Histórico da Página
Introduction
draw.io Diagram | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Systems Involved
- TOTVS Otimização Logística / TOTVS Roteirização e Entrega
- External System: ERPs that connect or intend to connect with TOL/TRE
Integration
Scope
Asynchronous integration consisting of Trip Release and Trip Unblock services:
- If the orderBreakParts tag is empty, there are no breaks (splits) for trips sent in the interface;
- If the orderBreakParts tag is filled in, it means that there are trips on this interface that have breaks (splits); if this occurs, you must identify, within this structure, the transport requests that suffered breaks through the following fields:
- o orderSourceId: This field is the identifier of the transport request received in the order interface; if a transport request is inside the orderBreakParts structure, it means that it has suffered a break;
- o orderItemSourceId: This field is the item identifier of the transport order received in the order interface;
- If a transport order item is inside the orderBreakParts structure, it means that this item (which is inside the orderSourceId order) suffered a break;
- The loadId field that exists within the orderBreakParts structure serves to associate the transport request (orderSourceId and orderItemSourceId fields) with the load generated by TOL\TRE in this interface;
- The quantities updated by TOL\TRE after breaks must be obtained in the fields: quantShipmUnits; the quantProdUnits;
- o orderItemSourceId: This field is the item identifier of the transport order received in the order interface;
- o orderSourceId: This field is the identifier of the transport request received in the order interface; if a transport request is inside the orderBreakParts structure, it means that it has suffered a break;
Installation/Deployment/Usage Prerequisites
Minimum versions
- TOL\TRE: 6.4.0
- Protheus: ?
- Datasul: ?
- This integration requires no additional installations or updates.
Requisition Layout
Âncora doUnblockReleasedTrip doUnblockReleasedTrip
doUnblockReleasedTrip: SOAP, Asynchronous integration with publishReleasedTrip; | |||||
---|---|---|---|---|---|
Name | Type | Mandatory | Size | Description | Observation |
unblockReleasedTrips | unblockReleasedTrips[] | Yes | N/A | Grouping element for all travel release requests; |
Âncora unblockReleasedTrips unblockReleasedTrips
unblockReleasedTrip, data type used in TOL/TRE integrations | |||||
---|---|---|---|---|---|
Name | Type | Mandatory | Size | Description | Observation |
unblockReleasedTrips | unblockReleasedTrip[] | Yes | N/A | Grouping element for all travel release requests; |
Âncora | ||||
---|---|---|---|---|
|
unblockReleasedTrip, data type used in TOL/TRE integrations | |||||
---|---|---|---|---|---|
Name | Type | Mandatory | Size | Description | Observation |
identifier (unblock release trip) | Integer | Yes | 10 | ID of the trip release request message; | This field must be from a valid trip release request message or -1 when an error occurs in the external system when trying to recreate TOL/TRE trips (in this case, the request made in this service will be ignored by the TOL/TRE); in the case of an error in the external system, the details of this error can be sent in the "ERPMessageResponses" element; |
ERPMessageResponses | eRPMessageResponseList[] | No | N/A | Grouping entity of external system responses; | |
orderBreakResponses | No | N/A | Bundling entity of an external system response to a TOL/TRE break; | Note: If all but 1 of the breaks passed, the last one will be automatically approved; | |
tripReleaseResponses | tripReleaseResponseList[] | Yes | N/A | Grouping entity of an external system response to TOL/TRE trip releases; | |
tripLoadsSourceIds | tripLoadsSourceIdList[] | Yes | N/A | Grouping entity for sending the source ids of the loads from the external system to the TOL/TRE; |
Âncora eRPMessageResponseList eRPMessageResponseList
eRPMessageResponseList, data type used in TOL/TRE integrations | |||||
---|---|---|---|---|---|
Name | Type | Mandatory | Size | Description | Observation |
ERPMessageResponses | eRPMessageResponse[] | Yes | N/A | Grouping element for all travel release requests; |
Âncora eRPMessageResponse eRPMessageResponse
eRPMessageResponse, data type used in TOL/TRE integrations | |||||
---|---|---|---|---|---|
Name | Type | Mandatory | Size | Description | Observation |
msg | String | Yes | N/A | External system response message; |
Âncora orderBreakResponses orderBreakResponses
orderBreakResponses, data type used in TOL/TRE integrations | |||||
---|---|---|---|---|---|
Name | Type | Mandatory | Size | Description | Observation |
orderBreakResponses | orderBreakResponse[] | Yes | N/A | Grouping element for all travel release requests; |
Âncora orderBreakResponse orderBreakResponse
orderBreakResponse , data type used in TOL/TRE integrations | |||||
---|---|---|---|---|---|
Name | Type | Mandatory | Size | Description | Observation |
regionSourceId | String | Yes | 30 | Regional identifier; | Must be a valid regional; |
breakId | Integer | Yes | 10 | TOL/TRE Break ID; | This field must be assigned a valid break ID; you should not resubmit break IDs that have already been released; the external system must return all breakIds generated by TOL/TRE in the trip release interface for it to be released; |
orderId | String | Yes | 30 | Transport order ID associated with the break; | Important: - If the external system wants this break to be linked to a new order, just inform the name of the new order in this field; the units related to this break will be associated with the new order; the new order data will be copied from the original order; - This order change will only be carried out if the status field is sent with the value "1"; |
orderItemId | String | Yes | 30 | Item ID of the transport order associated with the break; | Important: - If the external system wants this break to be linked to a new order item, Yesply inform the name of the new order item in this field; the units related to this break will be associated with the new order item; the new order item data will be copied from the original order item; - This change to the order item will only be carried out if the status field is sent with the value "1"; - If the order item code is changed but the order code remains the same as the original order, the message will be rejected; |
status | Boolean | Yes | 1 | External system response status about breaking TOL/TRE; | 0=Break not performed; 1=Break performed; |
msg | String | No | 500 | External system response message about breaking TOL/TRE; |
Âncora tripReleaseResponseList tripReleaseResponseList
tripReleaseResponseList, data type used in TOL/TRE integrations | |||||
---|---|---|---|---|---|
Name | Type | Mandatory | Size | Description | Observation |
tripReleaseResponseList | tripReleaseResponse[] | Yes | N/A | Grouping element for all travel release requests; |
Âncora | ||||
---|---|---|---|---|
|
tripReleaseResponse, data type used in TOL/TRE integrations | |||||
---|---|---|---|---|---|
Name | Type | Mandatory | Size | Description | Observation |
regionSourceId | String | Yes | 30 | Regional identifier; | Must be a valid regional; |
tripCode | Integer | Yes | 10 | TOL/TRE Trip ID; | This field must contain a valid trip ID; you should not submit trip IDs that have already been cleared; |
orderSourceId | String | Yes | 30 | Transport order ID associated with the trip; | This field must contain a valid order ID for the trip; |
itemId | String | Yes | 30 | ID do item do pedido de transporte associado ao pedido da viagem; | This field must receive a valid order item ID for the trip order; the external system must return all existing order items in the trip for it to be released; |
status | Boolean | No | 1 | External system response status about the TOL/TRE trip; | 0=Does not unlock the trip; 1=Unlocks the trip; if this field is not filled in, it will be considered as 0; |
msg | String | No | 500 | External system response message about TOL/TRE trip; |
Âncora tripLoadsSourceIdList tripLoadsSourceIdList
tripLoadsSourceIdList, data type used in TOL/TRE integrations | |||||
---|---|---|---|---|---|
Name | Type | Mandatory | Size | Description | Observation |
tripLoadsSourceIds | tripLoadsSourceId[] | Yes | N/A | Grouping entity for sending the source ids of the loads from the external system to the TOL/TRE; |
Âncora tripLoadsSourceId tripLoadsSourceId
tripLoadsSourceId, data type used in TOL/TRE integrations | |||||
---|---|---|---|---|---|
Name | Type | Mandatory | Size | Description | Observation |
regionSourceId | String | Yes | 30 | Regional identifier; | Must be a valid regional; |
tripId | Integer | Yes | 10 | ID of a TOL/TRE trip; | |
loads | load[] | Yes | N/A | Grouping element of all the loads of the trip; | When shipped, this section must return all cargo for the trip; |
Âncora load load
load, data type used in TOL/TRE integrations | |||||
---|---|---|---|---|---|
Name | Type | Mandatory | Size | Description | Observation |
loadId | Integer | Yes | 10 | Trip load ID in the TOL/TRE; | These fields are just so that you can have a reference to the ID of an external system load in the TOL/TRE; if the loadId is not valid (eg empty or a non-existent code in the TOL/TRE) or is associated with a trip other than the one informed, the TOL/TRE must return an error message and the request must be ignored; |
loadSourceId | Integer | Yes | 30 | Trip load ID in the external system; |
Answer Layout
tripLoadsSourceIdList, data type used in TOL/TRE integrations | |||||
---|---|---|---|---|---|
Name | Type | Mandatory | Size | Description | Observation |
result | results[] | Yes | N/A | Grouping entity for sending the results |
Âncora | ||||
---|---|---|---|---|
|
results, data type used in TOL/TRE integrations | |||||
---|---|---|---|---|---|
Name | Type | Mandatory | Size | Description | Observation |
results | result[] | Yes | N/A | Grouping entity for sending the results |
Âncora | ||||
---|---|---|---|---|
|
result, data type used in TOL/TRE integrations | |||||
---|---|---|---|---|---|
Name | Type | Mandatory | Size | Description | Observation |
errorCodes | errcode[] | No | N/A | List of errors | |
errorMessage | String | No | N/A | Error message | |
identifier | String | Yes | N/A | ID of the trip release request message; | |
sucess | String | Yes | 1 | TRUE or FALSE |
Âncora | ||||
---|---|---|---|---|
|
errcode, data type used in TOL/TRE integrations | |||||
---|---|---|---|---|---|
Name | Type | Mandatory | Size | Description | Observation |
value | String | No | N/A | Error code |
Error catalog
Âncora | ||||
---|---|---|---|---|
|
Code | Message | Description |
Attachments
Anexos