Obsah:

Http download. 2

Webové služby (WS) 2

1. Cars. 3

1.1. ModelCatalog. 3

1.1.1. ModelCatalog.AllModels [web service][1xdenně] 3

1.1.2. ModelCatalog.ModelFromVIN [web service][na vyžádání] 3

1.1.3. ModelCatalog.Color [web service] [1xdenně] 3

1.1.4. ModelCatalog.CarInfo [web service] [na vyžádání] 3

1.2. CustomerContract 4

1.2.1. CustomerContract.InsertCustomerContract [web service][při změně] 4

1.2.2. CustomerContract.CustomerContractStatus [web service][na vyžádání] 4

1.3. Party. 5

1.3.1. Party.PartyCatalog [web service][1xdenně] 5

1.3.2. Party.InsertParty [web service][při změně] 5

1.3.3. Party.SalesActivity [web service][při změně] 5

1.3.4. Party.CarInterest [web service][při změně] 5

1.4. Invoice. 6

1.4.1. Invoice.SalesInvoice [web service][na vyžádání] 6

2. Parts. 7

2.1. PartCatalog. 7

2.1.1. Parts.GetAllParts [file download][při změně souboru] 7

2.1.2. Parts.PartFromPIT [web service][na vyžádání] 7

2.1.3. Parts.AvaRequest [web service] [na vyžádání] 7

2.1.4. Parts.PnType [file download] [při změně souboru] 7

2.1.5. Parts.Substitutins [file download] [při změně souboru] 8

2.2. SalesOrder 9

2.2.1. SalesOrder.CreateSalesOrder [web service] [odeslání objednávky] 9

2.2.2. SalesOrder.SalesOrderStatus [web service][na vyžádání] 9

2.2.3. SalesOrder.SalesOrderCode [web service][1xdenně] 9

2.2.4. SalesOrder.SalesOrderNumbers [web service][1xdenně, na vyžádání] 9

2.2.5. SalesOrder.GetSalesOrder [web service] [1xdenně, na vyžádání] 10

2.3. Invoice. 11

2.3.1. Invoice.SalesInvoice [web service][na vyžádání] 11

2.3.2. Invoice.SalesInvoiceNumber [web service][na vyžádání] 11

3. Service. 12

3.1. Service. 12

3.1.1. Service.Recalls [file download][při změně souboru] 12

3.1.2. Service.FlatRate [file download][při změně souboru] 12

3.1.3. Service.ServiceInfo [web service][1xdenně] 12

3.1.4. Service.ComponentArea [web service][1xdenně] 12

3.1.5. Service.DiagFormSubmit [web service][odeslání dotazníku] 12

3.1.6. Service.TechRepSubmit [web service][odeslání dotazníku] 14

3.1.7. Service.RepairOrder [web service][vloží servisní objednávku] 14

3.2. Claim. 15

3.2.1. Claim.InsertClaim [web service][odeslání claimu] 15

3.2.2. Claim.ClaimResult [web service][1xdenně, na vyžádání] 15

3.2.3. Claim.ClaimCatalog [web service][1xdenně] 15

3.2.4. Claim.ClaimInvoice[web service][Odeslání faktury] 15

 


DMS rozhraní

Pro přenosy informací se používají se dva přístupy, HTTP download souborů a webové služby. Přenáší se dokumenty ve formáty XML. Všechny XSD schémata pro XML Dokumenty jsou uloženy na http://schemas.toyota.cz.
Každý dealer bude mít vlastní aplikační účet pro přístup na tato rozhraní.

Http download

