Tracking Request

Endpoint Definition

Request

• Request-Urls:

- https://solventum.viya.me/api/custom/request-tracking/gs1ti/v1
- https://solventum.viya.me/api/custom/request-tracking/gs1ti/v1?environment=QA
- https://solventum.viya.me/api/custom/request-tracking/gs1ti/v1?environment=UAT
- https://solventum.viya.me/api/custom/request-tracking/gs1ti/v1?environment=DEV

• Request-Method: PUT
• Accept: application/xml; charset=utf-8
• Accept-encoding: gzip, deflate
• x-api-pat:: {{PAT_TOKEN}}

Request Body

Using the contents as discussed, currently the following XSD is used:

• https://www.gs1.org/standards/edi-xml/xml-transport-instruction-and-response/3-2

Response Headers

• Content-type: application/xml; charset=utf-8

Responses:

The GS1-TI endpoint will be an async endpoint, adding new gs1-ti messages to a que that are processed by Viya. The GS1-TI is a custom ingress and will result in two seperate object created in Viya. A Trailer/Consignment (for the Despatch Advice) and multiple shipments, with Handling Units & Overpacks.

202 Accepted

• Payload: No Content

401 Unauthorized

• Payload: No Content

500 Server Error

• Payload: No Content

503 Service Unavailable

• Payload: No Content

Exception Responses / process

Exceptions for the GS1-TI endpoint will result in a callback to a status endpoint and/or an mail to the person responsible for the process. Depending on the exception a change in SAP can be made and the process can be retried or a issues is raised to resolve the technical problem.

Most common exceptions:

```XML
<problem xmlns="urn:ietf:rfc:7807">
    <messageId>12893752289</messageId>
    <reference>TRL1036LNUM</reference>
    <title>Invalid XML according to schema</title>
    <status>400</status>
    <detail>Elements in the XML are invalid, see details in errors</detail>
    <instance>api/v0/gs1-ti</instance>
    <type>https://httpstatuses.com/400</type>
    <timestamp>2021-06-14 09:13:18<timestamp>
    <errors>The element 'transportInstruction' has invalid child element 'NonExistent'. List of possible elements expected: 'logisticServicesSeller'; 
            The 'date' element is invalid - The value 'aaa' is invalid according to its datatype. http://www.w3.org/2001/XMLSchema:date' - The string 'aaa' is not a valid Date value
    </errors>
</problem> 
```