This is the multi-page printable view of this section. Click here to print.
Inbound/QS
- 1:
 - 2:
 - 3:
 - 4:
 - 5:
 - 6:
 - 7:
 - 8:
 - 9:
 - 10:
 - 11:
 - 12:
 - 13:
 - 14:
 - 15:
 - 16:
 - 17:
 - 18:
 - 19: I01 Storage Notification
 - 20: I02A Despatch Advice Ramp
 - 21: I02B Despatch Advice Ramp Process
 - 22: I02C Despatch Advice Booking
 - 23: I02D Despatch Advice Process State
 - 24: I03 Delivery Note
 - 25: I04 Goods In
 - 26: I05 Quality Sample Request
 - 27: I06 Quality Sample Response
 - 28: I07 Quality Result
 - 29: I08 Package List Ready for QS
 - 30: I09 Package Status after QS
 - 31: I10 Planned reworks (Deprecated)
 - 32: I13 Planned and Unplanned Reworks
 - 33: I15 Executed rework steps
 - 34: I19 Stock Transfer
 - 35: I22 Returns Booking
 - 36: I23 Transport Damages
 
1 -
1.1 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
|
eventId*  | 
string (uuid)  | 
UUID for this event  Minimum Length:  36  | 
traceId*  | 
string (uuid)  | 
UUID for all events in a call hierarchy It's like a order number, the will used for alle activities around the order.  Minimum Length:  36  | 
spanId*  | 
string (uuid)  | 
UUID for all events in a call hierarchy  Minimum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
eventTime*  | 
string (date-time)  | 
Event time  | 
context*  | 
string  | 
The name of the responsible context  Maximum Length:  20  | 
type*  | 
string  | 
Type  | 
sender*  | 
string  | 
Sender  | 
sourceIdentifier*  | 
string  | 
SourceIdentifier  | 
instance  | 
string  | 
Instance  | 
data*  | 
object  | 
|
storageNotificationId*  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
storageNotificationNo*  | 
string  | 
Storage Notification Number  | 
created*  | 
string (date-time)  | 
Created Date  | 
updated*  | 
string (date-time)  | 
Updated Time  | 
partnerId*  | 
string  | 
Partner Id  | 
purchaseOrder*  | 
object  | 
|
orderUUID*  | 
string  | 
Order UUID  | 
orderPositionUUID*  | 
string  | 
Order Position UUID  | 
orderNo*  | 
string  | 
Order Number  | 
location*  | 
string  | 
Storage Location  | 
sourceLocation  | 
string  | 
Source/Original location  Maximum Length:  15  | 
handlingType*  | 
string  | 
Handling Type  | 
supplyLocationCode*  | 
string  | 
Supply Location Code  | 
deliveryDate*  | 
string (date)  | 
Delivery Date  Maximum Length:  10  | 
forecastedWarehouseArrivalDate  | 
string (date)  | 
Forecasted Warehouse Arrival Date  Maximum Length:  10  | 
forecastedBufferedStorageDate  | 
string (date)  | 
Forecasted Buffered Storage Date  Maximum Length:  10  | 
foreignDemandQty  | 
string  | 
Foreign Demand Quantity  | 
planningPeriodCode*  | 
string  | 
Planning Period Code  | 
supplierNo*  | 
string  | 
Supplier Number  | 
orderQty*  | 
number  | 
Order Quantity  | 
fullyDelivered  | 
boolean  | 
Fully delivered  | 
noFurtherStockReceiptsExpected  | 
boolean  | 
No further stock receipts expected  | 
productIdentifier*  | 
object  | 
|
erpProductId*  | 
string  | 
¨Erp Product Id  Maximum Length:  36  | 
FNSKU  | 
string  | 
FNSKU  | 
sku*  | 
string  | 
¨Sku  Maximum Length:  36  | 
itemNo*  | 
string  | 
Item Number  Maximum Length:  16  | 
itemSize*  | 
string  | 
Item Size  Maximum Length:  16  | 
1.2 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
|
eventId*  | 
string (uuid)  | 
UUID for this event  Minimum Length:  36  | 
traceId*  | 
string (uuid)  | 
UUID for all events in a call hierarchy It's like a order number, the will used for alle activities around the order.  Minimum Length:  36  | 
spanId*  | 
string (uuid)  | 
UUID for all events in a call hierarchy  Minimum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
eventTime*  | 
string (date-time)  | 
Event time  | 
context*  | 
string  | 
The name of the responsible context  Maximum Length:  20  | 
type*  | 
string  | 
Type  | 
sender*  | 
string  | 
Sender  | 
sourceIdentifier*  | 
string  | 
SourceIdentifier  | 
instance  | 
string  | 
Instance  | 
data*  | 
object  | 
|
storageNotificationId*  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
storageNotificationNo*  | 
string  | 
Storage Notification Number  | 
createDate*  | 
string (date-time)  | 
Created Date  | 
modifyDate  | 
string (date-time)  | 
Modify Date  | 
partnerId*  | 
string  | 
Partner Id  | 
location*  | 
string  | 
Storage Location  | 
sourceLocation  | 
string  | 
Source/Original location  Maximum Length:  15  | 
purchaseOrder*  | 
object  | 
|
orderUUID*  | 
string  | 
Order UUID  | 
orderPositionUUID*  | 
string  | 
Order Position UUID  | 
orderNumber*  | 
string  | 
Order Number  | 
handlingType*  | 
string  | 
Handling Type  | 
supplyLocationCode*  | 
string  | 
Supply Location Code  | 
deliveryDate*  | 
string (date)  | 
Delivery Date  Maximum Length:  10  | 
forecastedWarehouseArrivalDate  | 
string (date)  | 
Forecasted Warehouse Arrival Date  Maximum Length:  10  | 
forecastedBufferedStorageDate  | 
string (date)  | 
Forecasted Buffered Storage Date  Maximum Length:  10  | 
foreignDemandQty  | 
string  | 
Foreign Demand Quantity  | 
planningPeriodCode*  | 
string  | 
Planning Period Code  | 
supplierNumber*  | 
string  | 
Supplier Number  | 
quantity*  | 
number  | 
Order Quantity  | 
fullyDelivered  | 
boolean  | 
Fully delivered  | 
noFurtherStockReceiptsExpected  | 
boolean  | 
No further stock receipts expected  | 
ownerCompany  | 
string  | 
Owner Company (BDF)  Maximum Length:  30  | 
product*  | 
object  | 
|
logisticProductId*  | 
string  | 
¨Logistic Product Id  Maximum Length:  30  | 
erpProductId*  | 
string  | 
¨Erp Product Id  Maximum Length:  36  | 
FNSKU  | 
string  | 
FNSKU  | 
sku*  | 
string  | 
¨Sku  Maximum Length:  36  | 
itemNumber*  | 
string  | 
Item Number  Maximum Length:  16  | 
itemSize*  | 
string  | 
Item Size  Maximum Length:  16  | 
2 -
2.1 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
Despatch Advice Ramps  | 
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  | 
|
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  | 
bookRampId*  | 
integer  | 
Id of the ramp  | 
rampName*  | 
string  | 
Name of the ramp  | 
rampType  | 
string  | 
Type of the ramp  | 
groupName  | 
string  | 
Ramp group name  | 
rampProcessStateCount*  | 
integer  | 
Number of available process states for a ramp  | 
defaultWeekFreeMinutes  | 
integer  | 
|
active*  | 
boolean  | 
Is the ramp active  | 
3 -
3.1 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
Despatch Advice Ramp Process  | 
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  | 
|
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  | 
bookRampId  | 
integer  | 
Id of the ramp  | 
arrivalSlotStartDateTime  | 
string (date-time)  | 
|
dailyStartTime  | 
string (time)  | 
|
dailyCloseTime  | 
string (time)  | 
|
dailyOpenMinutes  | 
integer  | 
|
dailyCapacityLimitMinutes  | 
integer  | 
|
dailyCapacityLimitKolli  | 
integer  | 
|
bookedMinutes  | 
integer  | 
|
manuallyClosedMinutes  | 
integer  | 
|
manuallyOpenMinutes  | 
integer  | 
|
previous  | 
object  | 
|
arrivalSlotStartDateTime  | 
string (date-time)  | 
|
bookedMinutes  | 
integer  | 
|
manuallyClosedMinutes  | 
integer  | 
|
manuallyOpenMinutes  | 
integer  | 
4 -
4.1 -
| 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  | 
5 -
6 -
6.1 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
ElectronicDeliveryNoteErp  | 
eventId*  | 
string  | 
The uniqe eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "GOODSIN_SUPPLIER",
  "GOODSIN_DLW"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "CREATE",
  "UPDATE",
  "DELETE"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string (enum)  | 
sender  Any of:  [
  "BUBE",
  "COBRA",
  "CORE",
  "FINE_INBOUND",
  "IDEEFIX",
  "KMOTION_ILOWA",
  "KMOTION_GERNSHEIM",
  "KR1_SUEDHAFEN",
  "KR1_HALDENSLEBEN",
  "KR1_HAMBURGERSTRASSE",
  "LDH",
  "LIGIS",
  "LSAS",
  "OBS",
  "RESY",
  "RETAILSCHICHT",
  "WMSX_AKU",
  "WMSX_SONNEFELD",
  "WMSX_WEISMAIN",
  "F2X"
]  | 
data*  | 
object  | 
|
location*  | 
string (enum)  | 
The target warehouse  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",
  "NORD_LOGISTIC"
]  | 
deliveryNoteId*  | 
string  | 
Delivery note id  Maximum Length:  36  | 
deliveryNoteNumber*  | 
string  | 
Delivery note number  Maximum Length:  36  | 
totalContainerQuantity  | 
integer  | 
Total container quantity  Maximum Length:  4  | 
createdTime*  | 
string (date-time)  | 
Created time  | 
updatedTime*  | 
string (date-time)  | 
Updated time  | 
plannedDeliveryTime  | 
string (date-time)  | 
Planned delivery time  | 
freightForwarder  | 
string  | 
Carrier forwarding  Maximum Length:  50  | 
origin  | 
string  | 
Origin/source of the data. Possible values are: SLOT_BOOKING, EDI, EDI_SUPPLYX, DLW_EDI, DLW_DIVA  Maximum Length:  50  | 
positions*  | 
array  | 
Positionen  Minimum number of items  1  | 
(Array item)  | 
object  | 
|
deliveryNotePositionId*  | 
string  | 
Delivery note position id  Maximum Length:  36  | 
erpProductId*  | 
string  | 
ERP Product Id  Maximum Length:  36  | 
quantity*  | 
number  | 
Quantity  | 
supplierNumber*  | 
integer  | 
Supplier number  Maximum Length:  6  | 
erpSupplierId*  | 
string  | 
ERP Supplier Id  Maximum Length:  36  | 
orderNumber*  | 
integer  | 
Order number  Maximum Length:  11  | 
storageNotificationId  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
sscc  | 
string  | 
Serial shipping contaner code  Maximum Length:  18  | 
handlingType  | 
string (enum)  | 
Delivery type code  Any of:  [
  "OSS",
  "WHS",
  "WHL"
]  | 
customsProcedure  | 
string (enum)  | 
Customs procedure  Any of:  [
  "CUSTOMS_WAREHOUSE_GOODS",
  "FREE"
]  | 
industrialDay  | 
integer  | 
Industrial day  Maximum Length:  3  | 
parts  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
partNumber*  | 
integer  | 
Part number  Maximum Length:  2  | 
barcode*  | 
string  | 
Barcode  Maximum Length:  36  | 
6.2 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
DeliveryNote  | 
eventId*  | 
string (uuid)  | 
UUID for this event  Minimum Length:  36  | 
traceId*  | 
string (uuid)  | 
UUID for all events in a call hierarchy  Minimum Length:  36  | 
spanId*  | 
string (uuid)  | 
UUID for all events in a call hierarchy  Minimum Length:  36  | 
eventTime*  | 
string (date-time)  | 
the date and time, when this event occured as an ISO-8601 timestamp.  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context*  | 
string  | 
The name of the responsible context  Maximum Length:  20  | 
type*  | 
string  | 
the event type that triggers this event  Maximum Length:  20  | 
sender*  | 
string  | 
The sending system  Maximum Length:  20  | 
sourceIdentifier*  | 
string  | 
SourceIdentifier  | 
data*  | 
object  | 
|
deliveryNoteId*  | 
string  | 
deliveryNoteId  Maximum Length:  36  | 
deliveryNoteNumber*  | 
string  | 
Die Belegnummer des Lieferscheins  Maximum Length:  36  | 
deliveryNoteStatus*  | 
string  | 
deliveryNoteStatus  Maximum Length:  10  | 
location*  | 
string  | 
Electronic delivery Location  | 
createDate*  | 
string (date-time)  | 
createDate  | 
modifyDate*  | 
string (date-time)  | 
modifyDate  | 
shippingDate*  | 
string (date-time)  | 
shippingDate  | 
plannedDeliveryDate  | 
string (date-time)  | 
plannedDeliveryDate  | 
totalCartonQty*  | 
integer  | 
totalCartonQty  Maximum Length:  4  | 
collectionAddress  | 
string  | 
collectionAddress  Maximum Length:  35  | 
package  | 
object  | 
|
weight  | 
object  | 
weight  | 
value*  | 
number  | 
|
unit*  | 
string  | 
|
volume  | 
object  | 
volume  | 
value*  | 
number  | 
|
unit*  | 
string  | 
|
carrierForwarding  | 
string  | 
carrierForwarding  Maximum Length:  35  | 
positions*  | 
array  | 
Positions  Minimum number of items  1  | 
(Array item)  | 
object  | 
|
deliveryNotePositionId*  | 
string  | 
deliveryNotePositionId  Maximum Length:  36  | 
deliveryNotePositionStatus*  | 
string  | 
deliveryNotePositionStatus  Maximum Length:  10  | 
createDate*  | 
string (date-time)  | 
createDate  | 
modifyDate*  | 
string (date-time)  | 
modifyDate  | 
product*  | 
object  | 
|
logisticProductId*  | 
integer  | 
logisticProductId  Maximum:  1000000000000000000  | 
itemNumber*  | 
integer  | 
ItemNumber  Maximum Length:  16  | 
itemSize*  | 
string  | 
ItemSize  Maximum Length:  16  | 
itemSizeBin*  | 
integer  | 
ItemSizeBin  | 
quantity*  | 
number  | 
quantity  | 
supplierNumber*  | 
integer  | 
supplierNumber  Maximum Length:  6  | 
purchaseOrderNumber*  | 
integer  | 
purchaseOrderNumber  Maximum Length:  6  | 
shippingUnitNumber  | 
integer  | 
shippingUnitNumber  Maximum Length:  18  | 
containerType  | 
string  | 
containerType  Maximum Length:  70  | 
containerNumber  | 
string  | 
containerNumber  | 
hermesTMPPosNr  | 
string  | 
hermesTMPPosNr  Maximum Length:  70  | 
customsProcedure  | 
string  | 
customsProcedure  Maximum Length:  70  | 
hAwbBl  | 
string  | 
hAwbBl  Maximum Length:  70  | 
deliveryTypeCode*  | 
string  | 
deliveryTypeCode  Maximum Length:  1  | 
ovaValInfo  | 
integer  | 
ovaValInfo  Maximum Length:  1  | 
additionalInformation  | 
object  | 
|
originalItemNumber  | 
integer  | 
originalItemNumber  Maximum Length:  8  | 
originalItemSize  | 
string  | 
originalItemSize  Maximum Length:  7  | 
ean  | 
integer  | 
ean  Maximum Length:  13  | 
originalOva  | 
integer  | 
originalOva  Maximum Length:  6  | 
errorCode  | 
string  | 
errorCode  | 
errorMessage  | 
string  | 
errorMessage  | 
7 -
7.1 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
ERP goods receipt messages  | 
eventId*  | 
string  | 
The unique eventId  | 
traceId*  | 
string  | 
The unique traceId  | 
spanId*  | 
string  | 
The eventId of previous record or batchId  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
The number of version schema  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "GOODS_IN"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "DELIVERY_NOTE_REGISTRATION_END",
  "GOODSRECEIPT_START",
  "GOODSRECEIPT_END",
  "DELIVERY_COMPARISON_START",
  "DELIVERY_COMPARISON_END",
  "RELEASE_END"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string (enum)  | 
sender  Any of:  [
  "BUBE",
  "COBRA",
  "CORE",
  "FINE_INBOUND",
  "IDEEFIX",
  "KMOTION_ILOWA",
  "KMOTION_GERNSHEIM",
  "KR1_SUEDHAFEN",
  "KR1_HALDENSLEBEN",
  "KR1_HAMBURGERSTRASSE",
  "LDH",
  "LIGIS",
  "LSAS",
  "OBS",
  "RESY",
  "RETAILSCHICHT",
  "WMSX_AKU",
  "WMSX_SONNEFELD",
  "WMSX_WEISMAIN",
  "F2X"
]  | 
client  | 
string  | 
client  | 
instance  | 
string  | 
Software instance of producing system  | 
data*  | 
object  | 
 Additional Properties:  false  | 
location*  | 
string (enum)  | 
The sending warehouse  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",
  "NORD_LOGISTIC"
]  | 
businessEventTime*  | 
string (date-time)  | 
The date and time, when the business event occurred  | 
goodsInId*  | 
string  | 
the goods receipt ID  Maximum Length:  36  | 
originalGoodsInId  | 
string  | 
the original goods receipt ID  Maximum Length:  36  | 
deliveryNumber*  | 
string  | 
the inbound delivery business key  Maximum Length:  36  | 
deliveryTypeCode  | 
string  | 
Identification of the type of entry/delivery  Maximum Length:  50  | 
deliveryType*  | 
string (enum)  | 
Type of the delivery  Any of:  [
  "GOODSIN_SUPPLIER",
  "GOODSIN_FROM_REWORK",
  "GOODSIN_FOR_BOOKING_AND_RELEASE",
  "GOODSIN_FOR_REMOVAL",
  "GOODSIN_INCOMPLETE",
  "GOODSIN_DLW",
  "GOODSIN_FOR_RELEASE",
  "GOODSIN_POST_PROCESSING",
  "GOODSIN_FROM_MAPPER",
  "GOODSIN_SECOND_CHOICE",
  "GOODSIN_STATIONARY_TRADE",
  "GOODSIN_SMALLPARTS",
  "GOODSIN_CANCELATION",
  "GOODSIN_RELABEL",
  "GOODSIN_B2B",
  "GOODSIN_FROM_RETAIL",
  "GOODSIN_3RD_PARTY"
]  | 
carrier  | 
string  | 
name of the carrier transporting goods  Maximum Length:  100  | 
gates  | 
array  | 
|
(Array item)  | 
object  | 
|
door  | 
string  | 
Gate or Door number  Maximum Length:  10  | 
building  | 
string  | 
Building  Maximum Length:  3  | 
processingInformation  | 
array  | 
|
(Array item)  | 
object  | 
 Additional Properties:  false  | 
goodsReceiptProcessingType*  | 
string (enum)  | 
Pallets/hatch detection  Any of:  [
  "PALLETED_SORTED",
  "PALLETED_UNSORTED",
  "CARTONS_SORTED",
  "CARTONS_UNSORTED",
  "SANDWICH_PALLET",
  "PULK_2MH",
  "DLW",
  "ITEMS_UNSORTED",
  "ITEMS_UNSORTED_FROM_KEP",
  "CARTONS_UNSORTED_FROM_KEP",
  "NON_TRADE_ITEMS"
]  | 
goodsReceiptProcessingCode*  | 
string  | 
Pallet/hatch detection code  | 
quantity  | 
integer  | 
Quantity received for this processing type  Minimum:  0  | 
positions  | 
array  | 
|
(Array item)  | 
object  | 
 Additional Properties:  false  | 
deliveryPositionId*  | 
string  | 
Position Id  Maximum Length:  36  | 
deliveryPositionNumber  | 
integer  | 
Position number  Maximum:  99999999999999  | 
quantity*  | 
integer  | 
Quantity received  Minimum:  0  | 
arrivedToReworkerQuantity  | 
integer  | 
Quantity received by the external reworker  Minimum:  0  | 
destroyedByReworkerQuantity  | 
integer  | 
Quantity destroyed by the external reworker  Minimum:  0  | 
loadingUnitQuantity  | 
integer  | 
Amount of goods  Minimum:  0  | 
supplierNumber*  | 
integer  | 
Supplier Number  Maximum:  9999999  | 
reworkerSupplierNumber  | 
integer  | 
External reworker supplier number  Maximum:  9999999  | 
documentNumber*  | 
integer  | 
Document number  Minimum:  100000  | 
ownerCompany*  | 
string  | 
Owner Company (BDF)  Maximum Length:  30  | 
hermesTourNumber  | 
string  | 
Hermes number  Maximum Length:  12  | 
customsShipmentNumber  | 
string  | 
Custom shipment Number  | 
airWayBill  | 
string  | 
Custom shipment Number  Maximum Length:  30  | 
positionDetails  | 
array  | 
|
(Array item)  | 
object  | 
 Additional Properties:  false  | 
purchaseOrderNumber*  | 
string  | 
Purchase Order Number  Maximum Length:  36  | 
deliveryNoteNumber  | 
string  | 
Delivery Note Number  Maximum Length:  36  | 
storageNotificationId  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
quantity  | 
number  | 
the quantity of the referenced PositionDetail within the position  | 
electronicDeliveryNotePositionId  | 
array  | 
Electronic Delivery Note Position  | 
(Array item)  | 
string  | 
|
deliveryPositionDetailId  | 
string  | 
Position Detail Id  Maximum Length:  36  | 
sourceLocation  | 
string  | 
Source/Original location  Maximum Length:  15  | 
product*  | 
object  | 
 Additional Properties:  false  | 
erpProductId*  | 
string  | 
ERP Product Id  Maximum Length:  36  | 
logisticsProductId*  | 
string  | 
Logistics Product Id  Maximum Length:  36  | 
qualityCheck  | 
string (enum)  | 
Type of Quality Check  Any of:  [
  "NO_QUALITY_CHECK",
  "NORMAL_QUALITY_CHECK",
  "DOWNSTREAM_QUALITY_CHECK"
]  | 
qualityCode  | 
integer  | 
Quantity code number Goods inspection  Maximum:  999  | 
damagedQuantity  | 
integer  | 
Quantity items damaged  Maximum:  999999  | 
processEndDate  | 
string  | 
Process End Date  | 
processEndCode  | 
string (enum)  | 
Process End Code  Any of:  [
  "RELEASE",
  "CANCELLATION",
  "RETURN",
  "REWORK",
  "DESTROY",
  "THIRD_PARTY_SALE"
]  | 
erpDeliveryNo  | 
string  | 
Erp Deliver Number  | 
qualitySampleRequestMode  | 
string (enum)  | 
Sample size calculation mode  Any of:  [
  "ONLINE",
  "OFFLINE"
]  | 
qualitySampleDischargeMode  | 
string (enum)  | 
Direktausschleusung  Any of:  [
  "IMMEDIATE",
  "DEFERRED",
  "CONVERTED"
]  | 
deliveryComparisonResult  | 
string (enum)  | 
Comparison result  Any of:  [
  "DIFFERENCE",
  "NO_DIFFERENCE",
  "NO_COMPARISON"
]  | 
7.2 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
WMS goods receipt messages  | 
eventId*  | 
string  | 
The unique eventId  | 
traceId*  | 
string  | 
The unique traceId  | 
spanId*  | 
string  | 
The eventId of previous record or batchId  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
The number of version schema  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "GOODS_IN"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "DELIVERY_NOTE_REGISTRATION_END",
  "GOODSRECEIPT_START",
  "GOODSRECEIPT_END",
  "DELIVERY_COMPARISON_START",
  "DELIVERY_COMPARISON_END",
  "RELEASE_END"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string (enum)  | 
sender  Any of:  [
  "BUBE",
  "COBRA",
  "CORE",
  "FINE_INBOUND",
  "IDEEFIX",
  "KMOTION_ILOWA",
  "KMOTION_GERNSHEIM",
  "KR1_SUEDHAFEN",
  "KR1_HALDENSLEBEN",
  "KR1_HAMBURGERSTRASSE",
  "LDH",
  "LIGIS",
  "LSAS",
  "OBS",
  "RESY",
  "RETAILSCHICHT",
  "WMSX_AKU",
  "WMSX_SONNEFELD",
  "WMSX_WEISMAIN",
  "F2X"
]  | 
client  | 
string  | 
client  | 
instance  | 
string  | 
Software instance of producing system  | 
data*  | 
object  | 
 Additional Properties:  false  | 
location*  | 
string (enum)  | 
The sending warehouse  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",
  "NORD_LOGISTIC"
]  | 
businessEventTime*  | 
string (date-time)  | 
The date and time, when the business event occurred  | 
goodsInId*  | 
string  | 
the goods receipt ID  Maximum Length:  36  | 
originalGoodsInId  | 
string  | 
the original goods receipt ID  Maximum Length:  36  | 
deliveryNumber*  | 
string  | 
the inbound delivery business key  Maximum Length:  36  | 
deliveryTypeCode  | 
string  | 
Identification of the type of entry/delivery  Maximum Length:  50  | 
deliveryType*  | 
string (enum)  | 
Type of the delivery  Any of:  [
  "GOODSIN_SUPPLIER",
  "GOODSIN_FROM_REWORK",
  "GOODSIN_FOR_BOOKING_AND_RELEASE",
  "GOODSIN_FOR_REMOVAL",
  "GOODSIN_INCOMPLETE",
  "GOODSIN_DLW",
  "GOODSIN_FOR_RELEASE",
  "GOODSIN_POST_PROCESSING",
  "GOODSIN_FROM_MAPPER",
  "GOODSIN_SECOND_CHOICE",
  "GOODSIN_STATIONARY_TRADE",
  "GOODSIN_SMALLPARTS",
  "GOODSIN_CANCELATION",
  "GOODSIN_RELABEL",
  "GOODSIN_B2B",
  "GOODSIN_FROM_RETAIL",
  "GOODSIN_3RD_PARTY"
]  | 
carrier  | 
string  | 
name of the carrier transporting goods  Maximum Length:  100  | 
gates  | 
array  | 
|
(Array item)  | 
object  | 
|
door  | 
string  | 
Gate or Door number  Maximum Length:  10  | 
building  | 
string  | 
Building  Maximum Length:  3  | 
processingInformation  | 
array  | 
|
(Array item)  | 
object  | 
 Additional Properties:  false  | 
goodsReceiptProcessingType*  | 
string (enum)  | 
Pallets/hatch detection  Any of:  [
  "PALLETED_SORTED",
  "PALLETED_UNSORTED",
  "CARTONS_SORTED",
  "CARTONS_UNSORTED",
  "SANDWICH_PALLET",
  "PULK_2MH",
  "DLW",
  "ITEMS_UNSORTED",
  "ITEMS_UNSORTED_FROM_KEP",
  "CARTONS_UNSORTED_FROM_KEP",
  "NON_TRADE_ITEMS"
]  | 
goodsReceiptProcessingCode*  | 
string  | 
Pallet/hatch detection code  | 
quantity  | 
integer  | 
Quantity received for this processing type  Minimum:  0  | 
positions  | 
array  | 
|
(Array item)  | 
object  | 
 Additional Properties:  false  | 
deliveryPositionId*  | 
string  | 
Position Id  Maximum Length:  36  | 
deliveryPositionNumber  | 
integer  | 
Position number  Maximum:  99999999999999  | 
quantity*  | 
integer  | 
Quantity received  Minimum:  0  | 
arrivedToReworkerQuantity  | 
integer  | 
Quantity received by the external reworker  Minimum:  0  | 
destroyedByReworkerQuantity  | 
integer  | 
Quantity destroyed by the external reworker  Minimum:  0  | 
loadingUnitQuantity  | 
integer  | 
Amount of goods  Minimum:  0  | 
supplierNumber*  | 
integer  | 
Supplier Number  Maximum:  9999999  | 
reworkerSupplierNumber  | 
integer  | 
External reworker supplier number  Maximum:  9999999  | 
documentNumber*  | 
integer  | 
Document number  Minimum:  100000  | 
ownerCompany*  | 
string  | 
Owner Company (BDF)  Maximum Length:  30  | 
hermesTourNumber  | 
string  | 
Hermes number  Maximum Length:  12  | 
customsShipmentNumber  | 
string  | 
Custom shipment Number  | 
airWayBill  | 
string  | 
Custom shipment Number  Maximum Length:  30  | 
positionDetails  | 
array  | 
|
(Array item)  | 
object  | 
 Additional Properties:  false  | 
purchaseOrderNumber*  | 
string  | 
Purchase Order Number  Maximum Length:  36  | 
deliveryNoteNumber  | 
string  | 
Delivery Note Number  Maximum Length:  36  | 
storageNotificationId  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
quantity  | 
number  | 
the quantity of the referenced PositionDetail within the position  | 
electronicDeliveryNotePositionId  | 
array  | 
Electronic Delivery Note Position  | 
(Array item)  | 
string  | 
|
deliveryPositionDetailId  | 
string  | 
Position Detail Id  Maximum Length:  36  | 
sourceLocation  | 
string  | 
Source/Original location  Maximum Length:  15  | 
product*  | 
object  | 
 Additional Properties:  false  | 
logisticsProductId*  | 
string  | 
Logistics Product Id  Maximum Length:  36  | 
qualityCheck  | 
string (enum)  | 
Type of Quality Check  Any of:  [
  "NO_QUALITY_CHECK",
  "NORMAL_QUALITY_CHECK",
  "DOWNSTREAM_QUALITY_CHECK"
]  | 
qualityCode  | 
integer  | 
Quantity code number Goods inspection  Maximum:  999  | 
damagedQuantity  | 
integer  | 
Quantity items damaged  Maximum:  999999  | 
processEndDate  | 
string  | 
Process End Date  | 
processEndCode  | 
string (enum)  | 
Process End Code  Any of:  [
  "RELEASE",
  "CANCELLATION",
  "RETURN",
  "REWORK",
  "DESTROY",
  "THIRD_PARTY_SALE"
]  | 
erpDeliveryNo  | 
string  | 
Erp Deliver Number  | 
qualitySampleRequestMode  | 
string (enum)  | 
Sample size calculation mode  Any of:  [
  "ONLINE",
  "OFFLINE"
]  | 
qualitySampleDischargeMode  | 
string (enum)  | 
Direktausschleusung  Any of:  [
  "IMMEDIATE",
  "DEFERRED",
  "CONVERTED"
]  | 
deliveryComparisonResult  | 
string (enum)  | 
Comparison result  Any of:  [
  "DIFFERENCE",
  "NO_DIFFERENCE",
  "NO_COMPARISON"
]  | 
8 -
8.1 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
QSRequestErp  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta information  | 
sender  | 
string  | 
The name of sender = producer  Maximum Length:  30  | 
instance  | 
string  | 
SW-Instance of the producing system  Maximum Length:  36  | 
client  | 
string  | 
Client / Tenant  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
requestType*  | 
string  | 
Request type  Maximum Length:  60  | 
deliveryDate*  | 
string (date)  | 
Delivery Date  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
positions*  | 
array  | 
Positionen  Minimum number of items  1  | 
(Array item)  | 
object  | 
 Additional Properties:  false  | 
product*  | 
object  | 
|
erpProductId*  | 
string  | 
Erp product Id  Maximum Length:  50  | 
supplierNumber*  | 
integer  | 
Supplier number  Minimum Length:  1  | 
partnerId  | 
string  | 
Partner Id  Minimum Length:  1  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
purchaseOrderNumber*  | 
integer  | 
Purchase order number  Maximum Length:  20  | 
externalQualityCode*  | 
string  | 
External quality code  Maximum Length:  30  | 
deliveryQuantity*  | 
number  | 
Delivery quantity  | 
storageNotificationId  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
wmsPositionId*  | 
string  | 
LVS VorgangsID  Maximum Length:  36  | 
8.2 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
QSRequestWms  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta information  | 
sender  | 
string  | 
The name of sender = producer  Maximum Length:  30  | 
instance  | 
string  | 
SW-Instance of the producing system  Maximum Length:  36  | 
client  | 
string  | 
Client / Tenant  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
requestType*  | 
string  | 
Request type  Maximum Length:  60  | 
deliveryDate*  | 
string (date)  | 
Delivery Date  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
positions*  | 
array  | 
Positionen  Minimum number of items  1  | 
(Array item)  | 
object  | 
 Additional Properties:  false  | 
product*  | 
object  | 
|
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  50  | 
supplierNumber*  | 
integer  | 
Supplier number  Minimum Length:  1  | 
partnerId  | 
string  | 
Partner Id  Minimum Length:  1  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
purchaseOrderNumber*  | 
integer  | 
Purchase order number  Maximum Length:  20  | 
externalQualityCode*  | 
string  | 
External quality code  Maximum Length:  30  | 
deliveryQuantity*  | 
number  | 
Delivery quantity  | 
storageNotificationId  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
wmsPositionId*  | 
string  | 
LVS VorgangsID  Maximum Length:  36  | 
9 -
9.1 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
QSResponseErp  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta information  | 
sender  | 
string  | 
The name of sender = producer  Maximum Length:  30  | 
instance  | 
string  | 
SW-Instance of the producing system  Maximum Length:  36  | 
client  | 
string  | 
Client / Tenant  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
deliveryDate*  | 
string (date)  | 
Delivery Date  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
positions*  | 
array  | 
Positionen  Minimum number of items  1  | 
(Array item)  | 
object  | 
 Additional Properties:  false  | 
product*  | 
object  | 
|
erpProductId*  | 
string  | 
Erp product Id  Maximum Length:  50  | 
supplierNumber*  | 
integer  | 
Supplier number  Maximum Length:  20  | 
partnerId  | 
string  | 
Partner Id  Minimum Length:  1  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
purchaseOrderNumber*  | 
integer  | 
Purchase order number  Maximum Length:  20  | 
qualityCode*  | 
integer  | 
Quality code  Maximum Length:  6  | 
checkPrecision*  | 
string  | 
Check precision  Maximum Length:  10  | 
sampleQuantity*  | 
integer  | 
Sample quantity  Maximum Length:  6  | 
inspectionId*  | 
string  | 
Inspection Id  Maximum Length:  36  | 
wmsPositionId*  | 
string  | 
LVS VorgangsID  Maximum Length:  36  | 
9.2 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
QSResponseWms  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta information  | 
sender  | 
string  | 
The name of sender = producer  Maximum Length:  30  | 
instance  | 
string  | 
SW-Instance of the producing system  Maximum Length:  36  | 
client  | 
string  | 
Client / Tenant  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
deliveryDate*  | 
string (date)  | 
Delivery Date  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
positions*  | 
array  | 
Positionen  Minimum number of items  1  | 
(Array item)  | 
object  | 
 Additional Properties:  false  | 