Používají se hlavně pro velké číselníky, které se aktualizují nejčastěji jednou denně. Soubory jsou zabalené GPL programem GZip. Pro rozbalení existuje GUnzip. Syntaxe je jednoduchá pro balení gzip [soubor.xml] a pro rozbalení gunzip [soubor.xml.gz]. Gzip je možné získat například na adrese: http://gnuwin32.sourceforge.net/packages/gzip.htm.
Všechny soubory jsou umístěny na http://dmsdownloads.corp.toyota.cz. V některých případech, jako jsou ceníky, je třeba zvlášť uchovávat verzi pro české a slovenské dealery. Ty se pak nacházejí na adrese http://dmsdownloads.corp.toyota.cz/CZ resp. http://dmsdownloads.corp.toyota.cz/SK. Kdy byl který soubor aktualizován je uloženo v xml souboru http://dmsdownloads.corp.toyota.cz/DmsDownload.xml. V atributu @logicalName je jméno souboru, @lastUpdate je datum poslední aktualizace, @urn je http cesta na daný soubor, @localPath je lokální cesta, používá se interně pro aktualizaci, nikdo jiný než TMCZ ji nebude používat.

Webové služby (WS)

Používají se pro on-line přenos informací, jako je posílání objednávek, faktur apod. Většina metod webových služeb má za vstupní a výstupní parametr XML dokument, nebo jednoduché typy, jako je string a integer.


 

1. Cars

Rozhraní, která se týkají prodeje vozů.

1.1. ModelCatalog

Webová služba, která vrací informace o modelech, barvách, cenách apod.

1.1.1. ModelCatalog.AllModels [web service][1xdenně]

Tato metoda slouží pro aktualizaci všech číselníku modelů, jejich cen apod.

 

Vstup

Výstup

Typ, schéma

string

http://schemas.toyota.cz/Cars/ModelCatalog.xsd

Příklad

“TTP”

http://schemas.toyota.cz/Cars/Instance/ModelCatalog.xml

Dokumentace

 

http://schemas.toyota.cz/Cars/ModelCatalog/ModelCatalog.html

1.1.2. ModelCatalog.ModelFromVIN [web service][na vyžádání]

Metoda vrací model na základě VINu, jako vstupního parametru

 

Vstup

Výstup

Typ, schéma

string, string

http://schemas.toyota.cz/Cars/ModelCatalog.xsd

Příklad

“TTP”, “VNKKV12370A310140”

http://schemas.toyota.cz/Cars/Instance/ModelCatalog.xml

Dokumentace

 

http://schemas.toyota.cz/Cars/ModelCatalog/ModelCatalog.html

1.1.3. ModelCatalog.Color [web service] [1xdenně]

Číselník barev. Kódy barev s jejich popisem.
 

 

Vstup

Výstup

Typ, schéma

 

http://schemas.toyota.cz/Cars/Color.xsd

Příklad

 

http://schemas.toyota.cz/Cars/Instance/Color.xml

Dokumentace

 

http://schemas.toyota.cz/Cars/Color/Color.html

1.1.4. ModelCatalog.CarInfo [web service] [na vyžádání]

Metoda vrací informace o voze, jako je číslo motoru. Dále pak modelové vlastnosti.

 

Vstup

Výstup

Typ, schéma

http://schemas.toyota.cz/cars/VinList.xsd

http://schemas.toyota.cz/cars/CarInfo.xsd

Příklad

http://schemas.toyota.cz/cars/Instance/VinList.xml

http://schemas.toyota.cz/cars/instance/CarInfo.xml

Dokumentace

http://schemas.toyota.cz/Cars/VinList/VinList.html

http://schemas.toyota.cz/Cars/CarInfo/CarInfo.html


1.2. CustomerContract

Webová služba, která pracuje se zákaznickým kontraktem (objednávkou).

1.2.1. CustomerContract.InsertCustomerContract [web service][při změně]

Vloží zákaznickou objednávku do systému TMCZ.

 

 

Vstup

Výstup

Typ, schéma

http://schemas.toyota.cz/Cars/CustomerContract.xsd

integer

Příklad

http://schemas.toyota.cz/Cars/Instance/CustomerContract.xml

0

Dokumentace

http://schemas.toyota.cz/Cars/CustomerContract/CustomerContract.html

 

1.2.2. CustomerContract.CustomerContractStatus [web service][na vyžádání]

Vrací stav zákaznických objednávek.

 

 

Vstup

Výstup

Typ, schéma

http://schemas.toyota.cz/StringList.xsd , string

