Versiones comparadas

Version Versión anterior 21 Nueva versión 22
Cambios realizados por

Luisa Kempf

Francisco Blanquer Jaraiz

Guardado el

Clave

  • Se ha añadido esta línea.
  • Se ha eliminado esta línea.
  • El formato se ha cambiado.

CONCEPT

Fields

Type

Description

Purpose

ID (Concept identifier)

M

dwell

GRAMMAR

Concept name

M

Dwell

GRAMMAR

Concept type

M

status

GRAMMAR

Also known as

O

Cargo at terminal, cargo stay.

TIC Description

Definition

M

The cargo visit dwell concept represents that the cargo is actually visiting a terminal. The status of the concept is “true”, between the moment the cargo is identified during the incoming of the cargo (check-in) and the moment of confirmation of the cargo’s departure (check-out).

TIC Description

Further Detail

O

This definition only applies to non-divisible cargo where the “subject” (cargo) id doesn't change during the “cargovisit”. Future releases will address divisible cargo .cargovisit is the processthat will consider the way to split cargo and track the dwell of a “piece of cargo”.

tos.cargovisit.dwell is the concept of the process the process (what status has the cargovisit) that defines if the cargo is formaly (not phisically) inside the terminal. It is consider that is formaly inside the terminal = between check-in and check-out (verification by the terminal of the cargo id).

tos.cargovisit.dwell.status is true at the timestamp (observation time) if the cargo is inside the terminal (after check-in and before check-out: status = true)

