Metoda grupuj─ůca createShipmentReturn

Metoda pozwalaj─ůc─ů na tworzenie przesy┼éki i etykiety zwrotnej zar├│wno z listem nadawczym jak i bez niego.

Parametry wej┼Ťciowe

Nazwa pola Typ Wymagane? Opis
authData AuthData Tak Struktura autoryzacyjna
serviceType string Tak Rodzaj us┼éugi, mo┼╝liwe warto┼Ťci:
ZC Zwrot connect ZK Zwrot krajowy
shipmentInfo - informacja o p┼éatno┼Ťci
waybill string Nie Numer listu przewozowego przesyłki
bookCourier string Tak mo┼╝liwo┼Ť─ç nadania przesy┼éki zwrotnej kurierem
billing - informacja o p┼éatno┼Ťci
shippingPaymentType string Tak Okre┼Ťlenie strony, kt├│ra zostanie obci─ů┼╝ona kosztami, mo┼╝liwe opcje:
RECEIVER - odbiorca
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:
UBEZP - Ubezpieczenie przesyłki - tylko dla przesyłek krajowychdodatkowo płatne
serviceValue float Nie Deklarowana warto┼Ť─ç, wymagana podczas zamawiania us┼éug ubezpieczenie
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
labelExpDate string Tak data wyga┼Ťni─Öcia etykiety
labelType string - Wyb├│r etykiety zwrotnej, mo┼╝liwe warto┼Ťci:
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.
reference string(20) Nie Numer referencyjny przesyłki
primaryWaybillNumber string Nie Numer przesyłki pierwotnej
shippingPaymentType string Tak Okre┼Ťlenie strony, kt├│ra zostanie obci─ů┼╝ona kosztami, mo┼╝liwe opcje:
RECEIVER - odbiorca
billingAccountNumber integer Tak Numer klienta, kt├│ry b─Ödzie obci─ů┼╝ony kosztami
shipper oraz receiver - dane adresowe nadawcy oraz odbiorcy
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
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
pieceList - dane nt. paczek w przesyłce
type string Tak Typ paczki, mo┼╝liwe warto┼Ťci:
ENVELOPE - przesyłka kopertowa
PACKAGE - paczka
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)
blpPieceId string(32) Nie Identyfikator paczki (JJD) na etykiet─Ö BLP (dla klient├│w, kt├│rzy prowadz─ů w┼éasn─ů numeracj─Ö)

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)

Przykłady wywołania

<authData>
    <username>testomir</username>
    <password>testalski</password>
</authData>
<shipment>
    <shipmentInfo>
        <waybill>12345678910</waybill>
        <serviceType>ZC</serviceType>
        <bookCourier>true</bookCourier>
        <billing>
            <shippingPaymentType>RECEIVER</shippingPaymentType>
            <!-- okre┼Ťlenie strony, kt├│ra zostanie obci─ů┼╝ona kosztami, mo┼╝liwe opcje serviceType:
                RECEIVER - płaci odbiorca -->
            <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>UBEZP</serviceType>
                <serviceValue>20000</serviceValue>
            </item>
        </specialServices>
        <shipmentTime>
            <labelExpDate>2017-07-31</labelExpDate>
        </shipmentTime>
        <labelType>BLP</labelType>
        <!-- wyb├│r etykiety zwrotnej, mo┼╝liwe warto┼Ťci labelType:
            BLP - etykieta BLP w formacie PDF
            LBLP - etykieta BLP w formacie PDF A4
            ZBLP - etykieta BLP w formacie drukarek Zebra -->
    </shipmentInfo>
    <content>Gra komputerowa</content>
    <comment>ostro┼╝nie</comment>
    <reference>REF TESTREF TESTSTOP</reference>
    <primaryWaybillNumber>nr zlecenia</primaryWaybillNumber>
    <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>
                <country>CZ</country>
                <name>Janek</name>
                <postalCode>50011</postalCode>
                <city>Test</city>
                <street>Test</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>
                <country>PL</country>
                <name>Ja</name>
                <postalCode>00001</postalCode>
                <city>Wawa</city>
                <street>Le┼Ťna</street>
                <houseNumber>9</houseNumber>
                <apartmentNumber>59</apartmentNumber>
                <postnummer>123456789</postnummer>
                <isPackstation>false</isPackstation>
                <isPostfiliale>false</isPostfiliale>
            </address>
        </receiver>
    </ship>
    <pieceList>
        <item>
            <type>PACKAGE</type>
            <!-- typ paczki, mo┼╝liwe warto┼Ťci:
                ENVELOPE - przesyłka kopertowa
                PACKAGE - paczka -->
            <weight>20</weight>
            <width>60</width>
            <height>40</height>
            <length>40</length>
            <quantity>1</quantity>
        </item>
    </pieceList>
</shipment>
Wr├│─ç do listy temat├│w