Metoda bookCourier

Metoda umo┼╝liwia zam├│wienie kuriera do zdefiniowanych wcze┼Ťniej przesy┼éek, na konkretny dzie┼ä w ramach wskazanych godzin. Po otrzymaniu ┼╝─ůdania metoda sprawdza dane wej┼Ťciowe: czy mo┼╝liwy jest przyjazd kuriera w wyznaczonym czasie i czy wszystkie wskazane przesy┼éki mog─ů by─ç odebrane w jednym miejscu (zgodno┼Ť─ç adres├│w nadania). W przypadku wyst─ůpienia b┼é─Ödu komunikat zwrotny b─Ödzie wskazywa┼é przyczyn─Ö problemu.

Zam├│wi─ç kuriera mo┼╝na

  • dla listy przygotowanych wcze┼Ťniej przesy┼éek (przez podanie identyfikator├│w przesy┼éek w parametrze shipmentIdList)
  • bez podawanie przesy┼éek - wymagana jest wtedy struktura shipmentOrderInfo z podstawowymi danymi o zam├│wieniu

Uwaga - w przypadku zamawiania kuriera bez podania listy przesy┼éek, takie zam├│wienie b─Ödzie niewidoczne na li┼Ťcie przesy┼éek w serwisie www.

Parametry wej┼Ťciowe

Nazwa pola Typ Wymagane? Opis
authData AuthData Tak Struktura autoryzacyjna
pickupDate string Tak Data w formacie RRRR-MM-DD
pickupTimeFrom string Tak Godzina, od której przesyłka jest gotowa do odebrania (w formacie GG:MM)
pickupTimeTo string Tak Godzina, do której można odebrać przesyłkę (w formacie GG:MM)
additionalInfo string(50) Nie Dodatkowe informacje dla kuriera
shipmentIdList array Tak(*) Tablica element├│w typu string, zawieraj─ůca identyfikatory przesy┼éek
shipmentOrderInfo shipmentOrderInfo Tak(*) Zbiorcze dane dotycz─ůce nadawcy oraz ilo┼Ťci oraz wagi przesy┼éek
courierWithLabel boolean Nie Czy kurier ma przyjecha─ç z etykiet─ů

(*) - tylko jeden z tych element├│w (lista zdefiniowanych przesy┼éek, lub podstawowe dane o przesy┼ékach) jest wymagany. Je┼Ťli podane s─ů oba struktura shipmentOrderInfo jest ignorowana.

Parametry wyj┼Ťciowe

Nazwa pola Typ Wymagane? Opis
orderId array Tak Tablica elementów typu string z numerami zleceń

Przykłady wywołań

Zam├│wienie kuriera dla trzech utworzonych wcze┼Ťniej przesy┼éek

<authData>
    <username>testomir</username>
    <password>testalski</password>
</authData>
<pickupDate>2012-10-23</pickupDate>
<pickupTimeFrom>10:00</pickupTimeFrom>
<pickupTimeTo>14:00</pickupTimeTo>
<additionalInfo>Uwaga, paczki zawieraj─ů szk┼éo</additionalInfo>
<shipmentIdList>
    <item>1234567</item>
    <item>1234568</item>
    <item>1234569</item>
</shipmentIdList>

Zam├│wienie kuriera bez definiowania paczek

<authData>
    <username>testomir</username>
    <password>testalski</password>
</authData>
<pickupDate>2012-10-23</pickupDate>
<pickupTimeFrom>10:00</pickupTimeFrom>
<pickupTimeTo>14:00</pickupTimeTo>
<additionalInfo>Uwaga, paczki zawieraj─ů szk┼éo</additionalInfo>
<shipmentOrderInfo>
    <shipper>
        <name>Testomir Testalski</name>
        <postalCode>02796</postalCode>
        <city>Warszawa</city>
        <street>W─ůwozowa</street>
        <houseNumber>2</houseNumber>
        <contactPerson>Testomir Testalski</contactPerson>
        <contactEmail>testomir@jakasdomena.eu</contactEmail>
    </shipper>
    <numberOfExPieces>3</numberOfExPieces>
    <numberOfDrPieces>0</numberOfDrPieces>
    <totalWeight>40</totalWeight>
    <heaviestPieceWeight>15</heaviestPieceWeight>
</shipmentOrderInfo>
Wr├│─ç do listy temat├│w