Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

ParametrTypOpisWalidacja
receiverReceiverForm

Dane odbiorcy paczki.

Atrybut jest wymagany.

  • jeśli ma być przedstawiona oferta usługi kurierskiej, należy podać co najmniej receiver.company_name i/lub receiver.first_name i receiver.last_name oraz obiekt address,
  • jeśli ma być przedstawiona oferta paczkomatowa należy podać receiver.phone_number i receiver.email,
  • podanie wszystkich danych umożliwi przedstawienie ofert obu typów.
  • jeśli w additional_services podane zostaną "sms", lub "email", to analigocznie wymagane jest podanie phone, lub email
  • jeśli zostanie przekazany atrybut is_return == true, atrybut receiver nie będzie wymagany
senderSenderFormDane nadawcy paczki.

Atrybut nie jest wymagany.

  • Jeśli nie zostaną podane żadne dane, domyślnie zostaną użyte dane organizacji, w ramach której tworzona jest przesyłka.
parcelsArray[ParcelsSimpleForm]

Dane paczek zawartych w przesyłce.

Atrybut jest wymagany.

  • Kolekcja minimum 1, maksimum 1000
custom_attributesCustomAttributesForm

Dodatkowe atrybuty przesyłki.

Atrybut nie jest wymagany.

  • Lista dodatkowych atrybutów została opisana we wstępie.
  • Wymagane jest podanie paczkomatu w przypadku przesyłki paczkomatowej.
codCodFormWartość pobrania.

Atrybut nie jest wymagany.

  • Walidacja oraz wymagalność przekazania atrybutu występuje w momencie przekazania serwisu.
insuranceInsuranceFormKwota ubezpieczenia przesyłki.

Atrybut nie jest wymagany.

  • Walidacja oraz wymagalność przekazania atrybutu występuje w momencie przekazania serwisu.
referenceStringDodatkowy opis przesyłki, np. numer zamówienia.

Atrybut nie jest wymagany.

  • Minimum 3 znaki, maksimum 100 znaków, możliwość przekazania pustego atrybutu.
is_returnBoolOkreśla przesyłkę jako zwrotną.

Atrybut nie jest wymagany.

  • Dopuszczalne wartości (true, false)
  • Możliwość przekazania pustego atrybutu.
  • Jeśli ustawione na true, określa przesyłkę jako zwrotną. W takiej sytuacji dane nadawcy i odbiorcy zostaną automatycznie zamienione miejscami.
additional_servicesArray[String]

Usługi dodatkowe.

Dostępne usługi dodatkowe: smsemailsaturday.

API X Rozmiary i usługi dla przesyłek 

Atrybut nie jest wymagany.

  • Atrybut walidowany w momencie przekazania wartości.
  • Przekazując atrybut additional_services system sprawdza przekazanie atrybutu service, jeśli atrybut service nie zostanie przekazany lub przekazany atrybut additional_services nie mieści się w zakresie przekazanego serwisu, użytkownik otrzyma błąd.
external_customer_id
StringIdentyfikator broker'a generującego przesyłki w ramach innej organizacjiAtrybut nie jest wymagany.
only_choice_of_offerBoolean

Ustawienie parametru na true powoduje że oferta we wszystkich przesyłkach zostanie wybrana dla podanego serwisu, ale nie zostanie automatycznie opłacona.
Taka przesyłkę trzeba opłacić przed końcem wygaśnięcia oferty wykonując operacje (Opłacanie przesyłki). 
Parametr ten można ustawić również dla każdej przesyłki z osobna (w takim przypadku parametr ustawiony w przesyłce ma wyższy priorytet).

Atrybut nie jest wymagany.

  • Domyślna wartość false
mpkStringMiejsce powstania kosztów

Atrybut nie jest wymagany.

  • maksymalnie 255 znaków
  • jeśli atrybut jest podany, weryfikujemy czy przynależy do organizacji, z której wykonywane jest żądanie
  • możliwość przekazania pustego atrybutu

Miejsce powstania kosztów musi najpierw być dodane do organizacji, aby można je było przypisać do przesyłki.

commentsStringDowolny komentarz

Atrybut nie jest wymagany.

  • maksymalnie 100 znaków
  • możliwosć przekazania pustego atrybutu

...