Przekazanie własnych etykiet

Od teraz możesz przekazać własną etykietę do nadania przesyłki — bez względu na jej pochodzenie (Allegro, Erli, Shopee, własny sklep itd.).

Dane dotyczące etykiety przekazujemy w metodzie createSale. Należy je podać w tablicy o nazwie own_label a także wybrać odpowiedni typ przesyłki - Własna etykieta.

Dostępne są 2 sposoby przekazania etykiety przez API:

Przekazanie przez link

1. Ustaw parametr own_label[mode] na wartość url.
2. W parametrze own_label[items][][url] przekaż adres URL, z którego można pobrać etykietę w formacie PDF.
   WAŻNE: nagłówek 'Content-Type' musi być równy 'application/pdf', zwrócony status strony musi być równy 200.
3. Uzupełnij pozostałe wymagane parametry jak provider, tracking_no.

Przekazanie jako plik

1. Gotowy plik: parametr own_label[mode] należy ustawić na wartość pdf.
2. W parametrze own_label[items][][data] przekaż zawartość pliku jako tekst base64 (w przypadku PHP — konwersję można wykonać za pomocą metody base64_encode).
   WAŻNE: przekazany plik musi po odkodowaniu zawierać prawidłowy plik PDF.
3. Uzupełnij pozostałe wymagane parametry jak provider, tracking_no.

Pozostałe informacje, które dotyczą obu sposobów przekazywania etykiety:

• Walidacja etykiety odbędzie się zarówno w momencie przekazania adresu/pliku, jak i podczas jej drukowania.
• Maksymalny rozmiar etykiety to 4 MB.
• Jedyny dopuszczalny format etykiety to PDF.
• Możliwe jest przekazanie więcej niż 1 etykiety poprzez dodanie wielu elementów w tablicy own_label[items][].
• Pole own_label[tracking_no] wymaga podania numerów trackingowych z przekazanych etykiet. W przypadku wielu etykiet należy je rozdzielić przecinkiem.
• UWAGA! Podanie danych niezgodnych z etykietą może opóźnić lub uniemożliwić jej realizację!