...
Click here for the Service Description WSDL and Annotated XSDs
Recent Updates:
- NEW FEATURES in v2.0.102 - 03/10/2018
- Settings Group Membership Assignment for Vehicles on Vehicle, Vehicle Type and Terminal
- Settings Group Membership Assignment for Vehicles on Vehicle, Vehicle Type and Terminal
- CORRECTION in v2.0.101 - 01/25/2018 - PLEASE UPDATE YOUR IMPLEMENTATION
AuthorityGroupAssignment operation response ‘errors’ element has been changed to “Errors” due to issues it caused with newer java wsdlimport
Expand title Example of Namespace Rewrite Response Example prior to 01/25/2018 v2.0.101:
Response Example after 01/25/2018 v2.0.101:
- Carrier_GetAll default namespace has been changed to AdminService_v2
The service will detect if the client request uses DataService_v2 and will rewrite the response to use that namespace to prevent breaking change. Otherwise, the service will respond with the correct NS of AdminService_v2
Expand title Example of Namespace Rewrite Example using incorrect DataService_v2 Namespace - Service will rewrite response to match to prevent breaking client integrations developed before 01/25/2018 v2.0.101:
Example using default namespace of AdminService_v2 Namespace after 01/25/2018 v2.0.101:
- NEW in v2.0.100 - 11/01/2017
- Update to support new backend framework. No API changes are being made at this time
- NEW in v2.0.90
- NEW 02/2015: Support for Multiple Operating Authority and Hierarchical Reporting Groups
- Terminal Setting configurations(s)
- Authority Group Membership management
Existing ReportingGroup_GetAll operation will automatically include Hierarchical Reporting Groups and Membership (if enabled)
Expand title Click to expand for details.... - The ID of a Hierarchical reporting group will be comprised using "Hi word, Lo word": (CompanyId * 2^16) + TerminalId
This will produce result where:- Value does not complete with existing Custom Reporting Groups
- Value is a positive integer (does not require any change to Vendor software)
- Value is easily/accurately encoded and decoded to/from HiLo value
- CompanyId has a ceiling of 32768 (set at 30k to provide a buffer if needed in the future)
- TerminalId has a ceiling of 65535 (set at 60k to provide a buffer if needed in the future)
Examples:- A Company Level Hierarchical Reporting Group:
CompanyId = 201
CompanyName = BurgerKing
======================================
HierarchicalReportingGroupId = 13172736
HierarchicalReportingGroupName = "BurgerKing" (Company Name Only) - A Terminal Level Hierarchical Reporting Group:
CompanyId = 201
CompanyName = BurgerKing
TerminalId = 54
TerminalName = Denver102
======================================
HierarchicalReportingGroupId = 13172790
HierarchicalReportingGroupName = "BurgerKing - Denver102"
- A Company Level Hierarchical Reporting Group:
- Existing structure is not affected:
- The ID of a Hierarchical reporting group will be comprised using "Hi word, Lo word": (CompanyId * 2^16) + TerminalId
...