Contents
Chybové Zprávy ze Servisní
domény
Uživatelská přihlašovací stránka
Interfaces
referring to vehicle sales.
Webservice
used for finacing requests and approvals.
Structures
used in FinancigService:
http://schemas.toyota.cz/WCF/Cars02/Documentation/FinancingService1.Cars/FinancingService1.Cars.html
http://schemas.toyota.cz/WCF/Cars02/Documentation/FinancingService1.Well/FinancingService1.Well.html
FinancingCollection GetFinancingsChanged(PartyIdentification financedBy, DateTime dateFrom, DateTime dateTo);
For
specific leasing company specified in parameter <financedBy> gets all created or changed financial
requests between dateFrom and dateTo
Sample
request: http://schemas.toyota.cz/WCF/Cars02/Samples/FinancingService1.GetFinancingsChanged_REQUEST.xml
Sample
response: http://schemas.toyota.cz/WCF/Cars02/Samples/FinancingService1.GetFinancingsChanged_RESPONSE.xml
Financing GetFinancing(int financingID);
Gets on
Financing based on financingID parameter
Sample
request: http://schemas.toyota.cz/WCF/Cars02/Samples/FinancingService1.GetFinancing_REQUEST.xml
Sample
response: http://schemas.toyota.cz/WCF/Cars02/Samples/FinancingService1.GetFinancing_RESPONSE.xml
FinancingCollection GetFinancings(int[] financingIDs);
Gets more
Financings for collection of financingIDs
·
sample request: http://schemas.toyota.cz/WCF/Cars02/Samples/FinancingService1.GetFinancings_REQUEST.xml
·
sample response: http://schemas.toyota.cz/WCF/Cars02/Samples/FinancingService1.GetFinancings_RESPONSE.xml
void SetFinancingStatus(int financingID, FinancingStatus_BO status, string responseNote, string externalNumber);
Method is
used to change status of financing, responseNote and external number (internal
number of Financing Approval of specific leasing company)
Valid Changes
possible: CRE – Created, INP – In Approval, REJ – Rejected, APR – Approved, CAN
– Canceled by retailer
·
CRE->INP
·
CRE->APR
·
CRE->REJ
·
INP->APR
·
INP->REJ
·
CRE->CAN
·
INP->CAN
For invalid
changes an error is generated.
Sample request: http://schemas.toyota.cz/WCF/Cars02/Samples/FinancingService1.SetFinancingStatus_REQUEST.xml
Sample
response : http://schemas.toyota.cz/WCF/Cars02/Samples/FinancingService1.SetFinancingStatus_RESPONSE.xml
Web service used for geting vehicle information
Structures
used in FinancigService:
http://schemas.toyota.cz/WCF/Cars02/Documentation/CarService1.Cars/CarService1.Cars.Annotated.htm
CarInfos GetCarInfo(string[] VINs)
Gets information about list of vehicles specified by
parameter VINs. In case VIN does not exist method does not return error.
Sample request: http://schemas.toyota.cz/WCF/Cars02/Samples/CarService1.GetCarInfo_REQUEST.xml
Sample response: http://schemas.toyota.cz/WCF/Cars02/Samples/CarService1.GetCarInfo_RESPONSE.xml
CarHistories GetCarHistory(string[] VINs)
Gets history of vehicles specified specified by parameter VINs. In case VIN
does not exist method does not return error.
Sample request:
http://schemas.toyota.cz/WCF/Cars02/Samples/CarService1.GetCarHistory_REQUEST.xml
Sample response: http://schemas.toyota.cz/WCF/Cars02/Samples/CarService1.GetCarHistory_RESPONSE.xml
CarPrices GetCarPrice(int[] carIds)
Gets car prices for carIds specified by parameter carIds.
Sample request:
http://schemas.toyota.cz/WCF/Cars02/Samples/CarService1.GetCarPrice_REQUEST.xml
Sample response: http://schemas.toyota.cz/WCF/Cars02/Samples/CarService1.GetCarPrice_RESPONSE.xml
CampaignInfos GetValidCampaigns(string countryCode, DateTime validAtDate)
Gets valid campaigns for country (specified by paramter countryCode), valid at a certain moment.
Sample request:
http://schemas.toyota.cz/WCF/Cars02/Samples/CarService1.GetValidCampaigns_REQUEST.xml
Sample response: http://schemas.toyota.cz/WCF/Cars02/Samples/CarService1.GetValidCampaigns_RESPONSE.xml
Campaigns GetCampaignById(int[] campaignIds)
Gets campaign details by one or more campaign IDs. Use GetValidCampaigns method to get the list of IDs.
Sample request:
http://schemas.toyota.cz/WCF/Cars02/Samples/CarService1.GetCampaignById_REQUEST.xml
Sample response: http://schemas.toyota.cz/WCF/Cars02/Samples/CarService1.GetCampaignById_RESPONSE.xml
Campaigns GetCampaignByModel(string fullKatashiki, string sfx, string ssn)
Gets valid campaign details currently valid for a model specified by parameters fullKatashiki, sfx and ssn, for any country.
Sample request: http://schemas.toyota.cz/WCF/Cars02/Samples/CarService1.GetCampaignByModel_REQUEST.xml
Sample response: http://schemas.toyota.cz/WCF/Cars02/Samples/CarService1.GetCampaignByModel_RESPONSE.xml
OBSOLETE:
Campaigns GetCampaignByCountry(string countryCode)
Gets valid campaing
for country specified by parameter country Code.
Sample request: http://schemas.toyota.cz/WCF/Cars02/Samples/CarService1.GetCampaignByCountry_REQUEST.xml
Sample response: http://schemas.toyota.cz/WCF/Cars02/Samples/CarService1.GetCampaignByCountry_RESPONSE.xml
Campaigns GetCampaignByCountrySfx(string countryCode, string fullKatashiki, string sfx, string ssn)
Gets valid campaign
for country specified by paramter countryCode and model specified by parameters
fullKatashiki, sfx and ssn.
Sample request: http://schemas.toyota.cz/WCF/Cars02/Samples/CarService1.GetCampaignByCountrySfx_REQUEST.xml
Sample response: http://schemas.toyota.cz/WCF/Cars02/Samples/CarService1.GetCampaignByCountrySfx_RESPONSE.xml
Web service used for getting information about Models catalogs, colors etc.
·
URL test: https://wstest.toyota.cz/Cars02/CatalogsService1.svc
Structures
used in FinancigService:
http://schemas.toyota.cz/WCF/Cars02/Documentation/CatologService1.Cars/CatologService1.Cars.html
ExteriorColors
GetAllExteriorColors(string languageCode)
Returns list of Exterior
colors.
Sample Request: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllExteriorColors_REQUEST.xml
Sample Response:http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllExteriorColors_RESPONSE.xml
InteriorColors
GetAllInteriorColors(string languageCode)
Returns list of all Interior
colors.
Sample Request: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllInteriorColors_REQUEST.xml
Sample Response:http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllInteriorColors_RESPONSE.xml
Trims GetAllTrims(string languageCode)
Returns list of all trims.
Sample Request: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllTrims_REQUEST.xml
Sample Response XML: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllTrims_RESPONSE.xml
Brands GetAllModelTypes(string languageCode)
Returns list of all
Brand-ModelType hierarchies.
Sample Request: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllModelTypes_REQUEST.xml
Sample Response: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllModelTypes_RESPONSE.xml
Models GetAllModels(string languageCode)
Sample Request: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllModels_REQUEST.xml
Sample Response: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllModels_RESPONSE.xml
BodyTypes GetAllBodyTypes(string languageCode)
Returns list of all body
types.
Sample Request: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllBodyTypes_REQUEST.xml
Sample Response: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllBodyTypes_RESPONSE.xml
ModelCategories
GetAllModelCategories(string languageCode)
Returns list of all Model Categories.
Sample Request: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllModelCategories_REQUEST.xml
Sample Response: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllModelCategories_RESPONSE.xml
Transmissions
GetAllTransmissionTypes(string languageCode)
Returns list of all Transmission types.
Sample Request: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllTransmissionTypes_REQUEST.xml
Sample Response: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllTransmissionTypes_RESPONSE.xml
FuelTypes GetAllFuelTypes(string languageCode)
Returns
list of all Fuel types.
Sample Request: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllFuelTypes_REQUEST.xml
Sample Response: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllFuelTypes_RESPONSE.xml
Engines GetAllEngines(string languageCode)
Returns
list of all Engines.
Sample Request: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllEngines_REQUEST.xml
Sample Response: http://schemas.toyota.cz/WCF/Cars02/Samples/CatalogService1.GetAllEngines_RESPONSE.xml
Web service used for integration Fleet Module – Progression Company
·
URL
test: https://wstest.toyota.cz/Cars02/FleetService1.svc
·
WSDL
test: http://schemas.toyota.cz/WCFtest/Cars02/FleetService1.wsdl.zip
·
URL
production: https://ws.toyota.cz/Cars02/FleetService1.svc
·
WSDL production: http://schemas.toyota.cz/WCF/Cars02/FleetService1.wsdl.zip
Structures used in FleetService:
·
http://schemas.toyota.cz/WCFtest/Cars02/Documentation/Faults/Faults.html
void CreateFleets(Fleets fleets)
Inserts approved fleet offers into system. If fleet already exists (unique fleet-code), returns error.
Sample Request: http://schemas.toyota.cz/WCF/Cars02/Samples/FleetService1.CreateFleet_REQUEST.xml
Sample Response: http://schemas.toyota.cz/WCF/Cars02/Samples/FleetService1.CreateFleet_RESPONSE.xml
FleetDetails GetFleets(string[] fleetCodes)
Returns detail information of fleets specified by parameter fleedIds.
Sample Request: http://schemas.toyota.cz/WCF/Cars02/Samples/FleetService1.GetFleets_REQUEST.xml
Sample Response: http://schemas.toyota.cz/WCF/Cars02/Samples/FleetService1.GetFleets_RESPONSE.xml
Webservices about companies, persons and their contatcs like addresses, emails, bankacounts
Webservice about Parties = (companies, per
· URL Test: https://wstest.toyota.cz/Well01/PartyService1.svc
· WSDL testovací: http://schemas.toyota.cz/WCFtest/Well01/PartyService1.wsdl.zip
· URL produkční: https://ws.toyota.cz/Well01/PartyService1.svc
· WSDL produkční: http://schemas.toyota.cz/WCF/Well01/PartyService1.wsdl.zip
Dokumentace:
· http://schemas.toyota.cz/WCF/Well01/Documentation/PartyService1.Cars/PartyService1.Cars.html
Party GetParty(PartyIdentification partyIdentification);
Vrací party příslušného
typu, tj. Company nebo Person.
Sample
Request: http://schemas.toyota.cz/WCF/Well01/Samples/PartyService1.GetParty_REQUEST.xml
Sample response XML:
a)
http://schemas.toyota.cz/WCF/Well01/Samples/PartyService1.GetParty_RESPONSE.xml
b) http://schemas.toyota.cz/WCF/Well01/Samples/PartyService1.GetParty_RESPONSE1.xml
Rozhraní, která se týkají servisu.
Služba pokrývající číselníky TCodes, PositionCodes, SubletTypes.
Dokumentace:
·
http://schemas.toyota.cz/WCF/Service01/Documentation/CatalogService1.Well/CatalogService1.Well.html
Catalogs GetTCodes(string LanguageCode). LanguageCode
= 3 místný podle ISO 639-2. V tuto chvíli se komentáře vracejí pro jazyky
CZE, SLK, ENG.
Vrací číselník TCodes.
·
Sample Request: http://schemas.toyota.cz/WCF/Service01/Samples/CatalogService1.GetTCodes_REQUEST.xml
·
Sample response XML: http://schemas.toyota.cz/WCF/Service01/Samples/CatalogService1.GetTCodes_RESPONSE.xml
Catalogs GetPositionCodes(string LanguageCode). LanguageCode = 3 místný podle ISO
639-2. V tuto chvíli se komentáře vracejí pro jazyky CZE, SLK, ENG.
Vrací číselník PositionCodes.
·
Sample
Request: http://schemas.toyota.cz/WCF/Service01/Samples/CatalogService1.GetPositionCodes_REQUEST.xml
·
Sample
response XML: http://schemas.toyota.cz/WCF/Service01/Samples/CatalogService1.GetPositionCodes_RESPONSE.xml
Catalogs GetSubletTypes(string LanguageCode). LanguageCode = 3 místný podle ISO
639-2. V tuto chvíli se komentáře vracejí pro jazyky CZE, SLK, ENG.
Vrací číselník SubletTypes.
·
Sample
Request: http://schemas.toyota.cz/WCF/Service01/Samples/CatalogService1.GetSubletTypes_REQUEST.xml
·
Sample
response XML: http://schemas.toyota.cz/WCF/Service01/Samples/CatalogService1.GetSubletTypes_RESPONSE.xml
Služba pokrývající komunikaci TMCZ se svými partnery. Slouží k získávání a zasílání informací o záručních protokolech.
Dokumentace:
· http://schemas.toyota.cz/WCF/Service01/Documentation/ClaimService1.Well/ClaimService1.Well.html
ClaimStatuses InsertClaim(Claims Claims)
Metoda pro vložení kolekce záručních protokolů. Výsledkem metody je kolekce stavů vkládaných záručních protokolů.
·
Sample
Request XML: http://schemas.toyota.cz/WCF/Service01/Samples/ClaimService1.InsertClaim_REQUEST.xml
·
Sample
Response XML: http://schemas.toyota.cz/WCF/Service01/Samples/ClaimService1.InsertClaim_RESPONSE.xml
ObjectName =Claims
MemberName = Claim
MemberValue = DlrClaim
ObjectName = Claim
ObjectI|D
= DlrClaimNo
DataFault chyby
Kód
chyby |
MemberName |
MemberValue |
Popis |
D002 |
AcInstallationDate |
|
Chybějící element. Povinný pro typ Claimu: AC, SOPE_AC. |
D002 |
AcInstallationMileage |
|
Chybějící
element. Povinný pro typ Claimu: AC, SOPE_AC. |
D001 |
Cause |
Cause |
Délka je větší než 50 znaků. |
D002 |
Cause |
|
Chybějící
element. |
D001 |
ClaimDate |
ClaimDate |
ClaimDate musí být menší nebo rovno aktulnímu datu a času. |
D001 |
Condition |
Condition |
Délka
je větší než 50 znaků. |
D002 |
Condition |
|
Chybějící element. |
D001 |
DeliveryDate |
DeliveryDate |
Je
větší než aktuální datum. |
D002 |
DeliveryDate |
|
Chybějící element. Povinný pro typ Claimu TEC a pokud je
Mileage > 100 |
D001 |
DlrClaimNo |
DlrClaimNo |
Délka
mezi 1-6. Může obsahovat písmena a číslice. RegEx: ^[a-z0-9A-Z]{1,6}$ |
D002 |
DlrClaimNo |
|
Chybějící element. |
D002 |
DlrCode |
|
Chybějící
element. |
D001 |
MidtronicFirstTest1 |
MidtronicFirstTest1 |
Právě 10 písmen nebo číslic, nesmí obsahovat písmena I, O,
Q, S. RegEx: ^(?!.*[iIoOqQsS])[a-z0-9A-Z]{10}$ |
D002 |
MidtronicFirstTest1 |
MidtronicFirstTest1 |
Povinný
pokud hlavní díl zaciná na 28800 nebo hlavní operace je jedna
z 190011,190011A,190031, 19099. |
D001 |
MidtronicFirstTest2 |
MidtronicFirstTest2 |
Právě 10 písmen nebo číslic, nesmí obsahovat písmena I, O,
Q, S. RegEx: ^(?!.*[iIoOqQsS])[a-z0-9A-Z]{10}$ |
D001 |
MidtronicLastTest1 |
MidtronicLastTest1 |
Právě
10 písmen nebo číslic, nesmí obsahovat písmena I, O, Q, S. RegEx: ^(?!.*[iIoOqQsS])[a-z0-9A-Z]{10}$ |
D001 |
MidtronicLastTest2 |
MidtronicLastTest2 |
Právě 10 písmen nebo číslic, nesmí obsahovat písmena I, O,
Q, S. RegEx: ^(?!.*[iIoOqQsS])[a-z0-9A-Z]{10}$ |
D001 |
Mileage |
Mileage |
Je
větší rovno 1 000 000. |
D002 |
Operations |
|
Chybějící element. Povinný u všech typů kromě P2. |
D005 |
Operations |
|
Kolekce
může obsahovat max 10 elementů. |
SD002 |
Operations |
|
Právě jedna operace musí být hlavní. |
D006 |
Opertaions |
|
Kolekce
muže obsahovat min 1 element. |
D002 |
P1PreviousMileage |
|
Chybějící element. Povinný pro typ Claimu: P1, SOPE_P1. |
D002 |
P1PreviousRepairDate |
|
Chybějící
element. Povinný pro typ Claimu: P1, SOPE_P1. |
D002 |
P1PreviousRepairDate |
|
Chybějící element. Povinný pro typ Claimu: P1, SOPE_P1. |
D002 |
P2PreviouisSalesInvoicDate |
|
Chybějící
element. Povinný pro typ Claimu P2. |
D002 |
P2PreviousSalesInvoiceNo |
|
Chybějící element. Povinný pro typ Claimu P2. |
D002 |
P2SalesInvoiceDate |
|
Chybějící
element. Povinný pro typ Claimu P2. |
D002 |
P2SalesInvoiceNo |
|
Chybějící element. Povinný pro typ Claimu P2. |
D005 |
Parts |
|
V
kolekci může být max. 99 part elementů. |
SD001 |
Parts |
|
Kolekce obsahuje víc než jeden hlavní díl. |
D002 |
Positions |
|
Chybějící
element. Povinné pokud hlavní operace začíná na N,P,R. |
D005 |
Positions |
|
Kolekce může obsahovat max. 10 position elementů. |
D001 |
ReceptionDate |
ReceptionDate |
ReceptionDate
musí být menší nebo rovno RepairDate. |
D001 |
Remedy |
Remedy |
Délka je větší než 50 znaků. |
D002 |
Remedy |
|
Chybějící
element. |
D001 |
RepairDate |
RepairDate |
RepairDate musí být menší nebo rovno ClaimDate. |
D001 |
RepairOrderNo |
|
Délka
mezi 1-20, Může obsahoavt písmena a
číslice. RegEx: ^[a-z0-9A-Z]{1,20}$ |
D002 |
RepairOrderNo |
|
Chybějící element. |
D005 |
Sublets |
|
Kolekce
může obsahovat max. 12 sublet elementů. |
D001 |
T1 |
T1 |
Právě 2 znaky. RegEx: ^[a-z0-9A-Z]{2}$ |
D002 |
T1 |
|
Chybějící
element. |
D001 |
T2 |
T2 |
Právě 2 znaky. RegEx: ^[a-z0-9A-Z]{2}$. |
D002 |
T2 |
|
Chybějící
element. |
D002 |
VIN |
|
Chybějící element. Je povinný pro typ Claimu: VE, AC, P1, SOPE_VE, SOPE_AC, SOPE_P1, TEC. |
OperationFault
chyby
Kód
chyby |
MemberName |
MemberValue |
Popis |
O003 |
DlrClaimNo |
DlrClaimNo |
Objekt Claim s DlrClaimNo již existuje v databázi
TMCZ. |
O001 |
DlrCode |
DlrCode |
Delaer
nenalezen v databázi TMCZ. |
O002 |
Operations |
|
Kolekce musí obsahovat pouze platné operace. |
O002 |
Parts |
|
Kolekce
musí obsahovat pouze platná čísla náhradních dílů. |
O002 |
Positions |
|
Kolekce musí obsahovat pouze platné PositionCodes |
O002 |
Sublets |
|
Kolekce
musí obsahovat pouze platné SubletCodes. |
O001 |
T1 |
T1 |
T1 kód nenalezen v databázi TMCZ. |
O001 |
T2 |
T2 |
T2
kód nenalezen v databázi TMCZ. |
O001 |
VIN |
VIN |
VIN nenalezen v databázi TMCZ. |
ObjectName =Claims
MemberName = Claim
MemberValue = DlrClaim
Objec
tName = Claim
ObjectID
= DlrClaimNo
MemberName
= Parts
MemberValue =
PartNumbers
ObjectName
= Parts
MemberName
= Part
MemberValue
= PartNo
ObjectName = Part
ObjectID = PartNo
DataFault chyby
Kód |
MemberName |
MemberValue |
Popis |
D001 |
ClaimedAmount |
ClaimedAmount |
Musí být mezi 0 – 10 000 000. |
D001 |
ClaimedQty |
ClaimedQty |
Musí
být mezi 0 – 99. |
D001 |
PartDescription |
PartDescription |
Délka může být max. 50 znaků. |
D001 |
PartNo |
PartNo |
RegEx:
^([a-z0-9A-Z]{5}-[a-z0-9A-Z]{5}-[a-z0-9A-Z]{1,2})$|^([a-z0-9A-Z]{5}-[a-z0-9A-Z]{1,5})$|^([a-z0-9A-Z]{3,5})$ |
D002 |
PartNo |
|
Chybějící element. |
OperationFault
chyby
Kód
chyby |
MemberName |
MemberValue |
Popis |
O001 |
PartCode |
PartCode |
PartCode nanalezen databázi TMCZ. |
ObjectName =Claims
ObjectID =DlrClaimNo
MemberName = Claim
MemberValue = DlrClaim
Objec tName = Claim
Objec tID =
DlrClaimNo
MemberName
=Operations
MemberValue
=OperationCodes
ObjectName = Operations
MemberName
=Operation
MemberValue
= OperationCode
ObjectName = Operation
ObjectID
= OperationCode
DataFault chyby
Kód |
MemberName |
MemberValue |
Popis |
D002 |
ClaimedHours |
|
Povinný pokud na 4. a 5. místě v OperationCode je „99“
nebo na 6. místě „Z“ |
D001 |
OperationCode |
OperationCode |
RegEx:
^[a-z0-9A-Z-]{2,10}$ |
D002 |
OperationCode |
|
Chybějící element. |
D001 |
OperationDescription |
OperationDescription |
Délka
může být max 100 znaků. |
D002 |
OperationDescription |
|
Povinný pokud na 4. a 5. místě v OperationCode je „99“
nebo na 6. místě „Z“ |
OperationFault
chyby
Kód
chyby |
MemberName |
MemberValue |
Popis |
O001 |
OperationCode |
OperationCode |
OperationCode nanalezen databázi TMCZ. |
ObjectName =Claims
ObjectID =DlrClaimNo
MemberName = Claim
MemberValue = DlrClaim
Objec
tName = Claim
MemberValue = DlrClaimNo
MemberName
= Sublets
MemberValue =
SubletCodes
ObjectName = Sublets
MemberName
= Sublet
MemberValue
= SubletCode
ObjectName = Sublet
ObjectID = SubletCode
DataFault chyby
Kód |
MemberName |
MemberValue |
Popis |
D001 |
ClaimedAmount |
ClaimedAmount |
Musí být mezí 0 – 10 000 000. |
D001 |
SubletCode |
SubletCode |
RegEx:
^[a-z0-9A-Z]{2}$ |
D002 |
SubletCode |
|
Chybějící element. |
D001 |
SubletComment |
SubletComment |
Délka
může být max 150 znaků. |
D001 |
SubletDescription |
SubletDescription |
Délka může být max 150 znaků. |
D001 |
SubletInvoiceNo |
SulbetInvoiceNo |
Délka
mezi 2-20. RegEx: ^[a-z0-9A-Z/-]{2,20}$ |
OperationFault chyby
Kód
chyby |
MemberName |
MemberValue |
Popis |
O001 |
SubletCode |
SubletCode |
SubletCode nenalezen databázi TMCZ. |
ObjectName =Claims
ObjectID =DlrClaimNo
MemberName = Claim
MemberValue = DlrClaim
Objec
tName = Claim
MemberValue = DlrClaimNo
MemberName
= Positions
MemberValue
=PositionCodes
ObjectName = Positions
MemberName
= Position
MemberValue
= PositionCode
ObjectName = Position
ObjectID
= PositionCode
DataFault chyby
Kód |
MemberName |
MemberValue |
Popis |
D002 |
PositionCode |
|
Chybějící element. |
D001 |
PositionCode |
PositionCode |
RegEx:
^[NPRnpr]{1}[0-9]{4}$ |
OperationFault chyby
Kód
chyby |
MemberName |
MemberValue |
Popis |
O001 |
PositionCode |
PositionCode |
PositionCode nenalezen databázi TMCZ. |
ClaimStatuses GetClaimStatus(string[] ClaimNumbers, string DealerCode)
Metoda pro získání stavu záručních protokolů.
·
Sample
Request: http://schemas.toyota.cz/WCF/Service01/Samples/ClaimService1.GetClaimStatus_REQUEST.xml
·
Sample
Response XML: http://schemas.toyota.cz/WCF/Service01/Samples/ClaimService1.GetClaimStatus_RESPONSE.xml
string[] GetClaimNumbers(DateTime ReceiveDateFrom, DateTime
ReceiveDateTo, string DealerCode)
Metoda pro získání čísel záručních protokolů v časovém období.
·
Sample
Request: http://schemas.toyota.cz/WCF/Service01/Samples/ClaimService1.GetClaimNumbers_REQUEST.xml
·
Sample
Response XML: http://schemas.toyota.cz/WCF/Service01/Samples/ClaimService1.GetClaimNumbers_RESPONSE.xml
Claims GetClaim(string[] ClaimNumbers, string DealerCode)
Metoda pro získání záručních protokolů.
·
Sample
Request: http://schemas.toyota.cz/WCF/Service01/Samples/ClaimService1.GetClaim_REQUEST.xml
·
Sample
Response XML: http://schemas.toyota.cz/WCF/Service01/Samples/ClaimService1.GetClaim_RESPONSE.xml
Služba pokrývající informace o fakturách záručních protokolů,
·
URL testovací: https://wstest.toyota.cz/Service01/InvoiceService1.svc
Dokumentace:
·
http://schemas.toyota.cz/WCF/Service01/Documentation/InvoiceService1.Well/InvoiceService1.Well.html
string[]
GetInvoiceNumbers(DateTime CreateDateFrom, DateTime CreateDateTo, string DealerCode)
Metoda pro získání čísel faktur vystavených za reklamační protokoly v časovém období.
·
Sample
Request: http://schemas.toyota.cz/WCF/Service01/Samples/InvoiceService1.GetInvoiceNumbers_REQUEST.xml
·
Sample
Response XML: http://schemas.toyota.cz/WCF/Service01/Samples/InvoiceService1.GetInvoiceNumbers_RESPONSE.xml
ClaimInvoiceCollection_INO GetInvoice(string[] InvoiceNumbers, string DealerCode)
Metoda pro získání faktur za reklamační protokoly.
·
Sample
Request: http://schemas.toyota.cz/WCF/Service01/Samples/InvoiceService1.GetInvoice_REQUEST.xml
·
Sample
Response XML: http://schemas.toyota.cz/WCF/Service01/Samples/InvoiceService1.GetInvoice_RESPONSE.xml
Chybové zprávy ze Servisní domény.
Dokumentace
·
http://schemas.toyota.cz/WCF/Service01/Documentation/Faults/Faults.html
Obecné definice
Struktury
http://schemas.toyota.cz/WCF/Service01/Documentation/Faults/Faults.html#Link00000000
Obecné definice
Možné chybové kódy ze servisní domény a jejich popisy.
Kód |
Popis |
SD001 |
Main part must be just one. |
SD002 |
Main operation must be just one. |
Struktury
·
http://schemas.toyota.cz/WCF/Service01/Documentation/Faults/Faults.html#Link00000006
Obecné definice
Možné chybové kódy ze servisní domény a jejich popisy.
Kód |
Popis |
SO001 |
Authorization is not working. Dealer code could not be obtained. |
SO002 |
Cannot
insert claim with another dealer code. Dealer with appropriate code must be
logged in. |
Rozhraní, která se týkají ověřování identity a přístupových práv TMCZ+DLR uživatelů k externím webovým aplikacím.
Služba pokrývající autentizaci a autorizaci doménových uživatelů TMCZ/TMSK+partnerů do extranetových aplikací.
Standardní ověřovací schéma je:
· Uživatel přichází na (vaši) www aplikaci – teoreticky do libovolné cesty
· Když aplikace zjistí neověřeného klienta, přesměruje ho na přihlašovací stránku na serveru TMCZ
· Pokud uživatel zadá platné jméno a heslo a má práva k aplikaci (alespoň 1 roli), je přesměrován zpět a v URL je uveden unikátní klíč session
· Aplikace zavolá AuthorizationService, aby ověřila pravost klíče a případně zjistila rozsah oprávnění a případně detaily uživatele a jeho firmy/pobočky.
Dokumentace:
Pro autentizaci (ověření ticketu) a autorizaci (získání rolí) lze použít metodu:
·
Session GetSessionByTicket(int applicationID, string
sessionTicketValue)
Tato metoda poskytuje (v kombinaci s PartyService) všechny dostupné údaje. Pokud je aplikace nepotřebuje, lze místo toho v zájmu rychlejšího volání využít následující redukované metody:
·
Roles GetRolesByTicket(int applicationID, string
sessionTicketValue)
·
Boolean HasRoleByTicket(int applicationID, int
roleID, string sessionTicketValue)
Pro získání objetku session z Credentials slouží metoda:
·
Session GetSessionByCredentials(int applicationID, string
username, string domain, string password)
Pro zpětnou
kompatibilitu jsou k dispozici i následující metody:
·
Company HasRoleGetOrganizationDetailsByTicket(int applicationID, int
roleID, string sessionTicketValue)
·
Person GetIdentityPersonByTicket(string sessionTicketValue)
·
Company GetIdentityCompanyByTicket(string sessionTicketValue)
·
Parties GetIdentityPartiesByTicket(string sessionTicketValue)
Jejich použití však nedoporučujeme.
Session GetSessionByTicket(int applicationID, string
sessionTicketValue)
Vrací objekt Session, pokud je session stále platná. V něm je obsaženo login a displayName uživatele, seznam jeho rolí a odkazy na podrobné objekty Party fyzické osoby uživatele a jeho organizace (firmy). Ty lze následně získat voláním služby PartyService.GetParty
·
Sample Request: http://schemas.toyota.cz/WCF/Authorization01/Samples/AuthorizationService1.GetSessionByTicket_REQUEST.xml
·
Sample response XML: http://schemas.toyota.cz/WCF/Authorization01/Samples/AuthorizationService1.GetSessionByTicket_RESPONSE.xml
Roles
GetRolesByTicket(int applicationID, string sessionTicketValue)
Vrací kolekci rolí přiřazených uživateli, pokud je session platná.
·
Sample Request: http://schemas.toyota.cz/WCF/Authorization01/Samples/AuthorizationService1.GetRolesByTicket_REQUEST.xml
·
Sample response XML: http://schemas.toyota.cz/WCF/Authorization01/Samples/AuthorizationService1.GetRolesByTicket_RESPONSE.xml
Boolean HasRoleByTicket(int applicationID, int
roleID, string sessionTicketValue)
Vrací true, pokud je session platná a uživatel má danou roli, jinak false.
·
Sample Request: http://schemas.toyota.cz/WCF/Authorization01/Samples/AuthorizationService1.HasRoleByTicket_REQUEST.xml
·
Sample response XML: http://schemas.toyota.cz/WCF/Authorization01/Samples/AuthorizationService1.HasRoleByTicket_RESPONSE.xml
Session GetSessionByCredentials(int applicationID, string username, string domain, hh password)
Vrací objekt Session pokud jsou platná credentials. V případě chybných credentials vrací null.
·
Sample Request:
·
Sample response XML:
·
URL testovací: http://briantest.corp.toyota.cz/Authenticate.aspx?ApplicationId=n
http://briantest.corp.toyota.cz/Logout.aspx
URL produkční: http://brian.corp.toyota.cz/Authenticate.aspx?ApplicationId=n
http://brian.corp.toyota.cz/Logout.aspx
Povinný parametr:
·
ApplicationId –
ID aplikace (int, přidělí vám ho TMCZ)
Volitelný parametr:
·
RedirPath –
relativní nebo absolutní cesta, na kterou se má klient vrátit. Není-li uveden,
je klient přeměrován na URL referrer, případně na úvodní stránku aplikace
Návratový parametr:
·
TicketValue – unikátní
ověřovací identifikátor (guid)
Uživatel může zrušit přihlášení (session) vůči TMCZ pomocí Logout.aspx. Při dalším přístupu na stránku Authenticate.aspx je opět vyzván k zadání jména/hesla. Pokud existuje aktivní ticket pro danou aplikaci a uživatele, použije se a prodlouží.
Typyzované návratové chyby TMCZ.
Tato chyba se používá v případě neošetřené vyjímky. Např. databázový server není k dispozici apod.
Dokumentace
· http://schemas.toyota.cz/WCF/Documentation/Faults/Faults.html#Link00000004
Možné chybové kódy a jejich popisy.
Kód |
Popis |
G001 |
General error occured on the server |
Používá se v případě, že lient pošle nesprávný DataContract. Např. V objektu objednávka bude chybět číslo objednávky. DataFault navíc obsahuje kolekcí dalších DataFault.
Dokumentace
· http://schemas.toyota.cz/WCF/Documentation/Faults/Faults.html#Link00000001
Možné chybové kódy a jejich popisy.
Kód |
Popis |
D001 |
Value is invalid. |
D002 |
Data
Member (element) is missing. |
D003 |
Value can not be null. |
D004 |
Fault
is in inner object (element). |
D005 |
Maximum count of
items is exceeded. |
D006 |
Minimum count of items is not exceeded. |
Používá se v případě, že ošetřená chyba nastane u metody. Např. object neexistuje nebo je ve špatném stavu apod.
Dokumentace
·
http://schemas.toyota.cz/WCF/Documentation/Faults/Faults.html#Link00000007
Možné chybové kódy a jejich
popisy.
Kód |
Popis |
O001 |
Object not found in system or database. |
O002 |
Object
is in wrong state. |
O003 |
Object already exists in system/database. |