Metoda createShipments

Metoda umo┼╝liwia utworzenie przesy┼éek w systemie DHL24. Obowi─ůzuj─ů wszystkie regu┼éy walidacyjne, kt├│re u┼╝ywane s─ů w serwisie WWW. W przypadku nie przej┼Ťcia przez proces walidacyjny zostanie zwr├│cona struktura b┼é─Ödu z odpowiednim komunikatem, opisuj─ůcym przyczyn─Ö problemu.


Aby przesy┼éka by┼éa utworzona musz─ů by─ç spe┼énione warunki:

  • wybrana us┼éuga przewozowa musi by─ç dost─Öpna (w wybranych godzinach) dla danego kodu pocztowego, pomocne w tym mo┼╝e by─ç sprawdzenie kodu pocztowego przy pomocy getPostalCodeServices
  • paczki musz─ů spe┼énia─ç og├│lne kryteria, zestawione w cenniku


W trybie testowym metoda dokonuje walidacji danych wej┼Ťciowych, bez sprawdzenia rzeczywistej dost─Öpno┼Ťci us┼éug czy te┼╝ opcji p┼éatno┼Ťci. Zwraca przyk┼éadow─ů struktur─Ö wyj┼Ťciow─ů lub struktury b┼é─Öd├│w.

Parametry wej┼Ťciowe

Nazwa pola Typ Wymagane? Opis
authData AuthData Tak Struktura autoryzacyjna
shipments Tablica struktur ShipmentFullData Tak Tablica z minimum jedn─ů struktur─ů definiuj─ůc─ů przesy┼ék─Ö (maksymalnie trzema)

Parametry wyj┼Ťciowe

Nazwa pola Typ Wymagane? Opis
shipments ShipmentBasicData Tak Tablica struktur ShipmentBasicData lub struktur błędu

Przykład wywołania

<createShipments>
    <authData>
        <username>testomir</username>
        <password>testalski</password>
    </authData>
    <shipments>
        <item>
            <shipper>
                <name>Testomir</name>
                <postalCode>00909</postalCode>
                <city>Warszawa</city>
                <street>W─ůwozowa</street>
                <houseNumber>2</houseNumber>
                <contactPhone>123456789</contactPhone>
            </shipper>
            <receiver>
                <addressType>B</addressType>
                <country>PL</country>
                <name>Odbiorca</name>
                <postalCode>24100</postalCode>
                <city>Puławy</city>
                <street>Wr├│blewskiego</street>
                <houseNumber>7</houseNumber>
                <contactPerson>Jan JakoTaki</contactPerson>
                <contactPhone>818765432</contactPhone>
                <contactEmail>odbiorca@gmail.com</contactEmail>
            </receiver>
            <pieceList>
                <item>
                    <type>PALLET</type>
                    <width>40</width>
                    <height>100</height>
                    <length>60</length>
                    <weight>250</weight>
                    <quantity>1</quantity>
                    <nonStandard>true</nonStandard>
                    <blpPieceId>JJD111100022203041</blpPieceId>
                </item>
                <item>
                    <type>ENVELOPE</type>
                    <quantity>1</quantity>
                </item>
            </pieceList>
            <payment>
                <paymentMethod>BANK_TRANSFER</paymentMethod>
                <payerType>SHIPPER</payerType>
                <accountNumber>1234567</accountNumber>
                <costsCenter>501502</costsCenter>
            </payment>
            <service>
                <product>AH</product>
                <collectOnDelivery>true</collectOnDelivery>
                <collectOnDeliveryValue>2199.99</collectOnDeliveryValue>
                <collectOnDeliveryForm>BANK_TRANSFER</collectOnDeliveryForm>
                <insurance>true</insurance>
                <insuranceValue>2500</insuranceValue>
            </service>
            <shipmentDate>2012-12-24</shipmentDate>
            <content>sprz─Öt AGD</content>
        </item>
    </shipments>
</createShipments>
Wr├│─ç do listy temat├│w