product*  | 
object  | 
|
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  50  | 
supplierNumber*  | 
integer  | 
Supplier number  Maximum Length:  20  | 
partnerId  | 
string  | 
Partner Id  Minimum Length:  1  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
purchaseOrderNumber*  | 
integer  | 
Purchase order number  Maximum Length:  20  | 
qualityCode*  | 
integer  | 
Quality code  Maximum Length:  6  | 
checkPrecision*  | 
string  | 
Check precision  Maximum Length:  10  | 
sampleQuantity*  | 
integer  | 
Sample quantity  Maximum Length:  6  | 
inspectionId*  | 
string  | 
Inspection Id  Maximum Length:  36  | 
wmsPositionId*  | 
string  | 
LVS VorgangsID  Maximum Length:  36  | 
10 -
10.1 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
QSResultErp  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta information  | 
sender  | 
string  | 
The name of sender = producer  Maximum Length:  30  | 
instance  | 
string  | 
SW-Instance of the producing system  | 
client  | 
string  | 
Client / Tenant  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
product*  | 
object  | 
|
erpProductId*  | 
string  | 
Erp product Id  Maximum Length:  50  | 
supplierNumber*  | 
integer  | 
Supplier number  Minimum Length:  1  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
qualityCode*  | 
integer  | 
Quality code  Maximum Length:  6  | 
resultCode*  | 
string  | 
Quality result code  | 
rejectionCode  | 
string  | 
Rejection code  Minimum Length:  1  | 
inspectionId  | 
string  | 
Inspection Id  Maximum Length:  36  | 
wmsPositionId*  | 
string  | 
LVS VorgangsID  Maximum Length:  36  | 
resultQuantity  | 
number  | 
Result quantity  | 
cmsId  | 
string  | 
CMS Id  Maximum Length:  36  | 
10.2 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
QSResultWms  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta information  | 
sender  | 
string  | 
The name of sender = producer  Maximum Length:  30  | 
instance  | 
string  | 
SW-Instance of the producing system  | 
client  | 
string  | 
Client / Tenant  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
deliveryNumber*  | 
string  | 
Delivery Number  | 
product*  | 
object  | 
|
logisticsProductId*  | 
string  | 
Logistics Product Id  Maximum Length:  50  | 
supplierNumber*  | 
integer  | 
Supplier number  Minimum Length:  1  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
qualityCode*  | 
integer  | 
Quality code  Maximum Length:  6  | 
resultCode*  | 
string  | 
Quality result code  | 
rejectionCode  | 
string  | 
Rejection code  Minimum Length:  1  | 
inspectionId  | 
string  | 
Inspection Id  Maximum Length:  36  | 
wmsPositionId*  | 
string  | 
LVS VorgangsID  Maximum Length:  36  | 
resultQuantity  | 
number  | 
Result quantity  | 
cmsId  | 
string  | 
CMS Id  Maximum Length:  36  | 
11 -
11.1 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
PacklistReadyForQsErp  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta data  | 
sender  | 
string (enum)  | 
sender  Any of:  [
  "KR1_SHF",
  "KR1_HHSTR",
  "WMSX_SON",
  "WMSX_AKU",
  "KMOTION_ILO",
  "KMOTION_GHM",
  "COBRA",
  "LSAS",
  "IDEEFIX",
  "OBS",
  "RESY",
  "LDH",
  "RETAILSCHICHT",
  "BUBE",
  "FINE_INBOUND"
]  | 
instance  | 
string  | 
instance of producer  | 
client  | 
string (enum)  | 
client  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU"
]  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
positions*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
containerId*  | 
string  | 
Container ID  Maximum Length:  36  | 
containerNumber*  | 
string  | 
Container number  Maximum Length:  50  | 
buid  | 
string  | 
BUID  Maximum Length:  36  | 
erpProductId*  | 
string  | 
Erp product Id  Maximum Length:  50  | 
quantity*  | 
number  | 
Menge  | 
storageRemovalTime*  | 
string (date-time)  | 
Entnahmezeitpunkt  | 
currentStorageLocation*  | 
string  | 
Lagerort/Lagerkoordinate  Maximum Length:  50  | 
supplierNumber*  | 
integer  | 
Supplier number  Minimum Length:  1  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
inspectionId*  | 
string  | 
Inspection Id  Maximum Length:  36  | 
wmsPositionId*  | 
string  | 
LVS VorgangsID  Maximum Length:  36  | 
11.2 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
PackageStatusAfterQsWms  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta data  | 
sender  | 
string (enum)  | 
sender  Any of:  [
  "KR1_SHF",
  "KR1_HHSTR",
  "WMSX_SON",
  "WMSX_AKU",
  "KMOTION_ILO",
  "KMOTION_GHM",
  "COBRA",
  "LSAS",
  "IDEEFIX",
  "OBS",
  "RESY",
  "LDH",
  "RETAILSCHICHT",
  "BUBE",
  "FINE_INBOUND"
]  | 
instance  | 
string  | 
instance of producer  | 
client  | 
string (enum)  | 
client  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU"
]  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
positions*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
containerId*  | 
string  | 
Container ID  Maximum Length:  36  | 
containerNumber*  | 
string  | 
Container number  Maximum Length:  50  | 
buid  | 
string  | 
BUID  Maximum Length:  36  | 
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  50  | 
quantity*  | 
number  | 
Menge  | 
storageRemovalTime*  | 
string (date-time)  | 
Entnahmezeitpunkt  | 
currentStorageLocation*  | 
string  | 
Lagerort/Lagerkoordinate  Maximum Length:  50  | 
supplierNumber*  | 
integer  | 
Supplier number  Minimum Length:  1  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
inspectionId*  | 
string  | 
Inspection Id  Maximum Length:  36  | 
wmsPositionId*  | 
string  | 
LVS VorgangsID  Maximum Length:  36  | 
12 -
12.1 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
PackageStatusAfterQsErp  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta data  | 
sender  | 
string (enum)  | 
sender  Any of:  [
  "KR1_SHF",
  "KR1_HHSTR",
  "WMSX_SON",
  "WMSX_AKU",
  "KMOTION_ILO",
  "KMOTION_GHM",
  "COBRA",
  "LSAS",
  "IDEEFIX",
  "OBS",
  "RESY",
  "LDH",
  "RETAILSCHICHT",
  "BUBE",
  "FINE_INBOUND"
]  | 
instance  | 
string  | 
instance of producer  | 
client  | 
string (enum)  | 
client  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU"
]  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
containerId*  | 
string  | 
Container ID  Maximum Length:  36  | 
buid  | 
string  | 
BUID  Maximum Length:  36  | 
erpProductId*  | 
string  | 
Erp product Id  Maximum Length:  50  | 
quantity*  | 
number  | 
Menge  | 
status*  | 
string  | 
Package status  Maximum Length:  20  | 
12.2 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
PackageStatusAfterQsWms  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta data  | 
sender  | 
string (enum)  | 
sender  Any of:  [
  "KR1_SHF",
  "KR1_HHSTR",
  "WMSX_SON",
  "WMSX_AKU",
  "KMOTION_ILO",
  "KMOTION_GHM",
  "COBRA",
  "LSAS",
  "IDEEFIX",
  "OBS",
  "RESY",
  "LDH",
  "RETAILSCHICHT",
  "BUBE",
  "FINE_INBOUND"
]  | 
instance  | 
string  | 
instance of producer  | 
client  | 
string (enum)  | 
client  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU"
]  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
containerId*  | 
string  | 
Container ID  Maximum Length:  36  | 
buid  | 
string  | 
BUID  Maximum Length:  36  | 
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  50  | 
quantity*  | 
number  | 
Menge  | 
status*  | 
string  | 
Package status  Maximum Length:  20  | 
13 -
13.1 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
AllPlannedReworksErp  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta data  | 
sender  | 
string (enum)  | 
sender  Any of:  [
  "KR1_SHF",
  "KR1_HHSTR",
  "WMSX_SON",
  "WMSX_AKU",
  "KMOTION_ILO",
  "KMOTION_GHM",
  "COBRA",
  "LSAS",
  "IDEEFIX",
  "OBS",
  "RESY",
  "LDH",
  "RETAILSCHICHT",
  "BUBE",
  "FINE_INBOUND"
]  | 
instance  | 
string  | 
instance of producer  | 
client  | 
string (enum)  | 
client  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU"
]  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
cmsId*  | 
string  | 
CMS ID  Maximum Length:  36  | 
validFrom  | 
string (date-time)  | 
Valid from date  | 
validTo  | 
string (date-time)  | 
Valid to date  | 
erpProductId*  | 
string  | 
Erp product Id  Maximum Length:  50  | 
quantity*  | 
number  | 
Quantity  | 
storageNotificationId  | 
array  | 
StorageNotification reference  | 
(Array item)  | 
string  | 
|
activityCode*  | 
array  | 
Activity codes  | 
(Array item)  | 
string  | 
|
supplierNumber*  | 
integer  | 
Supplier number  Minimum Length:  1  | 
companyNumber*  | 
string  | 
Company number  | 
13.2 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
AllPlannedReworksWms  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta data  | 
sender  | 
string (enum)  | 
sender  Any of:  [
  "KR1_SHF",
  "KR1_HHSTR",
  "WMSX_SON",
  "WMSX_AKU",
  "KMOTION_ILO",
  "KMOTION_GHM",
  "COBRA",
  "LSAS",
  "IDEEFIX",
  "OBS",
  "RESY",
  "LDH",
  "RETAILSCHICHT",
  "BUBE",
  "FINE_INBOUND"
]  | 
instance  | 
string  | 
instance of producer  | 
client  | 
string (enum)  | 
client  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU"
]  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
cmsId*  | 
string  | 
CMS ID  Maximum Length:  36  | 
validFrom  | 
string (date-time)  | 
Valid from date  | 
validTo  | 
string (date-time)  | 
Valid to date  | 
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  50  | 
quantity*  | 
number  | 
Quantity  | 
storageNotificationId  | 
array  | 
StorageNotification reference  | 
(Array item)  | 
string  | 
|
activityCode*  | 
array  | 
Activity codes  | 
(Array item)  | 
string  | 
|
supplierNumber*  | 
integer  | 
Supplier number  Minimum Length:  1  | 
companyNumber*  | 
string  | 
Company number  | 
14 -
14.1 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
PlannedUnplannedReworkErp  | 
eventId*  | 
string  | 
The unique eventId  | 
traceId*  | 
string  | 
The unique traceId  | 
spanId*  | 
string  | 
The eventId of previous record or batchId  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
The number of version schema  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "CLAIM"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "PLANNED_REWORK",
  "UNPLANNED_REWORK",
  "SECONDARY_INSPECTION"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string  | 
Sender  | 
client  | 
string  | 
Client  | 
data*  | 
object  | 
|
location*  | 
string (enum)  | 
The receiving warehouse  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"
]  | 
positions*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
erpProductId*  | 
string  | 
Erp product Id  Maximum Length:  36  | 
quantity*  | 
number  | 
Menge  Maximum:  999999  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
supplierNumber*  | 
integer  | 
Supplier number  Maximum Length:  7  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Minimum:  100000  | 
goodsInPositionId*  | 
string  | 
Technischer Schlüssel der Anlieferposition  Maximum Length:  36  | 
purchaseOrderNumber  | 
array  | 
Purchase Order Number  | 
(Array item)  | 
string  | 
 Maximum Length:  36  | 
storageNotificationId  | 
array  | 
Storage Notification Id  | 
(Array item)  | 
string  | 
 Maximum Length:  36  | 
containerId  | 
string  | 
Container ID  Maximum Length:  36  | 
containerNumber  | 
string  | 
Container number  Maximum Length:  50  | 
buaid  | 
string  | 
BUAID  Maximum Length:  36  | 
14.2 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
PlannedUnplannedReworkWms  | 
eventId*  | 
string  | 
The unique eventId  | 
traceId*  | 
string  | 
The unique traceId  | 
spanId*  | 
string  | 
The eventId of previous record or batchId  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
The number of version schema  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "CLAIM"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "PLANNED_REWORK",
  "UNPLANNED_REWORK",
  "SECONDARY_INSPECTION"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string  | 
Sender  | 
client  | 
string  | 
Client  | 
data*  | 
object  | 
|
location*  | 
string (enum)  | 
The receiving warehouse  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"
]  | 
positions*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  36  | 
quantity*  | 
number  | 
Menge  Maximum:  999999  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
supplierNumber*  | 
integer  | 
Supplier number  Maximum Length:  7  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Minimum:  100000  | 
goodsInPositionId*  | 
string  | 
Technischer Schlüssel der Anlieferposition  Maximum Length:  36  | 
purchaseOrderNumber  | 
array  | 
Purchase Order Number  | 
(Array item)  | 
string  | 
 Maximum Length:  36  | 
storageNotificationId  | 
array  | 
Storage Notification Id  | 
(Array item)  | 
string  | 
 Maximum Length:  36  | 
containerId  | 
string  | 
Container ID  Maximum Length:  36  | 
containerNumber  | 
string  | 
Container number  Maximum Length:  50  | 
buaid  | 
string  | 
BUAID  Maximum Length:  36  | 
15 -
15.1 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
ExecutedReworkStepsErp  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "EXECUTED_REWORK_STEPS"
]  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "GOODSIN_NEW_GOODS",
  "GOODSIN_STOCK_TRANSFER"
]  | 
metaData  | 
object  | 
additional meta data  | 
sender  | 
string (enum)  | 
sender  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",
  "EFI",
  "ABOUTYOU",
  "WITT",
  "MFC_HRL_HHSTR"
]  | 
data*  | 
object  | 
|
location*  | 
string (enum)  | 
The sending warehouse  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"
]  | 
deliveryNumber  | 
string  | 
Delivery Number  Maximum Length:  36  | 
containerId  | 
string  | 
Container ID  Maximum Length:  36  | 
wmsReferenceId  | 
string  | 
WMS reference id  Maximum Length:  36  | 
positions*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  50  | 
erpProductId*  | 
string  | 
ERP Product Id  Maximum Length:  36  | 
ownerCompany*  | 
string  | 
Owner Company (BDF)  | 
activities*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
activityCode*  | 
string  | 
Activity code  Maximum Length:  30  | 
quantity*  | 
number  | 
Menge  | 
supplierNumber  | 
integer  | 
Supplier number  Maximum:  9999999  | 
receivingDocumentNumber  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
goodsInPositionId  | 
string  | 
Position Id  Maximum Length:  36  | 
15.2 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
ExecutedReworkStepsWms  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "EXECUTED_REWORK_STEPS"
]  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "GOODSIN_NEW_GOODS",
  "GOODSIN_STOCK_TRANSFER"
]  | 
metaData  | 
object  | 
additional meta data  | 
sender  | 
string (enum)  | 
sender  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",
  "EFI",
  "ABOUTYOU",
  "WITT",
  "MFC_HRL_HHSTR"
]  | 
data*  | 
object  | 
|
location*  | 
string (enum)  | 
The sending warehouse  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"
]  | 
deliveryNumber  | 
string  | 
Delivery Number  Maximum Length:  36  | 
containerId  | 
string  | 
Container ID  Maximum Length:  36  | 
wmsReferenceId  | 
string  | 
WMS reference id  Maximum Length:  36  | 
positions*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  50  | 
activities*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
activityCode*  | 
string  | 
Activity code  Maximum Length:  30  | 
quantity*  | 
number  | 
Menge  | 
supplierNumber  | 
integer  | 
Supplier number  Maximum:  9999999  | 
receivingDocumentNumber  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
goodsInPositionId  | 
string  | 
Position Id  Maximum Length:  36  | 
16 -
16.1 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
Stock Transfer  | 
eventId*  | 
string  | 
The uniqe eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "STOCK_TRANSFER_BETWEEN_WAREHOUSES",
  "STOCK_TRANSFER_CANCELLATION"
]  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Version of the interface  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "STOCK_TRANSFER"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string  | 
sender  Maximum Length:  30  | 
client  | 
string  | 
client  Maximum Length:  30  | 
data*  | 
object  | 
|
locationSource*  | 
string  | 
Source warehouse  Minimum Length:  3  | 
locationTarget*  | 
string (enum)  | 
Target warehouse  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"
]  | 
wmsOrderId*  | 
string  | 
WMS Order ID  Maximum Length:  36  | 
transportStartTime  | 
string (date-time)  | 
Start time from source warehouse  | 
positions*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
b2bOrderId  | 
string  | 
ERP Order ID  Maximum Length:  36  | 
voucherNumber  | 
integer  | 
Belegnummer  Maximum Length:  6  | 
loadingNumber  | 
string  | 
Loading Number  Maximum Length:  12  | 
originalLoadingNumber  | 
string  | 
Original Loading Number  Maximum Length:  12  | 
wabNumber  | 
string  | 
WAB Number  Maximum Length:  30  | 
latestStorageTime  | 
string (date-time)  | 
Latest storage time at the target warehouse  | 
priority  | 
string (enum)  | 
Priority for transport  Any of:  [
  "PRIORITY_A",
  "PRIORITY_B"
]  | 
stockType*  | 
string (enum)  | 
Stock type  Any of:  [
  "STOCK_ITEM",
  "LOCKED",
  "DLW",
  "NLR"
]  | 
transportType*  | 
string (enum)  | 
Transport type  Any of:  [
  "STOCK_TRANSFER",
  "RETURN_INBOUND",
  "RETURN_SUPPLIER",
  "INTERNAL_REMOVAL_FROM_INBOUND",
  "INTERNAL_REMOVAL_FOR_SAMPLE",
  "SUPPLY",
  "STOCK_TRANSFER_WITH_PROMISE",
  "FINAL_REMOVAL",
  "OTTO_MARKET",
  "INBOUND_SAMPLE",
  "GOODSIN_B2B",
  "GOODSIN_RETAIL"
]  | 
containerId*  | 
string  | 
Container ID  Maximum Length:  36  | 
containerNumber*  | 
string  | 
Container number  Maximum Length:  50  | 
containerPackaging*  | 
string  | 
Container packaging  Maximum Length:  50  | 
parentContainerId  | 
string  | 
Parent container ID  Maximum Length:  36  | 
parentContainerNumber  | 
string  | 
Parent container number  Maximum Length:  36  | 
parentContainerPackaging  | 
string  | 
Parent container packaging  Maximum Length:  50  | 
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  36  | 
erpProductId  | 
string  | 
ERP Product Id  Maximum Length:  36  | 
partNumber*  | 
integer  | 
Part number  Maximum Length:  6  | 
productDetails  | 
object  | 
|
buid  | 
string  | 
BUID  Maximum Length:  36  | 
rfid  | 
string  | 
RFID  Maximum Length:  64  | 
imei1  | 
string  | 
IMEI1  Maximum Length:  16  | 
imei2  | 
string  | 
IMEI2  Maximum Length:  16  | 
producerId  | 
string  | 
Producer ID  Maximum Length:  36  | 
batchId  | 
string  | 
Batch ID  Maximum Length:  40  | 
bestBeforeDate  | 
string (date-time)  | 
Best before date  | 
ownerCompany*  | 
string  | 
Owner Company (BDF)  Maximum Length:  30  | 
supplierNumber*  | 
integer  | 
Supplier number  Maximum Length:  6  | 
logisticsSupplierId  | 
string  | 
Logistics supplier id  Maximum Length:  36  | 
quantity*  | 
number  | 
Quantity  | 
deliveryNumber  | 
string  | 
Delivery Number  Maximum Length:  36  | 
deliveryNumberShort  | 
integer  | 
Delivery number short  Maximum Length:  7  | 
receivingDocumentNumber  | 
integer  | 
Receiving document number  Maximum Length:  6  | 
customsStatus*  | 
string (enum)  | 
Customs status  Any of:  [
  "FREE",
  "DUTY",
  "NOT_DEFINED"
]  | 
storageNotificationId  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
deliveryPositionId  | 
string  | 
Delivery Position Id  Maximum Length:  36  | 
sortDestination  | 
integer  | 
Sort Destination  Maximum Length:  4  | 
returnsKey  | 
string  | 
Returns Key  Maximum Length:  36  | 
returnsEvaluationCode  | 
string  | 
Returns evaluation code  Maximum Length:  50  | 
orderDescription  | 
string  | 
Order description  Maximum Length:  100  | 
lockReason  | 
string (enum)  | 
Lock reason type  Any of:  [
  "REQUEST_BY_MERCHANT",
  "QUALITY_PROBLEMS",
  "WRONG_LABEL",
  "RESERVED_FOR_IWA",
  "DIFFERENCES",
  "OTHER"
]  | 
lockReasonText  | 
string  | 
Lock reason text  Maximum Length:  1000  | 
17 -
17.1 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
ERP WRS/WRR bookings  | 
eventId*  | 
string  | 
The uniq eventId  | 
traceId*  | 
string  | 
The uniq traceId  | 
spanId*  | 
string  | 
The eventId of previous record or batchId  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
The number of version schema  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "RETURNS_TO_SUPPLIER"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "WRS",
  "WRR"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string (enum)  | 
sender  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"
]  | 
client  | 
string (enum)  | 
client  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU",
  "F2X",
  "F2X_MANUFACTUM",
  "PSAUT",
  "F2X_SHEEGO",
  "F2X_CLEARANCE"
]  | 
data*  | 
object  | 
 Additional Properties:  false  | 
location*  | 
string (enum)  | 
Lagerstandort  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"
]  | 
businessEventTime*  | 
string (date-time)  | 
Datum und Uhrzeit des Geschäftsvorfalls  | 
businessEventKey*  | 
string  | 
UUID der Buchung  Maximum Length:  36  | 
supplierNumber*  | 
integer  | 
Lieferantenkennziffer  Maximum:  999999  | 
erpSupplierId*  | 
string  | 
LieferantenID  Maximum Length:  36  | 
creditorNumber  | 
integer  | 
Kreditornummer eines Lieferanten  Maximum:  9999999999  | 
ownerCompany*  | 
string (enum)  | 
Owner Company (BDF)  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU",
  "F2X",
  "F2X_MANUFACTUM",
  "PSAUT",
  "F2X_SHEEGO",
  "F2X_CLEARANCE"
]  | 
returnAddress*  | 
object  | 
Abweichende Adresse  | 
addressName  | 
string  | 
Name des Lieferanten  Maximum Length:  100  | 
addressStreet  | 
string  | 
Straße, Hausnummer  Maximum Length:  100  | 
addressZip  | 
string  | 
Postleitzahl  Maximum Length:  10  | 
addressCity  | 
string  | 
Ortschaft  Maximum Length:  100  | 
addressCountryCode  | 
string  | 
Zweistellige Ländercode  Maximum Length:  2  | 
documentNumber*  | 
integer  | 
Belegnummer  Minimum:  100000  | 
wrsOrderNumber  | 
integer  | 
WRS Order Number  Minimum:  10000000000000  | 
cancellableDocumentNumber  | 
integer  | 
Nummer des zu stornierenden Beleges  Minimum:  100000  | 
cancellationFlag*  | 
string (enum)  | 
Cancellation flag  Any of:  [
  "YES",
  "NO"
]  | 
returnReason*  | 
string (enum)  | 
Return reason  Any of:  [
  "QUALITY",
  "SURPLUS_DELIVERY",
  "FAIRNESS"
]  | 
returnSourceCode*  | 
string (enum)  | 
Quelle der Rücksendung  Any of:  [
  "NON_STOCK_ITEM",
  "CONSIGNMENT_GOODS",
  "RETURNS",
  "WAREHOUSE_REPAIRS",
  "DEFAULT"
]  | 
freightTermCode*  | 
string (enum)  | 
Frankatur  Any of:  [
  "NOT_FREE",
  "FREE",
  "FROM_FACTORY",
  "NOT_IDENTIFIED"
]  | 
shipmentCode*  | 
string (enum)  | 
Versand veranlasst per  Any of:  [
  "CARRIER",
  "RAILWAY",
  "POST",
  "EXPRESS",
  "COLLECTION",
  "NOT_IDENTIFIED"
]  | 
postageCost  | 
integer  | 
Porto  Minimum:  0  | 
extraCost  | 
integer  | 
Nebenkosten  Minimum:  0  | 
extraCostsCode*  | 
string (enum)  | 
Nebenkosten Kennzeichen  Any of:  [
  "CUSTOMER_RETURNS",
  "STANDARD_CARTON",
  "SELF_PRODUCTION",
  "TROLLEY",
  "SOLD_BY_METER",
  "HARDWARE",
  "NO_EXTRA_COSTS"
]  | 
extraCostCartonQuantity  | 
integer  | 
Anzahl Kartons  Minimum:  0  | 
extraCostOpenCartonQuantity  | 
integer  | 
Anzahl geöffneter Kartons  Minimum:  0  | 
documentCreatedBy*  | 
string  | 
Beleg erstellt von  | 
positions*  | 
array  | 
|
(Array item)  | 
object  | 
 Additional Properties:  false  | 
erpProductId*  | 
string  | 
ERP Product Id  Maximum Length:  36  | 
quantity*  | 
integer  | 
Return received  Minimum:  0  | 
17.2 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
WMS WRS/WRR bookings  | 
eventId*  | 
string  | 
The uniq eventId  | 
traceId*  | 
string  | 
The uniq traceId  | 
spanId*  | 
string  | 
The eventId of previous record or batchId  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
The number of version schema  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "RETURNS_TO_SUPPLIER"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "WRS",
  "WRR"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string (enum)  | 
sender  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"
]  | 
client  | 
string (enum)  | 
client  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU",
  "F2X",
  "F2X_MANUFACTUM",
  "PSAUT",
  "F2X_SHEEGO",
  "F2X_CLEARANCE"
]  | 
data*  | 
object  | 
 Additional Properties:  false  | 
location*  | 
string (enum)  | 
Lagerstandort  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"
]  | 
businessEventTime*  | 
string (date-time)  | 
Datum und Uhrzeit des Geschäftsvorfalls  | 
businessEventKey*  | 
string  | 
UUID der Buchung  Maximum Length:  36  | 
supplierNumber*  | 
integer  | 
Lieferantenkennziffer  Maximum:  999999  | 
logisticsSupplierId*  | 
string  | 
LieferantenID  Maximum Length:  36  | 
creditorNumber  | 
integer  | 
Kreditornummer eines Lieferanten  Maximum:  9999999999  | 
ownerCompany*  | 
string (enum)  | 
Owner Company (BDF)  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU",
  "F2X",
  "F2X_MANUFACTUM",
  "PSAUT",
  "F2X_SHEEGO",
  "F2X_CLEARANCE"
]  | 
returnAddress*  | 
object  | 
Abweichende Adresse  | 
addressName  | 
string  | 
Name des Lieferanten  Maximum Length:  100  | 
addressStreet  | 
string  | 
Straße, Hausnummer  Maximum Length:  100  | 
addressZip  | 
string  | 
Postleitzahl  Maximum Length:  10  | 
addressCity  | 
string  | 
Ortschaft  Maximum Length:  100  | 
addressCountryCode  | 
string  | 
Zweistellige Ländercode  Maximum Length:  2  | 
documentNumber*  | 
integer  | 
Belegnummer  Minimum:  100000  | 
wrsOrderNumber  | 
integer  | 
WRS Order Number  Minimum:  10000000000000  | 
cancellableDocumentNumber  | 
integer  | 
Nummer des zu stornierenden Beleges  Minimum:  100000  | 
cancellationFlag*  | 
string (enum)  | 
Cancellation flag  Any of:  [
  "YES",
  "NO"
]  | 
returnReason*  | 
string (enum)  | 
Return reason  Any of:  [
  "QUALITY",
  "SURPLUS_DELIVERY",
  "FAIRNESS"
]  | 
returnSourceCode*  | 
string (enum)  | 
Quelle der Rücksendung  Any of:  [
  "NON_STOCK_ITEM",
  "CONSIGNMENT_GOODS",
  "RETURNS",
  "WAREHOUSE_REPAIRS",
  "DEFAULT"
]  | 
freightTermCode*  | 
string (enum)  | 
Frankatur  Any of:  [
  "NOT_FREE",
  "FREE",
  "FROM_FACTORY",
  "NOT_IDENTIFIED"
]  | 
shipmentCode*  | 
string (enum)  | 
Versand veranlasst per  Any of:  [
  "CARRIER",
  "RAILWAY",
  "POST",
  "EXPRESS",
  "COLLECTION",
  "NOT_IDENTIFIED"
]  | 
postageCost  | 
integer  | 
Porto  Minimum:  0  | 
extraCost  | 
integer  | 
Nebenkosten  Minimum:  0  | 
extraCostsCode*  | 
string (enum)  | 
Nebenkosten Kennzeichen  Any of:  [
  "CUSTOMER_RETURNS",
  "STANDARD_CARTON",
  "SELF_PRODUCTION",
  "TROLLEY",
  "SOLD_BY_METER",
  "HARDWARE",
  "NO_EXTRA_COSTS"
]  | 
extraCostCartonQuantity  | 
integer  | 
Anzahl Kartons  Minimum:  0  | 
extraCostOpenCartonQuantity  | 
integer  | 
Anzahl geöffneter Kartons  Minimum:  0  | 
documentCreatedBy*  | 
string  | 
Beleg erstellt von  | 
positions*  | 
array  | 
|
(Array item)  | 
object  | 
 Additional Properties:  false  | 
logisticsProductId*  | 
string  | 
WMS Product Id  Maximum Length:  36  | 
quantity*  | 
integer  | 
Return received  Minimum:  0  | 
18 -
18.1 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
TransportDamageErp  | 
eventId*  | 
string  | 
The uniqe eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId*  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "QS"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "TRANSPORT_DAMAGE_NEW_GOODS"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string (enum)  | 
sender  Any of:  [
  "BUBE",
  "COBRA",
  "CORE",
  "FINE_INBOUND",
  "IDEEFIX",
  "KMOTION_ILOWA",
  "KMOTION_GERNSHEIM",
  "KR1_SUEDHAFEN",
  "KR1_HALDENSLEBEN",
  "KR1_HAMBURGERSTRASSE",
  "LDH",
  "LIGIS",
  "LSAS",
  "OBS",
  "RESY",
  "RETAILSCHICHT",
  "WMSX_AKU",
  "WMSX_SONNEFELD",
  "WMSX_WEISMAIN",
  "F2X"
]  | 
data*  | 
object  | 
|
location*  | 
string (enum)  | 
The sending warehouse  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"
]  | 
businessEventTime*  | 
string (date-time)  | 
The date and time, when the business event occurred  | 
goodsInId*  | 
string  | 
the goods receipt ID  Maximum Length:  36  | 
deliveryNumber*  | 
string  | 
the inbound delivery business key  Maximum Length:  36  | 
deliveryDate*  | 
string (date)  | 
Delivery Date  | 
positions*  | 
array  | 
Positionen  Minimum number of items  1  | 
(Array item)  | 
object  | 
|
goodsInPositionId*  | 
string  | 
Position Id  Maximum Length:  36  | 
supplierNumber*  | 
integer  | 
Supplier Number  Maximum:  9999999  | 
erpProductId*  | 
string  | 
Erp Product Id  Maximum Length:  36  | 
documentNumber*  | 
integer  | 
Document number  Minimum:  100000  | 
purchaseOrderNumber*  | 
integer  | 
Purchase order number  Maximum Length:  20  | 
storageNotificationId*  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
deliveryQuantity*  | 
number  | 
Delivery quantity  | 
damagedQuantity*  | 
number  | 
Damaged quantity  | 
imageURLs  | 
array  | 
Image URLs  | 
(Array item)  | 
string  | 
|
damageCodes  | 
array  | 
|
(Array item)  | 
object  | 
|
code  | 
string  | 
Damage code  Maximum Length:  50  | 
description  | 
string  | 
Damage code description  Maximum Length:  200  | 
18.2 -
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
TransportDamageWms  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId*  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "QS"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "TRANSPORT_DAMAGE_NEW_GOODS"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string (enum)  | 
sender  Any of:  [
  "BUBE",
  "COBRA",
  "CORE",
  "FINE_INBOUND",
  "IDEEFIX",
  "KMOTION_ILOWA",
  "KMOTION_GERNSHEIM",
  "KR1_SUEDHAFEN",
  "KR1_HALDENSLEBEN",
  "KR1_HAMBURGERSTRASSE",
  "LDH",
  "LIGIS",
  "LSAS",
  "OBS",
  "RESY",
  "RETAILSCHICHT",
  "WMSX_AKU",
  "WMSX_SONNEFELD",
  "WMSX_WEISMAIN",
  "F2X"
]  | 
data*  | 
object  | 
|
location*  | 
string (enum)  | 
The sending warehouse  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"
]  | 
businessEventTime*  | 
string (date-time)  | 
The date and time, when the business event occurred  | 
goodsInId*  | 
string  | 
the goods receipt ID  Maximum Length:  36  | 
deliveryNumber*  | 
string  | 
the inbound delivery business key  Maximum Length:  36  | 
deliveryDate*  | 
string (date)  | 
Delivery Date  | 
positions*  | 
array  | 
Positionen  Minimum number of items  1  | 
(Array item)  | 
object  | 
|
goodsInPositionId*  | 
string  | 
Position Id  Maximum Length:  36  | 
supplierNumber*  | 
integer  | 
Supplier Number  Maximum:  9999999  | 
logisticsProductId*  | 
string  | 
Logistics Product Id  Maximum Length:  36  | 
documentNumber*  | 
integer  | 
Document number  Minimum:  100000  | 
purchaseOrderNumber*  | 
integer  | 
Purchase order number  Maximum Length:  20  | 
storageNotificationId*  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
deliveryQuantity*  | 
number  | 
Delivery quantity  | 
damagedQuantity*  | 
number  | 
Damaged quantity  | 
imageURLs  | 
array  | 
Image URLs  | 
(Array item)  | 
string  | 
|
damageCodes  | 
array  | 
|
(Array item)  | 
object  | 
|
code  | 
string  | 
Damage code  Maximum Length:  50  | 
description  | 
string  | 
Damage code description  Maximum Length:  200  | 
19 - I01 Storage Notification
- Status
 - 
Version 2.0 for ERP published 25.04.2023, Version 1.0 for WMS published 12.04.2022
 - Approval
 - 
- 
DeepSea: SST im Worksheet abgestimmt mit Oyster Fachbereich
 - 
NEON: abgestimmt mit Körber zur Umsetzung in NEON_Fein_Pflichtenheft_WEN1_ SST_v6.0
 
 - 
 - Comment
 - 
Die Anbindung von MyToys ist in Planung und im Informationsflussdiagramm mit aufgenommen.
 - Assumption
 - 
Die Avise wird nicht komplett über die SST übertragen sondern die Positionen als StorageNotification
 
1. Stakeholder
| Role | Application | Responsible | 
|---|---|---|
Communication  | 
Integration Layer  | 
|
Leading App  | 
Inbound  | 
|
InterfaceOwner  | 
||
Producer  | 
Oyster  | 
|
Producer  | 
OBS  | 
MyToys  | 
Consumer  | 
FLASH  | 
|
Consumer  | 
kMotion  | 
|
Consumer  | 
KR1  | 
|
Consumer  | 
COBRA  | 
|
Consumer  | 
2. Business Context
Es wird unterschieden zwischen PurchaseOrder als Lieferantenauftrag und einer Avise (Advice). Daneben wird im Rahmen von Deepsea auch eine Einlagerungsauftag aufgebaut. Dieser entspricht unserem Verständnis nach der Avise. Somit beschreibt die Avise eine Anlieferung die bald am Lager ankommen wird. Darin wird auf eine PurchaseOrder verwiesen. Eine PurchaseOrder kann n Avisen haben. Eine Avise kann aus mehreren Lieferscheinen bestehen. Eine Avise kann nach ihrer Art (Type) unterschieden werden Lieferavise, Umfuhr, Retoureavise.
3. Informationflow
4. Interface
4.1. Direction ERP to FINE
4.1.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
type  | 
oyster-goods-receipt-event.PURCHASE_ORDER_CREATE  | 
oyster-goods-receipt-event.PURCHASE_ORDER_UPDATE  | 
|
oyster-goods-receipt-event.PURCHASE_ORDER_CONFIRM  | 
|
oyster-goods-receipt-event.PURCHASE_ORDER_CANCEL  | 
|
context  | 
STORAGE_NOTIFICATION  | 
4.1.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
|
eventId*  | 
string (uuid)  | 
UUID for this event  Minimum Length:  36  | 
traceId*  | 
string (uuid)  | 
UUID for all events in a call hierarchy It's like a order number, the will used for alle activities around the order.  Minimum Length:  36  | 
spanId*  | 
string (uuid)  | 
UUID for all events in a call hierarchy  Minimum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
eventTime*  | 
string (date-time)  | 
Event time  | 
context*  | 
string  | 
The name of the responsible context  Maximum Length:  20  | 
type*  | 
string  | 
Type  | 
sender*  | 
string  | 
Sender  | 
sourceIdentifier*  | 
string  | 
SourceIdentifier  | 
instance  | 
string  | 
Instance  | 
data*  | 
object  | 
|
storageNotificationId*  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
storageNotificationNo*  | 
string  | 
Storage Notification Number  | 
created*  | 
string (date-time)  | 
Created Date  | 
updated*  | 
string (date-time)  | 
Updated Time  | 
partnerId*  | 
string  | 
Partner Id  | 
purchaseOrder*  | 
object  | 
|
orderUUID*  | 
string  | 
Order UUID  | 
orderPositionUUID*  | 
string  | 
Order Position UUID  | 
orderNo*  | 
string  | 
Order Number  | 
location*  | 
string  | 
Storage Location  | 
sourceLocation  | 
string  | 
Source/Original location  Maximum Length:  15  | 
handlingType*  | 
string  | 
Handling Type  | 
supplyLocationCode*  | 
string  | 
Supply Location Code  | 
deliveryDate*  | 
string (date)  | 
Delivery Date  Maximum Length:  10  | 
forecastedWarehouseArrivalDate  | 
string (date)  | 
Forecasted Warehouse Arrival Date  Maximum Length:  10  | 
forecastedBufferedStorageDate  | 
string (date)  | 
Forecasted Buffered Storage Date  Maximum Length:  10  | 
foreignDemandQty  | 
string  | 
Foreign Demand Quantity  | 
planningPeriodCode*  | 
string  | 
Planning Period Code  | 
supplierNo*  | 
string  | 
Supplier Number  | 
orderQty*  | 
number  | 
Order Quantity  | 
fullyDelivered  | 
boolean  | 
Fully delivered  | 
noFurtherStockReceiptsExpected  | 
boolean  | 
No further stock receipts expected  | 
productIdentifier*  | 
object  | 
|
erpProductId*  | 
string  | 
¨Erp Product Id  Maximum Length:  36  | 
FNSKU  | 
string  | 
FNSKU  | 
sku*  | 
string  | 
¨Sku  Maximum Length:  36  | 
itemNo*  | 
string  | 
Item Number  Maximum Length:  16  | 
itemSize*  | 
string  | 
Item Size  Maximum Length:  16  | 
4.1.3. Enumeration
Field: handlingType
| Meta Value | Description | Short Value | 
|---|---|---|
Abwicklungsart OSS  | 
||
wholesale  | 
||
wholesalelight  | 
4.1.4. Example
{
	"eventId": "ba7b43dd-8b4a-46d9-9e3d-03bb3781e06e",
	"traceId": "c24558d1-eb1f-4723-9ab6-d026014e407f",
	"spanId": null,
	"version": "2.0",
	"type": "oyster-goods-receipt-event.PURCHASE_ORDER_CREATE",
	"context": "oyster-goods-receipt-event",
	"eventTime": "2022-03-31T12:41:06.036+0200",
	"sender": "DEEPSEA_OYSTER",
	"sourceIdentifier": "D2PO",
	"data": {
		"storageNotificationId": "305106fa-2068-44b9-bca2-5afaed6f5090",
		"storageNotificationNo": "BlackWarehouse",
		"created": "2022-03-22T09:52:00.000+0100",
		"partnerId": "1234",
		"purchaseOrder": {
			"orderUUID": "189263jdueke6",
			"orderPositionUUID": "djfs73hef",
			"orderNo": "456",
			"location": "ANSBACH",
			"supplierNo": "7890",
			"handlingType": "OSS",
			"supplyLocationCode": "10",
			"orderQty": "10.35",
			"foreignDemandQty": "0.0",
			"deliveryDate": "2022-03-22T00:00:00.000+0100",
			"forecastedWarehouseArrivalDate": "2022-03-22T00:00:00.000+0100",
			"forecastedBufferedStorageDate": "2022-03-22T00:00:00.000+0100",
			"planningPeriodCode": "144"
		},
		"productIdentifier": {
			"sku": "12345",
			"itemSize": "36",
			"itemNo": "51755400",
			"fnsku": null,
			"erpProductId": null
		}
	}
}
4.1.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
2.0  | 
12.04.2022  | 
||
previous version  | 
||||
coming version  | 
4.2. Direction FINE to WMS
4.2.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
type  | 
PURCHASE_ORDER_CREATE  | 
PURCHASE_ORDER_UPDATE  | 
|
PURCHASE_ORDER_CONFIRM  | 
|
PURCHASE_ORDER_CANCEL  | 
|
context  | 
STORAGE_NOTIFICATION  | 
4.2.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
|
eventId*  | 
string (uuid)  | 
UUID for this event  Minimum Length:  36  | 
traceId*  | 
string (uuid)  | 
UUID for all events in a call hierarchy It's like a order number, the will used for alle activities around the order.  Minimum Length:  36  | 
spanId*  | 
string (uuid)  | 
UUID for all events in a call hierarchy  Minimum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
eventTime*  | 
string (date-time)  | 
Event time  | 
context*  | 
string  | 
The name of the responsible context  Maximum Length:  20  | 
type*  | 
string  | 
Type  | 
sender*  | 
string  | 
Sender  | 
sourceIdentifier*  | 
string  | 
SourceIdentifier  | 
instance  | 
string  | 
Instance  | 
data*  | 
object  | 
|
storageNotificationId*  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
storageNotificationNo*  | 
string  | 
Storage Notification Number  | 
createDate*  | 
string (date-time)  | 
Created Date  | 
modifyDate  | 
string (date-time)  | 
Modify Date  | 
partnerId*  | 
string  | 
Partner Id  | 
location*  | 
string  | 
Storage Location  | 
sourceLocation  | 
string  | 
Source/Original location  Maximum Length:  15  | 
purchaseOrder*  | 
object  | 
|
orderUUID*  | 
string  | 
Order UUID  | 
orderPositionUUID*  | 
string  | 
Order Position UUID  | 
orderNumber*  | 
string  | 
Order Number  | 
handlingType*  | 
string  | 
Handling Type  | 
supplyLocationCode*  | 
string  | 
Supply Location Code  | 
deliveryDate*  | 
string (date)  | 
Delivery Date  Maximum Length:  10  | 
forecastedWarehouseArrivalDate  | 
string (date)  | 
Forecasted Warehouse Arrival Date  Maximum Length:  10  | 
forecastedBufferedStorageDate  | 
string (date)  | 
Forecasted Buffered Storage Date  Maximum Length:  10  | 
foreignDemandQty  | 
string  | 
Foreign Demand Quantity  | 
planningPeriodCode*  | 
string  | 
Planning Period Code  | 
supplierNumber*  | 
string  | 
Supplier Number  | 
quantity*  | 
number  | 
Order Quantity  | 
fullyDelivered  | 
boolean  | 
Fully delivered  | 
noFurtherStockReceiptsExpected  | 
boolean  | 
No further stock receipts expected  | 
ownerCompany  | 
string  | 
Owner Company (BDF)  Maximum Length:  30  | 
product*  | 
object  | 
|
logisticProductId*  | 
string  | 
¨Logistic Product Id  Maximum Length:  30  | 
erpProductId*  | 
string  | 
¨Erp Product Id  Maximum Length:  36  | 
FNSKU  | 
string  | 
FNSKU  | 
sku*  | 
string  | 
¨Sku  Maximum Length:  36  | 
itemNumber*  | 
string  | 
Item Number  Maximum Length:  16  | 
itemSize*  | 
string  | 
Item Size  Maximum Length:  16  | 
4.2.3. Enumeration
Field: handlingType
| Meta Value | Description | Short Value | 
|---|---|---|
Abwicklungsart OSS  | 
||
wholesale  | 
||
wholesalelight  | 
4.2.4. Example
{
    "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
    "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
    "spanId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
    "version": "1.0",
    "eventTime": "2018-11-28T08:25:56.523+0000",
    "context": "oyster-goods-receipt-event",
    "type": "PURCHASE_ORDER_CREATE",
    "sender": "fine-inbound",
    "sourceIdentifier": "D2PO",
    "instance": "instance",
    "data": {
      "storageNotificationId": "23548bfa-3d69-4080-90d1-37c4157bbe6a",
      "storageNotificationNo": "BD52FD46S2",
      "createDate": "2022-01-17T14:30:25.523+0000",
      "modifyDate": "2022-01-17T14:30:25.523+0000",
      "partnerId": "10000",
      "location": "ANSBACH",
      "purchaseOrder": {
        "orderUUID": "da087ed3-0802-4c48-bfb8-6f95dd254589",
        "orderPositionUUID": "7db820fb-d61b-4438-ac2d-d0fd8b6d36ca",
        "orderNumber": "57322",
        "handlingType": "WHS",
        "supplyLocationCode": "10",
        "deliveryDate": "2022-01-20",
        "forecastedWarehouseArrivalDate": "2022-01-25",
        "forecastedBufferedStorageDate": "2022-01-26",
        "foreignDemandQty": "0",
        "planningPeriodCode": "145",
        "supplierNumber": "11223",
        "quantity": 10
      },
      "product": {
        "logisticProductId": "123456789",
        "erpProductId": "123456789",
        "FNSKU": "AB12345678",
        "sku": "208d8205-510e-479b-bba1-6d8c3dd99354",
        "itemNumber": "51755400",
        "itemSize": "36"
      }
    }
  }
