I02C Despatch Advice Booking
- Status
-
1.0 current version published 07.02.2025
- Approval
- Comment
-
FLASH nutzt bereits eine CargoClix-Schnittstelle produktiv. Die folgende Beschreibung bezieht sich auf ein neu zu entwickelndes Schnittstellenformat.
1. Stakeholder
Role | Application | Responsible |
---|---|---|
Communication |
Integration Layer |
|
Leading App |
Inbound |
|
InterfaceOwner |
Inbound |
|
Producer |
CargoClix |
|
Consumer |
FLASH |
|
Consumer |
Oyster |
|
Consumer |
Yard |
|
Consumer |
Babelfish |
2. Business Context
CargoClix slot booking
3. Informationflow
4. Interface
Vorhandene Dokumentation
Technisch:
4.1. Direction Cargoclix to FINE
4.1.1. Header
This interface uses the Service Header
4.1.2. Datamodel
Property | Type | Description |
---|---|---|
(Root) |
object |
Despatch Advice Bookings |
eventId* |
string (uuid) |
The uniq eventId |
traceId* |
string (uuid) |
The uniq traceId |
spanId |
string (uuid) |
The uniq spanId |
eventTime* |
string (date-time) |
Time of occurrence of the event |
version* |
string |
The number of version schema Minimum Length: 3 |
context |
string |
The context / business case |
eventType* |
string (enum) |
The type of operation Any of: [
"INSERT",
"UPDATE",
"DELETE"
] |
metaData |
object |
|
sender |
string (enum) |
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"
] |
data* |
object |
|
bookId |
integer |
Id of the booking |
location* |
string (enum) |
warehouse locations 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"
] |
businessEventDateTime |
string (date-time) |
timestamp of business event |
creator |
object |
|
id |
integer |
Id of the booking creator |
companyId |
integer |
the creators company id |
companyName |
string |
the creators company name |
previous |
object |
|
arrivalSlotStartDateTime |
string (date-time) |
previous slot start time |
arrivalSlotEndDateTime |
string (date-time) |
previous slot end time |
arrivalSlotLengthMinutes |
integer |
previous slot length in minutes |
bookRampId |
integer |
Id of previous ramp |
arrivalSlotStartDateTime |
string (date-time) |
slot start time |
arrivalSlotCriticalStartDateTime |
string (date-time) |
slot critical start time |
arrivalSlotEndDateTime |
string (date-time) |
slot end time |
arrivalSlotLengthMinutes |
integer |
slot length in minutes |
bookRampId |
integer |
Id of the ramp |
bookingCompany |
object |
|
id |
integer |
Id of the booking company |
name |
string |
the booking company name |
storageNotification |
array |
StorageNotifications |
(Array item) |
object |
|
id |
string |
StorageNotificationId |
quantity |
integer |
quantity |
orderNumber |
array |
order numbers |
(Array item) |
string |
|
carrier |
string |
carrier |
productDescription |
string |
|
itemNumber |
array |
item numbers |
(Array item) |
string |
|
customerCompany |
array |
HF Customer from CargoClix |
(Array item) |
string |
|
leavingEuroPallets |
integer |
|
loadCarrier |
array |
|
(Array item) |
object |
|
id |
string |
load carrier ID (swap body number ID, container ID, license plate number of the truck, …) / ID des Ladungsträgers (Brückennummer, Containernummer, KFZ_Kennz. bei LKW, …) |
type |
string (enum) |
load carrier type / Typ des Ladungsträgers: LKW, Auflieger, WAB, Container, … Any of: [
"WAB",
"CT20",
"CT40",
"CT20HC",
"CT40HC",
"TRUCK",
"TRUCK_WITH_TRAILER",
"TRAILER",
"BUS",
"OTHER"
] |
sealNumber |
string |
seal number |
cancellationDescription |
string |
|
comment |
string |
|
deliveryMethodDescription |
string |
|
processingInformation |
array |
|
(Array item) |
object |
|
goodsReceiptProcessingType |
string |
Pallets/hatch detection |
quantity |
integer |
Quantity received for this processing type Minimum: 0 |
delivery |
array |
|
(Array item) |
object |
|
type |
string |
delivery type (new items single SKU boxes, returns, transfer) / Art der Anlieferung (Neuware SKU-rein, Retoure, Umfuhr) |
number |
string |
delivery number |
desiredDate |
string |
preferred delivery date by HG |
deviationAvisQuality |
string |
Avis quality |
deliveryNoteId |
array |
|
(Array item) |
string |
delivery note uuid |
supplier |
object |
|
name |
string |
supplier name |
code |
string |
supplier code |
numberOf |
object |
|
colliLoose |
integer |
|
colliPaletized |
integer |
|
hunte |
integer |
|
articles |
integer |
|
colli |
integer |
|
defectivePallets |
integer |
|
onewayPallets |
integer |
|
pallets |
integer |
|
pager |
object |
|
pagerNumber |
string |
pager number |
returned |
boolean |
pager returned by driver |
pagerNumber |
string |
pager number |
pagerReturn |
boolean |
pager returned by driver |
palleteNumber |
string |
|
processingTimeMinCalculated |
string |
calculated timee for umloading in minutes |
ProductTypeSelect |
string |
Sortimentsauswahl |
shipName |
string |
ship name |
shipmentNumber |
string |
shipment number |
slaRelevance |
boolean |
|
cancellationReason |
string |
|
transportId |
array |
|
(Array item) |
string |
transport uuid |
tourNumber |
array |
tour numbers |
(Array item) |
string |
|
wayBillNumber |
string |
|
driver |
object |
|
name |
string |
driver name |
phone |
string |
driver phone |
language |
string |
driver language |
isDeleted |
boolean |
booking is deleted |
isCancelled |
boolean |
booking is cancelled |
licensePlate |
object |
|
truck |
string |
truck license plate |
trailer |
string |
driver license plate |
4.1.3. Enumeration
4.1.4. Example
4.1.5. Schema
Version |
Number |
File |
Published on |
Changes |
coming version |
1.0 |
07.02.2025 |
new attribute customerCompany |
|
current version |
1.0 |
15.09.2023 |
senderSystem → sender: system.v7.schema.json, remove carrierCountryIso , ship {name, number} → shipName, shipmentNumber, sealNumber → move to loadCarrier {id, type, sealNumber}, deliveryNoteId → array, transportId → array, wayBillNumber integer→string |