Dostęp do zasobu wymaga podania prawidłowego i ważnego access tokenu.
Na tej stronie
Zbiorowe opłacanie przesyłek
W momencie wyboru oferty, pozostałe (niewybrane) są usuwane. Aplikacja pozwala opłacić masowo przesyłki tylko wtedy gdy wszystkie dane są prawidłowo wprowadzone (podane numery przesyłek nalezą do organizacji, ID ofert są poprawnie przypisane do przesyłki, nie były wczesnej opłacone itp.)
Ponieważ zakup przesyłki działa asynchronicznie, serwer w odpowiedzi zwróci informacje o przesyłce nieuwzględniające zmian wywołanych przez zakup (zmiana statusu, nadanie numeru przewozowego), gdyż informacje te będą dostępne dopiero po pewnym czasie.
POST /v1/organizations/:organization_id/shipments/bulk_buy
Parametry
Parametr
Typ
Opis
Walidacja
shipments
Array[Hash]
Bulk Buy Shipments
Umożliwia dokonania zbiorowego opłacenia przesyłek.
Tablica może zawierać maksymalnie 100 elementów.
shipments posiada następujące atrybuty:
Parametr
Typ
Opis
id
String
Unikalny identyfikator danej przesyłki, który pozwala zwrócić użytkownikowi informację o błędach walidacji przypisanych do konkretnej przesyłki.
HTTP/1.1 204 No Content
Content-Type: application/json
Informacje o błędach
Lista błędów, które mogą wystąpić przy opłacaniu przesyłki:
resource_not_found - może wystąpić gdy określona przesyłka nie istnieje lub użytkownik nie ma do niej dostępu,
offer_unavailable - występuje jeśli podejmowana próba opłacenia oferty w statusie innym niż available albo selected,
transaction_failed - może wystąpić jeżeli nie uda się opłacić przesyłki.
Asynchroniczne opłacanie przesyłki
Po wykonaniu requestu zostanie uruchomiony asynchroniczny proces opłacania przesyłki.
Aby otrzymać informację o pomyślnym zakupieniu przesyłki, należy zdefiniować w konfiguracji organizacji adres url, pod który mają być wysyłane informacje dla zdarzenia shipment_confirmed. Dzięki temu aplikacja ShipX wyśle na podany adres następujące informacje: