Datum: 2005-11-23 Sida 1 av 9 Gränssnitt XML Prisfråga Sverige 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>, <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>. <service><action> O String WDR 10 Värde select <service><method> O String WDR 10 Värde calculate <user><login_name> O String WDR 10 Användarnamn <user><password> O String WDR 10 Lösenord <user><e_mail> String WDR 30 Användarens epost-adress <format><mime> String WDR 40 Format man skickar på. Tex text/xml 1.2 <response> Innehåller information från tjänsten.. Noderna ligger under <xml><response>. <service><name> O String WDR - Namn på tjänsten <service><version> O String WDR - Versionsnummer (2.0) <data_list_count> O Int WDR - Antal i data_list
Datum: 2005-11-23 Sida 2 av 9 1.3 <system> Innehåller felkod från systemet. <system><error><id>0</id></error></system> betyder OK. Innehåller statistikvariabler till systemet. Noderna ligger under <xml><system>. <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> O String WDR - Landskod för klient, ex. se eller us <statistics><remote><send_data_format> 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_name> O String WDR - Klientens sida/modul som anropar <statistics><remote><admin_e_mail> O String WDR - E-mail till adm. för klient <statistics><user><return_mime_format> 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, Calculate_002 <statistics><request><service><action> O String WDR - select <statistics><request><service><method> O String WDR - calculate
Datum: 2005-11-23 Sida 3 av 9 2 Meddelande IFTMIN Efterfrågar pris på transport. I fältet (O)bligatoriskt finns 5 fält markerade ett A. Villkoren för dessa står bland förklaringarna. Lägg in noderna under <xml><data_list><data index= 0 >. <consignor_identification> O String NAD-CZ 8 Kundnummer för avsändare, 8 siffror DE 3039 <contract_condition_code> O String TSR 4065-PAR 4065-COM 4065-BUD 4065-CLD 4065-DIR 4065-SPC 4065-HMD 3 Produktnamn: Välj en av PAR = Parcel, COM = Comfort, BUD = Budget, CLD = Coldsped, DIR = Direct, SPC = Special HMD = Home Delivery <departure_place_name> A String TDT 3227-5 DE 3224 <destination_place_name> A String TDT 3227-8 DE 3224 <consignment_gross_weight> A Int CNT 6069-7 DE 6066 Unit 6411 <consignment_cube> Float CNT 6069-15 DE 6066 Unit 6411 <consignment_loading_meters> Float CNT 6069-ZLM DE 6066 <is_collect> A Boolean TSR 7273=CCT <is_express> Boolean TSR 7273=EXP <is_advise_service> Boolean TSR 7273=ADS <is_dangerous_goods> Boolean TSR 7273=DAG <is_hot_goods> Boolean TSR 7273=HOT <is_delivery_date_time> Boolean TSR 7273=TID 13 Avsändningsort Obligatorisk för alla utom PAR 13 Mottagarort Obligatorisk för alla utom PAR 5 Vikt (Kg). Obligatorisk för samtliga produkter. 6,2 Volym (Kbm). För produkterna COM, 'SPC, DIR, CLD, HMD. 2,2 Flakmeter. För produkterna COM, DIR, CLD, HMD. 1 Mottagaren betalar Obligatorisk för alla utom PAR 1 Tilläggstjänst Express. Gäller ej SPC 1 Tilläggstjänst Avisering 1 Tilläggstjänst Farligt gods Gäller ej PAR, CLD 1 Tilläggstjänst Varmtransport Gäller ej PAR, CLD, HMD 1 Tilläggstjänst Tidslossning Gäller ej PAR 7 Tilläggstjänst Efterkrav (SEK) (Schenker unik kod) 7 Tilläggstjänst Utvidgad varuförsäkring (SEK) (Schenker unik kod) 2 Antal pallplatser (st) Gäller endast BUD <cash_on_delivery> Int TSR 7273=COD <expanded_insurance> Int TSR 7273=INS <budget_pallet_count> Int CNT 6063-111 DE 6066 Unit 6411 <country_code> 3 Landskod (Se Appendix A) Gäller endast PAR <percentage_charge> 4 Påslag I procent. För samtliga produkter. <charge> 6 Påslag I SEK. För samtliga produkter. <number_of_packages> 5 Antal kolli Gäller endast PAR
Datum: 2005-11-23 Sida 4 av 9 <consignor_zip_number> 5 Avsändande postnr Gäller ej PAR <consignee_zip_number> 5 Mottagande postnr Gäller ej PAR <is_skrymme_code> Boolean 1 Skrymmande Gäller endast 'PAR' <Is_edi_customer> Boolean 1 Ett påslag på expiditionsavgiften görs om det är en edi-kund. Värde 1= Ja eller 0 = Nej <number_of_pallet_places> Int 7 Pallplatspris antal För produkterna COM, DIR, CLD. <styck> Int 7 Styckpris antal För produkterna COM, DIR, CLD. 3 Meddelande IFTMCS Levererar efterfrågat pris på transport. Noderna ligger under <xml><data_list><data index= 0 > <chargeable_distance> Int QTY - Avstånd mellan orter för taxering (Km) 6063-49 <breakpoint_weight> Int CNT - Brytpunktsvikt (Kg), fraktdragande vikt <chargeable_weight> Int QTY 6063-100 <currency_code> String (3) CUX 6345 - Fraktgrundande vikt (Kg) - Valutakod. Enligt ISO 4217. (SEK/EUR) <freight_net_cost> Float TCC 8023-551 <administration_fee> Float TCC 8023-205 <oil_charge> Float TCC 8023-553 <collect_fee> Float TCC 8023-561 <freight_cost> Float TCC 8023-??? <gotland_charge> Float TCC 8023-560 <pallet_fee> Float TCC 8023-451 <freight_total_cost> Float TCC 8023-??? <express_fee> Float TCC 8023-578 - Netto grundfrakt - Expeditionsavgift - Oljetillägg - Avgift för mottagarfrakt, dvs den utgår när "Betalande kund" är "Mottagare". - Fraktkostnad Är lika med freight_net_cost + administration_fee + oil_charge + collect_fee - Gotlandstillägg - Pallavgift - Fraktkostnad 2 Är lika med freight_cost + pallet_fee + gotland_charge - Expressavgift <advise_service_fee> Float TCC - Aviseringsavgift
Datum: 2005-11-23 Sida 5 av 9 8023-905 <dangerous_goods_fee> Float TCC 8023-555 - Farligt gods avgift <delivery_date_time_fee> Float TCC 8023-TID <carrier_fee> Float TCC 8023-CAR <cash_on_delivery_fee> Float TCC 8023-901 <expanded_insurance_fee> Float TCC 8023-501 <currency_administration_fee> Float TCC 8023-??? <value_added_tax> Float MOA-5025-150 - Tidslossningsavgift (Schenker unik kod) - Inbärning (Schenker unik kod) - Efterkravsavgift - Utvidgad varuförsäkringsavgift - Valutaavgift. - Moms <total_cost> Float - Totalsumma <charge_currency> - <departure_place_name> String - Ort Avsändare <destination_place_name> String - Ort Mottagare <edi_fee> Float - Ett påslag på expiditionsavgiften görs om det är en edi-kund. Ediavgift i SEK eller EUR <departure_place_charge> Float - Ortstillägget Avsändare <destination_place_charge> Float - Ortstillägget Mottagare <departure_place_type> String - Typ av ortstillägg Avsändare, se Appendix C för att se vilka alternativ som finns. <destination_place_type> String - Typ av ortstillägg Mottagare, se Appendix C för att se vilka alternativ som finns. <transport_document_number_charge> Float - Flerkollitillägg för Parcel <distribution_charge> Float - Distributionstillägget för Coldsped. <information> String - Information, se Appendix B för information om vilka texter som finns. <customs_fee> Float - Tullavgift för Parcel.
Datum: 2005-11-23 Sida 6 av 9 4 Anrop av scripten Adresser man anropar är (endast POST): Produktion http://was.webtrp.com/priceonlinese_3/servlet/priceonlinese_3 Tjänsten kräver inloggning. Information kan hittas på: http://www.schenker.se/online Exempel på anrop: <?xml version="1.0"?> <xml> <response></response> <system> <statistics> <remote> <country_code>se</country_code> <ip_address/> <send_data_format/> <admin_e_mail/> <access_type/> <application_name/> </remote> <service> <name/> <api_version/> </service> <user> <return_mime_format/> <organization_id/> <language_code/> </user> </statistics> </system> <data_list> <data index="0"> <is_delivery_date_time>1</is_delivery_date_time> <budget_pallet_count></budget_pallet_count> <contract_condition_code>com</contract_condition_code> <is_collect>0</is_collect> <is_dangerous_goods>1</is_dangerous_goods> <consignor_identification>[kundnummer]</consignor_identification> <destination_place_name>göteborg</destination_place_name> <is_hot_goods>1</is_hot_goods> <expanded_insurance></expanded_insurance> <departure_place_name>stockholm</departure_place_name> <cash_on_delivery></cash_on_delivery> <is_advise_service>1</is_advise_service> <consignment_gross_weight>12</consignment_gross_weight> </data> </data_list> <request> <format> <mime>text%2fxml</mime> <type>full</type> </format> <service>
Datum: 2005-11-23 Sida 7 av 9 <action>select</action> <method>calculate</method> </service> </request> </xml> Svaret kan se ut på följande sätt: <?xml version="1.0"?> <xml> <response> <data_list_count>1</data_list_count> <service> <version>1.0</version> <name>priceonline 3</name> </service> </response> <system> <error> <message> Your+request+was+successfully+processed. </message> <id>0</id> </error> </system> <data_list> <data index="0"> <freight_net_cost>0.00</freight_net_cost> <currency_administration_fee>0.00</currency_administration_fee> <chargeable_distance>477</chargeable_distance> <oil_charge>0.00</oil_charge> <freight_total_cost>0.00</freight_total_cost> <total_cost> 0.00</total_cost> <gotland_charge>0.00</gotland_charge> <freight_cost>0.00</freight_cost> <currency_code>sek</currency_code> <expanded_insurance_fee>0.00</expanded_insurance_fee> <advise_service_fee>0.00</advise_service_fee> <carrier_fee>0.00</carrier_fee> <delivery_date_time_fee>0.00</delivery_date_time_fee> <value_added_tax>0.00</value_added_tax> <chargeable_weight>66</chargeable_weight> <breakpoint_weight>0</breakpoint_weight> <administration_fee>0.00</administration_fee> <dangerous_goods_fee>0.00</dangerous_goods_fee> <pallet_fee>0.00</pallet_fee> <express_fee>0.00</express_fee> <collect_fee>0.00</collect_fee> <cash_on_delivery_fee>0.00</cash_on_delivery_fee> </data> </data_list> <request/> </xml>
Datum: 2005-11-23 Sida 8 av 9 Appendix A Landskoder: Land Landskod Sverige 046 Belgien 032 Cypern 357 Danmark 045 Estland 372 Finland 358 Frankrike 033 Frankrike (Korsika) 504 Grekland 030 Holland 031 Irland 353 Italien 039 Italien (Sardinien) 506 Italien (Sicilien) 507 Lettland 371 Litauen 370 Luxemburg 352 Norge 047 Polen 048 Portugal 351 Schweiz 041 Slovenien 386 Slovakien 421 Spanien 034 Spanien (Ibiza) 503 Spanien (Mallorca) 501 Spanien (Minorca) 502 Storbritannien 044 Tjeckien 420 Tyskland 049 Ungern 036 Österrike 043
Datum: 2005-11-23 Sida 9 av 9 Appendix B Informationskoder: Information Pris ej avtalat på angiven produkt/relation. Kontakta din säljare för att avtala pris. Pallplatspris fins inte avtalat, pris angivet enligt din generella prislista. Styckpris finns ej avtalat, pris angivet enligt din generella prislista. Informationskod 1 2 3 Appendix C Ortstillägg: Ortstillägg typ Ö-ortstillägg Storstadstillägg Glesbygdstillägg Ortstillägg typ bokstav O S G