Metoda grupuj─ůca createShipment

Przy pomocy tej metody mo┼╝liwe jest - w jednym ┼╝─ůdaniu - utworzenie przesy┼éki i zam├│wienie kuriera.

Parametry wej┼Ťciowe

Nazwa pola Typ Wymagane? Opis
authData AuthData Tak Struktura autoryzacyjna
dropOffType string Tak Rodzaj ┼╝─ůdania, warto┼Ť─ç s┼éownikowa; mo┼╝liwe warto┼Ťci:
REGULAR_PICKUP - utworzenie przesyłki bez restrykcji
REQUEST_COURIER - utworzenie przesyłki i zamówienie kuriera
COURIER_ONLY - zam├│wienie kuriera
serviceType string Tak
(Niewymagane dla przesyłek międzynarodowych)
Typ us┼éugi przewozowej, warto┼Ť─ç s┼éownika; mo┼╝liwe warto┼Ťci:
AH - przesyłka krajowa
09 - usługa Domestic 09
12 - usługa Domestic 12
DW - przesyłka z doręczeniem wieczornym
EK - przesyłka Connect
PI - przesyłka International
PR - produkt Premium
CP - przesyłka Connect Plus
CM - przesyłka Connect Plus
labelType string Tak Wyb├│r etykiety zwrotnej, mo┼╝liwe warto┼Ťci:
LP - list przewozowy
BLP - etykieta BLP w formacie PDF
LBLP - etykieta BLP w formacie PDF A4
ZBLP - etykieta BLP w formacie drukarek Zebra
Je┼╝eli u┼╝ywacie Pa┼ästwo drukarki laserowej ÔÇô etykieta wygenerowana w pliku pdf ÔÇô parametr BLP
Je┼╝eli u┼╝ywacie Pa┼ästwo drukarki termicznej zebra - etykieta wygenerowana w pliku zpl ÔÇô parametr ZBLP
content string(30) Tak Zawarto┼Ť─ç przesy┼éki
comment string(100) Nie Dodatkowy komentarz, do wydruku na li┼Ťcie przewozowym.
Pierwsze 50 znak├│w wiadomo┼Ťci zostanie r├│wnie┼╝ przekazane kurierowi jako uwagi zleceniodawcy
reference string(200) Nie Numer referencyjny przesyłki
waybill string(11) Nie Numer listu przewozowego przesyłki
billing - informacja o p┼éatno┼Ťci
shippingPaymentType string Tak Okre┼Ťlenie strony, kt├│ra zostanie obci─ů┼╝ona kosztami, mo┼╝liwe opcje:
SHIPPER - nadawca,
RECEIVER - odbiorca,
USER - strona trzecia
billingAccountNumber integer Tak Numer klienta, kt├│ry b─Ödzie obci─ů┼╝ony kosztami
paymentType string Tak Wyb├│r sposobu p┼éatno┼Ťci, mo┼╝liwe warto┼Ťci:
BANK_TRANSFER - przelew (tylko dla klient├│w z umow─ů i numerem SAP)
costsCenter string(20) Nie Miejsce powstawania koszt├│w
specialServices - zamawianie usług dodatkowych
serviceType string Nie Rodzaj us┼éugi dodatkowej, mo┼╝liwe warto┼Ťci:
1722 - Doręczenie w godzinach 18-22dodatkowo płatne
SOBOTA - Doręczenie w sobotędodatkowo płatne
NAD_SOBOTA - Nadanie w sobotędodatkowo płatne
UBEZP - Ubezpieczenie przesyłkidodatkowo płatne
COD - Zwrot pobraniadodatkowo płatne
PDI - Informacje przed doręczeniemdodatkowo płatne
ROD - Zwrot potwierdzonych dokumentówdodatkowo płatne
POD - Potwierdzenie doręczenia dodatkowo płatne / Dla produktu PI - Usługi utylizacjibezpłatne
SAS - Dor─Öczenie do s─ůsiadabezp┼éatne
ODB - Odbiór własnybezpłatne
serviceValue float Nie Deklarowana warto┼Ť─ç, wymagana podczas zamawiania us┼éug ubezpieczenie lub zwrot pobrania
textInstruction string(32) Nie Nazwa dokumentu zwrotnego w usłudze ROD
collectOnDeliveryForm string Nie Forma zwrotu pobrania w us┼éudze COD, dost─Öpne warto┼Ťci:
BANK_TRANSFER - przelew (tylko dla klient├│w z umow─ů i numerem SAP)
shipmentTime - informacja o czasie nadania przesyłki
shipmentDate string Tak Data nadania w formacie RRRR-MM-DD
shipmentStartHour string(32) Tak Pocz─ůtek zakresu godzinowego, w kt├│rym kurier ma odebra─ç przesy┼ék─Ö; w formacie GG:MM
shipmentEndHour string(32) Tak Koniec zakresu godzinowego, w którym kurier ma odebrać przesyłkę; w formacie GG:MM
shipper oraz receiver - dane adresowe nadawcy oraz odbiorcy
addressType string(1) Tak Typ adresu (B/C) (tylko odbiorca)
country string(2) Tak Kraj odbiorcy
isPackstation bool Nie Dor─Öczenie do DHL Parcelstation
isPostfiliale bool Nie Dor─Öczenie do DHL Parcelshop
postnummer string(10) Nie Numer klienta - wymagane tylko dla DE przy dor─Öczeniu do paczkomatu
name string(60) Tak Nazwa (imi─Ö i nazwisko b─ůd┼║ nazwa firmy)
postalCode string Tak Kod pocztowy
city string(17) Tak Miejscowo┼Ť─ç
street string(35) Tak Ulica
houseNumber string(10) Tak Numer domu
W przypadku doręczenia do DHL Parcelstation lub DHL Parcelshop dla przesyłek zagranicznych Connect - numer parcelstation lub parcelshop suma znaków w polach "apartmentNumber" i "houseNumber" nie może przekroczyć 15 znaków
apartmentNumber string(10) Nie Numer lokalu suma znak├│w w polach "apartmentNumber" i "houseNumber" nie mo┼╝e przekroczy─ç 15 znak├│w
preaviso oraz contact - dane do preawizacji / kontaktubezpłatne
personName string(50) Nie Nazwa osoby kontaktowej
phoneNumber string(9) Nie Numer telefonu (9 cyfr)
emailAddress string(100) Nie Adres email
neighbour - dane s─ůsiada (tylko, gdy wybrana us┼éuga SAS)
name string(60) Tak Nazwa (imi─Ö i nazwisko b─ůd┼║ nazwa firmy)
postalCode string Tak Kod pocztowy (w formacie xxxxx: bez my┼Ťlnika)
city string(17) Tak Miejscowo┼Ť─ç
street string(35) Tak Ulica
houseNumber string(10) Tak Numer domu suma znak├│w w polach "apartmentNumber" i "houseNumber" nie mo┼╝e przekroczy─ç 15 znak├│w
apartmentNumber string(10) Nie Numer lokalu suma znak├│w w polach "apartmentNumber" i "houseNumber" nie mo┼╝e przekroczy─ç 15 znak├│w
contactPhone string(9) Nie Kontaktowy numer telefonu
contactEmail string(100) Nie Kontaktowy adres email
pieceList - dane nt. paczek w przesyłce
type string Tak Typ paczki, mo┼╝liwe warto┼Ťci:
ENVELOPE - przesyłka kopertowa
PACKAGE - paczka
PALLET - paleta
weight integer Tak Waga paczki(w kilogramach), nie wymagane dla type = ENVELOPE
width integer Tak Szeroko┼Ť─ç paczki (w centymetrach), nie wymagane dla type = ENVELOPE
height integer Tak Wysoko┼Ť─ç paczki (w centymetrach), nie wymagane dla type = ENVELOPE
length integer Tak D┼éugo┼Ť─ç paczki (w centymetrach), nie wymagane dla type = ENVELOPE
quantity integer Tak Ilo┼Ť─ç paczek tego typu
nonStandard bool Nie Oznaczenie, ┼╝e paczka jest niestandardowa (true / false)
euroReturn bool Nie Oznaczenie, ┼╝e palety w przesy┼éce s─ů do zwrotu (true / false)
blpPieceId string(32) Nie Identyfikator paczki (JJD) na etykiet─Ö BLP (dla klient├│w, kt├│rzy prowadz─ů w┼éasn─ů numeracj─Ö)
customs - dane dotycz─ůce odprawy celnej (dla przesy┼éek dor─Öczanych poza UE)
customsType string(1) Tak Rodzaj odprawy celnej (U - uproszczona, I - indywidualna)
costsOfShipment integer Tak Warto┼Ť─ç brutto transportu jak─ů zap┼éaci┼é odbiorca u kupuj─ůcego
currency string(3) Tak Waluta (GBP, PLN, EUR, CHF, USD)
nipNr string(12) Tak (dla odprawy indywidualnej) Numer NIP
eoriNr string(17) Tak (dla odprawy indywidualnej) Numer EORI
vatRegistrationNumber string(9) Tak (dla odprawy indywidualnej) Numer rejestracyjny VAT
categoryOfItem string(2) Tak Kategoria towarów (wg. słownika: 9 - "Inne", 11 - "Sprzedaż towarów", 21 - "Zwrot towarów", 31 - "Prezent", 32 - "Wzory, próbki", 91 - "Dokumenty")
invoiceNr string(35) Tak (dla odprawy indywidualnej) Numer faktury
invoiceDate string(10) Tak (dla odprawy indywidualnej) Data faktury (format: YYYY-MM-DD)
countryOfOrigin string(2) Nie Kraj pochodzenia towar├│w. Dozwolone warto┼Ťci wg. ISO 3366-1 alfa-2.
additionalInfo string(100) Nie Dodatkowe informacje
grossWeight float Tak Waga towar├│w
firstName string(30) Tak Imi─Ö osoby kontaktowej
secondaryName string(30) Tak Nazwisko osoby kontaktowej
invoice base64 Tak (dla odprawy indywidualnej) Faktura VAT
customAgreements - dane dotycz─ůce zg├│d i deklaracji odprawy celnej (dla przesy┼éek dor─Öczanych poza UE)
notExceedValue string(1) Tak (dla odprawy uproszczonej) Dozwolone warto┼Ťci: T, N
notProhibitedGoods string(1) Tak Dozwolone warto┼Ťci: T, N
notRestrictedGoods string(1) Tak Dozwolone warto┼Ťci: T, N
customsItem - dane dotycz─ůce towar├│w w odprawie celnej (dla przesy┼éek dor─Öczanych poza UE)
nameEn string(256) Tak Nazwa angielska towaru
namePl string(256) Tak (dla odprawy indywidualnej) Nazwa polska towaru
quantity integer Tak Liczba element├│w
weight float Tak Waga towaru
value float Tak Warto┼Ť─ç towar├│w
tariffCode string(10) Tak (dla odprawy indywidualnej) Kod taryfy celnej

