{
"eventId": "00ce536f-923a-42f4-8128-be118faf1d87",
"traceId": "00ce536f-923a-42f4-8128-be118faf1d85",
"eventTime": "2023-02-15T13:55:00+01:00",
"eventType": "YARD_CONTAINER_INVENTORY",
"version": "1.0",
"context": "YARD",
"sender": "YMS_KMOTION",
"data": {
"yard": "ILOWA",
"location": "ILOWA",
"recipient": "HERIS",
"containerList": [
{
"loadCarrierId": "905603311",
"loadCarrierIsDefective": false,
"yardTransactionType": "WAB",
"deliveryType": "UMF_KOLLI"
},
{
"loadCarrierId": "905603312",
"loadCarrierIsDefective": false,
"yardTransactionType": "BRLEER",
"deliveryType": "LEER"
},
{
"loadCarrierId": "905603313",
"loadCarrierIsDefective": false,
"yardTransactionType": "WAKB"
},
{
"loadCarrierId": "905603314",
"loadCarrierIsDefective": true,
"yardTransactionType": "BRLEER",
"deliveryType": "LEER"
},
{
"loadCarrierId": "905603315",
"loadCarrierIsDefective": false,
"yardTransactionType": "WAUB",
"deliveryType": "LHM"
},
{
"loadCarrierId": "905603316",
"loadCarrierIsDefective": false,
"yardTransactionType": "WAUB",
"deliveryType": "RET_MW"
},
{
"loadCarrierId": "905603317",
"loadCarrierIsDefective": false,
"yardTransactionType": "WAKUB",
"deliveryType": "RET_MW"
}
]
}
}
Y03 Yard Container Inventory
- Status
-
v1.0, 31.07.2024
1. Stakeholder
Role | Application | Responsible |
---|---|---|
Communication |
Integration Layer |
|
Leading App |
Yard |
|
InterfaceOwner |
OSP |
|
Producer |
YMS Körber |
Körber |
Consumer |
HERIS |
Hermes Germany |
Consumer |
Flash |
2. Business Context
A Snapshot of available containers located in a yard will be provided per receiver.
3. Informationflow
Partner | Direction | FINE-Service | Topic/API | Description | Status |
---|---|---|---|---|---|
YMS:Körber-YMS |
send |
Yard |
https |
YardContainerInventory |
productive |
Hermes-Germany:HERIS |
receive |
Yard |
https with XML |
yardReportContainerInventoryRequest |
productive |
FINE:Flash |
receive |
Yard |
yard.inventory.out |
YardContainerInventory |
productive |
4. Interface
4.1. Direction YMS Körber to FINE
4.1.1. Datamodel
Property | Type | Description |
---|---|---|
(Root) |
object |
Interface for reporting Yard Container Inventory |
eventId* |
string (uuid) |
The uniq eventId |
traceId* |
string (uuid) |
The uniq traceId Maximum Length: 36 |
spanId |
string (uuid) |
The uniq spanId Maximum Length: 36 |
eventTime* |
string (date-time) |
Time of occurrence of the event |
version* |
The number of version schema |
|
context |
string |
The context / business case Maximum Length: 25 |
eventType* |
string (enum) |
The concrete type = kind of record(event) Any of: [
"YARD_CONTAINER_INVENTORY"
] |
metaData |
object |
|
sender |
string (enum) |
The name of sender/producer Any of: [
"KR1_SHF",
"KR1_HHSTR",
"WMSX_SON",
"WMSX_AKU",
"KMOTION_ILO",
"KMOTION_GHM",
"COBRA",
"LSAS",
"IDEEFIX",
"OBS",
"RESY",
"LDH",
"RETAILSCHICHT",
"BUBE",
"FINE_INBOUND",
"F2X",
"WMSX_WEISMAIN",
"LIGIS",
"KR1_MANDANT",
"YMS_KMOTION",
"YMS_INCONSO",
"HERIS",
"CARGOCLIX"
] |
instance |
string |
SW-Instance of the producing system Maximum Length: 50 |
client |
string |
Client / Tenant Maximum Length: 50 |
messageNumber |
integer |
Current meassage number Minimum: 1 |
messageCount |
integer |
Overall message count Minimum: 1 |
data* |
object |
|
yard* |
string |
Yard for wich the Inventory is provided Maximum Length: 50 |
location |
string (enum) |
location managed by the Yard system Any of: [
"ANSBACH",
"LOEHNE",
"LANGENSELBOLD",
"MOSINA",
"OHRDRUF",
"HALDENSLEBEN",
"HALDENSLEBEN_RT",
"SUEDHAFEN",
"SONNEFELD",
"ALTENKUNSTADT",
"WEIDEN",
"KRACANY",
"ILOWA",
"ILOWA_RT",
"ILOWA_RSS",
"GERNSHEIM",
"ERFURT",
"HAMBURG_RT",
"OTELFINGEN_RT",
"KRIMICE_RT",
"STAHLAVY_RT",
"OHRDRUF_RT",
"LOEHNE_RT",
"LANGENSELBOLD_RT",
"LODZ_1_RT",
"LODZ_2_RT",
"BERGHEIM_RT",
"ALTENKUNSTADT_RT",
"LISTERHILLS_RT",
"SUEDHAFEN_RT",
"PILSEN_RT",
"HAMBURG_SC",
"LOEHNE_SC",
"SCHWABHAUSEN_SC",
"HALDENSLEBEN_RSS",
"ALTENKUNSTADT_RSS",
"LOEHNE_RSS",
"OHRDRUF_RSS",
"LANGENSELBOLD_RSS",
"LOEHNE_CP"
] |
recipient* |
string (enum) |
receiver system Any of: [
"KR1_SHF",
"KR1_HHSTR",
"WMSX_SON",
"WMSX_AKU",
"KMOTION_ILO",
"KMOTION_GHM",
"COBRA",
"LSAS",
"IDEEFIX",
"OBS",
"RESY",
"LDH",
"RETAILSCHICHT",
"BUBE",
"FINE_INBOUND",
"F2X",
"WMSX_WEISMAIN",
"LIGIS",
"KR1_MANDANT",
"YMS_KMOTION",
"YMS_INCONSO",
"HERIS",
"CARGOCLIX",
"KMOTION_ERFURT",
"LOGISTIKPUFFER"
] |
containerList* |
array |
container list |
(Array item) |
object |
|
loadCarrierId* |
string |
Load carrier ID Maximum Length: 50 |
loadCarrierIsDefective |
boolean |
Load carrier defective flag |
yardTransactionType |
string |
YMS Transaction Type Maximum Length: 25 |
deliveryType |
string |
Delivery Type Maximum Length: 25 |
4.1.2. Example
4.1.3. Schema
Version | Number | File | Published on | Changes |
---|---|---|---|---|
current version |
1.0 |
30.11.2023 |
location, additionalInfo added, delayCategory optional |
|
previous version |
0.1 |
28.09.2023 |
draft |
|
coming version |
4.2. Direction FINE to HG - yardReportContainerInventoryRequest
Körber YMS data will be mappedand transferred to HG as yardReportContainerInventoryRequest.
4.2.1. Schema
HG is responsible for the described schema. It is mentioned here for reference only.
Version | Number | File | Published on | Changes |
---|---|---|---|---|
current version |
2.0 |
20.09.2023 |
initial version |
|
previous version |
||||
coming version |
4.2.2. Examples
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<yardReportContainerInventoryRequest xmlns="http://hlg.de/tl/yard-inbound-2.0">
<inventoryReport>
<containerIdentifier>905603311</containerIdentifier>
<locationMatchCode>HUBILOWPL</locationMatchCode>
<containerStatus>Vorlader</containerStatus>
<comment/>
</inventoryReport>
<inventoryReport>
<containerIdentifier>905603312</containerIdentifier>
<locationMatchCode>OTTOILOWPL</locationMatchCode>
<containerStatus>Leer</containerStatus>
<comment/>
</inventoryReport>
<inventoryReport>
<containerIdentifier>905603313</containerIdentifier>
<locationMatchCode>OTTOILOWPL</locationMatchCode>
<containerStatus>Überhänge</containerStatus>
<comment/>
</inventoryReport>
<!-- ... -->
</yardReportContainerInventoryRequest>