Trinium
=============================================================================

:Provider Information:

+-----------------+-----------------------------------------------+
| **Id**          | trinium                                       |
+-----------------+-----------------------------------------------+
| **Type**        | terminal                                      |
+-----------------+-----------------------------------------------+
| **Trace Type**  | API                                           |
+-----------------+-----------------------------------------------+
| **Credentials** | Customer credentials                          |
+-----------------+-----------------------------------------------+
| **Limits**      | Maximum number of containers per request is 5 |
+-----------------+-----------------------------------------------+
| **Status**      | draft                                         |
+-----------------+-----------------------------------------------+
| **Doc Status**  | draft                                         |
+-----------------+-----------------------------------------------+
| **Doc Version** | 1                                             |
+-----------------+-----------------------------------------------+



:URLs:

+---------+-----------------------------------+-------------+
| Type    | URL                               | Environment |
+=========+===================================+=============+
| Request | https://pipeline.triniumtech.com/ | PRD/DEV/STG |
+---------+-----------------------------------+-------------+

:Sites:

+------+---------+-----------------+
| Name | Site Id | Description     |
+======+=========+=================+
| name | ern     | the description |
+------+---------+-----------------+

Request
-----------------------------------------------------------------------------

Query Containers Request
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Query containers using the following request by adding the LocationCode and container numbers in the request url as following.

..  code-block:: shell

    GET https://pipeline.triniumtech.com/cgi-bin/web/WService=wsam/websrc/ss3.p?wfacct={account}&wfacctpwd={accountPassword}&wfsite={locationCodeValue}&wfsiteuid={user}&wfsitepwd={password}&wfcontainers={Containers}

..  note::
    trinium API supports different terminals, in order to query data related to one of them, the **locationCode** has to be provided inside the data with the terminal AM Trace name.



Responses
-----------------------------------------------------------------------------

Query Containers Response
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Next response is for three containers MSCU5303578,MSCU5317020, TTTR0000001 represents found containers and not found one.