Parametry wyj┼Ťciowe

Nazwa pola Typ Wymagane? Opis
shipmentNotificationNumber string - Identyfikator przesyłki
dispatchNotificationNumber string - Identyfikator zam├│wienia (je┼Ťli zam├│wiony kurier)
labelType string - Typ etykiety zwrotnej
labelFormat string - Format MIME etykiety
labelContent string - Zawarto┼Ť─ç etykiety (zakodowana w base64)
cn23MimeType string - Typ dokumentu celnego CN23 - zwracany w przypadku uproszczonej odprawy celnej
cn23Content string - Zawarto┼Ť─ç dokumentu celnego CN23 (base64) - zwracany w przypadku uproszczonej odprawy celnej
fvProformaMimeType string - Typ dokumentu faktura proforma - zwracany w przypadku uproszczonej odprawy celnej
fvProformaContent string - Zawarto┼Ť─ç dokumentu faktura proforma (base64) - zwracany w przypadku uproszczonej odprawy celnej
fvProformaNumer string - Wygenerowany numer faktury - w przypadku niepodania numeru faktury w parametrach wej┼Ťciowych

Przykłady wywołania

<authData>
    <username>testomir</username>
    <password>testalski</password>
</authData>
<shipment>
    <shipmentInfo>
        <dropOffType>REQUEST_COURIER</dropOffType>
        <!-- mo┼╝liwe warto┼Ťci dropOffType:
            REGULAR_PICKUP - utworzenie przesyłki bez sprawdzania restrykcji na kod pocztowy (zbiór stały)
            REQUEST_COURIER - utworzenie przesyłki i zamówienie kuriera
            COURIER_ONLY - zam├│wienie kuriera -->
        <serviceType>AH</serviceType>
        <!-- typ usługi przewozowej, możliwe opcje serviceType:
            AH - przesyłka krajowa
            09 - usługa domestic 09
            DW - usługa Doręczenie wieczorne
            12 - usługa domestic 12 -->
        <billing>
            <shippingPaymentType>SHIPPER</shippingPaymentType>
            <!-- okre┼Ťlenie strony, kt├│ra zostanie obci─ů┼╝ona kosztami, mo┼╝liwe opcje serviceType:
                SHIPPER - płaci nadawca
                USER - p┼éatno┼Ť─ç trzecia strona -->
            <billingAccountNumber>1204663</billingAccountNumber>
            <paymentType>BANK_TRANSFER</paymentType>
            <!-- wyb├│r sposobu p┼éatno┼Ťci, mo┼╝liwe warto┼Ťci paymentType:
                 BANK_TRANSFER - przelew (tylko dla klient├│w z umow─ů i numerem SAP) -->
            <costsCenter>ABC1235</costsCenter>
        </billing>
        <specialServices>
            <item>
                <serviceType>ODB</serviceType>
                <!-- rodzaj us┼éugi dodatkowej, mo┼╝liwe warto┼Ťci serviceType:
                    - 1722 - Dor─Öczenie w godzinach 18-22
                    - SOBOTA - Nadanie / dor─Öczenie w sobot─Ö
                    - UBEZP - Ubezpieczenie przesyłki
                    - COD - Zwrot pobrania
                    - PDI - Informacje przed dor─Öczeniem
                    - ROD - Zwrot potwierdzonych dokument├│w
                    - POD - Potwierdzenie dor─Öczenia
                    - ODB - Odbiór własny
                    -->
            </item>
            <item>
                <serviceType>UBEZP</serviceType>
                <serviceValue>20000</serviceValue>
            </item>
        </specialServices>
        <shipmentTime>
            <shipmentDate>2012-10-23</shipmentDate>
            <shipmentStartHour>12:00</shipmentStartHour>
            <shipmentEndHour>15:00</shipmentEndHour>
        </shipmentTime>
        <labelType>LP</labelType>
        <!-- wyb├│r etykiety zwrotnej, mo┼╝liwe warto┼Ťci labelType:
            LP - list przewozowy
            BLP - etykieta BLP w formacie PDF
            ZBLP - etykieta BLP w formacie drukarek Zebra -->
    </shipmentInfo>
    <content>Gra komputerowa</content>
    <comment>ostro┼╝nie</comment>
    <ship>
        <shipper>
            <preaviso>
                <personName>3e Spółka Jawna</personName>
                <phoneNumber>123456789</phoneNumber>
                <emailAddress>testomir@gmail.pl</emailAddress>
            </preaviso>
            <contact>
                <personName>3e Spółka Jawna</personName>
                <phoneNumber>123456789</phoneNumber>
                <emailAddress>testomir@gmail.pl</emailAddress>
            </contact>
            <address>
                <name>Janek</name>
                <postalCode>00909</postalCode>
                <city>Wawa</city>
                <street>Le┼Ťna</street>
                <houseNumber>9</houseNumber>
                <apartmentNumber>59</apartmentNumber>
            </address>
        </shipper>
        <receiver>
            <preaviso>
                <personName>3e Spółka Jawna</personName>
                <phoneNumber>123456789</phoneNumber>
                <emailAddress>testomir@gmail.pl</emailAddress>
            </preaviso>
            <contact>
                <personName>3e Spółka Jawna</personName>
                <phoneNumber>123456789</phoneNumber>
                <emailAddress>testomir@gmail.pl</emailAddress>
            </contact>
            <address>
                <addressType>B</addressType>
                <country>PL</country>
                <name>Ja</name>
                <postalCode>00001</postalCode>
                <city>Wawa</city>
                <street>Le┼Ťna</street>
                <houseNumber>9</houseNumber>
                <apartmentNumber>59</apartmentNumber>
            </address>
        </receiver>
    </ship>
    <pieceList>
        <item>
            <type>ENVELOPE</type>
            <!-- typ paczki, mo┼╝liwe warto┼Ťci:
                ENVELOPE - przesyłka kopertowa
                PACKAGE - paczka
                PALLET - paleta -->
            <quantity>1</quantity>
        </item>
        <item>
            <type>PACKAGE</type>
            <weight>20</weight>
            <width>60</width>
            <height>40</height>
            <length>40</length>
            <quantity>1</quantity>
        </item>
    </pieceList>
    <customs>
        <customsType>U</customsType>
        <costsOfShipment>10</costsOfShipment>
        <currency>PLN</currency>
        <nipNr>5218487281</nipNr>
        <categoryOfItem>9</categoryOfItem>
        <countryOfOrigin>PL</countryOfOrigin>
        <customAgreements>
            <notExceedValue>T</notExceedValue>
            <notProhibitedGoods>T</notProhibitedGoods>
            <notRestrictedGoods>T</notRestrictedGoods>
        </customAgreements>
        <customsItem>
            <item>
                <nameEn>test</nameEn>
                <namePl>test</namePl>
                <quantity>2</quantity>
                <weight>2.0</weight>
                <value>100</value>
                <tariffCode>001</tariffCode>
            </item>
        </customsItem>
        <firstName>Testomir</firstName>
        <secondaryName>Testalski</secondaryName>
    </customs>
</shipment>
Wr├│─ç do listy temat├│w