4.2.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
12.04.22  | 
||
previous version  | 
||||
coming version  | 
20 - I02A Despatch Advice Ramp
- Status
 - 
DRAFT → Dokumentation im Aufbau
 - 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  | 
||
InterfaceOwner  | 
||
Producer  | 
CargoClix  | 
|
Consumer  | 
FLASH  | 
|
Consumer  | 
Oyster  | 
2. Business Context
ramp master data
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 Ramps  | 
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  | 
|
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  | 
bookRampId*  | 
integer  | 
Id of the ramp  | 
rampName*  | 
string  | 
Name of the ramp  | 
rampType  | 
string  | 
Type of the ramp  | 
groupName  | 
string  | 
Ramp group name  | 
rampProcessStateCount*  | 
integer  | 
Number of available process states for a ramp  | 
defaultWeekFreeMinutes  | 
integer  | 
|
active*  | 
boolean  | 
Is the ramp active  | 
4.1.3. Enumeration
4.1.4. Example
4.1.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
23.11.2023  | 
final  | 
|
previous version  | 
||||
coming version  | 
21 - I02B Despatch Advice Ramp Process
- Status
 - 
DRAFT → Dokumentation im Aufbau
 - 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  | 
||
InterfaceOwner  | 
||
Producer  | 
CargoClix  | 
|
Consumer  | 
FLASH  | 
|
Consumer  | 
Oyster  | 
2. Business Context
current ramp data (opening hours, capacities)
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 Ramp Process  | 
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  | 
|
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  | 
bookRampId  | 
integer  | 
Id of the ramp  | 
arrivalSlotStartDateTime  | 
string (date-time)  | 
|
dailyStartTime  | 
string (time)  | 
|
dailyCloseTime  | 
string (time)  | 
|
dailyOpenMinutes  | 
integer  | 
|
dailyCapacityLimitMinutes  | 
integer  | 
|
dailyCapacityLimitKolli  | 
integer  | 
|
bookedMinutes  | 
integer  | 
|
manuallyClosedMinutes  | 
integer  | 
|
manuallyOpenMinutes  | 
integer  | 
|
previous  | 
object  | 
|
arrivalSlotStartDateTime  | 
string (date-time)  | 
|
bookedMinutes  | 
integer  | 
|
manuallyClosedMinutes  | 
integer  | 
|
manuallyOpenMinutes  | 
integer  | 
4.1.3. Enumeration
4.1.4. Example
4.1.5. Schema
Version  | 
Number  | 
File  | 
Published on  | 
Changes  | 
current version  | 
1.0  | 
18.02.2025  | 
added attribute location  | 
|
previous version  | 
1.0  | 
09.01.2025  | 
added attributes arrivalSlotStartDateTime and previous.arrivalSlotStartDateTime  | 
|
previous version  | 
1.0  | 
02.04.2024  | 
dailyStartTime, dailyCloseTime change from date-time to time  | 
|
coming version  | 
22 - 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  | 
23 - I02D Despatch Advice Process State
- Status
 - 
DRAFT → Dokumentation im Aufbau
 - 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  | 
||
InterfaceOwner  | 
||
Producer  | 
CargoClix  | 
|
Consumer  | 
FLASH  | 
|
Consumer  | 
Oyster  | 
|
Consumer  | 
Yard  | 
2. Business Context
process status data for bookings
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 Process State  | 
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  | 
|
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"
]  | 
bookId*  | 
integer  | 
Id of the booking  | 
businessEventDateTime*  | 
string (date-time)  | 
timestamp of business event  | 
processState*  | 
object  | 
|
number*  | 
integer  | 
|
name*  | 
string  | 
4.1.3. Enumeration
4.1.4. Example
24 - I03 Delivery Note
- Status
 - 
Version 1.0 published 12.04.2022
 
1. Stakeholder
| Role | Application | Responsible | 
|---|---|---|
Communication  | 
Integration Layer  | 
|
Leading App  | 
Inbound  | 
|
InterfaceOwner  | 
||
Producer  | 
Oyster  | 
|
Consumer  | 
FLASH  | 
|
Consumer  | 
kMotion  | 
|
Consumer  | 
KR1  | 
|
Consumer  | 
COBRA  | 
2. Business Context
Die DeliveryNote beschreibt das Geschäftsobjekt, welches den elektronische Lieferschein enthält. Dabei gibt es Kopf- und Positionsdaten. (elektronischer) Lieferschein - Begleitdokument für die bewegte Ware
3. Informationflow
4. Interface
4.1. Direction ERP to FINE
4.1.1. Header
This interface uses the Service Header
4.1.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
ElectronicDeliveryNoteErp  | 
eventId*  | 
string  | 
The uniqe eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "GOODSIN_SUPPLIER",
  "GOODSIN_DLW"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "CREATE",
  "UPDATE",
  "DELETE"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string (enum)  | 
sender  Any of:  [
  "BUBE",
  "COBRA",
  "CORE",
  "FINE_INBOUND",
  "IDEEFIX",
  "KMOTION_ILOWA",
  "KMOTION_GERNSHEIM",
  "KR1_SUEDHAFEN",
  "KR1_HALDENSLEBEN",
  "KR1_HAMBURGERSTRASSE",
  "LDH",
  "LIGIS",
  "LSAS",
  "OBS",
  "RESY",
  "RETAILSCHICHT",
  "WMSX_AKU",
  "WMSX_SONNEFELD",
  "WMSX_WEISMAIN",
  "F2X"
]  | 
data*  | 
object  | 
|
location*  | 
string (enum)  | 
The target warehouse  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",
  "NORD_LOGISTIC"
]  | 
deliveryNoteId*  | 
string  | 
Delivery note id  Maximum Length:  36  | 
deliveryNoteNumber*  | 
string  | 
Delivery note number  Maximum Length:  36  | 
totalContainerQuantity  | 
integer  | 
Total container quantity  Maximum Length:  4  | 
createdTime*  | 
string (date-time)  | 
Created time  | 
updatedTime*  | 
string (date-time)  | 
Updated time  | 
plannedDeliveryTime  | 
string (date-time)  | 
Planned delivery time  | 
freightForwarder  | 
string  | 
Carrier forwarding  Maximum Length:  50  | 
origin  | 
string  | 
Origin/source of the data. Possible values are: SLOT_BOOKING, EDI, EDI_SUPPLYX, DLW_EDI, DLW_DIVA  Maximum Length:  50  | 
positions*  | 
array  | 
Positionen  Minimum number of items  1  | 
(Array item)  | 
object  | 
|
deliveryNotePositionId*  | 
string  | 
Delivery note position id  Maximum Length:  36  | 
erpProductId*  | 
string  | 
ERP Product Id  Maximum Length:  36  | 
quantity*  | 
number  | 
Quantity  | 
supplierNumber*  | 
integer  | 
Supplier number  Maximum Length:  6  | 
erpSupplierId*  | 
string  | 
ERP Supplier Id  Maximum Length:  36  | 
orderNumber*  | 
integer  | 
Order number  Maximum Length:  11  | 
storageNotificationId  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
sscc  | 
string  | 
Serial shipping contaner code  Maximum Length:  18  | 
handlingType  | 
string (enum)  | 
Delivery type code  Any of:  [
  "OSS",
  "WHS",
  "WHL"
]  | 
customsProcedure  | 
string (enum)  | 
Customs procedure  Any of:  [
  "CUSTOMS_WAREHOUSE_GOODS",
  "FREE"
]  | 
industrialDay  | 
integer  | 
Industrial day  Maximum Length:  3  | 
parts  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
partNumber*  | 
integer  | 
Part number  Maximum Length:  2  | 
barcode*  | 
string  | 
Barcode  Maximum Length:  36  | 
4.1.3. Enumeration
4.1.4. Example
{
  "eventId": "00ce536f-923a-42f4-8128-be118faf1d85",
  "traceId": "00ce536f-923a-42f4-8128-be118faf1d85",
  "eventTime": "2025-09-31T12:41:06.036+01:00",
  "version": "3.0",
  "context": "GOODSIN_SUPPLIER",
  "eventType": "CREATE",
  "metaData" : {
    "sender": "DEEPSEA_OYSTER"
  },
  "data": {
    "location": "OHRDRUF",
    "deliveryNoteId": "69571695-1814-4771-b097-6091f8b5d8e4",
    "deliveryNoteNumber": "347669",
    "totalContainerQuantity": 75,
    "createdTime": "2025-09-31T12:41:06.036+01:00",
    "updatedTime": "2025-09-31T12:41:06.036+01:00",
    "plannedDeliveryTime": "2025-12-21T12:41:06.036+01:00",
    "freightForwarder": "Unisped Logistik GmbH",
    "origin": "SLOT_BOOKING",
    "positions": [
      {
        "deliveryNotePositionId": "162d18ce-c31b-45b7-a75d-3c2de5cb1303",
        "erpProductId": "01906cb6-87c0-4853-9156-ce738f12843a",
        "quantity": 42,
        "supplierNumber": 67850,
        "erpSupplierId": "OTTO_67850",
        "orderNumber": 56140,
        "storageNotificationId": "305106fa-2068-44b9-bca2-5afaed6f5090",
        "sscc": "2138501847",
        "handlingType": "OSS",
        "customsProcedure": "FREE"
      }
    ]
  }
}
4.2. Direction FINE to WMS
4.2.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
context  | 
DELIVERY_NOTE  | 
type  | 
CREATE UPDATE STORNO  | 
4.2.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
DeliveryNote  | 
eventId*  | 
string (uuid)  | 
UUID for this event  Minimum Length:  36  | 
traceId*  | 
string (uuid)  | 
UUID for all events in a call hierarchy  Minimum Length:  36  | 
spanId*  | 
string (uuid)  | 
UUID for all events in a call hierarchy  Minimum Length:  36  | 
eventTime*  | 
string (date-time)  | 
the date and time, when this event occured as an ISO-8601 timestamp.  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context*  | 
string  | 
The name of the responsible context  Maximum Length:  20  | 
type*  | 
string  | 
the event type that triggers this event  Maximum Length:  20  | 
sender*  | 
string  | 
The sending system  Maximum Length:  20  | 
sourceIdentifier*  | 
string  | 
SourceIdentifier  | 
data*  | 
object  | 
|
deliveryNoteId*  | 
string  | 
deliveryNoteId  Maximum Length:  36  | 
deliveryNoteNumber*  | 
string  | 
Die Belegnummer des Lieferscheins  Maximum Length:  36  | 
deliveryNoteStatus*  | 
string  | 
deliveryNoteStatus  Maximum Length:  10  | 
location*  | 
string  | 
Electronic delivery Location  | 
createDate*  | 
string (date-time)  | 
createDate  | 
modifyDate*  | 
string (date-time)  | 
modifyDate  | 
shippingDate*  | 
string (date-time)  | 
shippingDate  | 
plannedDeliveryDate  | 
string (date-time)  | 
plannedDeliveryDate  | 
totalCartonQty*  | 
integer  | 
totalCartonQty  Maximum Length:  4  | 
collectionAddress  | 
string  | 
collectionAddress  Maximum Length:  35  | 
package  | 
object  | 
|
weight  | 
object  | 
weight  | 
value*  | 
number  | 
|
unit*  | 
string  | 
|
volume  | 
object  | 
volume  | 
value*  | 
number  | 
|
unit*  | 
string  | 
|
carrierForwarding  | 
string  | 
carrierForwarding  Maximum Length:  35  | 
positions*  | 
array  | 
Positions  Minimum number of items  1  | 
(Array item)  | 
object  | 
|
deliveryNotePositionId*  | 
string  | 
deliveryNotePositionId  Maximum Length:  36  | 
deliveryNotePositionStatus*  | 
string  | 
deliveryNotePositionStatus  Maximum Length:  10  | 
createDate*  | 
string (date-time)  | 
createDate  | 
modifyDate*  | 
string (date-time)  | 
modifyDate  | 
product*  | 
object  | 
|
logisticProductId*  | 
integer  | 
logisticProductId  Maximum:  1000000000000000000  | 
itemNumber*  | 
integer  | 
ItemNumber  Maximum Length:  16  | 
itemSize*  | 
string  | 
ItemSize  Maximum Length:  16  | 
itemSizeBin*  | 
integer  | 
ItemSizeBin  | 
quantity*  | 
number  | 
quantity  | 
supplierNumber*  | 
integer  | 
supplierNumber  Maximum Length:  6  | 
purchaseOrderNumber*  | 
integer  | 
purchaseOrderNumber  Maximum Length:  6  | 
shippingUnitNumber  | 
integer  | 
shippingUnitNumber  Maximum Length:  18  | 
containerType  | 
string  | 
containerType  Maximum Length:  70  | 
containerNumber  | 
string  | 
containerNumber  | 
hermesTMPPosNr  | 
string  | 
hermesTMPPosNr  Maximum Length:  70  | 
customsProcedure  | 
string  | 
customsProcedure  Maximum Length:  70  | 
hAwbBl  | 
string  | 
hAwbBl  Maximum Length:  70  | 
deliveryTypeCode*  | 
string  | 
deliveryTypeCode  Maximum Length:  1  | 
ovaValInfo  | 
integer  | 
ovaValInfo  Maximum Length:  1  | 
additionalInformation  | 
object  | 
|
originalItemNumber  | 
integer  | 
originalItemNumber  Maximum Length:  8  | 
originalItemSize  | 
string  | 
originalItemSize  Maximum Length:  7  | 
ean  | 
integer  | 
ean  Maximum Length:  13  | 
originalOva  | 
integer  | 
originalOva  Maximum Length:  6  | 
errorCode  | 
string  | 
errorCode  | 
errorMessage  | 
string  | 
errorMessage  | 
4.2.3. Enumeration
Field: deliveryTypeCode
| Meta Value | Description | Short Value | 
|---|---|---|
OTTO_MARKET  | 
O  | 
|
WHOLE_SALE  | 
WHLS  | 
|
WHOLE_SALE_LIGHT  | 
_  | 
Field: ovaValidationInfo
| Meta Value | Description | Short Value | 
|---|---|---|
ORGINAL  | 
Orginal  | 
1  | 
MODIFED  | 
Modifed at Validation  | 
2  | 
4.2.4. Example
{
  "eventId": "00ce536f-923a-42f4-8128-be118faf1d87",
  "traceId": "00ce536f-923a-42f4-8128-be118faf1d85",
  "spanId": "null",
  "eventTime": "2022-03-31T12:41:06.036+0200",
  "version": "1.0",
  "context": "TRANSFER_ELS",
  "type": "CREATE",
  "sender": "ZS",
  "sourceIdentifier": "FINE-ELS",
  "data": {
    "deliveryNoteId": "69571695-1814-4771-b097-6091f8b5d8e4",
    "deliveryNoteNumber": "347669",
    "deliveryNoteStatus": "validated",
    "location": "LOEHNE",
    "createDate": "2022-03-31T12:41:06.036+0200",
    "modifyDate": "2022-03-31T12:41:06.036+0200",
    "shippingDate": "2022-03-31T12:41:06.036+0200",
    "plannedDeliveryDate": "2022-03-31T00:00:00.000+0200",
    "totalCartonQty": 4,
    "collectionAddress": "Dradenauer Deichweg 5, Hamburg",
    "package": {
      "weight": {
        "value": 2583,
        "unit": "kg"
      },
      "volume": {
        "value": 13.312,
        "unit": "m3"
      }
    },
    "carrierForwarding": "Unisped Logistik GmbH",
    "positions": [
      {
        "deliveryNotePositionId": "162d18ce-c31b-45b7-a75d-3c2de5cb1303",
        "deliveryNotePositionStatus": "validated",
        "createDate": "2022-03-31T12:41:06.036+0200",
        "modifyDate": "2022-03-31T12:41:06.036+0200",
        "product": {
          "logisticProductId": 1234567895241478,
          "itemNumber": 25724443,
          "itemSize": "M",
          "itemSizeBin": 905
        },
        "quantity": 42.0,
        "supplierNumber": 40411,
        "purchaseOrderNumber": 12802,
        "shippingUnitNumber": 340070601330298816,
        "containerType": "WAB",
        "containerNumber": "415396",
        "hermesTMPPosNr": "H119080851",
        "customsProcedure": "ZL",
        "hAwbBl": "SL30094406",
        "deliveryTypeCode": "_",
        "ovaValInfo": 1,
        "additionalInformation": {
          "originalItemNumber": 22445566,
          "originalItemSize": "S",
          "ean": 192564537341,
          "originalOva": 12345,
          "errorCode": "x",
          "errorMessage": "x"
        }
      }
    ]
  }
}
4.2.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
12.04.2022  | 
||
previous version  | 
||||
coming version  | 
25 - I04 Goods In
- Status
 - 
2.2 current version published 10.10.2024
 - Approval
 - 
- 
DeepSea: approved
 - 
FLASH: approved
 - 
F2X: approved
 - 
NEON: approved
 - 
KR1: approved
 - 
COBRA: approved
 - 
WITT: approved
 
 - 
 - Comment
 - Assumption
 - 
.
 
1. Stakeholder
| Role | Application | Responsible | 
|---|---|---|
Communication  | 
Integration Layer  | 
|
Leading App  | 
Inbound  | 
|
InterfaceOwner  | 
||
Producer  | 
kMotion  | 
|
Producer  | 
KR1  | 
|
Producer  | 
COBRA  | 
|
Consumer  | 
F2X  | 
|
Consumer  | 
Oyster  | 
|
Consumer  | 
FLASH  | 
|
Consumer  | 
WITT  | 
2. Business Context
Die Wareneingänge beschreiben den Belegfluss des Wareneingangs und beinhalten Informationen zum Abgleich zwischen Lieferschein- und Kollierfassung, Lieferscheinmengen, Tournummern, Bestellungen, Lieferanten, Qualitätssicherung usw.
Für die einzelnen Prozessevents werden Messages versendet:
- 
Ende Lieferscheinerfassung (WE1) → DELIVERY_NOTE_REGISTRATION_END
 - 
Start Warenvereinnahmung → keine Positionen gefüllt → GOODSRECEIPT_START
 - 
Ende Warenvereinnahmung (WE1.2) → GOODSRECEIPT_END
 - 
Start Differenzenabgleich → DELIVERY_COMPARISON_START
 - 
Ende Differenzenabgleich (WE1.5) → DELIVERY_COMPARISON_END
 - 
Warenfreischaltung (WE2) → RELEASE_END
 
Bei den Start-Events sollen nur Kopfdaten übermittelt werden, bei den End-Events sollen auch die Positionen übermittelt werden.
3. Informationflow
4. Interface
4.1. Direction WMS to FINE
4.1.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
eventType  | 
DELIVERY_NOTE_REGISTRATION_END GOODSRECEIPT_START GOODSRECEIPT_END DELIVERY_COMPARISON_START DELIVERY_COMPARISON_END RELEASE_END  | 
context  | 
GOODS_IN  | 
4.1.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
WMS goods receipt messages  | 
eventId*  | 
string  | 
The unique eventId  | 
traceId*  | 
string  | 
The unique traceId  | 
spanId*  | 
string  | 
The eventId of previous record or batchId  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
The number of version schema  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "GOODS_IN"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "DELIVERY_NOTE_REGISTRATION_END",
  "GOODSRECEIPT_START",
  "GOODSRECEIPT_END",
  "DELIVERY_COMPARISON_START",
  "DELIVERY_COMPARISON_END",
  "RELEASE_END"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string (enum)  | 
sender  Any of:  [
  "BUBE",
  "COBRA",
  "CORE",
  "FINE_INBOUND",
  "IDEEFIX",
  "KMOTION_ILOWA",
  "KMOTION_GERNSHEIM",
  "KR1_SUEDHAFEN",
  "KR1_HALDENSLEBEN",
  "KR1_HAMBURGERSTRASSE",
  "LDH",
  "LIGIS",
  "LSAS",
  "OBS",
  "RESY",
  "RETAILSCHICHT",
  "WMSX_AKU",
  "WMSX_SONNEFELD",
  "WMSX_WEISMAIN",
  "F2X"
]  | 
client  | 
string  | 
client  | 
instance  | 
string  | 
Software instance of producing system  | 
data*  | 
object  | 
 Additional Properties:  false  | 
location*  | 
string (enum)  | 
The sending warehouse  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",
  "NORD_LOGISTIC"
]  | 
businessEventTime*  | 
string (date-time)  | 
The date and time, when the business event occurred  | 
goodsInId*  | 
string  | 
the goods receipt ID  Maximum Length:  36  | 
originalGoodsInId  | 
string  | 
the original goods receipt ID  Maximum Length:  36  | 
deliveryNumber*  | 
string  | 
the inbound delivery business key  Maximum Length:  36  | 
deliveryTypeCode  | 
string  | 
Identification of the type of entry/delivery  Maximum Length:  50  | 
deliveryType*  | 
string (enum)  | 
Type of the delivery  Any of:  [
  "GOODSIN_SUPPLIER",
  "GOODSIN_FROM_REWORK",
  "GOODSIN_FOR_BOOKING_AND_RELEASE",
  "GOODSIN_FOR_REMOVAL",
  "GOODSIN_INCOMPLETE",
  "GOODSIN_DLW",
  "GOODSIN_FOR_RELEASE",
  "GOODSIN_POST_PROCESSING",
  "GOODSIN_FROM_MAPPER",
  "GOODSIN_SECOND_CHOICE",
  "GOODSIN_STATIONARY_TRADE",
  "GOODSIN_SMALLPARTS",
  "GOODSIN_CANCELATION",
  "GOODSIN_RELABEL",
  "GOODSIN_B2B",
  "GOODSIN_FROM_RETAIL",
  "GOODSIN_3RD_PARTY"
]  | 
carrier  | 
string  | 
name of the carrier transporting goods  Maximum Length:  100  | 
gates  | 
array  | 
|
(Array item)  | 
object  | 
|
door  | 
string  | 
Gate or Door number  Maximum Length:  10  | 
building  | 
string  | 
Building  Maximum Length:  3  | 
processingInformation  | 
array  | 
|
(Array item)  | 
object  | 
 Additional Properties:  false  | 
goodsReceiptProcessingType*  | 
string (enum)  | 
Pallets/hatch detection  Any of:  [
  "PALLETED_SORTED",
  "PALLETED_UNSORTED",
  "CARTONS_SORTED",
  "CARTONS_UNSORTED",
  "SANDWICH_PALLET",
  "PULK_2MH",
  "DLW",
  "ITEMS_UNSORTED",
  "ITEMS_UNSORTED_FROM_KEP",
  "CARTONS_UNSORTED_FROM_KEP",
  "NON_TRADE_ITEMS"
]  | 
goodsReceiptProcessingCode*  | 
string  | 
Pallet/hatch detection code  | 
quantity  | 
integer  | 
Quantity received for this processing type  Minimum:  0  | 
positions  | 
array  | 
|
(Array item)  | 
object  | 
 Additional Properties:  false  | 
deliveryPositionId*  | 
string  | 
Position Id  Maximum Length:  36  | 
deliveryPositionNumber  | 
integer  | 
Position number  Maximum:  99999999999999  | 
quantity*  | 
integer  | 
Quantity received  Minimum:  0  | 
arrivedToReworkerQuantity  | 
integer  | 
Quantity received by the external reworker  Minimum:  0  | 
destroyedByReworkerQuantity  | 
integer  | 
Quantity destroyed by the external reworker  Minimum:  0  | 
loadingUnitQuantity  | 
integer  | 
Amount of goods  Minimum:  0  | 
supplierNumber*  | 
integer  | 
Supplier Number  Maximum:  9999999  | 
reworkerSupplierNumber  | 
integer  | 
External reworker supplier number  Maximum:  9999999  | 
documentNumber*  | 
integer  | 
Document number  Minimum:  100000  | 
ownerCompany*  | 
string  | 
Owner Company (BDF)  Maximum Length:  30  | 
hermesTourNumber  | 
string  | 
Hermes number  Maximum Length:  12  | 
customsShipmentNumber  | 
string  | 
Custom shipment Number  | 
airWayBill  | 
string  | 
Custom shipment Number  Maximum Length:  30  | 
positionDetails  | 
array  | 
|
(Array item)  | 
object  | 
 Additional Properties:  false  | 
purchaseOrderNumber*  | 
string  | 
Purchase Order Number  Maximum Length:  36  | 
deliveryNoteNumber  | 
string  | 
Delivery Note Number  Maximum Length:  36  | 
storageNotificationId  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
quantity  | 
number  | 
the quantity of the referenced PositionDetail within the position  | 
electronicDeliveryNotePositionId  | 
array  | 
Electronic Delivery Note Position  | 
(Array item)  | 
string  | 
|
deliveryPositionDetailId  | 
string  | 
Position Detail Id  Maximum Length:  36  | 
sourceLocation  | 
string  | 
Source/Original location  Maximum Length:  15  | 
product*  | 
object  | 
 Additional Properties:  false  | 
logisticsProductId*  | 
string  | 
Logistics Product Id  Maximum Length:  36  | 
qualityCheck  | 
string (enum)  | 
Type of Quality Check  Any of:  [
  "NO_QUALITY_CHECK",
  "NORMAL_QUALITY_CHECK",
  "DOWNSTREAM_QUALITY_CHECK"
]  | 
qualityCode  | 
integer  | 
Quantity code number Goods inspection  Maximum:  999  | 
damagedQuantity  | 
integer  | 
Quantity items damaged  Maximum:  999999  | 
processEndDate  | 
string  | 
Process End Date  | 
processEndCode  | 
string (enum)  | 
Process End Code  Any of:  [
  "RELEASE",
  "CANCELLATION",
  "RETURN",
  "REWORK",
  "DESTROY",
  "THIRD_PARTY_SALE"
]  | 
erpDeliveryNo  | 
string  | 
Erp Deliver Number  | 
qualitySampleRequestMode  | 
string (enum)  | 
Sample size calculation mode  Any of:  [
  "ONLINE",
  "OFFLINE"
]  | 
qualitySampleDischargeMode  | 
string (enum)  | 
Direktausschleusung  Any of:  [
  "IMMEDIATE",
  "DEFERRED",
  "CONVERTED"
]  | 
deliveryComparisonResult  | 
string (enum)  | 
Comparison result  Any of:  [
  "DIFFERENCE",
  "NO_DIFFERENCE",
  "NO_COMPARISON"
]  | 
4.1.3. Enumeration
Field: Event Type
| Meta Value | Description | Short Value | 
|---|---|---|
DELIVERY_NOTE_REGISTRATION_END  | 
WE1.0 Ende  | 
|
GOODSRECEIPT_START  | 
WE1.2 Start  | 
|
GOODSRECEIPT_END  | 
WE1.2 Ende  | 
|
DELIVERY_COMPARISON_START  | 
WE1.5 Start  | 
|
DELIVERY_COMPARISON_END  | 
WE1.5 Ende  | 
|
RELEASE_END  | 
WE2.0 Ende  | 
Field: Context
| Meta Value | Description | Short Value | 
|---|---|---|
GOODS_IN  | 
Wareneingang Neuware  | 
Field: Delivery Type
| Meta Value | Description | Short Value | 
|---|---|---|
GOODSIN_SUPPLIER  | 
WE vom Lieferanten  | 
|
GOODSIN_FROM_REWORK  | 
WE aus Nachbearbeitung  | 
|
GOODSIN_FOR_BOOKING_AND_RELEASE  | 
WE ohne Ware (zur Freischaltung mit LIB)  | 
|
GOODSIN_FOR_REMOVAL  | 
WE ohne Ware (zur Ausbuchung)  | 
|
GOODSIN_INCOMPLETE  | 
Inkomplette Anlieferungen  | 
|
GOODSIN_DLW  | 
DLW Anlieferung  | 
|
GOODSIN_FOR_RELEASE  | 
WE ohne Ware (zur Freischaltung ohne LIB)  | 
|
GOODSIN_POST_PROCESSING  | 
WE zur Aufbereitung  | 
|
GOODSIN_FROM_MAPPER  | 
Anlieferung aus Mapper  | 
|
GOODSIN_SECOND_CHOICE  | 
Anlieferung 2. Wahl  | 
|
GOODSIN_STATIONARY_TRADE  | 
WE ohne Ware für Stationärhandel  | 
|
GOODSIN_SMALLPARTS  | 
OSS-Anlieferung  | 
|
GOODSIN_CANCELATION  | 
WE aus Storno  | 
|
GOODSIN_RELABEL  | 
WE aus Neuauszeichnung  | 
|
GOODSIN_B2B  | 
WE aus Großkundenabzug  | 
|
GOODSIN_FROM_RETAIL  | 
WE Rückführung aus Filialen  | 
|
GOODSIN_3RD_PARTY  | 
WE aus Rückführung Drittgeschäft  | 
Field: Goods Receipt Processing
| Meta Value | Description | Short Value | 
|---|---|---|
PALLETED_SORTED  | 
Palettiert einlagerungsfähig/sortenrein  | 
|
PALLETED_UNSORTED  | 
Palettiert unsortiert/Mischpalette  | 
|
CARTONS_SORTED  | 
Sortenreine Kartons  | 
|
CARTONS_UNSORTED  | 
Mischkartons/lose angeliefert  | 
|
SANDWICH_PALLET  | 
Sandwichpalette  | 
|
PULK_2MH  | 
Pulkanlieferung 2MH  | 
|
DLW  | 
Durchlaufware  | 
|
ITEMS_UNSORTED  | 
Mischanlieferung Item/Schuhe  | 
|
ITEMS_UNSORTED_FROM_KEP  | 
Mischanlieferung Item/Schuhe (von KEP). KEP = Kurier-, Express- und Paketdienste-Dienstleister  | 
|
CARTONS_UNSORTED_FROM_KEP  | 
Mischanlieferung Kartons (von KEP). KEP = Kurier-, Express- und Paketdienste-Dienstleister  | 
|
NON_TRADE_ITEMS  | 
Anlieferung von Verbrauchs- und Verpackungsmaterial  | 
Field: Quality Check
| Meta Value | Description | Short Value | 
|---|---|---|
NO_QUALITY_CHECK  | 
ohne Prüfung  | 
|
NORMAL_QUALITY_CHECK  | 
mit Prüfung  | 
|
DOWNSTREAM_QUALITY_CHECK  | 
nachgelagerte Prüfung  | 
Field: Process End Code
| Meta Value | Description | Short Value | 
|---|---|---|
RELEASE  | 
Freischaltung  | 
|
RETURN  | 
Warenrücksendung  | 
|
REWORK  | 
Nachbearbeitung  | 
|
CANCELLATION  | 
Storno  | 
|
DESTROY  | 
Verschrottung  | 
|
THIRD_PARTY_SALE  | 
Verkauf an dritte  | 
Field: Quality Sample Request Mode
| Meta Value | Description | Short Value | 
|---|---|---|
ONLINE  | 
WACH/LIGIS  | 
|
OFFLINE  | 
Vom LVS ermittelt  | 
Field: Quality Sample Discharge Mode
| Meta Value | Description | Short Value | 
|---|---|---|
IMMEDIATE  | 
sofort/vorgelagert  | 
|
DEFERRED  | 
nachgelagert  | 
|
CONVERTED  | 
umgewandelt  | 
Field: Delivery Comparison Result
| Meta Value | Description | Short Value | 
|---|---|---|
DIFFERENCE  | 
Abgleich mit Differenz  | 
|
NO_DIFFERENCE  | 
Abgleich ohne Differenz  | 
|
NO_COMPARISON  | 
Abgleich noch nicht erfolgt  | 
4.1.4. Example
{
    "eventId": "00ce536f-923a-42f4-8128-be118faf1d87",
    "traceId": "00ce536f-923a-42f4-8128-be118faf1d85",
    "spanId": "00ce536f-923a-42f4-8128-be118faf1d85",
    "eventTime": "2022-03-31T12:41:06.036+01:00",
    "version": "2.3",
    "context": "GOODS_IN",
    "eventType": "RELEASE_END",
    "metaData" : {
        "sender": "FINE_INBOUND",
        "client": "FBO",
        "instance": "ILO_INT2"
    },
    "data": {
        "location": "ILOWA",
        "businessEventTime": "2022-03-31T12:41:06.036+01:00",
        "goodsInId": "1368329",
        "deliveryNumber": "1189582",
        "deliveryTypeCode": "1",
        "deliveryType": "GOODSIN_SUPPLIER",
        "carrier": "Hermes Germany",
        "gates": [
            {
                "building": "1",
                "door": "8"
            }
        ],
        "processingInformation": [
            {
                "goodsReceiptProcessingType": "PALLETED_SORTED",
                "goodsReceiptProcessingCode": "W",
                "quantity": 12
            }
        ],
        "positions": [
            {
                "deliveryPositionId": "123123",
                "deliveryPositionNumber": 123456,
                "quantity": 90,
                "loadingUnitQuantity": 9,
                "supplierNumber": 648052,
                "reworkerSupplierNumber": 588411,
                "documentNumber": 483512,
                "ownerCompany": "OTTO",
                "hermesTourNumber": "SGH222010043",
                "customsShipmentNumber": "",
                "airWayBill": "",
                "positionDetails": [
                    {
                        "purchaseOrderNumber": "105791",
                        "deliveryNoteNumber": "22020176_648052",
                        "storageNotificationId": "",
                        "quantity": 90,
                        "electronicDeliveryNotePositionId": [
                            "HG_22020176_648052",
                            "LSB_12345667_987654332"
                        ],
                        "deliveryPositionDetailId": "51984510"
                    }
                ],
                "product": {
                    "logisticsProductId": "1245874412"
                },
                "qualityCheck": "DOWNSTREAM_QUALITY_CHECK",
                "qualityCode": 100,
                "damagedQuantity": 0,
                "processEndDate": "2023-04-16",
                "processEndCode": "RELEASE",
                "erpDeliveryNo": "3291147085",
                "qualitySampleRequestMode": "ONLINE",
                "qualitySampleDischargeMode": "DEFERRED",
                "deliveryComparisonResult": "DIFFERENCE"
            }
        ]
    }
}
4.1.5. Version history
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
planned version  | 
2.3  | 
11.04.2025  | 
Siehe Kapitel Changelog weiter unten  | 
|
current version  | 
2.2  | 
10.10.2024  | 
Siehe Kapitel Changelog weiter unten  | 
|
previous version  | 
2.1  | 
13.12.2023  | 
Siehe Kapitel Changelog weiter unten  | 
|
previous version  | 
2.0  | 
11.04.2023  | 
Siehe Kapitel Changelog weiter unten  | 
|
previous version  | 
1.0  | 
26.05.2022  | 
- die Länge des Feldes “type” im Header hat sich von 20 auf 32 Zeichen geändert  | 
|
previous version  | 
1.0  | 
09.05.2022  | 
- das Datums-Format an den Feldern eventTime und businessEventTime hat sich geändert: das korrekte Format sieht so aus: 2022-03-31T12:41:06.036+0200 - wir haben die Versionsnummer angepasst bzw. das Versionierungskonzept umgesetzt. Die aktuelle SST-Version ist: „1.0“ - es wurden die Pflichtfelder am Header entsprechend hinterlegt. Diese Felder sind jetzt auch laut JSON Schema immer mitzuschicken: (eventId, traceId, spanId, version, eventTime, context, type, sender, sourceIdentifier) - die Dokumentation direkt am JSON Schema wurde ergänzt, Beschreibungen, Beispiele wurden hinzugefügt.  | 
4.1.6. Changelog
Changes V2.2 → V2.3
- 
New values added to the ENUM deliveryType: GOODSIN_B2B, GOODSIN_FROM_RETAIL, GOODSIN_3RD_PARTY
 - 
