Nie pokazuj więcej tej informacji

Szanowny Kliencie!

Informujemy, że aby świadczyć usługi na najwyższym poziomie, nasz serwis internetowy gromadzi i zapisuje w pamięci komputerów Użytkowników serwisu krótkie informacje tekstowe (tzw. „cookies”). W dowolnym momencie istnieje możliwość modyfikacji ustawień przeglądarki, aby wyłączyć ten mechanizm. Konfiguracja, która dopuszcza używanie cookies oznacza, że Użytkownicy wyrażają na powyższe zgodę. Aby dowiedzieć się więcej proszę zapoznać się z Polityką Plików Cookies.

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>
                <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>