Opis plików wymiany danych. WPROWADZENIE...2 PLIKI XML...2 PRZYKŁADOWE WARTOŚCI W PLIKU XML...5 PLIKI PDF...BŁĄD! NIE ZDEFINIOWANO ZAKŁADKI. DHL 2012 Strona 1 z 7
Wprowadzenie Dokument opisuje poszczególne pliki wejściowe używane w przypadku integracji platform klientów i DHL. Pliki XML Pole Długosc Opis <?xml version="1.0" encoding="windows-1250"?> Standard pliku <LIST> Znacznik początku pliku <SHIPMENT_ID>12345678900</SHIPMENT_ID> 11 Numer lp gdy nr generowany przez klienta <SENDER_ID>1234567</SENDER_ID> 7 Sap nadawcy - może być puste <SENDER_NAME>TEST POLSKA SP.ZO.O.</SENDER_NAME> 45 Nazwa nadawcy - może być puste <SENDER_POSTCODE>42600</SENDER_POSTCODE> 5 Kod nadawcy - może być puste <SENDER_CITY>TARNOWSKIE GÓRY</SENDER_CITY> 17 Miasto nadawcy - może być puste <SENDER_STREET>TOWAROWA</SENDER_STREET> 22 Ulica nadawcy - może być puste <SENDER_HOUSENUMBER>1</SENDER_HOUSENUMBER> 7 Numer domu nadawcy - może być puste <SENDER_TEL>032-200-22022</SENDER_TEL> 22 Telefon nadawcy - może być puste <PRE_SEN_SMS>323223232</PRE_SEN_SMS> 9 Numer telefonu nadawcy do preawizacji <PRE_SEN_EMAIL>AAA@BBB.COM</PRE_SEN_EMAIL> 50 Adres e-mail nadawcy do preawizacji <RECEIVER_ID>TESST</RECEIVER_ID> 15 Pole kluczujące unikatowe odbiorcy <RECEIVER_NAME>RECEIVER NAME</RECEIVER_NAME> 45 Nazwa drukowana odbiorcy <RECEIVER_POSTCODE>78600</RECEIVER_POSTCODE> 5 Kod odbiorcy <RECEIVER_CITY>CITY</RECEIVER_CITY> 17 Nazwa miasta <RECEIVER_STREET>TEST</RECEIVER_STREET> 22 Ulica DHL 2012 Strona 2 z 7
<RECEIVER_HOUSENUMBER>12</RECEIVER_HOUSENUMBER> 7 Numer domu <RECEIVER_TEL>22 2131231</RECEIVER_TEL> 22 Telefon <PRE_REC_SMS>600000000</PRE_REC_SMS> 9 Numer telefonu odbiorcy do preawizacji <PRE_REC_EMAIL>AAA@AAA.COM</PRE_REC_EMAIL> 50 Adres e-mail odbiorcy do preawizacji <PRE_REC_EMAIL_ADDTEXT>123 232 100 Tekst e-mail odbiorcy do preawizacji 32323</PRE_REC_EMAIL_ADDTEXT> <THI_ID>ID</THI_ID> 7 Id zleceniodawcy <THI_NAME>NAME</THI_NAME> 45 Nazwa zleceniodawcy <THI_POSTCODE>01234</THI_POSTCODE> 5 Kod zleceniodawcy <THI_CITY>CITY</THI_CITY> 17 Miasto zleceniodawcy <THI_STREET>STREET</THI_STREET> 22 Ulica zleceniodawcy <THI_HOUSENUMBER>NUMBER</THI_HOUSENUMBER> 7 Numer domu zleceniodawcy <THI_TELEFON>48 22 123123123</THI_TELEFON> 22 Telefon zleceniodawcy <PRODUCT>AH</PRODUCT> 2 Typ produktu AH, 09 lub 12 <INVOICE_TO>N</INVOICE_TO> 1 Platnik n/o/z <PAYMENT_TYPE>P</PAYMENT_TYPE> 1 Płatność za usługę dla n=p o=g <DOCUMENT>999</DOCUMENT> 3 Kategoria 0 podajemy il sztuk paczek. <CATEGORY1>999</CATEGORY1> 3 Kategoria 1 podajemy il sztuk paczek. <CATEGORY2>999</CATEGORY2> 3 Kategoria 2 podajemy il sztuk paczek. <CATEGORY3>999</CATEGORY3> 3 Kategoria 3 podajemy il sztuk paczek. <CATEGORY4>999</CATEGORY4> 3 Kategoria 4 podajemy il sztuk paczek. <NON_STANDARD_TO_31KG>999</NON_STANDARD_TO_31KG> 3 Ilość niestandardowych paczek do 31 kg. <TOTAL_OVER_31KG>999</TOTAL_OVER_31KG> 3 Ilość paczek powyżej 31 kg <TOTAL_WEIGHT>2500</TOTAL_WEIGHT> 4 Suma wag palet <WEIGHT_TYPE>R</WEIGHT_TYPE> 1 Typ wagi zawsze r <NUMBER_EURO_PAL>999</NUMBER_EURO_PAL> 3 Ilość palet euro ( opcja zwrot palet) <PAL_TO_200KG>999</PAL_TO_200KG> 3 Paleta do 200 <PAL_TO_400KG>999</PAL_TO_400KG> 3 Paleta do 400 <PAL_TO_600KG>999</PAL_TO_600KG> 3 Paleta do 600 <PAL_TO_800KG>999</PAL_TO_800KG> 3 Paleta do 800 kg <PAL_TO_1000KG>999</PAL_TO_1000KG> 3 Paleta do 1000 kg <NUMBER_NON_STANDARD_PAL>999</NUMBER_NON_STANDARD_PAL> 3 Ilość niestandardowych powyzej 31 kg DHL 2012 Strona 3 z 7
<ON_TIME_DELIVERY>1722</ON_TIME_DELIVERY> 4 Doręczenie terminowe (1722;so) <CASH_ON_DELIVERY>11000</CASH_ON_DELIVERY> 5 Kwota pobrania <COD_REFERENCE>FV123</COD_REFERENCE> 20 Pole referencja pobrania na lp <RETURN_ON_DELIVERY>Y</RETURN_ON_DELIVERY> 1 Usługa zwrotu potwierdzonego dokumentu <ROD_REFERENCE>WZ:1234/34/2005</ROD_REFERENCE> 20 Nazwa dokumentu zwrotnego <GOODS_VALUE>100000</GOODS_VALUE> 6 Wartość netto wysyłanego towaru ubezp. <CONFIRMATION_OF_RECEIPT>Y</CONFIRMATION_OF_RECEIPT> 1 Usługa potwierdzenia doręczenia <SELF_RECEIPT>Y</SELF_RECEIPT> 1 Odbiór własny poprawka <COSTS_CENTER>COST CENTRE</COSTS_CENTER> 20 Pole mpk na lp <COMMENT>ADDITIONAL COMMENTS</COMMENT> 100 Pole uwagi na lp <CUSTOMER_REFERENCE>123_123_123</CUSTOMER_REFERENCE> 35 Referencje klienta dla t&t <CONTENT></CONTENT> 20 Zawartość <BLP>1</BLP> 1 Znacznik blp (0,1) <TNTROD>1234567890</TNTROD> 12 Numer dokumentu zwrotnego przyznawany przez DHL <TNTROD_ID>2</TNTROD_ID> 15 ID odbiorcy do zwrotu Dokumentów <ITEMS>JJD000031000000000000504: JJD000031000000000000604</ITEMS> Numery paczek. W przypadku gdy numery kolejne tylko pierwszy numer paczki. W innych przypadkach numery paczek oddzielane : <TOUR_ID>169</TOUR_ID> 3 Numer kuriera odbierającego paczki od klienta <PDI>Y</PDI> 1 Znacznik usługi PDI Pre Delivery Information UWAGA musi być podany telefon do odbiorcy w Tagu <RECEIVER_TEL> - możliwe wartości : T, Y,1 oznacza użycie usługi. <VIP>Y</VIP> 1 Znacznik usługi Doręczenie Monitorowane - - możliwe wartości : T, Y,1 oznacza użycie usługi. <ROD_DOC>WZ12333</ROD_DOC> 30 <Pickup_Timestamp>2011-03-31</Pickup_Timestamp> Opcjonalnie jak chcemy sterować data nadania z pliku - Format daty to yyyy-mm-dd </LIST> Znacznik końca pliku DHL 2012 Strona 4 z 7
Przykładowe wartości w pliku XML Nazwa pola Przykładowa wartość Uwagi SHIPMENT_ID 12345678900 Numer LP z sumą kontrolną, może być użyty tylko z przyznanego zakresu. RECEIVER_NAME Jan Kowalski sp zoo Nazwa odbiorcy przesyłki RECEIVER_POSTCODE 96300 Kod pocztowy odbiorcy 5 cyfr bez tzw kreski musi być zgodny z bazą kodów pocztowych DHL RECEIVER_CITY Żyrardów Miasto odbiorcy RECEIVER_STREET Bohaterów Warszawy Ulica odbiorcy przesyłki RECEIVER_TEL 46 855 55 55 Telefon do odbiorcy przesyłki PRODUCT AH AH przesyłki serwisu krajowego, SM przesyłki serwisu miejskiego INVOICE_TO N Płatnik za usługę transportową N- nadawca O - odbiorca DOCUMENT 1 Liczba przesyłek kopertowych w przesyłce CATEGORY1 1 Liczba przesyłek kategorii 1 CATEGORY2 1 Liczba przesyłek kategorii 2 CATEGORY3 1 Liczba przesyłek kategorii 3 CATEGORY4 1 Liczba przesyłek kategorii 4 NON_STANDARD_TO_31KG 1 Liczba elementów niestandardowych expresowych w przesyłce nie może być większa od sumy sztuk Kat0 do kat 4 TOTAL_OVER_31KG 1 Liczba sztuk przesyłek drobnicowych nie spaletyzowanych TOTAL_WEIGHT 25 Suma wag wszystkich elementów w przesyłce uwaga nie może przekraczać 2500 kg NUMBER_EURO_PAL 1 Liczba palet euro jakie maja być zwrócone nadawcy po doręczniu przesyłki. Możliwe użycie usługi pod warunkiem wpisania ilości sztuk w kategorie PAL_TO_200KG, PAL_TO_400KG, PAL_TO_600KG, PAL_TO_800KG, PAL_TO_1000KG. Ilość DHL 2012 Strona 5 z 7
nie może przekraczać sumy elementów z tych kategorii PAL_TO_200KG 1 Ilość elementów na palecie o wadze do 200 kg PAL_TO_400KG 1 Ilość elementów na palecie o wadze od 200 kg do 400 kg PAL_TO_600KG 1 Ilość elementów na palecie o wadze od 400 kg do 600 kg PAL_TO_800KG 1 Ilość elementów na palecie o wadze od 600 kg do 800 kg PAL_TO_1000KG 1 Ilość elementów na palecie o wadze od 800 kg do 1000 kg NUMBER_NON_STANDARD_PAL 1 ILOŚĆ NIESTANDARDOWYCH POWYZEJ 31 KG. ON_TIME_DELIVERY 1722 Doręczenie teminowe 1722(doręczenie od 17.00do 22.00 w dni robocze), SO (doręczenie w sobotę) zasady używania patrz opis przesyłek Europremium Polska CASH_ON_DELIVERY 123,99 Kwota pobrania zasady patrz opis przesyłek Europremium Polska. Separator dziesiętny przecinek W przypadku braku usługi 0,00 RETURN_ON_DELIVERY Y Y- usługa zwrot dokumentu do przesyłki, N- brak usługi GOODS_VALUE 1000 Wartość towaru do ubezpieczenia przesyłki musi być zawsze gdy jest usługa COD. Wartość podajemy w pełnych złotych. CONFIRMATION_OF_RECEIPT Y Usługa zwrotu potwierdzonej kopii LP POD Y- ma być POD N brak usługi SELF_RECEIPT Y Odbiorca odbiera przesyłkę w terminalu DHL. Y- usługa ma być dla tej przesyłki N- brak usługi COSTS_CENTER 1233/q MPK miejsce powstawania kosztów dla nadawcy do rozliczenia kosztów może być zwrotnie na fakturze lub załączniku do niej max 20 znaków DHL 2012 Strona 6 z 7
COMMENT Uwagi Pole komentarza do przesyłki max 100 znaków do dowolnego użycia przez nadawce CUSTOMER_REFERENCE 12/wa Referencja do przesyłki max 20 znaków po tej referencji klient może sprawdzić losy przesyłki na stornie www.dhl.com.pl w Track & Trace. CONTENT Monitor Zawartość przesyłki PDI Y Usługa PDI kurier kontaktuje się z odbiorcą przed doręczeniem przesyłki ważne musi byc podany telefon do odbiorcy VIP Y Usługa doreczenie monitorowane ROD_DOC WZ1222230 Pole opisowe dla dokumentów zwrotnych usługa ROD - max 30 znaków Pickup_Timestamp 2011-03-31 Jeżeli chcemy sterować data nadania z pliku xml KASOWANIE LP za pomocą XML: <?xml version='1.0' encoding='windows-1250'?> <LIST> <Header>DHL0204200</Header> <SHIPMENT_ID>-10380890251</SHIPMENT_ID> </LIST> nr LP do skasowania poprzedzony jest znakiem - (minus) W plikach XML może być stosowane również kodowanie UTF-8 DHL 2012 Strona 7 z 7