..  code-block:: xml

    <TRACEROOT>
        <trace-acct-code>zsales600</trace-acct-code>
        <trace-site>GREER</trace-site>
        <trace-containers>MSCU5303578,MSCU5317020,TTTR0000001</trace-containers>
        <trace-error></trace-error>
        <trace-status></trace-status>
        <TRACERESPONSE>
            <TRCCONTAINER>MSCU5303578</TRCCONTAINER>
            <TRCCONTAINERNUMBER>MSCU5303578</TRCCONTAINERNUMBER>
            <TRCCONTAINER>MSCU5303578</TRCCONTAINER>
            <TRCDATETIME>SUCCESS</TRCDATETIME>
            <TRCSCRAPESITE>GREER</TRCSCRAPESITE>
            <TRCSCRAPEPAGE>qry</TRCSCRAPEPAGE>
            <TRCTRACEVER>1</TRCTRACEVER>
            <TRCTRACECLEAN>p-ss-greer-01.p</TRCTRACECLEAN>
            <TRCAVAILABLE>TRUE</TRCAVAILABLE>
            <TRCAVAILABLEVAL></TRCAVAILABLEVAL>
            <TRCSSLINE>MED</TRCSSLINE>
            <TRCVESSEL>AMERICA / 447A</TRCVESSEL>
            <TRCVESSELATA>01/15/2025</TRCVESSELATA>
            <TRCDISCHARGEDATE>01/15/2025</TRCDISCHARGEDATE>
            <TRCDISCHARGEDATEVAL>01/15/2025 15:41:51</TRCDISCHARGEDATEVAL>
            <TRCDISCHARGETIME>15:41:51</TRCDISCHARGETIME>
            <TRCDISCHARGETIMEVAL>01/15/2025 15:41:51</TRCDISCHARGETIMEVAL>
            <TRCCONTAINERSTATUS></TRCCONTAINERSTATUS>
            <TRCCONTAINERSTATUSVAL></TRCCONTAINERSTATUSVAL>
            <TRCFREIGHTHOLDS>FALSE</TRCFREIGHTHOLDS>
            <TRCFREIGHTHOLDSVAL></TRCFREIGHTHOLDSVAL>
            <TRCOUTGATE>01/24/2025 15:19:59</TRCOUTGATE>
            <TRCCNTRISO>S40H</TRCCNTRISO>
            <TRCRAILUNLOADDATE>01/20/2025</TRCRAILUNLOADDATE>
            <TRCRAILUNLOADDATEVAL>01/20/2025 16:18:54</TRCRAILUNLOADDATEVAL>
            <TRCRAILUNLOADTIME>16:18:54</TRCRAILUNLOADTIME>
            <TRCRAILUNLOADTIMEVAL>01/20/2025 16:18:54</TRCRAILUNLOADTIMEVAL>
            <TRCEIRNUMBER></TRCEIRNUMBER>
            <TRCCARRIER></TRCCARRIER>
            <TRCCHASSISNUMBER></TRCCHASSISNUMBER>
            <TRCGENSET></TRCGENSET>
            <TRCCATEGORY></TRCCATEGORY>
            <TRCTRUCKERLICENSE></TRCTRUCKERLICENSE>
            <TRCTRUCKER></TRCTRUCKER>
            <TRCOUTGATED></TRCOUTGATED>
            <TRCOUTGATEDVAL></TRCOUTGATEDVAL>
            <TRCOUTGATEDDATE></TRCOUTGATEDDATE>
            <TRCOUTGATEDDATEVAL></TRCOUTGATEDDATEVAL>
            <TRCOUTGATEDTIME></TRCOUTGATEDTIME>
            <TRCOUTGATEDTIMEVAL></TRCOUTGATEDTIMEVAL>
            <TRCINGATED></TRCINGATED>
            <TRCINGATEDVAL></TRCINGATEDVAL>
            <TRCINGATEDDATE></TRCINGATEDDATE>
            <TRCINGATEDDATEVAL></TRCINGATEDDATEVAL>
            <TRCINGATEDTIME></TRCINGATEDTIME>
            <TRCINGATEDTIMEVAL></TRCINGATEDTIMEVAL>
        </TRACERESPONSE>
        <TRACERESPONSE>
            <TRCCONTAINER>MSCU5317020</TRCCONTAINER>
            <TRCCONTAINERNUMBER>MSCU5317020</TRCCONTAINERNUMBER>
            <TRCCONTAINER>MSCU5317020</TRCCONTAINER>
            <TRCDATETIME>SUCCESS</TRCDATETIME>
            <TRCSCRAPESITE>GREER</TRCSCRAPESITE>
            <TRCSCRAPEPAGE>qry</TRCSCRAPEPAGE>
            <TRCTRACEVER>1</TRCTRACEVER>
            <TRCTRACECLEAN>p-ss-greer-01.p</TRCTRACECLEAN>
            <TRCAVAILABLE>TRUE</TRCAVAILABLE>
            <TRCAVAILABLEVAL></TRCAVAILABLEVAL>
            <TRCSSLINE>MED</TRCSSLINE>
            <TRCVESSEL>AMERICA / 447A</TRCVESSEL>
            <TRCVESSELATA>01/15/2025</TRCVESSELATA>
            <TRCDISCHARGEDATE>01/16/2025</TRCDISCHARGEDATE>
            <TRCDISCHARGEDATEVAL>01/16/2025 01:33:33</TRCDISCHARGEDATEVAL>
            <TRCDISCHARGETIME>01:33:33</TRCDISCHARGETIME>
            <TRCDISCHARGETIMEVAL>01/16/2025 01:33:33</TRCDISCHARGETIMEVAL>
            <TRCCONTAINERSTATUS></TRCCONTAINERSTATUS>
            <TRCCONTAINERSTATUSVAL></TRCCONTAINERSTATUSVAL>
            <TRCFREIGHTHOLDS>FALSE</TRCFREIGHTHOLDS>
            <TRCFREIGHTHOLDSVAL></TRCFREIGHTHOLDSVAL>
            <TRCOUTGATE>01/21/2025 22:33:52</TRCOUTGATE>
            <TRCCNTRISO>S40H</TRCCNTRISO>
            <TRCRAILUNLOADDATE>01/20/2025</TRCRAILUNLOADDATE>
            <TRCRAILUNLOADDATEVAL>01/20/2025 01:18:57</TRCRAILUNLOADDATEVAL>
            <TRCRAILUNLOADTIME>01:18:57</TRCRAILUNLOADTIME>
            <TRCRAILUNLOADTIMEVAL>01/20/2025 01:18:57</TRCRAILUNLOADTIMEVAL>
            <TRCEIRNUMBER></TRCEIRNUMBER>
            <TRCCARRIER></TRCCARRIER>
            <TRCCHASSISNUMBER></TRCCHASSISNUMBER>
            <TRCGENSET></TRCGENSET>
            <TRCCATEGORY></TRCCATEGORY>
            <TRCTRUCKERLICENSE></TRCTRUCKERLICENSE>
            <TRCTRUCKER></TRCTRUCKER>
            <TRCOUTGATED></TRCOUTGATED>
            <TRCOUTGATEDVAL></TRCOUTGATEDVAL>
            <TRCOUTGATEDDATE></TRCOUTGATEDDATE>
            <TRCOUTGATEDDATEVAL></TRCOUTGATEDDATEVAL>
            <TRCOUTGATEDTIME></TRCOUTGATEDTIME>
            <TRCOUTGATEDTIMEVAL></TRCOUTGATEDTIMEVAL>
            <TRCINGATED></TRCINGATED>
            <TRCINGATEDVAL></TRCINGATEDVAL>
            <TRCINGATEDDATE></TRCINGATEDDATE>
            <TRCINGATEDDATEVAL></TRCINGATEDDATEVAL>
            <TRCINGATEDTIME></TRCINGATEDTIME>
            <TRCINGATEDTIMEVAL></TRCINGATEDTIMEVAL>
        </TRACERESPONSE>
        <TRACERESPONSE>
            <TRCCONTAINER>TTTR0000001</TRCCONTAINER>
            <TRCCONTAINERNUMBER>TTTR0000001</TRCCONTAINERNUMBER>
            <TRCCONTAINER>TTTR0000001</TRCCONTAINER>
            <TRCDATETIME>SUCCESS</TRCDATETIME>
            <TRCSCRAPESITE>GREER</TRCSCRAPESITE>
            <TRCSCRAPEPAGE>qry</TRCSCRAPEPAGE>
            <TRCTRACEVER>1</TRCTRACEVER>
            <TRCTRACECLEAN>p-ss-greer-01.p</TRCTRACECLEAN>
            <TRCAVAILABLE>FALSE</TRCAVAILABLE>
            <TRCAVAILABLEVAL></TRCAVAILABLEVAL>
            <TRCSSLINE></TRCSSLINE>
            <TRCVESSEL></TRCVESSEL>
            <TRCVESSELATA></TRCVESSELATA>
            <TRCDISCHARGEDATE></TRCDISCHARGEDATE>
            <TRCDISCHARGEDATEVAL> </TRCDISCHARGEDATEVAL>
            <TRCDISCHARGETIME></TRCDISCHARGETIME>
            <TRCDISCHARGETIMEVAL> </TRCDISCHARGETIMEVAL>
            <TRCCONTAINERSTATUS></TRCCONTAINERSTATUS>
            <TRCCONTAINERSTATUSVAL></TRCCONTAINERSTATUSVAL>
            <TRCFREIGHTHOLDS>FALSE</TRCFREIGHTHOLDS>
            <TRCFREIGHTHOLDSVAL></TRCFREIGHTHOLDSVAL>
            <TRCOUTGATE></TRCOUTGATE>
            <TRCCNTRISO></TRCCNTRISO>
            <TRCRAILUNLOADDATE></TRCRAILUNLOADDATE>
            <TRCRAILUNLOADDATEVAL></TRCRAILUNLOADDATEVAL>
            <TRCRAILUNLOADTIME></TRCRAILUNLOADTIME>
            <TRCRAILUNLOADTIMEVAL></TRCRAILUNLOADTIMEVAL>
            <TRCEIRNUMBER></TRCEIRNUMBER>
            <TRCCARRIER></TRCCARRIER>
            <TRCCHASSISNUMBER></TRCCHASSISNUMBER>
            <TRCGENSET></TRCGENSET>
            <TRCCATEGORY></TRCCATEGORY>
            <TRCTRUCKERLICENSE></TRCTRUCKERLICENSE>
            <TRCTRUCKER></TRCTRUCKER>
            <TRCOUTGATED></TRCOUTGATED>
            <TRCOUTGATEDVAL></TRCOUTGATEDVAL>
            <TRCOUTGATEDDATE></TRCOUTGATEDDATE>
            <TRCOUTGATEDDATEVAL></TRCOUTGATEDDATEVAL>
            <TRCOUTGATEDTIME></TRCOUTGATEDTIME>
            <TRCOUTGATEDTIMEVAL></TRCOUTGATEDTIMEVAL>
            <TRCINGATED></TRCINGATED>
            <TRCINGATEDVAL></TRCINGATEDVAL>
            <TRCINGATEDDATE></TRCINGATEDDATE>
            <TRCINGATEDDATEVAL></TRCINGATEDDATEVAL>
            <TRCINGATEDTIME></TRCINGATEDTIME>
            <TRCINGATEDTIMEVAL></TRCINGATEDTIMEVAL>
        </TRACERESPONSE>
    </TRACEROOT>


