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. Future releases will address divisible cargo. cargovisit is the process. tos.cargovisit.dwell is the concept of the process that defines if the cargo is inside the terminal = between check-in and check-out. 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 how often the status = “true” without interruption. The value of the resolution (frequency determines the length of the duration check) is up to the implementation and defines the resolution of the data (example is 4 hours). tos.cargovisit.dwell.timer is the aggregation of the duration during a period of time (observation period). tos.cargovisit.dwell.totaltimer is the aggregation of the duration since the check-in until check-out Cargovisit “age” is obtained from: totaltimer value when “dwell.status = true” Cargovisit “dwelltime” is obtained from: totaltimer value when “dwell.status = false” 
| 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. {
"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 |
M = Mandatory
O = Optional
Created by | Edited by | Review / Approve | Published |
Francisco Blanquer Jaraiz 2021-12-10 |
|
|
|
|
|
| |