New optional attribute sourceLocation was added
 
Changes V2.1 → V2.2
- 
Company ENUM was removed from the attributes: client, ownerCompany
 - 
New optional attribute reworkerSupplierNumber was added: the external reworker as supplier
 - 
New ENUM value "NO_COMPARISON" was added for the existing attribute deliveryComparisonResult. Meaning: there was no comparison yet.
 - 
New optional attributes were added: arrivedToReworkerQuantity, destroyedByReworkerQuantity.
 
Changes V2.0 → V2.1
- 
upgraded ENUM company from V4 to V6
 - 
optional attribute metaData.instance was added to the header
 - 
optional attributes itemNumber and itemSize were removed
 - 
mandatory attribute logisticsProductId was added to the FINE-ERP interface
 - 
3 new optional attributes have been introduced: qualitySampleRequestMode, qualitySampleDischargeMode, deliveryComparisonResult
 - 
optional attribute deliveryPositionDetailId has been added
 
Changes V1.0 → V2.0
- 
Standard header: The Standard header has been changed to the current standard header with following changes:
- 
"eventTime" is to be sent in local time. Format: yyyy-MM-dd’T’HH:mm:ss.SSSXXX Example: 2023-04-12T16:06:05.036+01:00
 - 
the attributes: "sourceIdentifier", "instance", "messageNumber", "lastMessageNumber" have been removed
 - 
the attribute "type" has been renamed to "eventType" and an enum has been introduced
 - 
for the attribute "context" an enum has been introduced
 - 
the attributes "sender" and "client" have been moved to the new object type "metaData"
 
 - 
 - 
Payload (Data)
- 
for the attribute "location" an enum has been introduced
 - 
"businessEventTime" is to be sent in local time. Format: yyyy-MM-dd’T’HH:mm:ss.SSSXXX Example: 2023-04-12T16:06:05.036+01:00
 - 
the attribute "type" has been renamed to "deliveryType" and an enum has been introduced
 - 
the attribute "typeCode" has been renamed to "deliveryTypeCode"
 - 
the attributes "goodsReceiptProcessing" and "goodsReceiptProcessingCode" have been moved to the new array "processingInformation"
 - 
"goodsReceiptProcessing" has been renamed to "goodsReceiptProcessingType"
 - 
the new array is optional but if present, then "goodsReceiptProcessingType" and "goodsReceiptProcessingCode" have to be provided
 - 
besides of the old attributes "goodsReceiptProcessingType" and "goodsReceiptProcessingCode" a new optional attribute "quantity" has been introduced
 - 
for the attribute "goodsReceiptProcessingType" an enum has been introduced
 - 
the attribute "positionId" has been renamed to "deliveryPositionId"
 - 
the attribute "positionNumber" has been renamed to "deliveryPositionNumber"
 - 
the attribute "logisticProductId" has been renamed to "logisticsProductId" (change only in the WMS interface)
 - 
the attribute "sku" has been removed
 - 
for the attribute "qualityCheck" an enum has been introduced
 - 
for the attribute "processEndCode" an enum has been introduced
 - 
new attributes have been introduced: "originalGoodsInId" (optional), "carrier" (optional), ownerCompany (mandatory)
 
 - 
 
Hint: The "…Code" attributes should be filled with the WMS specific codes also known by the users in the warehouse. These will be presented in the data mart reports (BI). Here no enum will be defined as this code is WMS specific.
4.2. Direction FINE to ERP
4.2.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
type  | 
DELIVERY_NOTE_REGISTRATION_END GOODSRECEIPT_START GOODSRECEIPT_END DELIVERY_COMPARISON_START DELIVERY_COMPARISON_END RELEASE_END  | 
context  | 
GOODS_IN  | 
4.2.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
ERP goods receipt messages  | 
eventId*  | 
string  | 
The unique eventId  | 
traceId*  | 
string  | 
The unique traceId  | 
spanId*  | 
string  | 
The eventId of previous record or batchId  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
The number of version schema  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "GOODS_IN"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "DELIVERY_NOTE_REGISTRATION_END",
  "GOODSRECEIPT_START",
  "GOODSRECEIPT_END",
  "DELIVERY_COMPARISON_START",
  "DELIVERY_COMPARISON_END",
  "RELEASE_END"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string (enum)  | 
sender  Any of:  [
  "BUBE",
  "COBRA",
  "CORE",
  "FINE_INBOUND",
  "IDEEFIX",
  "KMOTION_ILOWA",
  "KMOTION_GERNSHEIM",
  "KR1_SUEDHAFEN",
  "KR1_HALDENSLEBEN",
  "KR1_HAMBURGERSTRASSE",
  "LDH",
  "LIGIS",
  "LSAS",
  "OBS",
  "RESY",
  "RETAILSCHICHT",
  "WMSX_AKU",
  "WMSX_SONNEFELD",
  "WMSX_WEISMAIN",
  "F2X"
]  | 
client  | 
string  | 
client  | 
instance  | 
string  | 
Software instance of producing system  | 
data*  | 
object  | 
 Additional Properties:  false  | 
location*  | 
string (enum)  | 
The sending warehouse  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",
  "NORD_LOGISTIC"
]  | 
businessEventTime*  | 
string (date-time)  | 
The date and time, when the business event occurred  | 
goodsInId*  | 
string  | 
the goods receipt ID  Maximum Length:  36  | 
originalGoodsInId  | 
string  | 
the original goods receipt ID  Maximum Length:  36  | 
deliveryNumber*  | 
string  | 
the inbound delivery business key  Maximum Length:  36  | 
deliveryTypeCode  | 
string  | 
Identification of the type of entry/delivery  Maximum Length:  50  | 
deliveryType*  | 
string (enum)  | 
Type of the delivery  Any of:  [
  "GOODSIN_SUPPLIER",
  "GOODSIN_FROM_REWORK",
  "GOODSIN_FOR_BOOKING_AND_RELEASE",
  "GOODSIN_FOR_REMOVAL",
  "GOODSIN_INCOMPLETE",
  "GOODSIN_DLW",
  "GOODSIN_FOR_RELEASE",
  "GOODSIN_POST_PROCESSING",
  "GOODSIN_FROM_MAPPER",
  "GOODSIN_SECOND_CHOICE",
  "GOODSIN_STATIONARY_TRADE",
  "GOODSIN_SMALLPARTS",
  "GOODSIN_CANCELATION",
  "GOODSIN_RELABEL",
  "GOODSIN_B2B",
  "GOODSIN_FROM_RETAIL",
  "GOODSIN_3RD_PARTY"
]  | 
carrier  | 
string  | 
name of the carrier transporting goods  Maximum Length:  100  | 
gates  | 
array  | 
|
(Array item)  | 
object  | 
|
door  | 
string  | 
Gate or Door number  Maximum Length:  10  | 
building  | 
string  | 
Building  Maximum Length:  3  | 
processingInformation  | 
array  | 
|
(Array item)  | 
object  | 
 Additional Properties:  false  | 
goodsReceiptProcessingType*  | 
string (enum)  | 
Pallets/hatch detection  Any of:  [
  "PALLETED_SORTED",
  "PALLETED_UNSORTED",
  "CARTONS_SORTED",
  "CARTONS_UNSORTED",
  "SANDWICH_PALLET",
  "PULK_2MH",
  "DLW",
  "ITEMS_UNSORTED",
  "ITEMS_UNSORTED_FROM_KEP",
  "CARTONS_UNSORTED_FROM_KEP",
  "NON_TRADE_ITEMS"
]  | 
goodsReceiptProcessingCode*  | 
string  | 
Pallet/hatch detection code  | 
quantity  | 
integer  | 
Quantity received for this processing type  Minimum:  0  | 
positions  | 
array  | 
|
(Array item)  | 
object  | 
 Additional Properties:  false  | 
deliveryPositionId*  | 
string  | 
Position Id  Maximum Length:  36  | 
deliveryPositionNumber  | 
integer  | 
Position number  Maximum:  99999999999999  | 
quantity*  | 
integer  | 
Quantity received  Minimum:  0  | 
arrivedToReworkerQuantity  | 
integer  | 
Quantity received by the external reworker  Minimum:  0  | 
destroyedByReworkerQuantity  | 
integer  | 
Quantity destroyed by the external reworker  Minimum:  0  | 
loadingUnitQuantity  | 
integer  | 
Amount of goods  Minimum:  0  | 
supplierNumber*  | 
integer  | 
Supplier Number  Maximum:  9999999  | 
reworkerSupplierNumber  | 
integer  | 
External reworker supplier number  Maximum:  9999999  | 
documentNumber*  | 
integer  | 
Document number  Minimum:  100000  | 
ownerCompany*  | 
string  | 
Owner Company (BDF)  Maximum Length:  30  | 
hermesTourNumber  | 
string  | 
Hermes number  Maximum Length:  12  | 
customsShipmentNumber  | 
string  | 
Custom shipment Number  | 
airWayBill  | 
string  | 
Custom shipment Number  Maximum Length:  30  | 
positionDetails  | 
array  | 
|
(Array item)  | 
object  | 
 Additional Properties:  false  | 
purchaseOrderNumber*  | 
string  | 
Purchase Order Number  Maximum Length:  36  | 
deliveryNoteNumber  | 
string  | 
Delivery Note Number  Maximum Length:  36  | 
storageNotificationId  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
quantity  | 
number  | 
the quantity of the referenced PositionDetail within the position  | 
electronicDeliveryNotePositionId  | 
array  | 
Electronic Delivery Note Position  | 
(Array item)  | 
string  | 
|
deliveryPositionDetailId  | 
string  | 
Position Detail Id  Maximum Length:  36  | 
sourceLocation  | 
string  | 
Source/Original location  Maximum Length:  15  | 
product*  | 
object  | 
 Additional Properties:  false  | 
erpProductId*  | 
string  | 
ERP Product Id  Maximum Length:  36  | 
logisticsProductId*  | 
string  | 
Logistics Product Id  Maximum Length:  36  | 
qualityCheck  | 
string (enum)  | 
Type of Quality Check  Any of:  [
  "NO_QUALITY_CHECK",
  "NORMAL_QUALITY_CHECK",
  "DOWNSTREAM_QUALITY_CHECK"
]  | 
qualityCode  | 
integer  | 
Quantity code number Goods inspection  Maximum:  999  | 
damagedQuantity  | 
integer  | 
Quantity items damaged  Maximum:  999999  | 
processEndDate  | 
string  | 
Process End Date  | 
processEndCode  | 
string (enum)  | 
Process End Code  Any of:  [
  "RELEASE",
  "CANCELLATION",
  "RETURN",
  "REWORK",
  "DESTROY",
  "THIRD_PARTY_SALE"
]  | 
erpDeliveryNo  | 
string  | 
Erp Deliver Number  | 
qualitySampleRequestMode  | 
string (enum)  | 
Sample size calculation mode  Any of:  [
  "ONLINE",
  "OFFLINE"
]  | 
qualitySampleDischargeMode  | 
string (enum)  | 
Direktausschleusung  Any of:  [
  "IMMEDIATE",
  "DEFERRED",
  "CONVERTED"
]  | 
deliveryComparisonResult  | 
string (enum)  | 
Comparison result  Any of:  [
  "DIFFERENCE",
  "NO_DIFFERENCE",
  "NO_COMPARISON"
]  | 
4.2.3. Enumeration
Field: Event Type
| Meta Value | Description | Short Value | 
|---|---|---|
DELIVERY_NOTE_REGISTRATION_END  | 
WE1.0 Ende  | 
|
GOODSRECEIPT_START  | 
WE1.2 Start  | 
|
GOODSRECEIPT_END  | 
WE1.2 Ende  | 
|
DELIVERY_COMPARISON_START  | 
WE1.5 Start  | 
|
DELIVERY_COMPARISON_END  | 
WE1.5 Ende  | 
|
RELEASE_END  | 
WE2.0 Ende  | 
Field: Context
| Meta Value | Description | Short Value | 
|---|---|---|
GOODS_IN  | 
Wareneingang Neuware  | 
Field: Delivery Type
| Meta Value | Description | Short Value | 
|---|---|---|
GOODSIN_SUPPLIER  | 
WE vom Lieferanten  | 
|
GOODSIN_FROM_REWORK  | 
WE aus Nachbearbeitung  | 
|
GOODSIN_FOR_BOOKING_AND_RELEASE  | 
WE ohne Ware (zur Freischaltung mit LIB)  | 
|
GOODSIN_FOR_REMOVAL  | 
WE ohne Ware (zur Ausbuchung)  | 
|
GOODSIN_INCOMPLETE  | 
Inkomplette Anlieferungen  | 
|
GOODSIN_DLW  | 
DLW Anlieferung  | 
|
GOODSIN_FOR_RELEASE  | 
WE ohne Ware (zur Freischaltung ohne LIB)  | 
|
GOODSIN_POST_PROCESSING  | 
WE zur Aufbereitung  | 
|
GOODSIN_FROM_MAPPER  | 
Anlieferung aus Mapper  | 
|
GOODSIN_SECOND_CHOICE  | 
Anlieferung 2. Wahl  | 
|
GOODSIN_STATIONARY_TRADE  | 
WE ohne Ware für Stationärhandel  | 
|
GOODSIN_SMALLPARTS  | 
OSS-Anlieferung  | 
|
GOODSIN_CANCELATION  | 
WE aus Storno  | 
|
GOODSIN_RELABEL  | 
WE aus Neuauszeichnung  | 
|
GOODSIN_B2B  | 
WE aus Großkundenabzug  | 
|
GOODSIN_FROM_RETAIL  | 
WE Rückführung aus Filialen  | 
|
GOODSIN_3RD_PARTY  | 
WE aus Rückführung Drittgeschäft  | 
Field: Goods Receipt Processing
| Meta Value | Description | Short Value | 
|---|---|---|
PALLETED_SORTED  | 
Palettiert einlagerungsfähig/sortenrein  | 
|
PALLETED_UNSORTED  | 
Palettiert unsortiert/Mischpalette  | 
|
CARTONS_SORTED  | 
Sortenreine Kartons  | 
|
CARTONS_UNSORTED  | 
Mischkartons/lose angeliefert  | 
|
SANDWICH_PALLET  | 
Sandwichpalette  | 
|
PULK_2MH  | 
Pulkanlieferung 2MH  | 
|
DLW  | 
Durchlaufware  | 
|
ITEMS_UNSORTED  | 
Mischanlieferung Item/Schuhe  | 
|
ITEMS_UNSORTED_FROM_KEP  | 
Mischanlieferung Item/Schuhe (von KEP). KEP = Kurier-, Express- und Paketdienste-Dienstleister  | 
|
CARTONS_UNSORTED_FROM_KEP  | 
Mischanlieferung Kartons (von KEP). KEP = Kurier-, Express- und Paketdienste-Dienstleister  | 
|
NON_TRADE_ITEMS  | 
Anlieferung von Verbrauchs- und Verpackungsmaterial  | 
Field: Quality Check
| Meta Value | Description | Short Value | 
|---|---|---|
NO_QUALITY_CHECK  | 
ohne Prüfung  | 
|
NORMAL_QUALITY_CHECK  | 
mit Prüfung  | 
|
DOWNSTREAM_QUALITY_CHECK  | 
nachgelagerte Prüfung  | 
Field: Process End Code
| Meta Value | Description | Short Value | 
|---|---|---|
RELEASE  | 
Freischaltung  | 
|
RETURN  | 
Warenrücksendung  | 
|
REWORK  | 
Nachbearbeitung  | 
|
CANCELLATION  | 
Storno  | 
|
DESTROY  | 
Verschrottung  | 
|
THIRD_PARTY_SALE  | 
Verkauf an dritte  | 
Field: Quality Sample Request Mode
| Meta Value | Description | Short Value | 
|---|---|---|
ONLINE  | 
WACH/LIGIS  | 
|
OFFLINE  | 
Vom LVS ermittelt  | 
Field: Quality Sample Discharge Mode
| Meta Value | Description | Short Value | 
|---|---|---|
IMMEDIATE  | 
sofort/vorgelagert  | 
|
DEFERRED  | 
nachgelagert  | 
|
CONVERTED  | 
umgewandelt  | 
Field: Delivery Comparison Result
| Meta Value | Description | Short Value | 
|---|---|---|
DIFFERENCE  | 
Abgleich mit Differenz  | 
|
NO_DIFFERENCE  | 
Abgleich ohne Differenz  | 
|
NO_COMPARISON  | 
Abgleich noch nicht erfolgt  | 
4.2.4. Example
{
    "eventId": "00ce536f-923a-42f4-8128-be118faf1d87",
    "traceId": "00ce536f-923a-42f4-8128-be118faf1d85",
    "spanId": "00ce536f-923a-42f4-8128-be118faf1d85",
    "eventTime": "2022-03-31T12:41:06.036+01:00",
    "version": "2.3",
    "context": "GOODS_IN",
    "eventType": "RELEASE_END",
    "metaData" : {
        "sender": "FINE_INBOUND",
        "client": "FBO",
        "instance": "ILO_INT2"
    },
    "data": {
        "location": "ILOWA",
        "businessEventTime": "2022-03-31T12:41:06.036+01:00",
        "goodsInId": "1368329",
        "deliveryNumber": "1189582",
        "deliveryTypeCode": "1",
        "deliveryType": "GOODSIN_SUPPLIER",
        "carrier": "Hermes Germany",
        "gates": [
            {
                "building": "1",
                "door": "8"
            }
        ],
        "processingInformation": [
            {
                "goodsReceiptProcessingType": "PALLETED_SORTED",
                "goodsReceiptProcessingCode": "W",
                "quantity": 12
            }
        ],
        "positions": [
            {
                "deliveryPositionId": "123123",
                "deliveryPositionNumber": 123456,
                "quantity": 90,
                "loadingUnitQuantity": 9,
                "supplierNumber": 648052,
                "reworkerSupplierNumber": 588411,
                "documentNumber": 483512,
                "ownerCompany": "OTTO",
                "hermesTourNumber": "SGH222010043",
                "customsShipmentNumber": "",
                "airWayBill": "",
                "positionDetails": [
                    {
                        "purchaseOrderNumber": "105791",
                        "deliveryNoteNumber": "22020176_648052",
                        "storageNotificationId": "",
                        "quantity": 90,
                        "electronicDeliveryNotePositionId": [
                            "HG_22020176_648052",
                            "LSB_12345667_987654332"
                        ],
                        "deliveryPositionDetailId": "51984510"
                    }
                ],
                "product": {
                    "erpProductId": "1245874412",
                    "logisticsProductId": "1245874412"
                },
                "qualityCheck": "DOWNSTREAM_QUALITY_CHECK",
                "qualityCode": 100,
                "damagedQuantity": 0,
                "processEndDate": "2023-04-16",
                "processEndCode": "RELEASE",
                "erpDeliveryNo": "3291147085",
                "qualitySampleRequestMode": "ONLINE",
                "qualitySampleDischargeMode": "DEFERRED",
                "deliveryComparisonResult": "DIFFERENCE"
            }
        ]
    }
}
4.2.5. Version history
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
planned version  | 
2.3  | 
11.04.2025  | 
Siehe Kapitel Changelog weiter unten  | 
|
current version  | 
2.2  | 
10.10.2024  | 
Siehe Kapitel Changelog weiter unten  | 
|
previous version  | 
2.1  | 
13.12.2023  | 
Siehe Kapitel Changelog weiter unten  | 
|
previous version  | 
2.0  | 
11.04.2023  | 
Siehe Kapitel Changelog weiter unten  | 
|
previous version  | 
1.0  | 
26.05.2022  | 
- die Länge des Feldes “type” im Header hat sich von 20 auf 32 Zeichen geändert  | 
|
previous version  | 
1.0  | 
09.05.2022  | 
- das Datums-Format an den Feldern eventTime und businessEventTime hat sich geändert: das korrekte Format sieht so aus: 2022-03-31T12:41:06.036+0200 - wir haben die Versionsnummer angepasst bzw. das Versionierungskonzept umgesetzt. Die aktuelle SST-Version ist: „1.0“ - es wurden die Pflichtfelder am Header entsprechend hinterlegt. Diese Felder sind jetzt auch laut JSON Schema immer mitzuschicken: (eventId, traceId, spanId, version, eventTime, context, type, sender, sourceIdentifier) - die Dokumentation direkt am JSON Schema wurde ergänzt, Beschreibungen, Beispiele wurden hinzugefügt.  | 
4.2.6. Changelog
Changes V2.2 → V2.3
- 
New values added to the ENUM deliveryType: GOODSIN_B2B, GOODSIN_FROM_RETAIL, GOODSIN_3RD_PARTY
 - 
New optional attribute sourceLocation was added
 
Changes V2.1 → V2.2
- 
Company ENUM was removed from the attributes: client, ownerCompany
 - 
New optional attribute reworkerSupplierNumber was added: the external reworker as supplier
 - 
New ENUM value "NO_COMPARISON" was added for the existing attribute deliveryComparisonResult. Meaning: there was no comparison yet.
 - 
New optional attributes were added: arrivedToReworkerQuantity, destroyedByReworkerQuantity.
 
Changes V2.0 → V2.1
- 
upgraded ENUM company from V4 to V6
 - 
optional attribute metaData.instance was added to the header
 - 
optional attributes itemNumber and itemSize were removed
 - 
mandatory attribute logisticsProductId was added to the FINE-ERP interface
 - 
3 new optional attributes have been introduced: qualitySampleRequestMode, qualitySampleDischargeMode, deliveryComparisonResult
 - 
optional attribute deliveryPositionDetailId has been added
 
Changes V1.0 → V2.0
- 
Standard header: The Standard header has been changed to the current standard header with following changes:
- 
"eventTime" is to be sent in local time. Format: yyyy-MM-dd’T’HH:mm:ss.SSSXXX Example: 2023-04-12T16:06:05.036+01:00
 - 
the attributes: "sourceIdentifier", "instance", "messageNumber", "lastMessageNumber" have been removed
 - 
the attribute "type" has been renamed to "eventType" and an enum has been introduced
 - 
for the attribute "context" an enum has been introduced
 - 
the attributes "sender" and "client" have been moved to the new object type "metaData"
 
 - 
 - 
Payload (Data)
- 
for the attribute "location" an enum has been introduced
 - 
"businessEventTime" is to be sent in local time. Format: yyyy-MM-dd’T’HH:mm:ss.SSSXXX Example: 2023-04-12T16:06:05.036+01:00
 - 
the attribute "type" has been renamed to "deliveryType" and an enum has been introduced
 - 
the attribute "typeCode" has been renamed to "deliveryTypeCode"
 - 
the attributes "goodsReceiptProcessing" and "goodsReceiptProcessingCode" have been moved to the new array "processingInformation"
 - 
"goodsReceiptProcessing" has been renamed to "goodsReceiptProcessingType"
 - 
the new array is optional but if present, then "goodsReceiptProcessingType" and "goodsReceiptProcessingCode" have to be provided
 - 
besides of the old attributes "goodsReceiptProcessingType" and "goodsReceiptProcessingCode" a new optional attribute "quantity" has been introduced
 - 
for the attribute "goodsReceiptProcessingType" an enum has been introduced
 - 
the attribute "positionId" has been renamed to "deliveryPositionId"
 - 
the attribute "positionNumber" has been renamed to "deliveryPositionNumber"
 - 
the attribute "sku" has been removed
 - 
for the attribute "qualityCheck" an enum has been introduced
 - 
for the attribute "processEndCode" an enum has been introduced
 - 
new attributes have been introduced: "originalGoodsInId" (optional), "carrier" (optional), ownerCompany (mandatory)
 
 - 
 
Hint: The "…Code" attributes should be filled with the WMS specific codes also known by the users in the warehouse. These will be presented in the data mart reports (BI). Here no enum will be defined as this code is WMS specific.
26 - I05 Quality Sample Request
- Status
 - 
Version 1.0 published 26.05.2022
 - Approval
 - Comment
 - Assumption
 - 
_
 
1. Stakeholder
| Role | Application | Responsible | 
|---|---|---|
Communication  | 
Integration Layer  | 
|
Leading App  | 
QS  | 
|
InterfaceOwner  | 
||
Producer  | 
kMotion  | 
|
Producer  | 
KR1  | 
|
Producer  | 
COBRA  | 
|
Consumer  | 
Lionfish  | 
2. Business Context
Nach der Lieferscheinerfassung im Wareneingang muss die Prüfmenge ermittelt werden für die Qualitätsprüfung. Das LVS sendet eine Musterziehungsanfrage über und erhält die Prüfmenge oder bei Außenprüfung bereits ein Prüfergebnis zurück. Das Lager versendet die Ware physisch zur Prüfung. Nach Abschluss der Warenprüfung sendet das Warenprüfungssystem das Ergebnis an das LVS und das BI -System.
3. Informationflow
4. Interface
4.1. Direction WMS to FINE
4.1.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
context  | 
QUALITY_SAMPLE_REQUEST  | 
type  | 
Vorläufige Zweite Prüfmenge Storno Entgültig  | 
4.1.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
QSRequestWms  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta information  | 
sender  | 
string  | 
The name of sender = producer  Maximum Length:  30  | 
instance  | 
string  | 
SW-Instance of the producing system  Maximum Length:  36  | 
client  | 
string  | 
Client / Tenant  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
requestType*  | 
string  | 
Request type  Maximum Length:  60  | 
deliveryDate*  | 
string (date)  | 
Delivery Date  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
positions*  | 
array  | 
Positionen  Minimum number of items  1  | 
(Array item)  | 
object  | 
 Additional Properties:  false  | 
