Introduction

Systems Involved

  • TOTVS Otimização Logística / TOTVS Roteirização e Entrega
  • External System: ERPs that connect or intend to connect with TOL/TRE

Scope

  • This integration aims to provide an access token for the external system to be able to interact with the TOL/TRE execution module
  • In order to minimize the traffic of access credentials to the system and given valid credentials, this integration returns an access token to the external system, thus enabling the validation of the authenticity of transactions between systems to become a token.

Installation/Deployment/Usage Prerequisites

  • Minimum versions

    • TOL/TRE:  6.4.0
    • Protheus:  ?
    • Datasul: ?
  • This integration requires no additional installations or updates.

Requisition Layout

createGatewayAuthenticationRequest, SOAP Integration, Synchronous
NameTypeMandatorySizeDescriptionObservation
usernameStringYesN/A

User able to access TOL/TRE


passwordStringYesN/A

user password


regionSourceIdStringNoN/A

Region linked to user

This field is validated only in the planning module

Answer Layout

createGatewayAuthenticationResponse, data type used in TOL/TRE integrations
NameTypeMandatorySizeDescriptionObservation
successfulBooleanYesN/A

User Authentication Confirmation


tokenStringNoN/A

Access token that must be inserted in SOAP headers


Error catalog

CodeMessageDescription
Attachments

  Arquivo Modificado
Arquivo authentication.wsdl 04 mai, 2023 by Julio Vinicius Oliveira dos Santos
Arquivo Authentication draw.io diagram 09 mai, 2023 by Julio Vinicius Oliveira dos Santos
Arquivo PNG Authentication.png Authentication exported to image 09 mai, 2023 by Julio Vinicius Oliveira dos Santos
Arquivo XML Authentication Example.xml 02 jun, 2023 by Julio Vinicius Oliveira dos Santos