Obiekt przesyłki wykorzystywany jest do uzyskania dostępnych ofert, a jednocześnie reprezentuje ona fizyczną paczkę (lub paczki), która będzie przesłana pomiędzy określonymi adresami.
...
Code Block |
---|
POST /v1/organizations/:organization_id/shipments |
...
Parametr | Typ | Opis | Walidacja |
---|---|---|---|
receiver | ReceiverForm | Dane odbiorcy paczki. | Atrybut jest wymagany.
|
sender | SenderForm | Dane nadawcy paczki. | Atrybut nie jest wymagany.
|
parcels | Array[ParcelsSimpleForm] | Dane paczek zawartych w przesyłce. | Atrybut jest wymagany.
|
custom_attributes | CustomAttributesForm | Dodatkowe atrybuty przesyłki. | Atrybut nie jest wymagany.
|
cod | CodForm | Wartość pobrania. | Atrybut nie jest wymagany.
|
insurance | InsuranceForm | Kwota ubezpieczenia przesyłki. | Atrybut nie jest wymagany.
|
reference | String | Dodatkowy opis przesyłki, np. numer zamówienia. | Atrybut nie jest wymagany.
|
is_return | Bool | Określa przesyłkę jako zwrotną. | Atrybut nie jest wymagany.
|
additional_services | Array[String] | Usługi dodatkowe. Dostępne usługi dodatkowe: | Atrybut nie jest wymagany.
|
external_customer_id | String | Identyfikator broker'a generującego przesyłki w ramach innej organizacji | Atrybut nie jest wymagany. |
only_choice_of_offer | Boolean | Ustawienie parametru na | Atrybut nie jest wymagany.
|
mpk | String | Nazwa miejsca powstania kosztów. | Atrybut nie jest wymagany.
Miejsce powstania kosztów musi najpierw być dodane do organizacji, aby można je było przypisać do przesyłki. |
comments | String | Dowolny komentarz | Atrybut nie jest wymagany.
|
...
Code Block |
---|
POST /v1/organizations/123/shipments HTTP/1.1 Host: api-shipx-pl.easypack24.net Content-Type: application/json Authorization: Bearer lkfjasd9f70y43ohriw...[ommited for brevity]... { "mpk":"miejsce_powstania_kosztow", "comments": "dowolny komentarz", "external_customer_id": "8877xxx", "receiver": { "first_name": "Jan", "last_name": "Kowalski", "name": "Nazwa", "email": "receiver@example.com", "phone": "888000000", "address": { "id": "123", "street": "Malborska", "building_number": "130", "city": "Kraków", "post_code": "30-624", "country_code": "PL" } }, "parcels": [ { "id": "small package", "template": "small", "dimensions": { "length": "80", "width": "360", "height": "640", "unit": "mm" }, "weight": { "amount": "25", "unit": "kg" }, "tracking_number": null, "is_non_standard": false } ], "custom_attributes": { "target_point": "KRA010" }, "insurance": { "amount": 25, "currency": "PLN" }, "cod": { "amount": 12.50, "currency": "PLN" }, "additional_services": ["email", "sms"], "mpk": "Nazwa miejsca powstania kosztów." } |
...
W odpowiedzi serwer zwróci status 201 wraz z obiektem nowo utworzonej przesyłki.
...