http://schemas.toyota.cz/Cars/CustomerContractStatus.xsd

Příklad

http://schemas.toyota.cz/Parts/Instance/InvoiceList.xml , "FRE“

http://schemas.toyota.cz/Cars/Instance/CustomerContractStatus.xml

Dokumentace

http://schemas.toyota.cz/StringList/StringList.html

http://schemas.toyota.cz/Cars/CustomerContractStatus/CustomerContractStatus.html


1.3. Party

Webová služba, která pracuje se zákazníky – osoby i firmy (party), jejich aktivitami apod.

 

1.3.1. Party.PartyCatalog [web service][1xdenně]

Metoda vrací číselníky, které jsou třeba pro vložení Party. Jako seznamy pracovních pozic apod.

 

 

Vstup

Výstup

Typ, schéma

 

http://schemas.toyota.cz/Cars/PartyCatalog.xsd

Příklad

 

http://schemas.toyota.cz/Cars/Instance/PartyCatalog.xml

Dokumentace

 

http://schemas.toyota.cz/Cars/PartyCatalog/PartyCatalog.html

 

1.3.2. Party.InsertParty [web service][při změně]

Uloží osobu/firmu do databáze TMCZ. Volá se při každé změně Party v DMS.

 

 

Vstup

Výstup

Typ, schéma

http://schemas.toyota.cz/Cars/Party.xsd

integer

Příklad

http://schemas.toyota.cz/Cars/Instance/Party.xml

0

Dokumentace

http://schemas.toyota.cz/Cars/Party/Party.html

 

 

1.3.3. Party.SalesActivity [web service][při změně]

Uloží jakoukoliv aktivitu zákazníka, jako je testovací jízda, návštěva showroomu apod.

 

 

Vstup

Výstup

Typ, schéma

http://schemas.toyota.cz/Cars/SalesActivity.xsd

integer

Příklad

http://schemas.toyota.cz/Cars/Instance/SalesActivity.xml

0

Dokumentace

http://schemas.toyota.cz/Cars//SalesActivity//SalesActivity.html

 

1.3.4. Party.CarInterest [web service][při změně]

Uloží do systému TMCZ zákazníkův zájem o vůz.

 

 

Vstup

Výstup

Typ, schéma

http://schemas.toyota.cz/Cars/CarInterest.xsd

integer

Příklad

http://schemas.toyota.cz/Cars/Instance/CarInterest.xml

0

Dokumentace

http://schemas.toyota.cz/Cars/CarInterest/CarInterest.html

 


1.4. Invoice

Webová služba, která pracuje se fakturami, které byly vystaveny distributorem. Webová služba bude implementována až s příchodem nového prodejního sýstému Roger.

 

1.4.1. Invoice.SalesInvoice [web service][na vyžádání]

Tato metoda vrací faktury vystavené distributorem, na základě čísel faktur uvedených ve vstupní instanci.

 

 

Vstup

Výstup

Typ, schéma

 

http://schemas.toyota.cz/Cars/SalesInvoice.xsd

Příklad

 

http://schemas.toyota.cz/Cars/Instance/SalesInvoice.xml

Dokumentace

 

http://schemas.toyota.cz/Cars/SalesInvoice/SalesInvoice.html


2. Parts

Rozhraní pro náhradní díly.

2.1. PartCatalog

Webová služba pro správu náhradních dílu, číselníků, dostupností, substitucí apod.

2.1.1. Parts.GetAllParts [file download][při změně souboru]

Soubor obsahuje všechny náhradní díly, jejich ceny apod.

 

Cesta

http://dmsdownloads.corp.toyota.cz/CZ/AllParts.xml.gz
http://dmsdownloads.corp.toyota.cz/SK/AllParts.xml.gz

Typ, schéma

http://schemas.toyota.cz/Parts/PartCatalog.xsd

Příklad

http://schemas.toyota.cz/Parts/Instance/AllPartsCZ.xml

Dokumentace

http://schemas.toyota.cz/Parts/PartCatalog/PartCatalog.html

2.1.2. Parts.PartFromPIT [web service][na vyžádání]