product*  | 
object  | 
|
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  50  | 
supplierNumber*  | 
integer  | 
Supplier number  Minimum Length:  1  | 
partnerId  | 
string  | 
Partner Id  Minimum Length:  1  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
purchaseOrderNumber*  | 
integer  | 
Purchase order number  Maximum Length:  20  | 
externalQualityCode*  | 
string  | 
External quality code  Maximum Length:  30  | 
deliveryQuantity*  | 
number  | 
Delivery quantity  | 
storageNotificationId  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
wmsPositionId*  | 
string  | 
LVS VorgangsID  Maximum Length:  36  | 
4.1.3. Enumeration
Field: tbd
| Meta Value | Description | Short Value | 
|---|
4.1.4. Example
{
  "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
  "eventTime": "2016-04-16T16:06:05+02:00",
  "eventType": "SAMPLE_REQUEST",
  "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
  "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
  "version": "1.0",
  "context": "QS",
  "metaData": {
    "sender": "kMotion",
    "instance": "kMotion-ILO",
    "client": "OTTO"
  },
  "data": {
    "location": "ILOWA",
    "requestType": "PRELIMINARY",
    "deliveryDate": "2020-12-21",
    "deliveryNumber": 0,
    "positions": [
      {
        "product": {
          "logisticsProductId": "1234567890"
        },
        "supplierNumber": 1,
        "partnerId": "0",
        "receivingDocumentNumber": 123,
        "purchaseOrderNumber": 123,
        "externalQualityCode": "A",
        "deliveryQuantity": 4,
        "storageNotificationId": "305106fa-2068-44b9-bca2-5afaed6f5090",
        "wmsPositionId": "4552140011"
      }
    ]
  }
}
4.1.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
26.05.2022  | 
||
previous version  | 
||||
coming version  | 
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "QSRequestWms",
  "description": "Request vom WMS an FINE-QS",
  "type": "object",
  "properties": {
    "eventId": {
      "type": "string",
      "title": "The uniq eventId",
      "maxLength": 36,
      "description": "Global uniq Id, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "traceId": {
      "type": "string",
      "title": "The uniq traceId",
      "maxLength": 36,
      "description": "Global uniq Id for tracing the flow of events, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8138-33418faf1342"
      ]
    },
    "spanId": {
      "type": "string",
      "title": "The eventId of previous record or batchId",
      "maxLength": 36,
      "description": "Optionally, if this record (event) is one of a sequence of records and the order is important, then here is the id of the previous record (event) or event is a part of a batch, recommended as uuid, Special usecases can be specify for some interfaces",
      "examples": [
        "00ce536f-923a-42f4-5463-32a41877b3c2"
      ]
    },
    "eventTime": {
      "type": "string",
      "title": "Time of occurrence of the event",
      "format": "date-time",
      "description": "Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC.",
      "examples": [
        "2016-04-16T16:06:05Z",
        "2016-04-16T16:06:05+02:00"
      ]
    },
    "version": {
      "description": "Version of the interface",
      "type": "string",
      "pattern": "^[0-9]+[.][0-9]+$",
      "minLength": 3,
      "maxLength": 5,
      "title": "Json schema version",
      "examples": [
        "1.0",
        "1.11",
        "1.1"
      ]
    },
    "context": {
      "type": "string",
      "title": "The context / business case",
      "maxLength": 36,
      "description": "The optional context specified here means the business domain.",
      "examples": [
        "QS"
      ]
    },
    "eventType": {
      "type": "string",
      "title": "The concrete type = kind of record(event)",
      "maxLength": 36,
      "description": "This attribute is to be used if the data set can have more than one characteristic. E.g. goods delivery start or goods delivery end. The possible values are to be co-ordinated here as Enum between the partners.",
      "examples": [
        "SAMPLE_REQUEST"
      ]
    },
    "metaData": {
      "type": "object",
      "title": "additional meta information",
      "description": "optional, can be used with different characteristics for technical data per interface",
      "properties": {
        "sender": {
          "type": "string",
          "maxLength": 30,
          "examples": [
            "KR1",
            "ADD"
          ],
          "title": "The name of sender = producer",
          "description": "Name of the source system, which has generated this data."
        },
        "instance": {
          "type": "string",
          "examples": [
            "kMotion-ILO",
            "kMotion-GERNSHEIM"
          ],
          "maxLength": 36,
          "title": "SW-Instance of the producing system",
          "description": "Name of the source instance, which has generated this data"
        },
        "client": {
          "type": "string",
          "title": "Client / Tenant",
          "description": "the client (messages of different clients have different processing rules and destination interfaces)",
          "examples": [
            "KONZERN",
            "OTTO",
            "MYTOYS"
          ]
        }
      }
    },
    "data": {
      "type": "object",
      "properties": {
        "location": {
          "description": "Standort. Bsp. für Kmotion@LSB einen Festwert: LANGENSELBOLD",
          "type": "string",
          "maxLength": 30,
          "minLength": 3,
          "title": "Request location",
          "examples": [
            "LANGENSELBOLD"
          ]
        },
        "requestType": {
          "description": "PRELIMINARY, SECONDLOT, FINAL, CANCELLATION",
          "type": "string",
          "title": "Request type",
          "maxLength": 60,
          "examples": [
            "PRELIMINARY",
            "SECONDLOT",
            "FINAL",
            "CANCELLATION"
          ]
        },
        "deliveryDate": {
          "description": "Datum der Anlieferung",
          "type": "string",
          "format": "date",
          "title": "Delivery Date",
          "examples": [
            "2022-03-22"
          ]
        },
        "deliveryNumber": {
          "description": "Nummer der Anlieferung",
          "type": "string",
          "title": "Delivery Number",
          "maxLength": 36,
          "examples": [
            "1"
          ]
        },
        "positions": {
          "description": "Positionen",
          "type": "array",
          "uniqueItems": true,
          "minItems": 1,
          "items": {
            "$ref": "#/$defs/QSRequestPos"
          }
        }
      },
      "required": [
        "location",
        "requestType",
        "deliveryDate",
        "deliveryNumber",
        "positions"
      ]
    }
  },
  "$defs": {
    "QSRequestPos": {
      "type": "object",
      "properties": {
        "product": {
          "type": "object",
          "properties": {
            "logisticsProductId": {
              "description": "FINE-LSAS Logistics Product Identifier.",
              "type": "string",
              "maxLength": 50,
              "title": "Logistics product Id",
              "examples": [
                "45896254"
              ]
            }
          },
          "required": [
            "logisticsProductId"
          ]
        },
        "supplierNumber": {
          "description": "Lieferantenkennziffer",
          "type": "integer",
          "title": "Supplier number",
          "examples": [
            1
          ],
          "maxLength": 6,
          "minLength": 1
        },
        "partnerId": {
          "description": "Bestandsfirma (lt. Artikelstamm)",
          "type": "string",
          "maxLength": 7,
          "minLength": 1,
          "title": "Partner Id",
          "examples": [
            "12"
          ]
        },
        "receivingDocumentNumber": {
          "description": "Warenannahmeprotokoll (WAP) Nummer",
          "type": "integer",
          "title": "Receiving document number",
          "examples": [
            12
          ],
          "maxLength": 20
        },
        "purchaseOrderNumber": {
          "description": "Auftragsnummer (OVA)",
          "type": "integer",
          "title": "Purchase order number",
          "examples": [
            12
          ],
          "maxLength": 20
        },
        "externalQualityCode": {
          "description": "Aussenpruefkennziffer. Enum wird definiert: Keine (-), Aussengeprueft (A), Selbstpruefer (S), Identifizieren (I)",
          "type": "string",
          "title": "External quality code",
          "maxLength": 30,
          "examples": [
            "-",
            "A",
            "S",
            "I"
          ]
        },
        "deliveryQuantity": {
          "description": "Liefermenge",
          "type": "number",
          "title": "Delivery quantity",
          "examples": [
            12
          ]
        },
        "storageNotificationId": {
          "description": "Technical key",
          "type": "string",
          "title": "Storage Notification Id",
          "maxLength": 36,
          "examples": [
            "305106fa-2068-44b9-bca2-5afaed6f5090"
          ]
        },
        "wmsPositionId": {
          "description": "LVS VorgangsID",
          "type": "string",
          "title": "LVS VorgangsID",
          "maxLength": 36,
          "examples": [
            "45880014",
            "390b8b08-20b9-11ed-861d-0242ac120002"
          ]
        }
      },
      "required": [
        "product",
        "supplierNumber",
        "receivingDocumentNumber",
        "purchaseOrderNumber",
        "externalQualityCode",
        "deliveryQuantity",
        "wmsPositionId"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "eventId",
    "eventTime",
    "traceId",
    "eventType",
    "version",
    "data"
  ],
  "examples": [
    {
      "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
      "eventTime": "2016-04-16T16:06:05+02:00",
      "eventType": "SAMPLE_REQUEST",
      "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
      "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
      "version": "1.0",
      "context": "QS",
      "metaData": {
        "sender": "kMotion",
        "instance": "kMotion-ILO",
        "client": "OTTO"
      },
      "data": {
        "location": "ILOWA",
        "requestType": "PRELIMINARY",
        "deliveryDate": "2020-12-21",
        "deliveryNumber": 0,
        "positions": [
          {
            "product": {
              "logisticsProductId": "1234567890"
            },
            "supplierNumber": 1,
            "partnerId": "0",
            "receivingDocumentNumber": 123,
            "purchaseOrderNumber": 123,
            "externalQualityCode": "A",
            "deliveryQuantity": 4,
            "storageNotificationId": "305106fa-2068-44b9-bca2-5afaed6f5090",
            "wmsPositionId": "4552140011"
          }
        ]
      }
    }
  ]
}
4.2. Direction FINE to ERP
4.2.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
context  | 
QUALITY_SAMPLE_REQUEST  | 
type  | 
Vorläufige Zweite Prüfmenge Storno Entgültig  | 
4.2.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
QSRequestErp  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta information  | 
sender  | 
string  | 
The name of sender = producer  Maximum Length:  30  | 
instance  | 
string  | 
SW-Instance of the producing system  Maximum Length:  36  | 
client  | 
string  | 
Client / Tenant  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
requestType*  | 
string  | 
Request type  Maximum Length:  60  | 
deliveryDate*  | 
string (date)  | 
Delivery Date  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
positions*  | 
array  | 
Positionen  Minimum number of items  1  | 
(Array item)  | 
object  | 
 Additional Properties:  false  | 
product*  | 
object  | 
|
erpProductId*  | 
string  | 
Erp product Id  Maximum Length:  50  | 
supplierNumber*  | 
integer  | 
Supplier number  Minimum Length:  1  | 
partnerId  | 
string  | 
Partner Id  Minimum Length:  1  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
purchaseOrderNumber*  | 
integer  | 
Purchase order number  Maximum Length:  20  | 
externalQualityCode*  | 
string  | 
External quality code  Maximum Length:  30  | 
deliveryQuantity*  | 
number  | 
Delivery quantity  | 
storageNotificationId  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
wmsPositionId*  | 
string  | 
LVS VorgangsID  Maximum Length:  36  | 
4.2.3. Enumeration
Field: tbd
Meta Value  | 
Description  | 
Short Value  | 
4.2.4. Example
{
  "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
  "eventTime": "2016-04-16T16:06:05+02:00",
  "eventType": "SAMPLE_REQUEST",
  "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
  "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
  "version": "1.0",
  "context": "QS",
  "metaData": {
    "sender": "kMotion",
    "instance": "kMotion-ILO",
    "client": "OTTO"
  },
  "data": {
    "location": "ILOWA",
    "requestType": "PRELIMINARY",
    "deliveryDate": "2020-12-21",
    "deliveryNumber": 0,
    "positions": [
      {
        "product": {
          "erpProductId": "1234567890"
        },
        "supplierNumber": 1,
        "partnerId": "0",
        "receivingDocumentNumber": 123,
        "purchaseOrderNumber": 123,
        "externalQualityCode": "A",
        "deliveryQuantity": 4,
        "storageNotificationId": "305106fa-2068-44b9-bca2-5afaed6f5090",
        "wmsPositionId": "4552140011"
      }
    ]
  }
}
4.2.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
26.05.2022  | 
||
previous version  | 
||||
coming version  | 
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "QSRequestErp",
  "description": "Request von FINE-QS das ERP",
  "type": "object",
  "properties": {
    "eventId": {
      "type": "string",
      "title": "The uniq eventId",
      "maxLength": 36,
      "description": "Global uniq Id, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "traceId": {
      "type": "string",
      "title": "The uniq traceId",
      "maxLength": 36,
      "description": "Global uniq Id for tracing the flow of events, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8138-33418faf1342"
      ]
    },
    "spanId": {
      "type": "string",
      "title": "The eventId of previous record or batchId",
      "maxLength": 36,
      "description": "Optionally, if this record (event) is one of a sequence of records and the order is important, then here is the id of the previous record (event) or event is a part of a batch, recommended as uuid, Special usecases can be specify for some interfaces",
      "examples": [
        "00ce536f-923a-42f4-5463-32a41877b3c2"
      ]
    },
    "eventTime": {
      "type": "string",
      "title": "Time of occurrence of the event",
      "format": "date-time",
      "description": "Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC.",
      "examples": [
        "2016-04-16T16:06:05Z",
        "2016-04-16T16:06:05+02:00"
      ]
    },
    "version": {
      "description": "Version of the interface",
      "type": "string",
      "pattern": "^[0-9]+[.][0-9]+$",
      "minLength": 3,
      "maxLength": 5,
      "title": "Json schema version",
      "examples": [
        "1.0",
        "1.11",
        "1.1"
      ]
    },
    "context": {
      "type": "string",
      "title": "The context / business case",
      "maxLength": 36,
      "description": "The optional context specified here means the business domain.",
      "examples": [
        "QS"
      ]
    },
    "eventType": {
      "type": "string",
      "title": "The concrete type = kind of record(event)",
      "maxLength": 36,
      "description": "This attribute is to be used if the data set can have more than one characteristic. E.g. goods delivery start or goods delivery end. The possible values are to be co-ordinated here as Enum between the partners.",
      "examples": [
        "SAMPLE_REQUEST"
      ]
    },
    "metaData": {
      "type": "object",
      "title": "additional meta information",
      "description": "optional, can be used with different characteristics for technical data per interface",
      "properties": {
        "sender": {
          "type": "string",
          "maxLength": 30,
          "examples": [
            "KR1",
            "ADD"
          ],
          "title": "The name of sender = producer",
          "description": "Name of the source system, which has generated this data."
        },
        "instance": {
          "type": "string",
          "examples": [
            "kMotion-ILO",
            "kMotion-GERNSHEIM"
          ],
          "maxLength": 36,
          "title": "SW-Instance of the producing system",
          "description": "Name of the source instance, which has generated this data"
        },
        "client": {
          "type": "string",
          "title": "Client / Tenant",
          "description": "the client (messages of different clients have different processing rules and destination interfaces)",
          "examples": [
            "KONZERN",
            "OTTO",
            "MYTOYS"
          ]
        }
      }
    },
    "data": {
      "type": "object",
      "properties": {
        "location": {
          "description": "Standort. Bsp. für Kmotion@LSB einen Festwert: LANGENSELBOLD",
          "type": "string",
          "maxLength": 30,
          "minLength": 3,
          "title": "Request location",
          "examples": [
            "LANGENSELBOLD"
          ]
        },
        "requestType": {
          "description": "PRELIMINARY, SECONDLOT, FINAL, CANCELLATION",
          "type": "string",
          "title": "Request type",
          "maxLength": 60,
          "examples": [
            "PRELIMINARY",
            "SECONDLOT",
            "FINAL",
            "CANCELLATION"
          ]
        },
        "deliveryDate": {
          "description": "Datum der Anlieferung",
          "type": "string",
          "format": "date",
          "title": "Delivery Date",
          "examples": [
            "2022-03-22"
          ]
        },
        "deliveryNumber": {
          "description": "Nummer der Anlieferung",
          "type": "string",
          "title": "Delivery Number",
          "maxLength": 36,
          "examples": [
            "1"
          ]
        },
        "positions": {
          "description": "Positionen",
          "type": "array",
          "uniqueItems": true,
          "minItems": 1,
          "items": {
            "$ref": "#/$defs/QSRequestPos"
          }
        }
      },
      "required": [
        "location",
        "requestType",
        "deliveryDate",
        "deliveryNumber",
        "positions"
      ]
    }
  },
  "$defs": {
    "QSRequestPos": {
      "type": "object",
      "properties": {
        "product": {
          "type": "object",
          "properties": {
            "erpProductId": {
              "description": "FINE-LSAS ERP Product Identifier.",
              "type": "string",
              "maxLength": 50,
              "title": "Erp product Id",
              "examples": [
                "45896254"
              ]
            }
          },
          "required": [
            "erpProductId"
          ]
        },
        "supplierNumber": {
          "description": "Lieferantenkennziffer",
          "type": "integer",
          "title": "Supplier number",
          "examples": [
            1
          ],
          "maxLength": 6,
          "minLength": 1
        },
        "partnerId": {
          "description": "Bestandsfirma (lt. Artikelstamm)",
          "type": "string",
          "maxLength": 7,
          "minLength": 1,
          "title": "Partner Id",
          "examples": [
            "12"
          ]
        },
        "receivingDocumentNumber": {
          "description": "Warenannahmeprotokoll (WAP) Nummer",
          "type": "integer",
          "title": "Receiving document number",
          "examples": [
            12
          ],
          "maxLength": 20
        },
        "purchaseOrderNumber": {
          "description": "Auftragsnummer (OVA)",
          "type": "integer",
          "title": "Purchase order number",
          "examples": [
            12
          ],
          "maxLength": 20
        },
        "externalQualityCode": {
          "description": "Aussenpruefkennziffer. Enum wird definiert: Keine (-), Aussengeprueft (A), Selbstpruefer (S), Identifizieren (I)",
          "type": "string",
          "title": "External quality code",
          "maxLength": 30,
          "examples": [
            "-",
            "A",
            "S",
            "I"
          ]
        },
        "deliveryQuantity": {
          "description": "Liefermenge",
          "type": "number",
          "title": "Delivery quantity",
          "examples": [
            12
          ]
        },
        "storageNotificationId": {
          "description": "Technical key",
          "type": "string",
          "title": "Storage Notification Id",
          "maxLength": 36,
          "examples": [
            "305106fa-2068-44b9-bca2-5afaed6f5090"
          ]
        },
        "wmsPositionId": {
          "description": "LVS VorgangsID",
          "type": "string",
          "title": "LVS VorgangsID",
          "maxLength": 36,
          "examples": [
            "45880014",
            "390b8b08-20b9-11ed-861d-0242ac120002"
          ]
        }
      },
      "required": [
        "product",
        "supplierNumber",
        "receivingDocumentNumber",
        "purchaseOrderNumber",
        "externalQualityCode",
        "deliveryQuantity",
        "wmsPositionId"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "eventId",
    "eventTime",
    "traceId",
    "eventType",
    "version",
    "data"
  ],
  "examples": [
    {
      "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
      "eventTime": "2016-04-16T16:06:05+02:00",
      "eventType": "SAMPLE_REQUEST",
      "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
      "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
      "version": "1.0",
      "context": "QS",
      "metaData": {
        "sender": "kMotion",
        "instance": "kMotion-ILO",
        "client": "OTTO"
      },
      "data": {
        "location": "ILOWA",
        "requestType": "PRELIMINARY",
        "deliveryDate": "2020-12-21",
        "deliveryNumber": 0,
        "positions": [
          {
            "product": {
              "erpProductId": "1234567890"
            },
            "supplierNumber": 1,
            "partnerId": "0",
            "receivingDocumentNumber": 123,
            "purchaseOrderNumber": 123,
            "externalQualityCode": "A",
            "deliveryQuantity": 4,
            "storageNotificationId": "305106fa-2068-44b9-bca2-5afaed6f5090",
            "wmsPositionId": "4552140011"
          }
        ]
      }
    }
  ]
}
27 - I06 Quality Sample Response
- Status
 - 
Version 1.0 published 26.05.2022
 - Approval
 - Comment
 - Assumption
 - 
_
 
1. Stakeholder
| Role | Application | Responsible | 
|---|---|---|
Communication  | 
Integration Layer  | 
|
Leading App  | 
QS  | 
|
InterfaceOwner  | 
||
Producer  | 
Lionfish  | 
|
Consumer  | 
kMotion  | 
|
Consumer  | 
KR1  | 
|
Consumer  | 
COBRA  | 
2. Business Context
Nach der Lieferscheinerfassung im Wareneingang muss die Prüfmenge ermittelt werden für die Qualitätsprüfung. Das LVS sendet eine Musterziehungsanfrage über und erhält die Prüfmenge oder bei Außenprüfung bereits ein Prüfergebnis zurück. Das Lager versendet die Ware physisch zur Prüfung. Nach Abschluss der Warenprüfung sendet das Warenprüfungssystem das Ergebnis an das LVS und das BI -System.
3. Informationflow
4. Interface
4.1. Direction ERP to FINE
4.1.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
context  | 
QUALITY_SAMPLE_RESPONSE  | 
type  | 
Vorläufige Zweite Prüfmenge Storno Entgültig  | 
4.1.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
QSResponseErp  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta information  | 
sender  | 
string  | 
The name of sender = producer  Maximum Length:  30  | 
instance  | 
string  | 
SW-Instance of the producing system  Maximum Length:  36  | 
client  | 
string  | 
Client / Tenant  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
deliveryDate*  | 
string (date)  | 
Delivery Date  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
positions*  | 
array  | 
Positionen  Minimum number of items  1  | 
(Array item)  | 
object  | 
 Additional Properties:  false  | 
product*  | 
object  | 
|
erpProductId*  | 
string  | 
Erp product Id  Maximum Length:  50  | 
supplierNumber*  | 
integer  | 
Supplier number  Maximum Length:  20  | 
partnerId  | 
string  | 
Partner Id  Minimum Length:  1  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
purchaseOrderNumber*  | 
integer  | 
Purchase order number  Maximum Length:  20  | 
qualityCode*  | 
integer  | 
Quality code  Maximum Length:  6  | 
checkPrecision*  | 
string  | 
Check precision  Maximum Length:  10  | 
sampleQuantity*  | 
integer  | 
Sample quantity  Maximum Length:  6  | 
inspectionId*  | 
string  | 
Inspection Id  Maximum Length:  36  | 
wmsPositionId*  | 
string  | 
LVS VorgangsID  Maximum Length:  36  | 
4.1.3. Enumeration
Field: tbd
| Meta Value | Description | Short Value | 
|---|
4.1.4. Example
{
  "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
  "eventTime": "2016-04-16T16:06:05+02:00",
  "eventType": "SAMPLE_RESPONSE",
  "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
  "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
  "version": "1.0",
  "context": "QS",
  "metaData": {
    "sender": "kMotion",
    "instance": "kMotion-ILO",
    "client": "OTTO"
  },
  "data": {
    "location": "LANGENSELBOLD",
    "deliveryDate": "2020-12-21",
    "deliveryNumber": 12240,
    "positions": [
      {
        "product": {
          "erpProductId": "1234567890"
        },
        "supplierNumber": 1,
        "partnerId": "0",
        "receivingDocumentNumber": 123,
        "purchaseOrderNumber": 123,
        "qualityCode": 103,
        "checkPrecision": "",
        "sampleQuantity": 4,
        "inspectionId": "1234567890",
        "wmsPositionId": "4552140011"
      }
    ]
  }
}
4.1.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
26.05.2022  | 
||
previous version  | 
||||
coming version  | 
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "QSResponseErp",
  "description": "Response vom ERP an FINE-QS",
  "type": "object",
  "properties": {
    "eventId": {
      "type": "string",
      "title": "The uniq eventId",
      "maxLength": 36,
      "description": "Global uniq Id, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "traceId": {
      "type": "string",
      "title": "The uniq traceId",
      "maxLength": 36,
      "description": "Global uniq Id for tracing the flow of events, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8138-33418faf1342"
      ]
    },
    "spanId": {
      "type": "string",
      "title": "The eventId of previous record or batchId",
      "maxLength": 36,
      "description": "Optionally, if this record (event) is one of a sequence of records and the order is important, then here is the id of the previous record (event) or event is a part of a batch, recommended as uuid, Special usecases can be specify for some interfaces",
      "examples": [
        "00ce536f-923a-42f4-5463-32a41877b3c2"
      ]
    },
    "eventTime": {
      "type": "string",
      "title": "Time of occurrence of the event",
      "format": "date-time",
      "description": "Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC.",
      "examples": [
        "2016-04-16T16:06:05Z",
        "2016-04-16T16:06:05+02:00"
      ]
    },
    "version": {
      "description": "Version of the interface",
      "type": "string",
      "pattern": "^[0-9]+[.][0-9]+$",
      "minLength": 3,
      "maxLength": 5,
      "title": "Json schema version",
      "examples": [
        "1.0",
        "1.11",
        "1.1"
      ]
    },
    "context": {
      "type": "string",
      "title": "The context / business case",
      "maxLength": 36,
      "description": "The optional context specified here means the business domain.",
      "examples": [
        "QS"
      ]
    },
    "eventType": {
      "type": "string",
      "title": "The concrete type = kind of record(event)",
      "maxLength": 36,
      "description": "This attribute is to be used if the data set can have more than one characteristic. E.g. goods delivery start or goods delivery end. The possible values are to be co-ordinated here as Enum between the partners.",
      "examples": [
        "SAMPLE_RESPONSE"
      ]
    },
    "metaData": {
      "type": "object",
      "title": "additional meta information",
      "description": "optional, can be used with different characteristics for technical data per interface",
      "properties": {
        "sender": {
          "type": "string",
          "examples": [
            "KR1",
            "ADD"
          ],
          "title": "The name of sender = producer",
          "maxLength": 30,
          "description": "Name of the source system, which has generated this data."
        },
        "instance": {
          "type": "string",
          "examples": [
            "kMotion-ILO",
            "kMotion-GERNSHEIM"
          ],
          "maxLength": 36,
          "title": "SW-Instance of the producing system",
          "description": "Name of the source instance, which has generated this data"
        },
        "client": {
          "type": "string",
          "title": "Client / Tenant",
          "description": "the client (messages of different clients have different processing rules and destination interfaces)",
          "examples": [
            "KONZERN",
            "OTTO",
            "MYTOYS"
          ]
        }
      }
    },
    "data": {
      "type": "object",
      "properties": {
        "location": {
          "description": "Standort. Bsp. für Kmotion@LSB einen Festwert: LANGENSELBOLD",
          "type": "string",
          "maxLength": 30,
          "minLength": 3,
          "title": "Request location",
          "examples": [
            "LANGENSELBOLD"
          ]
        },
        "deliveryDate": {
          "description": "Datum der Anlieferung",
          "type": "string",
          "format": "date",
          "title": "Delivery Date",
          "examples": [
            "2022-03-22"
          ]
        },
        "deliveryNumber": {
          "description": "Nummer der Anlieferung",
          "type": "string",
          "title": "Delivery Number",
          "maxLength": 36,
          "examples": [
            "1"
          ]
        },
        "positions": {
          "description": "Positionen",
          "type": "array",
          "uniqueItems": true,
          "minItems": 1,
          "items": {
            "$ref": "#/$defs/QSResponsePos"
          }
        }
      },
      "required": [
        "location",
        "deliveryDate",
        "deliveryNumber",
        "positions"
      ]
    }
  },
  "$defs": {
    "QSResponsePos": {
      "type": "object",
      "properties": {
        "product": {
          "type": "object",
          "properties": {
            "erpProductId": {
              "description": "FINE-LSAS ERP Product Identifier.",
              "type": "string",
              "maxLength": 50,
              "title": "Erp product Id",
              "examples": [
                "45896254"
              ]
            }
          },
          "required": [
            "erpProductId"
          ]
        },
        "supplierNumber": {
          "description": "Lieferantenkennziffer",
          "type": "integer",
          "title": "Supplier number",
          "examples": [
            1
          ],
          "maxLength": 20
        },
        "partnerId": {
          "description": "Bestandsfirma (lt. Artikelstamm)",
          "type": "string",
          "maxLength": 10,
          "minLength": 1,
          "title": "Partner Id",
          "examples": [
            "12"
          ]
        },
        "receivingDocumentNumber": {
          "description": "Warenannahmeprotokoll (WAP) Nummer",
          "type": "integer",
          "title": "Receiving document number",
          "examples": [
            12
          ],
          "maxLength": 20
        },
        "purchaseOrderNumber": {
          "description": "Auftragsnummer (OVA)",
          "type": "integer",
          "title": "Purchase order number",
          "examples": [
            12
          ],
          "maxLength": 20
        },
        "qualityCode": {
          "description": "Prüfergebnis. Bei 103 oder 110 --> manuelle Freigabe; Friegabe nur dann wenn qualityCode mit diesen Werten anfängt: 10,11,15,45,50,75",
          "type": "integer",
          "title": "Quality code",
          "maxLength": 6,
          "examples": [
            10,
            11,
            15
          ]
        },
        "checkPrecision": {
          "description": "Prüfschärfe",
          "type": "string",
          "maxLength": 10,
          "title": "Check precision",
          "examples": [
            "Y"
          ]
        },
        "sampleQuantity": {
          "description": "Mustermenge",
          "type": "integer",
          "title": "Sample quantity",
          "maxLength": 6,
          "examples": [
            12
          ]
        },
        "inspectionId": {
          "description": "Prüfauftrag Identifier",
          "type": "string",
          "title": "Inspection Id",
          "maxLength": 36,
          "examples": [
            "390c570e-20b9-11ed-861d-0242ac120002"
          ]
        },
        "wmsPositionId": {
          "description": "LVS VorgangsID",
          "type": "string",
          "title": "LVS VorgangsID",
          "maxLength": 36,
          "examples": [
            "45880014",
            "390b8b08-20b9-11ed-861d-0242ac120002"
          ]
        }
      },
      "required": [
        "product",
        "supplierNumber",
        "receivingDocumentNumber",
        "purchaseOrderNumber",
        "qualityCode",
        "checkPrecision",
        "sampleQuantity",
        "inspectionId",
        "wmsPositionId"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "eventId",
    "eventTime",
    "traceId",
    "eventType",
    "version",
    "data"
  ],
  "examples": [
    {
      "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
      "eventTime": "2016-04-16T16:06:05+02:00",
      "eventType": "SAMPLE_RESPONSE",
      "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
      "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
      "version": "1.0",
      "context": "QS",
      "metaData": {
        "sender": "kMotion",
        "instance": "kMotion-ILO",
        "client": "OTTO"
      },
      "data": {
        "location": "LANGENSELBOLD",
        "deliveryDate": "2020-12-21",
        "deliveryNumber": 12240,
        "positions": [
          {
            "product": {
              "erpProductId": "1234567890"
            },
            "supplierNumber": 1,
            "partnerId": "0",
            "receivingDocumentNumber": 123,
            "purchaseOrderNumber": 123,
            "qualityCode": 103,
            "checkPrecision": "",
            "sampleQuantity": 4,
            "inspectionId": "1234567890",
            "wmsPositionId": "4552140011"
          }
        ]
      }
    }
  ]
}
4.2. Direction FINE to WMS
4.2.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
context  | 
QUALITY_SAMPLE_RESPONSE  | 
type  | 
Vorläufige Zweite Prüfmenge Storno Entgültig  | 
4.2.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
QSResponseWms  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta information  | 
sender  | 
string  | 
The name of sender = producer  Maximum Length:  30  | 
instance  | 
string  | 
SW-Instance of the producing system  Maximum Length:  36  | 
client  | 
string  | 
Client / Tenant  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
deliveryDate*  | 
string (date)  | 
Delivery Date  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
positions*  | 
array  | 
Positionen  Minimum number of items  1  | 
(Array item)  | 
object  | 
 Additional Properties:  false  | 
product*  | 
object  | 
|
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  50  | 
supplierNumber*  | 
integer  | 
Supplier number  Maximum Length:  20  | 
partnerId  | 
string  | 
Partner Id  Minimum Length:  1  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
purchaseOrderNumber*  | 
integer  | 
Purchase order number  Maximum Length:  20  | 
qualityCode*  | 
integer  | 
Quality code  Maximum Length:  6  | 
checkPrecision*  | 
string  | 
Check precision  Maximum Length:  10  | 
sampleQuantity*  | 
integer  | 
Sample quantity  Maximum Length:  6  | 
inspectionId*  | 
string  | 
Inspection Id  Maximum Length:  36  | 
wmsPositionId*  | 
string  | 
LVS VorgangsID  Maximum Length:  36  | 
4.2.3. Enumeration
Field: tbd
Meta Value  | 
Description  | 
Short Value  | 
4.2.4. Example
{
  "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
  "eventTime": "2016-04-16T16:06:05+02:00",
  "eventType": "SAMPLE_RESPONSE",
  "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
  "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
  "version": "1.0",
  "context": "QS",
  "metaData": {
    "sender": "kMotion",
    "instance": "kMotion-ILO",
    "client": "OTTO"
  },
  "data": {
    "location": "LANGENSELBOLD",
    "deliveryDate": "2020-12-21",
    "deliveryNumber": 12240,
    "positions": [
      {
        "product": {
          "logisticsProductId": "1234567890"
        },
        "supplierNumber": 1,
        "partnerId": "0",
        "receivingDocumentNumber": 123,
        "purchaseOrderNumber": 123,
        "qualityCode": 103,
        "checkPrecision": "",
        "sampleQuantity": 4,
        "inspectionId": "1234567890",
        "wmsPositionId": "4552140011"
      }
    ]
  }
}
4.2.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
26.05.2022  | 
||
previous version  | 
||||
coming version  | 
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "QSResponseWms",
  "description": "Response von FINE-QS an das WMS",
  "type": "object",
  "properties": {
    "eventId": {
      "type": "string",
      "title": "The uniq eventId",
      "maxLength": 36,
      "description": "Global uniq Id, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "traceId": {
      "type": "string",
      "title": "The uniq traceId",
      "maxLength": 36,
      "description": "Global uniq Id for tracing the flow of events, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8138-33418faf1342"
      ]
    },
    "spanId": {
      "type": "string",
      "title": "The eventId of previous record or batchId",
      "maxLength": 36,
      "description": "Optionally, if this record (event) is one of a sequence of records and the order is important, then here is the id of the previous record (event) or event is a part of a batch, recommended as uuid, Special usecases can be specify for some interfaces",
      "examples": [
        "00ce536f-923a-42f4-5463-32a41877b3c2"
      ]
    },
    "eventTime": {
      "type": "string",
      "title": "Time of occurrence of the event",
      "format": "date-time",
      "description": "Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC.",
      "examples": [
        "2016-04-16T16:06:05Z",
        "2016-04-16T16:06:05+02:00"
      ]
    },
    "version": {
      "description": "Version of the interface",
      "type": "string",
      "pattern": "^[0-9]+[.][0-9]+$",
      "minLength": 3,
      "maxLength": 5,
      "title": "Json schema version",
      "examples": [
        "1.0",
        "1.11",
        "1.1"
      ]
    },
    "context": {
      "type": "string",
      "title": "The context / business case",
      "maxLength": 36,
      "description": "The optional context specified here means the business domain.",
      "examples": [
        "QS"
      ]
    },
    "eventType": {
      "type": "string",
      "title": "The concrete type = kind of record(event)",
      "maxLength": 36,
      "description": "This attribute is to be used if the data set can have more than one characteristic. E.g. goods delivery start or goods delivery end. The possible values are to be co-ordinated here as Enum between the partners.",
      "examples": [
        "SAMPLE_RESPONSE"
      ]
    },
    "metaData": {
      "type": "object",
      "title": "additional meta information",
      "description": "optional, can be used with different characteristics for technical data per interface",
      "properties": {
        "sender": {
          "type": "string",
          "examples": [
            "KR1",
            "ADD"
          ],
          "title": "The name of sender = producer",
          "maxLength": 30,
          "description": "Name of the source system, which has generated this data."
        },
        "instance": {
          "type": "string",
          "examples": [
            "kMotion-ILO",
            "kMotion-GERNSHEIM"
          ],
          "maxLength": 36,
          "title": "SW-Instance of the producing system",
          "description": "Name of the source instance, which has generated this data"
        },
        "client": {
          "type": "string",
          "title": "Client / Tenant",
          "description": "the client (messages of different clients have different processing rules and destination interfaces)",
          "examples": [
            "KONZERN",
            "OTTO",
            "MYTOYS"
          ]
        }
      }
    },
    "data": {
      "type": "object",
      "properties": {
        "location": {
          "description": "Standort. Bsp. für Kmotion@LSB einen Festwert: LANGENSELBOLD",
          "type": "string",
          "maxLength": 30,
          "minLength": 3,
          "title": "Request location",
          "examples": [
            "LANGENSELBOLD"
          ]
        },
        "deliveryDate": {
          "description": "Datum der Anlieferung",
          "type": "string",
          "format": "date",
          "title": "Delivery Date",
          "examples": [
            "2022-03-22"
          ]
        },
        "deliveryNumber": {
          "description": "Nummer der Anlieferung",
          "type": "string",
          "title": "Delivery Number",
          "maxLength": 36,
          "examples": [
            "1"
          ]
        },
        "positions": {
          "description": "Positionen",
          "type": "array",
          "uniqueItems": true,
          "minItems": 1,
          "items": {
            "$ref": "#/$defs/QSResponsePos"
          }
        }
      },
      "required": [
        "location",
        "deliveryDate",
        "deliveryNumber",
        "positions"
      ]
    }
  },
  "$defs": {
    "QSResponsePos": {
      "type": "object",
      "properties": {
        "product": {
          "type": "object",
          "properties": {
            "logisticsProductId": {
              "description": "FINE-LSAS Logistics Product Identifier.",
              "type": "string",
              "maxLength": 50,
              "title": "Logistics product Id",
              "examples": [
                "45896254"
              ]
            }
          },
          "required": [
            "logisticsProductId"
          ]
        },
        "supplierNumber": {
          "description": "Lieferantenkennziffer",
          "type": "integer",
          "title": "Supplier number",
          "examples": [
            1
          ],
          "maxLength": 20
        },
        "partnerId": {
          "description": "Bestandsfirma (lt. Artikelstamm)",
          "type": "string",
          "maxLength": 10,
          "minLength": 1,
          "title": "Partner Id",
          "examples": [
            "12"
          ]
        },
        "receivingDocumentNumber": {
          "description": "Warenannahmeprotokoll (WAP) Nummer",
          "type": "integer",
          "title": "Receiving document number",
          "examples": [
            12
          ],
          "maxLength": 20
        },
        "purchaseOrderNumber": {
          "description": "Auftragsnummer (OVA)",
          "type": "integer",
          "title": "Purchase order number",
          "examples": [
            12
          ],
          "maxLength": 20
        },
        "qualityCode": {
          "description": "Prüfergebnis. Bei 103 oder 110 --> manuelle Freigabe; Friegabe nur dann wenn qualityCode mit diesen Werten anfängt: 10,11,15,45,50,75",
          "type": "integer",
          "title": "Quality code",
          "maxLength": 6,
          "examples": [
            10,
            11,
            15
          ]
        },
        "checkPrecision": {
          "description": "Prüfschärfe",
          "type": "string",
          "maxLength": 10,
          "title": "Check precision",
          "examples": [
            "Y"
          ]
        },
        "sampleQuantity": {
          "description": "Mustermenge",
          "type": "integer",
          "title": "Sample quantity",
          "maxLength": 6,
          "examples": [
            12
          ]
        },
        "inspectionId": {
          "description": "Prüfauftrag Identifier",
          "type": "string",
          "title": "Inspection Id",
          "maxLength": 36,
          "examples": [
            "390c570e-20b9-11ed-861d-0242ac120002"
          ]
        },
        "wmsPositionId": {
          "description": "LVS VorgangsID",
          "type": "string",
          "title": "LVS VorgangsID",
          "maxLength": 36,
          "examples": [
            "45880014",
            "390b8b08-20b9-11ed-861d-0242ac120002"
          ]
        }
      },
      "required": [
        "product",
        "supplierNumber",
        "receivingDocumentNumber",
        "purchaseOrderNumber",
        "qualityCode",
        "checkPrecision",
        "sampleQuantity",
        "inspectionId",
        "wmsPositionId"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "eventId",
    "eventTime",
    "traceId",
    "eventType",
    "version",
    "data"
  ],
  "examples": [
    {
      "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
      "eventTime": "2016-04-16T16:06:05+02:00",
      "eventType": "SAMPLE_RESPONSE",
      "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
      "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
      "version": "1.0",
      "context": "QS",
      "metaData": {
        "sender": "kMotion",
        "instance": "kMotion-ILO",
        "client": "OTTO"
      },
      "data": {
        "location": "LANGENSELBOLD",
        "deliveryDate": "2020-12-21",
        "deliveryNumber": 12240,
        "positions": [
          {
            "product": {
              "logisticsProductId": "1234567890"
            },
            "supplierNumber": 1,
            "partnerId": "0",
            "receivingDocumentNumber": 123,
            "purchaseOrderNumber": 123,
            "qualityCode": 103,
            "checkPrecision": "",
            "sampleQuantity": 4,
            "inspectionId": "1234567890",
            "wmsPositionId": "4552140011"
          }
        ]
      }
    }
  ]
}
28 - I07 Quality Result
- Status
 - 
Version 1.0 published 18.10.2022
 - Approval
 - Comment
 - Assumption
 - 
_
 
1. Stakeholder
| Role | Application | Responsible | 
|---|---|---|
Communication  | 
Integration Layer  | 
|
Leading App  | 
QS  | 
|
InterfaceOwner  | 
||
Producer  | 
Lionfish  | 
|
Consumer  | 
kMotion  | 
|
Consumer  | 
KR1  | 
|
Consumer  | 
COBRA  | 
|
Consumer  | 
FLASH  | 
2. Business Context
Nach der Lieferscheinerfassung im Wareneingang muss die Prüfmenge ermittelt werden für die Qualitätsprüfung. Das LVS sendet eine Musterziehungsanfrage über und erhält die Prüfmenge oder bei Außenprüfung bereits ein Prüfergebnis zurück. Das Lager versendet die Ware physisch zur Prüfung. Nach Abschluss der Warenprüfung sendet das Warenprüfungssystem das Ergebnis an das LVS und das BI -System.
3. Informationflow
4. Interface
4.1. Direction ERP to FINE
4.1.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
context  | 
QUALITY_RESULT CMS_RESULT  | 
eventType  | 
QUALITY_RESULT CMS_RESULT  | 
4.1.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
QSResultErp  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta information  | 
sender  | 
string  | 
The name of sender = producer  Maximum Length:  30  | 
instance  | 
string  | 
SW-Instance of the producing system  | 
client  | 
string  | 
Client / Tenant  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
product*  | 
object  | 
|
erpProductId*  | 
string  | 
Erp product Id  Maximum Length:  50  | 
supplierNumber*  | 
integer  | 
Supplier number  Minimum Length:  1  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
qualityCode*  | 
integer  | 
Quality code  Maximum Length:  6  | 
resultCode*  | 
string  | 
Quality result code  | 
rejectionCode  | 
string  | 
Rejection code  Minimum Length:  1  | 
inspectionId  | 
string  | 
Inspection Id  Maximum Length:  36  | 
wmsPositionId*  | 
string  | 
LVS VorgangsID  Maximum Length:  36  | 
resultQuantity  | 
number  | 
Result quantity  | 
cmsId  | 
string  | 
CMS Id  Maximum Length:  36  | 
4.1.3. Enumeration
Field: Result Code
| Meta Value | Description | Short Value | 
|---|---|---|
APPROPRIATE  | 
Freischaltung - Qualität in Ordnung  | 
|
INADEQUATE  | 
Keine Freischaltung - Qualität nicht in Ordnung  | 
|
RETURN  | 
Rücksendung  | 
|
REWORK  | 
Nacharbeit  | 
|
ONSTOCK  | 
Freischaltung nach Claim (ggf. trotz Fehlerbild)  | 
|
SCRAP  | 
Verschrottung  | 
|
THIRD_PARTY_SELLING  | 
Sonderdrittverkauf  | 
4.1.4. Example
{
      "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
      "eventTime": "2016-04-16T16:06:05+02:00",
      "eventType": "QUALITY_RESULT",
      "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
      "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
      "version": "1.0",
      "context": "QS",
      "metaData": {
        "sender": "kMotion",
        "instance": "kMotion-ILO",
        "client": "OTTO"
      },
      "data": {
        "location": "ILOWA",
        "deliveryNumber": 124404,
        "product": {
          "erpProductId": "1234567890"
        },
        "supplierNumber": 11148,
        "receivingDocumentNumber": 41123,
        "qualityCode": 103,
        "resultCode": "APPROPRIATE",
        "rejectionCode": "F",
        "inspectionId": "1234567890",
        "wmsPositionId": "4552140011"
      }
}
4.1.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
26.05.2022  | 
||
previous version  | 
||||
coming version  | 
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "QSResultErp",
  "description": "Prüfergebnisse der Warenprüfung",
  "type": "object",
  "properties": {
    "eventId": {
      "type": "string",
      "title": "The uniq eventId",
      "maxLength": 36,
      "description": "Global uniq Id, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "traceId": {
      "type": "string",
      "title": "The uniq traceId",
      "maxLength": 36,
      "description": "Global uniq Id for tracing the flow of events, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8138-33418faf1342"
      ]
    },
    "spanId": {
      "type": "string",
      "title": "The eventId of previous record or batchId",
      "maxLength": 36,
      "description": "Optionally, if this record (event) is one of a sequence of records and the order is important, then here is the id of the previous record (event) or event is a part of a batch, recommended as uuid, Special usecases can be specify for some interfaces",
      "examples": [
        "00ce536f-923a-42f4-5463-32a41877b3c2"
      ]
    },
    "eventTime": {
      "type": "string",
      "title": "Time of occurrence of the event",
      "format": "date-time",
      "description": "Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC.",
      "examples": [
        "2016-04-16T16:06:05Z",
        "2016-04-16T16:06:05+02:00"
      ]
    },
    "version": {
      "description": "Version of the interface",
      "type": "string",
      "pattern": "^[0-9]+[.][0-9]+$",
      "minLength": 3,
      "maxLength": 5,
      "title": "Json schema version",
      "examples": [
        "1.0",
        "1.11",
        "1.1"
      ]
    },
    "context": {
      "type": "string",
      "title": "The context / business case",
      "description": "The optional context specified here means the business domain.",
      "maxLength": 36,
      "examples": [
        "QS"
      ]
    },
    "eventType": {
      "type": "string",
      "title": "The concrete type = kind of record(event)",
      "maxLength": 36,
      "description": "This attribute is to be used if the data set can have more than one characteristic. E.g. goods delivery start or goods delivery end. The possible values are to be co-ordinated here as Enum between the partners.",
      "examples": [
        "QUALITY_RESULT"
      ]
    },
    "metaData": {
      "type": "object",
      "title": "additional meta information",
      "description": "optional, can be used with different characteristics for technical data per interface",
      "properties": {
        "sender": {
          "type": "string",
          "examples": [
            "KR1",
            "ADD"
          ],
          "title": "The name of sender = producer",
          "maxLength": 30,
          "description": "Name of the source system, which has generated this data."
        },
        "instance": {
          "type": "string",
          "examples": [
            "kMotion-ILO",
            "kMotion-GERNSHEIM"
          ],
          "title": "SW-Instance of the producing system",
          "description": "Name of the source instance, which has generated this data"
        },
        "client": {
          "type": "string",
          "title": "Client / Tenant",
          "description": "the client (messages of different clients have different processing rules and destination interfaces)",
          "examples": [
            "KONZERN",
            "OTTO",
            "MYTOYS"
          ]
        }
      }
    },
    "data": {
      "type": "object",
      "properties": {
        "location": {
          "description": "Standort. Bsp. für Kmotion@LSB einen Festwert: LANGENSELBOLD",
          "type": "string",
          "maxLength": 30,
          "minLength": 3,
          "title": "Request location",
          "examples": [
            "LANGENSELBOLD"
          ]
        },
        "deliveryNumber": {
          "description": "Nummer der Anlieferung",
          "type": "string",
          "title": "Delivery Number",
          "maxLength": 36,
          "examples": [
            "1"
          ]
        },
        "product": {
          "type": "object",
          "properties": {
            "erpProductId": {
              "description": "FINE-LSAS ERP Product Identifier.",
              "type": "string",
              "maxLength": 50,
              "title": "Erp product Id",
              "examples": [
                "45896254"
              ]
            }
          },
          "required": [
            "erpProductId"
          ]
        },
        "supplierNumber": {
          "description": "Lieferantenkennziffer",
          "type": "integer",
          "title": "Supplier number",
          "examples": [
            1
          ],
          "maxLength": 6,
          "minLength": 1
        },
        "receivingDocumentNumber": {
          "description": "Warenannahmeprotokoll (WAP) Nummer",
          "type": "integer",
          "title": "Receiving document number",
          "examples": [
            12
          ],
          "maxLength": 20
        },
        "qualityCode": {
          "description": "Prüfergebnis. Bei 103 oder 110 --> manuelle Freigabe; Friegabe nur dann wenn qualityCode mit diesen Werten anfängt: 10,11,15,45,50,75",
          "type": "integer",
          "title": "Quality code",
          "maxLength": 6,
          "examples": [
            10,
            11,
            15
          ]
        },
        "resultCode": {
          "description": "Ergebnis der Warenprüfung. Mögliche Werte: APPROPRIATE, REWORK, RETURN, INADEQUATE",
          "type": "string",
          "title": "Quality result code",
          "examples": [
            "APPROPRIATE"
          ]
        },
        "rejectionCode": {
          "description": "Beanstandungskennzeichen. Mögliche Werte: leer, F = Formale Fehler, S = Serienfehler, Q = Qualitätsfehler",
          "type": "string",
          "maxLength": 1,
          "minLength": 1,
          "title": "Rejection code",
          "examples": [
            "F",
            "S",
            "Q"
          ]
        },
        "inspectionId": {
          "description": "Prüfauftrag Identifier",
          "type": "string",
          "title": "Inspection Id",
          "maxLength": 36,
          "examples": [
            "12"
          ]
        },
        "wmsPositionId": {
          "description": "LVS VorgangsID",
          "type": "string",
          "title": "LVS VorgangsID",
          "maxLength": 36,
          "examples": [
            "45880014",
            "390b8b08-20b9-11ed-861d-0242ac120002"
          ]
        },
        "resultQuantity": {
          "description": "Optionale Ergebnismenge. Wenn nicht vorhanden, dann bezieht sich das Ergebnis auf die ganze Liefermenge. Mit dem Attribut kann man Prüfergebnisse bezugen auf eine Teilmenge übertragen",
          "type": "number",
          "title": "Result quantity",
          "examples": [
            12
          ]
        },
        "cmsId": {
          "description": "CMS Identifier",
          "type": "string",
          "title": "CMS Id",
          "maxLength": 36,
          "examples": [
            "12"
          ]
        }
      },
      "required": [
        "location",
        "deliveryNumber",
        "product",
        "supplierNumber",
        "receivingDocumentNumber",
        "qualityCode",
        "resultCode",
        "wmsPositionId"
      ]
    }
  },
  "required": [
    "eventId",
    "eventTime",
    "traceId",
    "eventType",
    "version",
    "data"
  ],
  "examples": [
    {
      "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
      "eventTime": "2016-04-16T16:06:05+02:00",
      "eventType": "QUALITY_RESULT",
      "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
      "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
      "version": "1.0",
      "context": "QS",
      "metaData": {
        "sender": "kMotion",
        "instance": "kMotion-ILO",
        "client": "OTTO"
      },
      "data": {
        "location": "ILOWA",
        "deliveryNumber": 124404,
        "product": {
          "erpProductId": "1234567890"
        },
        "supplierNumber": 11148,
        "receivingDocumentNumber": 41123,
        "qualityCode": 103,
        "resultCode": "APPROPRIATE",
        "rejectionCode": "F",
        "inspectionId": "1234567890",
        "wmsPositionId": "4552140011"
      }
    }
  ]
}
4.2. Direction FINE to WMS
4.2.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
context  | 
QUALITY_RESULT CMS_RESULT  | 
eventType  | 
QUALITY_RESULT CMS_RESULT  | 
4.2.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
QSResultWms  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta information  | 
sender  | 
string  | 
The name of sender = producer  Maximum Length:  30  | 
instance  | 
string  | 
SW-Instance of the producing system  | 
client  | 
string  | 
Client / Tenant  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
deliveryNumber*  | 
string  | 
Delivery Number  | 
product*  | 
object  | 
|
logisticsProductId*  | 
string  | 
Logistics Product Id  Maximum Length:  50  | 
supplierNumber*  | 
integer  | 
Supplier number  Minimum Length:  1  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
qualityCode*  | 
integer  | 
Quality code  Maximum Length:  6  | 
resultCode*  | 
string  | 
Quality result code  | 
rejectionCode  | 
string  | 
Rejection code  Minimum Length:  1  | 
inspectionId  | 
string  | 
Inspection Id  Maximum Length:  36  | 
wmsPositionId*  | 
string  | 
LVS VorgangsID  Maximum Length:  36  | 
resultQuantity  | 
number  | 
Result quantity  | 
cmsId  | 
string  | 
CMS Id  Maximum Length:  36  | 
4.2.3. Enumeration
Field: Result Code
| Meta Value | Description | Short Value | 
|---|---|---|
APPROPRIATE  | 
Freischaltung - Qualität in Ordnung  | 
|
INADEQUATE  | 
Keine Freischaltung - Qualität nicht in Ordnung  | 
|
RETURN  | 
Rücksendung  | 
|
REWORK  | 
Nacharbeit  | 
|
ONSTOCK  | 
Freischaltung nach Claim (ggf. trotz Fehlerbild)  | 
|
SCRAP  | 
Verschrottung  | 
|
THIRD_PARTY_SELLING  | 
Sonderdrittverkauf  | 
4.2.4. Example
{
      "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
      "eventTime": "2016-04-16T16:06:05+02:00",
      "eventType": "QUALITY_RESULT",
      "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
      "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
      "version": "1.0",
      "context": "QS",
      "metaData": {
        "sender": "kMotion",
        "instance": "kMotion-ILO",
        "client": "OTTO"
      },
      "data": {
        "location": "ILOWA",
        "deliveryNumber": 124404,
        "product": {
          "logisticsProductId": "1234567890"
        },
        "supplierNumber": 11148,
        "receivingDocumentNumber": 41123,
        "qualityCode": 103,
        "resultCode": "APPROPRIATE",
        "rejectionCode": "F",
        "inspectionId": "1234567890",
        "wmsPositionId": "4552140011"
      }
}
4.2.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
26.05.2022  | 
||
previous version  | 
||||
coming version  | 
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "QSResultWms",
  "description": "Prüfergebnisse der Warenprüfung",
  "type": "object",
  "properties": {
    "eventId": {
      "type": "string",
      "maxLength": 36,
      "title": "The uniq eventId",
      "description": "Global uniq Id, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "traceId": {
      "type": "string",
      "maxLength": 36,
      "title": "The uniq traceId",
      "description": "Global uniq Id for tracing the flow of events, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8138-33418faf1342"
      ]
    },
    "spanId": {
      "type": "string",
      "title": "The eventId of previous record or batchId",
      "maxLength": 36,
      "description": "Optionally, if this record (event) is one of a sequence of records and the order is important, then here is the id of the previous record (event) or event is a part of a batch, recommended as uuid, Special usecases can be specify for some interfaces",
      "examples": [
        "00ce536f-923a-42f4-5463-32a41877b3c2"
      ]
    },
    "eventTime": {
      "type": "string",
      "title": "Time of occurrence of the event",
      "format": "date-time",
      "description": "Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC.",
      "examples": [
        "2016-04-16T16:06:05Z",
        "2016-04-16T16:06:05+02:00"
      ]
    },
    "version": {
      "description": "Version of the interface",
      "type": "string",
      "pattern": "^[0-9]+[.][0-9]+$",
      "minLength": 3,
      "maxLength": 5,
      "title": "Json schema version",
      "examples": [
        "1.0",
        "1.11",
        "1.1"
      ]
    },
    "context": {
      "type": "string",
      "title": "The context / business case",
      "maxLength": 36,
      "description": "The optional context specified here means the business domain.",
      "examples": [
        "QS"
      ]
    },
    "eventType": {
      "type": "string",
      "title": "The concrete type = kind of record(event)",
      "maxLength": 36,
      "description": "This attribute is to be used if the data set can have more than one characteristic. E.g. goods delivery start or goods delivery end. The possible values are to be co-ordinated here as Enum between the partners.",
      "examples": [
        "QUALITY_RESULT"
      ]
    },
    "metaData": {
      "type": "object",
      "title": "additional meta information",
      "description": "optional, can be used with different characteristics for technical data per interface",
      "properties": {
        "sender": {
          "type": "string",
          "examples": [
            "KR1",
            "ADD"
          ],
          "maxLength": 30,
          "title": "The name of sender = producer",
          "description": "Name of the source system, which has generated this data."
        },
        "instance": {
          "type": "string",
          "examples": [
            "kMotion-ILO",
            "kMotion-GERNSHEIM"
          ],
          "title": "SW-Instance of the producing system",
          "description": "Name of the source instance, which has generated this data"
        },
        "client": {
          "type": "string",
          "title": "Client / Tenant",
          "description": "the client (messages of different clients have different processing rules and destination interfaces)",
          "examples": [
            "KONZERN",
            "OTTO",
            "MYTOYS"
          ]
        }
      }
    },
    "data": {
      "type": "object",
      "properties": {
        "location": {
          "description": "Standort. Bsp. für Kmotion@LSB einen Festwert: LANGENSELBOLD",
          "type": "string",
          "maxLength": 30,
          "minLength": 3,
          "title": "Request location",
          "examples": [
            "LANGENSELBOLD"
          ]
        },
        "deliveryNumber": {
          "description": "Nummer der Anlieferung",
          "type": "string",
          "title": "Delivery Number",
          "examples": [
            "1"
          ]
        },
        "product": {
          "type": "object",
          "properties": {
            "logisticsProductId": {
              "description": "FINE-LSAS Logistics Product Identifier.",
              "type": "string",
              "maxLength": 50,
              "title": "Logistics Product Id",
              "examples": [
                "45896254"
              ]
            }
          },
          "required": [
            "logisticsProductId"
          ]
        },
        "supplierNumber": {
          "description": "Lieferantenkennziffer",
          "type": "integer",
          "title": "Supplier number",
          "examples": [
            1
          ],
          "maxLength": 6,
          "minLength": 1
        },
        "receivingDocumentNumber": {
          "description": "Warenannahmeprotokoll (WAP) Nummer",
          "type": "integer",
          "title": "Receiving document number",
          "examples": [
            12
          ],
          "maxLength": 20
        },
        "qualityCode": {
          "description": "Prüfergebnis. Bei 103 oder 110 --> manuelle Freigabe; Friegabe nur dann wenn qualityCode mit diesen Werten anfängt: 10,11,15,45,50,75",
          "type": "integer",
          "title": "Quality code",
          "maxLength": 6,
          "examples": [
            10,
            11,
            15
          ]
        },
        "resultCode": {
          "description": "Ergebnis der Warenprüfung. Mögliche Werte: APPROPRIATE, REWORK, RETURN, INADEQUATE",
          "type": "string",
          "title": "Quality result code",
          "examples": [
            "APPROPRIATE"
          ]
        },
        "rejectionCode": {
          "description": "Beanstandungskennzeichen. Mögliche Werte: leer, F = Formale Fehler, S = Serienfehler, Q = Qualitätsfehler",
          "type": "string",
          "maxLength": 1,
          "minLength": 1,
          "title": "Rejection code",
          "examples": [
            "F",
            "S",
            "Q"
          ]
        },
        "inspectionId": {
          "description": "Prüfauftrag Identifier",
          "type": "string",
          "title": "Inspection Id",
          "maxLength": 36,
          "examples": [
            "12"
          ]
        },
        "wmsPositionId": {
          "description": "LVS VorgangsID",
          "type": "string",
          "title": "LVS VorgangsID",
          "maxLength": 36,
          "examples": [
            "45880014",
            "390b8b08-20b9-11ed-861d-0242ac120002"
          ]
        },
        "resultQuantity": {
          "description": "Optionale Ergebnismenge. Wenn nicht vorhanden, dann bezieht sich das Ergebnis auf die ganze Liefermenge. Mit dem Attribut kann man Prüfergebnisse bezugen auf eine Teilmenge übertragen",
          "type": "number",
          "title": "Result quantity",
          "examples": [
            12
          ]
        },
        "cmsId": {
          "description": "CMS Identifier",
          "type": "string",
          "title": "CMS Id",
          "maxLength": 36,
          "examples": [
            "12"
          ]
        }
      },
      "required": [
        "location",
        "deliveryNumber",
        "product",
        "supplierNumber",
        "receivingDocumentNumber",
        "qualityCode",
        "resultCode",
        "wmsPositionId"
      ]
    }
  },
  "required": [
    "eventId",
    "eventTime",
    "traceId",
    "eventType",
    "version",
    "data"
  ],
  "examples": [
    {
      "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
      "eventTime": "2016-04-16T16:06:05+02:00",
      "eventType": "QUALITY_RESULT",
      "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
      "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
      "version": "1.0",
      "context": "QS",
      "metaData": {
        "sender": "kMotion",
        "instance": "kMotion-ILO",
        "client": "OTTO"
      },
      "data": {
        "location": "ILOWA",
        "deliveryNumber": 124404,
        "product": {
          "logisticsProductId": "1234567890"
        },
        "supplierNumber": 11148,
        "receivingDocumentNumber": 41123,
        "qualityCode": 103,
        "resultCode": "APPROPRIATE",
        "rejectionCode": "F",
        "inspectionId": "1234567890",
        "wmsPositionId": "4552140011"
      }
    }
  ]
}
29 - I08 Package List Ready for QS
- Status
 - 
