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

Installation/Deployment/Usage Prerequisites

  • Minimum versions

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

Requisition Layout

createInvoices/updateInvoices/deleteInvoices: SOAP Integration, Synchronous
NameTypeMandatorySizeDescriptionObservation
regionSourceIdStringYes30Regional Identifier;Must be a valid regional;
identifierStringYes20Invoice identifier;
nameStringNo255Invoice name;
descriptionStringNo255Invoice description;
orderSourceIdsStringYes30SourceId list of orders associated with the invoice;May be empty for delete operation;
NFeKeyStringNo255Electronic Invoice Key;
totalValueFloatNo13Total invoice amount;Required on creation and update;
totalWeightFloatNo13Total weight of invoice;Required on creation and update;

Answer Layout

invoicesResponse, data type used in TOL/TRE integrations
NameTypeMandatorySizeDescriptionObservation
resultresult[]YesN/AGrouping element of all results;There must be at least 1 result in this list;
sucessBooleanYes1Success or failure flag;

result, data type used in TOL/TRE integrations
NameTypeMandatorySizeDescriptionObservation
errorCodesStringNo30List of error codes;
errorMessageStringNo255Error messages;
identifierStringNo30invoice identifier;
sucessBooleanYes1Success or failure flag;

Error catalog

CodeMessageDescription

Attachments

  Arquivo Modificado
Arquivo XML R2_Invoice-example.xml 04 mai, 2023 by Julio Vinicius Oliveira dos Santos
Arquivo XML InvoiceAcquisitionService.xml 04 mai, 2023 by Julio Vinicius Oliveira dos Santos
Arquivo Invoice Aquisition draw.io diagram 09 mai, 2023 by Julio Vinicius Oliveira dos Santos
Arquivo PNG Invoice Aquisition.png Invoice Aquisition exported to image 09 mai, 2023 by Julio Vinicius Oliveira dos Santos

  • Sem rótulos