Not found containers Response
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
If containers TTTR0000001 is given as not found container then API returns the next response.

..  code-block:: xml

    <TRACEROOT>
        <trace-acct-code>zsales600</trace-acct-code>
        <trace-site>GREER</trace-site>
        <trace-containers>TTTR0000001</trace-containers>
        <trace-error></trace-error>
        <trace-status></trace-status>
        <TRACERESPONSE>
            <TRCCONTAINER>TTTR0000001</TRCCONTAINER>
            <TRCCONTAINERNUMBER>TTTR0000001</TRCCONTAINERNUMBER>
            <TRCCONTAINER>TTTR0000001</TRCCONTAINER>
            <TRCDATETIME>SUCCESS</TRCDATETIME>
            <TRCSCRAPESITE>GREER</TRCSCRAPESITE>
            <TRCSCRAPEPAGE>qry</TRCSCRAPEPAGE>
            <TRCTRACEVER>1</TRCTRACEVER>
            <TRCTRACECLEAN>p-ss-greer-01.p</TRCTRACECLEAN>
            <TRCAVAILABLE>FALSE</TRCAVAILABLE>
            <TRCAVAILABLEVAL></TRCAVAILABLEVAL>
            <TRCSSLINE></TRCSSLINE>
            <TRCVESSEL></TRCVESSEL>
            <TRCVESSELATA></TRCVESSELATA>
            <TRCDISCHARGEDATE></TRCDISCHARGEDATE>
            <TRCDISCHARGEDATEVAL> </TRCDISCHARGEDATEVAL>
            <TRCDISCHARGETIME></TRCDISCHARGETIME>
            <TRCDISCHARGETIMEVAL> </TRCDISCHARGETIMEVAL>
            <TRCCONTAINERSTATUS></TRCCONTAINERSTATUS>
            <TRCCONTAINERSTATUSVAL></TRCCONTAINERSTATUSVAL>
            <TRCFREIGHTHOLDS>FALSE</TRCFREIGHTHOLDS>
            <TRCFREIGHTHOLDSVAL></TRCFREIGHTHOLDSVAL>
            <TRCOUTGATE></TRCOUTGATE>
            <TRCCNTRISO></TRCCNTRISO>
            <TRCRAILUNLOADDATE></TRCRAILUNLOADDATE>
            <TRCRAILUNLOADDATEVAL></TRCRAILUNLOADDATEVAL>
            <TRCRAILUNLOADTIME></TRCRAILUNLOADTIME>
            <TRCRAILUNLOADTIMEVAL></TRCRAILUNLOADTIMEVAL>
            <TRCEIRNUMBER></TRCEIRNUMBER>
            <TRCCARRIER></TRCCARRIER>
            <TRCCHASSISNUMBER></TRCCHASSISNUMBER>
            <TRCGENSET></TRCGENSET>
            <TRCCATEGORY></TRCCATEGORY>
            <TRCTRUCKERLICENSE></TRCTRUCKERLICENSE>
            <TRCTRUCKER></TRCTRUCKER>
            <TRCOUTGATED></TRCOUTGATED>
            <TRCOUTGATEDVAL></TRCOUTGATEDVAL>
            <TRCOUTGATEDDATE></TRCOUTGATEDDATE>
            <TRCOUTGATEDDATEVAL></TRCOUTGATEDDATEVAL>
            <TRCOUTGATEDTIME></TRCOUTGATEDTIME>
            <TRCOUTGATEDTIMEVAL></TRCOUTGATEDTIMEVAL>
            <TRCINGATED></TRCINGATED>
            <TRCINGATEDVAL></TRCINGATEDVAL>
            <TRCINGATEDDATE></TRCINGATEDDATE>
            <TRCINGATEDDATEVAL></TRCINGATEDDATEVAL>
            <TRCINGATEDTIME></TRCINGATEDTIME>
            <TRCINGATEDTIMEVAL></TRCINGATEDTIMEVAL>
        </TRACERESPONSE>
    </TRACEROOT>


