Dodaj załączniki do faktury marża

Zakres: api:invoices:write. Pliki są zapisywane pojedynczo: odrzucony plik jest zgłaszany w entities z success: false, a odpowiedź pozostaje 201.

POST

https://api.sandbox-infakt.pl/v3/margin_invoices/{uuid}/add_attachment.json

Autoryzacja

ApiKey
opcjonalne
API key in header

Token
opcjonalne
API key in header

Path parameters

uuid
string
wymagane
format: uuid

Treść żądania FORM-DATA required

uploads[]
array of
string
wymagane
PDF, JPG albo PNG. Powtórz część dla każdego pliku.

format: binary

Odpowiedzi

201

Utworzono

JSON

entities
array of
object
wymagane
- success
  boolean
  wymagane
- name
  string
  wymagane
- uuid
  opcjonalne
  string
  Ustawione, gdy success ma wartość true.
  
  format: uuid
- download_url
  opcjonalne
  string
  Ustawione, gdy success ma wartość true.
- errors
  opcjonalne
  array of
  string
  Ustawione, gdy success ma wartość false.
}

401

Brak klucza API, nieprawidłowy klucz albo klucz bez wymaganego zakresu uprawnień.

JSON

error
opcjonalne
Komunikat po polsku (po angielsku dla 429). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól.
One of the following:
string
array<string>
object
}
errors
opcjonalne
Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
One of the following:
object
string
}
limit
opcjonalne
string
Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
type
opcjonalne
redirect
or
email_not_confirmed
url
opcjonalne
string
action_url
opcjonalne
string

402

API niedostępne w obecnym planie (limit: plan_upgrade_needed) albo osiągnięty limit dokumentów.

JSON

error
opcjonalne
Komunikat po polsku (po angielsku dla 429). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól.
One of the following:
string
array<string>
object
}
errors
opcjonalne
Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
One of the following:
object
string
}
limit
opcjonalne
string
Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
type
opcjonalne
redirect
or
email_not_confirmed
url
opcjonalne
string
action_url
opcjonalne
string

404

Nie znaleziono zasobu.

JSON

error
opcjonalne
Komunikat po polsku (po angielsku dla 429). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól.
One of the following:
string
array<string>
object
}
errors
opcjonalne
Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
One of the following:
object
string
}
limit
opcjonalne
string
Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
type
opcjonalne
redirect
or
email_not_confirmed
url
opcjonalne
string
action_url
opcjonalne
string

406

Ścieżka nie kończy się na .json.

JSON

error
opcjonalne
Komunikat po polsku (po angielsku dla 429). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól.
One of the following:
string
array<string>
object
}
errors
opcjonalne
Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
One of the following:
object
string
}
limit
opcjonalne
string
Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
type
opcjonalne
redirect
or
email_not_confirmed
url
opcjonalne
string
action_url
opcjonalne
string

422

Nie wysłano pliku (error) albo formularz przesyłania jest niepoprawny (success: false).

JSON

One of the following:

ErrorBody
- error
  opcjonalne
  Komunikat po polsku (po angielsku dla 429). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól.
  
  One of the following:
  string
  array<string>
  object
- errors
  opcjonalne
  Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
  
  One of the following:
  object
  string
- limit
  opcjonalne
  string
  Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
- type
  opcjonalne
  redirect
  or
  email_not_confirmed
- url
  opcjonalne
  string
- action_url
  opcjonalne
  string
}
AttachmentFormInvalid
- success
  false
  wymagane
}

423

Niepotwierdzony adres e-mail albo wymagana weryfikacja tożsamości.

JSON

error
opcjonalne
Komunikat po polsku (po angielsku dla 429). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól.
One of the following:
string
array<string>
object
}
errors
opcjonalne
Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
One of the following:
object
string
}
limit
opcjonalne
string
Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
type
opcjonalne
redirect
or
email_not_confirmed
url
opcjonalne
string
action_url
opcjonalne
string

429

Przekroczony limit zapytań. Komunikat jest po angielsku, np. API rate limit exceeded. Try again in 60 seconds.

JSON

error
opcjonalne
Komunikat po polsku (po angielsku dla 429). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól.
One of the following:
string
array<string>
object
}
errors
opcjonalne
Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
One of the following:
object
string
}
limit
opcjonalne
string
Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
type
opcjonalne
redirect
or
email_not_confirmed
url
opcjonalne
string
action_url
opcjonalne
string

curl --request POST \ --url https://api.sandbox-infakt.pl/v3/margin_invoices/aae6796c-30a9-4bc6-ae55-6b2f08a8a0f6/add_attachment.json \ --header 'X-inFakt-ApiKey: <X-inFakt-ApiKey>' \ --form 'uploads[]=@<uploads[]>;type=application/pdf' \ --form 'uploads[]=@<uploads[]>;type=application/pdf'

{ "entities": [ { "success": true, "name": "protokol-odbioru.pdf", "uuid": "6a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d", "download_url": "https://files.infakt.pl/uploads/6a1b2c3d/protokol-odbioru.pdf?X-Amz-Expires=300" } ] }