Wprowadziliśmy rozwiązanie, które znacząco optymalizuje obsługę faktur.

Co zmieniliśmy?

Wprowadziliśmy nowy endpoint POST /order/{orderId}/billing-documents/files, dzięki któremu prześlesz plik faktury w ramach jednego żądania.

Przykładowy request:

 curl -X POST \
 'https://api.allegro.pl/order/39878c30-9d38-11f1-8672-8107a5f829bb/billing-documents/files' \
  -H 'Accept: application/vnd.allegro.public.v1+json' \
  -H 'Content-Type: multipart/form-data' \
  -H 'Authorization: Bearer {token}' \
  -F 'file=@"/Users/user/faktura.pdf"' \
  -F 'invoiceNumber=02-10-26'

Przykładowe response:

{"id":"b0373e5b-d6b5-4457-a358-a1d35ec41426"}

Dotychczasowe endpointy:

• POST /order/checkout-forms/{id}/invoices
• PUT /order/checkout-forms/{id}/invoices/{invoiceId}/file

Oznaczyliśmy w dokumentacji jako deprecated i w przyszłości planujemy je usunąć. O dokładnej dacie poinformujemy z odpowiednim wyprzedzeniem w osobnym komunikacie.

Dlaczego wprowadziliśmy zmianę?

Dotychczasowy proces załączania faktur wymagał wykonania dwóch osobnych żądań. Nowy endpoint zastępuje ten dwuetapowy proces, znacznie upraszczając i przyspieszając integrację.