Metoda vrací číselník náhradních dílů omezený pouze na čísla ve vstupní instanci seznamu čísel dílů.

 

 

Vstup

Výstup

Typ, schéma

http://schemas.toyota.cz/Parts/PartList.xsd

http://schemas.toyota.cz/Parts/PartCatalog.xsd

Příklad

http://schemas.toyota.cz/Parts/Instance/PartList.xml

http://schemas.toyota.cz/Parts/Instance/PartCatalog.xml

Dokumentace

http://schemas.toyota.cz/Parts/PartList/PartList.html

http://schemas.toyota.cz/Parts/PartCatalog/PartCatalog.html

 

2.1.3. Parts.AvaRequest [web service] [na vyžádání]

Vrací dostupnost dílů (ETA) ze vstupního seznamu dílů.

 

 

Vstup

Výstup

Typ, schéma

http://schemas.toyota.cz/Parts/AVARequest.xsd

http://schemas.toyota.cz/Parts/AvaResponse.xsd

Příklad

http://schemas.toyota.cz/Parts/Instance/AVARequest.xml

http://schemas.toyota.cz/Parts/Instance/AVAResponse.xml

Dokumentace

http://schemas.toyota.cz/Parts/AVARequest/AVARequest.html

http://schemas.toyota.cz/Parts/AVAResponse/AVAResponse.html

2.1.4. Parts.PnType [file download] [při změně souboru]

Soubor obsahuje číselník typů náhradních dílů.  Nebudeme radši používat webovou službu???

 

Cesta

http://dmsdownloads.corp.toyota.cz/PnType.xml.gz

Typ, schéma

http://schemas.toyota.cz/Parts/PnType.xsd

Příklad

http://schemas.toyota.cz/Parts/Instance/PnType.xml

Dokumentace

http://schemas.toyota.cz/Parts/PnType/PnType.html

2.1.5. Parts.Substitutins [file download] [při změně souboru]

Soubor obsahuje číselník náhrad a jejich typy.

 

Cesta

http://dmsdownloads.corp.toyota.cz/Substitutions.xml.gz

Typ, schéma

http://schemas.toyota.cz/Parts/Substitution.xsd

Příklad

http://schemas.toyota.cz/Parts/Instance/Substitutions.xml

Dokumentace

http://schemas.toyota.cz/Parts/Substitution/Substitution.html

 


2.2. SalesOrder

·         URL:               http://ws.corp.toyota.cz/Parts/SalesOrder.asmx

·         WSDL:            http://ws.corp.toyota.cz/Parts/SalesOrder?WSDL

2.2.1. SalesOrder.CreateSalesOrder [web service] [odeslání objednávky]

Metoda vytvoří novou nákupní objednávku.

 

Vstup

Výstup

Typ, schéma

http://schemas.toyota.cz/Parts/SalesOrder.xsd

integer

Příklad

http://schemas.toyota.cz/Parts/Instance/SalesOrder.xml

0

Dokumentace

http://schemas.toyota.cz/Parts/SalesOrder/SalesOrder.html

 

 

2.2.2. SalesOrder.SalesOrderStatus [web service][na vyžádání]

Na základě seznamu objednávek vrací jejich stav. Vstupní instance může obsahovat i řádky, v tom případě metoda vrací jen stav uvedených řádků a ne celé objednávky.

 

 

Vstup

Výstup

Typ, schéma

http://schemas.toyota.cz/Parts/SalesOrderList.xsd

http://schemas.toyota.cz/Parts/SalesOrderStatus.xsd

Příklad

http://schemas.toyota.cz/Parts/Instance/SalesOrderList.xml

http://schemas.toyota.cz/Parts/Instance/SalesOrderStatus.xml

Dokumentace

http://schemas.toyota.cz/Parts/SalesOrderList/SalesOrderList.html

http://schemas.toyota.cz/Parts/SalesOrderStatus/SalesOrderStatus.html

 

2.2.3. SalesOrder.SalesOrderCode [web service][1xdenně]

Metoda vrací možné kódy řádky nákupních objednávek.

 

 