Version 1.0 published 21.11.2022
 - Approval
 - Comment
 - Assumption
 - 
_
 
1. Stakeholder
| Role | Application | Responsible | 
|---|---|---|
Communication  | 
Integration Layer  | 
|
Leading App  | 
QS  | 
|
InterfaceOwner  | 
||
Producer  | 
kMotion  | 
|
Producer  | 
COBRA  | 
|
Consumer  | 
Lionfish  | 
2. Business Context
Die Nachricht wird vom Lagerverwaltungssystem erzeugt und an FINE übermittelt genau dann, wenn die Packstücke auf der Übergabefläche für die Warenprüfung bereitgestellt worden sind. Es sollen Detailinformationen über die bereitgestellten Packstücke übermittelt werden. FINE bereitet dann diese Daten auf und übermittelt an das Warenprüfsystem/ERP.
3. Informationflow
4. Interface
4.1. Direction WMS to FINE
4.1.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
context  | 
QS CLAIM  | 
eventType  | 
PACKAGE_LIST_READY_FOR_QS PACKAGE_LIST_READY_FOR_CLAIM  | 
4.1.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
PackageStatusAfterQsWms  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta data  | 
sender  | 
string (enum)  | 
sender  Any of:  [
  "KR1_SHF",
  "KR1_HHSTR",
  "WMSX_SON",
  "WMSX_AKU",
  "KMOTION_ILO",
  "KMOTION_GHM",
  "COBRA",
  "LSAS",
  "IDEEFIX",
  "OBS",
  "RESY",
  "LDH",
  "RETAILSCHICHT",
  "BUBE",
  "FINE_INBOUND"
]  | 
instance  | 
string  | 
instance of producer  | 
client  | 
string (enum)  | 
client  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU"
]  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
positions*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
containerId*  | 
string  | 
Container ID  Maximum Length:  36  | 
containerNumber*  | 
string  | 
Container number  Maximum Length:  50  | 
buid  | 
string  | 
BUID  Maximum Length:  36  | 
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  50  | 
quantity*  | 
number  | 
Menge  | 
storageRemovalTime*  | 
string (date-time)  | 
Entnahmezeitpunkt  | 
currentStorageLocation*  | 
string  | 
Lagerort/Lagerkoordinate  Maximum Length:  50  | 
supplierNumber*  | 
integer  | 
Supplier number  Minimum Length:  1  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
inspectionId*  | 
string  | 
Inspection Id  Maximum Length:  36  | 
wmsPositionId*  | 
string  | 
LVS VorgangsID  Maximum Length:  36  | 
4.1.3. Enumeration
Field: tbd
| Meta Value | Description | Short Value | 
|---|
4.1.4. Example
{
  "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
  "eventTime": "2016-04-16T16:06:05+02:00",
  "eventType": "PACKAGE_LIST_READY_FOR_QS",
  "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
  "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
  "version": "1.0",
  "context": "QS",
  "metaData": {
    "sender": "KMOTION_ILO",
    "instance": "kMotion-ILO",
    "client": "OTTO"
  },
  "data": {
    "location": "ILOWA",
    "deliveryNumber": "124404",
    "positions": [
      {
        "containerId": "390c3aee-20b9-11ed-861d-0242ac120002",
        "containerNumber": "5487891001",
        "buid": "390c3d1e-20b9-11ed-861d-0242ac120002",
        "logisticsProductId": "1234567890",
        "quantity": 1,
        "storageRemovalTime": "2022-10-16T16:01:00+02:00",
        "currentStorageLocation": "7.1.15.41.2.01",
        "supplierNumber": 11148,
        "receivingDocumentNumber": 41123,
        "inspectionId": "1234567890",
        "wmsPositionId": "4552140011"
      }
    ]
  }
}
4.1.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
21.11.2022  | 
||
previous version  | 
||||
coming version  | 
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "PackageStatusAfterQsWms",
  "description": "Packstückliste für die Warenprüfung",
  "type": "object",
  "properties": {
    "eventId": {
      "type": "string",
      "title": "The uniq eventId",
      "maxLength": 36,
      "description": "Global uniq Id, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "eventTime": {
      "type": "string",
      "title": "Time of occurrence of the event",
      "format": "date-time",
      "description": "Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC.",
      "examples": [
        "2016-04-16T16:06:05Z",
        "2016-04-16T16:06:05+02:00"
      ]
    },
    "eventType": {
      "type": "string",
      "title": "The concrete type = kind of record(event)",
      "maxLength": 36,
      "description": "This attribute is to be used if the data set can have more than one characteristic. E.g. goods delivery start or goods delivery end. The possible values are to be co-ordinated here as Enum between the partners.",
      "examples": [
        "PACKAGE_LIST_READY_FOR_QS"
      ]
    },
    "traceId": {
      "type": "string",
      "title": "The uniq traceId",
      "maxLength": 36,
      "description": "Global uniq Id for tracing the flow of events, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8138-33418faf1342"
      ]
    },
    "spanId": {
      "type": "string",
      "title": "The eventId of previous record or batchId",
      "maxLength": 36,
      "description": "Optionally, if this record (event) is one of a sequence of records and the order is important, then here is the id of the previous record (event) or event is a part of a batch, recommended as uuid, Special usecases can be specify for some interfaces",
      "examples": [
        "00ce536f-923a-42f4-5463-32a41877b3c2"
      ]
    },
    "version": {
      "description": "Version of the interface",
      "type": "string",
      "pattern": "^[0-9]+[.][0-9]+$",
      "minLength": 3,
      "maxLength": 5,
      "title": "Json schema version",
      "examples": [
        "1.0",
        "1.11",
        "1.1"
      ]
    },
    "context": {
      "type": "string",
      "title": "The context / business case",
      "description": "The optional context specified here means the business domain.",
      "maxLength": 36,
      "examples": [
        "QS", "CLAIM"
      ]
    },
    "metaData": {
      "type": "object",
      "title": "additional meta data",
      "description": "additional meta information for booking interface",
      "properties": {
        "sender": {
          "title": "sender",
          "description": "Name of the source system, that has sent this message.",
          "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/system.v1.schema.json"
        },
        "instance": {
          "title": "instance of producer",
          "type": "string",
          "description": "instance of the application or warehouse context"
        },
        "client": {
          "title": "client",
          "description": "Client/mandant (messages of different clients have different processing rules and destination interfaces) - use FBO for Fulfillment by Otto (CORE, DeepSea...)",
          "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/company.v1.schema.json"
        }
      }
    },
    "data": {
      "type": "object",
      "properties": {
        "location": {
          "description": "Lagerstandort",
          "type": "string",
          "maxLength": 30,
          "minLength": 3,
          "title": "Request location",
          "examples": [
            "LANGENSELBOLD", "ILOWA"
          ]
        },
        "deliveryNumber": {
          "description": "Nummer der Anlieferung",
          "type": "string",
          "title": "Delivery Number",
          "maxLength": 36,
          "examples": [
            "1"
          ]
        },
        "positions": {
          "type": "array",
          "uniqueItems": true,
          "minItems": 1,
          "items": {
            "type": "object",
            "properties": {
              "containerId": {
                "description": "Technische ID des Packstückes/Quantes/Gebinde",
                "type": "string",
                "title": "Container ID",
                "maxLength": 36,
                "examples": [
                  "390c3e40-20b9-11ed-861d-0242ac120002"
                ]
              },
              "containerNumber": {
                "description": "Fachliche ID des Packstückes/Quantes/Gebinde",
                "type": "string",
                "title": "Container number",
                "maxLength": 50,
                "examples": [
                  "5487891001"
                ]
              },
              "buid": {
                "description": "Eineindeutige Identifizierung eines Teils",
                "type": "string",
                "title": "BUID",
                "maxLength": 36,
                "examples": [
                  "390c3e40-20b9-11ed-861d-0242ac120002"
                ]
              },
              "logisticsProductId": {
                "description": "FINE-LSAS Logistics Product Identifier.",
                "type": "string",
                "maxLength": 50,
                "title": "Logistics product Id",
                "examples": [
                  "45896254"
                ]
              },
              "quantity": {
                "description": "Menge innerhalb des Packstückes",
                "type": "number",
                "title": "Menge",
                "examples": [
                  12
                ]
              },
              "storageRemovalTime": {
                "type": "string",
                "title": "Entnahmezeitpunkt",
                "format": "date-time",
                "description": "Entnahmezeitpunkt",
                "examples": [
                  "2016-04-16T16:06:05Z",
                  "2016-04-16T16:06:05+02:00"
                ]
              },
              "currentStorageLocation": {
                "description": "Lagerort/Lagerkoordinate, wo sich die Ware aktuell befindet",
                "type": "string",
                "maxLength": 50,
                "title": "Lagerort/Lagerkoordinate",
                "examples": [
                  "7.1.15.41.2.01"
                ]
              },
              "supplierNumber": {
                "description": "Lieferantenkennziffer",
                "type": "integer",
                "title": "Supplier number",
                "maxLength": 6,
                "minLength": 1,
                "examples": [
                  1
                ]
              },
              "receivingDocumentNumber": {
                "description": "Warenannahmeprotokoll (WAP) Nummer",
                "type": "integer",
                "title": "Receiving document number",
                "examples": [
                  12
                ],
                "maxLength": 20
              },
              "inspectionId": {
                "description": "Prüfauftrag Identifier",
                "type": "string",
                "title": "Inspection Id",
                "maxLength": 36,
                "examples": [
                  "12"
                ]
              },
              "wmsPositionId": {
                "description": "LVS VorgangsID",
                "type": "string",
                "title": "LVS VorgangsID",
                "maxLength": 36,
                "examples": [
                  "45880014",
                  "390b8b08-20b9-11ed-861d-0242ac120002"
                ]
              }
            },
            "required": [
              "containerId",
              "containerNumber",
              "logisticsProductId",
              "quantity",
              "storageRemovalTime",
              "currentStorageLocation",
              "supplierNumber",
              "receivingDocumentNumber",
              "inspectionId",
              "wmsPositionId"
            ]
          }
        }
      },
      "required": [
        "location",
        "deliveryNumber",
        "positions"
      ]
    }
  },
  "required": [
    "eventId",
    "eventTime",
    "traceId",
    "eventType",
    "version",
    "data"
  ],
  "examples": [
    {
      "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
      "eventTime": "2016-04-16T16:06:05+02:00",
      "eventType": "PACKAGE_LIST_READY_FOR_QS",
      "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
      "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
      "version": "1.0",
      "context": "QS",
      "metaData": {
        "sender": "KMOTION_ILO",
        "instance": "kMotion-ILO",
        "client": "OTTO"
      },
      "data": {
        "location": "ILOWA",
        "deliveryNumber": "124404",
        "positions": [
          {
            "containerId": "390c3aee-20b9-11ed-861d-0242ac120002",
            "containerNumber": "5487891001",
            "buid": "390c3d1e-20b9-11ed-861d-0242ac120002",
            "logisticsProductId": "1234567890",
            "quantity": 1,
            "storageRemovalTime": "2022-10-16T16:01:00+02:00",
            "currentStorageLocation": "7.1.15.41.2.01",
            "supplierNumber": 11148,
            "receivingDocumentNumber": 41123,
            "inspectionId": "1234567890",
            "wmsPositionId": "4552140011"
          }
        ]
      }
    }
  ]
}
4.2. Direction FINE to ERP
4.2.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
context  | 
QS CLAIM  | 
eventType  | 
PACKAGE_LIST_READY_FOR_QS PACKAGE_LIST_READY_FOR_CLAIM  | 
4.2.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
PacklistReadyForQsErp  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta data  | 
sender  | 
string (enum)  | 
sender  Any of:  [
  "KR1_SHF",
  "KR1_HHSTR",
  "WMSX_SON",
  "WMSX_AKU",
  "KMOTION_ILO",
  "KMOTION_GHM",
  "COBRA",
  "LSAS",
  "IDEEFIX",
  "OBS",
  "RESY",
  "LDH",
  "RETAILSCHICHT",
  "BUBE",
  "FINE_INBOUND"
]  | 
instance  | 
string  | 
instance of producer  | 
client  | 
string (enum)  | 
client  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU"
]  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
positions*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
containerId*  | 
string  | 
Container ID  Maximum Length:  36  | 
containerNumber*  | 
string  | 
Container number  Maximum Length:  50  | 
buid  | 
string  | 
BUID  Maximum Length:  36  | 
erpProductId*  | 
string  | 
Erp product Id  Maximum Length:  50  | 
quantity*  | 
number  | 
Menge  | 
storageRemovalTime*  | 
string (date-time)  | 
Entnahmezeitpunkt  | 
currentStorageLocation*  | 
string  | 
Lagerort/Lagerkoordinate  Maximum Length:  50  | 
supplierNumber*  | 
integer  | 
Supplier number  Minimum Length:  1  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
inspectionId*  | 
string  | 
Inspection Id  Maximum Length:  36  | 
wmsPositionId*  | 
string  | 
LVS VorgangsID  Maximum Length:  36  | 
4.2.3. Enumeration
Field: tbd
Meta Value  | 
Description  | 
Short Value  | 
4.2.4. Example
{
  "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
  "eventTime": "2016-04-16T16:06:05+02:00",
  "eventType": "PACKAGE_LIST_READY_FOR_QS",
  "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
  "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
  "version": "1.0",
  "context": "QS",
  "metaData": {
    "sender": "KMOTION_ILO",
    "instance": "kMotion-ILO",
    "client": "OTTO"
  },
  "data": {
    "location": "ILOWA",
    "deliveryNumber": "124404",
    "positions": [
      {
        "containerId": "390c3aee-20b9-11ed-861d-0242ac120002",
        "containerNumber": "5487891001",
        "buid": "390c3d1e-20b9-11ed-861d-0242ac120002",
        "erpProductId": "1234567890",
        "quantity": 1,
        "storageRemovalTime": "2022-10-16T16:01:00+02:00",
        "currentStorageLocation": "7.1.15.41.2.01",
        "supplierNumber": 11148,
        "receivingDocumentNumber": 41123,
        "inspectionId": "1234567890",
        "wmsPositionId": "4552140011"
      }
    ]
  }
}
4.2.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
21.11.2022  | 
||
previous version  | 
||||
coming version  | 
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "PacklistReadyForQsErp",
  "description": "Packstückliste für die Warenprüfung",
  "type": "object",
  "properties": {
    "eventId": {
      "type": "string",
      "title": "The uniq eventId",
      "maxLength": 36,
      "description": "Global uniq Id, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "eventTime": {
      "type": "string",
      "title": "Time of occurrence of the event",
      "format": "date-time",
      "description": "Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC.",
      "examples": [
        "2016-04-16T16:06:05Z",
        "2016-04-16T16:06:05+02:00"
      ]
    },
    "eventType": {
      "type": "string",
      "title": "The concrete type = kind of record(event)",
      "maxLength": 36,
      "description": "This attribute is to be used if the data set can have more than one characteristic. E.g. goods delivery start or goods delivery end. The possible values are to be co-ordinated here as Enum between the partners.",
      "examples": [
        "PACKAGE_LIST_READY_FOR_QS"
      ]
    },
    "traceId": {
      "type": "string",
      "title": "The uniq traceId",
      "maxLength": 36,
      "description": "Global uniq Id for tracing the flow of events, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8138-33418faf1342"
      ]
    },
    "spanId": {
      "type": "string",
      "title": "The eventId of previous record or batchId",
      "maxLength": 36,
      "description": "Optionally, if this record (event) is one of a sequence of records and the order is important, then here is the id of the previous record (event) or event is a part of a batch, recommended as uuid, Special usecases can be specify for some interfaces",
      "examples": [
        "00ce536f-923a-42f4-5463-32a41877b3c2"
      ]
    },
    "version": {
      "description": "Version of the interface",
      "type": "string",
      "pattern": "^[0-9]+[.][0-9]+$",
      "minLength": 3,
      "maxLength": 5,
      "title": "Json schema version",
      "examples": [
        "1.0",
        "1.11",
        "1.1"
      ]
    },
    "context": {
      "type": "string",
      "title": "The context / business case",
      "description": "The optional context specified here means the business domain.",
      "maxLength": 36,
      "examples": [
        "QS", "CLAIM"
      ]
    },
    "metaData": {
      "type": "object",
      "title": "additional meta data",
      "description": "additional meta information for booking interface",
      "properties": {
        "sender": {
          "title": "sender",
          "description": "Name of the source system, that has sent this message.",
          "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/system.v1.schema.json"
        },
        "instance": {
          "title": "instance of producer",
          "type": "string",
          "description": "instance of the application or warehouse context"
        },
        "client": {
          "title": "client",
          "description": "Client/mandant (messages of different clients have different processing rules and destination interfaces) - use FBO for Fulfillment by Otto (CORE, DeepSea...)",
          "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/company.v1.schema.json"
        }
      }
    },
    "data": {
      "type": "object",
      "properties": {
        "location": {
          "description": "Lagerstandort",
          "type": "string",
          "maxLength": 30,
          "minLength": 3,
          "title": "Request location",
          "examples": [
            "LANGENSELBOLD", "ILOWA"
          ]
        },
        "deliveryNumber": {
          "description": "Nummer der Anlieferung",
          "type": "string",
          "title": "Delivery Number",
          "maxLength": 36,
          "examples": [
            "1"
          ]
        },
        "positions": {
          "type": "array",
          "uniqueItems": true,
          "minItems": 1,
          "items": {
            "type": "object",
            "properties": {
              "containerId": {
                "description": "Technische ID des Packstückes/Quantes/Gebinde",
                "type": "string",
                "title": "Container ID",
                "maxLength": 36,
                "examples": [
                  "390c3e40-20b9-11ed-861d-0242ac120002"
                ]
              },
              "containerNumber": {
                "description": "Fachliche ID des Packstückes/Quantes/Gebinde",
                "type": "string",
                "title": "Container number",
                "maxLength": 50,
                "examples": [
                  "5487891001"
                ]
              },
              "buid": {
                "description": "Eineindeutige Identifizierung eines Teils",
                "type": "string",
                "title": "BUID",
                "maxLength": 36,
                "examples": [
                  "390c3e40-20b9-11ed-861d-0242ac120002"
                ]
              },
              "erpProductId": {
                "description": "FINE-LSAS Erp Product Identifier.",
                "type": "string",
                "maxLength": 50,
                "title": "Erp product Id",
                "examples": [
                  "45896254"
                ]
              },
              "quantity": {
                "description": "Menge innerhalb des Packstückes",
                "type": "number",
                "title": "Menge",
                "examples": [
                  12
                ]
              },
              "storageRemovalTime": {
                "type": "string",
                "title": "Entnahmezeitpunkt",
                "format": "date-time",
                "description": "Entnahmezeitpunkt",
                "examples": [
                  "2016-04-16T16:06:05Z",
                  "2016-04-16T16:06:05+02:00"
                ]
              },
              "currentStorageLocation": {
                "description": "Lagerort/Lagerkoordinate, wo sich die Ware aktuell befindet",
                "type": "string",
                "maxLength": 50,
                "title": "Lagerort/Lagerkoordinate",
                "examples": [
                  "7.1.15.41.2.01"
                ]
              },
              "supplierNumber": {
                "description": "Lieferantenkennziffer",
                "type": "integer",
                "title": "Supplier number",
                "maxLength": 6,
                "minLength": 1,
                "examples": [
                  1
                ]
              },
              "receivingDocumentNumber": {
                "description": "Warenannahmeprotokoll (WAP) Nummer",
                "type": "integer",
                "title": "Receiving document number",
                "examples": [
                  12
                ],
                "maxLength": 20
              },
              "inspectionId": {
                "description": "Prüfauftrag Identifier",
                "type": "string",
                "title": "Inspection Id",
                "maxLength": 36,
                "examples": [
                  "12"
                ]
              },
              "wmsPositionId": {
                "description": "LVS VorgangsID",
                "type": "string",
                "title": "LVS VorgangsID",
                "maxLength": 36,
                "examples": [
                  "45880014",
                  "390b8b08-20b9-11ed-861d-0242ac120002"
                ]
              }
            },
            "required": [
              "containerId",
              "containerNumber",
              "erpProductId",
              "quantity",
              "storageRemovalTime",
              "currentStorageLocation",
              "supplierNumber",
              "receivingDocumentNumber",
              "inspectionId",
              "wmsPositionId"
            ]
          }
        }
      },
      "required": [
        "location",
        "deliveryNumber",
        "positions"
      ]
    }
  },
  "required": [
    "eventId",
    "eventTime",
    "traceId",
    "eventType",
    "version",
    "data"
  ],
  "examples": [
    {
      "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
      "eventTime": "2016-04-16T16:06:05+02:00",
      "eventType": "PACKAGE_LIST_READY_FOR_QS",
      "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
      "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
      "version": "1.0",
      "context": "QS",
      "metaData": {
        "sender": "KMOTION_ILO",
        "instance": "kMotion-ILO",
        "client": "OTTO"
      },
      "data": {
        "location": "ILOWA",
        "deliveryNumber": "124404",
        "positions": [
          {
            "containerId": "390c3aee-20b9-11ed-861d-0242ac120002",
            "containerNumber": "5487891001",
            "buid": "390c3d1e-20b9-11ed-861d-0242ac120002",
            "erpProductId": "1234567890",
            "quantity": 1,
            "storageRemovalTime": "2022-10-16T16:01:00+02:00",
            "currentStorageLocation": "7.1.15.41.2.01",
            "supplierNumber": 11148,
            "receivingDocumentNumber": 41123,
            "inspectionId": "1234567890",
            "wmsPositionId": "4552140011"
          }
        ]
      }
    }
  ]
}
30 - I09 Package Status after QS
- Status
 - 
Version 1.0 published 22.11.2022
 - Approval
 - Comment
 - Assumption
 - 
_
 
