...

Requirements

...

Requirements

• TLS 1.2
  • When calling the web services for CXT Cloud customers (designated by a domain in the format <CXTID>0.cxtsoftware.net), the calling system must connect with TLS 1.2
  • TLS 1.2 is not supported on Windows 2008 R2 or below. The calling system can run Windows 7, 8.1 or 2012 or newer, all of which support TLS 1.2

...

1. Navigate to URL: https://<domain>/CxtWebService/CXTWCF.svc/api-docs

2. Authenticate by either getting an authentication token or using basic authentication. See Authenticate. Depending on the user type allowed to access the endpoint, you may need different tokens.  

3. If getting an authorization token, place token in the Authorization Token box at the top. 

   DivImage Modified
4. Make endpoint requests in JSON or XML

...

• If the "Enforce Address Validation" global option is checked inside the Operations App, an order/stop will be successfully placed only if the address is validated; the order will fail if the address cannot be validated. If "Enforce Address Validation" is unchecked, the order placement will succeed regardless of validation.
• Only the geocode (lat/lon) is updated when the addresses can be validated. 
• If the "Enforce address validation when using web service" global option is checked inside the Operations App, route stops created through the web service will have address validation enforced.

Attachments

Requirements for uploading a file (attachment creation/update):

...

You can see which user type(s) are required for an endpoint under "Implementation Notes". For example, "Allowed requestors: [Inet user]" requires an authenticated internet user and  "Allowed requestors: [Mobile Users]" requires an authenticated driver user.  

Image Modified

To authenticate, select sending an authorization token or doing a basic authentication with the call.

...

• Driver endpoint: /v2/Authentication/Drivers 

  Div

  • Valid duration of an authentication token: 30 days  

  note

  title	X Dispatch User Note

  • "Allow web access" must be enabled on the driver record in the Operations App application. See Drivers (Classic Operations App).

• Internet User endpoint: /v2/Authentication/InetUser 

  Div

  • Valid duration of an authentication token: 20 minutes

  NotetitleX Dispatch User Note

  • "Allow Web Service API" must be enabled on the internet user record in the Operations App application. See Internet Users (Classic Operations App).

• Human Resources endpoint: /v2/Authentication/Worker  

  div

  • 
    

    Valid duration of an authentication token: 30 days

  note

  • See Human Resources - New / Edit Human Resource. 

    
    

• Operations App User endpoint: /v2/Authentication/XdUser 

  div
  • Valid duration of an authentication token: 3 hours 

Token expiration is automatically extended with each call. 

...

Basic authentication credentials must be sent with every request, base64 encoded and the username must be prefixed with 1 or 4 values to distinguish user type:

• Driver prefix: DRIVER
  • Internet User prefix: INET
  • Human Resources prefix: WORKER
  • Operations App User prefix: XDISPATCH

An example of an internet user with the username "cxtsupport" is "INET-cxtsupport".

...

How to Create a Route Stop

You can use the /v2/RouteStops endpoint to create new route stops in the Operations App.

Endpoint URL: https://XXXX0.cxtsoftware.net/CxtWebService/CXTWCF.svc/api-docs/index.html?url=/CxtWebService/CXTWCF.svc/v2/swagger.json#!/Route_Stops/CxtSoftware_MiddleTier_WebService_CXTWCF_PostRouteStopV2

Section: Route Stops

Endpoint: /v2/RouteStops

Implementation Notes: Allowed requestors: [XD User]

...

Troubleshooting

...