Vstup

Výstup

Typ, schéma

 

http://schemas.toyota.cz/Parts/SalesOrderCode.xsd

Příklad

 

http://schemas.toyota.cz/Parts/Instance/SalesOrderCode.xml

Dokumentace

 

http://schemas.toyota.cz/Parts/SalesOrderCode/SalesOrderCode.html

2.2.4. SalesOrder.SalesOrderNumbers [web service][1xdenně, na vyžádání]

Metoda vrací čísla objednávek za posledních 14 dní. Distributor může vystavit objednávku za dealera. Pomocí této metody se zjistí, která čísla objednávek chybějí a naimportují se pomocí metody

 

 

Vstup

Výstup

Typ, schéma

String (shipToDealer)

http://schemas.toyota.cz/Parts/SalesOrderNumber.xsd

Příklad

„FRE“

http://schemas.toyota.cz/Parts/Instance/SalesOrderNumber.xml

Dokumentace

 

http://schemas.toyota.cz/Parts/SalesOrderNumber/SalesOrderNumber.html

 

2.2.5. SalesOrder.GetSalesOrder [web service] [1xdenně, na vyžádání]

Na základě seznamu objednávek vrací přesné kopie objednávek. Používá se v případě, že za dealera vystaví objednávku distributor. Tato objednávka se pak může naimportovat do systému DMS.

 

 

Vstup

Výstup

Typ, schéma

http://schemas.toyota.cz/Parts/SalesOrderList.xsd

http://schemas.toyota.cz/Parts/SalesOrder.xsd

Příklad

http://schemas.toyota.cz/Parts/Instance/SalesOrderList.xml

http://schemas.toyota.cz/Parts/Instance/SalesOrder.xml

Dokumentace

http://schemas.toyota.cz/Parts/SalesOrderList/SalesOrderList.html

http://schemas.toyota.cz/Parts/SalesOrder/SalesOrder.html


2.3. Invoice

Webová služba pro získání informací o fakturách vystavených distributorem.

 

2.3.1. Invoice.SalesInvoice [web service][na vyžádání]

Tato metoda vrací faktury vystavené distributorem, na základě čísel faktur uvedených ve vstupní instanci.

 

 

Vstup

Výstup

Typ, schéma

http://schemas.toyota.cz/StringList.xsd, string

http://schemas.toyota.cz/Parts/SalesInvoice.xsd

 

Příklad

http://schemas.toyota.cz/Parts/Instance/InvoiceList.xml,"ZLI“

http://schemas.toyota.cz/Parts/Instance/SalesInvoice.xml

Dokumentace

http://schemas.toyota.cz/StringList/StringList.html

http://schemas.toyota.cz/Parts/SalesInvoice/SalesInvoice.html

 

 

 

2.3.2. Invoice.SalesInvoiceNumber [web service][na vyžádání]

Tato metoda vrací faktury vystavené distributorem.

 

 

Vstup

Výstup

Typ, schéma

string

http://schemas.toyota.cz/StringList.xsd

Příklad

"ZLI“

http://schemas.toyota.cz/Parts/Instance/SalesInvoiceNumbers.xml

Dokumentace

 

http://schemas.toyota.cz/StringList/StringList.html


3. Service

Rozhraní pro servis.

3.1. Service

3.1.1. Service.Recalls [file download][při změně souboru]

Soubor obsahuje recally a vozy, které do nich náleží.

 

Typ, schéma

http://schemas.toyota.cz/Service/Recall.xsd

Příklad

http://schemas.toyota.cz/Service/Instance/Recalls.xml

Dokumentace

http://schemas.toyota.cz/Service/Recall/Recall.html

3.1.2. Service.FlatRate [file download][při změně souboru]

Soubor obsahuje FlatRaty.

 

Typ, schéma

http://schemas.toyota.cz/Service/FlatRate.xsd

Příklad

http://schemas.toyota.cz/Service/Instance/FlateRate.xml

Dokumentace

http://schemas.toyota.cz/Service/FlatRate/FlatRate.html