1. Stakeholder
| Role | Application | Responsible | 
|---|---|---|
Communication  | 
Integration Layer  | 
|
Leading App  | 
QS  | 
|
InterfaceOwner  | 
||
Consumer  | 
kMotion  | 
|
Consumer  | 
COBRA  | 
|
Producer  | 
Lionfish  | 
2. Business Context
Die Nachricht wird vom ERP (Ligis/CMS) erzeugt und an FINE übermittelt. FINE bereitet dann diese Daten auf und übermittelt an das Lagerverwaltungssystem. Fachlicher Inhalt: Meldung über Zustand des einzelnen Warenstückes nach Warenprüfung, um LVS-seitig entsprechende Transportaufträge anzustoßen oder Bestandsreduzierungen vorzunehmen (z.B.: bei Vernichtung).
3. Informationflow
4. Interface
4.1. Direction ERP to FINE
4.1.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
context  | 
QS oder CLAIM  | 
eventType  | 
PACKAGE_STATUS_AFTER_QS  | 
4.1.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
PackageStatusAfterQsErp  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta data  | 
sender  | 
string (enum)  | 
sender  Any of:  [
  "KR1_SHF",
  "KR1_HHSTR",
  "WMSX_SON",
  "WMSX_AKU",
  "KMOTION_ILO",
  "KMOTION_GHM",
  "COBRA",
  "LSAS",
  "IDEEFIX",
  "OBS",
  "RESY",
  "LDH",
  "RETAILSCHICHT",
  "BUBE",
  "FINE_INBOUND"
]  | 
instance  | 
string  | 
instance of producer  | 
client  | 
string (enum)  | 
client  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU"
]  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
containerId*  | 
string  | 
Container ID  Maximum Length:  36  | 
buid  | 
string  | 
BUID  Maximum Length:  36  | 
erpProductId*  | 
string  | 
Erp product Id  Maximum Length:  50  | 
quantity*  | 
number  | 
Menge  | 
status*  | 
string  | 
Package status  Maximum Length:  20  | 
4.1.3. Enumeration
status: SELLABLE, DESTROYED
| Meta Value | Description | Short Value | 
|---|
4.1.4. Example
{
  "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
  "eventTime": "2016-04-16T16:06:05+02:00",
  "eventType": "PACKAGE_STATUS_AFTER_QS",
  "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
  "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
  "version": "1.0",
  "context": "QS",
  "metaData": {
    "sender": "KMOTION_ILO",
    "instance": "kMotion-ILO",
    "client": "OTTO"
  },
  "data": {
    "location": "ILOWA",
    "containerId": "390c3aee-20b9-11ed-861d-0242ac120002",
    "buid": "390c3d1e-20b9-11ed-861d-0242ac120002",
    "erpProductId": "1234567890",
    "quantity": 1,
    "status": "DESTROYED"
  }
}
4.1.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
22.11.2022  | 
||
previous version  | 
||||
coming version  | 
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "PackageStatusAfterQsErp",
  "description": "Packstück Status nach der Warenprüfung",
  "type": "object",
  "properties": {
    "eventId": {
      "type": "string",
      "title": "The uniq eventId",
      "maxLength": 36,
      "description": "Global uniq Id, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "eventTime": {
      "type": "string",
      "title": "Time of occurrence of the event",
      "format": "date-time",
      "description": "Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC.",
      "examples": [
        "2016-04-16T16:06:05Z",
        "2016-04-16T16:06:05+02:00"
      ]
    },
    "eventType": {
      "type": "string",
      "title": "The concrete type = kind of record(event)",
      "maxLength": 36,
      "description": "This attribute is to be used if the data set can have more than one characteristic. E.g. goods delivery start or goods delivery end. The possible values are to be co-ordinated here as Enum between the partners.",
      "examples": [
        "PACKAGE_STATUS_AFTER_QS"
      ]
    },
    "traceId": {
      "type": "string",
      "title": "The uniq traceId",
      "maxLength": 36,
      "description": "Global uniq Id for tracing the flow of events, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8138-33418faf1342"
      ]
    },
    "spanId": {
      "type": "string",
      "title": "The eventId of previous record or batchId",
      "maxLength": 36,
      "description": "Optionally, if this record (event) is one of a sequence of records and the order is important, then here is the id of the previous record (event) or event is a part of a batch, recommended as uuid, Special usecases can be specify for some interfaces",
      "examples": [
        "00ce536f-923a-42f4-5463-32a41877b3c2"
      ]
    },
    "version": {
      "description": "Version of the interface",
      "type": "string",
      "pattern": "^[0-9]+[.][0-9]+$",
      "minLength": 3,
      "maxLength": 5,
      "title": "Json schema version",
      "examples": [
        "1.0",
        "1.11",
        "1.1"
      ]
    },
    "context": {
      "type": "string",
      "title": "The context / business case",
      "description": "The optional context specified here means the business domain.",
      "maxLength": 36,
      "examples": [
        "QS", "CLAIM"
      ]
    },
    "metaData": {
      "type": "object",
      "title": "additional meta data",
      "description": "additional meta information for booking interface",
      "properties": {
        "sender": {
          "title": "sender",
          "description": "Name of the source system, that has sent this message.",
          "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/system.v1.schema.json"
        },
        "instance": {
          "title": "instance of producer",
          "type": "string",
          "description": "instance of the application or warehouse context"
        },
        "client": {
          "title": "client",
          "description": "Client/mandant (messages of different clients have different processing rules and destination interfaces) - use FBO for Fulfillment by Otto (CORE, DeepSea...)",
          "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/company.v1.schema.json"
        }
      }
    },
    "data": {
      "type": "object",
      "properties": {
        "location": {
          "description": "Lagerstandort",
          "type": "string",
          "maxLength": 30,
          "minLength": 3,
          "title": "Request location",
          "examples": [
            "LANGENSELBOLD", "ILOWA"
          ]
        },
        "containerId": {
          "description": "Technische ID des Packstückes/Quantes/Gebinde",
          "type": "string",
          "title": "Container ID",
          "maxLength": 36,
          "examples": [
            "390c3e40-20b9-11ed-861d-0242ac120002"
          ]
        },
        "buid": {
          "description": "Eineindeutige Identifizierung eines Teils",
          "type": "string",
          "title": "BUID",
          "maxLength": 36,
          "examples": [
            "390c3e40-20b9-11ed-861d-0242ac120002"
          ]
        },
        "erpProductId": {
          "description": "FINE-LSAS Erp Product Identifier.",
          "type": "string",
          "maxLength": 50,
          "title": "Erp product Id",
          "examples": [
            "45896254"
          ]
        },
        "quantity": {
          "description": "Menge innerhalb des Packstückes",
          "type": "number",
          "title": "Menge",
          "examples": [
            12
          ]
        },
        "status": {
          "description": "Status des Packstückes",
          "type": "string",
          "title": "Package status",
          "maxLength": 20,
          "examples": [
            "SELLABLE", "DESTROYED"
          ]
        }
      },
      "required": [
        "location",
        "containerId",
        "erpProductId",
        "quantity",
        "status"
      ]
    }
  },
  "required": [
    "eventId",
    "eventTime",
    "traceId",
    "eventType",
    "version",
    "data"
  ],
  "examples": [
    {
      "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
      "eventTime": "2016-04-16T16:06:05+02:00",
      "eventType": "PACKAGE_STATUS_AFTER_QS",
      "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
      "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
      "version": "1.0",
      "context": "QS",
      "metaData": {
        "sender": "KMOTION_ILO",
        "instance": "kMotion-ILO",
        "client": "OTTO"
      },
      "data": {
        "location": "ILOWA",
        "containerId": "390c3aee-20b9-11ed-861d-0242ac120002",
        "buid": "390c3d1e-20b9-11ed-861d-0242ac120002",
        "erpProductId": "1234567890",
        "quantity": 1,
        "status": "DESTROYED"
      }
    }
  ]
}
4.2. Direction FINE to WMS
4.2.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
context  | 
QS oder CLAIM  | 
eventType  | 
PACKAGE_STATUS_AFTER_QS  | 
4.2.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
PackageStatusAfterQsWms  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta data  | 
sender  | 
string (enum)  | 
sender  Any of:  [
  "KR1_SHF",
  "KR1_HHSTR",
  "WMSX_SON",
  "WMSX_AKU",
  "KMOTION_ILO",
  "KMOTION_GHM",
  "COBRA",
  "LSAS",
  "IDEEFIX",
  "OBS",
  "RESY",
  "LDH",
  "RETAILSCHICHT",
  "BUBE",
  "FINE_INBOUND"
]  | 
instance  | 
string  | 
instance of producer  | 
client  | 
string (enum)  | 
client  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU"
]  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
containerId*  | 
string  | 
Container ID  Maximum Length:  36  | 
buid  | 
string  | 
BUID  Maximum Length:  36  | 
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  50  | 
quantity*  | 
number  | 
Menge  | 
status*  | 
string  | 
Package status  Maximum Length:  20  | 
4.2.3. Enumeration
status: SELLABLE, DESTROYED
Meta Value  | 
Description  | 
Short Value  | 
4.2.4. Example
{
  "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
  "eventTime": "2016-04-16T16:06:05+02:00",
  "eventType": "PACKAGE_STATUS_AFTER_QS",
  "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
  "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
  "version": "1.0",
  "context": "QS",
  "metaData": {
    "sender": "KMOTION_ILO",
    "instance": "kMotion-ILO",
    "client": "OTTO"
  },
  "data": {
    "location": "ILOWA",
    "containerId": "390c3aee-20b9-11ed-861d-0242ac120002",
    "buid": "390c3d1e-20b9-11ed-861d-0242ac120002",
    "logisticsProductId": "1234567890",
    "quantity": 1,
    "status": "DESTROYED"
  }
}
4.2.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
22.11.2022  | 
||
previous version  | 
||||
coming version  | 
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "PackageStatusAfterQsWms",
  "description": "Packstück Status nach der Warenprüfung",
  "type": "object",
  "properties": {
    "eventId": {
      "type": "string",
      "title": "The uniq eventId",
      "maxLength": 36,
      "description": "Global uniq Id, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "eventTime": {
      "type": "string",
      "title": "Time of occurrence of the event",
      "format": "date-time",
      "description": "Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC.",
      "examples": [
        "2016-04-16T16:06:05Z",
        "2016-04-16T16:06:05+02:00"
      ]
    },
    "eventType": {
      "type": "string",
      "title": "The concrete type = kind of record(event)",
      "maxLength": 36,
      "description": "This attribute is to be used if the data set can have more than one characteristic. E.g. goods delivery start or goods delivery end. The possible values are to be co-ordinated here as Enum between the partners.",
      "examples": [
        "PACKAGE_STATUS_AFTER_QS"
      ]
    },
    "traceId": {
      "type": "string",
      "title": "The uniq traceId",
      "maxLength": 36,
      "description": "Global uniq Id for tracing the flow of events, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8138-33418faf1342"
      ]
    },
    "spanId": {
      "type": "string",
      "title": "The eventId of previous record or batchId",
      "maxLength": 36,
      "description": "Optionally, if this record (event) is one of a sequence of records and the order is important, then here is the id of the previous record (event) or event is a part of a batch, recommended as uuid, Special usecases can be specify for some interfaces",
      "examples": [
        "00ce536f-923a-42f4-5463-32a41877b3c2"
      ]
    },
    "version": {
      "description": "Version of the interface",
      "type": "string",
      "pattern": "^[0-9]+[.][0-9]+$",
      "minLength": 3,
      "maxLength": 5,
      "title": "Json schema version",
      "examples": [
        "1.0",
        "1.11",
        "1.1"
      ]
    },
    "context": {
      "type": "string",
      "title": "The context / business case",
      "description": "The optional context specified here means the business domain.",
      "maxLength": 36,
      "examples": [
        "QS", "CLAIM"
      ]
    },
    "metaData": {
      "type": "object",
      "title": "additional meta data",
      "description": "additional meta information for booking interface",
      "properties": {
        "sender": {
          "title": "sender",
          "description": "Name of the source system, that has sent this message.",
          "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/system.v1.schema.json"
        },
        "instance": {
          "title": "instance of producer",
          "type": "string",
          "description": "instance of the application or warehouse context"
        },
        "client": {
          "title": "client",
          "description": "Client/mandant (messages of different clients have different processing rules and destination interfaces) - use FBO for Fulfillment by Otto (CORE, DeepSea...)",
          "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/company.v1.schema.json"
        }
      }
    },
    "data": {
      "type": "object",
      "properties": {
        "location": {
          "description": "Lagerstandort",
          "type": "string",
          "maxLength": 30,
          "minLength": 3,
          "title": "Request location",
          "examples": [
            "LANGENSELBOLD", "ILOWA"
          ]
        },
        "containerId": {
          "description": "Technische ID des Packstückes/Quantes/Gebinde",
          "type": "string",
          "title": "Container ID",
          "maxLength": 36,
          "examples": [
            "390c3e40-20b9-11ed-861d-0242ac120002"
          ]
        },
        "buid": {
          "description": "Eineindeutige Identifizierung eines Teils",
          "type": "string",
          "title": "BUID",
          "maxLength": 36,
          "examples": [
            "390c3e40-20b9-11ed-861d-0242ac120002"
          ]
        },
        "logisticsProductId": {
          "description": "FINE-LSAS Logistics Product Identifier.",
          "type": "string",
          "maxLength": 50,
          "title": "Logistics product Id",
          "examples": [
            "45896254"
          ]
        },
        "quantity": {
          "description": "Menge innerhalb des Packstückes",
          "type": "number",
          "title": "Menge",
          "examples": [
            12
          ]
        },
        "status": {
          "description": "Status des Packstückes",
          "type": "string",
          "title": "Package status",
          "maxLength": 20,
          "examples": [
            "SELLABLE", "DESTROYED"
          ]
        }
      },
      "required": [
        "location",
        "containerId",
        "logisticsProductId",
        "quantity",
        "status"
      ]
    }
  },
  "required": [
    "eventId",
    "eventTime",
    "traceId",
    "eventType",
    "version",
    "data"
  ],
  "examples": [
    {
      "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
      "eventTime": "2016-04-16T16:06:05+02:00",
      "eventType": "PACKAGE_STATUS_AFTER_QS",
      "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
      "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
      "version": "1.0",
      "context": "QS",
      "metaData": {
        "sender": "KMOTION_ILO",
        "instance": "kMotion-ILO",
        "client": "OTTO"
      },
      "data": {
        "location": "ILOWA",
        "containerId": "390c3aee-20b9-11ed-861d-0242ac120002",
        "buid": "390c3d1e-20b9-11ed-861d-0242ac120002",
        "logisticsProductId": "1234567890",
        "quantity": 1,
        "status": "DESTROYED"
      }
    }
  ]
}
31 - I10 Planned reworks (Deprecated)
- Status
 - 
Deprecated. Merged to I13. This interface will be removed as of 15.05.2025
 - Approval
 - Comment
 - Assumption
 - 
_
 
1. Stakeholder
| Role | Application | Responsible | 
|---|---|---|
Communication  | 
Integration Layer  | 
|
Leading App  | 
QS  | 
|
InterfaceOwner  | 
||
Consumer  | 
kMotion  | 
|
Consumer  | 
COBRA  | 
|
Producer  | 
Lionfish  | 
2. Business Context
Übertragung aller bekannten geplanten Nachbearbeitungen aus Claim-Management-System (CMS) an das Lagerverwaltungssystem.
3. Informationflow
4. Interface
4.1. Direction ERP to FINE
4.1.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
context  | 
CLAIM  | 
eventType  | 
PLANNED_REWORK  | 
4.1.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
AllPlannedReworksErp  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta data  | 
sender  | 
string (enum)  | 
sender  Any of:  [
  "KR1_SHF",
  "KR1_HHSTR",
  "WMSX_SON",
  "WMSX_AKU",
  "KMOTION_ILO",
  "KMOTION_GHM",
  "COBRA",
  "LSAS",
  "IDEEFIX",
  "OBS",
  "RESY",
  "LDH",
  "RETAILSCHICHT",
  "BUBE",
  "FINE_INBOUND"
]  | 
instance  | 
string  | 
instance of producer  | 
client  | 
string (enum)  | 
client  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU"
]  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
cmsId*  | 
string  | 
CMS ID  Maximum Length:  36  | 
validFrom  | 
string (date-time)  | 
Valid from date  | 
validTo  | 
string (date-time)  | 
Valid to date  | 
erpProductId*  | 
string  | 
Erp product Id  Maximum Length:  50  | 
quantity*  | 
number  | 
Quantity  | 
storageNotificationId  | 
array  | 
StorageNotification reference  | 
(Array item)  | 
string  | 
|
activityCode*  | 
array  | 
Activity codes  | 
(Array item)  | 
string  | 
|
supplierNumber*  | 
integer  | 
Supplier number  Minimum Length:  1  | 
companyNumber*  | 
string  | 
Company number  | 
4.1.3. Enumeration
| Meta Value | Description | Short Value | 
|---|
4.1.4. Example
{
  "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
  "eventTime": "2016-04-16T16:06:05+02:00",
  "eventType": "PLANNED_REWORK",
  "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
  "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
  "version": "1.0",
  "context": "CLAIM",
  "metaData": {
    "sender": "KMOTION_ILO",
    "instance": "kMotion-ILO",
    "client": "OTTO"
  },
  "data": {
    "location": "ILOWA",
    "cmsId": "649871002",
    "validFrom": "2022-11-16T16:06:05+02:00",
    "validTo": "2023-06-16T16:06:05+02:00",
    "erpProductId": "1234567890",
    "quantity": 1000,
    "storageNotificationId": ["390c5074-20b9-11ed-861d-0242ac120002", "390c5182-20b9-11ed-861d-0242ac120002"],
    "activityCode": ["12", "84", "41"],
    "supplierNumber": 11183,
    "companyNumber": "0"
  }
}
4.1.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
27.11.2022  | 
||
previous version  | 
||||
coming version  | 
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "AllPlannedReworksErp",
  "description": "Übermittlung aller geplanten Nachbearbeitungen",
  "type": "object",
  "properties": {
    "eventId": {
      "type": "string",
      "title": "The uniq eventId",
      "maxLength": 36,
      "description": "Global uniq Id, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "eventTime": {
      "type": "string",
      "title": "Time of occurrence of the event",
      "format": "date-time",
      "description": "Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC.",
      "examples": [
        "2016-04-16T16:06:05Z",
        "2016-04-16T16:06:05+02:00"
      ]
    },
    "eventType": {
      "type": "string",
      "title": "The concrete type = kind of record(event)",
      "maxLength": 36,
      "description": "This attribute is to be used if the data set can have more than one characteristic. E.g. goods delivery start or goods delivery end. The possible values are to be co-ordinated here as Enum between the partners.",
      "examples": [
        "PLANNED_REWORK"
      ]
    },
    "traceId": {
      "type": "string",
      "title": "The uniq traceId",
      "maxLength": 36,
      "description": "Global uniq Id for tracing the flow of events, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8138-33418faf1342"
      ]
    },
    "spanId": {
      "type": "string",
      "title": "The eventId of previous record or batchId",
      "maxLength": 36,
      "description": "Optionally, if this record (event) is one of a sequence of records and the order is important, then here is the id of the previous record (event) or event is a part of a batch, recommended as uuid, Special usecases can be specify for some interfaces",
      "examples": [
        "00ce536f-923a-42f4-5463-32a41877b3c2"
      ]
    },
    "version": {
      "description": "Version of the interface",
      "type": "string",
      "pattern": "^[0-9]+[.][0-9]+$",
      "minLength": 3,
      "maxLength": 5,
      "title": "Json schema version",
      "examples": [
        "1.0",
        "1.11",
        "1.1"
      ]
    },
    "context": {
      "type": "string",
      "title": "The context / business case",
      "description": "The optional context specified here means the business domain.",
      "maxLength": 36,
      "examples": [
        "CLAIM"
      ]
    },
    "metaData": {
      "type": "object",
      "title": "additional meta data",
      "description": "additional meta information for booking interface",
      "properties": {
        "sender": {
          "title": "sender",
          "description": "Name of the source system, that has sent this message.",
          "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/system.v1.schema.json"
        },
        "instance": {
          "title": "instance of producer",
          "type": "string",
          "description": "instance of the application or warehouse context"
        },
        "client": {
          "title": "client",
          "description": "Client/mandant (messages of different clients have different processing rules and destination interfaces) - use FBO for Fulfillment by Otto (CORE, DeepSea...)",
          "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/company.v1.schema.json"
        }
      }
    },
    "data": {
      "type": "object",
      "properties": {
        "location": {
          "description": "Lagerstandort",
          "type": "string",
          "maxLength": 30,
          "minLength": 3,
          "title": "Request location",
          "examples": [
            "LANGENSELBOLD", "ILOWA"
          ]
        },
        "cmsId": {
          "description": "VorgangsID aus dem System CMS",
          "type": "string",
          "title": "CMS ID",
          "maxLength": 36,
          "examples": [
            "390c3e40-20b9-11ed-861d-0242ac120002"
          ]
        },
        "validFrom": {
          "type": "string",
          "title": "Valid from date",
          "format": "date-time",
          "description": "Gültigkeit der Nachbearbeitung (Anfang).",
          "examples": [
            "2016-04-16T16:06:05Z",
            "2016-04-16T16:06:05+02:00"
          ]
        },
        "validTo": {
          "type": "string",
          "title": "Valid to date",
          "format": "date-time",
          "description": "Gültigkeit der Nachbearbeitung (Ende).",
          "examples": [
            "2016-04-16T16:06:05Z",
            "2016-04-16T16:06:05+02:00"
          ]
        },
        "erpProductId": {
          "description": "FINE-LSAS Erp Product Identifier.",
          "type": "string",
          "maxLength": 50,
          "title": "Erp product Id",
          "examples": [
            "45896254"
          ]
        },
        "quantity": {
          "description": "Soll-Menge",
          "type": "number",
          "title": "Quantity",
          "examples": [
            12000
          ]
        },
        "storageNotificationId": {
          "description": "Liste von StorageNotificationIds",
          "type": "array",
          "title": "StorageNotification reference",
          "items": {
            "type": "string",
            "example": ["390c539e-20b9-11ed-861d-0242ac120002", "390c560a-20b9-11ed-861d-0242ac120002"]
          }
        },
        "activityCode": {
          "description": "Liste der Nachbearbeitungsschritte",
          "type": "array",
          "title": "Activity codes",
          "items": {
            "type": "string",
            "example": ["12", "84", "41"]
          }
        },
        "supplierNumber": {
          "description": "Lieferantenkennziffer",
          "type": "integer",
          "title": "Supplier number",
          "maxLength": 6,
          "minLength": 1,
          "examples": [
            1
          ]
        },
        "companyNumber": {
          "description": "Bestandsfirma",
          "type": "string",
          "title": "Company number",
          "examples": ["0"]
        }
      },
      "required": [
        "location",
        "cmsId",
        "erpProductId",
        "quantity",
        "activityCode",
        "supplierNumber",
        "companyNumber"
      ]
    }
  },
  "required": [
    "eventId",
    "eventTime",
    "traceId",
    "eventType",
    "version",
    "data"
  ],
  "examples": [
    {
      "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
      "eventTime": "2016-04-16T16:06:05+02:00",
      "eventType": "PLANNED_REWORK",
      "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
      "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
      "version": "1.0",
      "context": "CLAIM",
      "metaData": {
        "sender": "KMOTION_ILO",
        "instance": "kMotion-ILO",
        "client": "OTTO"
      },
      "data": {
        "location": "ILOWA",
        "cmsId": "649871002",
        "validFrom": "2022-11-16T16:06:05+02:00",
        "validTo": "2023-06-16T16:06:05+02:00",
        "erpProductId": "1234567890",
        "quantity": 1000,
        "storageNotificationId": ["390c5074-20b9-11ed-861d-0242ac120002", "390c5182-20b9-11ed-861d-0242ac120002"],
        "activityCode": ["12", "84", "41"],
        "supplierNumber": 11183,
        "companyNumber": "0"
      }
    }
  ]
}
4.2. Direction FINE to WMS
4.2.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
context  | 
CLAIM  | 
eventType  | 
PLANNED_REWORK  | 
4.2.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
AllPlannedReworksWms  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string  | 
The concrete type = kind of record(event)  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context  | 
string  | 
The context / business case  Maximum Length:  36  | 
metaData  | 
object  | 
additional meta data  | 
sender  | 
string (enum)  | 
sender  Any of:  [
  "KR1_SHF",
  "KR1_HHSTR",
  "WMSX_SON",
  "WMSX_AKU",
  "KMOTION_ILO",
  "KMOTION_GHM",
  "COBRA",
  "LSAS",
  "IDEEFIX",
  "OBS",
  "RESY",
  "LDH",
  "RETAILSCHICHT",
  "BUBE",
  "FINE_INBOUND"
]  | 
instance  | 
string  | 
instance of producer  | 
client  | 
string (enum)  | 
client  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU"
]  | 
data*  | 
object  | 
|
location*  | 
string  | 
Request location  Minimum Length:  3  | 
cmsId*  | 
string  | 
CMS ID  Maximum Length:  36  | 
validFrom  | 
string (date-time)  | 
Valid from date  | 
validTo  | 
string (date-time)  | 
Valid to date  | 
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  50  | 
quantity*  | 
number  | 
Quantity  | 
storageNotificationId  | 
array  | 
StorageNotification reference  | 
(Array item)  | 
string  | 
|
activityCode*  | 
array  | 
Activity codes  | 
(Array item)  | 
string  | 
|
supplierNumber*  | 
integer  | 
Supplier number  Minimum Length:  1  | 
companyNumber*  | 
string  | 
Company number  | 
4.2.3. Enumeration
Meta Value  | 
Description  | 
Short Value  | 
4.2.4. Example
{
  "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
  "eventTime": "2016-04-16T16:06:05+02:00",
  "eventType": "PLANNED_REWORK",
  "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
  "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
  "version": "1.0",
  "context": "CLAIM",
  "metaData": {
    "sender": "KMOTION_ILO",
    "instance": "kMotion-ILO",
    "client": "OTTO"
  },
  "data": {
    "location": "ILOWA",
    "cmsId": "649871002",
    "validFrom": "2022-11-16T16:06:05+02:00",
    "validTo": "2023-06-16T16:06:05+02:00",
    "logisticsProductId": "1234567890",
    "quantity": 1000,
    "storageNotificationId": ["390c5074-20b9-11ed-861d-0242ac120002", "390c5182-20b9-11ed-861d-0242ac120002"],
    "activityCode": ["12", "84", "41"],
    "supplierNumber": 11183,
    "companyNumber": "0"
  }
}
4.2.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
27.11.2022  | 
||
previous version  | 
||||
coming version  | 
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "AllPlannedReworksWms",
  "description": "Übermittlung aller geplanten Nachbearbeitungen",
  "type": "object",
  "properties": {
    "eventId": {
      "type": "string",
      "title": "The uniq eventId",
      "maxLength": 36,
      "description": "Global uniq Id, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "eventTime": {
      "type": "string",
      "title": "Time of occurrence of the event",
      "format": "date-time",
      "description": "Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC.",
      "examples": [
        "2016-04-16T16:06:05Z",
        "2016-04-16T16:06:05+02:00"
      ]
    },
    "eventType": {
      "type": "string",
      "title": "The concrete type = kind of record(event)",
      "maxLength": 36,
      "description": "This attribute is to be used if the data set can have more than one characteristic. E.g. goods delivery start or goods delivery end. The possible values are to be co-ordinated here as Enum between the partners.",
      "examples": [
        "PLANNED_REWORK"
      ]
    },
    "traceId": {
      "type": "string",
      "title": "The uniq traceId",
      "maxLength": 36,
      "description": "Global uniq Id for tracing the flow of events, recommended as uuid",
      "examples": [
        "00ce536f-923a-42f4-8138-33418faf1342"
      ]
    },
    "spanId": {
      "type": "string",
      "title": "The eventId of previous record or batchId",
      "maxLength": 36,
      "description": "Optionally, if this record (event) is one of a sequence of records and the order is important, then here is the id of the previous record (event) or event is a part of a batch, recommended as uuid, Special usecases can be specify for some interfaces",
      "examples": [
        "00ce536f-923a-42f4-5463-32a41877b3c2"
      ]
    },
    "version": {
      "description": "Version of the interface",
      "type": "string",
      "pattern": "^[0-9]+[.][0-9]+$",
      "minLength": 3,
      "maxLength": 5,
      "title": "Json schema version",
      "examples": [
        "1.0",
        "1.11",
        "1.1"
      ]
    },
    "context": {
      "type": "string",
      "title": "The context / business case",
      "description": "The optional context specified here means the business domain.",
      "maxLength": 36,
      "examples": [
        "CLAIM"
      ]
    },
    "metaData": {
      "type": "object",
      "title": "additional meta data",
      "description": "additional meta information for booking interface",
      "properties": {
        "sender": {
          "title": "sender",
          "description": "Name of the source system, that has sent this message.",
          "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/system.v1.schema.json"
        },
        "instance": {
          "title": "instance of producer",
          "type": "string",
          "description": "instance of the application or warehouse context"
        },
        "client": {
          "title": "client",
          "description": "Client/mandant (messages of different clients have different processing rules and destination interfaces) - use FBO for Fulfillment by Otto (CORE, DeepSea...)",
          "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/company.v1.schema.json"
        }
      }
    },
    "data": {
      "type": "object",
      "properties": {
        "location": {
          "description": "Lagerstandort",
          "type": "string",
          "maxLength": 30,
          "minLength": 3,
          "title": "Request location",
          "examples": [
            "LANGENSELBOLD", "ILOWA"
          ]
        },
        "cmsId": {
          "description": "VorgangsID aus dem System CMS",
          "type": "string",
          "title": "CMS ID",
          "maxLength": 36,
          "examples": [
            "390c3e40-20b9-11ed-861d-0242ac120002"
          ]
        },
        "validFrom": {
          "type": "string",
          "title": "Valid from date",
          "format": "date-time",
          "description": "Gültigkeit der Nachbearbeitung (Anfang).",
          "examples": [
            "2016-04-16T16:06:05Z",
            "2016-04-16T16:06:05+02:00"
          ]
        },
        "validTo": {
          "type": "string",
          "title": "Valid to date",
          "format": "date-time",
          "description": "Gültigkeit der Nachbearbeitung (Ende).",
          "examples": [
            "2016-04-16T16:06:05Z",
            "2016-04-16T16:06:05+02:00"
          ]
        },
        "logisticsProductId": {
          "description": "FINE-LSAS Logistics Product Identifier.",
          "type": "string",
          "maxLength": 50,
          "title": "Logistics product Id",
          "examples": [
            "45896254"
          ]
        },
        "quantity": {
          "description": "Soll-Menge",
          "type": "number",
          "title": "Quantity",
          "examples": [
            12000
          ]
        },
        "storageNotificationId": {
          "description": "Liste von StorageNotificationIds",
          "type": "array",
          "title": "StorageNotification reference",
          "items": {
            "type": "string",
            "example": ["390c539e-20b9-11ed-861d-0242ac120002", "390c560a-20b9-11ed-861d-0242ac120002"]
          }
        },
        "activityCode": {
          "description": "Liste der Nachbearbeitungsschritte",
          "type": "array",
          "title": "Activity codes",
          "items": {
            "type": "string",
            "example": ["12", "84", "41"]
          }
        },
        "supplierNumber": {
          "description": "Lieferantenkennziffer",
          "type": "integer",
          "title": "Supplier number",
          "maxLength": 6,
          "minLength": 1,
          "examples": [
            1
          ]
        },
        "companyNumber": {
          "description": "Bestandsfirma",
          "type": "string",
          "title": "Company number",
          "examples": ["0"]
        }
      },
      "required": [
        "location",
        "cmsId",
        "logisticsProductId",
        "quantity",
        "activityCode",
        "supplierNumber",
        "companyNumber"
      ]
    }
  },
  "required": [
    "eventId",
    "eventTime",
    "traceId",
    "eventType",
    "version",
    "data"
  ],
  "examples": [
    {
      "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
      "eventTime": "2016-04-16T16:06:05+02:00",
      "eventType": "PLANNED_REWORK",
      "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
      "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
      "version": "1.0",
      "context": "CLAIM",
      "metaData": {
        "sender": "KMOTION_ILO",
        "instance": "kMotion-ILO",
        "client": "OTTO"
      },
      "data": {
        "location": "ILOWA",
        "cmsId": "649871002",
        "validFrom": "2022-11-16T16:06:05+02:00",
        "validTo": "2023-06-16T16:06:05+02:00",
        "logisticsProductId": "1234567890",
        "quantity": 1000,
        "storageNotificationId": ["390c5074-20b9-11ed-861d-0242ac120002", "390c5182-20b9-11ed-861d-0242ac120002"],
        "activityCode": ["12", "84", "41"],
        "supplierNumber": 11183,
        "companyNumber": "0"
      }
    }
  ]
}
32 - I13 Planned and Unplanned Reworks
- Status
 - 
Version 2.0 published 15.05.2025
 - Approval
 - Comment
 - Assumption
 - 
_
 
1. Stakeholder
| Role | Application | Responsible | 
|---|---|---|
Communication  | 
Integration Layer  | 
|
Leading App  | 
FINE Inbound  | 
|
InterfaceOwner  | 
FINE Inbound  | 
|
Consumer  | 
kMotion  | 
|
Producer  | 
Lionfish  | 
2. Business Context
Anlage einer geplanten oder ungeplanten Nachbearbeitung und Übertragung notwendiger Informationen an das Lagerverwaltungssystem.
3. Informationflow
4. Interface
4.1. Direction ERP to FINE
4.1.1. Header
This interface uses the Service Header
4.1.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
PlannedUnplannedReworkErp  | 
eventId*  | 
string  | 
The unique eventId  | 
traceId*  | 
string  | 
The unique traceId  | 
spanId*  | 
string  | 
The eventId of previous record or batchId  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
The number of version schema  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "CLAIM"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "PLANNED_REWORK",
  "UNPLANNED_REWORK",
  "SECONDARY_INSPECTION"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string  | 
Sender  | 
client  | 
string  | 
Client  | 
data*  | 
object  | 
|
location*  | 
string (enum)  | 
The receiving warehouse  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"
]  | 
positions*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
erpProductId*  | 
string  | 
Erp product Id  Maximum Length:  36  | 
quantity*  | 
number  | 
Menge  Maximum:  999999  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
supplierNumber*  | 
integer  | 
Supplier number  Maximum Length:  7  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Minimum:  100000  | 
goodsInPositionId*  | 
string  | 
Technischer Schlüssel der Anlieferposition  Maximum Length:  36  | 
purchaseOrderNumber  | 
array  | 
Purchase Order Number  | 
(Array item)  | 
string  | 
 Maximum Length:  36  | 
storageNotificationId  | 
array  | 
Storage Notification Id  | 
(Array item)  | 
string  | 
 Maximum Length:  36  | 
containerId  | 
string  | 
Container ID  Maximum Length:  36  | 
containerNumber  | 
string  | 
Container number  Maximum Length:  50  | 
buaid  | 
string  | 
BUAID  Maximum Length:  36  | 
4.1.3. Enumeration
Field: Event Type
| Meta Value | Description | Short Value | 
|---|---|---|
PLANNED_REWORK  | 
Geplante Nachbearbeitung  | 
|
UNPLANNED_REWORK  | 
Ungeplante Nachbearbeitung  | 
|
SECONDARY_INSPECTION  | 
Zweitprüfung  | 
Field: Context
| Meta Value | Description | Short Value | 
|---|---|---|
CLAIM  | 
Nachbearbeitung  | 
4.1.4. Example
{
  "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
  "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
  "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
  "eventTime": "2023-04-12T16:06:05.036+01:00",
  "version": "2.0",
  "context": "CLAIM",
  "eventType": "UNPLANNED_REWORK",
  "metaData": {
    "sender": "CMS"
  },
  "data": {
    "location": "ILOWA",
    "positions": [
      {
        "erpProductId": "1234567890",
        "quantity": 1,
        "deliveryNumber": "124404",
        "supplierNumber": 11148,
        "receivingDocumentNumber": 41123,
        "goodsInPositionId": "4552140011",
        "purchaseOrderNumber": ["115410"],
        "storageNotificationId": ["00ce536f-923a-42f4-8128-be118faf1d87"],
        "containerId": "390c3aee-20b9-11ed-861d-0242ac120002",
        "containerNumber": "5487891001",
        "buaid": "390c3d1e-20b9-11ed-861d-0242ac120002"
      }
    ]
  }
}
4.1.5. Schema
Version  | 
Number  | 
File  | 
Published on  | 
Changes  | 
coming version  | 
2.0  | 
15.05.2025  | 
||
current version  | 
1.0  | 
27.11.2022  | 
||
previous version  | 
4.1.6. Changelog
Changes V1.0 → V2.0
- 
Standard header eingeführt/Headerattribute angepasst. Unterscheidung geplante- und ungeplante Nachbearbeitungen über eventType.
 - 
Attribut buid umbenannt in buaid
 - 
Attribute activityCode und cmsId entfernt
 - 
Attribut wmsPositionId umbenannt in goodsInPositionId
 - 
Attribute purchaseOrderNumber und storageNotificationId aufgenommen
 
4.2. Direction FINE to WMS
4.2.1. Header
This interface uses the Service Header
4.2.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
PlannedUnplannedReworkWms  | 
eventId*  | 
string  | 
The unique eventId  | 
traceId*  | 
string  | 
The unique traceId  | 
spanId*  | 
string  | 
The eventId of previous record or batchId  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
The number of version schema  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "CLAIM"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "PLANNED_REWORK",
  "UNPLANNED_REWORK",
  "SECONDARY_INSPECTION"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string  | 
Sender  | 
client  | 
string  | 
Client  | 
data*  | 
object  | 
|
location*  | 
string (enum)  | 
The receiving warehouse  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"
]  | 
positions*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  36  | 
quantity*  | 
number  | 
Menge  Maximum:  999999  | 
deliveryNumber*  | 
string  | 
Delivery Number  Maximum Length:  36  | 
supplierNumber*  | 
integer  | 
Supplier number  Maximum Length:  7  | 
receivingDocumentNumber*  | 
integer  | 
Receiving document number  Minimum:  100000  | 
goodsInPositionId*  | 
string  | 
Technischer Schlüssel der Anlieferposition  Maximum Length:  36  | 
purchaseOrderNumber  | 
array  | 
Purchase Order Number  | 
(Array item)  | 
string  | 
 Maximum Length:  36  | 
storageNotificationId  | 
array  | 
Storage Notification Id  | 
(Array item)  | 
string  | 
 Maximum Length:  36  | 
containerId  | 
string  | 
Container ID  Maximum Length:  36  | 
containerNumber  | 
string  | 
Container number  Maximum Length:  50  | 
buaid  | 
string  | 
BUAID  Maximum Length:  36  | 
4.2.3. Enumeration
Field: Event Type
| Meta Value | Description | Short Value | 
|---|---|---|
PLANNED_REWORK  | 
Geplante Nachbearbeitung  | 
|
UNPLANNED_REWORK  | 
Ungeplante Nachbearbeitung  | 
|
SECONDARY_INSPECTION  | 
Zweitprüfung  | 
Field: Context
| Meta Value | Description | Short Value | 
|---|---|---|
CLAIM  | 
Nachbearbeitung  | 
4.2.4. Example
{
  "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
  "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
  "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
  "eventTime": "2023-04-12T16:06:05.036+01:00",
  "version": "2.0",
  "context": "CLAIM",
  "eventType": "UNPLANNED_REWORK",
  "metaData": {
    "sender": "CMS"
  },
  "data": {
    "location": "ILOWA",
    "positions": [
      {
        "logisticsProductId": "1234567890",
        "quantity": 1,
        "deliveryNumber": "124404",
        "supplierNumber": 11148,
        "receivingDocumentNumber": 41123,
        "goodsInPositionId": "4552140011",
        "purchaseOrderNumber": ["115410"],
        "storageNotificationId": ["00ce536f-923a-42f4-8128-be118faf1d87"],
        "containerId": "390c3aee-20b9-11ed-861d-0242ac120002",
        "containerNumber": "5487891001",
        "buaid": "390c3d1e-20b9-11ed-861d-0242ac120002"
      }
    ]
  }
}
4.2.5. Schema
Version  | 
Number  | 
File  | 
Published on  | 
Changes  | 
coming version  | 
2.0  | 
15.05.2025  | 
||
current version  | 
1.0  | 
27.11.2022  | 
||
previous version  | 
4.2.6. Changelog
Changes V1.0 → V2.0
- 
Standard header eingeführt/Headerattribute angepasst. Unterscheidung geplante- und ungeplante Nachbearbeitungen über eventType.
 - 
Attribut buid umbenannt in buaid
 - 
Attribute activityCode und cmsId entfernt
 - 
Attribut wmsPositionId umbenannt in goodsInPositionId
 - 
Attribute purchaseOrderNumber und storageNotificationId aufgenommen
 
33 - I15 Executed rework steps
- Status
 - 
Version 2.0 published 13.06.2025
 - Approval
 - Comment
 - Assumption
 - 
_
 
