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  |