3.1.3. Service.ServiceInfo [web service][1xdenně]

Vrací seznam servisních informací

 

Vstup

Výstup

Typ, schéma

 

http://schemas.toyota.cz/Service/ServiceInfo.xsd

Příklad

 

http://schemas.toyota.cz/Service/Instance/ServiceInfo.xml

Dokumentace

 

http://schemas.toyota.cz/Service/ServiceInfo/ServiceInfo.html

3.1.4. Service.ComponentArea [web service][1xdenně]

Vrací číselník oblastí. Používá se pro diagnostické dotazníky.

 

Vstup

Výstup

Typ, schéma

 

http://schemas.toyota.cz/Service/ComponentArea.xsd

Příklad

 

http://schemas.toyota.cz/Service/Instance/ComponentArea.xml

Dokumentace

 

http://schemas.toyota.cz/Service/ComponentArea/ComponentArea.html

3.1.5. Service.DiagFormSubmit [web service][odeslání dotazníku]

Uloží diagnostický dotazník do systému TMCZ.

 

Vstup

Výstup

Typ, schéma

XmlDokument

integer

Příklad

 

0

Dokumentace

 

 

 


 

3.1.6. Service.TechRepSubmit [web service][odeslání dotazníku]

Uloží technické hlášení do systému TMCZ.

 

Vstup

Výstup

Typ, schéma

XmlDokument

integer

Příklad

 

0

Dokumentace

 

 

 

3.1.7. Service.RepairOrder [web service][vloží servisní objednávku]

Vloží servisní objednávku do systému TMCZ.

 

Vstup

Výstup

Typ, schéma

http://schemas.toyota.cz/Service/RepairOrder.xsd

integer

Příklad

http://schemas.toyota.cz/Service/Instance/RepairOrder.xml

0

Dokumentace

http://schemas.toyota.cz/Service/RepairOrder/RepairOrder.html

 


 

3.2. Claim

·         URL:               http://ws.corp.toyota.cz/Service/Claim.asmx

·         WSDL:            http://ws.corp.toyota.cz/Service/Claim.asmx?WSDL

3.2.1. Claim.InsertClaim [web service][odeslání claimu]

Uloží reklamační protokol.

 

Vstup

Výstup

Typ, schéma

http://schemas.toyota.cz/Service/Claim.xsd

Integer

Příklad

http://schemas.toyota.cz/Service/Instance/Claim.xml

0

Dokumentace

http://schemas.toyota.cz/Service/Claim/Claim.html

 

 

3.2.2. Claim.ClaimResult [web service][1xdenně, na vyžádání]

Vrací stav reklamačních protokolů.

 

 

Vstup

Výstup

Typ, schéma

string, http://schemas.toyota.cz/StringList.xsd

http://schemas.toyota.cz/Service/ClaimResult.xsd

Příklad

“FRE”, http://schemas.toyota.cz/Service/Instance/ClaimResultList.xml

http://schemas.toyota.cz/Service/Instance/ClaimResult.xml

Dokumentace

http://schemas.toyota.cz/StringList/StringList.html

http://schemas.toyota.cz/Service/ClaimResult/ClaimResult.html

3.2.3. Claim.ClaimCatalog [web service][1xdenně]

Vrací číselníky, které se používají pro reklamační protokol.

 

Vstup

Výstup

Typ, schéma

 

http://schemas.toyota.cz/Service/ClaimCatalog.xsd

Příklad

 

http://schemas.toyota.cz/Service/Instance/ClaimCatalog.xml

Dokumentace

 

http://schemas.toyota.cz/Service/ClaimCatalog/ClaimCatalog.html

3.2.4. Claim.ClaimInvoice[web service][Odeslání faktury]

Uloží reklamační fakturu.

 

Vstup

Výstup

Typ, schéma

 

http://schemas.toyota.cz/Service/ClaimInvoice.xsd

Příklad

 

http://schemas.toyota.cz/Service/Instance/ClaimInvoice.xml

Dokumentace

 

http://schemas.toyota.cz/Service/ClaimCatalog/ClaimCatalog.html