:Data Mapping:

+------------------------+--------------------------------+----------------------------------------------------------------------+
| Property               | Source Property                | Description                                                          |
+========================+================================+======================================================================+
| containerNumber        | TRCCONTAINER                   | The container reference number                                       |
+------------------------+--------------------------------+----------------------------------------------------------------------+
| length                 | TRCCTRLENGTH                   | The container length                                                 |
+------------------------+--------------------------------+----------------------------------------------------------------------+
| loaded                 | TRCCONTAINERSTATUSVAL          | Determine if the container is loaded or empty                        |
+------------------------+--------------------------------+----------------------------------------------------------------------+
| pickupNumber           | TRCRELEASENUMBERVAL            | Represents the puckup number                                         |
+------------------------+--------------------------------+----------------------------------------------------------------------+
| carrier.steamshipLine  | TRCBILLOFLADING                | Carrier scac.                                                        |
+------------------------+--------------------------------+----------------------------------------------------------------------+
| carrier.vessel         | TRCVESSEL                      | Represents the carrier vessel                                        |
+------------------------+--------------------------------+----------------------------------------------------------------------+
| carrier.voyage         | TRCVOYAGE                      | Carrier voyage number                                                |
+------------------------+--------------------------------+----------------------------------------------------------------------+
| destination.name       | TRCDESTINATION                 | Represents the destination location                                  |
+------------------------+--------------------------------+----------------------------------------------------------------------+
|| destination.type      || Default                       || This is a static value represents where the                         |
||                       ||                               || event happens and it is set to 'terminal'.                          |
+------------------------+--------------------------------+----------------------------------------------------------------------+
| event[n].code          | TRCDISCHARGEDATEVAL            | Grounded event is created if TRCDISCHARGEDATEVAL has a value         |
+------------------------+--------------------------------+----------------------------------------------------------------------+
| event[n].lot           | TRCLASTMOVE                    | Represents the lot                                                   |
+------------------------+--------------------------------+----------------------------------------------------------------------+
| event[n].code          | TRCLSRFLFDTRCLASTFREEDATEDMVAL | Lfd event is created if TRCLSRFLFDTRCLASTFREEDATEDMVAL has a date    |
+------------------------+--------------------------------+----------------------------------------------------------------------+
| event[n].code          | TRCOUTGATEDDATEVAL             | Outgated event is created if TRCOUTGATEDDATEVAL has a value          |
+------------------------+--------------------------------+----------------------------------------------------------------------+
| event[n].data.holdType | TRCCUSTOMSHOLDSVAL             | Hold event is created with hold type as Customs Hold if it has value |
+------------------------+--------------------------------+----------------------------------------------------------------------+
| event[n].data.holdType | TRCFREIGHTHOLDSVAL             | Hold event is created with hold type as Freight Hold if it has value |
+------------------------+--------------------------------+----------------------------------------------------------------------+
| event[n].data.holdType | TRCUSDAHOLDSVAL                | Hold event is created with hold type as USDA Hold if it has value    |
+------------------------+--------------------------------+----------------------------------------------------------------------+
| event[n].date          | Default                        | Today date is a default date                                         |
+------------------------+--------------------------------+----------------------------------------------------------------------+
| event[n].location.name | TRCDESTINATION                 | Represents the location                                              |
+------------------------+--------------------------------+----------------------------------------------------------------------+
| event[n].location.type | Default                        | Default value is Terminal.                                           |
+------------------------+--------------------------------+----------------------------------------------------------------------+