Page Comparison

Implementacja usługi

Parametry

Modyfikację obiektu przesyłki

Zmiana powinna zostać zaimplementowana w:

• tworzeniu przesyłki w trybie uproszczonym [1.9.0] Tworzenie przesyłki w trybie uproszczonym

• tworzeniu przesyłek w trybie ofertowym [1.9.0] Tworzenie przesyłki w trybie ofertowym

• tworzeniu wielu przesyłek [1.6.4] Tworzenie i podgląd wielu przesyłek

• aktualizacji przesyłki [1.9.0] Aktualizowanie przesyłki

Pobieranie listy punktów dostępnych dla usługi

Aby pobrać listę punktów obsługujących usługę, należy wywołać metodę do pobierania maszyn z parametrem type=parcel_locker_only np.: https://api-shipx-pl.easypack24.net/v1/points?type=parcel_locker_only  następnie należy odfiltrować maszyny które nie są dostępne 24/7 za pomocą parametr location_247 ustawiony jest na true (location_247": true) 

Informacje o błędach

Błędy, jakie mogą wystąpić podczas tworzenia przesyłki:

• invalid_end_of_week_collection - w przypadku wybrania usługi dodatkowej poza wskazanym przedziałem czasowym spowoduje zwrócenie wyjątku przez aplikację

• invalid_target_point_for_end_of_week_collection- w przypadku wybrania Punktu Obsługi Przesyłek który nie jest dostępny 24/7 jako sposobu odbioru przesyłki zostanie zwrócony wyjątek. Tylko maszyny filtrowane za pomocą parametru type=parcel_locker_only obsługują Dostawy Weekendowe

• invalid_target_point_247_for_end_of_week_collection- w przypadku wybrania  paczkomatu który nie jest dostępny 24/7 jako sposobu odbioru przesyłki zostanie zwrócony wyjątek. Tylko maszyny filtrowane za pomocą parametru type=parcel_locker_only obsługują Dostawy Weekendowe

• invalid_allegro_for_end_of_week_collection- dla przesyłek allegro usługa nie jest dostępna. Próba utworzenia przesyłki allegro z usługą Dostawy Weekendowej spowoduje zwrócenie wyjątku przez aplikację
  

Przykładowe zapytanie dla tworzenia przesyłki w trybie uproszczonym

POST /v1/organizations/123/shipments HTTP/1.1
Host: api-shipx-pl.easypack24.net
Content-Type: application/json
Authorization: Bearer lkfjasd9f70y43ohriw...[ommited for brevity]...
{
      "receiver": {
             "email": "receiver@example.com",
             "phone": "888000000"
      },
      "parcels": [
      {
             "template": "small"
      }
      ],
      "custom_attributes": {
             "target_point": "KRA010"
      },
      "insurance": {
             "amount": 25,
             "currency": "PLN"
      },
      "cod": {
             "amount": 12.50,
             "currency": "PLN"
      },
      "end_of_week_collection":true
      "service": "inpost_locker_standard"
}

Modyfikacja wyszukiwania przesyłek

• usługę Dostaw Weekendowych będzie można wyszukać poprzez wywołanie w filtrze parametru end_of_week_collection, który będzie przyjmował wartości true/false

• w przypadku, gdy parametr będzie ustawiony na end_of_week_collection=true, będą zwracane tylko przesyłki, w których została wybrana opcja Dostaw Weekendowych

• w przypadku braku parametru end_of_week_collection w filtrze będą zwracane wszystkie przesyłki

• szczegółowe informacje na stronie [1.6.0] Wyszukiwanie przesyłek

Modyfikacja usług 

• obiekt serwisu zostanie zaktualizowany o usługę dodatkową Dostaw Weekendowych,

• dla serwisu inpost_locker_standard zostanie zwrócona usługa dodatkowa o identyfikatorze

id: end_of_week_collection

• szczegółowe informacje na stronie [1.9.0] Aktualizowanie przesyłki

Modyfikacja przeliczania cen przesyłki

• analogicznie jak przy tworzeniu przesyłki w metodzie post będzie można podać parametr end_of_week_collection z wartością true lub false,

• parametr nie jest wymagany

• w odpowiedzi zostanie zwrócony cennik zaktualizowany o parametr end_of_week_collection_charge_amount

• szczegółowe informacje na stronie [1.7.0] Przeliczanie cen przesyłek

Przykład odpowiedzi:

[

      {

             "id":"SHIPMENT1",

             "calculated_charge_amount":"27.20",

             "fuel_charge_amount":"0.00",

             "notification_charge_amount":"0.00",

             "cod_charge_amount":"0.00",

             "insurance_charge_amount":"20.00",

             "calculated_charge_amount_non_commission":"7.20",

             "end_of_week_collection_charge_amount":"4.99",

      },

      {

             "id":"SHIPMENT2",

             "calculated_charge_amount":"18.00",

             "fuel_charge_amount":null,

             "notification_charge_amount":null,

             "cod_charge_amount":null,

             "insurance_charge_amount":null,

             "calculated_charge_amount_non_commission":null,

             "end_of_week_collection_charge_amount":"4.99"