Datum: 2005-11-01 Sida 1 av 9 Gränssnitt Bokning IFTMBF 1 Generella noder De generella noderna är till för för att administrera kommunikationen och är gemensamma för all kommunikation. De tre är: <request, <response och <system Den fjärde är <data_list som består av <data index=? noder med meddelandets information. Rubriken O står för obligatoriskt fält. 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 1.1 <request Innehåller information till tjänsten. Lägg in noderna under <xml<request Namn O Typ Standard Längd Förklaring <service<action O String WDR 10 Värde insert <service<method O String WDR 10 Värde booking <service<type O String WDR 10 Värde booking <user<name String WDR 10 Användarnamn <user<email String WDR 30 Användarens epost-adress <format<mime String WDR 40 Format man skickar på. Tex text/xml <admin<email String WDR 30 Epost-adress för administration 1.2 <response Innehåller information från tjänsten.. Noderna ligger under <xml<response. Namn O Typ Standard Längd Förklaring <service<name O String WDR - Namn på tjänsten <service<version O String WDR - Versionsnummer (1.0) <data_list_count O Int WDR - Antal i data_list
Datum: 2005-11-01 Sida 2 av 9 1.3 <system Innehåller felkod från systemet. <system<error<id0</id</error</system betyder OK. Innehåller statistikvariabler till systemet. Noderna ligger under <xml<system. Namn O Typ Standard Längd Förklaring <error<id O Int WDR 5 Felkod <error<message String WDR 100 Felmeddelande <statistics<remote<ip_address O String WDR - Klientens ip-adress <statistics<remote<country_code <statistics<remote<send_data_fo rmat 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) <statistics<remote<access_type O String WDR - Klientens anropstyp, A (browser) <statistics<remote<application_n O String WDR - Klientens sida/modul som anropar ame <statistics<remote<admin_e_mai O String WDR - E-mail till adm. för klient l <statistics<user<return_mime_fo rmat O String WDR - Klientens önskade svarsformat, text/plain, text/html eller text/xml <statistics<user<organization_id O String WDR - Klientens organisationsnummer <statistics<user<language_code O String WDR - Språkkod för klient, ex. sv_se <statistics<service<api_version O String WDR - Gränssnittsversion, 2.0 <statistics<service<name O String WDR - Namn på applikation som anropas, ex. BookingConnector_002 <statistics<request<service<act ion <statistics<request<service<me thod O String WDR - insert O String WDR - booking
Datum: 2005-11-01 Sida 3 av 9 2 Meddelande IFTMBF Innehåller information om en beställning av hämtning av gods. I fältet (O)bligatoriskt finns 10 noder markerade ett A. Minst en av dessa noder måste anges. Lägg in noderna under <xml<data_list<data index= 0 Namn O Typ Standard Längd Förklaring <consignor_identification O String NAD-CZ DE 3039 8 Kundnummer för avsändare, 8 siffror <consignor_identification_opal O String NAD-CZ 1153-AHY DE 1154 5 Opal nummer 5 siffror AHY = Forwarders ref number (e.g for client) <confirmation_media_type O String COM- 3155-EM 3155-FX <confirmation_address O String COM <transport_document_number String RFF 1153-AAS DE 1154 <departure_carrier_office_number O String NAD-CA 3139-TR DE 3413 <consignor_name String NAD CZ DE 3036 <consignor_contact_person_name O String NAD CZ DE 3412 <despatch_address String NAD-PW DE 3042 <despatch_zip_number String NAD-PW DE 3251 <despatch_city_name String NAD-PW DE 3164 <despatch_telephone_number String NAD PW 3155-TE <despatch_telefax_number String NAD PW 3155-FX <pick_up_date Date DTM 2005-200 <pick_up_from_time Time DTM 2005-234 <pick_up_to_time Time DTM 2005-235 <consignor_open_from_time Time NAD-CZ 2005-T90 <consignor_open_to_time Time NAD-CZ 2005-T91 <consignor_lunch_from_time Time NAD-CZ 2005-T92 <consignor_lunch_to_time Time NAD-CZ 2005-T93 <consignee_name String NAD-CN DE 3036 2 Kvittens-typ COM 3155 = EM för email och FX för Fax 35 Adress för kvittens, t ex faxnummer 10 Sändningsnummer max 10 siffror 4 Kontorsnummer avgående kontor, max 4 siffror 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 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
Datum: 2005-11-01 Sida 4 av 9 <consignee_address String NAD-CN DE 3042 <consignee_zip_number String NAD-CN DE 3251 <consignee_city_name O String NAD-CN DE 3164 <consignee_contact_person_name String NAD-CN DE 3412 <consignee_telephone_number String NAD CN 3155-TE <consignee_telefax_number String NAD CN 3155-FX <consignment_gross_weight A Int CNT 6069-7 Unit 5411 <consignment_cube A Float CNT 6069-15 <consignment_loading_meters A Float CNT 6069-ZLM CNT ZLM <consignment_package_count A Int CNT 6069-11 CNT 11 <consignment_pallet_count A Int CNT 6069-16 CNT 16 <consignment_halfpallet_count A Int CNT 6069-Z14 CNT Z14 <consignment_pallet_space A Float CNT 6069-Z12 CNT Z12 <package_length_dimension A Float GID DE 6168 DIM 6168 <package_width_dimension A Float GID DE 6140 DIM 6140 <package_height_dimension A Float GID DE 6008 DIM 6008 <booking_general_information String FTX 4451-AA1 DE 4440 <contract_condition_dangerous_go String TSR 7273-DAG 35 Mottagaradress 6 Mottagarens postnummer 18 Mottagarort 35 Kontaktperson hos mottagaren 15 Telefonnummer till mottagaren 15 Telefaxnummer till mottagaren 9 Vikt (Kg) 7 Volym (Kbm) 10 Flakmeter (m) 10 Kolliantal (st) 10 Pallantal (st) 10 Halvpallantal (st) (Schenker unik kod) 10 Pall_platser (st) (Schenker unik kod) 10 Godslängd (m) 10 Godsbredd (m) 10 Godshöjd (m) 105 Kommentarrad. Max 105 tecken. Mottagarland om annat än Sverige 3 Tilläggstjänst "Farligt gods" (Schenker unik kod) DAG
Datum: 2005-11-01 Sida 5 av 9 ods_code <contract_condition_dangerous_go ods_information <contract_condition_transport_code <contract_condition_temperature_c ode String FTX 4451-AAC DE 4440 FTX 4451-AAC String TSR 7273-EXP String TSR 7273-HOT 7273-CLD 7273-FRZ 35 Kommentar om farligt gods 3 Tilläggstjänst "Express" (Schenker unik kod) EXP 3 Tempererat gods: Välj en av HOT = varm, CLD = kyla, FRZ = frys (Schenker unik kod) 2 Anrop av scripten <?xml version="1.0" encoding="iso-8859-1"? <xml <data_list <data index="0" <consignor_identification [Avsändarens kundnummer hos Schenker-BTL] </consignor_identification <consignor_identification_opal [opalnummer] </consignor_identification_opal <confirmation_media_type EM </confirmation_media_type <confirmation_address [E-post address] </confirmation_address <transport_document_number/ <departure_carrier_office_number [Kontorsnummer] </departure_carrier_office_number <consignor_name [Mottagarens 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 [Avsändarens telefonnummer] </despatch_telephone_number <despatch_telefax_number/ <pick_up_date [Datum för upphämtning] </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/
Datum: 2005-11-01 Sida 6 av 9 <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] </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 [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 <system <statistics <remote <ip_address[ip_address]</ip_address <country_codese</country_code <send_data_formatxml</send_data_format <access_typea</access_type <application_name[applikationsnamn]</application_name <admin_e_mail[emailadress]</admin_e_mail </remote <service <api_version2.0</api_version <namebookingconnector_002</name </service <user <return_mime_formattext/xml</return_mime_format <organization_id[organisationsnr]</organization_id <language_codesv_se</language_code </user <request <service <actioninsert</action <methodbooking</method </service </request
Datum: 2005-11-01 Sida 7 av 9 </statistics </system <request <format <mimetext/xml</mime <typefull</type </format <service <actioninsert</action <methodbooking</method <typebooking</type </service <user <name[namn]</name <email[emailadress]</email </user <admin <email[emailadress]</email </admin </request </xml Adresser man anropar är (endast POST): Produktion http://www.services.wantech.se/cgi-bin/cgiwrap/w01btl/prod2/online/bokning/ xml_connector.pl Test: http://www.services.wantech.se/cgi-bin/cgiwrap/w01btl/test2/online/bokning/ xml_connector.pl Svaret kan se ut på följande sätt: <?xml version="1.0"? <xml <response <data_list_count0</data_list_count <service <version1.0</version <namebooking</name </service </response <system <error <message Your+request+was+successfully+processed. </message <id0</id </error </system <data_list <data index="0" / </data_list <request/
Datum: 2005-11-01 Sida 8 av 9 </xml &data_list.0.departure_carrier_office_number= 430 Borlänge 356 Linköping 448 Vänersborg 190 Borås 513 Luleå 604 Värnamo 455 Gävle 174 Malmö 638 Västerås 158 Göteborg 281 Nybro 653 Växjö 3848 Halmstad 679 Skara 422 Örebro 224 Helsingborg 372 Skellefteå 745 Örnsköldsvik 463 Hultsfred 125 Stockholm 661 Östersund 3426 Jönköping 943 Stockholm Coldsped 4721 Karlshamn 380 Sundsvall 315 Karlstad 414 Umeå 4721 Kristianstad 596 Visby
Datum: 2005-11-01 Sida 9 av 9 4 Versionshistorik 2.00 051101 Under rubriken 1.1 <request är tillagt <service<type Värde booking <admin<email Epost-adress för administ xml:en under rubrik "2 Anrop av scripten" korrigerad. 2.00 041112 Ändrat länk i kapitel 3 från http://www.cgi.webtrp.secgi-bin/cgiwrap/w01btl/prod2/online/bokning/xml_connector.pl till http://cgi.webtrp.com/cgi-bin/cgiwrap/w01btl/prod2/online/bokning/xml_connector.pl 2.00 020226 Uppdaterat kontorsnummertabellen 2.00 010816 Tillägg av statistikvariabler under system. 1.50 000302 Korrigerat referenser i standardfältet 1.40 000112 Korrigerat enligt WDR Ändrat request.service.type Ändrat request.service.method - request.service.method - request.service.type 1.30 990927 Städat bort projektinformation. 1.20 990816 Följande variabler är ändrade consignment_gross_weight från total_gross_weight consignment_cube total_consignment_cube consignment_loading_meters total_loading_meters consignment_package_count total_package_count consignment_pallet_count total_pallet_count consignment_halfpallet_count total_halfpallet_count consignment_pallet_space total_pallet_space