1. Stakeholder
| Role | Application | Responsible | 
|---|---|---|
Communication  | 
Integration Layer  | 
|
Leading App  | 
FINE Inbound  | 
|
InterfaceOwner  | 
FINE Inbound  | 
|
Producer  | 
kMotion  | 
|
Producer  | 
KR1  | 
|
Consumer  | 
Flash  | 
2. Business Context
Bei der Rückmeldung an das ERP werden die durchgeführten Aufbereitungsschritte pro Artikel und Anlieferung im Rahmen des ETUP (bzw. separaten Arbeitsplatz für diese kleineres Nachbearbeitungs-Schritte) übertragen.
3. Informationflow
4. Interface
4.1. Direction WMS to FINE
4.1.1. Header
This interface uses the Service Header
4.1.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
ExecutedReworkStepsWms  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "EXECUTED_REWORK_STEPS"
]  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "GOODSIN_NEW_GOODS",
  "GOODSIN_STOCK_TRANSFER"
]  | 
metaData  | 
object  | 
additional meta data  | 
sender  | 
string (enum)  | 
sender  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",
  "EFI",
  "ABOUTYOU",
  "WITT",
  "MFC_HRL_HHSTR"
]  | 
data*  | 
object  | 
|
location*  | 
string (enum)  | 
The sending warehouse  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"
]  | 
deliveryNumber  | 
string  | 
Delivery Number  Maximum Length:  36  | 
containerId  | 
string  | 
Container ID  Maximum Length:  36  | 
wmsReferenceId  | 
string  | 
WMS reference id  Maximum Length:  36  | 
positions*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  50  | 
activities*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
activityCode*  | 
string  | 
Activity code  Maximum Length:  30  | 
quantity*  | 
number  | 
Menge  | 
supplierNumber  | 
integer  | 
Supplier number  Maximum:  9999999  | 
receivingDocumentNumber  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
goodsInPositionId  | 
string  | 
Position Id  Maximum Length:  36  | 
4.1.3. Enumeration
Field: Event Type
| Meta Value | Description | Short Value | 
|---|---|---|
EXECUTED_REWORK_STEPS  | 
Field: Context
| Meta Value | Description | Short Value | 
|---|---|---|
GOODSIN_NEW_GOODS  | 
Wareneingang Neuware  | 
|
GOODSIN_STOCK_TRANSFER  | 
Wareneingang aus Umfuhr  | 
4.1.4. Example
{
  "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
  "eventTime": "2023-04-12T16:06:05.036+01:00",
  "eventType": "EXECUTED_REWORK_STEPS",
  "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
  "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
  "version": "2.0",
  "context": "GOODSIN_NEW_GOODS",
  "metaData": {
    "sender": "KMOTION_ILO"
  },
  "data": {
    "location": "ILOWA",
    "deliveryNumber": "124404",
    "positions": [
      {
        "logisticsProductId": "1234567890",
        "activities" : [
          {
            "activityCode": "34",
            "quantity": 1
          }
        ],
        "supplierNumber": 11148,
        "receivingDocumentNumber": 41123,
        "goodsInPositionId": "4552140011"
      }
    ]
  }
}
4.1.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
27.11.2022  | 
||
previous version  | 
||||
coming version  | 
2.0  | 
13.06.2025  | 
Siehe Kapitel Changelog weiter unten  | 
4.1.6. Changelog
Changes V1.0 → V2.0
- 
attribute eventTime is of local time
 - 
new enum for the attributes eventType, context, location
 - 
attributes instance, client, cmsId, quantity removed
 - 
enumeration system updated to version 10
 - 
attribute wmsPositionId renamed into goodsInPositionId
 - 
following attributes are now optional: deliveryNumber, receivingDocumentNumber, goodsInPositionId, supplierNumber
 - 
new complex type for activities: activityCode and quantity
 - 
new attribute introduced: containerId, wmsReferenceId
 
4.2. Direction FINE to ERP
4.2.1. Header
This interface uses the Service Header
4.2.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
ExecutedReworkStepsErp  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "EXECUTED_REWORK_STEPS"
]  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "GOODSIN_NEW_GOODS",
  "GOODSIN_STOCK_TRANSFER"
]  | 
metaData  | 
object  | 
additional meta data  | 
sender  | 
string (enum)  | 
sender  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",
  "EFI",
  "ABOUTYOU",
  "WITT",
  "MFC_HRL_HHSTR"
]  | 
data*  | 
object  | 
|
location*  | 
string (enum)  | 
The sending warehouse  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"
]  | 
deliveryNumber  | 
string  | 
Delivery Number  Maximum Length:  36  | 
containerId  | 
string  | 
Container ID  Maximum Length:  36  | 
wmsReferenceId  | 
string  | 
WMS reference id  Maximum Length:  36  | 
positions*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  50  | 
erpProductId*  | 
string  | 
ERP Product Id  Maximum Length:  36  | 
ownerCompany*  | 
string  | 
Owner Company (BDF)  | 
activities*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
activityCode*  | 
string  | 
Activity code  Maximum Length:  30  | 
quantity*  | 
number  | 
Menge  | 
supplierNumber  | 
integer  | 
Supplier number  Maximum:  9999999  | 
receivingDocumentNumber  | 
integer  | 
Receiving document number  Maximum Length:  20  | 
goodsInPositionId  | 
string  | 
Position Id  Maximum Length:  36  | 
4.2.3. Enumeration
Field: Event Type
| Meta Value | Description | Short Value | 
|---|---|---|
EXECUTED_REWORK_STEPS  | 
Field: Context
| Meta Value | Description | Short Value | 
|---|---|---|
GOODSIN_NEW_GOODS  | 
Wareneingang Neuware  | 
|
GOODSIN_STOCK_TRANSFER  | 
Wareneingang aus Umfuhr  | 
4.2.4. Example
{
  "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
  "eventTime": "2023-04-12T16:06:05.036+01:00",
  "eventType": "EXECUTED_REWORK_STEPS",
  "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
  "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
  "version": "2.0",
  "context": "GOODSIN_NEW_GOODS",
  "metaData": {
    "sender": "KMOTION_ILO"
  },
  "data": {
    "location": "ILOWA",
    "deliveryNumber": "124404",
    "positions": [
      {
        "logisticsProductId": "1234567890",
        "erpProductId": "804f2105-e5b7-4295-a6ae-02cc1cdc9c04",
        "ownerCompany": "OTTO",
        "activities" : [
          {
            "activityCode": "34",
            "quantity": 1
          }
        ],
        "supplierNumber": 11148,
        "receivingDocumentNumber": 41123,
        "goodsInPositionId": "4552140011"
      }
    ]
  }
}
4.2.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
27.11.2022  | 
||
previous version  | 
||||
coming version  | 
2.0  | 
13.06.2025  | 
Siehe Kapitel Changelog weiter unten  | 
4.2.6. Changelog
Changes V1.0 → V2.0
- 
attribute eventTime is of local time
 - 
new enum for the attributes eventType, context, location
 - 
attributes instance, client, cmsId, quantity removed
 - 
enumeration system updated to version 10
 - 
attribute wmsPositionId renamed into goodsInPositionId
 - 
following attributes are now optional: deliveryNumber, receivingDocumentNumber, goodsInPositionId, supplierNumber
 - 
new complex type for activities: activityCode and quantity
 - 
new attributes introduced: containerId, ownerCompany, wmsReferenceId
 
34 - I19 Stock Transfer
- Status
 - 
Version 2.2 published 25.07.2025
 - Approval
 - Comment
 - Assumption
 - 
_
 
1. Stakeholder
| Role | Application | Responsible | 
|---|---|---|
Communication  | 
Integration Layer  | 
|
Leading App  | 
Inbound  | 
|
InterfaceOwner  | 
||
Producer and Consumer  | 
kMotion  | 
2. Business Context
Avisierung von Umfuhren zwischen Lagerstandorten. Es werden die tatsächlich umgefahrenen Artikel und Packstücke gemeldet. Die Umfuhraufträge vom Händler werden nicht über diese Schnittstelle an das Lagerverwaltunssystem übermittelt.
3. Informationflow
4. Interface
4.1. Direction WMS to FINE and FINE to WMS
4.1.1. Header
This interface uses the Service Header
Special expresion for this interface:
| Fieldname | Expresion | 
|---|---|
eventType  | 
STOCK_TRANSFER_BETWEEN_WAREHOUSES STOCK_TRANSFER_CANCELLATION  | 
context  | 
STOCK_TRANSFER  | 
4.1.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
Stock Transfer  | 
eventId*  | 
string  | 
The uniqe eventId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "STOCK_TRANSFER_BETWEEN_WAREHOUSES",
  "STOCK_TRANSFER_CANCELLATION"
]  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
version*  | 
string  | 
Version of the interface  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "STOCK_TRANSFER"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string  | 
sender  Maximum Length:  30  | 
client  | 
string  | 
client  Maximum Length:  30  | 
data*  | 
object  | 
|
locationSource*  | 
string  | 
Source warehouse  Minimum Length:  3  | 
locationTarget*  | 
string (enum)  | 
Target warehouse  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"
]  | 
wmsOrderId*  | 
string  | 
WMS Order ID  Maximum Length:  36  | 
transportStartTime  | 
string (date-time)  | 
Start time from source warehouse  | 
positions*  | 
array  | 
 Minimum number of items  1  | 
(Array item)  | 
object  | 
|
b2bOrderId  | 
string  | 
ERP Order ID  Maximum Length:  36  | 
voucherNumber  | 
integer  | 
Belegnummer  Maximum Length:  6  | 
loadingNumber  | 
string  | 
Loading Number  Maximum Length:  12  | 
originalLoadingNumber  | 
string  | 
Original Loading Number  Maximum Length:  12  | 
wabNumber  | 
string  | 
WAB Number  Maximum Length:  30  | 
latestStorageTime  | 
string (date-time)  | 
Latest storage time at the target warehouse  | 
priority  | 
string (enum)  | 
Priority for transport  Any of:  [
  "PRIORITY_A",
  "PRIORITY_B"
]  | 
stockType*  | 
string (enum)  | 
Stock type  Any of:  [
  "STOCK_ITEM",
  "LOCKED",
  "DLW",
  "NLR"
]  | 
transportType*  | 
string (enum)  | 
Transport type  Any of:  [
  "STOCK_TRANSFER",
  "RETURN_INBOUND",
  "RETURN_SUPPLIER",
  "INTERNAL_REMOVAL_FROM_INBOUND",
  "INTERNAL_REMOVAL_FOR_SAMPLE",
  "SUPPLY",
  "STOCK_TRANSFER_WITH_PROMISE",
  "FINAL_REMOVAL",
  "OTTO_MARKET",
  "INBOUND_SAMPLE",
  "GOODSIN_B2B",
  "GOODSIN_RETAIL"
]  | 
containerId*  | 
string  | 
Container ID  Maximum Length:  36  | 
containerNumber*  | 
string  | 
Container number  Maximum Length:  50  | 
containerPackaging*  | 
string  | 
Container packaging  Maximum Length:  50  | 
parentContainerId  | 
string  | 
Parent container ID  Maximum Length:  36  | 
parentContainerNumber  | 
string  | 
Parent container number  Maximum Length:  36  | 
parentContainerPackaging  | 
string  | 
Parent container packaging  Maximum Length:  50  | 
logisticsProductId*  | 
string  | 
Logistics product Id  Maximum Length:  36  | 
erpProductId  | 
string  | 
ERP Product Id  Maximum Length:  36  | 
partNumber*  | 
integer  | 
Part number  Maximum Length:  6  | 
productDetails  | 
object  | 
|
buid  | 
string  | 
BUID  Maximum Length:  36  | 
rfid  | 
string  | 
RFID  Maximum Length:  64  | 
imei1  | 
string  | 
IMEI1  Maximum Length:  16  | 
imei2  | 
string  | 
IMEI2  Maximum Length:  16  | 
producerId  | 
string  | 
Producer ID  Maximum Length:  36  | 
batchId  | 
string  | 
Batch ID  Maximum Length:  40  | 
bestBeforeDate  | 
string (date-time)  | 
Best before date  | 
ownerCompany*  | 
string  | 
Owner Company (BDF)  Maximum Length:  30  | 
supplierNumber*  | 
integer  | 
Supplier number  Maximum Length:  6  | 
logisticsSupplierId  | 
string  | 
Logistics supplier id  Maximum Length:  36  | 
quantity*  | 
number  | 
Quantity  | 
deliveryNumber  | 
string  | 
Delivery Number  Maximum Length:  36  | 
deliveryNumberShort  | 
integer  | 
Delivery number short  Maximum Length:  7  | 
receivingDocumentNumber  | 
integer  | 
Receiving document number  Maximum Length:  6  | 
customsStatus*  | 
string (enum)  | 
Customs status  Any of:  [
  "FREE",
  "DUTY",
  "NOT_DEFINED"
]  | 
storageNotificationId  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
deliveryPositionId  | 
string  | 
Delivery Position Id  Maximum Length:  36  | 
sortDestination  | 
integer  | 
Sort Destination  Maximum Length:  4  | 
returnsKey  | 
string  | 
Returns Key  Maximum Length:  36  | 
returnsEvaluationCode  | 
string  | 
Returns evaluation code  Maximum Length:  50  | 
orderDescription  | 
string  | 
Order description  Maximum Length:  100  | 
lockReason  | 
string (enum)  | 
Lock reason type  Any of:  [
  "REQUEST_BY_MERCHANT",
  "QUALITY_PROBLEMS",
  "WRONG_LABEL",
  "RESERVED_FOR_IWA",
  "DIFFERENCES",
  "OTHER"
]  | 
lockReasonText  | 
string  | 
Lock reason text  Maximum Length:  1000  | 
4.1.3. Enumeration
Field: Priority
| Meta Value | Description | 
|---|---|
PRIORITY_A  | 
Renner  | 
PRIORITY_B  | 
Penner  | 
Field: Stock type
| Meta Value | Description | 
|---|---|
STOCK_ITEM  | 
Lagerware frei  | 
LOCKED  | 
Lagerware gesperrt  | 
DLW  | 
Durchlaufware  | 
NLR  | 
Nichtlagerfähige Retouren  | 
Field: Transport type
| Meta Value | Description | 
|---|---|
STOCK_TRANSFER  | 
Bestandsumfuhr normal  | 
RETURN_INBOUND  | 
Umfuhr-für-WRS-aus WE  | 
RETURN_SUPPLIER  | 
Umfuhr-für-WRS von Lieferant  | 
INTERNAL_REMOVAL_FROM_INBOUND  | 
Umfuhr für IWA aus Wareneingang / Warenprüfung  | 
INTERNAL_REMOVAL_FOR_SAMPLE  | 
Umfuhr für IWA für Muster  | 
SUPPLY  | 
Großkundenauftrag  | 
STOCK_TRANSFER_WITH_PROMISE  | 
Zusagbare Umfuhr  | 
FINAL_REMOVAL  | 
Endauslagerung  | 
OTTO_MARKET  | 
Otto Market  | 
INBOUND_SAMPLE  | 
Muster  | 
GOODSIN_B2B  | 
Umfuhr von Neuware  | 
GOODSIN_RETAIL  | 
Rückführung aus Filiale  | 
Field: Customs status
| Meta Value | Description | 
|---|---|
FREE  | 
Freigut  | 
DUTY  | 
Zollgut  | 
NOT_DEFINED  | 
Nicht definiert  | 
Field: Lock reason
| Meta Value | Description | 
|---|---|
REQUEST_BY_MERCHANT  | 
Anlieferung soll vorerst nicht verkauft werden, weil Materialzusammensetzung oder Farbnuance vom restlichen Bestand abweicht  | 
QUALITY_PROBLEMS  | 
Meist festgestellt bei nachgelagerter Warenprüfung oder im KS-Prozess  | 
WRONG_LABEL  | 
Meist festgestellt bei nachgelagerter Warenprüfung oder im KS-Prozess  | 
RESERVED_FOR_IWA  | 
Für angekündigte in- bzw. externe Warenanforderungen  | 
DIFFERENCES  | 
Bei falscher Mengeneingabe in der SEIN, Auslagerung zur Prüfung nicht taggleich möglich  | 
OTHER  | 
Grund per Freitext angegeben  | 
4.1.4. Example
{
  "eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
  "eventTime": "2023-04-12T16:06:05.036+01:00",
  "eventType": "STOCK_TRANSFER_BETWEEN_WAREHOUSES",
  "traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
  "spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
  "version": "2.2",
  "context": "STOCK_TRANSFER",
  "metaData": {
    "sender": "KMOTION_ILOWA",
    "client": "OTTO"
  },
  "data": {
    "locationSource": "ILOWA",
    "locationTarget": "SUEDHAFEN",
    "wmsOrderId": "390c4f5c-20b9-11ed-861d-0242ac120002",
    "transportStartTime": "2022-03-31T12:41:06.036+01:00",
    "positions": [
      {
        "b2bOrderId": "390c4084-20b9-11ed-861d-0242ac120002",
        "voucherNumber": 951145,
        "loadingNumber": "784414470093",
        "wabNumber": "23545359",
        "latestStorageTime": "2022-03-31T12:41:06.036+01:00",
        "priority": "PRIORITY_A",
        "stockType": "STOCK_ITEM",
        "transportType": "STOCK_TRANSFER",
        "containerId": "390c3aee-20b9-11ed-861d-0242ac120002",
        "containerNumber": "5487891001",
        "containerPackaging": "Norm 5 Karton",
        "parentContainerId": "390c3aee-20b9-11ed-861d-0242ac120002",
        "parentContainerNumber": "987251015011",
        "parentContainerPackaging": "Norm 20 Palette",
        "logisticsProductId": "1234567890",
        "erpProductId": "390c3aee-20b9-11ed-861d-0242ac120002",
        "partNumber": 1,
        "productDetails": {
          "buid": "390c3d1e-20b9-11ed-861d-0242ac120002",
          "rfid": "390c48a4-20b9-11ed-861d-0242ac120002",
          "imei1": "835468951314981",
          "imei2": "835468951314982",
          "producerId": "390c4732-20b9-11ed-861d-0242ac120002",
          "batchId": "390c4e1c-20b9-11ed-861d-0242ac120002",
          "bestBeforeDate": "2022-11-06T16:00:00+02:00"
        },
        "ownerCompany": "OTTO",
        "supplierNumber": 11148,
        "logisticsSupplierId": "461218997",
        "quantity": 1,
        "deliveryNumber": "124404",
        "deliveryNumberShort": 1458498,
        "receivingDocumentNumber": 41123,
        "customsStatus": "FREE",
        "storageNotificationId": "390c3e40-20b9-11ed-861d-0242ac120002",
        "deliveryPositionId": "390c43fe-20b9-11ed-861d-0242ac120002",
        "sortDestination": 9532,
        "returnsKey": "12500457996456101",
        "returnsEvaluationCode": "QUALITY",
        "orderDescription": "Auftragstext (Freitext)",
        "lockReason ": "WRONG_LABEL"
      }
    ]
  }
}
4.1.5. Schema
Version  | 
Number  | 
File  | 
Published on  | 
Changes  | 
planned version  | 
2.2  | 
25.07.2025  | 
Siehe Kapitel Changelog weiter unten  | 
|
current version  | 
2.1  | 
31.10.2024  | 
Siehe Kapitel Changelog weiter unten  | 
|
previous version  | 
2.0  | 
13.06.2024  | 
"uniqueItems": true bei den positions. eventType STOCK_TRANSFER_CANCELLATION eingeführt. originalLoadingNumber eingeführt  | 
4.1.6. Changelog
Changes V2.1 → V2.2
- 
Enums entfernt bei den Attributen sender, client, locationSource, ownerCompany
 - 
neue Enum Werte eingeführt für transportType: GOODSIN_B2B und GOODSIN_RETAIL
 
Changes V2.0 → V2.1
- 
neue optionale Attribute lockReason und lockReasonText eingeführt
 
35 - I22 Returns Booking
- Status
 - 
FINAL → Dokumentation abgenommen
 - Approval
 - Comment
 - 
Neue Schnittstelle für WRS/WRR Buchungen aus den Lagerverwaltungssystemen in Richtung ERP.
 
1. Stakeholder
| Role | Application | Responsible | 
|---|---|---|
Communication  | 
Integration Layer  | 
|
Leading App  | 
||
InterfaceOwner  | 
||
Producer  | 
COBRA  | 
|
Producer  | 
KMotion  | 
|
Consumer  | 
Eaglefish  | 
2. Business Context
booking: returns
3. Informationflow
4. Interface
Vorhandene Dokumentation
Technisch:
4.1. Direction WMS to FINE
4.1.1. Header
This interface uses the Service Header
4.1.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
WMS WRS/WRR bookings  | 
eventId*  | 
string  | 
The uniq eventId  | 
traceId*  | 
string  | 
The uniq traceId  | 
spanId*  | 
string  | 
The eventId of previous record or batchId  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
The number of version schema  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "RETURNS_TO_SUPPLIER"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "WRS",
  "WRR"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string (enum)  | 
sender  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"
]  | 
client  | 
string (enum)  | 
client  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU",
  "F2X",
  "F2X_MANUFACTUM",
  "PSAUT",
  "F2X_SHEEGO",
  "F2X_CLEARANCE"
]  | 
data*  | 
object  | 
 Additional Properties:  false  | 
location*  | 
string (enum)  | 
Lagerstandort  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"
]  | 
businessEventTime*  | 
string (date-time)  | 
Datum und Uhrzeit des Geschäftsvorfalls  | 
businessEventKey*  | 
string  | 
UUID der Buchung  Maximum Length:  36  | 
supplierNumber*  | 
integer  | 
Lieferantenkennziffer  Maximum:  999999  | 
logisticsSupplierId*  | 
string  | 
LieferantenID  Maximum Length:  36  | 
creditorNumber  | 
integer  | 
Kreditornummer eines Lieferanten  Maximum:  9999999999  | 
ownerCompany*  | 
string (enum)  | 
Owner Company (BDF)  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU",
  "F2X",
  "F2X_MANUFACTUM",
  "PSAUT",
  "F2X_SHEEGO",
  "F2X_CLEARANCE"
]  | 
returnAddress*  | 
object  | 
Abweichende Adresse  | 
addressName  | 
string  | 
Name des Lieferanten  Maximum Length:  100  | 
addressStreet  | 
string  | 
Straße, Hausnummer  Maximum Length:  100  | 
addressZip  | 
string  | 
Postleitzahl  Maximum Length:  10  | 
addressCity  | 
string  | 
Ortschaft  Maximum Length:  100  | 
addressCountryCode  | 
string  | 
Zweistellige Ländercode  Maximum Length:  2  | 
documentNumber*  | 
integer  | 
Belegnummer  Minimum:  100000  | 
wrsOrderNumber  | 
integer  | 
WRS Order Number  Minimum:  10000000000000  | 
cancellableDocumentNumber  | 
integer  | 
Nummer des zu stornierenden Beleges  Minimum:  100000  | 
cancellationFlag*  | 
string (enum)  | 
Cancellation flag  Any of:  [
  "YES",
  "NO"
]  | 
returnReason*  | 
string (enum)  | 
Return reason  Any of:  [
  "QUALITY",
  "SURPLUS_DELIVERY",
  "FAIRNESS"
]  | 
returnSourceCode*  | 
string (enum)  | 
Quelle der Rücksendung  Any of:  [
  "NON_STOCK_ITEM",
  "CONSIGNMENT_GOODS",
  "RETURNS",
  "WAREHOUSE_REPAIRS",
  "DEFAULT"
]  | 
freightTermCode*  | 
string (enum)  | 
Frankatur  Any of:  [
  "NOT_FREE",
  "FREE",
  "FROM_FACTORY",
  "NOT_IDENTIFIED"
]  | 
shipmentCode*  | 
string (enum)  | 
Versand veranlasst per  Any of:  [
  "CARRIER",
  "RAILWAY",
  "POST",
  "EXPRESS",
  "COLLECTION",
  "NOT_IDENTIFIED"
]  | 
postageCost  | 
integer  | 
Porto  Minimum:  0  | 
extraCost  | 
integer  | 
Nebenkosten  Minimum:  0  | 
extraCostsCode*  | 
string (enum)  | 
Nebenkosten Kennzeichen  Any of:  [
  "CUSTOMER_RETURNS",
  "STANDARD_CARTON",
  "SELF_PRODUCTION",
  "TROLLEY",
  "SOLD_BY_METER",
  "HARDWARE",
  "NO_EXTRA_COSTS"
]  | 
extraCostCartonQuantity  | 
integer  | 
Anzahl Kartons  Minimum:  0  | 
extraCostOpenCartonQuantity  | 
integer  | 
Anzahl geöffneter Kartons  Minimum:  0  | 
documentCreatedBy*  | 
string  | 
Beleg erstellt von  | 
positions*  | 
array  | 
|
(Array item)  | 
object  | 
 Additional Properties:  false  | 
logisticsProductId*  | 
string  | 
WMS Product Id  Maximum Length:  36  | 
quantity*  | 
integer  | 
Return received  Minimum:  0  | 
4.1.3. Enumeration
4.1.4. Example
4.1.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
30.12.2024  | 
Einführung wrsOrderNumber  | 
|
previous version  | 
||||
coming version  | 
4.2. Direction FINE to ERP
4.2.1. Header
This interface uses the Service Header
4.2.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
ERP WRS/WRR bookings  | 
eventId*  | 
string  | 
The uniq eventId  | 
traceId*  | 
string  | 
The uniq traceId  | 
spanId*  | 
string  | 
The eventId of previous record or batchId  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
The number of version schema  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "RETURNS_TO_SUPPLIER"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "WRS",
  "WRR"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string (enum)  | 
sender  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"
]  | 
client  | 
string (enum)  | 
client  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU",
  "F2X",
  "F2X_MANUFACTUM",
  "PSAUT",
  "F2X_SHEEGO",
  "F2X_CLEARANCE"
]  | 
data*  | 
object  | 
 Additional Properties:  false  | 
location*  | 
string (enum)  | 
Lagerstandort  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"
]  | 
businessEventTime*  | 
string (date-time)  | 
Datum und Uhrzeit des Geschäftsvorfalls  | 
businessEventKey*  | 
string  | 
UUID der Buchung  Maximum Length:  36  | 
supplierNumber*  | 
integer  | 
Lieferantenkennziffer  Maximum:  999999  | 
erpSupplierId*  | 
string  | 
LieferantenID  Maximum Length:  36  | 
creditorNumber  | 
integer  | 
Kreditornummer eines Lieferanten  Maximum:  9999999999  | 
ownerCompany*  | 
string (enum)  | 
Owner Company (BDF)  Any of:  [
  "FBO",
  "MYTOYS",
  "BONPRIX",
  "WITT",
  "CORSO",
  "HEINE",
  "BAUMARKT_DIREKT",
  "BAUR",
  "OTTO",
  "ABOUTYOU",
  "F2X",
  "F2X_MANUFACTUM",
  "PSAUT",
  "F2X_SHEEGO",
  "F2X_CLEARANCE"
]  | 
returnAddress*  | 
object  | 
Abweichende Adresse  | 
addressName  | 
string  | 
Name des Lieferanten  Maximum Length:  100  | 
addressStreet  | 
string  | 
Straße, Hausnummer  Maximum Length:  100  | 
addressZip  | 
string  | 
Postleitzahl  Maximum Length:  10  | 
addressCity  | 
string  | 
Ortschaft  Maximum Length:  100  | 
addressCountryCode  | 
string  | 
Zweistellige Ländercode  Maximum Length:  2  | 
documentNumber*  | 
integer  | 
Belegnummer  Minimum:  100000  | 
wrsOrderNumber  | 
integer  | 
WRS Order Number  Minimum:  10000000000000  | 
cancellableDocumentNumber  | 
integer  | 
Nummer des zu stornierenden Beleges  Minimum:  100000  | 
cancellationFlag*  | 
string (enum)  | 
Cancellation flag  Any of:  [
  "YES",
  "NO"
]  | 
returnReason*  | 
string (enum)  | 
Return reason  Any of:  [
  "QUALITY",
  "SURPLUS_DELIVERY",
  "FAIRNESS"
]  | 
returnSourceCode*  | 
string (enum)  | 
Quelle der Rücksendung  Any of:  [
  "NON_STOCK_ITEM",
  "CONSIGNMENT_GOODS",
  "RETURNS",
  "WAREHOUSE_REPAIRS",
  "DEFAULT"
]  | 
freightTermCode*  | 
string (enum)  | 
Frankatur  Any of:  [
  "NOT_FREE",
  "FREE",
  "FROM_FACTORY",
  "NOT_IDENTIFIED"
]  | 
shipmentCode*  | 
string (enum)  | 
Versand veranlasst per  Any of:  [
  "CARRIER",
  "RAILWAY",
  "POST",
  "EXPRESS",
  "COLLECTION",
  "NOT_IDENTIFIED"
]  | 
postageCost  | 
integer  | 
Porto  Minimum:  0  | 
extraCost  | 
integer  | 
Nebenkosten  Minimum:  0  | 
extraCostsCode*  | 
string (enum)  | 
Nebenkosten Kennzeichen  Any of:  [
  "CUSTOMER_RETURNS",
  "STANDARD_CARTON",
  "SELF_PRODUCTION",
  "TROLLEY",
  "SOLD_BY_METER",
  "HARDWARE",
  "NO_EXTRA_COSTS"
]  | 
extraCostCartonQuantity  | 
integer  | 
Anzahl Kartons  Minimum:  0  | 
extraCostOpenCartonQuantity  | 
integer  | 
Anzahl geöffneter Kartons  Minimum:  0  | 
documentCreatedBy*  | 
string  | 
Beleg erstellt von  | 
positions*  | 
array  | 
|
(Array item)  | 
object  | 
 Additional Properties:  false  | 
erpProductId*  | 
string  | 
ERP Product Id  Maximum Length:  36  | 
quantity*  | 
integer  | 
Return received  Minimum:  0  | 
4.2.3. Enumeration
4.2.4. Example
4.2.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
30.12.2024  | 
Einführung wrsOrderNumber  | 
|
previous version  | 
||||
coming version  | 
36 - I23 Transport Damages
- Status
 - 
final
 - Approval
 - Comment
 - 
Schnittstelle für die Meldung von Transportschäden im Wareneingang.
 
1. Stakeholder
| Role | Application | Responsible | 
|---|---|---|
Communication  | 
Integration Layer  | 
|
Leading App  | 
FINE Inbound  | 
|
InterfaceOwner  | 
FINE Inbound  | 
|
Producer  | 
KMotion  | 
|
Consumer  | 
Lionfish  | 
2. Business Context
3. Informationflow
4. Interface
Vorhandene Dokumentation
Technisch:
4.1. Direction WMS to FINE
4.1.1. Header
This interface uses the Service Header
4.1.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
TransportDamageWms  | 
eventId*  | 
string  | 
The uniq eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId*  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "QS"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "TRANSPORT_DAMAGE_NEW_GOODS"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string (enum)  | 
sender  Any of:  [
  "BUBE",
  "COBRA",
  "CORE",
  "FINE_INBOUND",
  "IDEEFIX",
  "KMOTION_ILOWA",
  "KMOTION_GERNSHEIM",
  "KR1_SUEDHAFEN",
  "KR1_HALDENSLEBEN",
  "KR1_HAMBURGERSTRASSE",
  "LDH",
  "LIGIS",
  "LSAS",
  "OBS",
  "RESY",
  "RETAILSCHICHT",
  "WMSX_AKU",
  "WMSX_SONNEFELD",
  "WMSX_WEISMAIN",
  "F2X"
]  | 
data*  | 
object  | 
|
location*  | 
string (enum)  | 
The sending warehouse  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"
]  | 
businessEventTime*  | 
string (date-time)  | 
The date and time, when the business event occurred  | 
goodsInId*  | 
string  | 
the goods receipt ID  Maximum Length:  36  | 
deliveryNumber*  | 
string  | 
the inbound delivery business key  Maximum Length:  36  | 
deliveryDate*  | 
string (date)  | 
Delivery Date  | 
positions*  | 
array  | 
Positionen  Minimum number of items  1  | 
(Array item)  | 
object  | 
|
goodsInPositionId*  | 
string  | 
Position Id  Maximum Length:  36  | 
supplierNumber*  | 
integer  | 
Supplier Number  Maximum:  9999999  | 
logisticsProductId*  | 
string  | 
Logistics Product Id  Maximum Length:  36  | 
documentNumber*  | 
integer  | 
Document number  Minimum:  100000  | 
purchaseOrderNumber*  | 
integer  | 
Purchase order number  Maximum Length:  20  | 
storageNotificationId*  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
deliveryQuantity*  | 
number  | 
Delivery quantity  | 
damagedQuantity*  | 
number  | 
Damaged quantity  | 
imageURLs  | 
array  | 
Image URLs  | 
(Array item)  | 
string  | 
|
damageCodes  | 
array  | 
|
(Array item)  | 
object  | 
|
code  | 
string  | 
Damage code  Maximum Length:  50  | 
description  | 
string  | 
Damage code description  Maximum Length:  200  | 
4.1.3. Enumeration
4.1.4. Example
    {
      "eventId": "00ce536f-923a-42f4-8128-be118faf1d87",
      "traceId": "00ce536f-923a-42f4-8128-be118faf1d85",
      "spanId": "00ce536f-923a-42f4-8128-be118faf1d85",
      "eventTime": "2022-03-31T12:41:06.036+01:00",
      "version": "1.0",
      "context": "QS",
      "eventType": "TRANSPORT_DAMAGE_NEW_GOODS",
      "metaData" : {
        "sender": "KMOTION_ILOWA"
      },
      "data": {
        "location": "ILOWA",
        "businessEventTime": "2022-03-31T12:41:06.036+01:00",
        "goodsInId": "121564200",
        "deliveryNumber": "457848710",
        "deliveryDate": "2024-06-21",
        "positions": [
          {
            "goodsInPositionId": "1125487000",
            "supplierNumber": 67850,
            "logisticsProductId": "1234567890",
            "documentNumber": 484152,
            "purchaseOrderNumber": 56140,
            "storageNotificationId": "305106fa-2068-44b9-bca2-5afaed6f5090",
            "deliveryQuantity": 100,
            "damagedQuantity": 2,
            "imageURLs": ["IMG_URL"],
            "damageCodes": [
              {
                "code": "INC160505",
                "description": "Damaged cartons / collis (ETUP)"
              }
            ]
          }
        ]
      }
    }
4.1.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
10.06.2025  | 
final  | 
|
previous version  | 
||||
coming version  | 
4.2. Direction FINE to ERP
4.2.1. Header
This interface uses the Service Header
4.2.2. Datamodel
| Property | Type | Description | 
|---|---|---|
(Root)  | 
object  | 
TransportDamageErp  | 
eventId*  | 
string  | 
The uniqe eventId  Maximum Length:  36  | 
traceId*  | 
string  | 
The uniq traceId  Maximum Length:  36  | 
spanId*  | 
string  | 
The eventId of previous record or batchId  Maximum Length:  36  | 
eventTime*  | 
string (date-time)  | 
Time of occurrence of the event  | 
version*  | 
string  | 
Json schema version  Minimum Length:  3  | 
context*  | 
string (enum)  | 
The context / business case  Any of:  [
  "QS"
]  | 
eventType*  | 
string (enum)  | 
The concrete type = kind of record(event)  Any of:  [
  "TRANSPORT_DAMAGE_NEW_GOODS"
]  | 
metaData*  | 
object  | 
additional meta information  | 
sender*  | 
string (enum)  | 
sender  Any of:  [
  "BUBE",
  "COBRA",
  "CORE",
  "FINE_INBOUND",
  "IDEEFIX",
  "KMOTION_ILOWA",
  "KMOTION_GERNSHEIM",
  "KR1_SUEDHAFEN",
  "KR1_HALDENSLEBEN",
  "KR1_HAMBURGERSTRASSE",
  "LDH",
  "LIGIS",
  "LSAS",
  "OBS",
  "RESY",
  "RETAILSCHICHT",
  "WMSX_AKU",
  "WMSX_SONNEFELD",
  "WMSX_WEISMAIN",
  "F2X"
]  | 
data*  | 
object  | 
|
location*  | 
string (enum)  | 
The sending warehouse  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"
]  | 
businessEventTime*  | 
string (date-time)  | 
The date and time, when the business event occurred  | 
goodsInId*  | 
string  | 
the goods receipt ID  Maximum Length:  36  | 
deliveryNumber*  | 
string  | 
the inbound delivery business key  Maximum Length:  36  | 
deliveryDate*  | 
string (date)  | 
Delivery Date  | 
positions*  | 
array  | 
Positionen  Minimum number of items  1  | 
(Array item)  | 
object  | 
|
goodsInPositionId*  | 
string  | 
Position Id  Maximum Length:  36  | 
supplierNumber*  | 
integer  | 
Supplier Number  Maximum:  9999999  | 
erpProductId*  | 
string  | 
Erp Product Id  Maximum Length:  36  | 
documentNumber*  | 
integer  | 
Document number  Minimum:  100000  | 
purchaseOrderNumber*  | 
integer  | 
Purchase order number  Maximum Length:  20  | 
storageNotificationId*  | 
string  | 
Storage Notification Id  Maximum Length:  36  | 
deliveryQuantity*  | 
number  | 
Delivery quantity  | 
damagedQuantity*  | 
number  | 
Damaged quantity  | 
imageURLs  | 
array  | 
Image URLs  | 
(Array item)  | 
string  | 
|
damageCodes  | 
array  | 
|
(Array item)  | 
object  | 
|
code  | 
string  | 
Damage code  Maximum Length:  50  | 
description  | 
string  | 
Damage code description  Maximum Length:  200  | 
4.2.3. Enumeration
4.2.4. Example
   {
      "eventId": "00ce536f-923a-42f4-8128-be118faf1d87",
      "traceId": "00ce536f-923a-42f4-8128-be118faf1d85",
      "spanId": "00ce536f-923a-42f4-8128-be118faf1d85",
      "eventTime": "2022-03-31T12:41:06.036+01:00",
      "version": "1.0",
      "context": "QS",
      "eventType": "TRANSPORT_DAMAGE_NEW_GOODS",
      "metaData" : {
        "sender": "KMOTION_ILOWA"
      },
      "data": {
        "location": "ILOWA",
        "businessEventTime": "2022-03-31T12:41:06.036+01:00",
        "goodsInId": "121564200",
        "deliveryNumber": "457848710",
        "deliveryDate": "2024-06-21",
        "positions": [
          {
            "goodsInPositionId": "1125487000",
            "supplierNumber": 67850,
            "erpProductId": "01906cb6-87c0-4853-9156-ce738f12843a",
            "documentNumber": 484152,
            "purchaseOrderNumber": 56140,
            "storageNotificationId": "305106fa-2068-44b9-bca2-5afaed6f5090",
            "deliveryQuantity": 100,
            "damagedQuantity": 2,
            "imageURLs": ["IMG_URL"],
            "damageCodes": [
              {
                "code": "INC160505",
                "description": "Damaged cartons / collis (ETUP)"
              }
            ]
          }
        ]
      }
   }
4.2.5. Schema
| Version | Number | File | Published on | Changes | 
|---|---|---|---|---|
current version  | 
1.0  | 
10.06.2025  | 
final  | 
|
previous version  | 
||||
coming version  |