tos.cargovisit.dwell.duration is represent how often long the dwell.status = is “true” without any interruption . The value of the resolution (frequency determines the length of the duration checkbefore the timestamp. So it represents that the cargo has been into the terminal for an uninterrupted duration (the value) time before the timestamp (the reference time). The resolution of the duration (usually the duration has a fix frequency that determines how long it is) is up to the implementation and defines the resolution of the data (example is in the example is fix value of 4 hours).

tos.cargovisit.dwell.timer is the aggregation of the duration during a period of time (observation period). Please review https://tic40.atlassian.net/wiki/spaces/TIC40Definitions/pages/8618041/TIC4.0+Semantic#duration-vs-timer.

tos.cargovisit.dwell.totaltimer timer is the aggregation of the duration since the check-in until check-outthe timestamp (observed time).

Cargovisit “age” is obtained from: totaltimer value when “dwell.status = true”

Cargovisit “dwelltime” is obtained from: totaltimer value when “dwell.status = false”

View file
nameDwell time V4.pptx

Cargovisit is the process dwell usually refers to. At the moment of this release 2022.004 it is not consider another subject but in future releases could be consider others like carriervisit, visitor, etc that could stay in the terminal during a visit.

TIC Description

Required Information

M

SUBJECT; OBSERVED PROPERTY and VALUE

TIC Description

SUBJECT

M

service, servcevisit, cargo, carrier, carriervisit

GRAMMAR

POINT OF MEASUREMENT

O

pom: input, output

pomt: actual, planned, estimated

GRAMMAR

OBSERVED PROPERTY

M

status;counter; duration; timer; totaltimer; age; dwelltime

GRAMMAR

Value

M

type = operational/safety/component

GRAMMAR

Related standards

O

TIC Description

Related TIC 4.0 definition

O

https://tic40.atlassian.net/l/c/j8R6vVZFInbound (Review) Check-in (Review) Check-out (Review) Outbound (Review) Announcement

TIC Description

Example

M

Cargo check-in 01/12/2021 00:00:00

Container check-out 02/02/2022 00:00:00

from 01/01/2022 00:00 to 02/01/2022 00:00

tos.cargovisit.dwell.status = true (always)

tos.cargovisit.dwell.timer = 1 day TEU*days or box*day

01/01/2022 00:00 tos.cargovisit.dwell.totaltimer = 31 days

from 01/02/2022 00:00 to 05/02/2022 00:00

tos.cargovisit.dwell.timer = 1 day

01/02/2022 00:00-23:59:59 tos.cargovisit.dwell.status = true

02-05/02/2022 tos.cargovisit.dwell.status = false

01/02/2022 00:00:00 tos.cargovisit.dwell.totaltimer = 62 days

06/02/2022 00:00:00 tos.cargovisit.dwell.totaltimer = 63 days

tos.cargovisit.id = 3453454

tos.cargovisit.cargo.id = CSQU3054383

tos.cargovisit.inbound.modality: vessel

tos.cargovisit.checkin.time : 2021-12-10T16:05:34.491Z

tos.cargovisit.dwell.totaltimer.seconds : 86400

tos.cargovisit.checkout.time : 2021-12-11T16:05:34.491Z

tos.cargovisit.outbound.modality: truck

TIC Description

Example in the context of the grammar

M

The data model of cargo visit contains the major events and status of the cargo during the terminal visit.

Bloque de código
languagejson
{
  "tos": [
    {
      "id": "120SUPERCURRO2021",
      "name": "TOS",
      "cargovisit": [
        {
          "id": "",
          "cargoflowtype": "domestic/import/export/transhipment/unknown",
          "cargo": {
            "timestamp": "2021-12-10T16:05:34.491Z",
            "id": "ISO 6346/splitable_cargo_id?"
          },
          "size": {
            "code": "",
            "description": "",
            "box": 1,
            "teu": 2,
            "20foot": 0,
            "30foot": 0,
            "40foot": 1,
            "45foot": 0
          },
          "weight": {
            "gross": [
              {
                "pom": "output",
                "pomt": "actual",
                "timestamp": "",
                "unit": "ton",
                "value": 0
              }
            ],
            "net": [
              {
                "pom": "output",
                "pomt": "actual",
                "timestamp": "",
                "unit": "ton",
                "value": 0
              }
            ]
          },
          "inbound": {
            "modality": "vessel/truck/train/barge/interterminaltransfer/unknown",
            "time": [
              {
                "pom": "output",
                "pomt": "actual",
                "timestamp": "2021-12-10T16:05:34.491Z"
              },
              {
                "pom": "output",
                "pomt": "estimated",
                "computingtime": "",
                "forecasttime": "",
                "timestamp": "2021-12-10T16:05:34.491Z"
              }
            ],
            "logical": [
              {
                "pom": "ioutput",
                "pomt": "actual",
                "timestamp": "2021-12-10T16:05:34.491Z",
                "qualifier": "berth",
                "name": "",
                "value": "B 2",
                "berthing": "2"
              }
            ],
            "coordinate": [
              {
                "pom": "ioutput",
                "pomt": "actual",
                "qualifier": "WGS84",
                "timestamp": "2021-12-10T16:05:34.491Z",
                "value": [
                  4012.22,
                  -7500.25
                ],
                "status": true,
                "accuracy": "12.0"
              }
            ],
            "carrier": [
              {
                "timestamp": "2021-12-10T16:05:34.491Z",
                "id": ""
              }
            ],
            "carriervisit": {
              "timestamp": "2021-12-10T16:05:34.492Z",
              "id": ""
            },
            "service": [
              {
                "code": "",
                "description": "",
                "timestamp": "2021-12-10T16:05:34.492Z"
              }
            ],
            "servicevisit": [
              {
                "timestamp": "2021-12-10T16:05:34.492Z",
                "id": ""
              }
            ]
          },
          "checkin": {
            "time": [
              {
                "pom": "output",
                "pomt": "actual",
                "timestamp": "2021-12-10T16:05:34.492Z"
              },
              {
                "pom": "output",
                "pomt": "estimated",
                "computingtime": "",
                "forecasttime": "",
                "timestamp": "2021-12-10T16:05:34.492Z"
              }
            ],
            "logical": [
              {
                "pom": "ioutput",
                "pomt": "actual",
                "timestamp": "2021-12-10T16:05:34.492Z",
                "qualifier": "berth",
                "name": "",
                "value": "B 2",
                "berthing": "2"
              }
            ],
            "coordinate": [
              {
                "pom": "ioutput",
                "pomt": "actual",
                "qualifier": "WGS84",
                "timestamp": "2021-12-10T16:05:34.492Z",
                "value": [
                  4012.22,
                  -7500.25
                ],
                "status": true,
                "accuracy": "12.0"
              }
            ]
          },
          "dwell": {
            "status": [
              {
                "pom": "ioutput",
                "pomt": "actual",
                "timestamp": "2021-12-10T16:05:34.492Z",
                "value": false
              }
            ],
            "duration": [
              {
                "pom": "ioutput",
                "pomt": "actual",
                "unit": "second",
                "timestamp": "2021-12-10T16:05:34.492Z",
                "value": 0
              }
            ],
            "counter": [
              {
                "pom": "ioutput",
                "pomt": "actual",
                "timestamp": "2021-12-10T16:05:34.492Z",
                "value": 0,
                "starttimestamp": "2021-12-10T16:05:34.492Z",
                "endtimestamp": "2021-12-10T16:05:34.492Z"
              }
            ],
            "totalcounter": [
              {
                "pom": "ioutput",
                "pomt": "actual",
                "timestamp": "2021-12-10T16:05:34.492Z",
                "value": 0
              }
            ],
            "timer": [
              {
                "pom": "ioutput",
                "pomt": "actual",
                "unit": "second",
                "timestamp": "2021-12-10T16:05:34.492Z",
                "value": 0,
                "starttimestamp": "2021-12-10T16:05:34.492Z",
                "endtimestamp": "2021-12-10T16:05:34.492Z"
              }
            ],
            "totaltimer": [
              {
                "pom": "ioutput",
                "pomt": "actual",
                "unit": "hour",
                "timestamp": "2021-12-10T16:05:34.492Z",
                "value": 0
              }
            ],
            "logical": [
              {
                "pom": "ioutput",
                "pomt": "actual",
                "qualifier": "yard",
                "timestamp": "2021-12-10T16:05:34.492Z",
                "value": "Y 01A 035 B 3",
                "status": true,
                "block": "01A",
                "row": "035",
                "bay": "B",
                "tier": "3"
              }
            ],
            "coordinate": [
              {
                "pom": "output",
                "pomt": "actual",
                "qualifier": "WGS84",
                "timestamp": "2021-12-10T16:05:34.492Z",
                "value": [
                  4012.45,
                  -7500.15
                ],
                "status": true,
                "accuracy": "1.5"
              }
            ]
          },
          "checkout": {
            "time": [
              {
                "pom": "output",
                "pomt": "actual",
                "timestamp": "2021-12-10T16:05:34.492Z"
              },
              {
                "pom": "output",
                "pomt": "estimated",
                "computingtime": "",
                "forecasttime": "",
                "timestamp": "2021-12-10T16:05:34.492Z"
              }
            ],
            "logical": [
              {
                "pom": "ioutput",
                "pomt": "actual",
                "timestamp": "2021-12-10T16:05:34.492Z",
                "qualifier": "berth",
                "name": "",
                "value": "B 2",
                "berthing": "2"
              }
            ],
            "coordinate": [
              {
                "pom": "ioutput",
                "pomt": "actual",
                "qualifier": "WGS84",
                "timestamp": "2021-12-10T16:05:34.492Z",
                "value": [
                  4012.22,
                  -7500.25
                ],
                "status": true,
                "accuracy": "12.0"
              }
            ]
          },
          "outbound": {
            "modality": "vessel/truck/train/barge/interterminaltransfer/unknown",
            "time": [
              {
                "pom": "output",
                "pomt": "actual",
                "timestamp": "2021-12-10T16:05:34.492Z"
              },
              {
                "pom": "output",
                "pomt": "estimated",
                "computingtime": "",
                "forecasttime": "",
                "timestamp": "2021-12-10T16:05:34.492Z"
              }
            ],
            "location": {
              "logical": [
                {
                  "pom": "ioutput",
                  "pomt": "actual",
                  "timestamp": "2021-12-10T16:05:34.492Z",
                  "qualifier": "berth",
                  "name": "",
                  "value": "B 2",
                  "berthing": "2"
                }
              ],
              "coordinate": [
                {
                  "pom": "ioutput",
                  "pomt": "actual",
                  "qualifier": "WGS84",
                  "timestamp": "2021-12-10T16:05:34.492Z",
                  "value": [
                    4012.22,
                    -7500.25
                  ],
                  "status": true,
                  "accuracy": "12.0"
                }
              ]
            },
            "carrier": [
              {
                "timestamp": "2021-12-10T16:05:34.492Z",
                "id": ""
              }
            ],
            "carriervisit": {
              "timestamp": "2021-12-10T16:05:34.492Z",
              "id": ""
            },
            "service": [
              {
                "code": "",
                "description": "",
                "timestamp": "2021-12-10T16:05:34.492Z"
              }
            ],
            "servicevisit": [
              {
                "timestamp": "2021-12-10T16:05:34.492Z",
                "id": ""
              }
            ]
          }
        }
      ]
    }
  ]
}

TIC Description

Link to one or more operational processes

M

TIC Description

Search tags

M

#alarm; #error; #fault

Technical

Version / Date

M

2021.004 - 15/03/2022

Technical

Internal TIC Version

M

2021310

Technical

...