Bokning Gränssnittsdokumentation Version 3.1
Datum: 2012-02-07 Sida 2 av 20 Revisionshistorik Version Datum Kommentarer 3.1 20120207 Consignor_identification_opal ändras från obligatorisk till icke-obligatorisk. Samt mindre uppdateringar och justeringar i kapitel1. 3.0 20110307 Contract_condition_code uppdaterad. Kontor Stockholm Coldsped borttaget. 2.30 20101011 Möjlighet att leverera bokningskvittens via fax är borttagen, confirmation_media_type accepterar inte längre FX. 2.20 20100322 Ihopslagning av HQF- respektive XML-dokumenten till en gränssnittsdokumentation. Lagt till exempel med godsposter. Äldre HQF-dokumentation Version Datum Kommentarer 2.11 20060823 Mer informativ text tillagd. 2.10 20060602 Tillägg av nya fält (från produktkod till transportbenämning). 2.00 20020226 Uppdaterat kontorsnummertabellen. 2.00 20010816 Tillägg av statistikvariabler under system. 1.50 20000302 Korrigerat referenser i standardfältet. 1.40 20000112 Korrigerat enligt WDR Ändrat request.service.type request.service.method Ändrat request.service.method request.service.type 1.30 19990927 Städat bort projektinformation 1.20 19990816 Följande variabler är ändrade: consignment_gross_weight från consignment_cube consignment_loading_meters consignment_package_count consignment_pallet_count consignment_halfpallet_count consignment_pallet_space total_gross_weight total_consignment_cube total_loading_meters total_package_count total_pallet_count total_halfpallet_count total_pallet_space Äldre XML-dokumentation Version Datum Kommentarer 2.00 20051101 Under <request> är tillagt <service><type> <admin><email> exempelxml:en korrigerad Värde booking Epost-adress för administration 2.00 20041112 Ändrat länk från http://www.cgi.webtrp.secgibin/cgiwrap/w01btl/prod2/online/bokning/xml_connector.pl till http://cgi.webtrp.com/cgibin/cgiwrap/w01btl/prod2/online/bokning/xml_connector.pl 2.00 20020226 Uppdaterat kontorsnummertabellen
Datum: 2012-02-07 Sida 3 av 20 2.00 20010816 Tillägg av statistikvariabler under system. 1.50 20000302 Korrigerat referenser i standardfältet. 1.40 20000112 Korrigerat enligt WDR Ändrat request.service.type request.service.method Ändrat request.service.method request.service.type 1.30 19990927 Städat bort projektinformation 1.20 19990816 Följande variabler är ändrade: consignment_gross_weight från consignment_cube consignment_loading_meters consignment_package_count consignment_pallet_count consignment_halfpallet_count consignment_pallet_space total_gross_weight total_consignment_cube total_loading_meters total_package_count total_pallet_count total_halfpallet_count total_pallet_space
Datum: 2012-02-07 Sida 4 av 20 INNEHÅLLSFÖRTECKNING REVISIONSHISTORIK... 2 1 BOKNING... 5 2 GENERELLA VARIABLER/NODER... 6 2.1 Request... 6 2.2 Response... 7 2.3 System... 7 3 INFORMATION OM EN BOKNING - MEDDELANDE IFTMBF... 8 3.1 Kontorsnummer... 11 4 EXEMPEL... 11 4.1 Exempel på bokning med HQF (utan godsrader):... 11 4.2 Exempel på bokning med HQF (med godsrader):... 12 4.3 Exempel på bokning med XML (utan godsrader):... 13 4.4 Exempel på bokning med XML (med godsrader):... 16 4.5 Exempel på svar i XML... 20
Datum: 2012-02-07 Sida 5 av 20 1 Bokning Tjänsten ger kunder möjlighet att koppla sig till Schenkers system och utföra en bokning. För tjänstens öppettider, samt övriga e-tjänsters öppettider se: http://www.schenker.se/servlet/se.ementor.econgero.servlet.presentation.main?data.node.id=291 89&data.language.id=1 Tjänsten kan anropas med hjälp av httprequest via XML alternativt HQF (Http Query Format, textformat) och returneras på samma sätt som du skickar in, XML eller HQF. Exempel på anrop respektive svar finns i dokumentet. Under utvecklingsskedet finns möjlighet att slå mot Schenkers testdata. Kontakta då vår kundtjänst så hjälper de dig att komma igång. Figur 1 Flödesskiss över tjänstens anrop För mer övergripande information om hur Schenkers e-tjänster är uppbyggda och anropas rekommenderas läsning i vårt separata introduktionsdokument. URL att anropa för HQF i produktion: http://cgi.webtrp.com/cgi-bin/cgiwrap/w01btl/prod2/online/bokning/booking_result.pl? URL att anropa för XML i produktion: http://cgi.webtrp.com/cgi-bin/cgiwrap/w01btl/prod2/online/bokning/xml_connector.pl?xml= Mer information om integration finns på: http://www.schenker.se/online
Datum: 2012-02-07 Sida 6 av 20 2 Generella variabler/noder De generella variablerna är till för att administrera kommunikationen och är gemensam för all kommunikation. De generella variablerna är: request, response och system. Variabeln data_list är en vektor av information med själva meddelandet som är specifikt per metod. För XML gäller <request>, <response>, <system> samt <data_list> som består av <data index=? > noder med meddelandets information. Ett XML dokument får bara innehålla en toppnod och därför omsluter vi de fyra ovan nämnda noderna med <xml>. En förfrågan kommer sålunda ha följande övergripande struktur: <?xml version= 1.0?> <xml> <request>...</request> <response>...</response> <system>...</system> <data_list> <data index= 0 >...</data> </data_list> </xml> 2.1 Request Innehåller information till tjänsten. Addera prefixet request. till variablerna vid HQF eller lägg in noderna under <xml><request> vid XML. Namn hqf Namn - xml O Typ Standard Längd Förklaring service.action <service><action> O String WDR 10 Värde insert service.method <service><method> O String WDR 10 Värde booking service.type <service><type> O String WDR 10 Värde booking user.name <user><name> String WDR 10 Användarnamn user.e_mail <user><email> String WDR 30 Användarens epost-adress format.mime <format><mime> String WDR 40 Format man skickar på. Vid xml anger man text/xml, vid HQF anger man text/plain format.type <format><type> String WDR - Typen på svaret. Värde kan vara url_simple eller full. Vilket man ska använda styrs av vad man skickar in i format.mime variabeln. Om formatet är text%2fplain så ska typen vara url_simple. Om formatet är text%2fhtml så ska typen vara full. För text%2fxml kan typen sättas till vad som helst. admin.email <admin><email> String WDR 30 Epost-adress för administration Rubriken O i tabellen står för obligatoriskt fält
Datum: 2012-02-07 Sida 7 av 20 2.2 Response Innehåller information från tjänsten. Hittas efter prefixet response. vid HQF eller under <xml><response> vid XML. Namn hqf Namn - xml O Typ Standard Längd Förklaring service.name <service><name> O String WDR - Namn på tjänsten service.version <service><version> O String WDR - Versionsnummer (1.0) data_list_count <data_list_count> O Int WDR - Antal i data_list Rubriken O i tabellen står för obligatoriskt fält 2.3 System Innehåller felkod från systemet. För HQF gäller att error.id = 0 betyder OK. För XML gäller att <system><error><id>0</id></error></system> betyder OK. Innehåller även statistikvariabler till systemet. Hittas efter prefixet system. vid HQF eller under <xml><system> vid XML. Namn hqf Namn - xml O Typ Standard Längd Förklaring error.id <error><id> O Int WDR 5 Felkod error.message <error><message> String WDR 100 Felmeddelande statistics.remote.ip_a ddress statistics.remote.coun try_code statistics.remote.send _data_format statistics.remote.acce ss_type statistics.remote.appli cation_name statistics.remote.admi n_e_mail statistics.user.return_ mime_format statistics.user.organiz ation_id statistics.user.langua ge_code statistics.service.api_ version statistics.service.nam e <statistics><remote> <ip_address> <statistics><remote> <country_code> <statistics><remote> <send_data_format> <statistics><remote> <access_type> <statistics><remote> <application_name> <statistics><remote> <admin_e_mail> <statistics><user><r eturn_mime_format> <statistics><user><o rganization_id> <statistics><user><l anguage_code> <statistics><service ><api_version> <statistics><service ><name> O String WDR - Klientens ip-adress O String WDR - Landskod för klient, ex. se eller us O String WDR - Klientens sätt att skicka sin Request, xml eller hqf (Http Query Format) O String WDR - Klientens anropstyp, A (browser) O String WDR - Klientens sida/modul som anropar O String WDR - E-mail till administratör för klient O String WDR - Klientens önskade svarsformat, text/plain, text/html eller text/xml O String WDR - Klientens organisationsnummer O String WDR - Språkkod för klient, ex. sv_se O String WDR - Gränssnittsversion, 2.30 O String WDR - Namn på applikation som anropas, ex. BookingConnector_002 statistics.request.serv <statistics><request O String WDR - insert ice.action ><service><action> statistics.request.serv <statistics><request O String WDR - booking ice.method ><service><method > Rubriken O i tabellen står för obligatoriskt fält
Datum: 2012-02-07 Sida 8 av 20 3 Information om en bokning - Meddelande IFTMBF Innehåller information om en beställning av hämtning av gods. Information som skickas till tjänsten tillsammans med request-variablerna. HQF Addera prefixet data_list.0. till variablerna. För godsposterna addera data_list.x. där x = 1,2,3 osv. Om endast en godspost finns så ska enbart värden skickas in i huvudposten. Om fler än en godspost så ska alla godsposter skickas in i godspost-arean. Utelämna då längd, bredd och höjd i huvudposten (där kommer de fälten från den godspost med längst längd att läggas in vid ankomst till Opal). Övriga godsuppgifter i huvudposten bör reflektera hela sändningen. XML Lägg in noden under <xml><data_list><data index= 0 >. Namn hqf Namn - xml O Typ Standard Längd Förklaring consignor_identification <consignor_identificatio n> O String NAD-CZ DE 3039 8 Kundnummer för avsändare, åtta siffror consignor_identification_ opal <consignor_identificatio n_opal> String NAD-CZ 1153-AHY DE 1154 5 Opal nummer, fem siffror AHY = Forwarders ref number (e.g for client) confirmation_media_typ e <confirmation_media_t ype> O String COM- 3155-EM 2 Kvittens-typ, COM 3155 = EM för email confirmation_address <confirmation_address > O String COM DE 3148 45 Adress för kvittens, t ex e-postadress transport_document_nu mber departure_carrier_office _number <transport_document_n umber> <departure_carrier_offi ce_number> String RFF 1153 - AAS DE 1154 O String NAD-CA 3139-TR DE 3413 consignor_name <consignor_name> String NAD CZ DE 3036 consignor_contact_pers <consignor_contact_pe O String NAD CZ on_name rson_name> DE 3412 despatch_address <despatch_address> String NAD-PW DE 3042 despatch_zip_number <despatch_zip_number String NAD-PW > DE 3251 despatch_city_name <despatch_city_name> String NAD-PW DE 3164 despatch_telephone_nu <despatch_telephone_ String NAD PW mber number> 3155-TE DE 3148 despatch_telefax_numb er <despatch_telefax_nu mber> String NAD PW 3155-FX DE 3148 pick_up_date <pick_up_date> Date DTM 2005-200 DE 2380 pick_up_from_time <pick_up_from_time> Time DTM 2005-234 DE 2380 10 Sändningsnummer 4 Kontorsnummer avgående kontor, max fyra siffror. Se kap 3.1 35 Kundnamn 35 Kontaktperson hos avsändare 35 Hämtningsadress 6 Hämtningsadress, postnummer 18 Hämtningsadress, ortsnamn 15 Hämtningsadress, telefonnummer 15 Hämtningsadress, telefax 8 Hämtningsdatum, YYYYMMDD 6 Hämtningstid, från och med, HHMMSS
Datum: 2012-02-07 Sida 9 av 20 Namn hqf Namn - xml O Typ Standard Längd Förklaring pick_up_to_time <pick_up_to_time> Time DTM 2005-235 DE 2380 consignor_open_from_ti me consignor_open_to_time consignor_lunch_from_ti me consignor_lunch_to_tim e <consignor_open_from _time> <consignor_open_to_ti me> <consignor_lunch_from _time> <consignor_lunch_to_ti me> Time Time Time Time NAD-CZ 2005-T90 DE 2380 NAD-CZ 2005-T91 DE 2380 NAD-CZ 2005-T92 DE 2380 NAD-CZ 2005-T93 DE 2380 consignee_name <consignee_name> String NAD-CN DE 3036 consignee_address <consignee_address> String NAD-CN DE 3042 consignee_zip_number <consignee_zip_numbe String NAD-CN r> DE 3251 6 Hämtningstid till och med, HHMMSS 6 Kundens öppethållande, från och med, HHMMSS 6 Kundens öppethållande, till och med, HHMMSS 6 Kundens lunchtid, från och med, HHMMSS 6 Kundens lunchtid, till och med, HHMMSS 35 Namn på mottagare 35 Mottagaradress 6 Mottagarens postnummer consignee_city_name <consignee_city_name > O String NAD-CN DE 3164 18 Mottagarort consignee_contact_pers on_name <consignee_contact_pe rson_name> String NAD-CN DE 3412 35 Kontaktperson hos mottagaren consignee_telephone_n umber consignee_telefax_num ber consignment_gross_wei ght <consignee_telephone _number> <consignee_telefax_nu mber> <consignment_gross_w eight> String NAD CN 3155-TE DE 3148 String NAD CN 3155-FX DE 3148 A Int CNT 6069-7 DE 6066 Unit 5411 consignment_cube <consignment_cube> A Float CNT 6069-15 DE 6066 Unit 6411 consignment_loading_m eters <consignment_loading_ meters> A Float CNT 6069-ZLM DE 6066 15 Telefonnummer till mottagaren 15 Telefaxnummer till mottagaren 9 Vikt (Kg) 7 Volym (Kbm) 5 Flakmeter (m) consignment_package_c ount <consignment_package _count> CNT ZLM A Int CNT 6069-11 DE 6066 9 Kolliantal (st) consignment_pallet_cou nt <consignment_pallet_c ount> CNT 11 A Int CNT 6069-16 DE 6066 4 Pallantal (st) consignment_halfpallet_ count <consignment_halfpalle t_count> CNT 16 A Int CNT 6069-Z14 DE 6066 Unit 6411 4 Halvpallantal (st) (Schenkerunik kod) consignment_pallet_spa ce <consignment_pallet_s pace> CNT Z14 A Float CNT 6069-Z12 DE 6066 6 Pall_platser (st) (Schenkerunik kod) CNT Z12
Datum: 2012-02-07 Sida 10 av 20 Namn hqf Namn - xml O Typ Standard Längd Förklaring package_length_dimensi on <package_length_dime nsion> A Float GID DE 6168 Unit 6411 8 Godslängd (m) package_width_dimensi on <package_width_dimen sion> DIM 6168 A Float GID DE 6140 Unit 6411 6 Godsbredd (m) package_height_dimensi on <package_height_dime nsion> DIM 6140 A Float GID DE 6008 Unit 6411 6 Godshöjd (m) booking_general_inform ation contract_condition_ dangerous_goods_code <booking_general_infor mation> <contract_condition_da ngerous_goods_code> String String DIM 6008 FTX 4451-AA1 DE 4440 TSR 7273-DAG 105 Kommentarrad, 3 st á 35 tecken Mottagarland om annat än Sverige 3 Tilläggstjänst "Farligt gods" (Schenker unik kod) DAG contract_condition_dang erous_goods_informatio n <contract_condition_da ngerous_goods_inform ation> String FTX 4451-AAC DE 4440 35 Kommentar om farligt gods contract_condition_trans port_code <contract_condition_tra nsport_code> String FTX 4451-AAC TSR 7273-EXP 3 Tilläggstjänst "Express" (Schenker unik kod) EXP contract_condition_temp erature_code <contract_condition_te mperature_code> String TSR 7273-HOT 7273-CLD 7273-FRZ 3 Tempererat gods: Välj en av HOT = varm, CLD = kyla, FRZ = frys (Schenker unik kod) contract_condition_code announcement_contact announcement_telephon e_number announcement_telefax_ number <contract_condition_co de> <announcement_conta ct> <announcement_teleph one_number> <announcement_telefa x_number> String 3 CLD=Coldsped, COM=System, DIR=Direct, PAR=Parcel, LPA=Parcel, SPC=Special, PRI=Privpak, HDG=Hemleverans String 18 Aviseringskontakt (om någon av aviseringsuppgifterna är ifyllda visas avisering i Opal) String 18 Aviseringstelefon (om någon av aviseringsuppgifterna är ifyllda visas avisering i Opal) String 18 Aviseringstelefax (om någon av aviseringsuppgifterna är ifyllda visas avisering i Opal) cash_on_delivery <cash_on_delivery> String 1 X = efterkrav finns annars blank carrier <carrier> String 1 X = inbärning finns annars blank delivery_date <delivery_date> Date 8 Tidlossningsdatum (om någon av tidslossningsuppgifterna är ifyllda visas tidlossning i Opal) delivery_time <delivery_time> Time 6 Tidlossningstid (om någon av tidslossningsuppgifterna är ifyllda visas tidlossning i Opal) service_insurance <service_insurance> Float 10 Varuförsäkring (om ifylld visas varuförsäkring i Opal) number_of_goods <number_of_goods> Int 3 Antal godsposter bifogade
Datum: 2012-02-07 Sida 11 av 20 Namn hqf Namn - xml O Typ Standard Längd Förklaring *package_gross_weight <package_gross_weigh t> Int 9 Vikt (kg) för godsposten *package_cube <package_cube> Float 7 Volym (kbm) för godsposten *package_count < package_count> Int 9 Kolli antal (st) för godsposten *package_length_dimen sion *package_width_dimensi on *package_height_dimen sion *package_address_clas s <package_length_dime nsion> <package_width_dimen sion> <package_height_dime nsion> <package_address_cla ss> Float 8 Längd (m) för godsposten Float 6 Bredd (m) för godsposten Float 6 Höjd (m) för godsposten String 7 Adrklass för godsposten *package_unno <package_unno> Int 4 Unnr för godsposten *package_dangerous_g oods_information <package_dangerous_ goods_information> String 50 Transportbenämning för godsposten (enbart 27 tecken kommer att läsas) I fältet (O)bligatoriskt finns tio fält markerade ett A. Minst ett av dessa fält måste anges. Huvudposter saknar stjärnmarkering * godspost 3.1 Kontorsnummer Värdet för &data_list.0.departure_carrier_office_number= kan anta följande: 430 Borlänge 356 Linköping 604 Värnamo 190 Borås 513 Luleå 638 Västerås 455 Gävle 174 Malmö 653 Växjö 158 Göteborg 281 Nybro 422 Örebro 3848 Halmstad 679 Skara 745 Örnsköldsvik 224 Helsingborg 372 Skellefteå 661 Östersund 463 Hultsfred 125 Stockholm 3426 Jönköping 380 Sundsvall 4721 Karlshamn 414 Umeå 315 Karlstad 596 Visby 4721 Kristianstad 448 Vänersborg 4 Exempel 4.1 Exempel på bokning med HQF (utan godsrader): http://cgi.webtrp.com/cgi-bin/cgiwrap/w01btl/prod2/online/bokning/booking_result.pl? request.service.action=insert &request.service.method=booking &request.service.type=booking &request.format.mime=text/plain
Datum: 2012-02-07 Sida 12 av 20 &request.format.type=url_simple &system.statistics.service.name=bookingconnector_002 &system.statistics.remote.ip_address=2 &system.statistics.service.api_version=2.30 &system.statistics.user.return_mime_format=html &system.statistics.remote.send_data_format=web2 &system.statistics.user.organization_id=[ert organisationsnummer] &system.statistics.user.language_code=sv &system.statistics.remote.country_code=se &system.statistics.remote.admin_e_mail=[er systemadministratörs e-postadress] &system.statistics.remote.access_type=a &system.statistics.remote.application_name=[er applikations namn varifrån bokningen skickas] &data_list.0.consignor_identification=[avsändarens kundnummer hos DB Schenker] &data_list.0.consignor_identification_opal=[avsändarens OPAL-nummer hos DB Schenker] &data_list.0.confirmation_media_type=em &data_list.0.confirmation_address=fornamn.efternamn@foretaget.se &data_list.0.departure_carrier_office_number=190 &data_list.0.consignor_name= &data_list.0.consignor_contact_person_name=förnamn+efternamn &data_list.0.despatch_city_name= &data_list.0.despatch_telephone_number=031+1234567 &data_list.0.pick_up_date=20100320 &data_list.0.consignee_name= &data_list.0.consignee_address= &data_list.0.consignee_city_name= &data_list.0.consignee_contact_person_name= &data_list.0.consignee_telephone_number=031+7654321 &data_list.0.consignment_gross_weight=150 &data_list.0.booking_general_information= 4.2 Exempel på bokning med HQF (med godsrader): http://cgi.webtrp.com/cgi-bin/cgiwrap/w01btl/prod2/online/bokning/booking_result.pl? request.service.action=insert &request.service.method=booking &request.service.type=booking &request.user.name=[användarnamn] &request.user.email=[er e-postadress] &request.format.mime=text/plain &request.admin.email=[er administratörs e-postadress] &system.statistics.remote.ip_address=[er ip-adress] &system.statistics.remote.country_code=se &system.statistics.remote.send_data_format=web2 &system.statistics.remote.access_type=a &system.statistics.remote.application_name=[er applications namn] &system.statistics.remote.admin_e_mail=[er administratörs e-postadress] &system.statistics.user.return_mime_format=text/plain &system.statistics.user.organization_id=[ert organisationsnummer] &system.statistics.user.language_code=sv_se &system.statistics.service.api_version=2.30 &system.statistics.service.name=bookingconnector_002 &system.statistics.request.service.action=insert &system.statistics.request.service.method=booking &data_list.0.consignor_identification=[avsändarens kundnummer hos DB Schenker] &data_list.0.consignor_identification_opal=[avsändarens OPAL-nummer hos DB Schenker] &data_list.0.confirmation_media_type=em
Datum: 2012-02-07 Sida 13 av 20 &data_list.0.confirmation_address=[adress för kvittens] &data_list.0.departure_carrier_office_number=[kontorsnummer] &data_list.0.consignor_name=[avsändarens namn] &data_list.0.consignor_contact_person_name=[kontaktperson hos avsändaren] &data_list.0.despatch_city_name=[hämtningsadress, ortsnamn] &data_list.0.despatch_telephone_number=[hämtningsadress, telefonnummer] &data_list.0.pick_up_date=[hämtningsdatum YYYYMMDD] &data_list.0.consignee_city_name=[mottagarort] &data_list.0.consignment_gross_weight=[vikt (kg)] &data_list.0.announcement_contact=[aviseringskontakt] &data_list.0.announcement_telephone_number=[aviseringstelefon] &data_list.0.cash_on_delivery=x &data_list.0.number_of_goods=1 &data_list.1.package_gross_weight=[vikt (kg) för godsposten] &data_list.1.package_count=1 4.3 Exempel på bokning med XML (utan godsrader): http://cgi.webtrp.com/cgi-bin/cgiwrap/w01btl/prod2/online/bokning/xml_connector.pl?xml= <?xml version="1.0" encoding="iso-8859-1"?> <xml> <request> <format> <mime> text/xml </mime> </format> <service> <action> insert </action> <method> booking </method> <type> booking </type> </service> <user> <name> [användarnamn] </name> <email> [er e-postadress] </email> </user> <admin> <email> [er administratörs e-postadress] </email> </admin> </request> <system> <statistics> <remote> <ip_address> [er ip-adress]
Datum: 2012-02-07 Sida 14 av 20 </ip_address> <country_code> se </country_code> <send_data_format> xml </send_data_format> <access_type> A </access_type> <application_name> [er applikations namn] </application_name> <admin_e_mail> [er administratörs e-postadress] </admin_e_mail> </remote> <service> <api_version> 2.30 </api_version> <name> BookingConnector_002 </name> </service> <user> <return_mime_format> text/xml </return_mime_format> <organization_id> [ert organisationsnummer] </organization_id> <language_code> sv_se </language_code> </user> <request> <service> <action> insert </action> <method> booking </method> </service> </request> </statistics> </system> <data_list> <data index="0"> <consignor_identification> [avsändarens kundnummer hos DB Schenker] </consignor_identification> <consignor_identification_opal> [avsändarens OPAL-nummer hos DB Schenker] </consignor_identification_opal> <confirmation_media_type>
Datum: 2012-02-07 Sida 15 av 20 EM </confirmation_media_type> <confirmation_address> [adress för kvittens] </confirmation_address> <transport_document_number/> <departure_carrier_office_number> [kontorsnummer] </departure_carrier_office_number> <consignor_name> [avsändarens namn] </consignor_name> <consignor_contact_person_name> [kontaktperson hos avsändaren] </consignor_contact_person_name> <despatch_address/> <despatch_zip_number/> <despatch_city_name/> <despatch_telephone_number> [hämtningsadress, telefonnummer] </despatch_telephone_number> <despatch_telefax_number/> <pick_up_date> [hämtningsdatum, YYYYMMDD] </pick_up_date> <pick_up_from_time/> <pick_up_to_time/> <consignor_open_from_time/> <consignor_open_to_time/> <consignor_lunch_from_time/> <consignor_lunch_to_time/> <consignee_name/> <consignee_address/> <consignee_zip_number/> <consignee_city_name> [mottagningsort] </consignee_city_name> <consignee_contact_person_name> [kontaktperson hos mottagaren] </consignee_contact_person_name> <consignee_telephone_number> [mottagarens telefonnummer] </consignee_telephone_number> <consignee_telefax_number/> <consignment_gross_weight> [vikt (kg)] </consignment_gross_weight> <consignment_cube/> <consignment_loading_meters/> <consignment_package_count/> <consignment_pallet_count/> <consignment_halfpallet_count/> <consignment_pallet_space/> <package_length_dimension/> <package_width_dimension/> <package_height_dimension/> <booking_general_information>
Datum: 2012-02-07 Sida 16 av 20 [information, mottagningsland om annat än Sverige] </booking_general_information> <contract_condition_dangerous_goods_code/> <contract_condition_dangerous_goods_information/> <contract_condition_transport_code/> <contract_condition_temperature_code/> </data> </data_list> </xml> 4.4 Exempel på bokning med XML (med godsrader): <?xml version="1.0"encoding="iso-8859-1"?> <xml> <request> <service> <action> insert </action> <method> booking </method> <type> booking </type> </service> <user> <name> [användarnamn] </name> <email> [er e-postadress] </email> </user> <format> <mime> text/xml </mime> </format>...<admin> <email> [er e-postadress] </email>...</admin> </request>..<system> <statistics> <remote> <ip_address> [er ip-adress] </ip_address> <country_code> se </country_code> <send_data_format>
Datum: 2012-02-07 Sida 17 av 20 xml </send_data_format> <access_type> A </access_type> <application_name> [er applications namn] </application_name> <admin_e_mail> [er e-postadress] </admin_e_mail> </remote> <user> <return_mime_format> text/xml </return_mime_format> <organization_id> [ert organisationsnummer] </organization_id> <language_code> sv_se </language_code> </user> <service> <api_version> 2.30 </api_version> <name> BookingConnector_002 </name> </service> <request> <service> <action> insert </action> <method> booking </method> </service> </request> </statistics> </system> <data_list> <data index="0"> <consignor_identification> [avsändarens kundnummer hos DB Schenker] </consignor_identification> <consignor_identification_opal> [avsändarens OPAL-nummer hos DB Schenker] </consignor_identification_opal> <confirmation_media_type> EM </confirmation_media_type> <confirmation_address> fornamn.efternamn@foretaget.se </confirmation_address>
Datum: 2012-02-07 Sida 18 av 20 <transport_document_number> [ert sändningsnummer] </transport_document_number> <departure_carrier_office_number> 0 </departure_carrier_office_number> <consignor_name> [avsändarens namn] </consignor_name> <consignor_contact_person_name> [kontaktperson hos avsändaren] </consignor_contact_person_name> <despatch_address> [hämtningsadress] </despatch_address> <despatch_zip_number> [postnummer hämtningsadress] </despatch_zip_number> <despatch_city_name> [ort hämtningsadress] </despatch_city_name> <despatch_telephone_number> [avsändarens telefonnummer] </despatch_telephone_number> <despatch_telefax_number/> <pick_up_date> [datum för upphämtning, YYYYMMDD] </pick_up_date> <pick_up_from_time> [hämtningstid fr.o.m.] </pick_up_from_time> <pick_up_to_time> [hämtningstid t.o.m.] </pick_up_to_time> <consignor_open_from_time/> <consignor_open_to_time /> <consignor_lunch_from_time /> <consignor_lunch_to_time /> <consignee_name> [mottagarens namn] </consignee_name> <consignee_address> [mottagarens adress] </consignee_address> <consignee_zip_number> [mottagarens postnummer] </consignee_zip_number> <consignee_city_name> [mottagarens ort] </consignee_city_name> <consignee_contact_person_name/> <consignee_telephone_number> [mottagarens telefonnummer] </consignee_telephone_number> <consignee_telefax_number/> <consignment_gross_weight> 2
Datum: 2012-02-07 Sida 19 av 20 </consignment_gross_weight> <consignment_cube/> <consignment_loading_meters/> <consignment_package_count> 1 </consignment_package_count> <consignment_pallet_count/> <consignment_halfpallet_count/> <consignment_pallet_space/> <package_length_dimension> 0.2 </package_length_dimension> <package_width_dimension> 0.1 </package_width_dimension> <package_height_dimension> 0.1 </package_height_dimension> <contract_condition_dangerous_goods_code/> <contract_condition_dangerous_goods_information/> <contract_condition_transport_code/> <contract_condition_temperature_code/> <contract_condition_code> COM </contract_condition_code> <announcement_telephone_number> [aviseringstelefon] </announcement_telephone_number> <announcement_telefax_number> [aviseringstelefax] </announcement_telefax_number> <cash_on_delivery> X </cash_on_delivery> <number_of_goods> 2 </number_of_goods> </data> <data index="1"> <package_gross_weight> 2 </package_gross_weight> <package_count> 1 </package_count> <package_address_class> II </package_address_class> <package_unno> [unnummer för godsposten] </package_unno> <package_dangerous_goods_information> [transportbenämning för godsposten] </package_dangerous_goods_information> </data> <data index="2"> <package_gross_weight>
Datum: 2012-02-07 Sida 20 av 20 2 </package_gross_weight> <package_count> 1 </package_count> <package_address_class> 123 </package_address_class> <package_unno> [unnummer för godsposten] </package_unno> <package_dangerous_goods_information> [transportbenämning för godsposten] </package_dangerous_goods_information> </data> </data_list> </xml> 4.5 Exempel på svar i XML <?xml version="1.0"?> <xml> <response> <data_list_count>0</data_list_count> <service> <version>1.0</version> <name>booking</name> </service> </response> <system> <error> <message> Your+request+was+successfully+processed. </message> <id>0</id> </error> </system> <data_list> <data index="0" /> </data_list> <request/> </xml>