01 lutego 2021
Dodaj fakturę do zamówienia
Już w lutym 2021, wraz ze startem Allegro Biznes, udostępnimy nowe zasoby, dzięki którym dodasz i pobierzesz fakturę do zamówienia:
- POST /order/checkout-forms/{id}/invoices - utwórz obiekt faktury.
Przykładowy request:
curl -X POST \
‘https://api.allegro.pl/order/checkout-forms/a8320af2-5f01-11eb-bbeb-112e13b418c5/invoices' \
-H ‘Accept: application/vnd.allegro.public.v1+json’ \
-H ‘Content-Type: application/vnd.allegro.public.v1+json’ \
-H ‘Authorization: Bearer {token}’ \
-d ‘{
"file": {
“name”: "faktura.pdf" - wymagane, nazwa pliku
},
"invoiceNumber": "FV 01/2020" - niewymagane, nr faktury
}’Przykładowy response:
{
"id": "56ae349d-8045-4bb3-adcc-7cf6fb420f61" - identyfikator faktury
}- PUT /order/checkout-forms/{id}/invoices/{invoiceId}/file - prześlij plik .pdf z fakturą. Jako “invoice.id” przekaż wartość id, którą otrzymałeś w odpowiedzi dla metody POST. Możesz dodać jedną fakturę w formacie .pdf do każdego zamówienia. Rozmiar pliku nie może przekroczyć 2 MB.
Przykładowy request:
curl -X PUT \
‘https://api.allegro.pl/order/checkout-forms/a8320af2-5f01-11eb-bbeb-112e13b418c5/invoices/56ae349d-8045-4bb3-adcc-7cf6fb420f61/file' \
-H ‘Accept: application/vnd.allegro.public.v1+json’ \
-H ‘Content-Type: application/pdf’ \
-H ‘Authorization: Bearer {token}’ \
-d 'data=@faktura.pdf’
- GET /order/checkout-forms/{id}/invoices - pobierz faktury przypisane do zamówienia.
Przykładowy request:
curl -X GET \
‘https://api.allegro.pl/order/checkout-forms/a8320af2-5f01-11eb-bbeb-112e13b418c5/invoices' \
-H ‘Accept: application/vnd.allegro.public.v1+json’ \
-H ‘Authorization: Bearer {token}’
Przykładowy response:
{
“invoices”: [
{
"id": "56ae349d-8045-4bb3-adcc-7cf6fb420f61", - identyfikator faktury
"invoiceNumber": "FV 01/2020", - nr faktury
"createdAt": "2021-01-07T15:50:00.000Z", - data dodania faktury
"file": {
"name": "faktura.pdf", - nazwa pliku
"uploadedAt": "2021-01-07T15:50:00.000Z", - data dodania pliku
"securityVerification": {
"status": "ACCEPTED", - status weryfikacji antywirusowej pliku,
dostępne wartości: WAITING, ACCEPTED, REJECTED.
"verifiedAt": "2021-01-07T15:51:00.000Z" - data weryfikacji
}
},
"eptVerification": { - obiekt przyjmuje
wartość null dla metod płatności
innych niż płatność odroczona
"status": "ACCEPTED", - status weryfikacji faktury dla
płatności odroczonej, dostępne
wartości: WAITING, ACCEPTED, REJECTED.
"verifiedAt": "2021-01-07T15:58:00.000Z", - data weryfikacji
"reason": null - powód odrzucenia faktury, jeśli
status weryfikacji to REJECTED.
}
}
]
}
