Etykietę można pobrać dla przesyłki opłaconej - w statusie confirmed
lub późniejszym.
etykiety można pobrać dla przesyłek opłaconych - w statusie confirmed
lub późniejszym
aby pobrać etykiety, użytkownik musi być jej nadawcą.
Pobranie etykiety przesyłki:
POST /v1/organizations/:organization_id/ shipments/labels |
Parametr | Typ | Opis | Walidacja | Domyślna wartość |
---|---|---|---|---|
format | string | Format etykiety | Formaty etykiet: Pdf , Epl , Zpl | Pdf |
shipment_ids | Array[Integer] | IDki przesyłek |
POST /v1/organizations/115/shipments/labels HTTP/1.1 Host: api-shipx-pl.easypack24.net Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbG ...[ommited for brevity]... Content-Type: application/json { "format": "pdf", "shipment_ids": [16728825,16237313] } |
W odpowiedzi na poprawnie przesłane zapytanie, serwer zwróci plik .pdf/.epl/.epl2/.zpl/.zip ze statusem HTTP 200 OK:
Błędy jakie mogą wystąpić podczas pobierania etykiety przesyłki:
label_generation_failed
- nie udało się wygenerować etykiety, powód opisany jest w kluczu message
oraz, ewentualnie, obiekcie details
.
label_template_not_found
- w systemie centralnym nie ma szablonu etykiety, więc nie można jej wygenerować,invalid_action
- przy próbie pobrania etykiety dla przesyłki nieopłaconej - w statusie wcześniejszym niż confirmed
.