This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

BuBe

1 -

1.1 -

Property Type Description

(Root)

object

    eventId*

string (uuid)

The unique eventId
Global unique Id

Minimum Length: 36
Maximum Length: 36

    traceId*

string (uuid)

The unique traceId
Global unique Id for tracing the flow of events

Minimum Length: 36
Maximum Length: 36

    spanId

string (uuid)

The eventId of previous record or batchId
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), recommended as uuid, Special usecases can be specify for some interfaces

Minimum Length: 36
Maximum Length: 36

    eventTime*

string (date-time)

Time of occurrence of the event
Time at which the record was generated (single event - not the businessEvent/snapshot) in UTC +ISO-8601 format YYYY-MM-DD'T'HH24:MM:SS'Z'

    version*

The number of version schema
Number of version of this data structure. Only required if no $schema is specified!

    context

string (enum)

The context / business case
The context specified here means the business domain.

Any of: [ "WAREHOUSE_STOCK" ]
Maximum Length: 50

    eventType*

string (enum)

Snapshot event
the snapshot type to which the data belongs, currently only snapshots are supported

Any of: [ "SNAPSHOT" ]
Maximum Length: 20

    metaData*

object

additional meta information
optional, can be used with different characteristics for technical data per interface

        sender*

string (enum)

sender
Name of the source system, that has sent this message.

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

client
Client/mandant (messages of different clients have different processing rules and destination interfaces) - use FBO for Fulfillment by Otto (CORE, DeepSea…​)

Maximum Length: 50

        messageNumber

integer

current message number
the current message number that is transmitted

Minimum: 1
Maximum: 1000000000000000000

        lastMessageNumber

integer

last message number
how many messages are to be transferred

Minimum: 1
Maximum: 1000000000000000000

        dailySnapshotNumber*

integer

daily snapshot number
sequence number of the snapshot per day, starts every day again with number 1

Minimum: 1
Maximum: 100

        snapshotTime

string (date-time)

snapshot time
time of the snapshot creation

    data*

object

        snapshotId

integer

the id of the inventory snapshot
Consecutive number (sequence) of a long number. each inventory snapshot gets its own ID from WMS, which is identical for all records of the snapshot. all bookings get the id of the following snapshot, generated by wms, each wms has his own scope

Maximum Length: 18
Minimum: 1
Maximum: 1000000000000000000

        quantId*

string

Quant Id
ID of the finest stock separating unit, generated id for virtual quants/units

Maximum Length: 100

        quantType*

string (enum)

quant type
type of quant, virtual for stocks without relation to a real physical quant ,e.g. high level reserved quantities, advised detours

Any of: [ "PHYSICAL", "VIRTUAL" ]
Maximum Length: 10

        location*

string (enum)

location
the location where the event was created

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" ]

        sourcelocation

string (enum)

source location
the source location of the stock e.g. the sending location for returns or detours

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" ]

        totalQuantity*

integer

total quantity
the total quantity for this quant including reserved qty in kMotion

Minimum: 1
Maximum: 9999999999

        stockInformation*

array

stockInformation
the stock related informations for the single quantities of this quant

            (Array item)

object

                quantity*

integer

quantity
quantity containing to this stock type

Minimum: 1
Maximum: 9999999999

                stockType*

string (enum)

Stock Type
stock type, that indicates whether an individual part is in goods in stock (before releasing), available, reserved for orders, advised as return or detour…​

Any of: [ "GOODS_IN", "AVAILABLE", "QUALITY_LOCKED", "LOCKED", "RESERVED_FOR_ORDERS", "HIGH_LEVEL_RESERVED_FOR_ORDER", "RETURN_OR_DETOUR", "RESERVABLE_LOCKED", "RESERVABLE_RETURN_OR_DETOUR", "REPLENISHMENT" ]
Maximum Length: 50

        stockTypeCode

string

WMS Stock Type
stock type used in wms frontend (if available)

Maximum Length: 50

        sourceType

string (enum)

source Type
additional source type information for distinction of stock source (detour, returns, goodsin from supplier etc.) and assignment of erp stocktypes

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", "STORABLE_RETURNS", "NON_STORABLE_RETURNS", "GOODSIN_SUPPLIER" ]
Maximum Length: 50

        isInventory*

boolean

is Inventory
set it true if the quant was intended for inventory checking, otherwise to false

        isIgnoredForComparison

boolean

is ignored for comparison
set it true, if this quant should be ignored for comparison during group inventory, normally used for returns that are advised with isInventory flag from RESY, because they are not booked

        customsType

string (enum)

Type of customs
indicates whether the quant have been cleared or not

Any of: [ "CUSTOMS_CLEARED", "CUSTOMS_NOT_CLEARED", "UNKNOWN" ]
Maximum Length: 50

        customsTypeCode

string

WMS Customs Type
customs type code used in wms frontend

Maximum Length: 50

        qualityControlTypeCode

string

WMS Quality Control Type
quality control type used in wms (account)

Maximum Length: 50

        locks

array

locks
locks used in wms, a quant can have multiple locks, use also wms code for unlocked,

            (Array item)

object

                typeCode

string

lock type
lock used in front end of WMS

Maximum Length: 50

                time

string (date-time)

Lock Date
time the lock was set

        buaid

string

buaid
bi unique article ID, unique identification of an individual unit in the logistical process

Maximum Length: 50

        BUID

string

BUID
obsolete. for backwards compatibility with V3.0. Use attribute buiad instead. BI UUID, unique identification of an individual unit in the logistical process

        bestBeforeDate

string (date)

best Before Date
best before date

        batch

string

batch
batch number

Maximum Length: 100

        imei

string

imei
IMEI of a technical device

Maximum Length: 50

        imei2

string

imei2
second IMEI of dual sim technical device

Maximum Length: 50

        serialNo

string

serial number
serial number of the manufacturer

Maximum Length: 100

        volume

object

volume
volume of the whole quant - gross value - measured

            value

string

Value

Regular expression: ^[0-9]{1,9}[.][0-9]{1,6}$

            unit

string (enum)

unit volume

Any of: [ "CUBIC_METER", "LITER" ]

        weight

object

weight
weight of the whole quant - gross value - measured

            value

string

Value

Regular expression: ^[0-9]{1,9}[.][0-9]{1,3}$

            unit

string (enum)

unit weight

Any of: [ "GRAM", "KILOGRAM" ]

        product*

object

            erpProductId

string

¨ERP Product Id
master communication key between Erp and LSAS

Maximum Length: 36

            itemNumber

string

Item Number
the item number-> Only provided by WMSx Sonnefeld - deprecated

            itemSize

string

Item Size
the item size (binary size, not alphanumeric) -> Only provided by WMSx Sonnefeld - deprecated

Maximum Length: 3

            company

string

Company
actual owner company - used in FLASH

Maximum Length: 50

            erpPackingUnitId

string

¨ERP PackingUnit Id
master communication key between LSAS and ERP for packing units of products with multiple parts

Maximum Length: 36

            packingUnitIndex

integer

¨PackingUnit Number
Part Number for products with multiple parts - deprecated

Maximum: 99

        supplier

object

            erpSupplierId

string

technical erp supplier id
erp supplier ID - ERP based ID

Maximum Length: 36

            supplierId

integer

supplier number
supplier number (LKZ) - deprecated

Minimum: 0
Maximum: 999999

        storageLocationId

string

storage location
unique identification of a storage location. see interface https://docs.osp-fine.de/page/fine-common/30_stock/s08_storage_location/s08_storage_location/

        storageHandlingUnitId

string

storage handling Unit
unique identification of a charge carrier/bundle. see interface https://docs.osp-fine.de/page/fine-common/30_stock/s09_storage_handling_unit/s09_storage_handling_unit/

        goodsIn

object

            goodsInId

string

goods in id
unique id of a goods receipt see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/

Maximum Length: 36

            deliveryPositionId

string

delivery position id
unique id of a delivery position see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/

Maximum Length: 36

        movementInfo

object

            firstMovement*

string (date-time)

first movement date
time of creation of the stock in the wms for determining the laytime of a stock unit, for retour or detour stocks use the advise date

            lastMovement

string (date-time)

last movement date
last movement of the stock unit to derive old stock and bum articles

            lastPickingDate

string (date-time)

last picking date
time at which the last pick/commission was made from this remaining quant

1.2 -

Property Type Description

(Root)

object

    eventId*

string (uuid)

The unique eventId
Global unique Id

Minimum Length: 36
Maximum Length: 36

    traceId*

string (uuid)

The unique traceId
Global unique Id for tracing the flow of events

Minimum Length: 36
Maximum Length: 36

    spanId

string (uuid)

The eventId of previous record or batchId
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), recommended as uuid, Special usecases can be specify for some interfaces

Minimum Length: 36
Maximum Length: 36

    eventTime*

string (date-time)

Time of occurrence of the event
Time at which the record was generated (single event - not the businessEvent/snapshot) in UTC +ISO-8601 format YYYY-MM-DD'T'HH24:MM:SS'Z'

    version*

The number of version schema
Number of version of this data structure. Only required if no $schema is specified!

    context

string (enum)

The context / business case
The context specified here means the business domain.

Any of: [ "WAREHOUSE_STOCK" ]
Maximum Length: 50

    eventType*

string (enum)

Snapshot event
the snapshot type to which the data belongs, currently only snapshots are supported

Any of: [ "SNAPSHOT" ]
Maximum Length: 20

    metaData*

object

additional meta information
optional, can be used with different characteristics for technical data per interface

        sender*

string (enum)

sender
Name of the source system, that has sent this message.

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

client
Client/mandant (messages of different clients have different processing rules and destination interfaces) - use FBO for Fulfillment by Otto (CORE, DeepSea…​)

Maximum Length: 50

        messageNumber

integer

current message number
the current message number that is transmitted

Minimum: 1
Maximum: 1000000000000000000

        lastMessageNumber

integer

last message number
how many messages are to be transferred

Minimum: 1
Maximum: 1000000000000000000

        dailySnapshotNumber*

integer

daily snapshot number
sequence number of the snapshot per day, starts every day again with number 1

Minimum: 1
Maximum: 100

        snapshotTime

string (date-time)

snapshot time
time of the snapshot creation

    data*

object

        snapshotId

integer

the id of the inventory snapshot
Consecutive number (sequence) of a long number. each inventory snapshot gets its own ID from WMS, which is identical for all records of the snapshot. all bookings get the id of the following snapshot, generated by wms, each wms has his own scope

Maximum Length: 18
Minimum: 1
Maximum: 1000000000000000000

        quantId*

string

Quant Id
ID of the finest stock separating unit, generated id for virtual quants/units

Maximum Length: 100

        quantType*

string (enum)

quant type
type of quant, virtual for stocks without relation to a real physical quant ,e.g. high level reserved quantities, advised detours

Any of: [ "PHYSICAL", "VIRTUAL" ]
Maximum Length: 10

        location*

string (enum)

location
the location where the event was created

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" ]

        sourcelocation

string (enum)

source location
the source location of the stock e.g. the sending location for returns or detours

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" ]

        totalQuantity*

integer

total quantity
the total quantity for this quant including reserved qty in kMotion

Minimum: 1
Maximum: 9999999999

        stockInformation*

array

stockInformation
the stock related informations for the single quantities of this quant

            (Array item)

object

                quantity*

integer

quantity
quantity containing to this stock type

Minimum: 1
Maximum: 9999999999

                stockType*

string (enum)

Stock Type
stock type, that indicates whether an individual part is in goods in stock (before releasing), available, reserved for orders, advised as return or detour…​

Any of: [ "GOODS_IN", "AVAILABLE", "QUALITY_LOCKED", "LOCKED", "RESERVED_FOR_ORDERS", "HIGH_LEVEL_RESERVED_FOR_ORDER", "RETURN_OR_DETOUR", "RESERVABLE_LOCKED", "RESERVABLE_RETURN_OR_DETOUR", "REPLENISHMENT" ]
Maximum Length: 50

        stockTypeCode

string

WMS Stock Type
stock type used in wms frontend (if available)

Maximum Length: 50

        sourceType

string (enum)

source Type
additional source type information for distinction of stock source (detour, returns, goodsin from supplier etc.) and assignment of erp stocktypes

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", "STORABLE_RETURNS", "NON_STORABLE_RETURNS", "GOODSIN_SUPPLIER" ]
Maximum Length: 50

        isInventory

boolean

is Inventory
set it true if the quant was intended for inventory checking, otherwise to false

        isIgnoredForComparison

boolean

is ignored for comparison
set it true, if this quant should be ignored for comparison during group inventory, normally used for returns that are advised with isInventory flag from RESY, because they are not booked

        customsType

string (enum)

Type of customs
indicates whether the quant have been cleared or not

Any of: [ "CUSTOMS_CLEARED", "CUSTOMS_NOT_CLEARED", "UNKNOWN" ]
Maximum Length: 50

        customsTypeCode

string

WMS Customs Type
customs type code used in wms frontend

Maximum Length: 50

        qualityControlTypeCode

string

WMS Quality Control Type
quality control type used in wms (account)

Maximum Length: 50

        locks

array

locks
locks used in wms, a quant can have multiple locks, use also wms code for unlocked,

            (Array item)

object

                typeCode

string

lock type
lock used in front end of WMS

Maximum Length: 50

                time

string (date-time)

Lock Date
time the lock was set

        buaid

string

buaid
bi unique article ID, unique identification of an individual unit in the logistical process

Maximum Length: 50

        BUID

string

BUID
obsolete. for backwards compatibility with V3.0. Use attribute buiad instead. BI UUID, unique identification of an individual unit in the logistical process

        bestBeforeDate

string (date)

best Before Date
best before date

        batch

string

batch
batch number

Maximum Length: 100

        imei

string

imei
IMEI of a technical device

Maximum Length: 50

        imei2

string

imei2
second IMEI of dual sim technical device

Maximum Length: 50

        serialNo

string

serial number
serial number of the manufacturer

Maximum Length: 100

        volume

object

volume
volume of the whole quant - gross value - measured

            value

string

Value

Regular expression: ^[0-9]{1,9}[.][0-9]{1,6}$

            unit

string (enum)

unit volume

Any of: [ "CUBIC_METER", "LITER" ]

        weight

object

weight
weight of the whole quant - gross value - measured

            value

string

Value

Regular expression: ^[0-9]{1,9}[.][0-9]{1,3}$

            unit

string (enum)

unit weight

Any of: [ "GRAM", "KILOGRAM" ]

        product*

object

            logisticsProductId

string

¨Logistic Product Id
master communication key

Maximum Length: 36

            itemNumber

string

Item Number
the item number-> Only provided by WMSx Sonnefeld - deprecated

            itemSize

string

Item Size
the item size (binary size, not alphanumeric) -> Only provided by WMSx Sonnefeld - deprecated

Maximum Length: 3

            company

string

Company
actual owner company - used in FLASH

Maximum Length: 50

            logisticsPackingUnitId

string

¨Logistic PackingUnit Id
master communication key from LSAS for products with multiple parts

Maximum Length: 36

            packingUnitIndex

integer

¨Logistic PackingUnit Number
Part Number for products with multiple parts - deprecated

Maximum: 99

        supplier

object

            logisticsSupplierId

string

technical logistics supplier id
logistics supplier ID - LSAS based ID

Maximum Length: 36

            supplierId

integer

supplier number
supplier number (LKZ) - deprecated

Minimum: 0
Maximum: 999999

        storageLocationId

string

storage location
unique identification of a storage location. see interface https://docs.osp-fine.de/page/fine-common/30_stock/s08_storage_location/s08_storage_location/

        storageHandlingUnitId

string

storage handling Unit
unique identification of a charge carrier/bundle. see interface https://docs.osp-fine.de/page/fine-common/30_stock/s09_storage_handling_unit/s09_storage_handling_unit/

        goodsIn

object

            goodsInId

string

goods in id
unique id of a goods receipt see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/

Maximum Length: 36

            deliveryPositionId

string

delivery position id
unique id of a delivery position see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/

Maximum Length: 36

        movementInfo

object

            firstMovement*

string (date-time)

first movement date
time of creation of the stock in the wms for determining the laytime of a stock unit, for retour or detour stocks use the advise date

            lastMovement

string (date-time)

last movement date
last movement of the stock unit to derive old stock and bum articles

            lastPickingDate

string (date-time)

last picking date
time at which the last pick/commission was made from this remaining quant

2 -

2.1 -

Property Type Description

(Root)

object

Stock Booking Erp Message
This document describes the booking messages that FINE sends to the client specific erp.

    eventId*

string (uuid)

The unique eventId
Global unique Id - JAVA UUID4 for the event generated by the actual producer. Use pattern: '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$'

    traceId*

string (uuid)

UUID for all events in a call hierarchy - trace
ID of the trace, will be generated by the first producer of the process. The ID will be the same for all events in the context of this process, also over system boundaries. The ID is equal to the eventId, if it is the first event. It's like a order number, the will used for all activities around the order.

    spanId

string (uuid)

The eventId of previous record or batchId
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)

    eventTime*

string (date-time)

Time of occurrence of the event
Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC

    version*

string

The number of version of schema
Number of version of this data structure. A sematic specification with major & minor version numbers

Maximum Length: 6
Regular expression: \d+\.\d{1,2}

    context*

string (enum)

context
The optional context specified here means the business domain. here STOCKPOSTING

Any of: [ "STOCKPOSTING" ]
Maximum Length: 50

    eventType*

string (enum)

event type
Event type (business transaction), that can be related to booking types

Any of: [ "GOODS_RECEIPT", "REVERSE_INBOUND", "DELIVERABLE_STOCK_MINUS", "DELIVERABLE_STOCK_PLUS", "DELIVERABLE_STOCK_TO_LOCKED_STOCK", "DELIVERABLE_STOCK_TO_STOCK_DIFFERENCE", "DELIVERABLE_STOCK_TO_STOCK_IN_TRANSIT", "LOCKED_STOCK_MINUS", "LOCKED_STOCK_PLUS", "LOCKED_STOCK_TO_DELIVERABLE_STOCK", "LOCKED_STOCK_TO_QUALITY_LOCKED_STOCK", "LOCKED_STOCK_TO_STOCK_IN_TRANSIT", "STOCK_DIFFERENCE_TO_DELIVERABLE_STOCK", "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK", "GOODS_RECEIPT_LOCKED_STOCK", "GOODS_RECEIPT_LOCKED_STOCK_CANCELED", "INVENTORY_DIFFERENCE", "INVENTORY_DIFFERENCE_CANCELED", "OUTGOING_GOODS_CUSTOMER_LOCKED_STOCK", "QUALITY_LOCKED_STOCK_CHANNEL_BOOKING", "QUALITY_LOCKED_STOCK_TO_CREDIT_THIRD_PARTY_SALE", "QUALITY_LOCKED_STOCK_TO_LOCKED_STOCK", "QUALITY_LOCKED_STOCK_TO_STOCK_DIFFERENCE", "QUALITY_LOCKED_STOCK_TO_STOCK_IN_TRANSIT", "QUALITY_LOCKED_STOCK_TO_TOTAL_LOSS", "QUALITY_LOCKED_STOCK_TO_TREASURE_DROVE", "REVERSE_INBOUND_RETURNS", "REVERSE_INBOUND_RETURNS_CANCELED", "STOCK_DIFFERENCE_TO_QUALITY_LOCKED_STOCK", "STOCK_IN_TRANSIT_TO_LOCKED_STOCK", "STOCK_IN_TRANSIT_TO_QUALITY_LOCKED_STOCK", "STOCK_DIFFERENCE_TO_STOCK_IN_TRANSIT", "STOCK_IN_TRANSIT_TO_STOCK_DIFFERENCE", "LOCKED_STOCK_TO_RETURNS", "TRANSIT_LOCKED_STOCK_MINUS", "TRANSIT_LOCKED_STOCK_TO_LOCKED_STOCK", "WAREHOUSE_DAMAGE", "WAREHOUSE_DAMAGE_CANCELED", "DELIVERABLE_STOCK_TO_QUALITY_LOCKED_STOCK", "DELIVERABLE_STOCK_TO_RESERVED_SHIPPING_STOCK", "GOODS_RECEIPT_QS_UNAUDITED_STOCK", "GOODS_RECEIPT_QUALITY_LOCKED_STOCK", "GOODS_RECEIPT_STOCK_DIFFERENCE", "INVENTORY_DIFFERENCE_DELIVERABLE_STOCK", "INVENTORY_DIFFERENCE_STOCK_DIFFERENCE", "IWA_STOCK_DIFFERENCE", "OUTGOING_GOODS_CUSTOMER_CANCEL", "OUTGOING_GOODS_CUSTOMER_STOCK_DIFFERENCE", "QS_UNAUDITED_STOCK_GOODS_RECEIPT", "QS_UNAUDITED_STOCK_TO_DELIVERABLE_STOCK", "QUALITY_LOCKED_STOCK_GOODS_RECEIPT", "QUALITY_LOCKED_STOCK_INVENTORY_DIFFERENCE", "QUALITY_LOCKED_STOCK_IWA", "QUALITY_LOCKED_STOCK_RAS_RES", "QUALITY_LOCKED_STOCK_TO_DELIVERABLE_STOCK", "RAS_RES_STOCK_DIFFERENCE", "RESERVABLE_LOCKED_STOCK_TO_DELIVERABLE_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_DELIVERABLE_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_STOCK_DIFFERENCE", "RESERVABLE_STOCK_IN_TRANSIT_TO_RESERVABLE_LOCKED_STOCK", "RESERVED_SHIPPING_STOCK_DELIVERABLE_STOCK", "RESERVED_SHIPPING_STOCK_INVENTORY_DIFFERENCE", "RESERVED_SHIPPING_STOCK_OUTGOING_GOODS_CUSTOMER", "STOCK_DIFFERENCE_INVENTORY", "STOCK_DIFFERENCE_OUTGOING_GOODS", "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK_H162", "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK_H46", "STOCK_IN_TRANSIT_TO_RESERVED_SHIPPING_STOCK", "TOTAL_LOSS_LOCKED_STOCK", "TOTAL_LOSS_STOCK_DIFFERENCE", "DELIVERABLE_STOCK_INVENTORY_DIFFERENCE", "DELIVERABLE_STOCK_TO_RESERVABLE_LOCKED_STOCK", "RESERVABLE_LOCKED_STOCK_TO_RESERVABLE_STOCK_IN_TRANSIT", "GOODS_RECEIPT_TOTAL_LOSS", "RETURNS_MANUAL_STORAGE", "RETURNS_AUTOMATIC_STORAGE", "TRANSFER_MANUAL_STORAGE", "TRANSFER_AUTOMATIC_STORAGE", "REVERSE_INBOUND_MANUAL_STORAGE", "REVERSE_INBOUND_AUTOMATIC_STORAGE", "STOCK_AVAILABILITY_CHECK_NOK", "INVENTORY_DIFFERENCE_ERP_STOCK", "IN_FULFILLMENT_MISSING", "HIGH_LEVEL_RESERVATION_OK", "RESERVATION_OK", "IN_FULFILLMENT_CUSTOMER", "IN_FULFILLMENT_MANUAL_SUBSTITUTION", "IN_FULFILLMENT_B2B", "IN_FULFILLMENT_QUALITY_LOCKED", "HIGH_LEVEL_RESERVATION_NOK", "RESERVATION_NOK", "INVENTORY_DIFFERENCE_ERP_STOCK_MEANWHILE_REDUCED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND", "OUTGOING_GOODS", "OUTGOING_GOODS_CUSTOMER", "OUTGOING_GOODS_TRANSFER", "OUTGOING_GOODS_B2B", "INVENTORY_DIFFERENCE_COMMON", "INVENTORY_PLUS_DIFFERENCE", "GOODS_RECEIPT_QUALITY_LOCKED", "GOODS_RECEIPT_QUALITY_CHECK_APPROVED", "GOODS_RECEIPT_RETURN", "INVENTORY_LOCK", "INVENTORY_LOCK_QUALITY_LOCKED", "INVENTORY_CHECK_FINAL", "INVENTORY_CHECK_FINAL_QUALITY_LOCKED", "IN_FULFILLMENT_CANCEL", "IN_FULFILLMENT_CANCEL_QUALITY_LOCKED", "TRANSFER_TRANSIT_BACK_TO_SOURCE", "INVENTORY_TRANSFER_TRANSIT", "RETURNS_TRANSIT_BACK_TO_SOURCE", "INVENTORY_RETURNS_TRANSIT", "DELIVERABLE_STOCK_PLUS_TEST", "DELIVERABLE_STOCK_MINUS_TEST", "QUALITY_LOCKED_STOCK_PLUS_TEST", "QUALITY_LOCKED_STOCK_MINUS_TEST", "STOCK_IN_FULFILLMENT_PLUS_TEST", "STOCK_IN_FULFILLMENT_MINUS_TEST", "INVENTORY_PLUS_DIFFERENCE_INVENTORY_LOCKED", "LOCKING_STOCK", "UNLOCKING_STOCK", "GOODS_RECEIPT_FROM_REWORK", "INVENTORY_MINUS_DIFFERENCE", "INVENTORY_PLUS_DIFFERENCE_QUALITY_LOCKED", "INVENTORY_MINUS_DIFFERENCE_QUALITY_LOCKED", "IN_FULFILLMENT_RESERVATION_CANCEL", "IN_FULFILLMENT_CANCEL_CUSTOMER", "IN_FULFILLMENT_CANCEL_B2B", "IN_FULFILLMENT_RESERVATION_CANCEL_CUSTOMER", "IN_FULFILLMENT_RESERVATION_CANCEL_B2B", "IN_FULFILLMENT_RESERVATION_CANCEL_QUALITY_LOCKED", "RESERVE_REPLENISHMENT", "UNRESERVE_REPLENISHMENT", "TRANSFER_MANUAL_STORAGE_QUALITY_LOCKED", "TRANSFER_AUTOMATIC_STORAGE_QUALITY_LOCKED", "IN_FULFILLMENT_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_MANUAL_SUBSTITUTION_B2B", "IN_FULFILLMENT_MANUAL_SUBSTITUTION_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK_B2B", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT_B2B", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK_B2B", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND_B2B", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_CANCEL_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_RESERVATION_CANCEL_B2B_QUALITY_LOCKED", "OUTGOING_GOODS_TRANSFER_B2B", "OUTGOING_GOODS_TRANSFER_B2B_QUALITY_LOCKED", "OUTGOING_GOODS_B2B_QUALITY_LOCKED", "INVENTORY_DIFFERENCE_INVENTORY_LOCKED", "LOCKED_STOCK_TO_STOCK_DIFFERENCE", "QUALITY_LOCKED_STOCK_TO_RESERVABLE_LOCKED_STOCK", "QUALITY_LOCKED_STOCK_TO_RESERVABLE_STOCK_IN_TRANSIT", "RESERVABLE_LOCKED_STOCK_TO_QUALITY_LOCKED_STOCK", "RESERVABLE_LOCKED_STOCK_TO_STOCK_DIFFERENCE", "RESERVABLE_STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_TO_QUALITY_LOCKED_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_TO_STOCK_DIFFERENCE", "STOCK_DIFFERENCE_TO_LOCKED_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_TO_LOCKED_STOCK" ]
Maximum Length: 100

    metaData*

object

additional meta data
additional meta information for booking interface

        sender*

string (enum)

sender
Name of the source system, that has sent this message.

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" ]

        instance*

string (enum)

instance of producer
instance of the application or warehouse context

Any of: [ "LANGENSELBOLD", "OHRDRUF", "LOEHNE", "ANSBACH", "MOSINA", "HALDENSLEBEN", "HALDENSLEBEN_RSS", "SUEDHAFEN", "ALTENKUNSTADT", "SONNEFELD", "ERFURT", "GERNSHEIM", "ILOWA", "LOEHNE_CP" ]
Maximum Length: 30

        client*

string

client
Client/mandant (messages of different clients have different processing rules and destination interfaces) - use FBO for Fulfillment by Otto (CORE, DeepSea…​)

Maximum Length: 50

        sourceIdentifier*

string (enum)

source identifier
identifies the source system of the bookings, mapped from sender and instance of the origin wms booking message in fine bube

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" ]

    data*

object

Data Erp
Data of the JSON message

        sourceTimestamp*

string (date-time)

the booking timestamp
Booking timestamp UTC+ISO-8601 format

        creationType

string (enum)

creation type
identifies specific creation conditions if necessary, in first version only automatic and manual bookings are used for stock journal

Any of: [ "AUTOMATIC", "MANUAL" ]

        location*

string (enum)

the location where where the event was created
the location where the event was created, warehouse that emits the booking

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" ]

        erpSnapshotId

number

the id of the following inventory snapshot
Consecutive number (sequence) of a long number. each inventory snapshot gets its own ID, which is identical for all records of the snapshot. all bookings get the id of the following snapshot

Maximum Length: 18
Minimum: 1
Maximum: 1000000000000000000

        product*

object

Product Erp
product related information to identify the product and part

            itemNumber

integer

item number
item number (article data) - used for old systems

Maximum: 9999999999

            itemSize

integer

item size
Numeric item size (article data) - used for old systems

Maximum: 99999

            erpProductId

string

ERP product ID
ERP product ID - the id of the product in erp received from LSAS

            erpPartId

string

ERP part ID
GL/bulky items: ID for the part/packing unit based on item - size - part from ERP (LSAS gets it from MOLA)

            partNumber

integer

part number (bulky items)
part number for specific packing unit (bulky items)

Maximum: 999

            numberOfParts

integer

number of all parts
number of all parts for this item (bulky items)

Maximum: 999

        stockInfo*

object

Stock Info Erp
the information for booking related warehouses, filled dependent on event type

Additional Properties: false

            sourceLocation

object

source location
the source location structure for the booking

                location

string (enum)

location
source location of booking

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" ]

            destinationLocation

object

destination location
the destination location for the booking

                location

string (enum)

location
destination location of booking

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" ]

        movementInfo*

object

Movement Info Erp
movement/booking informations

            quantity*

integer

quantity
quantity to be booked, in case of goods receipt the delivery note original quantity for this detail, in case of goods receipt release booking the released quantity for this detail

Minimum: 1
Maximum: 9999999999

            movementInfoDetails

object

Movement Info Details Erp
Detailed Info about the movement, also used for deprecated data for old systems

                documentNumber

integer

document number
Depending on type, in case of goods release booking then receiptDocumentNo (44xxx) from delivery, in case of return vendor sheet booking the rvsNumber (9x?xxx), otherwise other document numbers.

Maximum: 9999999999

                supplierNumber

integer

supplier number
Number of supplier, mandatory for goods release, return vendor sheet

Maximum: 9999999999

                externalReferenceView

string

External reference view
External reference view - used in core as posting text

Maximum Length: 50

                customerCompany

integer

customer company
Company of the customer account. For example: SON - LDG Großkunden mit Belegnummer

Maximum: 9999999999

                purchaseOrderNumber

string

purchase order number
purchase order number (sent from SON for goods released bookings, ordernumber OVA)

                externalReference

string

external reference
externalReference - Cobra - Unigro reference ano from unigro order

                goodsInId

string

goods in id
unique id of a goods receipt see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/

Maximum Length: 36

                buaid

string

buaid
bi unique article ID, unique identification of an individual unit in the logistical process

Maximum Length: 50

                returnKey

string

returnKey
returnKey

Maximum Length: 500

                b2bOrderId

string

b2b Order Id
ERP Order Id - for stock transfers ordered from ERP

Maximum Length: 36

                loadingNumber

string

Loading Number
generated per sender; generation specification from OTTO, unique within 13 years for stock transfers

Maximum Length: 12

                merchantErpIdentifier

string (enum)

merchant erp identifier
enums that specifies the merchant erp that generated the orders

Any of: [ "DEEP_SEA_CORMORANT", "CORE", "B2B_DEEP_SEA_CORMORANT", "B2B_CORE" ]
Maximum Length: 30

                merchantSingleItemId

string

merchant single item Id
single item id for orders used in merchant erp

Maximum Length: 255

                stockTransferType

string (enum)

stock transfer type
additional transfer type information for stock transfers

Any of: [ "UMF", "WRS_WE", "WRS_L", "IWA_WE", "IWA_M", "GKD" ]
Maximum Length: 50

                orderPart

integer

order part
number of the attempt to reserve or check the stock for orders - starts with zero

Minimum: 0
Maximum: 999999999

                stockType

string (enum)

stock type
stockType for B2B orders which indicates from which stock the order has to be fulfilled

Any of: [ "AVAILABLE", "LOCKED" ]
Maximum Length: 50

                lockTypeCode

string

lock type code
lock type code from wms for locked stock which can also differentiate between the locked stock types used in B2B order bookings

Maximum Length: 50

                returnOrderUUID

string

returnOrderUUID
the UID of the associated return order contract, can be a UUID4

Maximum Length: 100

                originalGoodsInId

string

original goods in id
unique id of the original goods receipt for a goods in from rework see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/

Maximum Length: 36

                b2bShipmentType

string (enum)

b2b shipment type
the shipment type for b2b orders - UMF for stock transfer to another warehouse (with known subtypes in stockTransferType) or GKD for real major customer orders, mandatory for b2b order bookings, null for B2C

Any of: [ "UMF", "GKD" ]
Maximum Length: 30

2.2 -

Property Type Description

(Root)

object

Stock Booking Wms Message
This document describes the booking messages that FINE receives from warehouse management systems (WMS).

    eventId*

string (uuid)

The unique eventId
Global unique Id - JAVA UUID4 for the event generated by the actual producer. Use pattern: '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$'

    traceId*

string (uuid)

UUID for all events in a call hierarchy - trace
ID of the trace, will be generated by the first producer of the process. The ID will be the same for all events in the context of this process, also over system boundaries. The ID is equal to the eventId, if it is the first event. It's like a order number, the will used for all activities around the order.

    spanId

string (uuid)

The eventId of previous record or batchId
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)

    eventTime*

string (date-time)

Time of occurrence of the event
Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC

    version*

string

The number of version of schema
Number of version of this data structure. A sematic specification with major & minor version numbers

Maximum Length: 6
Regular expression: \d+\.\d{1,2}

    context*

string (enum)

context
The optional context specified here means the business domain. here STOCKPOSTING

Any of: [ "STOCKPOSTING" ]
Maximum Length: 50

    eventType*

string (enum)

event type
Event type (business transaction), that can be related to booking types

Any of: [ "GOODS_RECEIPT", "REVERSE_INBOUND", "DELIVERABLE_STOCK_MINUS", "DELIVERABLE_STOCK_PLUS", "DELIVERABLE_STOCK_TO_LOCKED_STOCK", "DELIVERABLE_STOCK_TO_STOCK_DIFFERENCE", "DELIVERABLE_STOCK_TO_STOCK_IN_TRANSIT", "LOCKED_STOCK_MINUS", "LOCKED_STOCK_PLUS", "LOCKED_STOCK_TO_DELIVERABLE_STOCK", "LOCKED_STOCK_TO_QUALITY_LOCKED_STOCK", "LOCKED_STOCK_TO_STOCK_IN_TRANSIT", "STOCK_DIFFERENCE_TO_DELIVERABLE_STOCK", "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK", "GOODS_RECEIPT_LOCKED_STOCK", "GOODS_RECEIPT_LOCKED_STOCK_CANCELED", "INVENTORY_DIFFERENCE", "INVENTORY_DIFFERENCE_CANCELED", "OUTGOING_GOODS_CUSTOMER_LOCKED_STOCK", "QUALITY_LOCKED_STOCK_CHANNEL_BOOKING", "QUALITY_LOCKED_STOCK_TO_CREDIT_THIRD_PARTY_SALE", "QUALITY_LOCKED_STOCK_TO_LOCKED_STOCK", "QUALITY_LOCKED_STOCK_TO_STOCK_DIFFERENCE", "QUALITY_LOCKED_STOCK_TO_STOCK_IN_TRANSIT", "QUALITY_LOCKED_STOCK_TO_TOTAL_LOSS", "QUALITY_LOCKED_STOCK_TO_TREASURE_DROVE", "REVERSE_INBOUND_RETURNS", "REVERSE_INBOUND_RETURNS_CANCELED", "STOCK_DIFFERENCE_TO_QUALITY_LOCKED_STOCK", "STOCK_IN_TRANSIT_TO_LOCKED_STOCK", "STOCK_IN_TRANSIT_TO_QUALITY_LOCKED_STOCK", "STOCK_DIFFERENCE_TO_STOCK_IN_TRANSIT", "STOCK_IN_TRANSIT_TO_STOCK_DIFFERENCE", "LOCKED_STOCK_TO_RETURNS", "TRANSIT_LOCKED_STOCK_MINUS", "TRANSIT_LOCKED_STOCK_TO_LOCKED_STOCK", "WAREHOUSE_DAMAGE", "WAREHOUSE_DAMAGE_CANCELED", "DELIVERABLE_STOCK_TO_QUALITY_LOCKED_STOCK", "DELIVERABLE_STOCK_TO_RESERVED_SHIPPING_STOCK", "GOODS_RECEIPT_QS_UNAUDITED_STOCK", "GOODS_RECEIPT_QUALITY_LOCKED_STOCK", "GOODS_RECEIPT_STOCK_DIFFERENCE", "INVENTORY_DIFFERENCE_DELIVERABLE_STOCK", "INVENTORY_DIFFERENCE_STOCK_DIFFERENCE", "IWA_STOCK_DIFFERENCE", "OUTGOING_GOODS_CUSTOMER_CANCEL", "OUTGOING_GOODS_CUSTOMER_STOCK_DIFFERENCE", "QS_UNAUDITED_STOCK_GOODS_RECEIPT", "QS_UNAUDITED_STOCK_TO_DELIVERABLE_STOCK", "QUALITY_LOCKED_STOCK_GOODS_RECEIPT", "QUALITY_LOCKED_STOCK_INVENTORY_DIFFERENCE", "QUALITY_LOCKED_STOCK_IWA", "QUALITY_LOCKED_STOCK_RAS_RES", "QUALITY_LOCKED_STOCK_TO_DELIVERABLE_STOCK", "RAS_RES_STOCK_DIFFERENCE", "RESERVABLE_LOCKED_STOCK_TO_DELIVERABLE_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_DELIVERABLE_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_STOCK_DIFFERENCE", "RESERVABLE_STOCK_IN_TRANSIT_TO_RESERVABLE_LOCKED_STOCK", "RESERVED_SHIPPING_STOCK_DELIVERABLE_STOCK", "RESERVED_SHIPPING_STOCK_INVENTORY_DIFFERENCE", "RESERVED_SHIPPING_STOCK_OUTGOING_GOODS_CUSTOMER", "STOCK_DIFFERENCE_INVENTORY", "STOCK_DIFFERENCE_OUTGOING_GOODS", "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK_H162", "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK_H46", "STOCK_IN_TRANSIT_TO_RESERVED_SHIPPING_STOCK", "TOTAL_LOSS_LOCKED_STOCK", "TOTAL_LOSS_STOCK_DIFFERENCE", "DELIVERABLE_STOCK_INVENTORY_DIFFERENCE", "DELIVERABLE_STOCK_TO_RESERVABLE_LOCKED_STOCK", "RESERVABLE_LOCKED_STOCK_TO_RESERVABLE_STOCK_IN_TRANSIT", "GOODS_RECEIPT_TOTAL_LOSS", "RETURNS_MANUAL_STORAGE", "RETURNS_AUTOMATIC_STORAGE", "TRANSFER_MANUAL_STORAGE", "TRANSFER_AUTOMATIC_STORAGE", "REVERSE_INBOUND_MANUAL_STORAGE", "REVERSE_INBOUND_AUTOMATIC_STORAGE", "STOCK_AVAILABILITY_CHECK_NOK", "INVENTORY_DIFFERENCE_ERP_STOCK", "IN_FULFILLMENT_MISSING", "HIGH_LEVEL_RESERVATION_OK", "RESERVATION_OK", "IN_FULFILLMENT_CUSTOMER", "IN_FULFILLMENT_MANUAL_SUBSTITUTION", "IN_FULFILLMENT_B2B", "IN_FULFILLMENT_QUALITY_LOCKED", "HIGH_LEVEL_RESERVATION_NOK", "RESERVATION_NOK", "INVENTORY_DIFFERENCE_ERP_STOCK_MEANWHILE_REDUCED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND", "OUTGOING_GOODS", "OUTGOING_GOODS_CUSTOMER", "OUTGOING_GOODS_TRANSFER", "OUTGOING_GOODS_B2B", "INVENTORY_DIFFERENCE_COMMON", "INVENTORY_PLUS_DIFFERENCE", "GOODS_RECEIPT_QUALITY_LOCKED", "GOODS_RECEIPT_QUALITY_CHECK_APPROVED", "GOODS_RECEIPT_RETURN", "INVENTORY_LOCK", "INVENTORY_LOCK_QUALITY_LOCKED", "INVENTORY_CHECK_FINAL", "INVENTORY_CHECK_FINAL_QUALITY_LOCKED", "IN_FULFILLMENT_CANCEL", "IN_FULFILLMENT_CANCEL_QUALITY_LOCKED", "TRANSFER_TRANSIT_BACK_TO_SOURCE", "INVENTORY_TRANSFER_TRANSIT", "RETURNS_TRANSIT_BACK_TO_SOURCE", "INVENTORY_RETURNS_TRANSIT", "DELIVERABLE_STOCK_PLUS_TEST", "DELIVERABLE_STOCK_MINUS_TEST", "QUALITY_LOCKED_STOCK_PLUS_TEST", "QUALITY_LOCKED_STOCK_MINUS_TEST", "STOCK_IN_FULFILLMENT_PLUS_TEST", "STOCK_IN_FULFILLMENT_MINUS_TEST", "INVENTORY_PLUS_DIFFERENCE_INVENTORY_LOCKED", "LOCKING_STOCK", "UNLOCKING_STOCK", "GOODS_RECEIPT_FROM_REWORK", "INVENTORY_MINUS_DIFFERENCE", "INVENTORY_PLUS_DIFFERENCE_QUALITY_LOCKED", "INVENTORY_MINUS_DIFFERENCE_QUALITY_LOCKED", "IN_FULFILLMENT_RESERVATION_CANCEL", "IN_FULFILLMENT_CANCEL_CUSTOMER", "IN_FULFILLMENT_CANCEL_B2B", "IN_FULFILLMENT_RESERVATION_CANCEL_CUSTOMER", "IN_FULFILLMENT_RESERVATION_CANCEL_B2B", "IN_FULFILLMENT_RESERVATION_CANCEL_QUALITY_LOCKED", "RESERVE_REPLENISHMENT", "UNRESERVE_REPLENISHMENT", "TRANSFER_MANUAL_STORAGE_QUALITY_LOCKED", "TRANSFER_AUTOMATIC_STORAGE_QUALITY_LOCKED", "IN_FULFILLMENT_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_MANUAL_SUBSTITUTION_B2B", "IN_FULFILLMENT_MANUAL_SUBSTITUTION_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK_B2B", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT_B2B", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK_B2B", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND_B2B", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_CANCEL_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_RESERVATION_CANCEL_B2B_QUALITY_LOCKED", "OUTGOING_GOODS_TRANSFER_B2B", "OUTGOING_GOODS_TRANSFER_B2B_QUALITY_LOCKED", "OUTGOING_GOODS_B2B_QUALITY_LOCKED", "INVENTORY_DIFFERENCE_INVENTORY_LOCKED", "LOCKED_STOCK_TO_STOCK_DIFFERENCE", "QUALITY_LOCKED_STOCK_TO_RESERVABLE_LOCKED_STOCK", "QUALITY_LOCKED_STOCK_TO_RESERVABLE_STOCK_IN_TRANSIT", "RESERVABLE_LOCKED_STOCK_TO_QUALITY_LOCKED_STOCK", "RESERVABLE_LOCKED_STOCK_TO_STOCK_DIFFERENCE", "RESERVABLE_STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_TO_QUALITY_LOCKED_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_TO_STOCK_DIFFERENCE", "STOCK_DIFFERENCE_TO_LOCKED_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_TO_LOCKED_STOCK" ]
Maximum Length: 100

    metaData*

object

additional meta data
additional meta information for booking interface

        sender*

string (enum)

sender
Name of the source system, that has sent this message.

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" ]

        instance*

string (enum)

instance of producer
instance of the application or warehouse context

Any of: [ "LANGENSELBOLD", "OHRDRUF", "LOEHNE", "ANSBACH", "MOSINA", "HALDENSLEBEN", "HALDENSLEBEN_RSS", "SUEDHAFEN", "ALTENKUNSTADT", "SONNEFELD", "ERFURT", "GERNSHEIM", "ILOWA", "LOEHNE_CP" ]
Maximum Length: 30

        client*

string

client
Client/mandant (messages of different clients have different processing rules and destination interfaces) - use FBO for Fulfillment by Otto (CORE, DeepSea…​)

Maximum Length: 50

    data*

object

Data Wms
Data of the JSON message

        sourceTimestamp*

string (date-time)

the booking timestamp
Booking timestamp UTC+ISO-8601 format

        creationType

string (enum)

creation type
identifies specific creation conditions if necessary, in first version only automatic and manual bookings are used for stock journal

Any of: [ "AUTOMATIC", "MANUAL" ]

        location*

string (enum)

the location where where the event was created
the location where the event was created

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" ]

        erpSnapshotId

number

the id of the following inventory snapshot
Consecutive number (sequence) of a long number. each inventory snapshot gets its own ID, which is identical for all records of the snapshot. all bookings get the id of the following snapshot

Maximum Length: 18
Minimum: 1
Maximum: 1000000000000000000

        product*

object

Product Wms
product related information to identify the product and part

            itemNumber

integer

item number
item number (article data) - used for old systems

Maximum: 9999999999

            itemSize

integer

item size
Numeric item size (article data) - used for old systems

Maximum: 99999

            communicationKey

integer

unique communication key
An unique communication key for this item size (FBO: itemOptionCommunicationKey, BONPRIX: MAN…​) - used for old systems

Maximum: 1000000000000000000

            logisticProductId

string

LSAS product ID
LSAS product ID - unique over all item sizes / all clients

            logisticPartId

string

LSAS part ID
GL/bulky items: ID for the part/packing unit based on item - size - part (LSAS)

            partNumber

integer

part number (bulky items)
part number for specific packing unit (bulky items)

Maximum: 999

            numberOfParts

integer

number of all parts
number of all parts for this item (bulky items)

Maximum: 999

        stockInfo*

object

Stock Info Wms
the information for booking related warehouses, filled dependent on event type

Additional Properties: false

            sourceLocation

string (enum)

source location
the source location for the booking

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" ]

            destinationLocation

string (enum)

destination location
the destination location for the booking

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" ]

        movementInfo*

object

Movement Info Wms
movement/booking informations

            quantity*

integer

quantity
quantity to be booked, in case of goods receipt the delivery note original quantity for this detail, in case of goods receipt release booking the released quantity for this detail

Minimum: 1
Maximum: 9999999999

            movementInfoDetails

object

Movement Info Details Wms
Detailed Info about the movement, also used for deprecated data for old systems

                documentNumber

integer

document number
Depending on type, in case of goods release booking then receiptDocumentNo (44xxx) from delivery, in case of return vendor sheet booking the rvsNumber (9x?xxx), otherwise other document numbers.

Maximum: 9999999999

                supplierNumber

integer

supplier number
Number of supplier, mandatory for goods release, return vendor sheet

Maximum: 9999999999

                externalReferenceView

string

External reference view
External reference view - used in core as posting text

Maximum Length: 50

                customerCompany

integer

customer company
Company of the customer account. For example: SON - LDG Großkunden mit Belegnummer

Maximum: 9999999999

                purchaseOrderNumber

string

purchase order number
purchase order number (sent from SON for goods released bookings, ordernumber OVA)

                externalReference

string

external reference
externalReference - Cobra - Unigro reference ano from unigro order

                goodsInId

string

goods in id
unique id of a goods receipt see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/

Maximum Length: 36

                buaid

string

buaid
bi unique article ID, unique identification of an individual unit in the logistical process

Maximum Length: 50

                returnKey

string

returnKey
returnKey

Maximum Length: 500

                b2bOrderId

string

b2b Order Id
ERP Order Id - for stock transfers ordered from ERP

Maximum Length: 36

                loadingNumber

string

Loading Number
generated per sender; generation specification from OTTO, unique within 13 years for stock transfers

Maximum Length: 12

                merchantErpIdentifier

string (enum)

merchant erp identifier
enums that specifies the merchant erp that generated the orders

Any of: [ "DEEP_SEA_CORMORANT", "CORE", "B2B_DEEP_SEA_CORMORANT", "B2B_CORE" ]
Maximum Length: 30

                merchantSingleItemId

string

merchant single item Id
single item id for orders used in merchant erp

Maximum Length: 255

                stockTransferType

string (enum)

stock transfer type
additional transfer type information for stock transfers

Any of: [ "UMF", "WRS_WE", "WRS_L", "IWA_WE", "IWA_M", "GKD" ]
Maximum Length: 50

                orderPart

integer

order part
number of the attempt to reserve or check the stock for orders - starts with zero

Minimum: 0
Maximum: 999999999

                stockType

string (enum)

stock type
stockType for B2B orders which indicates from which stock the order has to be fulfilled

Any of: [ "AVAILABLE", "LOCKED" ]
Maximum Length: 50

                lockTypeCode

string

lock type code
lock type code from wms for locked stock which can also differentiate between the locked stock types used in B2B order bookings

Maximum Length: 50

                returnOrderUUID

string

returnOrderUUID
the UID of the associated return order contract, can be a UUID4

Maximum Length: 100

                originalGoodsInId

string

original goods in id
unique id of the original goods receipt for a goods in from rework see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/

Maximum Length: 36

                b2bShipmentType

string (enum)

b2b shipment type
the shipment type for b2b orders - UMF for stock transfer to another warehouse (with known subtypes in stockTransferType) or GKD for real major customer orders, mandatory for b2b order bookings, null for B2C

Any of: [ "UMF", "GKD" ]
Maximum Length: 30

3 -

3.1 -

Property Type Description

(Root)

object

    eventId*

string (uuid)

The unique eventId
Global unique Id

Minimum Length: 36
Maximum Length: 36

    traceId*

string (uuid)

The unique traceId
Global unique Id for tracing the flow of events

Minimum Length: 36
Maximum Length: 36

    eventTime*

string (date-time)

Time of occurrence of the event
Time at which the record was generated (single event - not the businessEvent/snapshot) in UTC +ISO-8601 format YYYY-MM-DD'T'HH24:MM:SS'Z'

    version*

The number of version schema
Number of version of this data structure. Only required if no $schema is specified!

    context

string (enum)

The context / business case
The context specified here means the business domain.

Any of: [ "ACCUMULATED_WAREHOUSE_STOCK" ]
Maximum Length: 50

    eventType*

string (enum)

Snapshot event
the snapshot type to which the data belongs, currently only snapshots are supported

Any of: [ "STOCK" ]
Maximum Length: 20

    metaData*

object

additional meta information
optional, can be used with different characteristics for technical data per interface

        sender*

string (enum)

sender
Name of the source system, that has sent this message.

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
Client/mandant (messages of different clients have different processing rules and destination interfaces) - use FBO for Fulfillment by Otto (CORE, DeepSea…​)

Any of: [ "FBO", "MYTOYS", "BONPRIX", "WITT", "CORSO", "HEINE", "BAUMARKT_DIREKT", "BAUR", "OTTO", "ABOUTYOU", "F2X", "F2X_MANUFACTUM", "PSAUT", "F2X_SHEEGO", "F2X_CLEARANCE" ]

        messageNumber

integer

current message number
the current message number that is transmitted

Minimum: 1
Maximum: 1000000000000000000

        lastMessageNumber

integer

last message number
how many messages are to be transferred

Minimum: 1
Maximum: 1000000000000000000

        dailySnapshotNumber*

integer

daily snapshot number
sequence number of the snapshot per day, starts every day again with number 1

Minimum: 1
Maximum: 100

        snapshotTime

string (date-time)

snapshot time
time of the snapshot creation

    data*

object

        erpSnapshotId*

integer

the id of the inventory snapshot
Consecutive number (sequence) of a long number. each inventory snapshot gets its own ID from WMS, which is identical for all records of the snapshot. all bookings get the id of the following snapshot, generated by wms, each wms has his own scope

Maximum Length: 18
Minimum: 1
Maximum: 1000000000000000000

        erpProductId*

string

¨ERP Product Id
master communication key between Erp and LSAS for item sizes

Maximum Length: 36

        erpPackingUnitId*

string

¨ERP PackingUnit Id
master communication key between LSAS and ERP for packing units of an item sized - used in Deep Sea for identification

Maximum Length: 36

        packingUnitIndex

integer

¨PackingUnit Number
Part Number for products with multiple parts - use 1 for PL

Maximum: 99

        location*

string (enum)

location
the location where the event was created

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" ]

        quantity*

integer

quantity
quantity containing to this stock type

Minimum: 1
Maximum: 9999999999

        erpStockType*

string (enum)

ERP Stock Type
stock type, which are defined at ERP

Any of: [ "DELIVERABLE_STOCK", "QUALITY_LOCKED_STOCK", "LOCKED_STOCK", "STOCK_IN_FULFILLMENT", "RESERVABLE_LOCKED_STOCK", "STOCK_IN_TRANSIT", "RESERVABLE_STOCK_IN_TRANSIT", "STOCK_IN_FULFILLMENT_QUALITY_LOCKED" ]
Maximum Length: 50

4 -

4.1 -

Property Type Description

(Root)

object

Unique Article Identifier
Get unique article identifier data for a Buaid

    eventId*

string (uuid)

UUID for this event
UUID for this event

Minimum Length: 36
Maximum Length: 36
Regular expression: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

    eventTime*

string (date-time)

the date and time, when this event occured as an ISO-8601 timestamp.
the date and time, when this event occured as an ISO-8601 timestamp.

    traceId*

string (uuid)

The unique traceId
Global unique Id for tracing the flow of events

Minimum Length: 36
Maximum Length: 36

    eventType*

string (enum)

event type
the snapshot type to which the data belongs, currently only snapshots are supported

Any of: [ "STOCK" ]
Maximum Length: 20

    context*

string (enum)

context
The context specified here means the business domain.

Any of: [ "UNIQUE_ARTICLE_IDENTIFIER_DATA" ]
Maximum Length: 50

    version*

string

Json schema version
JSON schema version

Minimum Length: 3
Maximum Length: 4
Regular expression: ^[0-9]+[.][0-9]+$

    data*

object

        status*

string (enum)

Status
Status

Any of: [ "NOT_FOUND", "SUCCESS" ]
Maximum Length: 50

        buaid*

string

buaid
bi unique article ID, unique identification of an individual unit in the logistical process

Maximum Length: 50

        supplier

object

            id

string

supplier number
supplier number (LKZ) - deprecated

Maximum Length: 50

            name

string

Name of supplier
Name of supplier

Maximum Length: 50

            erpSupplierId

string

technical erp supplier id
erp supplier ID - LSAS based ID

Maximum Length: 36

        bestBeforeDate

string (date)

best Before Date
best before date

        batch

string

batch
batch number

Maximum Length: 100

        imei

string

imei
IMEI of a technical device

Maximum Length: 50

        imei2

string

imei2
second IMEI of dual sim technical device

Maximum Length: 50

        serialNumber

string

serial number
serial number of the manufacturer

Maximum Length: 100

4.2 -

Property Type Description

(Root)

object

Unique Article Identifier
Get unique article identifier data for a Buaid

    eventId*

string (uuid)

UUID for this event
UUID for this event

Minimum Length: 36
Maximum Length: 36
Regular expression: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

    eventTime*

string (date-time)

the date and time, when this event occured as an ISO-8601 timestamp.
the date and time, when this event occured as an ISO-8601 timestamp.

    traceId*

string (uuid)

The unique traceId
Global unique Id for tracing the flow of events

Minimum Length: 36
Maximum Length: 36

    eventType*

string (enum)

event type
the snapshot type to which the data belongs, currently only snapshots are supported

Any of: [ "STOCK" ]
Maximum Length: 20

    context*

string (enum)

context
The context specified here means the business domain.

Any of: [ "UNIQUE_ARTICLE_IDENTIFIER_DATA" ]
Maximum Length: 50

    version*

string

Json schema version
JSON schema version

Minimum Length: 3
Maximum Length: 4
Regular expression: ^[0-9]+[.][0-9]+$

    data*

object

        status*

string (enum)

Status
Status

Any of: [ "UPDATE" ]
Maximum Length: 50

        buaid*

string

buaid
bi unique article ID, unique identification of an individual unit in the logistical process

Maximum Length: 50

        supplier*

object

            logisticsSupplierId*

string

technical logistics supplier id
logistics supplier ID - LSAS based ID

Maximum Length: 36

            id

string

supplier number
supplier number (LKZ) - deprecated

Maximum Length: 50

        bestBeforeDate

string (date)

best Before Date
best before date

        batch

string

batch
batch number

Maximum Length: 100

        imei

string

imei
IMEI of a technical device

Maximum Length: 50

        imei2

string

imei2
second IMEI of dual sim technical device

Maximum Length: 50

        serialNumber

string

serial number
serial number of the manufacturer

Maximum Length: 100

5 - S01 Warehouse Stock

Status

Version 1.0 published 14.06.2022

Approval
  1. DeepSea:

  2. NEON: agreed with Körber for implementation in NEON_Fein_Pflichtenheft_WEN1_ SST_v6.0

Comment

The first version is being developed for connecting LVS to FLASH and SOLAR. The connection to the merchant will be made for the inventory at the end of 2024.

Assumption

BISKO is not considered and receives the data from the inventory systems via the inventory interfaces. No connection to BISKO is planned for NEON.

1. Stakeholder

Role Application Responsible

Communication

Integration Layer

Leading App

Bube

InterfaceOwner

Bube

Producer

kMotion

Producer

KR1

Producer

COBRA

Producer

WMSx/SON

Consumer

Comorant

Consumer

Humpback

Consumer

OBS

MyToys

Consumer

FLASH

Consumer

SOLAR

Consumer

Nemo

2. Business Context

To determine stock levels in the warehouse management systems, a snapshot of the stock in the WMSs is taken at agreed times and sent to the merchants or data analytics.

2.1. Snapshot-Delivery times

Table 1. Attribute
Snapshot System Delivery time

1

KR1

2:00

2

KR1

8:00

3

KR1

12:00

4

KR1

16:00

5

KR1

20:00

1

kMotion

0:00

2

kMotion

4:48

3

kMotion

9:36

4

kMotion

14:24

5

kMotion

19:12

3. Information flow

Partner Direction FINE-Service Topic/API Description Status

WMS:WMSx

send

BuBe:StockService

stock.warehousestock.v2

WarehouseStockWms.v2.0

ready

WMS:KR1

send

BuBe:StockService

stock.warehousestock.kr1.v3

WarehouseStockWms.v3.1

ready

WMS:kMotion ILOWA

send

BuBe:StockService

stock.warehousestock.kmotion.v3

WarehouseStockWms.v3.1

ready

WMS:kMotion GERNSHEIM

send

BuBe:StockService

stock.warehousestock.kmotion.v3

WarehouseStockWms.v3.1

planned

FLASH

receive

BuBe:StockService

stock.warehousestock.v2

WarehouseStockWms.v2.0

ready

ERP:Otto

receive

BuBe:StockService

stock.warehousestock.v2.otto

WarehouseStockWms.v2.0

ready

ERP:DeepSea

receive

BuBe:StockService

stock.warehousestock.deepsea.v3

WarehouseStockErp.v3.2

planned

ERP:F2X

receive

BuBe:StockService

stock.warehousestock.f2x.v3

WarehouseStockErp.v3.2

planned

Diagram

4. Interface

4.1. Direction WMS to FINE

4.1.1. Header

This interface uses the Service Header

Special expression for this interface:

Table 2. Attribute
Fieldname Expression Version

type

SNAPSHOT_1

SNAPSHOT_2

SNAPSHOT_3

SNAPSHOT_4

SNAPSHOT_5

⇐ V2.1

type

SNAPSHOT

>= V3.0

context

WAREHOUSE_STOCK

4.1.2. Data model

Property Type Description

(Root)

object

    eventId*

string (uuid)

The unique eventId
Global unique Id

Minimum Length: 36
Maximum Length: 36

    traceId*

string (uuid)

The unique traceId
Global unique Id for tracing the flow of events

Minimum Length: 36
Maximum Length: 36

    spanId

string (uuid)

The eventId of previous record or batchId
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), recommended as uuid, Special usecases can be specify for some interfaces

Minimum Length: 36
Maximum Length: 36

    eventTime*

string (date-time)

Time of occurrence of the event
Time at which the record was generated (single event - not the businessEvent/snapshot) in UTC +ISO-8601 format YYYY-MM-DD'T'HH24:MM:SS'Z'

    version*

The number of version schema
Number of version of this data structure. Only required if no $schema is specified!

    context

string (enum)

The context / business case
The context specified here means the business domain.

Any of: [ "WAREHOUSE_STOCK" ]
Maximum Length: 50

    eventType*

string (enum)

Snapshot event
the snapshot type to which the data belongs, currently only snapshots are supported

Any of: [ "SNAPSHOT" ]
Maximum Length: 20

    metaData*

object

additional meta information
optional, can be used with different characteristics for technical data per interface

        sender*

string (enum)

sender
Name of the source system, that has sent this message.

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

client
Client/mandant (messages of different clients have different processing rules and destination interfaces) - use FBO for Fulfillment by Otto (CORE, DeepSea…​)

Maximum Length: 50

        messageNumber

integer

current message number
the current message number that is transmitted

Minimum: 1
Maximum: 1000000000000000000

        lastMessageNumber

integer

last message number
how many messages are to be transferred

Minimum: 1
Maximum: 1000000000000000000

        dailySnapshotNumber*

integer

daily snapshot number
sequence number of the snapshot per day, starts every day again with number 1

Minimum: 1
Maximum: 100

        snapshotTime

string (date-time)

snapshot time
time of the snapshot creation

    data*

object

        snapshotId

integer

the id of the inventory snapshot
Consecutive number (sequence) of a long number. each inventory snapshot gets its own ID from WMS, which is identical for all records of the snapshot. all bookings get the id of the following snapshot, generated by wms, each wms has his own scope

Maximum Length: 18
Minimum: 1
Maximum: 1000000000000000000

        quantId*

string

Quant Id
ID of the finest stock separating unit, generated id for virtual quants/units

Maximum Length: 100

        quantType*

string (enum)

quant type
type of quant, virtual for stocks without relation to a real physical quant ,e.g. high level reserved quantities, advised detours

Any of: [ "PHYSICAL", "VIRTUAL" ]
Maximum Length: 10

        location*

string (enum)

location
the location where the event was created

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" ]

        sourcelocation

string (enum)

source location
the source location of the stock e.g. the sending location for returns or detours

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" ]

        totalQuantity*

integer

total quantity
the total quantity for this quant including reserved qty in kMotion

Minimum: 1
Maximum: 9999999999

        stockInformation*

array

stockInformation
the stock related informations for the single quantities of this quant

            (Array item)

object

                quantity*

integer

quantity
quantity containing to this stock type

Minimum: 1
Maximum: 9999999999

                stockType*

string (enum)

Stock Type
stock type, that indicates whether an individual part is in goods in stock (before releasing), available, reserved for orders, advised as return or detour…​

Any of: [ "GOODS_IN", "AVAILABLE", "QUALITY_LOCKED", "LOCKED", "RESERVED_FOR_ORDERS", "HIGH_LEVEL_RESERVED_FOR_ORDER", "RETURN_OR_DETOUR", "RESERVABLE_LOCKED", "RESERVABLE_RETURN_OR_DETOUR", "REPLENISHMENT" ]
Maximum Length: 50

        stockTypeCode

string

WMS Stock Type
stock type used in wms frontend (if available)

Maximum Length: 50

        sourceType

string (enum)

source Type
additional source type information for distinction of stock source (detour, returns, goodsin from supplier etc.) and assignment of erp stocktypes

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", "STORABLE_RETURNS", "NON_STORABLE_RETURNS", "GOODSIN_SUPPLIER" ]
Maximum Length: 50

        isInventory

boolean

is Inventory
set it true if the quant was intended for inventory checking, otherwise to false

        isIgnoredForComparison

boolean

is ignored for comparison
set it true, if this quant should be ignored for comparison during group inventory, normally used for returns that are advised with isInventory flag from RESY, because they are not booked

        customsType

string (enum)

Type of customs
indicates whether the quant have been cleared or not

Any of: [ "CUSTOMS_CLEARED", "CUSTOMS_NOT_CLEARED", "UNKNOWN" ]
Maximum Length: 50

        customsTypeCode

string

WMS Customs Type
customs type code used in wms frontend

Maximum Length: 50

        qualityControlTypeCode

string

WMS Quality Control Type
quality control type used in wms (account)

Maximum Length: 50

        locks

array

locks
locks used in wms, a quant can have multiple locks, use also wms code for unlocked,

            (Array item)

object

                typeCode

string

lock type
lock used in front end of WMS

Maximum Length: 50

                time

string (date-time)

Lock Date
time the lock was set

        buaid

string

buaid
bi unique article ID, unique identification of an individual unit in the logistical process

Maximum Length: 50

        BUID

string

BUID
obsolete. for backwards compatibility with V3.0. Use attribute buiad instead. BI UUID, unique identification of an individual unit in the logistical process

        bestBeforeDate

string (date)

best Before Date
best before date

        batch

string

batch
batch number

Maximum Length: 100

        imei

string

imei
IMEI of a technical device

Maximum Length: 50

        imei2

string

imei2
second IMEI of dual sim technical device

Maximum Length: 50

        serialNo

string

serial number
serial number of the manufacturer

Maximum Length: 100

        volume

object

volume
volume of the whole quant - gross value - measured

            value

string

Value

Regular expression: ^[0-9]{1,9}[.][0-9]{1,6}$

            unit

string (enum)

unit volume

Any of: [ "CUBIC_METER", "LITER" ]

        weight

object

weight
weight of the whole quant - gross value - measured

            value

string

Value

Regular expression: ^[0-9]{1,9}[.][0-9]{1,3}$

            unit

string (enum)

unit weight

Any of: [ "GRAM", "KILOGRAM" ]

        product*

object

            logisticsProductId

string

¨Logistic Product Id
master communication key

Maximum Length: 36

            itemNumber

string

Item Number
the item number-> Only provided by WMSx Sonnefeld - deprecated

            itemSize

string

Item Size
the item size (binary size, not alphanumeric) -> Only provided by WMSx Sonnefeld - deprecated

Maximum Length: 3

            company

string

Company
actual owner company - used in FLASH

Maximum Length: 50

            logisticsPackingUnitId

string

¨Logistic PackingUnit Id
master communication key from LSAS for products with multiple parts

Maximum Length: 36

            packingUnitIndex

integer

¨Logistic PackingUnit Number
Part Number for products with multiple parts - deprecated

Maximum: 99

        supplier

object

            logisticsSupplierId

string

technical logistics supplier id
logistics supplier ID - LSAS based ID

Maximum Length: 36

            supplierId

integer

supplier number
supplier number (LKZ) - deprecated

Minimum: 0
Maximum: 999999

        storageLocationId

string

storage location
unique identification of a storage location. see interface https://docs.osp-fine.de/page/fine-common/30_stock/s08_storage_location/s08_storage_location/

        storageHandlingUnitId

string

storage handling Unit
unique identification of a charge carrier/bundle. see interface https://docs.osp-fine.de/page/fine-common/30_stock/s09_storage_handling_unit/s09_storage_handling_unit/

        goodsIn

object

            goodsInId

string

goods in id
unique id of a goods receipt see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/

Maximum Length: 36

            deliveryPositionId

string

delivery position id
unique id of a delivery position see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/

Maximum Length: 36

        movementInfo

object

            firstMovement*

string (date-time)

first movement date
time of creation of the stock in the wms for determining the laytime of a stock unit, for retour or detour stocks use the advise date

            lastMovement

string (date-time)

last movement date
last movement of the stock unit to derive old stock and bum articles

            lastPickingDate

string (date-time)

last picking date
time at which the last pick/commission was made from this remaining quant

4.1.3. Enumeration

Field: Event Type

Table 3. eventType
Meta Value Description Short Value

SNAPSHOT

Complete snapshot

Field: Customs Type

Table 4. customsType

Meta Value

Description

Short Value

CUSTOMS_CLEARED

CUSTOMS_NOT_CLEARED

UNKNOWN

Field: Quality Control Type

Table 5. qualityControlType
Meta Value Description Short Value

Field: Locks Type Code

Table 6. typeCode
Meta Value Description Short Value

Field: Quant Type

Table 7. quantType

Meta Value

Description

Short Value

PHYSICAL

value for physical quants/containers

VIRTUAL

value for virtual quants, that cannot be assigned to real quanta, e.g. in replenishment or high level reservation

Field: Stock Type

Table 8. stockType

Meta Value

Description

Short Value

GOODS_IN

goods in from supplier after WE1 before WE2

AVAILABLE

stock that is available, can be sold, after WE2

QUALITY_LOCKED

quality locked stock after WE2

LOCKED

locked stock after WE2

RESERVED_FOR_ORDERS

reserved for orders after logistic buffer call - based on real quants

HIGH_LEVEL_RESERVED_FOR_ORDER

reserved for orders after logistic buffer call - based on item size - not containing to a real quant

RETURN_OR_DETOUR

stock adviced for returns or detours on transport to the warehouse

RESERVABLE_LOCKED

locked stock available for customer reservations

RESERVABLE_RETURN_OR_DETOUR

stock in transport (detours) available for customer reservations

REPLENISHMENT

replenishment - for KR1 replenishment stock which is transported to the picking area - contains available and reserved for orders

k.Motion:

available stock is calculated as available stock minus high level reserved for orders with stockTypeCode AV

(quality) locked stock is calculated as locked stock minus high level reserved for orders with stockTypeCode LO

stock in fulfillment is the sum of reserved for orders and high level reserved for order

KR1:

available stock from replenishment is calculated as replenishment minus reserved stock from virtual quants

4.1.4. Example

Message WMSx to FINE
{
	"eventId":"0999c557-4c8d-e5bf-e063-4585b30a51c8",
	"traceId":"0999c557-4c8d-e5bf-e063-4585b30a51c8",
	"eventTime":"2023-11-08T01:00:09.000+01:00",
	"version":"2.0",
	"context":"WAREHOUSE_STOCK",
	"eventType":"SNAPSHOT_1",
	"metaData":{
		"senderSystem":"WMSX_SON",
		"messageNumber":6406,
		"lastMessageNumber":598820
	},
	"data":{
		"quantId":"111569868",
		"location":"SONNEFELD",
		"stockType":"ON_LOCATION",
		"stockTypeCode":"FR",
		"locks":[
			{
				"typeCode":"------",
				"type":"AVAILABLE"
			}
		],
		"customsType":"CUSTOMS_CLEARED",
		"customsTypeCode":"10",
		"qualityControlType":"AVAILABLE",
		"storageLocation":{
			"id":"FROH-MFL75/75-042-28-E2"
		},
		"storageHandlingUnit":{"id":"1794472"},
		"quantity":12,
		"reservedQuantity":0,
		"goodsIn":{
			"id":"2311021583"
		},
		"product":{
			"logisticProductId":"",
			"itemNumber":42903513,
			"itemSize":0,
			"company":"OTTO"
		},
		"movementInfo":{
			"firstMovement":"2023-04-20T13:19:05.000+01:00",
			"lastMovement":"2023-08-13T18:23:21.000+01:00"
		}
	}
}
Message KR1 to FINE
{
	"eventId":"377ae48b-d7e1-47fe-9057-1a3026f892e8",
	"traceId":"8e9673b6-4651-4a77-b47a-0caa8165490a",
	"eventTime":"2024-03-18T02:08:12.334+01:00",
	"version":"3.1",
	"context":"WAREHOUSE_STOCK",
	"eventType":"SNAPSHOT",
	"metaData":{
		"sender":"KR1_SHF",
		"client":"OTTO",
		"messageNumber":13,
		"lastMessageNumber":2131752,
		"dailySnapshotNumber":1,
		"snapshotTime":"2024-03-18T02:05:53.000+01:00"
	},
	"data":{
		"snapshotId":531,
		"quantId":"1/245194177",
		"quantType":"PHYSICAL",
		"location":"SUEDHAFEN",
		"totalQuantity":2,
		"stockInformation":[
			{
				"quantity":2,
				"stockType":"AVAILABLE"
			}
		],
		"stockTypeCode":"101",
		"isInventory":false,
		"customsType":"CUSTOMS_CLEARED",
		"customsTypeCode":"203",
		"qualityControlTypeCode":"505",
		"locks":[],
		"product":{
			"logisticsProductId":"23755776"
		},
		"supplier":{
			"logisticsSupplierId":"297901",
			"supplierId":10592
		},
		"storageLocationId":"83420",
		"storageHandlingUnitId":"24548611",
		"goodsIn":{},
		"movementInfo":{
			"firstMovement":"2024-01-23T02:17:52.214+01:00",
			"lastMovement":"2024-03-16T07:27:47.788+01:00"
		}
	}
}
Messages KMOTION to FINE
{
	"eventId":"c6bf3dd9-836f-4765-a0e8-a78413e3fda3",
	"traceId":"eff93878-42dc-478e-a2c4-eb26dee6ef01",
	"eventTime":"2023-10-10T19:12:00.087+02:00",
	"version":"3.2",
	"context":"WAREHOUSE_STOCK",
	"eventType":"SNAPSHOT",
	"metaData":{
		"sender":"KMOTION_ILO",
		"client":"FBO",
		"messageNumber":1,
		"lastMessageNumber":11,
		"dailySnapshotNumber":5,
		"snapshotTime":"2023-10-10T19:12:00.082+02:00"
	},
	"data":{
		"snapshotId":1232,
		"quantId":"22000003788",
		"quantType":"PHYSICAL",
		"location":"ILOWA",
		"sourcelocation":"ILOWA",
		"totalQuantity":10,
		"stockInformation":[
			{"quantity":10,"stockType":"GOODS_IN"}
		],
		"stockTypeCode":"RC",
		"isInventory":false,
		"isIgnoredForComparison":false,
		"customsType":"CUSTOMS_CLEARED",
		"customsTypeCode":"00",
		"qualityControlTypeCode":"00",
		"locks":[
			{"typeCode":"------"}
		],
		"volume":{
			"value":"111.0",
			"unit":"LITER"
		},
		"weight":{
			"value":"12240.0",
			"unit":"GRAM"
		},
		"product":{
			"logisticsProductId":"70371792",
			"itemNumber":"18102810",
			"itemSize":"0",
			"packingUnitIndex":1
		},
		"supplier":{
			"supplierId":0
		},
		"storageLocationId":"G00_R0_F00_E00_K0_Z0",
		"storageHandlingUnitId":"210000025334",
		"goodsIn":{
			"goodsInId":"22000000527",
			"deliveryPositionId":"22000000527-1"
		},
		"movementInfo":{
			"firstMovement":"2023-10-10T14:45:40.000+02:00"
		}
	}
}

{
	"eventId":"f58126f1-8779-42e6-8492-264e40d6b772",
	"traceId":"1ca24149-e886-42a1-aba2-d24a91a510bf",
	"eventTime":"2023-11-10T04:48:00.137+01:00",
	"version":"3.2",
	"context":"WAREHOUSE_STOCK",
	"eventType":"SNAPSHOT",
	"metaData":{
		"sender":"KMOTION_ILO",
		"client":"FBO",
		"messageNumber":47,
		"lastMessageNumber":301,
		"dailySnapshotNumber":2,
		"snapshotTime":"2023-11-10T04:48:00.071+01:00"
	},
	"data":{
		"snapshotId":1378,
		"quantId":"22000004469",
		"quantType":"PHYSICAL",
		"location":"ILOWA",
		"sourcelocation":"ILOWA",
		"totalQuantity":1,
		"stockInformation":[
			{
				"quantity":1,
				"stockType":"RESERVED_FOR_ORDERS"
			}
		],
		"stockTypeCode":"AV",
		"sourceType":"GOODSIN_SUPPLIER",
		"isInventory":false,
		"isIgnoredForComparison":false,
		"customsType":"CUSTOMS_CLEARED",
		"customsTypeCode":"00",
		"qualityControlTypeCode":"00",
		"locks":[
			{
				"typeCode":"------ - not locked"
			}
		],
		"buaid":"79b41ed7-7a4f-49fb-af34-a1eefd075048",
		"volume":{
			"value":"2.3","unit":"LITER"
		},
		"weight":{
			"value":"151.0","unit":"GRAM"
		},
		"product":{
			"logisticsProductId":"68249121",
			"itemNumber":"77500344",
			"itemSize":"42",
			"packingUnitIndex":0
		},
		"supplier":{
			"supplierId":0
		},
		"storageLocationId":"PP001_FBW",
		"storageHandlingUnitId":"290000008544",
		"goodsIn":{},
		"movementInfo":{
			"firstMovement":"2023-11-08T16:18:28.000+01:00"
		}
	}
}

4.1.5. Version history

Table 9. Version WMS to FINE

Version

Number

File

Published on

previous version

1.0

Download

17.06.22

previous version

2.0

Download

20.09.22

previous version

2.1

Download

25.01.23

previous version

3.0

Download

10.07.23

previous version

3.1

Download

18.03.24

current version

3.2

Download

09.01.25

coming version

4.1.6. Changelog

Changes V1.0

  1. Payload (Data)

    • ENUM of CustomType changed to CUSTOMS_CLEARED

    • "erpSnapshotId“ is not a „required“ element

Changes V1.0 → V2.0

  1. Standard header: The Standard header has been changed to the current standard header with following changes:

    • attributes "sender", "messageNumber" and "lastMessageNumer" has been moved to the new object type "metaData"

    • attribute "sender" is now linked to system.v1.schema.json

    • attribute "type" has been renamed to "eventType"

    • attribute "spanId" is now an optional field

  2. Payload (Data)

Changes V2.0 → V2.1

  1. Standard header

  2. Payload (Data)

    • add "logisticsPackingunitId" und "packingUnitIndex" at section "product" for articles with several parts as optional fields

    • add fields "BUID", "bestBeforeDate", "batch", "imei", "serialNo" as optional fields

Changes V2.1 → V3.0

  1. Standard header

    • attribute "sender" is now linked to system.v7.schema.json

    • attribute "client" is now linked to company.v5.schema.json

    • enum values for "eventType" were updated

    • fields of header were changed to "dailySnapshotNumber" and "snapshotTime"

    • renamed "erpSnapshotId" to "snapshotId"

  2. Payload (Data)

    • distinguish "totalQuantity" and "stockInformation" with different quantities for reserved and free quantity in k.Motion, used to distinguish different "stockType" and virtual quants with "quantType" for high level reservations (KMOTION type RC - GOODS_IN, AV - AVAILABLE, LO - LOCKED with free quantity of quant, RESERVED_FOR_ORDER for reserved qty of quant…​)

    • added new field "lastPickingDate"

    • changed references and attribute names for "supplier" and "goodsIn"

Changes V3.0 → V3.1

  1. Standard header

  2. Payload (Data)

    • added new field "isInventory" - set true if quant is registered for inventory checks

    • added new field "buaid" - prepare renaming BUID to buaid, don’t use BUID anymore (marked as obsolete) for V3.0 data

    • added new field "sourceType" - for distinction of stock source (detour, returns, goods in …​)

    • extend "quantId" to 100 signs

    • added new field "imei2" for dual sim devices

Changes V3.1 → V3.2

  1. Standard header

    • attribute "client" - reference to global company enums removed. Use string.

    • attribute "company" - reference to global company enums removed. Use string.

  2. Payload (Data)

    • attribute "isIgnoredForComparison" - new boolean value for group inventory

    • attribute "volume" - "value" - introduce pattern to validate string matches oracles decimal(15,6)

    • attruibute "weight" - "value" - introduce pattern to validate string matches oracles decimal(12,3)

Notes for new major version:

  • remove BUID

  • rename sourcelocation to sourceLocation

4.1.7. Schema

Message WMS to FINE V3.2
{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$comment": "Schema for stock in a warehouse Version 3.2 for WMS",
    "$id": "https://doc.fine.gcp.osp-dev.de/registry/Stock/WarehouseStockWms.v3.2.schema.json",
    "type": "object",
    "definitions": {
        "stockType": {
            "title": "Type of the stock",
            "description": "stockType, that indicates whether an individual part is in goods in stock (before releasing), available, reserved for orders, advised as return or detour...",
            "type": "string",
            "maxLength": 50,
            "enum": ["GOODS_IN",
                     "AVAILABLE",
                     "QUALITY_LOCKED",
                     "LOCKED",
                     "RESERVED_FOR_ORDERS",
                     "HIGH_LEVEL_RESERVED_FOR_ORDER",
                     "RETURN_OR_DETOUR",
                     "RESERVABLE_LOCKED",
                     "RESERVABLE_RETURN_OR_DETOUR",
                     "REPLENISHMENT"]
        },
        "sourceType": {
            "title": "additional source type",
            "description": "additional source type information for distinction of stock source (different transfer types, returns, goodsin from supplier etc.), used for erp stocktype mappings, has to be filled at least for all messages with stockType RETURN_OR_DETOUR and for NON_STORABLE_RETURNS",
            "type": "string",
            "maxLength": 50,
            "enum": ["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",
                     "STORABLE_RETURNS",
                     "NON_STORABLE_RETURNS",
                     "GOODSIN_SUPPLIER"
                     ]
        }
    },
    "properties": {
        "eventId": {
            "title": "The unique eventId",
            "description": "Global unique Id",
            "type": "string",
            "format": "uuid",
            "minLength": 36,
            "maxLength": 36,
            "examples": [
                "00ce536f-923a-42f4-8128-be118faf1d87"
            ]
        },
        "traceId": {
            "title": "The unique traceId",
            "description": "Global unique Id for tracing the flow of events",
            "type": "string",
            "format": "uuid",
            "minLength": 36,
            "maxLength": 36,
            "examples": [
                "00ce536f-923a-42f4-8138-33418faf1342"
            ]
        },
        "spanId": {
            "title": "The eventId of previous record or batchId",
            "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), recommended as uuid, Special usecases can be specify for some interfaces",
            "type": "string",
            "format": "uuid",
            "minLength": 36,
            "maxLength": 36,
            "examples": [
                "00ce536f-923a-42f4-5463-32a41877b3c2"
            ]
        },    
        "eventTime": {
            "title": "Time of occurrence of the event",
            "description": "Time at which the record was generated (single event - not the businessEvent/snapshot) in UTC +ISO-8601 format YYYY-MM-DD'T'HH24:MM:SS'Z'",
            "type": "string",
            "format": "date-time",
            "examples": [
                "2022-04-16T16:06:05.123456Z",
                "2022-04-19T08:51:05+02:00"
            ]
        },
        "version": {
            "title": "The number of version schema",
            "description": "Number of version of this data structure. Only required if no $schema is specified!",
            "oneOf": [
                {
                    "type": "string",
                    "pattern": "\\d+\\.\\d{1,2}",
                    "examples": ["1.01", "01.02"]
                },
                {
                    "type": "integer",
                    "examples": [1, 2]
                }
            ]
        },
        "context": {
            "title": "The context / business case",
            "description": "The context specified here means the business domain.",
            "type": "string",
            "maxLength":50,
            "enum": [
                "WAREHOUSE_STOCK"
            ]
        },
        "eventType": {
            "title": "Snapshot event",
            "description": "the snapshot type to which the data belongs, currently only snapshots are supported",
            "type": "string",
            "maxLength": 20,
            "enum": ["SNAPSHOT"],
            "examples":["SNAPSHOT"]
        },
        "metaData": {
            "title": "additional meta information",
            "description": "optional, can be used with different characteristics for technical data per interface",
            "type": "object",
            "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.v7.schema.json"
                },
                "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...)",
                    "type": "string",
                    "maxLength": 50,
                    "examples": [
                        "FBO"
                    ]
                },
                "messageNumber": {
                    "title": "current message number",
                    "description": "the current message number that is transmitted",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 999999999999999999
                },
                "lastMessageNumber": {
                    "title": "last message number",
                    "description": "how many messages are to be transferred",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 999999999999999999
                },
                "dailySnapshotNumber": {
                    "title": "daily snapshot number",
                    "description": "sequence number of the snapshot per day, starts every day again with number 1",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100
                },
                "snapshotTime": {
                    "title": "snapshot time",
                    "description": "time of the snapshot creation",
                    "type": "string",
                    "format": "date-time",
                    "examples": [
                        "2022-04-16T16:06:05.123456Z",
                        "2022-04-19T08:51:05+02:00"
                    ]
                }
            }, 
            "required": [
                "sender",
                "client",
                "dailySnapshotNumber"
            ]   
        },
        "data": {
            "type": "object",
            "properties": {
                "snapshotId": {
                    "title": "the id of the inventory snapshot",
                    "description": "Consecutive number (sequence) of a long number. each inventory snapshot gets its own ID from WMS, which is identical for all records of the snapshot. all bookings get the id of the following snapshot, generated by wms, each wms has his own scope",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 999999999999999999,
                    "maxLength": 18,
                    "examples": [
                        122
                    ]
                },
                "quantId": {
                    "title": "Quant Id",
                    "description": "ID of the finest stock separating unit, generated id for virtual quants/units",
                    "type": "string",
                    "maxLength": 100,
                    "examples":["1189582"]
                },
                "quantType": {
                    "title": "quant type",
                    "description": "type of quant, virtual for stocks without relation to a real physical quant ,e.g. high level reserved quantities, advised detours",
                    "type": "string",
                    "maxLength": 10,
                    "enum":["PHYSICAL","VIRTUAL"]
                },           
                "location": {
                    "title": "location",
                    "description": "the location where the event was created",
                    "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/warehouselocations.v1.schema.json"
                },
                "sourcelocation": {
                    "title": "source location",
                    "description": "the source location of the stock e.g. the sending location for returns or detours",
                    "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/warehouselocations.v1.schema.json"
                },
                "totalQuantity": {
                    "title": "total quantity",
                    "description": "the total quantity for this quant including reserved qty in kMotion",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9999999999,
                    "examples":["20"]
                },
                "stockInformation": {
                    "title": "stockInformation",
                    "description": "the stock related informations for the single quantities of this quant",
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "quantity": {
                                "title": "quantity",
                                "description": "quantity containing to this stock type",
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 9999999999,
                                "examples":[90]
                            },
                            "stockType": {
                                "title": "Stock Type",
                                "description": "stock type, that indicates whether an individual part is in goods in stock (before releasing), available, reserved for orders, advised as return or detour...",
                                "$ref": "#/definitions/stockType"
                            }
                        },
                        "required": [
                            "quantity",
                            "stockType"
                        ]
                    }
                },
                "stockTypeCode": {
                    "title": "WMS Stock Type",
                    "description": "stock type used in wms frontend (if available)",
                    "type": "string",
                    "maxLength": 50,
                    "examples":["4251"]
                },
                "sourceType": {
                    "title": "source Type",
                    "description": "additional source type information for distinction of stock source (detour, returns, goodsin from supplier etc.) and assignment of erp stocktypes",
                    "$ref": "#/definitions/sourceType"
                },
                "isInventory": {
                    "title": "is Inventory",
                    "description": "set it true if the quant was intended for inventory checking, otherwise to false",
                    "type": "boolean",
                    "default": false,
                    "examples": [true,false]
                },
                "isIgnoredForComparison": {
                    "title": "is ignored for comparison",
                    "description": "set it true, if this quant should be ignored for comparison during group inventory, normally used for returns that are advised with isInventory flag from RESY, because they are not booked",
                    "type": "boolean",
                    "default": false,
                    "examples": [true,false]
                },
                "customsType": {
                    "title": "Type of customs",
                    "description": "indicates whether the quant have been cleared or not",
                    "type": "string",
                    "maxLength": 50,
                    "enum": ["CUSTOMS_CLEARED", "CUSTOMS_NOT_CLEARED", "UNKNOWN"],
                    "example": ["CUSTOMS_CLEARED"]
                },
                "customsTypeCode": {
                    "title": "WMS Customs Type",
                    "description": "customs type code used in wms frontend",
                    "type": "string",
                    "maxLength": 50,
                    "example": ["5614D"]
                }, 
                "qualityControlTypeCode": {
                    "title": "WMS Quality Control Type",
                    "description": "quality control type used in wms (account)",
                    "type": "string",
                    "maxLength": 50,
                    "examples":["1234ABCD"]
                },               
                "locks": {
                    "title": "locks",
                    "description": "locks used in wms, a quant can have multiple locks, use also wms code for unlocked, ",
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {            
                            "typeCode": {
                                "title": "lock type",
                                "description": "lock used in front end of WMS",
                                "type": "string",
                                "maxLength": 50,
                                "examples":["1120ABD"]
                            },
                            "time": {
                                "title": "Lock Date",
                                "description": "time the lock was set",
                                "type": "string",
                                "format": "date-time",
                                "examples":["2022-03-22T09:52:00.000+0100"]
                            }
                        }
                    }
                }, 
                "buaid": {
                    "title": "buaid",
                    "description": "bi unique article ID, unique identification of an individual unit in the logistical process",
                    "type": "string",
                    "maxLength": 50,
                    "examples":["2344545-334542-465g45ddf"]
                },
                "BUID": {
                    "title": "BUID",
                    "description": "obsolete. for backwards compatibility with V3.0. Use attribute buiad instead. BI UUID, unique identification of an individual unit in the logistical process",
                    "type": "string",
                    "examples":["2344545-334542-465g45ddf"]
                },
                "bestBeforeDate": {
                    "title": "best Before Date",
                    "description": "best before date",
                    "type": "string",
                    "format":"date",
                    "examples":["2022-12-31"]
                },
                "batch": {
                    "title": "batch",
                    "description": "batch number",
                    "type": "string",
                    "maxLength": 100,
                    "examples":["124345d"]
                },
                "imei": {
                    "title": "imei",
                    "description": "IMEI of a technical device",
                    "type": "string",
                    "maxLength": 50,
                    "examples":["2345-45452-43365-5643"]
                },
                "imei2": {
                    "title": "imei2",
                    "description": "second IMEI of dual sim technical device",
                    "type": "string",
                    "maxLength": 50,
                    "examples":["2345-45452-43365-5643"]
                },
                "serialNo": {
                    "title": "serial number",
                    "description": "serial number of the manufacturer",
                    "type": "string",
                    "maxLength": 100,
                    "examples":["D345-gkjpo-3112"]
                },
                "volume": {
                    "title": "volume",
                    "description": "volume of the whole quant - gross value - measured",
                    "type": "object",
                    "properties": {
                        "value": {
                            "type": "string",
                            "description": "Value",
                            "pattern":"^[0-9]{1,9}[.][0-9]{1,6}$",
                            "examples": [
                                    "0.000234",
                                    "987654321.0"
                            ]
                        },
                        "unit": {
                            "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/unitVolume.v1.schema.json"
                        }
                    }
                },
                "weight": {
                    "title": "weight",
                    "description": "weight of the whole quant - gross value - measured",
                    "type": "object",
                    "properties": {
                        "value": {
                            "type": "string",
                            "description": "Value",
                            "pattern":"^[0-9]{1,9}[.][0-9]{1,3}$",
                            "examples": [
                                    "0.565",
                                    "987654321.0"
                            ]
                        },
                        "unit": {
                            "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/unitWeight.v1.schema.json"
                        }
                    }
               },
               "product": {
                   "type": "object",
                   "properties": {
                       "logisticsProductId": {
                           "title": "¨Logistic Product Id",
                           "description": "master communication key",
                           "type": "string",
                           "maxLength": 36,
                           "examples":["123"]
                       },
                       "itemNumber": {
                           "title": "Item Number",
                           "description": "the item number-> Only provided by WMSx Sonnefeld  - deprecated",
                           "type": "string",
                           "maxLentht": 8,
                           "examples":["4"]
                       },
                       "itemSize": {
                           "title": "Item Size",
                           "description": "the item size (binary size, not alphanumeric) -> Only provided by WMSx Sonnefeld  - deprecated",
                           "type": "string",
                           "maxLength": 3,
                           "examples":["960"]
                       },
                       "company": {
                           "title": "Company",
                           "description": "actual owner company - used in FLASH",
                           "type": "string",
                           "maxLength": 50,
                           "examples": [
                               "OTTO"
                           ]
                       },
                       "logisticsPackingUnitId": {
                           "title": "¨Logistic PackingUnit Id",
                           "description": "master communication key from LSAS for products with multiple parts",
                           "type": "string",
                           "maxLength": 36,
                           "examples":["123"]
                       },
                       "packingUnitIndex": {
                           "title": "¨Logistic PackingUnit Number",
                           "description": "Part Number for products with multiple parts - deprecated",
                           "type": "integer",
                           "mininmum": 1,
                           "maximum": 99,
                           "examples":["123"]
                       }
                   },
                   "anyOf": [
                       {
                           "description": "used for wms without lsas connection (Sonnefeld) single colli items",
                           "required": [
                               "itemNumber",
                               "itemSize"
                           ]
                       },
                       {
                           "description": "used for wms with lsas connection - PL - single colli",
                           "required": [
                               "logisticsProductId"
                           ]
                       },
                       {
                           "description": "used for wms with lsas connection - bulky item",
                           "required": [
                               "logisticsProductId",
                               "logisticsPackingUnitId",
                               "packingUnitIndex"
                           ]
                       },
                       {
                           "description": "used for bulky items without lsas data",
                           "required": [
                               "itemNumber",
                               "itemSize",
                               "packingUnitIndex"
                           ]
                       }
                   ]
               },
                "supplier": {
                    "type": "object",
                    "properties": {
                        "logisticsSupplierId": {
                            "title": "technical logistics supplier id",
                            "description": "logistics supplier ID - LSAS based ID",
                            "type": "string",
                            "maxLength": 36,
                            "examples":["123"]
                        },
                        "supplierId": {
                            "title": "supplier number",
                            "description": "supplier number (LKZ) - deprecated",
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 999999,
                            "examples":["4"]
                        }
                    }                                   
                },
                "storageLocationId": {
                    "title": "storage location",
                    "description": "unique identification of a storage location. see interface https://docs.osp-fine.de/page/fine-common/30_stock/s08_storage_location/s08_storage_location/",
                    "type": "string",
                    "examples":["123"]
                },
                "storageHandlingUnitId": {
                    "title": "storage handling Unit",
                    "description": "unique identification of a charge carrier/bundle. see interface https://docs.osp-fine.de/page/fine-common/30_stock/s09_storage_handling_unit/s09_storage_handling_unit/",
                    "type": "string",
                    "examples":["123"]
                },
                "goodsIn": {
                    "type": "object",
                    "properties": {
                        "goodsInId": {
                            "title": "goods in id",
                            "description": "unique id of a goods receipt see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/",
                            "type": "string",
                            "maxLength": 36,
                            "examples":["123"]
                        },
                        "deliveryPositionId": {
                            "title": "delivery position id",
                            "description": "unique id of a delivery position see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/",
                            "type": "string",
                            "maxLength": 36,
                            "examples":["4"]
                        }
                    }                                          
                },
                "movementInfo": {
                    "type": "object",
                    "properties": {
                        "firstMovement": {
                            "title": "first movement date",
                            "description": "time of creation of the stock in the wms for determining the laytime of a stock unit, for retour or detour stocks use the advise date",
                            "type": "string",
                            "format": "date-time",
                            "examples":["2022-03-22T09:52:00.000+0100"]
                        },
                        "lastMovement": {
                            "title": "last movement date",
                            "description": "last movement of the stock unit to derive old stock and bum articles",
                            "type": "string",
                            "format": "date-time",
                            "examples":["2022-03-22T09:52:00.000+0100"]
                        },
                        "lastPickingDate": {
                            "title": "last picking date",
                            "description": "time at which the last pick/commission was made from this remaining quant",
                            "type": "string",
                            "format": "date-time",
                            "examples":["2022-03-22T09:52:00.000+0100"]
                        }                       
                    },
                    "required": [
                        "firstMovement"
                    ]
                }
            },
            "required": [
                "quantId",
                "location",
                "quantType",
                "totalQuantity",
                "stockInformation",
                "product"                
            ]              
        }
    },
    "required": [
      "eventId",
      "traceId",
      "eventTime",
      "version",
      "eventType",
      "metaData",
      "data"
    ],
    
    
    
    
    "examples":[
        {
            "eventId":"f48cfc26-0615-4351-9966-cdb4ec41bbcc",
            "traceId":"f48cfc26-0615-4351-9966-cdb4ec41bbcc",
            "eventTime":"2016-04-16T01:03:17Z",
            "version":"3.1",
            "eventType":"SNAPSHOT",
            "metaData":{
                "sender":"KMOTION_ILO",
                "client":"FBO",
                "messageNumber":1,
                "lastMessageNumber":10,
                "dailySnapshotNumber":1,
                "snapshotTime":"2016-04-16T01:03:17Z"
            },
            "data":{
                "erpSnapshotId":427,
                "quantId":"22000003806",
                "location":"ILOWA",
                "quantType":"PHYSICAL",
                "totalQuantity":13,
                "stockInformation":[
                    {
                        "stockType":"RESERVED_FOR_ORDERS",
                        "quantity":3
                    },
                    {
                        "stockType":"AVAILABLE",
                        "quantity":10
                    }
                ],    
                "isInventory":false,
                "stockTypeCode":"AV",
                "customsType":"UNKNOWN",
                "product":{
                    "logisticsProductId":"Artikel1",
                    "logisticsPackingUnitId":"Teil1",
                    "packingUnitIndex":1
                },
                "storageLocationId":"199992",
                "storageHandlingUnitId":"C123456"
            }
        },
        {
            "eventId":"f48cfc26-0615-4351-9966-cdb4ec41bbcc",
            "traceId":"f48cfc26-0615-4351-9966-cdb4ec41bbcc",
            "eventTime":"2023-10-11T10:18:24.000+02:00",
            "version":"3.1",
            "eventType":"SNAPSHOT",
            "metaData":{
                "sender":"KMOTION_ILO",
                "client":"FBO",
                "messageNumber":2,
                "lastMessageNumber":10,
                "dailySnapshotNumber":1,
                "snapshotTime":"2023-10-11T01:00:00Z"
            },
            "data":{
                "erpSnapshotId":427,
                "quantId":"4711_08_01_21000000001_01",
                "location":"ILOWA",
                "quantType":"VIRTUAL",
                "totalQuantity":1,
                "stockInformation":[
                    {
                        "stockType":"RETURN_OR_DETOUR",
                        "quantity":1
                    }
                ],
                "isInventory":false,
                "sourceType":"STOCK_TRANSFER",
                "stockTypeCode":"AV",
                "customsType":"UNKNOWN",
                "product":{
                    "itemNumber":"47119884",
                    "itemSize":"906",
                    "packingUnitIndex":1
                },
                "imei":"352377995718121",
                "imei2":"352377995718122",
                "buaid":"ed5807dd-c141-4b91-9f76-b6cbfa41cb73",
                "movementInfo":{"firstMovement":"2023-10-10T10:24:41.000+02:00"}
            }
        },      
        {
            "eventId":"f48cfc26-0615-4351-9966-cdb4ec41bbcc",
            "traceId":"f48cfc26-0615-4351-9966-cdb4ec41bbcc",
            "eventTime":"2023-10-12T10:18:24.000+02:00",
            "version":"3.1",
            "eventType":"SNAPSHOT",
            "metaData":{
                "sender":"KMOTION_ILO",
                "client":"FBO",
                "messageNumber":2,
                "lastMessageNumber":10,
                "dailySnapshotNumber":1,
                "snapshotTime":"2023-10-12T10:18:24.000+02:00"
            },
            "data":{
                "erpSnapshotId":427,
                "quantId":"4711_08_01_21000000003_01",
                "location":"ILOWA",
                "quantType":"VIRTUAL",
                "totalQuantity":1,
                "stockInformation":[
                    {
                        "stockType":"RETURN_OR_DETOUR",
                        "quantity":1
                    }
                ],
                "isInventory":false,
                "sourceType":"NON_STORABLE_RETURNS",
                "stockTypeCode":"AV",
                "customsType":"UNKNOWN",
                "product":{
                    "itemNumber":"47119884",
                    "itemSize":"906",
                    "packingUnitIndex":1
                },
                "imei":"352377995718121",
                "buaid":"fg5807dd-c141-4b91-9f76-b6cbfa41cb73",
                "movementInfo":{"firstMovement":"2023-10-08T10:24:41.000+02:00"}
            }
        },      
        {
            "eventId":"f48cf326-0615-4351-9966-cdb4ec41bbcc",
            "traceId":"f48cf326-0615-4351-9966-cdb4ec41bbcc",
            "eventTime":"2023-10-11T10:18:24.000+02:00",
            "version":"3.1",
            "eventType":"SNAPSHOT",
            "metaData":{
                "sender":"KMOTION_ILO",
                "client":"FBO",
                "messageNumber":3,
                "lastMessageNumber":10,
                "dailySnapshotNumber":1,
                "snapshotTime":"2023-10-11T10:18:24.000+02:00"
            },
            "data":{
                "erpSnapshotId":427,
                "quantId":"V471108",
                "location":"ILOWA",
                "quantType":"VIRTUAL",
                "totalQuantity":5,
                "stockInformation":[
                    {
                        "stockType":"HIGH_LEVEL_RESERVED_FOR_ORDER",
                        "quantity":5
                    }
                ],    
                "isInventory":false,
                "stockTypeCode":"AV",
                "customsType":"UNKNOWN",
                "product":{
                    "itemNumber":"47119884",
                    "itemSize":"906",
                    "logisticProductId":"121214444",
                    "packingUnitIndex":1
                }
            }
        },      
        {
            "eventId":"f48cfc26-0615-4351-9966-cdb4ec41bacc",
            "traceId":"f48cfc26-0615-4351-9966-cdb4ec41bacc",
            "eventTime":"2022-03-22T09:52:00.000+0100",
            "version":"3.1",
            "eventType":"SNAPSHOT",
            "metaData":{
                "sender":"COBRA",
                "client":"FBO",
                "messageNumber":1,
                "lastMessageNumber":20,
                "dailySnapshotNumber":1,
                "snapshotTime":"2022-03-22T04:00:00.000+0100"
            },
            "data":{
                "quantId":"918450081",
                "location":"ERFURT",
                "quantType":"PHYSICAL",
                "totalQuantity":1,
                "stockInformation":[
                    {
                        "stockType":"GOODS_IN",
                        "quantity":1
                    }
                ],    
                "product":{
                    "itemNumber":"4209344",
                    "itemSize":"0",
                    "packingUnitIndex":3
                },
                "storageLocationId":"5858211128602",
                "storageHandlingUnitId":"C769675929",
                "locks":[
                    {
                        "typeCode": "AN",
                        "time": "2022-12-13T07:52:05Z"
                    },
                    {
                        "typeCode": "LO",
                        "time": "2022-12-13T07:52:05Z"
                    }
                ],
                "imei":"352377995718121",
                "imei2":"352377995718122",
                "buaid":"ed5807dd-c141-4b91-9f76-b6cbfa41cb73"
            }
        }

    ]
}

4.2. Direction FINE to ERP

4.2.1. Header

This interface uses the Service Header

Special expresion for this interface:

Table 10. Attribute
Fieldname Expresion

4.2.2. Data model

Property Type Description

(Root)

object

    eventId*

string (uuid)

The unique eventId
Global unique Id

Minimum Length: 36
Maximum Length: 36

    traceId*

string (uuid)

The unique traceId
Global unique Id for tracing the flow of events

Minimum Length: 36
Maximum Length: 36

    spanId

string (uuid)

The eventId of previous record or batchId
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), recommended as uuid, Special usecases can be specify for some interfaces

Minimum Length: 36
Maximum Length: 36

    eventTime*

string (date-time)

Time of occurrence of the event
Time at which the record was generated (single event - not the businessEvent/snapshot) in UTC +ISO-8601 format YYYY-MM-DD'T'HH24:MM:SS'Z'

    version*

The number of version schema
Number of version of this data structure. Only required if no $schema is specified!

    context

string (enum)

The context / business case
The context specified here means the business domain.

Any of: [ "WAREHOUSE_STOCK" ]
Maximum Length: 50

    eventType*

string (enum)

Snapshot event
the snapshot type to which the data belongs, currently only snapshots are supported

Any of: [ "SNAPSHOT" ]
Maximum Length: 20

    metaData*

object

additional meta information
optional, can be used with different characteristics for technical data per interface

        sender*

string (enum)

sender
Name of the source system, that has sent this message.

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

client
Client/mandant (messages of different clients have different processing rules and destination interfaces) - use FBO for Fulfillment by Otto (CORE, DeepSea…​)

Maximum Length: 50

        messageNumber

integer

current message number
the current message number that is transmitted

Minimum: 1
Maximum: 1000000000000000000

        lastMessageNumber

integer

last message number
how many messages are to be transferred

Minimum: 1
Maximum: 1000000000000000000

        dailySnapshotNumber*

integer

daily snapshot number
sequence number of the snapshot per day, starts every day again with number 1

Minimum: 1
Maximum: 100

        snapshotTime

string (date-time)

snapshot time
time of the snapshot creation

    data*

object

        snapshotId

integer

the id of the inventory snapshot
Consecutive number (sequence) of a long number. each inventory snapshot gets its own ID from WMS, which is identical for all records of the snapshot. all bookings get the id of the following snapshot, generated by wms, each wms has his own scope

Maximum Length: 18
Minimum: 1
Maximum: 1000000000000000000

        quantId*

string

Quant Id
ID of the finest stock separating unit, generated id for virtual quants/units

Maximum Length: 100

        quantType*

string (enum)

quant type
type of quant, virtual for stocks without relation to a real physical quant ,e.g. high level reserved quantities, advised detours

Any of: [ "PHYSICAL", "VIRTUAL" ]
Maximum Length: 10

        location*

string (enum)

location
the location where the event was created

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" ]

        sourcelocation

string (enum)

source location
the source location of the stock e.g. the sending location for returns or detours

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" ]

        totalQuantity*

integer

total quantity
the total quantity for this quant including reserved qty in kMotion

Minimum: 1
Maximum: 9999999999

        stockInformation*

array

stockInformation
the stock related informations for the single quantities of this quant

            (Array item)

object

                quantity*

integer

quantity
quantity containing to this stock type

Minimum: 1
Maximum: 9999999999

                stockType*

string (enum)

Stock Type
stock type, that indicates whether an individual part is in goods in stock (before releasing), available, reserved for orders, advised as return or detour…​

Any of: [ "GOODS_IN", "AVAILABLE", "QUALITY_LOCKED", "LOCKED", "RESERVED_FOR_ORDERS", "HIGH_LEVEL_RESERVED_FOR_ORDER", "RETURN_OR_DETOUR", "RESERVABLE_LOCKED", "RESERVABLE_RETURN_OR_DETOUR", "REPLENISHMENT" ]
Maximum Length: 50

        stockTypeCode

string

WMS Stock Type
stock type used in wms frontend (if available)

Maximum Length: 50

        sourceType

string (enum)

source Type
additional source type information for distinction of stock source (detour, returns, goodsin from supplier etc.) and assignment of erp stocktypes

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", "STORABLE_RETURNS", "NON_STORABLE_RETURNS", "GOODSIN_SUPPLIER" ]
Maximum Length: 50

        isInventory*

boolean

is Inventory
set it true if the quant was intended for inventory checking, otherwise to false

        isIgnoredForComparison

boolean

is ignored for comparison
set it true, if this quant should be ignored for comparison during group inventory, normally used for returns that are advised with isInventory flag from RESY, because they are not booked

        customsType

string (enum)

Type of customs
indicates whether the quant have been cleared or not

Any of: [ "CUSTOMS_CLEARED", "CUSTOMS_NOT_CLEARED", "UNKNOWN" ]
Maximum Length: 50

        customsTypeCode

string

WMS Customs Type
customs type code used in wms frontend

Maximum Length: 50

        qualityControlTypeCode

string

WMS Quality Control Type
quality control type used in wms (account)

Maximum Length: 50

        locks

array

locks
locks used in wms, a quant can have multiple locks, use also wms code for unlocked,

            (Array item)

object

                typeCode

string

lock type
lock used in front end of WMS

Maximum Length: 50

                time

string (date-time)

Lock Date
time the lock was set

        buaid

string

buaid
bi unique article ID, unique identification of an individual unit in the logistical process

Maximum Length: 50

        BUID

string

BUID
obsolete. for backwards compatibility with V3.0. Use attribute buiad instead. BI UUID, unique identification of an individual unit in the logistical process

        bestBeforeDate

string (date)

best Before Date
best before date

        batch

string

batch
batch number

Maximum Length: 100

        imei

string

imei
IMEI of a technical device

Maximum Length: 50

        imei2

string

imei2
second IMEI of dual sim technical device

Maximum Length: 50

        serialNo

string

serial number
serial number of the manufacturer

Maximum Length: 100

        volume

object

volume
volume of the whole quant - gross value - measured

            value

string

Value

Regular expression: ^[0-9]{1,9}[.][0-9]{1,6}$

            unit

string (enum)

unit volume

Any of: [ "CUBIC_METER", "LITER" ]

        weight

object

weight
weight of the whole quant - gross value - measured

            value

string

Value

Regular expression: ^[0-9]{1,9}[.][0-9]{1,3}$

            unit

string (enum)

unit weight

Any of: [ "GRAM", "KILOGRAM" ]

        product*

object

            erpProductId

string

¨ERP Product Id
master communication key between Erp and LSAS

Maximum Length: 36

            itemNumber

string

Item Number
the item number-> Only provided by WMSx Sonnefeld - deprecated

            itemSize

string

Item Size
the item size (binary size, not alphanumeric) -> Only provided by WMSx Sonnefeld - deprecated

Maximum Length: 3

            company

string

Company
actual owner company - used in FLASH

Maximum Length: 50

            erpPackingUnitId

string

¨ERP PackingUnit Id
master communication key between LSAS and ERP for packing units of products with multiple parts

Maximum Length: 36

            packingUnitIndex

integer

¨PackingUnit Number
Part Number for products with multiple parts - deprecated

Maximum: 99

        supplier

object

            erpSupplierId

string

technical erp supplier id
erp supplier ID - ERP based ID

Maximum Length: 36

            supplierId

integer

supplier number
supplier number (LKZ) - deprecated

Minimum: 0
Maximum: 999999

        storageLocationId

string

storage location
unique identification of a storage location. see interface https://docs.osp-fine.de/page/fine-common/30_stock/s08_storage_location/s08_storage_location/

        storageHandlingUnitId

string

storage handling Unit
unique identification of a charge carrier/bundle. see interface https://docs.osp-fine.de/page/fine-common/30_stock/s09_storage_handling_unit/s09_storage_handling_unit/

        goodsIn

object

            goodsInId

string

goods in id
unique id of a goods receipt see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/

Maximum Length: 36

            deliveryPositionId

string

delivery position id
unique id of a delivery position see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/

Maximum Length: 36

        movementInfo

object

            firstMovement*

string (date-time)

first movement date
time of creation of the stock in the wms for determining the laytime of a stock unit, for retour or detour stocks use the advise date

            lastMovement

string (date-time)

last movement date
last movement of the stock unit to derive old stock and bum articles

            lastPickingDate

string (date-time)

last picking date
time at which the last pick/commission was made from this remaining quant

4.2.3. Enumeration

Field: Type

Table 11. type
Meta Value Description Short Value

4.2.4. Example

Message FINE to ERP

4.2.5. Version history

Table 12. Version FINE to ERP

Version

Number

File

Published on

previous version

3.1

Download

18.03.24

current version

3.2

Download

09.01.25

coming version

4.2.6. Changelog

Changes V3.0

  1. Standard header

    • attribute "sender" is now linked to system.v7.schema.json

    • attribute "client" is now linked to company.v5.schema.json

    • enum values for "eventType" were updated

    • fields of header were changed to "dailySnapshotNumber" and "snapshotTime"

    • renamed "erpSnapshotId" to "snapshotId"

  2. Payload (Data)

    • Trennung "totalQuantity" und "stockInformation" mit versch. Mengen für reserviert/Menge zur Abbildung Bestandsarten über "stockType" und virtuelle Quanten mittels "quantType" für High Level Reservierungen

    • added new field "lastPickingDate"

    • changed references and attribute names for "supplier" and "goodsIn"

Changes V3.0 → V3.1

  1. Standard header

  2. Payload (Data)

    • added new field "isInventory" - set true if quant is registered for inventory checks

    • added new field "buaid" - prepare renaming BUID to buaid, don’t use BUID anymore (marked as obsolete) for V3.0 data

    • added new field "sourceType" - for distinction of stock source (detour, returns, goods in …​)

    • extend "quantId" to 100 signs

    • added new field "imei2" for dual sim devices

Changes V3.1 → V3.2

  1. Standard header

    • attribute "client" - reference to global company enums removed. Use string.

    • attribute "company" - reference to global company enums removed. Use string.

  2. Payload (Data)

    • attribute "isIgnoredForComparison" - new boolean value for group inventory

    • attribute "volume" - "value" - introduce pattern to validate string matches oracles decimal(15,6)

    • attruibute "weight" - "value" - introduce pattern to validate string matches oracles decimal(12,3)

Notes for new major version:

  • remove BUID

  • rename sourcelocation to sourceLocation

4.2.7. Schema

Interface FINE to ERP
{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$comment": "Schema for stock in a warehouse direction ERP Version 3.2",
    "$id": "https://doc.fine.gcp.osp-dev.de/registry/Stock/WarehouseStockErp.v3.2.schema.json",
    "type": "object",
    "definitions": {
        "stockType": {
            "title": "Type of the stock",
            "description": "stockType, that indicates whether an individual part is in goods in stock (before releasing), available, reserved for orders, advised as return or detour...",
            "type": "string",
            "maxLength": 50,
            "enum": ["GOODS_IN",
                     "AVAILABLE",
                     "QUALITY_LOCKED",
                     "LOCKED",
                     "RESERVED_FOR_ORDERS",
                     "HIGH_LEVEL_RESERVED_FOR_ORDER",
                     "RETURN_OR_DETOUR",
                     "RESERVABLE_LOCKED",
                     "RESERVABLE_RETURN_OR_DETOUR",
                     "REPLENISHMENT"]
        },
        "sourceType": {
            "title": "additional source type",
            "description": "additional source type information for distinction of stock source (different transfer types, returns, goodsin from supplier etc.), used for erp stocktype mappings, has to be filled at least for all messages with stockType RETURN_OR_DETOUR and for NON_STORABLE_RETURNS",
            "type": "string",
            "maxLength": 50,
            "enum": ["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",
                     "STORABLE_RETURNS",
                     "NON_STORABLE_RETURNS",
                     "GOODSIN_SUPPLIER"
                     ]
        }
    },
    "properties": {
        "eventId": {
            "title": "The unique eventId",
            "description": "Global unique Id",
            "type": "string",
            "format": "uuid",
            "minLength": 36,
            "maxLength": 36,
            "examples": [
                "00ce536f-923a-42f4-8128-be118faf1d87"
            ]
        },
        "traceId": {
            "title": "The unique traceId",
            "description": "Global unique Id for tracing the flow of events",
            "type": "string",
            "format": "uuid",
            "minLength": 36,
            "maxLength": 36,
            "examples": [
                "00ce536f-923a-42f4-8138-33418faf1342"
            ]
        },
        "spanId": {
            "title": "The eventId of previous record or batchId",
            "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), recommended as uuid, Special usecases can be specify for some interfaces",
            "type": "string",
            "format": "uuid",
            "minLength": 36,
            "maxLength": 36,
            "examples": [
                "00ce536f-923a-42f4-5463-32a41877b3c2"
            ]
        },    
        "eventTime": {
            "title": "Time of occurrence of the event",
            "description": "Time at which the record was generated (single event - not the businessEvent/snapshot) in UTC +ISO-8601 format YYYY-MM-DD'T'HH24:MM:SS'Z'",
            "type": "string",
            "format": "date-time",
            "examples": [
                "2022-04-16T16:06:05.123456Z",
                "2022-04-19T08:51:05+02:00"
            ]
        },
        "version": {
            "title": "The number of version schema",
            "description": "Number of version of this data structure. Only required if no $schema is specified!",
            "oneOf": [
                {
                    "type": "string",
                    "pattern": "\\d+\\.\\d{1,2}",
                    "examples": ["1.01", "01.02"]
                },
                {
                    "type": "integer",
                    "examples": [1, 2]
                }
            ]
        },
        "context": {
            "title": "The context / business case",
            "description": "The context specified here means the business domain.",
            "type": "string",
            "maxLength":50,
            "enum": [
                "WAREHOUSE_STOCK"
            ]
        },
        "eventType": {
            "title": "Snapshot event",
            "description": "the snapshot type to which the data belongs, currently only snapshots are supported",
            "type": "string",
            "maxLength": 20,
            "enum": ["SNAPSHOT"],
            "examples":["SNAPSHOT"]
        },
        "metaData": {
            "title": "additional meta information",
            "description": "optional, can be used with different characteristics for technical data per interface",
            "type": "object",
            "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.v7.schema.json"
                },
                "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...)",
                    "type": "string",
                    "maxLength": 50,
                    "examples": [
                        "FBO"
                    ]
                },
                "messageNumber": {
                    "title": "current message number",
                    "description": "the current message number that is transmitted",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 999999999999999999
                },
                "lastMessageNumber": {
                    "title": "last message number",
                    "description": "how many messages are to be transferred",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 999999999999999999
                },
                "dailySnapshotNumber": {
                    "title": "daily snapshot number",
                    "description": "sequence number of the snapshot per day, starts every day again with number 1",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100
                },
                "snapshotTime": {
                    "title": "snapshot time",
                    "description": "time of the snapshot creation",
                    "type": "string",
                    "format": "date-time",
                    "examples": [
                        "2022-04-16T16:06:05.123456Z",
                        "2022-04-19T08:51:05+02:00"
                    ]
                }
            }, 
            "required": [
                "sender",
                "client",
                "dailySnapshotNumber"
            ]   
        },
        "data": {
            "type": "object",
            "properties": {
                "snapshotId": {
                    "title": "the id of the inventory snapshot",
                    "description": "Consecutive number (sequence) of a long number. each inventory snapshot gets its own ID from WMS, which is identical for all records of the snapshot. all bookings get the id of the following snapshot, generated by wms, each wms has his own scope",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 999999999999999999,
                    "maxLength": 18,
                    "examples": [
                        122
                    ]
                },
                "quantId": {
                    "title": "Quant Id",
                    "description": "ID of the finest stock separating unit, generated id for virtual quants/units",
                    "type": "string",
                    "maxLength": 100,
                    "examples":["1189582"]
                },
                "quantType": {
                    "title": "quant type",
                    "description": "type of quant, virtual for stocks without relation to a real physical quant ,e.g. high level reserved quantities, advised detours",
                    "type": "string",
                    "maxLength": 10,
                    "enum":["PHYSICAL","VIRTUAL"]
                },           
                "location": {
                    "title": "location",
                    "description": "the location where the event was created",
                    "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/warehouselocations.v1.schema.json"
                },
                "sourcelocation": {
                    "title": "source location",
                    "description": "the source location of the stock e.g. the sending location for returns or detours",
                    "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/warehouselocations.v1.schema.json"
                },
                "totalQuantity": {
                    "title": "total quantity",
                    "description": "the total quantity for this quant including reserved qty in kMotion",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9999999999,
                    "examples":["20"]
                },
                "stockInformation": {
                    "title": "stockInformation",
                    "description": "the stock related informations for the single quantities of this quant",
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "quantity": {
                                "title": "quantity",
                                "description": "quantity containing to this stock type",
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 9999999999,
                                "examples":[90]
                            },
                            "stockType": {
                                "title": "Stock Type",
                                "description": "stock type, that indicates whether an individual part is in goods in stock (before releasing), available, reserved for orders, advised as return or detour...",
                                "$ref": "#/definitions/stockType"
                            }
                        },
                        "required": [
                            "quantity",
                            "stockType"
                        ]
                    }
                },
                "stockTypeCode": {
                    "title": "WMS Stock Type",
                    "description": "stock type used in wms frontend (if available)",
                    "type": "string",
                    "maxLength": 50,
                    "examples":["4251"]
                },          
                "sourceType": {
                    "title": "source Type",
                    "description": "additional source type information for distinction of stock source (detour, returns, goodsin from supplier etc.) and assignment of erp stocktypes",
                    "$ref": "#/definitions/sourceType"
                },
                "isInventory": {
                    "title": "is Inventory",
                    "description": "set it true if the quant was intended for inventory checking, otherwise to false",
                    "type": "boolean",
                    "default": false,
                    "examples": [true,false]
                },
                "isIgnoredForComparison": {
                    "title": "is ignored for comparison",
                    "description": "set it true, if this quant should be ignored for comparison during group inventory, normally used for returns that are advised with isInventory flag from RESY, because they are not booked",
                    "type": "boolean",
                    "default": false,
                    "examples": [true,false]
                },
                "customsType": {
                    "title": "Type of customs",
                    "description": "indicates whether the quant have been cleared or not",
                    "type": "string",
                    "maxLength": 50,
                    "enum": ["CUSTOMS_CLEARED", "CUSTOMS_NOT_CLEARED", "UNKNOWN"],
                    "example": ["CUSTOMS_CLEARED"]
                },
                "customsTypeCode": {
                    "title": "WMS Customs Type",
                    "description": "customs type code used in wms frontend",
                    "type": "string",
                    "maxLength": 50,
                    "example": ["5614D"]
                }, 
                "qualityControlTypeCode": {
                    "title": "WMS Quality Control Type",
                    "description": "quality control type used in wms (account)",
                    "type": "string",
                    "maxLength": 50,
                    "examples":["1234ABCD"]
                },               
                "locks": {
                    "title": "locks",
                    "description": "locks used in wms, a quant can have multiple locks, use also wms code for unlocked, ",
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {            
                            "typeCode": {
                                "title": "lock type",
                                "description": "lock used in front end of WMS",
                                "type": "string",
                                "maxLength": 50,
                                "examples":["1120ABD"]
                            },
                            "time": {
                                "title": "Lock Date",
                                "description": "time the lock was set",
                                "type": "string",
                                "format": "date-time",
                                "examples":["2022-03-22T09:52:00.000+0100"]
                            }
                        }
                    }
                }, 
                "buaid": {
                    "title": "buaid",
                    "description": "bi unique article ID, unique identification of an individual unit in the logistical process",
                    "type": "string",
                    "maxLength": 50,
                    "examples":["2344545-334542-465g45ddf"]
                },
                "BUID": {
                    "title": "BUID",
                    "description": "obsolete. for backwards compatibility with V3.0. Use attribute buiad instead. BI UUID, unique identification of an individual unit in the logistical process",
                    "type": "string",
                    "examples":["2344545-334542-465g45ddf"]
                },
                "bestBeforeDate": {
                    "title": "best Before Date",
                    "description": "best before date",
                    "type": "string",
                    "format":"date",
                    "examples":["2022-12-31"]
                },
                "batch": {
                    "title": "batch",
                    "description": "batch number",
                    "type": "string",
                    "maxLength": 100,
                    "examples":["124345d"]
                },
                "imei": {
                    "title": "imei",
                    "description": "IMEI of a technical device",
                    "type": "string",
                    "maxLength": 50,
                    "examples":["2345-45452-43365-5643"]
                },
                "imei2": {
                    "title": "imei2",
                    "description": "second IMEI of dual sim technical device",
                    "type": "string",
                    "maxLength": 50,
                    "examples":["2345-45452-43365-5643"]
                },
                "serialNo": {
                    "title": "serial number",
                    "description": "serial number of the manufacturer",
                    "type": "string",
                    "maxLength": 100,
                    "examples":["D345-gkjpo-3112"]
                },
                "volume": {
                    "title": "volume",
                    "description": "volume of the whole quant - gross value - measured",
                    "type": "object",
                    "properties": {
                        "value": {
                            "type": "string",
                            "description": "Value",
                            "pattern":"^[0-9]{1,9}[.][0-9]{1,6}$",
                            "examples": [
                                    "0.000234",
                                    "987654321.0"
                            ]
                        },
                        "unit": {
                            "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/unitVolume.v1.schema.json"
                        }
                    }
                },
                "weight": {
                    "title": "weight",
                    "description": "weight of the whole quant - gross value - measured",
                    "type": "object",
                    "properties": {
                        "value": {
                            "type": "string",
                            "description": "Value",
                            "pattern":"^[0-9]{1,9}[.][0-9]{1,3}$",
                            "examples": [
                                    "0.565",
                                    "987654321.0"
                            ]
                        },
                        "unit": {
                            "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/unitWeight.v1.schema.json"
                        }
                    }
               },
               "product": {
                    "type": "object",
                    "properties": {
                        "erpProductId": {
                            "title": "¨ERP Product Id",
                            "description": "master communication key between Erp and LSAS",
                            "type": "string",
                            "maxLength": 36,
                            "examples":["123"]
                        },
                        "itemNumber": {
                            "title": "Item Number",
                            "description": "the item number-> Only provided by WMSx Sonnefeld  - deprecated",
                            "type": "string",
                            "maxLentht": 8,
                            "examples":["4"]
                        },
                        "itemSize": {
                            "title": "Item Size",
                            "description": "the item size (binary size, not alphanumeric) -> Only provided by WMSx Sonnefeld  - deprecated",
                            "type": "string",
                            "maxLength": 3,
                            "examples":["960"]
                        },
                        "company": {
                            "title": "Company",
                            "description": "actual owner company - used in FLASH",
                            "type": "string",
                            "maxLength": 50,
                            "examples": [
                                "OTTO"
                            ]
                        },
                        "erpPackingUnitId": {
                            "title": "¨ERP PackingUnit Id",
                            "description": "master communication key between LSAS and ERP for packing units of products with multiple parts",
                            "type": "string",
                            "maxLength": 36,
                            "examples":["123"]
                        },
                        "packingUnitIndex": {
                            "title": "¨PackingUnit Number",
                            "description": "Part Number for products with multiple parts - deprecated",
                            "type": "integer",
                            "mininmum": 1,
                            "maximum": 99,
                            "examples":["123"]
                        }
                    },
                    "anyOf": [
                        {
                            "description": "used for wms without lsas connection (Sonnefeld) single colli items",
                            "required": [
                                "itemNumber",
                                "itemSize"
                            ]
                        },
                        {
                            "description": "used for erp with lsas connection - PL - single colli",
                            "required": [
                                "erpProductId"
                            ]
                        },
                        {
                            "description": "used for erp with lsas connection - bulky item",
                            "required": [
                                "erpProductId",
                                "erpPackingUnitId",
                                "packingUnitIndex"
                            ]
                        },
                        {
                            "description": "used for bulky items without lsas data",
                            "required": [
                                "itemNumber",
                                "itemSize",
                                "packingUnitIndex"
                            ]
                        }
                    ]
                },
                "supplier": {
                    "type": "object",
                    "properties": {
                        "erpSupplierId": {
                            "title": "technical erp supplier id",
                            "description": "erp supplier ID - ERP based ID",
                            "type": "string",
                            "maxLength": 36,
                            "examples":["123"]
                        },
                        "supplierId": {
                            "title": "supplier number",
                            "description": "supplier number (LKZ) - deprecated",
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 999999,
                            "examples":["4"]
                        }
                    }                                   
                },
                "storageLocationId": {
                    "title": "storage location",
                    "description": "unique identification of a storage location. see interface https://docs.osp-fine.de/page/fine-common/30_stock/s08_storage_location/s08_storage_location/",
                    "type": "string",
                    "examples":["123"]
                },
                "storageHandlingUnitId": {
                    "title": "storage handling Unit",
                    "description": "unique identification of a charge carrier/bundle. see interface https://docs.osp-fine.de/page/fine-common/30_stock/s09_storage_handling_unit/s09_storage_handling_unit/",
                    "type": "string",
                    "examples":["123"]
                },
                "goodsIn": {
                    "type": "object",
                    "properties": {
                        "goodsInId": {
                            "title": "goods in id",
                            "description": "unique id of a goods receipt see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/",
                            "type": "string",
                            "maxLength": 36,
                            "examples":["123"]
                        },
                        "deliveryPositionId": {
                            "title": "delivery position id",
                            "description": "unique id of a delivery position see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/",
                            "type": "string",
                            "maxLength": 36,
                            "examples":["4"]
                        }
                    }                                          
                },
                "movementInfo": {
                    "type": "object",
                    "properties": {
                        "firstMovement": {
                            "title": "first movement date",
                            "description": "time of creation of the stock in the wms for determining the laytime of a stock unit, for retour or detour stocks use the advise date",
                            "type": "string",
                            "format": "date-time",
                            "examples":["2022-03-22T09:52:00.000+0100"]
                        },
                        "lastMovement": {
                            "title": "last movement date",
                            "description": "last movement of the stock unit to derive old stock and bum articles",
                            "type": "string",
                            "format": "date-time",
                            "examples":["2022-03-22T09:52:00.000+0100"]
                        },
                        "lastPickingDate": {
                            "title": "last picking date",
                            "description": "time at which the last pick/commission was made from this remaining quant",
                            "type": "string",
                            "format": "date-time",
                            "examples":["2022-03-22T09:52:00.000+0100"]
                        }                       
                    },
                    "required": [
                        "firstMovement"
                    ]
                }
            },
            "required": [
                "quantId",
                "location",
                "quantType",
                "totalQuantity",
                "stockInformation",
                "isInventory",
                "product"                
            ]              
        }
    },
    "required": [
      "eventId",
      "traceId",
      "eventTime",
      "version",
      "eventType",
      "metaData",
      "data"
    ],
    
    
    
    
    "examples":[
        {
            "eventId":"f48cfc26-0615-4351-9966-cdb4ec41bbcc",
            "traceId":"f48cfc26-0615-4351-9966-cdb4ec41bbcc",
            "eventTime":"2016-04-16T01:03:17Z",
            "version":"3.1",
            "eventType":"SNAPSHOT",
            "metaData":{
                "sender":"KMOTION_ILO",
                "client":"FBO",
                "messageNumber":1,
                "lastMessageNumber":10,
                "dailySnapshotNumber":1,
                "snapshotTime":"2016-04-16T01:00:00Z"
            },
            "data":{
                "erpSnapshotId":427,
                "quantId":"22000003806",
                "location":"ILOWA",
                "quantType":"PHYSICAL",
                "totalQuantity":13,
                "stockInformation":[
                    {
                        "stockType":"RESERVED_FOR_ORDERS",
                        "quantity":3
                    },
                    {
                        "stockType":"AVAILABLE",
                        "quantity":10
                    }
                ],    
                "isInventory":false,
                "stockTypeCode":"AV",
                "customsType":"UNKNOWN",
                "product":{
                    "erpProductId":"Artikel1",
                    "erpPackingUnitId":"Teil1",
                    "packingUnitIndex":1
                },
                "storageLocationId":"199992",
                "storageHandlingUnitId":"C123456"
            }
        },
        {
            "eventId":"f48cfc26-0615-4351-9966-cdb4ec41bbcc",
            "traceId":"f48cfc26-0615-4351-9966-cdb4ec41bbcc",
            "eventTime":"2023-10-11T10:18:24.000+02:00",
            "version":"3.1",
            "eventType":"SNAPSHOT",
            "metaData":{
                "sender":"KMOTION_ILO",
                "client":"FBO",
                "messageNumber":2,
                "lastMessageNumber":10,
                "dailySnapshotNumber":1,
                "snapshotTime":"2023-10-11T01:00:00Z"
            },
            "data":{
                "erpSnapshotId":427,
                "quantId":"4711_08_01_21000000001_01",
                "location":"ILOWA",
                "quantType":"VIRTUAL",
                "totalQuantity":1,
                "stockInformation":[
                    {
                        "stockType":"RETURN_OR_DETOUR",
                        "quantity":1
                    }
                ],
                "isInventory":false,
                "sourceType":"STOCK_TRANSFER",
                "stockTypeCode":"AV",
                "customsType":"UNKNOWN",
                "product":{
                    "itemNumber":"47119884",
                    "itemSize":"906",
                    "packingUnitIndex":1
                },
                "imei":"352377995718121",
                "imei2":"352377995718122",
                "buaid":"ed5807dd-c141-4b91-9f76-b6cbfa41cb73",
                "movementInfo":{"firstMovement":"2023-10-10T10:24:41.000+02:00"}
            }
        },      
        {
            "eventId":"f48cfc26-0615-4351-9966-cdb4ec41bbcc",
            "traceId":"f48cfc26-0615-4351-9966-cdb4ec41bbcc",
            "eventTime":"2023-10-12T10:18:24.000+02:00",
            "version":"3.1",
            "eventType":"SNAPSHOT",
            "metaData":{
                "sender":"KMOTION_ILO",
                "client":"FBO",
                "messageNumber":2,
                "lastMessageNumber":10,
                "dailySnapshotNumber":1,
                "snapshotTime":"2023-10-12T10:18:24.000+02:00"
            },
            "data":{
                "erpSnapshotId":427,
                "quantId":"4711_08_01_21000000003_01",
                "location":"ILOWA",
                "quantType":"VIRTUAL",
                "totalQuantity":1,
                "stockInformation":[
                    {
                        "stockType":"RETURN_OR_DETOUR",
                        "quantity":1
                    }
                ],
                "isInventory":false,
                "sourceType":"NON_STORABLE_RETURNS",
                "stockTypeCode":"AV",
                "customsType":"UNKNOWN",
                "product":{
                    "itemNumber":"47119884",
                    "itemSize":"906",
                    "packingUnitIndex":1
                },
                "imei":"352377995718121",
                "buaid":"fg5807dd-c141-4b91-9f76-b6cbfa41cb73",
                "movementInfo":{"firstMovement":"2023-10-08T10:24:41.000+02:00"}
            }
        },      
        {
            "eventId":"f48cf326-0615-4351-9966-cdb4ec41bbcc",
            "traceId":"f48cf326-0615-4351-9966-cdb4ec41bbcc",
            "eventTime":"2023-10-11T10:18:24.000+02:00",
            "version":"3.1",
            "eventType":"SNAPSHOT",
            "metaData":{
                "sender":"KMOTION_ILO",
                "client":"FBO",
                "messageNumber":3,
                "lastMessageNumber":10,
                "dailySnapshotNumber":1,
                "snapshotTime":"2023-10-11T10:18:24.000+02:00"
            },
            "data":{
                "erpSnapshotId":427,
                "quantId":"V471108",
                "location":"ILOWA",
                "quantType":"VIRTUAL",
                "totalQuantity":5,
                "stockInformation":[
                    {
                        "stockType":"HIGH_LEVEL_RESERVED_FOR_ORDER",
                        "quantity":5
                    }
                ],    
                "isInventory":false,
                "stockTypeCode":"AV",
                "customsType":"UNKNOWN",
                "product":{
                    "itemNumber":"47119884",
                    "itemSize":"906",
                    "erpProductId":"121214444",
                    "packingUnitIndex":1
                }
            }
        },      
        {
            "eventId":"f48cfc26-0615-4351-9966-cdb4ec41bacc",
            "traceId":"f48cfc26-0615-4351-9966-cdb4ec41bacc",
            "eventTime":"2022-03-22T09:52:00.000+0100",
            "version":"3.1",
            "eventType":"SNAPSHOT",
            "metaData":{
                "sender":"COBRA",
                "client":"FBO",
                "messageNumber":1,
                "lastMessageNumber":20,
                "dailySnapshotNumber":1,
                "snapshotTime":"2022-03-22T04:00:00.000+0100"
            },
            "data":{
                "quantId":"918450081",
                "location":"ERFURT",
                "quantType":"PHYSICAL",
                "totalQuantity":1,
                "stockInformation":[
                    {
                        "stockType":"GOODS_IN",
                        "quantity":1
                    }
                ],    
                "isInventory":false,
                "product":{
                    "itemNumber":"4209344",
                    "itemSize":"0",
                    "packingUnitIndex":3
                },
                "storageLocationId":"5858211128602",
                "storageHandlingUnitId":"C769675929",
                "locks":[
                    {
                        "typeCode": "AN",
                        "time": "2022-12-13T07:52:05Z"
                    },
                    {
                        "typeCode": "LO",
                        "time": "2022-12-13T07:52:05Z"
                    }
                ],
                "imei":"352377995718121",
                "imei2":"352377995718122",
                "buaid":"ed5807dd-c141-4b91-9f76-b6cbfa41cb73"
            }
        }

    ]
}

4.3. Direction FINE to BRAIN

4.3.1. Header

This interface uses the Service Header

Special expression for this interface:

Table 13. Attribute
Fieldname Expression

4.3.2. Data model

4.3.3. Enumeration

Field: Type

Table 14. type
Meta Value Description Short Value

4.3.4. Example

Message FINE to BRAIN

4.3.5. Schema

Table 15. Version FINE to BRAIN
Version Number File Published on Changes

current version

2.0

Download

20.09.22

- service header attribute spanId as optional field inserted - rename service header attribute type to eventType - use new object "metaData" in service header and move the attributes "sender", "messageNumber" and "lastMessageNumber" into this object - link attribute "sender" to the global enum "sender" - link attributes data → "location" and "sourecLocation" to the global enums in "location" schema - use under data\package\weight attibute "unit" the global enum schema unit - use under data\package\volume attibute "unit" the global enum schema unit - under data\supplier use camelCase for attribute id - under data\supplier use camelCase for attribute number

coming version

2.1

Download

25.01.23

- add "logisticPackingunitId" and "logisticPackingunitNumber" under "product" for multipart items as optional fields - add "BUID", "bestBeforeDate", "batch", "imei", "serialNo" under "Data" as optional fields

Table 16. Version FINE to BRAIN

current version

previous version

coming version

4.3.6. Filter

Source topic is filtered on location IN ('LOEHNE', 'ANSBACH', 'SONNEFELD', 'HALDENSLEBEN', 'SUEDHAFEN', 'OHRDRUF', 'ERFURT', 'MOSINA', 'LANGENSELBOLD')


6 - S02 Stock Booking

Status
  1. Version 1.0 published 14.06.2022

  2. Version 2.0 published 29.01.2023

Approval
  1. DeepSea:

  2. NEON: abgestimmt mit Körber zur Umsetzung in NEON_Fein_Pflichtenheft_WEN1_ SST_v6.0

Comment
Assumption

.

1. Stakeholder

Role Application Responsible

Communication

Integration Layer

Leading App

Bube

InterfaceOwner

Bube

Producer

kMotion

Producer

KR1

Producer

COBRA

Producer

WMSx/SON

Consumer

Comorant

Consumer

Humpback

Consumer

OBS

MyToys

Consumer

F2X

2. Business Context

Bookings are triggered if the business event changes the amount of stock or the stock type for an item part. For multi part items each item part is booked. Single part items have only one part. The consuming ERP has to ensure the right calculation of their stocks considered on item size level. Most ERPs provide only complete item sizes in their web shops.

Exception: For the ERP CORE the bookings are sent from WMS at item size level. They are only triggered, if they are related to the complete item size (multi part bookings). For outbound bookings - when the first of n parts is booked and reduces the stock, for inbound bookings if the last of n parts is booked and the stock is "complete". The open multi part bookings have to be calculated and compared.

3. Information flow

Partner Direction FINE-Service Topic/API Description Status

WMS:Cobra

send

BuBe:BookingService

stock.stockbooking

StockBookingWms.v2.0

ready

WMS:Retailschicht

send

BuBe:BookingService

stock.stockbooking

StockBookingWms.v2.1

ready

WMS:KR1

send

BuBe:BookingService

stock.stockbooking.kr1.v2

StockBookingWms.v2.6

ready

WMS:kMotion ILOWA

send

BuBe:BookingService

stock.stockbooking.kmotion.v2

StockBookingWms.v2.4

ready

WMS:kMotion GERNSHEIM

send

BuBe:BookingService

stock.stockbooking.kmotion.v2

StockBookingWms.v2.3

planned

ERP:DeepSea

receive

BuBe:BookingService

stock.stockbooking.deepsea

StockBookingErp.v2.4

ready

ERP:CORE

receive

BuBe:BookingService

stock.stockbooking.core

StockBookingErp.v2.4

ready

ERP:F2X

receive

BuBe:BookingService

stock.stockbooking.f2x.v2

StockBookingErp.v2.5

planned

Diagram

4. Interface

4.1. Direction WMS to FINE

4.1.1. Header

This interface uses the Service Header

Special expresion for this interface:

Table 1. Attribute
Fieldname Expression

type

context

STOCK_BOOKING

4.1.2. Data model

Property Type Description

(Root)

object

Stock Booking Wms Message
This document describes the booking messages that FINE receives from warehouse management systems (WMS).

    eventId*

string (uuid)

The unique eventId
Global unique Id - JAVA UUID4 for the event generated by the actual producer. Use pattern: '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$'

    traceId*

string (uuid)

UUID for all events in a call hierarchy - trace
ID of the trace, will be generated by the first producer of the process. The ID will be the same for all events in the context of this process, also over system boundaries. The ID is equal to the eventId, if it is the first event. It's like a order number, the will used for all activities around the order.

    spanId

string (uuid)

The eventId of previous record or batchId
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)

    eventTime*

string (date-time)

Time of occurrence of the event
Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC

    version*

string

The number of version of schema
Number of version of this data structure. A sematic specification with major & minor version numbers

Maximum Length: 6
Regular expression: \d+\.\d{1,2}

    context*

string (enum)

context
The optional context specified here means the business domain. here STOCKPOSTING

Any of: [ "STOCKPOSTING" ]
Maximum Length: 50

    eventType*

string (enum)

event type
Event type (business transaction), that can be related to booking types

Any of: [ "GOODS_RECEIPT", "REVERSE_INBOUND", "DELIVERABLE_STOCK_MINUS", "DELIVERABLE_STOCK_PLUS", "DELIVERABLE_STOCK_TO_LOCKED_STOCK", "DELIVERABLE_STOCK_TO_STOCK_DIFFERENCE", "DELIVERABLE_STOCK_TO_STOCK_IN_TRANSIT", "LOCKED_STOCK_MINUS", "LOCKED_STOCK_PLUS", "LOCKED_STOCK_TO_DELIVERABLE_STOCK", "LOCKED_STOCK_TO_QUALITY_LOCKED_STOCK", "LOCKED_STOCK_TO_STOCK_IN_TRANSIT", "STOCK_DIFFERENCE_TO_DELIVERABLE_STOCK", "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK", "GOODS_RECEIPT_LOCKED_STOCK", "GOODS_RECEIPT_LOCKED_STOCK_CANCELED", "INVENTORY_DIFFERENCE", "INVENTORY_DIFFERENCE_CANCELED", "OUTGOING_GOODS_CUSTOMER_LOCKED_STOCK", "QUALITY_LOCKED_STOCK_CHANNEL_BOOKING", "QUALITY_LOCKED_STOCK_TO_CREDIT_THIRD_PARTY_SALE", "QUALITY_LOCKED_STOCK_TO_LOCKED_STOCK", "QUALITY_LOCKED_STOCK_TO_STOCK_DIFFERENCE", "QUALITY_LOCKED_STOCK_TO_STOCK_IN_TRANSIT", "QUALITY_LOCKED_STOCK_TO_TOTAL_LOSS", "QUALITY_LOCKED_STOCK_TO_TREASURE_DROVE", "REVERSE_INBOUND_RETURNS", "REVERSE_INBOUND_RETURNS_CANCELED", "STOCK_DIFFERENCE_TO_QUALITY_LOCKED_STOCK", "STOCK_IN_TRANSIT_TO_LOCKED_STOCK", "STOCK_IN_TRANSIT_TO_QUALITY_LOCKED_STOCK", "STOCK_DIFFERENCE_TO_STOCK_IN_TRANSIT", "STOCK_IN_TRANSIT_TO_STOCK_DIFFERENCE", "LOCKED_STOCK_TO_RETURNS", "TRANSIT_LOCKED_STOCK_MINUS", "TRANSIT_LOCKED_STOCK_TO_LOCKED_STOCK", "WAREHOUSE_DAMAGE", "WAREHOUSE_DAMAGE_CANCELED", "DELIVERABLE_STOCK_TO_QUALITY_LOCKED_STOCK", "DELIVERABLE_STOCK_TO_RESERVED_SHIPPING_STOCK", "GOODS_RECEIPT_QS_UNAUDITED_STOCK", "GOODS_RECEIPT_QUALITY_LOCKED_STOCK", "GOODS_RECEIPT_STOCK_DIFFERENCE", "INVENTORY_DIFFERENCE_DELIVERABLE_STOCK", "INVENTORY_DIFFERENCE_STOCK_DIFFERENCE", "IWA_STOCK_DIFFERENCE", "OUTGOING_GOODS_CUSTOMER_CANCEL", "OUTGOING_GOODS_CUSTOMER_STOCK_DIFFERENCE", "QS_UNAUDITED_STOCK_GOODS_RECEIPT", "QS_UNAUDITED_STOCK_TO_DELIVERABLE_STOCK", "QUALITY_LOCKED_STOCK_GOODS_RECEIPT", "QUALITY_LOCKED_STOCK_INVENTORY_DIFFERENCE", "QUALITY_LOCKED_STOCK_IWA", "QUALITY_LOCKED_STOCK_RAS_RES", "QUALITY_LOCKED_STOCK_TO_DELIVERABLE_STOCK", "RAS_RES_STOCK_DIFFERENCE", "RESERVABLE_LOCKED_STOCK_TO_DELIVERABLE_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_DELIVERABLE_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_STOCK_DIFFERENCE", "RESERVABLE_STOCK_IN_TRANSIT_TO_RESERVABLE_LOCKED_STOCK", "RESERVED_SHIPPING_STOCK_DELIVERABLE_STOCK", "RESERVED_SHIPPING_STOCK_INVENTORY_DIFFERENCE", "RESERVED_SHIPPING_STOCK_OUTGOING_GOODS_CUSTOMER", "STOCK_DIFFERENCE_INVENTORY", "STOCK_DIFFERENCE_OUTGOING_GOODS", "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK_H162", "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK_H46", "STOCK_IN_TRANSIT_TO_RESERVED_SHIPPING_STOCK", "TOTAL_LOSS_LOCKED_STOCK", "TOTAL_LOSS_STOCK_DIFFERENCE", "DELIVERABLE_STOCK_INVENTORY_DIFFERENCE", "DELIVERABLE_STOCK_TO_RESERVABLE_LOCKED_STOCK", "RESERVABLE_LOCKED_STOCK_TO_RESERVABLE_STOCK_IN_TRANSIT", "GOODS_RECEIPT_TOTAL_LOSS", "RETURNS_MANUAL_STORAGE", "RETURNS_AUTOMATIC_STORAGE", "TRANSFER_MANUAL_STORAGE", "TRANSFER_AUTOMATIC_STORAGE", "REVERSE_INBOUND_MANUAL_STORAGE", "REVERSE_INBOUND_AUTOMATIC_STORAGE", "STOCK_AVAILABILITY_CHECK_NOK", "INVENTORY_DIFFERENCE_ERP_STOCK", "IN_FULFILLMENT_MISSING", "HIGH_LEVEL_RESERVATION_OK", "RESERVATION_OK", "IN_FULFILLMENT_CUSTOMER", "IN_FULFILLMENT_MANUAL_SUBSTITUTION", "IN_FULFILLMENT_B2B", "IN_FULFILLMENT_QUALITY_LOCKED", "HIGH_LEVEL_RESERVATION_NOK", "RESERVATION_NOK", "INVENTORY_DIFFERENCE_ERP_STOCK_MEANWHILE_REDUCED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND", "OUTGOING_GOODS", "OUTGOING_GOODS_CUSTOMER", "OUTGOING_GOODS_TRANSFER", "OUTGOING_GOODS_B2B", "INVENTORY_DIFFERENCE_COMMON", "INVENTORY_PLUS_DIFFERENCE", "GOODS_RECEIPT_QUALITY_LOCKED", "GOODS_RECEIPT_QUALITY_CHECK_APPROVED", "GOODS_RECEIPT_RETURN", "INVENTORY_LOCK", "INVENTORY_LOCK_QUALITY_LOCKED", "INVENTORY_CHECK_FINAL", "INVENTORY_CHECK_FINAL_QUALITY_LOCKED", "IN_FULFILLMENT_CANCEL", "IN_FULFILLMENT_CANCEL_QUALITY_LOCKED", "TRANSFER_TRANSIT_BACK_TO_SOURCE", "INVENTORY_TRANSFER_TRANSIT", "RETURNS_TRANSIT_BACK_TO_SOURCE", "INVENTORY_RETURNS_TRANSIT", "DELIVERABLE_STOCK_PLUS_TEST", "DELIVERABLE_STOCK_MINUS_TEST", "QUALITY_LOCKED_STOCK_PLUS_TEST", "QUALITY_LOCKED_STOCK_MINUS_TEST", "STOCK_IN_FULFILLMENT_PLUS_TEST", "STOCK_IN_FULFILLMENT_MINUS_TEST", "INVENTORY_PLUS_DIFFERENCE_INVENTORY_LOCKED", "LOCKING_STOCK", "UNLOCKING_STOCK", "GOODS_RECEIPT_FROM_REWORK", "INVENTORY_MINUS_DIFFERENCE", "INVENTORY_PLUS_DIFFERENCE_QUALITY_LOCKED", "INVENTORY_MINUS_DIFFERENCE_QUALITY_LOCKED", "IN_FULFILLMENT_RESERVATION_CANCEL", "IN_FULFILLMENT_CANCEL_CUSTOMER", "IN_FULFILLMENT_CANCEL_B2B", "IN_FULFILLMENT_RESERVATION_CANCEL_CUSTOMER", "IN_FULFILLMENT_RESERVATION_CANCEL_B2B", "IN_FULFILLMENT_RESERVATION_CANCEL_QUALITY_LOCKED", "RESERVE_REPLENISHMENT", "UNRESERVE_REPLENISHMENT", "TRANSFER_MANUAL_STORAGE_QUALITY_LOCKED", "TRANSFER_AUTOMATIC_STORAGE_QUALITY_LOCKED", "IN_FULFILLMENT_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_MANUAL_SUBSTITUTION_B2B", "IN_FULFILLMENT_MANUAL_SUBSTITUTION_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK_B2B", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT_B2B", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK_B2B", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND_B2B", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_CANCEL_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_RESERVATION_CANCEL_B2B_QUALITY_LOCKED", "OUTGOING_GOODS_TRANSFER_B2B", "OUTGOING_GOODS_TRANSFER_B2B_QUALITY_LOCKED", "OUTGOING_GOODS_B2B_QUALITY_LOCKED", "INVENTORY_DIFFERENCE_INVENTORY_LOCKED", "LOCKED_STOCK_TO_STOCK_DIFFERENCE", "QUALITY_LOCKED_STOCK_TO_RESERVABLE_LOCKED_STOCK", "QUALITY_LOCKED_STOCK_TO_RESERVABLE_STOCK_IN_TRANSIT", "RESERVABLE_LOCKED_STOCK_TO_QUALITY_LOCKED_STOCK", "RESERVABLE_LOCKED_STOCK_TO_STOCK_DIFFERENCE", "RESERVABLE_STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_TO_QUALITY_LOCKED_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_TO_STOCK_DIFFERENCE", "STOCK_DIFFERENCE_TO_LOCKED_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_TO_LOCKED_STOCK" ]
Maximum Length: 100

    metaData*

object

additional meta data
additional meta information for booking interface

        sender*

string (enum)

sender
Name of the source system, that has sent this message.

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" ]

        instance*

string (enum)

instance of producer
instance of the application or warehouse context

Any of: [ "LANGENSELBOLD", "OHRDRUF", "LOEHNE", "ANSBACH", "MOSINA", "HALDENSLEBEN", "HALDENSLEBEN_RSS", "SUEDHAFEN", "ALTENKUNSTADT", "SONNEFELD", "ERFURT", "GERNSHEIM", "ILOWA", "LOEHNE_CP" ]
Maximum Length: 30

        client*

string

client
Client/mandant (messages of different clients have different processing rules and destination interfaces) - use FBO for Fulfillment by Otto (CORE, DeepSea…​)

Maximum Length: 50

    data*

object

Data Wms
Data of the JSON message

        sourceTimestamp*

string (date-time)

the booking timestamp
Booking timestamp UTC+ISO-8601 format

        creationType

string (enum)

creation type
identifies specific creation conditions if necessary, in first version only automatic and manual bookings are used for stock journal

Any of: [ "AUTOMATIC", "MANUAL" ]

        location*

string (enum)

the location where where the event was created
the location where the event was created

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" ]

        erpSnapshotId

number

the id of the following inventory snapshot
Consecutive number (sequence) of a long number. each inventory snapshot gets its own ID, which is identical for all records of the snapshot. all bookings get the id of the following snapshot

Maximum Length: 18
Minimum: 1
Maximum: 1000000000000000000

        product*

object

Product Wms
product related information to identify the product and part

            itemNumber

integer

item number
item number (article data) - used for old systems

Maximum: 9999999999

            itemSize

integer

item size
Numeric item size (article data) - used for old systems

Maximum: 99999

            communicationKey

integer

unique communication key
An unique communication key for this item size (FBO: itemOptionCommunicationKey, BONPRIX: MAN…​) - used for old systems

Maximum: 1000000000000000000

            logisticProductId

string

LSAS product ID
LSAS product ID - unique over all item sizes / all clients

            logisticPartId

string

LSAS part ID
GL/bulky items: ID for the part/packing unit based on item - size - part (LSAS)

            partNumber

integer

part number (bulky items)
part number for specific packing unit (bulky items)

Maximum: 999

            numberOfParts

integer

number of all parts
number of all parts for this item (bulky items)

Maximum: 999

        stockInfo*

object

Stock Info Wms
the information for booking related warehouses, filled dependent on event type

Additional Properties: false

            sourceLocation

string (enum)

source location
the source location for the booking

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" ]

            destinationLocation

string (enum)

destination location
the destination location for the booking

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" ]

        movementInfo*

object

Movement Info Wms
movement/booking informations

            quantity*

integer

quantity
quantity to be booked, in case of goods receipt the delivery note original quantity for this detail, in case of goods receipt release booking the released quantity for this detail

Minimum: 1
Maximum: 9999999999

            movementInfoDetails

object

Movement Info Details Wms
Detailed Info about the movement, also used for deprecated data for old systems

                documentNumber

integer

document number
Depending on type, in case of goods release booking then receiptDocumentNo (44xxx) from delivery, in case of return vendor sheet booking the rvsNumber (9x?xxx), otherwise other document numbers.

Maximum: 9999999999

                supplierNumber

integer

supplier number
Number of supplier, mandatory for goods release, return vendor sheet

Maximum: 9999999999

                externalReferenceView

string

External reference view
External reference view - used in core as posting text

Maximum Length: 50

                customerCompany

integer

customer company
Company of the customer account. For example: SON - LDG Großkunden mit Belegnummer

Maximum: 9999999999

                purchaseOrderNumber

string

purchase order number
purchase order number (sent from SON for goods released bookings, ordernumber OVA)

                externalReference

string

external reference
externalReference - Cobra - Unigro reference ano from unigro order

                goodsInId

string

goods in id
unique id of a goods receipt see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/

Maximum Length: 36

                buaid

string

buaid
bi unique article ID, unique identification of an individual unit in the logistical process

Maximum Length: 50

                returnKey

string

returnKey
returnKey

Maximum Length: 500

                b2bOrderId

string

b2b Order Id
ERP Order Id - for stock transfers ordered from ERP

Maximum Length: 36

                loadingNumber

string

Loading Number
generated per sender; generation specification from OTTO, unique within 13 years for stock transfers

Maximum Length: 12

                merchantErpIdentifier

string (enum)

merchant erp identifier
enums that specifies the merchant erp that generated the orders

Any of: [ "DEEP_SEA_CORMORANT", "CORE", "B2B_DEEP_SEA_CORMORANT", "B2B_CORE" ]
Maximum Length: 30

                merchantSingleItemId

string

merchant single item Id
single item id for orders used in merchant erp

Maximum Length: 255

                stockTransferType

string (enum)

stock transfer type
additional transfer type information for stock transfers

Any of: [ "UMF", "WRS_WE", "WRS_L", "IWA_WE", "IWA_M", "GKD" ]
Maximum Length: 50

                orderPart

integer

order part
number of the attempt to reserve or check the stock for orders - starts with zero

Minimum: 0
Maximum: 999999999

                stockType

string (enum)

stock type
stockType for B2B orders which indicates from which stock the order has to be fulfilled

Any of: [ "AVAILABLE", "LOCKED" ]
Maximum Length: 50

                lockTypeCode

string

lock type code
lock type code from wms for locked stock which can also differentiate between the locked stock types used in B2B order bookings

Maximum Length: 50

                returnOrderUUID

string

returnOrderUUID
the UID of the associated return order contract, can be a UUID4

Maximum Length: 100

                originalGoodsInId

string

original goods in id
unique id of the original goods receipt for a goods in from rework see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/

Maximum Length: 36

                b2bShipmentType

string (enum)

b2b shipment type
the shipment type for b2b orders - UMF for stock transfer to another warehouse (with known subtypes in stockTransferType) or GKD for real major customer orders, mandatory for b2b order bookings, null for B2C

Any of: [ "UMF", "GKD" ]
Maximum Length: 30

4.1.3. Enumeration

Field: EventType

Refer to Stock Booking EventType for detailed information about the event types and their usage.

Table 2. eventType
Meta Value Description

GOODS_RECEIPT

(formerly GOOD_RECEIPT_RELEASED)

This booking is triggered when a delivery position (for receiptDocumentNo, supplier, item, size) is released. It books in old CORE system from 6 - WE Lieferant to 3 - Fakturierbarer Bestand. (BUB relevant - Warenjournal/EK) The journal expects an aggregated booking with total released quantity, not partial bookings. If 100 items are delivered, we need a booking quantity 100 and not 100 times 1.

If not all items are on their location, a partial quantity has to be locked after this booking, because it is not deliverable.

A goods receipt message WE2 is also sent to FLASH (interface GoodsIn)

REVERSE_INBOUND

(formerly RETURN_TO_VENDOR)

This type is used if the released goods are returned to the vendor.

(In goods receiving processes with returns to vendor the goods_receipt_released booking is sent and the return to vendor booking for the partial quantity that should be returned. A goods receipt message WE2 is also sent to FLASH (interface Wareineingang) with release_code return to vendor.)

DELIVERABLE_STOCK_TO_LOCKED_STOCK

This type is used if the stock is locked and no more deliverable (transfer to a new place, aggregation/compaction of stock…​)

LOCKED_STOCK_TO_DELIVERABLE_STOCK

This type is used to free the locked stock. it will be available again.

DELIVERABLE_STOCK_TO_STOCK_DIFFERENCE

This type is used for missing items. it will be marked as minus difference

STOCK_DIFFERENCE_TO_DELIVERABLE_STOCK

This type is used for found items. it will be marked as plus difference

OUTGOING_GOODS_CUSTOMER

Reduces deliverable stock for outgoing goods to customers

DELIVERABLE_STOCK_TO_STOCK_IN_TRANSIT

Transfer to another warehouse (booked into the transport stock of the destination warehouse from deliverable stock)

STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK

Entry of the stock from transfer from another warehouse (is already in own transport stock and will be deliverable)

Field: StockTransferType

Table 3. stockTransferType
Meta Value Description

UMF

B2B order b2bShipmentType UMF for transfers

WRS_WE

B2B order b2bShipmentType UMF for returns to supplier from inbound process

WRS_L

B2B order b2bShipmentType UMF for returns to supplier from warehouse stock

IWA_WE

B2B order b2bShipmentType UMF for internal goods deduction (IWA) from inbound process

IWA_M

B2B order b2bShipmentType UMF for internal goods deductions (IWA) for samples

GKD

B2B order b2bShipmentType UMF for major customer/supply

Field: StockType

Table 4. stockType
Meta Value Description

AVAILABLE

B2B order fulfilled from deliverable/available stock

LOCKED

B2B order fulfilled from locked stock

Field: merchantErpIdentifier

Table 5. merchantErpIdentifier
Meta Value Description

DEEP_SEA_CORMORANT

Cormorant B2C orders

B2B_DEEP_SEA_CORMORANT

Cormorant B2B orders

CORE

Core B2C orders

B2B_CORE

Core B2C orders

Field: b2bShipmentType

Table 6. b2bShipmentType
Meta Value Description

UMF

B2B order for transfers

GKD

B2B order for major customer/supply

4.1.4. Example

Message WMS to FINE v2.6
{
  "eventId": "1e133d1b-ad2d-4230-bc6d-853b4ef9c651",
  "traceId": "7e533e45-2c71-4925-934f-c5a5f2eb1eb0",
  "eventTime": "2024-08-21T14:57:18.429+00:00",
  "version": "2.6",
  "context": "STOCKPOSTING",
  "eventType": "RESERVATION_OK",
  "metaData": {
    "sender": "KMOTION_ILO",
    "instance": "ILOWA",
    "client": "FBO"
  },
  "data": {
    "sourceTimestamp": "2024-08-21T14:57:18.429+00:00",
    "location": "ILOWA",
    "product": {
      "itemNumber": 27703966,
      "itemSize": 0,
      "logisticProductId": "1381743776",
      "logisticPartId": "34345555",
      "partNumber": 1,
      "numberOfParts": 1
    },
    "stockInfo": {
      "sourceLocation": "ILOWA",
      "destinationLocation": "ILOWA"
    },
    "movementInfo": {
      "quantity": 1,
      "movementInfoDetails": {
        "buaid": "ed5807dd-c141-4b91-9f76-b6cbfa41cb73",
        "orderPart": 0,
        "stockTransferType": "WRS_WE",
        "stockType": "LOCKED",
        "lockTypeCode": "QCSRET",
        "b2bShipmentType": "UMF",
        "merchantErpIdentifier": "B2B_DEEP_SEA_CORMORANT",
        "merchantSingleItemId": "7e545e45-2c71-4945-934f-c5a5f2eb1123"
      }
    }
  }
}

4.1.5. Version history

Table 7. Version WMS to FINE

Version

Number

File

Published on

previous version

2.0

Download

29.01.23

previous version

2.1

Download

10.08.23

previous version

2.2

Download

02.04.24

previous version

2.3

Download

17.07.24

previous version

2.4

Download

30.08.24

previous version

2.5

Download

07.11.24

current version

2.6

Download

09.01.25

coming version

4.1.6. Changelog

Changes V1.0 → V2.0

  1. Standard header: The Standard header has been changed to the current standard header with following changes:

    • attributes "sender", "instance" and "client" has been moved to the new object type "metaData"

    • attribute "type" has been renamed to "eventType"

    • attributes "sourceIdentifier", "messageNumber" and "lastMessageNumber" has been removed

  2. Payload (Data)

    • new attribute "creationType" with values "AUTOMATIC" or "MANUAL" has been introduced

Changes V2.0 ⇒ V2.1

  1. Standard header

    • attribute "sender" is now linked to system.v7.schema.json

    • attribute "client" is now linked to company.v5.schema.json

    • new enums for eventType DELIVERABLE_STOCK_TO_RESERVABLE_LOCKED_STOCK and RESERVABLE_LOCKED_STOCK_TO_RESERVABLE_STOCK_IN_TRANSIT

    • attribute "version" has now type string

Changes V2.1 ⇒ V2.2

  1. Standard header

  2. Payload (Data)

    • new attributes "goodsInId" for referencing the goods in goods receipt bookings

    • new attribute "buaid"

    • new attributes for b2b order and stock transfer related bookings "b2bOrderId" and "loadingNumber"

    • new attributes for b2c order related bookings "merchantErpIdentifier" and "merchantSingleItemId"

    • new attribute "returnKey"

    • new attribute "stockTransferType" for B2B orders

    • new attribute "orderPart"

    • new attribute "stockType" indicating stockType of quant used for B2B orders

    • new attribute "lockTypeCode" for B2B orders on locked stock

    • new attribute "returnOrderUUID" for return order contract relations

Changes V2.2 ⇒ V2.3

  1. Standard header

    • new eventTypes

  2. Payload (Data)

    • new attributes "originalGoodsInId" for referencing the original goods in id for goods receipt bookings

Changes V2.3 ⇒ V2.4

  1. Standard header

    • new eventTypes for replenishment reservation

    • remove enum for company references in metaData.client, use only strings

Changes V2.4 ⇒ V2.5

  1. Standard header

    • set length of "eventType" to 100

    • new eventTypes for B2B processes and locked stock transfers

    • new eventTypes for KR1

Changes V2.5 ⇒ V2.6

  1. Standard header

    • new eventTypes for KR1

  2. Payload (Data)

    • new attribute b2bShipmentType for separation of B2B order types for stock transfers and major customers

    • new values for enum merchantErpIdentifier for B2B orders

Notes for new major version:

  • rename logisticProductId to logisticsProductId

  • rename logisticsPartId to logisticsPackingUnitId

4.1.7. Schema

Message WMS to FINE v2.6
{
  "$schema": "https://json-schema.org/draft-07/schema",
  "$comment": "Specification of booking messages that FINE receives from warehouse management systems (WMS) in version 2.6",
  "$id": "https://doc.fine.gcp.osp-dev.de/registry/Stock/StockBookingWms.v2.6.schema.json",
  "title": "Stock Booking Wms Message",
  "description": "This document describes the booking messages that FINE receives from warehouse management systems (WMS).",
  "definitions": {
    "instance": {
      "type": "string",
      "enum": [
        "LANGENSELBOLD",
        "OHRDRUF",
        "LOEHNE",
        "ANSBACH",
        "MOSINA",
        "HALDENSLEBEN",
        "HALDENSLEBEN_RSS",
        "SUEDHAFEN",
        "ALTENKUNSTADT",
        "SONNEFELD",
        "ERFURT",
        "GERNSHEIM",
        "ILOWA",
        "LOEHNE_CP"
      ],
      "maxLength": 30
    }
  },
  "type": "object",
  "properties": {
    "eventId": {
      "title": "The unique eventId",
      "description": "Global unique Id - JAVA UUID4 for the event generated by the actual producer. Use pattern: '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$' ",
      "type": "string",
      "format": "uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "traceId": {
      "title": "UUID for all events in a call hierarchy - trace",
      "description": "ID of the trace, will be generated by the first producer of the process. The ID will be the same for all events in the context of this process, also over system boundaries. The ID is equal to the eventId, if it is the first event. It's like a order number, the will used for all activities around the order.",
      "type": "string",
      "format": "uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "spanId": {
      "title": "The eventId of previous record or batchId",
      "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)",
      "type": "string",
      "format": "uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "eventTime":{
      "title":"Time of occurrence of the event",
      "description":"Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC",
      "type":"string",
      "format":"date-time",
      "examples":[
        "2022-11-15T17:09:06.322+01:00",
        "2022-04-16T16:06:05.123Z"
      ]
    },
    "version": {
      "title":"The number of version of schema",
      "description":"Number of version of this data structure. A sematic specification with major & minor version numbers",
      "type":"string",
      "pattern":"\\d+\\.\\d{1,2}",
      "maxLength":6,
      "examples":[
        "1.1",
        "2.21",
        "12.1"
      ]
    },
    "context": {
      "title": "context",
      "description": "The optional context specified here means the business domain. here STOCKPOSTING",
      "type": "string",
      "enum": [
        "STOCKPOSTING"
      ],
      "maxLength": 50
    },
    "eventType": {
      "title": "event type",
      "description": "Event type (business transaction), that can be related to booking types",
      "type": "string",
      "enum": [
        "GOODS_RECEIPT",
        "REVERSE_INBOUND",
        "DELIVERABLE_STOCK_MINUS",
        "DELIVERABLE_STOCK_PLUS",
        "DELIVERABLE_STOCK_TO_LOCKED_STOCK",
        "DELIVERABLE_STOCK_TO_STOCK_DIFFERENCE",
        "DELIVERABLE_STOCK_TO_STOCK_IN_TRANSIT",
        "LOCKED_STOCK_MINUS",
        "LOCKED_STOCK_PLUS",
        "LOCKED_STOCK_TO_DELIVERABLE_STOCK",
        "LOCKED_STOCK_TO_QUALITY_LOCKED_STOCK",
        "LOCKED_STOCK_TO_STOCK_IN_TRANSIT",
        "STOCK_DIFFERENCE_TO_DELIVERABLE_STOCK",
        "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK",
        "GOODS_RECEIPT_LOCKED_STOCK",
        "GOODS_RECEIPT_LOCKED_STOCK_CANCELED",
        "INVENTORY_DIFFERENCE",
        "INVENTORY_DIFFERENCE_CANCELED",
        "OUTGOING_GOODS_CUSTOMER_LOCKED_STOCK",
        "QUALITY_LOCKED_STOCK_CHANNEL_BOOKING",
        "QUALITY_LOCKED_STOCK_TO_CREDIT_THIRD_PARTY_SALE",
        "QUALITY_LOCKED_STOCK_TO_LOCKED_STOCK",
        "QUALITY_LOCKED_STOCK_TO_STOCK_DIFFERENCE",
        "QUALITY_LOCKED_STOCK_TO_STOCK_IN_TRANSIT",
        "QUALITY_LOCKED_STOCK_TO_TOTAL_LOSS",
        "QUALITY_LOCKED_STOCK_TO_TREASURE_DROVE",
        "REVERSE_INBOUND_RETURNS",
        "REVERSE_INBOUND_RETURNS_CANCELED",
        "STOCK_DIFFERENCE_TO_QUALITY_LOCKED_STOCK",
        "STOCK_IN_TRANSIT_TO_LOCKED_STOCK",
        "STOCK_IN_TRANSIT_TO_QUALITY_LOCKED_STOCK",
        "STOCK_DIFFERENCE_TO_STOCK_IN_TRANSIT",
        "STOCK_IN_TRANSIT_TO_STOCK_DIFFERENCE",
        "LOCKED_STOCK_TO_RETURNS",
        "TRANSIT_LOCKED_STOCK_MINUS",
        "TRANSIT_LOCKED_STOCK_TO_LOCKED_STOCK",
        "WAREHOUSE_DAMAGE",
        "WAREHOUSE_DAMAGE_CANCELED",
        "DELIVERABLE_STOCK_TO_QUALITY_LOCKED_STOCK",
        "DELIVERABLE_STOCK_TO_RESERVED_SHIPPING_STOCK",
        "GOODS_RECEIPT_QS_UNAUDITED_STOCK",
        "GOODS_RECEIPT_QUALITY_LOCKED_STOCK",
        "GOODS_RECEIPT_STOCK_DIFFERENCE",
        "INVENTORY_DIFFERENCE_DELIVERABLE_STOCK",
        "INVENTORY_DIFFERENCE_STOCK_DIFFERENCE",
        "IWA_STOCK_DIFFERENCE",
        "OUTGOING_GOODS_CUSTOMER_CANCEL",
        "OUTGOING_GOODS_CUSTOMER_STOCK_DIFFERENCE",
        "QS_UNAUDITED_STOCK_GOODS_RECEIPT",
        "QS_UNAUDITED_STOCK_TO_DELIVERABLE_STOCK",
        "QUALITY_LOCKED_STOCK_GOODS_RECEIPT",
        "QUALITY_LOCKED_STOCK_INVENTORY_DIFFERENCE",
        "QUALITY_LOCKED_STOCK_IWA",
        "QUALITY_LOCKED_STOCK_RAS_RES",
        "QUALITY_LOCKED_STOCK_TO_DELIVERABLE_STOCK",
        "RAS_RES_STOCK_DIFFERENCE",
        "RESERVABLE_LOCKED_STOCK_TO_DELIVERABLE_STOCK",
        "RESERVABLE_STOCK_IN_TRANSIT_DELIVERABLE_STOCK",
        "RESERVABLE_STOCK_IN_TRANSIT_STOCK_DIFFERENCE",
        "RESERVABLE_STOCK_IN_TRANSIT_TO_RESERVABLE_LOCKED_STOCK",
        "RESERVED_SHIPPING_STOCK_DELIVERABLE_STOCK",
        "RESERVED_SHIPPING_STOCK_INVENTORY_DIFFERENCE",
        "RESERVED_SHIPPING_STOCK_OUTGOING_GOODS_CUSTOMER",
        "STOCK_DIFFERENCE_INVENTORY",
        "STOCK_DIFFERENCE_OUTGOING_GOODS",
        "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK_H162",
        "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK_H46",
        "STOCK_IN_TRANSIT_TO_RESERVED_SHIPPING_STOCK",
        "TOTAL_LOSS_LOCKED_STOCK",
        "TOTAL_LOSS_STOCK_DIFFERENCE",
        "DELIVERABLE_STOCK_INVENTORY_DIFFERENCE",
        "DELIVERABLE_STOCK_TO_RESERVABLE_LOCKED_STOCK",
        "RESERVABLE_LOCKED_STOCK_TO_RESERVABLE_STOCK_IN_TRANSIT",
        
        "GOODS_RECEIPT_TOTAL_LOSS",
        
        "RETURNS_MANUAL_STORAGE",
        "RETURNS_AUTOMATIC_STORAGE",
        "TRANSFER_MANUAL_STORAGE",
        "TRANSFER_AUTOMATIC_STORAGE",
        "REVERSE_INBOUND_MANUAL_STORAGE",
        "REVERSE_INBOUND_AUTOMATIC_STORAGE",

        "STOCK_AVAILABILITY_CHECK_NOK",
        "INVENTORY_DIFFERENCE_ERP_STOCK",
        "IN_FULFILLMENT_MISSING",

        "HIGH_LEVEL_RESERVATION_OK",
        "RESERVATION_OK",
        "IN_FULFILLMENT_CUSTOMER",
        "IN_FULFILLMENT_MANUAL_SUBSTITUTION",
        "IN_FULFILLMENT_B2B",
        "IN_FULFILLMENT_QUALITY_LOCKED",
        
        "HIGH_LEVEL_RESERVATION_NOK",
        "RESERVATION_NOK",
        "INVENTORY_DIFFERENCE_ERP_STOCK_MEANWHILE_REDUCED",

        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND",

        "OUTGOING_GOODS",
        "OUTGOING_GOODS_CUSTOMER",
        "OUTGOING_GOODS_TRANSFER",
        "OUTGOING_GOODS_B2B",
        
        "INVENTORY_DIFFERENCE_COMMON",
        "INVENTORY_PLUS_DIFFERENCE",
        
        "GOODS_RECEIPT_QUALITY_LOCKED",
        "GOODS_RECEIPT_QUALITY_CHECK_APPROVED",
        "GOODS_RECEIPT_RETURN",
        
        "INVENTORY_LOCK",
        "INVENTORY_LOCK_QUALITY_LOCKED",
        "INVENTORY_CHECK_FINAL",
        "INVENTORY_CHECK_FINAL_QUALITY_LOCKED",
        "IN_FULFILLMENT_CANCEL",
        "IN_FULFILLMENT_CANCEL_QUALITY_LOCKED",

        "TRANSFER_TRANSIT_BACK_TO_SOURCE",
        "INVENTORY_TRANSFER_TRANSIT",
        "RETURNS_TRANSIT_BACK_TO_SOURCE",
        "INVENTORY_RETURNS_TRANSIT",

        "DELIVERABLE_STOCK_PLUS_TEST",
        "DELIVERABLE_STOCK_MINUS_TEST",
        "QUALITY_LOCKED_STOCK_PLUS_TEST",
        "QUALITY_LOCKED_STOCK_MINUS_TEST",
        "STOCK_IN_FULFILLMENT_PLUS_TEST",
        "STOCK_IN_FULFILLMENT_MINUS_TEST",
        
        "INVENTORY_PLUS_DIFFERENCE_INVENTORY_LOCKED",

        "LOCKING_STOCK",
        "UNLOCKING_STOCK",

        "GOODS_RECEIPT_FROM_REWORK",
        "INVENTORY_MINUS_DIFFERENCE",
        "INVENTORY_PLUS_DIFFERENCE_QUALITY_LOCKED",
        "INVENTORY_MINUS_DIFFERENCE_QUALITY_LOCKED",

        "IN_FULFILLMENT_RESERVATION_CANCEL",
        "IN_FULFILLMENT_CANCEL_CUSTOMER",
        "IN_FULFILLMENT_CANCEL_B2B",
        "IN_FULFILLMENT_RESERVATION_CANCEL_CUSTOMER",
        "IN_FULFILLMENT_RESERVATION_CANCEL_B2B",
        "IN_FULFILLMENT_RESERVATION_CANCEL_QUALITY_LOCKED",
        "RESERVE_REPLENISHMENT",
        "UNRESERVE_REPLENISHMENT",

        "TRANSFER_MANUAL_STORAGE_QUALITY_LOCKED",
        "TRANSFER_AUTOMATIC_STORAGE_QUALITY_LOCKED",
        
        "IN_FULFILLMENT_B2B_QUALITY_LOCKED",
        "IN_FULFILLMENT_MANUAL_SUBSTITUTION_B2B",
        "IN_FULFILLMENT_MANUAL_SUBSTITUTION_B2B_QUALITY_LOCKED",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK_B2B",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK_B2B_QUALITY_LOCKED",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT_B2B",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT_B2B_QUALITY_LOCKED",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK_B2B",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK_B2B_QUALITY_LOCKED",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND_B2B",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND_B2B_QUALITY_LOCKED",
        "IN_FULFILLMENT_CANCEL_B2B_QUALITY_LOCKED",
        "IN_FULFILLMENT_RESERVATION_CANCEL_B2B_QUALITY_LOCKED",
        "OUTGOING_GOODS_TRANSFER_B2B",
        "OUTGOING_GOODS_TRANSFER_B2B_QUALITY_LOCKED",
        "OUTGOING_GOODS_B2B_QUALITY_LOCKED",
        "INVENTORY_DIFFERENCE_INVENTORY_LOCKED",
        
        "LOCKED_STOCK_TO_STOCK_DIFFERENCE",
        "QUALITY_LOCKED_STOCK_TO_RESERVABLE_LOCKED_STOCK",
        "QUALITY_LOCKED_STOCK_TO_RESERVABLE_STOCK_IN_TRANSIT",
        "RESERVABLE_LOCKED_STOCK_TO_QUALITY_LOCKED_STOCK",
        "RESERVABLE_LOCKED_STOCK_TO_STOCK_DIFFERENCE",
        "RESERVABLE_STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK",
        "RESERVABLE_STOCK_IN_TRANSIT_TO_QUALITY_LOCKED_STOCK",
        "RESERVABLE_STOCK_IN_TRANSIT_TO_STOCK_DIFFERENCE",
        "STOCK_DIFFERENCE_TO_LOCKED_STOCK",
        "RESERVABLE_STOCK_IN_TRANSIT_TO_LOCKED_STOCK"
      ],
      "maxLength": 100
    },
    "metaData":{
      "type":"object",
      "title":"additional meta data",
      "description":"additional meta information for booking interface",
      "required":[
        "sender",
        "instance",
        "client"
      ],
      "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.v8.schema.json"
        },
        "instance": {
          "title": "instance of producer",
          "description": "instance of the application or warehouse context",
          "$ref": "#/definitions/instance"
        },
        "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...)",
          "type": "string",
          "maxLength": 50,
          "examples": [
            "FBO"
          ]
        }
      }
    },
    "data": {
      "title": "Data Wms",
      "description": "Data of the JSON message",
      "type": "object",
      "properties": {
        "sourceTimestamp": {
          "title": "the booking timestamp",
          "description": "Booking timestamp UTC+ISO-8601 format",
          "type": "string",
          "format": "date-time",
          "examples": [
            "2022-04-19T08:51:05+02:00"
          ]
        },
        "creationType": {
          "title": "creation type",
          "description": "identifies specific creation conditions if necessary, in first version only automatic and manual bookings are used for stock journal",
          "type": "string",
          "enum": [
            "AUTOMATIC",
            "MANUAL"
          ]
        },
        "location": {
          "title": "the location where where the event was created",
          "description": "the location where the event was created",
          "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/warehouselocations.v1.schema.json"
        },
        "erpSnapshotId": {
          "title": "the id of the following inventory snapshot",
          "description": "Consecutive number (sequence) of a long number. each inventory snapshot gets its own ID, which is identical for all records of the snapshot. all bookings get the id of the following snapshot",
          "type": "number",
          "maxLength": 18,
          "minimum": 1,
          "maximum": 999999999999999999,
          "examples": [
            122
          ]
        },
        "product": {
          "title": "Product Wms",
          "description": "product related information to identify the product and part",
          "type": "object",
          "properties": {
            "itemNumber": {
              "title": "item number",
              "description": "item number (article data) - used for old systems",
              "type": "integer",
              "maximum": 9999999999,
              "examples": [
                80473011
              ]
            },
            "itemSize": {
              "title": "item size",
              "description": "Numeric item size (article data) - used for old systems",
              "type": "integer",
              "maximum": 99999,
              "examples": [
                907
              ]
            },
            "communicationKey": {
              "title": "unique communication key",
              "description": "An unique communication key for this item size (FBO: itemOptionCommunicationKey, BONPRIX: MAN...) - used for old systems",
              "type": "integer",
              "maximum": 999999999999999999,
              "examples": [
                74154545
              ]
            },
            "logisticProductId": {
              "title": "LSAS product ID",
              "description": "LSAS product ID - unique over all item sizes / all clients",
              "type": "string",
              "examples": [
                "54985132"
              ]
            },
            "logisticPartId": {
              "title": "LSAS part ID",
              "description": "GL/bulky items: ID for the part/packing unit based on item - size - part (LSAS)",
              "type": "string",
              "examples": [
                "58785132"
              ]
            },
            "partNumber": {
              "title": "part number (bulky items)",
              "description": "part number for specific packing unit (bulky items)",
              "type": "integer",
              "maximum": 999,
              "examples": [
                2
              ]
            },
            "numberOfParts": {
              "title": "number of all parts",
              "description": "number of all parts for this item (bulky items)",
              "type": "integer",
              "maximum": 999,
              "examples": [
                4
              ]
            }
          },
          "anyOf": [
            {
              "description": "PL booking or multi part result booking (bulky items) based on item size for CORE",
              "required": [
                "itemNumber",
                "itemSize",
                "numberOfParts"
              ]
            },
            {
              "description": "part booking (bulky items) based on item size and part to Humpback",
              "required": [
                "itemNumber",
                "itemSize",
                "partNumber",
                "numberOfParts"
              ]
            },
            {
              "description": "resulting bulky item booking multipart items for CORE",
              "required": [
                "logisticProductId",
                "numberOfParts"
              ]
            },
            {
              "description": "PL booking or bulky item part booking",
              "required": [
                "logisticProductId",
                "logisticPartId",
                "numberOfParts"
              ]
            }
          ]
        },
        "stockInfo": {
          "type": "object",
          "title": "Stock Info Wms",
          "description": "the information for booking related warehouses, filled dependent on event type",
          "properties": {
            "sourceLocation": {
              "title": "source location",
              "description": "the source location for the booking",
              "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/warehouselocations.v1.schema.json"
            },
            "destinationLocation": {
              "title": "destination location",
              "description": "the destination location for the booking",
              "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/warehouselocations.v1.schema.json"
            }
          },
          "minProperties": 1,
          "additionalProperties": false
        },
        "movementInfo": {
          "title": "Movement Info Wms",
          "description": "movement/booking informations",
          "type": "object",
          "properties": {
            "quantity": {
              "title": "quantity",
              "description": "quantity to be booked, in case of goods receipt the delivery note original quantity for this detail, in case of goods receipt release booking the released quantity for this detail",
              "type": "integer",
              "minimum": 1,
              "maximum": 9999999999,
              "examples": [
                2
              ]
            },
            "movementInfoDetails": {
              "title": "Movement Info Details Wms",
              "description": "Detailed Info about the movement, also used for deprecated data for old systems",
              "type": "object",
              "properties": {
                "documentNumber": {
                  "title": "document number",
                  "description": "Depending on type, in case of goods release booking then receiptDocumentNo (44xxx) from delivery, in case of return vendor sheet booking the rvsNumber (9x?xxx), otherwise other document numbers.",
                  "type": "integer",
                  "maximum": 9999999999,
                  "examples": [
                    973184
                  ]
                },
                "supplierNumber": {
                  "title": "supplier number",
                  "description": "Number of supplier, mandatory for goods release, return vendor sheet",
                  "type": "integer",
                  "maximum": 9999999999,
                  "examples": [
                    13901
                  ]
                },
                "externalReferenceView": {
                  "title": "External reference view",
                  "description": "External reference view - used in core as posting text",
                  "type": "string",
                  "maxLength": 50,
                  "examples": [
                    "Korrekturbuchung",
                    "449898"
                  ]
                },
                "customerCompany": {
                  "title": "customer company",
                  "description": "Company of the customer account. For example: SON - LDG Großkunden mit Belegnummer",
                  "type": "integer",
                  "maximum": 9999999999,
                  "examples": [
                    68
                  ]
                },
                "purchaseOrderNumber": {
                  "title": "purchase order number",
                  "description": "purchase order number (sent from SON for goods released bookings, ordernumber OVA)",
                  "type": "string",
                  "examples": [
                    "11887"
                  ]
                },
                "externalReference": {
                  "title": "external reference",
                  "description": "externalReference - Cobra - Unigro reference ano from unigro order",
                  "type": "string",
                  "examples": [
                    "364277"
                  ]
                },
                "goodsInId": {
                  "title": "goods in id",
                  "description": "unique id of a goods receipt see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/",
                  "type": "string",
                  "maxLength": 36,
                  "examples":["123"]
                },
                "buaid": {
                  "title": "buaid",
                  "description": "bi unique article ID, unique identification of an individual unit in the logistical process",
                  "type": "string",
                  "maxLength": 50,
                  "examples":["2344545-334542-465g45ddf"]
                },
                "returnKey": {
                  "title": "returnKey",
                  "description": "returnKey",
                  "type": "string",
                  "maxLength": 500,
                  "examples":["2344545-334542-465g45ddf"]
                },
                "b2bOrderId": {
                  "title": "b2b Order Id",
                  "description": "ERP Order Id - for stock transfers ordered from ERP",
                  "type": "string",
                  "maxLength": 36,
                  "examples": [
                    "390c4228-20b9-11ed-861d-0242ac120002"
                  ]
                },
                "loadingNumber": {
                  "description": "generated per sender; generation specification from OTTO, unique within 13 years for stock transfers",
                  "type": "string",
                  "maxLength": 12,
                  "title": "Loading Number",
                  "examples": [
                    "784414470093"
                  ]
                },
                "merchantErpIdentifier": {
                  "title": "merchant erp identifier",
                  "description": "enums that specifies the merchant erp that generated the orders",
                  "type": "string",
                  "enum": [
                    "DEEP_SEA_CORMORANT",
                    "CORE",
                    "B2B_DEEP_SEA_CORMORANT",
                    "B2B_CORE"
                  ],
                  "maxLength": 30
                },
                "merchantSingleItemId": {
                 "title": "merchant single item Id",
                  "description": "single item id for orders used in merchant erp",
                  "type": "string",
                  "maxLength": 255,
                  "examples": [
                    "390c4228-20b9-11ed-861d-0242ac120002"
                  ]
                },
                "stockTransferType": {
                    "title": "stock transfer type",
                    "description": "additional transfer type information for stock transfers",
                    "type": "string",
                    "maxLength": 50,
                    "enum": [
                        "UMF",
                        "WRS_WE",
                        "WRS_L",
                        "IWA_WE",
                        "IWA_M",
                        "GKD"
                    ]
                },
                "orderPart": {
                  "title": "order part",
                  "description": "number of the attempt to reserve or check the stock for orders - starts with zero",
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 999999999,
                  "examples": [
                    1
                  ]
                },
                "stockType": {
                  "title": "stock type",
                  "description": "stockType for B2B orders which indicates from which stock the order has to be fulfilled",
                  "type": "string",
                  "maxLength": 50,
                  "enum": [
                    "AVAILABLE",
                    "LOCKED"
                  ]
                },
                "lockTypeCode": {
                  "title": "lock type code",
                  "description": "lock type code from wms for locked stock which can also differentiate between the locked stock types used in B2B order bookings",
                  "type": "string",
                  "maxLength": 50
                },
                "returnOrderUUID": {
                  "title": "returnOrderUUID",
                  "description": "the UID of the associated return order contract, can be a UUID4",
                  "type": "string",
                  "maxLength": 100,
                  "examples":["b1eb5758-b9b5-43b9-a92f-142be61f73f1"]
                },
                "originalGoodsInId": {
                  "title": "original goods in id",
                  "description": "unique id of the original goods receipt for a goods in from rework see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/",
                  "type": "string",
                  "maxLength": 36,
                  "examples":["123"]
                },
                "b2bShipmentType": {
                  "title": "b2b shipment type",
                  "description": "the shipment type for b2b orders - UMF for stock transfer to another warehouse (with known subtypes in stockTransferType) or GKD for real major customer orders, mandatory for b2b order bookings, null for B2C",
                  "type": "string",
                  "maxLength": 30,
                  "enum": [
                    "UMF",
                    "GKD"
                  ]
                }
              },
              "minProperties": 1
            }
          },
          "required": [
            "quantity"
          ]
        }
      },
      "required": [
        "sourceTimestamp",
        "location",
        "product",
        "movementInfo",
        "stockInfo"
      ]
    }
  },
  "required": [
    "eventId",
    "traceId",
    "eventTime",
    "version",
    "context",
    "eventType",
    "metaData",
    "data"
  ],
  "examples": [
    {
      "eventId": "4f02ed14-db77-4fc8-a7da-98620f2ea5e7",
      "traceId": "a2b9691c-95a8-4f8e-80c3-fefa05f058df",
      "version": "2.6",
      "eventType": "GOODS_RECEIPT_QS_UNAUDITED_STOCK",
      "context": "STOCKPOSTING",
      "eventTime": "2021-05-31T18:45:47.123333Z",
      "metaData": {
        "client": "FBO",
        "sender": "RETAILSCHICHT",
        "instance": "SONNEFELD"
      },
      "data": {
        "sourceTimestamp": "2021-05-31T18:45:47Z",
        "creationType":"AUTOMATIC",
        "location": "SONNEFELD",
        "product": {
          "communicationKey": 731306093,
          "itemNumber": 14461216,
          "itemSize": 0,
          "numberOfParts": 1
        },
        "stockInfo": {
          "destinationLocation": "SONNEFELD"
        },
        "movementInfo": {
          "quantity": 4,
          "movementInfoDetails": {
            "documentNumber": 453756,
            "supplierNumber": 83224,
            "purchaseOrderNumber": "11887"
          }
        }
      }
    },
    {
      "eventId": "4f02ed14-db77-4fc8-a7da-98620f2ea5e7",
      "traceId": "a2b9691c-95a8-4f8e-80c3-fefa05f058df",
      "version": "2.6",
      "eventType": "DELIVERABLE_STOCK_MINUS",
      "context": "STOCKPOSTING",
      "eventTime": "2021-05-31T18:45:47.123333Z",
      "metaData": {
        "client": "FBO",
        "sender": "COBRA",
        "instance": "OHRDRUF"
      },
      "data": {
        "sourceTimestamp": "2021-05-31T18:45:47Z",
        "location": "OHRDRUF",
        "product": {
          "logisticProductId": "990167111",
          "logisticPartId": "29905444",
          "partNumber": 2,
          "numberOfParts": 1
        },
        "stockInfo": {
          "sourceLocation": "LANGENSELBOLD"
        },
        "movementInfo": {
          "quantity": 4,
          "movementInfoDetails": {
            "documentNumber": 93000,
            "supplierNumber": 13901
          }
        }
      }
    },
    {
      "eventId": "4f02ed14-db77-4fc8-a7da-98620f2ea5e7",
      "traceId": "a2b9691c-95a8-4f8e-80c3-fefa05f058df",
      "version": "2.6",
      "eventType": "DELIVERABLE_STOCK_TO_STOCK_IN_TRANSIT",
      "context": "STOCKPOSTING",
      "eventTime": "2021-05-31T18:45:47.123333Z",
      "metaData": {
        "client": "FBO",
        "sender": "COBRA",
        "instance": "OHRDRUF"
      },
      "data": {
        "sourceTimestamp": "2021-05-31T18:45:47Z",
        "location": "OHRDRUF",
        "product": {
          "logisticProductId": "990167111",
          "numberOfParts": 2
        },
        "stockInfo": {
          "sourceLocation": "OHRDRUF",
          "destinationLocation": "LANGENSELBOLD"
        },
        "movementInfo": {
          "quantity": 4,
          "movementInfoDetails": {
            "documentNumber": 93000,
            "supplierNumber": 13901
          }
        }
      }
    },
    {
      "eventId": "fa6c72ab-ccdd-4d0e-b075-1117b4340320",
      "traceId": "d2123101-0a0b-4142-ae43-9ea1a4b90fcc",
      "eventTime": "2022-04-21T14:57:14.641+00:00",
      "version": "2.6",
      "context": "STOCKPOSTING",
      "eventType": "OUTGOING_GOODS_CUSTOMER_LOCKED_STOCK",
      "metaData": {
        "sender": "COBRA",
        "instance": "LOEHNE_CP",
        "client": "FBO"
      },
      "data": {
        "sourceTimestamp": "2022-04-21T14:57:14.641+00:00",
        "location": "LOEHNE_CP",
        "product": {
          "itemNumber": 613527,
          "itemSize": 0,
          "communicationKey": 391080499,
          "numberOfParts": 1
        },
        "stockInfo": {
          "sourceLocation": "LOEHNE_CP"
        },
        "movementInfo": {
          "quantity": 1,
          "movementInfoDetails": {
            "documentNumber": 647300,
            "externalReferenceView": "647300",
            "externalReference": "371520"
          }
        }
      }
    },
    {
      "eventId": "7d2d2832-18fa-4be1-9a75-d30629f89c12",
      "traceId": "75dd30a4-3326-4784-aa80-4c9b2307923a",
      "eventTime": "2022-04-21T14:57:17.284+00:00",
      "version": "2.6",
      "context": "STOCKPOSTING",
      "eventType": "GOODS_RECEIPT",
      "metaData": {
        "sender": "COBRA",
        "instance": "OHRDRUF",
        "client": "FBO"
      },
      "data": {
        "sourceTimestamp": "2022-04-21T14:57:17.284+00:00",
        "location": "OHRDRUF",
        "product": {
          "itemNumber": 58155821,
          "itemSize": 0,
          "communicationKey": 711193650,
          "numberOfParts": 1
        },
        "stockInfo": {
          "destinationLocation": "OHRDRUF"
        },
        "movementInfo": {
          "quantity": 1,
          "movementInfoDetails": {
            "documentNumber": 404985,
            "supplierNumber": 81792,
            "externalReferenceView": "404985"
          }
        }
      }
    },
    {
      "eventId": "0e16cd1b-ad2d-4230-bc6d-853b4ef9c651",
      "traceId": "8e544e45-2c71-4925-934f-c5a5f2eb1eb0",
      "eventTime": "2022-04-21T14:57:18.429+00:00",
      "version": "2.6",
      "context": "STOCKPOSTING",
      "eventType": "LOCKED_STOCK_TO_DELIVERABLE_STOCK",
      "metaData": {
        "sender": "COBRA",
        "instance": "OHRDRUF",
        "client": "FBO"
      },
      "data": {
        "sourceTimestamp": "2022-04-21T14:57:18.429+00:00",
        "location": "OHRDRUF",
        "product": {
          "itemNumber": 27703966,
          "itemSize": 0,
          "communicationKey": 1381743776,
          "numberOfParts": 1
        },
        "stockInfo": {
          "sourceLocation": "OHRDRUF_RT",
          "destinationLocation": "OHRDRUF"
        },
        "movementInfo": {
          "quantity": 1
        }
      }
    },
    {
      "eventId": "0e133d1b-ad2d-4230-bc6d-853b4ef9c651",
      "traceId": "8e533e45-2c71-4925-934f-c5a5f2eb1eb0",
      "eventTime": "2023-11-17T14:57:18.429+00:00",
      "version": "2.6",
      "context": "STOCKPOSTING",
      "eventType": "IN_FULFILLMENT_CUSTOMER",
      "metaData": {
        "sender": "KMOTION_ILO",
        "instance": "ILOWA",
        "client": "FBO"
      },
      "data": {
        "sourceTimestamp": "2022-04-21T14:57:18.429+00:00",
        "location": "ILOWA",
        "product": {
          "itemNumber": 27703966,
          "itemSize": 0,
          "logisticProductId": "1381743776",
          "logisticPartId": "34345555",
          "partNumber": 1,
          "numberOfParts": 1
        },
        "stockInfo": {
          "sourceLocation": "ILOWA",
          "destinationLocation": "ILOWA"
        },
        "movementInfo": {
          "quantity": 1,
          "movementInfoDetails": {
              "buaid":"ed5807dd-c141-4b91-9f76-b6cbfa41cb73",
              "merchantErpIdentifier": "DEEP_SEA_CORMORANT",
              "merchantSingleItemId": "390c4228-20b9-11ed-861d-0242ac120002"
          }
        }
      }
    },
    {
      "eventId": "1e133d1b-ad2d-4230-bc6d-853b4ef9c651",
      "traceId": "7e533e45-2c71-4925-934f-c5a5f2eb1eb0",
      "eventTime": "2023-11-17T14:57:18.429+00:00",
      "version": "2.6",
      "context": "STOCKPOSTING",
      "eventType": "RESERVATION_OK",
      "metaData": {
        "sender": "KMOTION_ILO",
        "instance": "ILOWA",
        "client": "FBO"
      },
      "data": {
        "sourceTimestamp": "2022-04-21T14:57:18.429+00:00",
        "location": "ILOWA",
        "product": {
          "itemNumber": 27703966,
          "itemSize": 0,
          "logisticProductId": "1381743776",
          "logisticPartId": "34345555",
          "partNumber": 1,
          "numberOfParts": 1
        },
        "stockInfo": {
          "sourceLocation": "ILOWA",
          "destinationLocation": "ILOWA"
        },
        "movementInfo": {
          "quantity": 1,
          "movementInfoDetails": {
              "buaid": "ed5807dd-c141-4b91-9f76-b6cbfa41cb73",
              "orderPart": 0,
              "stockTransferType": "WRS_WE",
              "stockType": "LOCKED",
              "lockTypeCode": "QCSRET"
          }
        }
      }
    },
    {
      "eventId": "1e133d1b-ad2d-4230-bc6d-853b4ef9c651",
      "traceId": "3e533e45-2c71-4925-934f-c5a5f2eb1eb0",
      "eventTime": "2023-11-17T14:57:18.429+00:00",
      "version": "2.6",
      "context": "STOCKPOSTING",
      "eventType": "RETURNS_MANUAL_STORAGE",
      "metaData": {
        "sender": "KMOTION_GHM",
        "instance": "GERNSHEIM",
        "client": "TAZZIO"
      },
      "data": {
        "sourceTimestamp": "2022-04-21T14:57:18.429+00:00",
        "location": "GERNSHEIM",
        "product": {
          "itemNumber": 27703966,
          "itemSize": 0,
          "logisticProductId": "1381743776",
          "logisticPartId": "34345555",
          "partNumber": 1,
          "numberOfParts": 1
        },
        "stockInfo": {
          "sourceLocation": "GERNSHEIM",
          "destinationLocation": "GERNSHEIM"
        },
        "movementInfo": {
          "quantity": 1,
          "movementInfoDetails": {
              "buaid":"ed5807dd-c141-4b91-9f76-b6cbfa41cb73",
              "returnKey":"12345678886",
              "returnOrderUUID": "394c4228-20b9-11ed-861d-0242ac120002",
              "stockType":"AVAILABLE"
          }
        }
      }
    },
    {
      "eventId":"f1f9c1bd-974f-4c43-b15a-609ffcfe6c19",
      "traceId":"f1f9c1bd-974f-4c43-b15a-609ffcfe6c19",
      "eventTime":"2024-11-28T14:30:01.227+01:00",
      "version":"2.6",
      "context":"STOCKPOSTING",
      "eventType":"OUTGOING_GOODS",
      "metaData":{
        "sender":"KMOTION_ILO",
        "instance":"ILOWA",
        "client":"FBO"
      },
      "data":{
        "sourceTimestamp":"2024-11-28T14:30:00.000+01:00",
        "location":"ILOWA",
        "erpSnapshotId":3268.0,
        "product":{
          "itemNumber":10000239,
          "itemSize":908,
          "logisticProductId":"149860236",
          "partNumber":1,
          "numberOfParts":1
        },
        "stockInfo":{
          "sourceLocation":"ILOWA",
          "destinationLocation":"HALDENSLEBEN"
        },
        "movementInfo":{
          "quantity":4,
          "movementInfoDetails":{
            "documentNumber":123456,
            "supplierNumber":10010,
            "b2bOrderId":"827410101",
            "loadingNumber":"227000004333",
            "stockTransferType":"GKD",
            "orderPart":1,
            "stockType":"AVAILABLE",
            "lockTypeCode":"------",
            "merchantErpIdentifier": "B2B_DEEP_SEA_CORMORANT",
            "merchantSingleItemId": "494c4228-20b9-11ed-861d-0242ac120123",
            "b2bShipmentType": "UMF"
          }
        }
      }
    }
  ]
}

4.2. Direction FINE to ERP

4.2.1. Header

This interface uses the Service Header

Special expression for this interface:

Table 8. Attribute
Fieldname Expresion

type

context

STOCKPOSTING

4.2.2. Data model

Property Type Description

(Root)

object

Stock Booking Erp Message
This document describes the booking messages that FINE sends to the client specific erp.

    eventId*

string (uuid)

The unique eventId
Global unique Id - JAVA UUID4 for the event generated by the actual producer. Use pattern: '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$'

    traceId*

string (uuid)

UUID for all events in a call hierarchy - trace
ID of the trace, will be generated by the first producer of the process. The ID will be the same for all events in the context of this process, also over system boundaries. The ID is equal to the eventId, if it is the first event. It's like a order number, the will used for all activities around the order.

    spanId

string (uuid)

The eventId of previous record or batchId
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)

    eventTime*

string (date-time)

Time of occurrence of the event
Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC

    version*

string

The number of version of schema
Number of version of this data structure. A sematic specification with major & minor version numbers

Maximum Length: 6
Regular expression: \d+\.\d{1,2}

    context*

string (enum)

context
The optional context specified here means the business domain. here STOCKPOSTING

Any of: [ "STOCKPOSTING" ]
Maximum Length: 50

    eventType*

string (enum)

event type
Event type (business transaction), that can be related to booking types

Any of: [ "GOODS_RECEIPT", "REVERSE_INBOUND", "DELIVERABLE_STOCK_MINUS", "DELIVERABLE_STOCK_PLUS", "DELIVERABLE_STOCK_TO_LOCKED_STOCK", "DELIVERABLE_STOCK_TO_STOCK_DIFFERENCE", "DELIVERABLE_STOCK_TO_STOCK_IN_TRANSIT", "LOCKED_STOCK_MINUS", "LOCKED_STOCK_PLUS", "LOCKED_STOCK_TO_DELIVERABLE_STOCK", "LOCKED_STOCK_TO_QUALITY_LOCKED_STOCK", "LOCKED_STOCK_TO_STOCK_IN_TRANSIT", "STOCK_DIFFERENCE_TO_DELIVERABLE_STOCK", "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK", "GOODS_RECEIPT_LOCKED_STOCK", "GOODS_RECEIPT_LOCKED_STOCK_CANCELED", "INVENTORY_DIFFERENCE", "INVENTORY_DIFFERENCE_CANCELED", "OUTGOING_GOODS_CUSTOMER_LOCKED_STOCK", "QUALITY_LOCKED_STOCK_CHANNEL_BOOKING", "QUALITY_LOCKED_STOCK_TO_CREDIT_THIRD_PARTY_SALE", "QUALITY_LOCKED_STOCK_TO_LOCKED_STOCK", "QUALITY_LOCKED_STOCK_TO_STOCK_DIFFERENCE", "QUALITY_LOCKED_STOCK_TO_STOCK_IN_TRANSIT", "QUALITY_LOCKED_STOCK_TO_TOTAL_LOSS", "QUALITY_LOCKED_STOCK_TO_TREASURE_DROVE", "REVERSE_INBOUND_RETURNS", "REVERSE_INBOUND_RETURNS_CANCELED", "STOCK_DIFFERENCE_TO_QUALITY_LOCKED_STOCK", "STOCK_IN_TRANSIT_TO_LOCKED_STOCK", "STOCK_IN_TRANSIT_TO_QUALITY_LOCKED_STOCK", "STOCK_DIFFERENCE_TO_STOCK_IN_TRANSIT", "STOCK_IN_TRANSIT_TO_STOCK_DIFFERENCE", "LOCKED_STOCK_TO_RETURNS", "TRANSIT_LOCKED_STOCK_MINUS", "TRANSIT_LOCKED_STOCK_TO_LOCKED_STOCK", "WAREHOUSE_DAMAGE", "WAREHOUSE_DAMAGE_CANCELED", "DELIVERABLE_STOCK_TO_QUALITY_LOCKED_STOCK", "DELIVERABLE_STOCK_TO_RESERVED_SHIPPING_STOCK", "GOODS_RECEIPT_QS_UNAUDITED_STOCK", "GOODS_RECEIPT_QUALITY_LOCKED_STOCK", "GOODS_RECEIPT_STOCK_DIFFERENCE", "INVENTORY_DIFFERENCE_DELIVERABLE_STOCK", "INVENTORY_DIFFERENCE_STOCK_DIFFERENCE", "IWA_STOCK_DIFFERENCE", "OUTGOING_GOODS_CUSTOMER_CANCEL", "OUTGOING_GOODS_CUSTOMER_STOCK_DIFFERENCE", "QS_UNAUDITED_STOCK_GOODS_RECEIPT", "QS_UNAUDITED_STOCK_TO_DELIVERABLE_STOCK", "QUALITY_LOCKED_STOCK_GOODS_RECEIPT", "QUALITY_LOCKED_STOCK_INVENTORY_DIFFERENCE", "QUALITY_LOCKED_STOCK_IWA", "QUALITY_LOCKED_STOCK_RAS_RES", "QUALITY_LOCKED_STOCK_TO_DELIVERABLE_STOCK", "RAS_RES_STOCK_DIFFERENCE", "RESERVABLE_LOCKED_STOCK_TO_DELIVERABLE_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_DELIVERABLE_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_STOCK_DIFFERENCE", "RESERVABLE_STOCK_IN_TRANSIT_TO_RESERVABLE_LOCKED_STOCK", "RESERVED_SHIPPING_STOCK_DELIVERABLE_STOCK", "RESERVED_SHIPPING_STOCK_INVENTORY_DIFFERENCE", "RESERVED_SHIPPING_STOCK_OUTGOING_GOODS_CUSTOMER", "STOCK_DIFFERENCE_INVENTORY", "STOCK_DIFFERENCE_OUTGOING_GOODS", "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK_H162", "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK_H46", "STOCK_IN_TRANSIT_TO_RESERVED_SHIPPING_STOCK", "TOTAL_LOSS_LOCKED_STOCK", "TOTAL_LOSS_STOCK_DIFFERENCE", "DELIVERABLE_STOCK_INVENTORY_DIFFERENCE", "DELIVERABLE_STOCK_TO_RESERVABLE_LOCKED_STOCK", "RESERVABLE_LOCKED_STOCK_TO_RESERVABLE_STOCK_IN_TRANSIT", "GOODS_RECEIPT_TOTAL_LOSS", "RETURNS_MANUAL_STORAGE", "RETURNS_AUTOMATIC_STORAGE", "TRANSFER_MANUAL_STORAGE", "TRANSFER_AUTOMATIC_STORAGE", "REVERSE_INBOUND_MANUAL_STORAGE", "REVERSE_INBOUND_AUTOMATIC_STORAGE", "STOCK_AVAILABILITY_CHECK_NOK", "INVENTORY_DIFFERENCE_ERP_STOCK", "IN_FULFILLMENT_MISSING", "HIGH_LEVEL_RESERVATION_OK", "RESERVATION_OK", "IN_FULFILLMENT_CUSTOMER", "IN_FULFILLMENT_MANUAL_SUBSTITUTION", "IN_FULFILLMENT_B2B", "IN_FULFILLMENT_QUALITY_LOCKED", "HIGH_LEVEL_RESERVATION_NOK", "RESERVATION_NOK", "INVENTORY_DIFFERENCE_ERP_STOCK_MEANWHILE_REDUCED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND", "OUTGOING_GOODS", "OUTGOING_GOODS_CUSTOMER", "OUTGOING_GOODS_TRANSFER", "OUTGOING_GOODS_B2B", "INVENTORY_DIFFERENCE_COMMON", "INVENTORY_PLUS_DIFFERENCE", "GOODS_RECEIPT_QUALITY_LOCKED", "GOODS_RECEIPT_QUALITY_CHECK_APPROVED", "GOODS_RECEIPT_RETURN", "INVENTORY_LOCK", "INVENTORY_LOCK_QUALITY_LOCKED", "INVENTORY_CHECK_FINAL", "INVENTORY_CHECK_FINAL_QUALITY_LOCKED", "IN_FULFILLMENT_CANCEL", "IN_FULFILLMENT_CANCEL_QUALITY_LOCKED", "TRANSFER_TRANSIT_BACK_TO_SOURCE", "INVENTORY_TRANSFER_TRANSIT", "RETURNS_TRANSIT_BACK_TO_SOURCE", "INVENTORY_RETURNS_TRANSIT", "DELIVERABLE_STOCK_PLUS_TEST", "DELIVERABLE_STOCK_MINUS_TEST", "QUALITY_LOCKED_STOCK_PLUS_TEST", "QUALITY_LOCKED_STOCK_MINUS_TEST", "STOCK_IN_FULFILLMENT_PLUS_TEST", "STOCK_IN_FULFILLMENT_MINUS_TEST", "INVENTORY_PLUS_DIFFERENCE_INVENTORY_LOCKED", "LOCKING_STOCK", "UNLOCKING_STOCK", "GOODS_RECEIPT_FROM_REWORK", "INVENTORY_MINUS_DIFFERENCE", "INVENTORY_PLUS_DIFFERENCE_QUALITY_LOCKED", "INVENTORY_MINUS_DIFFERENCE_QUALITY_LOCKED", "IN_FULFILLMENT_RESERVATION_CANCEL", "IN_FULFILLMENT_CANCEL_CUSTOMER", "IN_FULFILLMENT_CANCEL_B2B", "IN_FULFILLMENT_RESERVATION_CANCEL_CUSTOMER", "IN_FULFILLMENT_RESERVATION_CANCEL_B2B", "IN_FULFILLMENT_RESERVATION_CANCEL_QUALITY_LOCKED", "RESERVE_REPLENISHMENT", "UNRESERVE_REPLENISHMENT", "TRANSFER_MANUAL_STORAGE_QUALITY_LOCKED", "TRANSFER_AUTOMATIC_STORAGE_QUALITY_LOCKED", "IN_FULFILLMENT_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_MANUAL_SUBSTITUTION_B2B", "IN_FULFILLMENT_MANUAL_SUBSTITUTION_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK_B2B", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT_B2B", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK_B2B", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND_B2B", "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_CANCEL_B2B_QUALITY_LOCKED", "IN_FULFILLMENT_RESERVATION_CANCEL_B2B_QUALITY_LOCKED", "OUTGOING_GOODS_TRANSFER_B2B", "OUTGOING_GOODS_TRANSFER_B2B_QUALITY_LOCKED", "OUTGOING_GOODS_B2B_QUALITY_LOCKED", "INVENTORY_DIFFERENCE_INVENTORY_LOCKED", "LOCKED_STOCK_TO_STOCK_DIFFERENCE", "QUALITY_LOCKED_STOCK_TO_RESERVABLE_LOCKED_STOCK", "QUALITY_LOCKED_STOCK_TO_RESERVABLE_STOCK_IN_TRANSIT", "RESERVABLE_LOCKED_STOCK_TO_QUALITY_LOCKED_STOCK", "RESERVABLE_LOCKED_STOCK_TO_STOCK_DIFFERENCE", "RESERVABLE_STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_TO_QUALITY_LOCKED_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_TO_STOCK_DIFFERENCE", "STOCK_DIFFERENCE_TO_LOCKED_STOCK", "RESERVABLE_STOCK_IN_TRANSIT_TO_LOCKED_STOCK" ]
Maximum Length: 100

    metaData*

object

additional meta data
additional meta information for booking interface

        sender*

string (enum)

sender
Name of the source system, that has sent this message.

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" ]

        instance*

string (enum)

instance of producer
instance of the application or warehouse context

Any of: [ "LANGENSELBOLD", "OHRDRUF", "LOEHNE", "ANSBACH", "MOSINA", "HALDENSLEBEN", "HALDENSLEBEN_RSS", "SUEDHAFEN", "ALTENKUNSTADT", "SONNEFELD", "ERFURT", "GERNSHEIM", "ILOWA", "LOEHNE_CP" ]
Maximum Length: 30

        client*

string

client
Client/mandant (messages of different clients have different processing rules and destination interfaces) - use FBO for Fulfillment by Otto (CORE, DeepSea…​)

Maximum Length: 50

        sourceIdentifier*

string (enum)

source identifier
identifies the source system of the bookings, mapped from sender and instance of the origin wms booking message in fine bube

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" ]

    data*

object

Data Erp
Data of the JSON message

        sourceTimestamp*

string (date-time)

the booking timestamp
Booking timestamp UTC+ISO-8601 format

        creationType

string (enum)

creation type
identifies specific creation conditions if necessary, in first version only automatic and manual bookings are used for stock journal

Any of: [ "AUTOMATIC", "MANUAL" ]

        location*

string (enum)

the location where where the event was created
the location where the event was created, warehouse that emits the booking

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" ]

        erpSnapshotId

number

the id of the following inventory snapshot
Consecutive number (sequence) of a long number. each inventory snapshot gets its own ID, which is identical for all records of the snapshot. all bookings get the id of the following snapshot

Maximum Length: 18
Minimum: 1
Maximum: 1000000000000000000

        product*

object

Product Erp
product related information to identify the product and part

            itemNumber

integer

item number
item number (article data) - used for old systems

Maximum: 9999999999

            itemSize

integer

item size
Numeric item size (article data) - used for old systems

Maximum: 99999

            erpProductId

string

ERP product ID
ERP product ID - the id of the product in erp received from LSAS

            erpPartId

string

ERP part ID
GL/bulky items: ID for the part/packing unit based on item - size - part from ERP (LSAS gets it from MOLA)

            partNumber

integer

part number (bulky items)
part number for specific packing unit (bulky items)

Maximum: 999

            numberOfParts

integer

number of all parts
number of all parts for this item (bulky items)

Maximum: 999

        stockInfo*

object

Stock Info Erp
the information for booking related warehouses, filled dependent on event type

Additional Properties: false

            sourceLocation

object

source location
the source location structure for the booking

                location

string (enum)

location
source location of booking

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" ]

            destinationLocation

object

destination location
the destination location for the booking

                location

string (enum)

location
destination location of booking

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" ]

        movementInfo*

object

Movement Info Erp
movement/booking informations

            quantity*

integer

quantity
quantity to be booked, in case of goods receipt the delivery note original quantity for this detail, in case of goods receipt release booking the released quantity for this detail

Minimum: 1
Maximum: 9999999999

            movementInfoDetails

object

Movement Info Details Erp
Detailed Info about the movement, also used for deprecated data for old systems

                documentNumber

integer

document number
Depending on type, in case of goods release booking then receiptDocumentNo (44xxx) from delivery, in case of return vendor sheet booking the rvsNumber (9x?xxx), otherwise other document numbers.

Maximum: 9999999999

                supplierNumber

integer

supplier number
Number of supplier, mandatory for goods release, return vendor sheet

Maximum: 9999999999

                externalReferenceView

string

External reference view
External reference view - used in core as posting text

Maximum Length: 50

                customerCompany

integer

customer company
Company of the customer account. For example: SON - LDG Großkunden mit Belegnummer

Maximum: 9999999999

                purchaseOrderNumber

string

purchase order number
purchase order number (sent from SON for goods released bookings, ordernumber OVA)

                externalReference

string

external reference
externalReference - Cobra - Unigro reference ano from unigro order

                goodsInId

string

goods in id
unique id of a goods receipt see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/

Maximum Length: 36

                buaid

string

buaid
bi unique article ID, unique identification of an individual unit in the logistical process

Maximum Length: 50

                returnKey

string

returnKey
returnKey

Maximum Length: 500

                b2bOrderId

string

b2b Order Id
ERP Order Id - for stock transfers ordered from ERP

Maximum Length: 36

                loadingNumber

string

Loading Number
generated per sender; generation specification from OTTO, unique within 13 years for stock transfers

Maximum Length: 12

                merchantErpIdentifier

string (enum)

merchant erp identifier
enums that specifies the merchant erp that generated the orders

Any of: [ "DEEP_SEA_CORMORANT", "CORE", "B2B_DEEP_SEA_CORMORANT", "B2B_CORE" ]
Maximum Length: 30

                merchantSingleItemId

string

merchant single item Id
single item id for orders used in merchant erp

Maximum Length: 255

                stockTransferType

string (enum)

stock transfer type
additional transfer type information for stock transfers

Any of: [ "UMF", "WRS_WE", "WRS_L", "IWA_WE", "IWA_M", "GKD" ]
Maximum Length: 50

                orderPart

integer

order part
number of the attempt to reserve or check the stock for orders - starts with zero

Minimum: 0
Maximum: 999999999

                stockType

string (enum)

stock type
stockType for B2B orders which indicates from which stock the order has to be fulfilled

Any of: [ "AVAILABLE", "LOCKED" ]
Maximum Length: 50

                lockTypeCode

string

lock type code
lock type code from wms for locked stock which can also differentiate between the locked stock types used in B2B order bookings

Maximum Length: 50

                returnOrderUUID

string

returnOrderUUID
the UID of the associated return order contract, can be a UUID4

Maximum Length: 100

                originalGoodsInId

string

original goods in id
unique id of the original goods receipt for a goods in from rework see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/

Maximum Length: 36

                b2bShipmentType

string (enum)

b2b shipment type
the shipment type for b2b orders - UMF for stock transfer to another warehouse (with known subtypes in stockTransferType) or GKD for real major customer orders, mandatory for b2b order bookings, null for B2C

Any of: [ "UMF", "GKD" ]
Maximum Length: 30

4.2.3. Enumeration

Field: EventType

Table 9. eventType
Meta Value Description Short Value

Field: StockTransferType

Table 10. stockTransferType
Meta Value Description

UMF

B2B order b2bShipmentType UMF for transfers

WRS_WE

B2B order b2bShipmentType UMF for returns to supplier from inbound process

WRS_L

B2B order b2bShipmentType UMF for returns to supplier from warehouse stock

IWA_WE

B2B order b2bShipmentType UMF for internal goods deduction (IWA) from inbound process

IWA_M

B2B order b2bShipmentType UMF for internal goods deductions (IWA) for samples

GKD

B2B order b2bShipmentType UMF for major customer/supply

Field: StockType

Table 11. stockType
Meta Value Description

AVAILABLE

B2B order fulfilled from deliverable/available stock

LOCKED

B2B order fulfilled from locked stock

Field: merchantErpIdentifier

Table 12. merchantErpIdentifier
Meta Value Description

DEEP_SEA_CORMORANT

Cormorant B2C orders

B2B_DEEP_SEA_CORMORANT

Cormorant B2B orders

CORE

Core B2C orders

B2B_CORE

Core B2C orders

Field: b2bShipmentType

Table 13. b2bShipmentType
Meta Value Description

UMF

B2B order for transfers

GKD

B2B order for major customer/supply

4.2.4. Example

Message FINE to ERP v2.6
{
  "eventId": "1e133d1b-ad2d-4230-bc6d-853b4ef9c651",
  "traceId": "3e533e45-2c71-4925-934f-c5a5f2eb1eb0",
  "eventTime": "2024-08-17T14:57:18.429+00:00",
  "version": "2.6",
  "context": "STOCKPOSTING",
  "eventType": "RETURNS_MANUAL_STORAGE",
  "metaData": {
    "sender": "BUBE",
    "instance": "GERNSHEIM",
    "client": "TAZZIO",
    "sourceIdentifier": "KMOTION_GHM"
  },
  "data": {
    "sourceTimestamp": "2024-08-17T14:57:18.429+00:00",
    "location": "GERNSHEIM",
    "product": {
      "itemNumber": 27703966,
      "itemSize": 0,
      "erpProductId": "1381743776",
      "erpPartId": "34345555",
      "partNumber": 1,
      "numberOfParts": 1
    },
    "stockInfo": {
      "sourceLocation": {
        "location": "GERNSHEIM"
      },
      "destinationLocation": {
        "location": "GERNSHEIM"
      }
    },
    "movementInfo": {
      "quantity": 1,
      "movementInfoDetails": {
        "buaid":"ed5807dd-c141-4b91-9f76-b6cbfa41cb73",
        "returnKey":"12345678886",
        "returnOrderUUID": "394c4228-20b9-11ed-861d-0242ac120002",
        "stockType":"AVAILABLE"
      }
    }
  }
}

4.2.5. Version history

Table 14. Version FINE to ERP

Version

Number

File

Published on

previous version

2.0

Download

05.03.23

previous version

2.1

Download

10.08.23

previous version

2.2

Download

02.04.24

previous version

2.3

Download

17.07.24

previous version

2.4

Download

30.08.24

previous version

2.5

Download

07.11.24

current version

2.6

Download

09.01.25

coming version

4.2.6. Changelog

Changes V1.0 ⇒ V2.0

  1. Standard header: The Standard header has been changed to the current standard header with following changes:

    • attributes "sender", "instance" and "client" has been moved to the new object type "metaData"

    • attribute "type" has been renamed to "eventType"

    • attributes "sourceIdentifier", "messageNumber" and "lastMessageNumber" has been removed

  2. Payload (Data)

    • new attribute "creationType" with values "AUTOMATIC" or "MANUAL" has been introduced

Changes V2.0 ⇒ V2.1

  1. Standard header

    • attribute "sender" is now linked to system.v7.schema.json

    • attribute "client" is now linked to company.v5.schema.json

    • new enums for eventType DELIVERABLE_STOCK_TO_RESERVABLE_LOCKED_STOCK and RESERVABLE_LOCKED_STOCK_TO_RESERVABLE_STOCK_IN_TRANSIT

    • attribute "version" has now type string

Changes V2.1 ⇒ V2.2

  1. Standard header

  2. Payload (Data)

    • new attributes "goodsInId" for referencing the goods in goods receipt bookings

    • new attribute "buaid"

    • new attributes for b2b order and stock transfer related bookings "b2bOrderId" and "loadingNumber"

    • new attributes for b2c order related bookings "merchantErpIdentifier" and "merchantSingleItemId"

    • new attribute "returnKey"

    • new attribute "stockTransferType" for B2B orders

    • new attribute "orderPart"

    • new attribute "stockType" indicating stock type of quant used for B2B orders

    • new attribute "lockTypeCode" for B2B orders on locked stock

    • new attribute "returnOrderUUID" for return order contract relations

Changes V2.2 ⇒ V2.3

  1. Standard header

    • new eventTypes

  2. Payload (Data)

    • new attributes "originalGoodsInId" for referencing the original goods in id for goods receipt bookings

Changes V2.3 ⇒ V2.4

  1. Standard header

    • new eventTypes for replenishment reservation

    • remove enum for company references in metaData.client, use only strings

Changes V2.4 ⇒ V2.5

  1. Standard header

    • set length of "eventType" to 100

    • new eventTypes for B2B processes and locked stock transfers

    • new eventTypes for KR1

Changes V2.5 ⇒ V2.6

  1. Standard header

    • new eventTypes for KR1

    • new attribute b2bShipmentType for separation of B2B order types for stock transfers and major customers

  2. Payload (Data)

    • new values for enum merchantErpIdentifier for B2B orders

4.2.7. Schema

Message FINE to ERP v2.6
{
  "$schema": "https://json-schema.org/draft-07/schema",
  "$comment": "Specification of booking messages that FINE sends to the client specific erp in version 2.6",
  "$id": "https://doc.fine.gcp.osp-dev.de/registry/Stock/StockBookingErp.v2.6.schema.json",
  "title": "Stock Booking Erp Message",
  "description": "This document describes the booking messages that FINE sends to the client specific erp.",
  "definitions": {
    "instance": {
      "type": "string",
      "enum": [
        "LANGENSELBOLD",
        "OHRDRUF",
        "LOEHNE",
        "ANSBACH",
        "MOSINA",
        "HALDENSLEBEN",
        "HALDENSLEBEN_RSS",
        "SUEDHAFEN",
        "ALTENKUNSTADT",
        "SONNEFELD",
        "ERFURT",
        "GERNSHEIM",
        "ILOWA",
        "LOEHNE_CP"
      ],
      "maxLength": 30
    }
  },
  "type": "object",
  "properties": {
    "eventId": {
      "title": "The unique eventId",
      "description": "Global unique Id - JAVA UUID4 for the event generated by the actual producer. Use pattern: '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$' ",
      "type": "string",
      "format": "uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "traceId": {
      "title": "UUID for all events in a call hierarchy - trace",
      "description": "ID of the trace, will be generated by the first producer of the process. The ID will be the same for all events in the context of this process, also over system boundaries. The ID is equal to the eventId, if it is the first event. It's like a order number, the will used for all activities around the order.",
      "type": "string",
      "format": "uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "spanId": {
      "title": "The eventId of previous record or batchId",
      "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)",
      "type": "string",
      "format": "uuid",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ]
    },
    "eventTime": {
      "title": "Time of occurrence of the event",
      "description":"Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC",
      "type": "string",
      "format": "date-time",
      "examples": [
        "2022-11-15T17:09:06.322+01:00",
        "2022-04-16T16:06:05.123Z"
      ]
    },
    "version": {
      "title":"The number of version of schema",
      "description":"Number of version of this data structure. A sematic specification with major & minor version numbers",
      "type":"string",
      "pattern":"\\d+\\.\\d{1,2}",
      "maxLength":6,
      "examples":[
        "1.1",
        "2.21",
        "12.1"
      ]
    },
    "context": {
      "title": "context",
      "description": "The optional context specified here means the business domain. here STOCKPOSTING",
      "type": "string",
      "enum": [
        "STOCKPOSTING"
      ],
      "maxLength": 50
    },
    "eventType": {
      "title": "event type",
      "description": "Event type (business transaction), that can be related to booking types",
      "type": "string",
      "enum": [
        "GOODS_RECEIPT",
        "REVERSE_INBOUND",
        "DELIVERABLE_STOCK_MINUS",
        "DELIVERABLE_STOCK_PLUS",
        "DELIVERABLE_STOCK_TO_LOCKED_STOCK",
        "DELIVERABLE_STOCK_TO_STOCK_DIFFERENCE",
        "DELIVERABLE_STOCK_TO_STOCK_IN_TRANSIT",
        "LOCKED_STOCK_MINUS",
        "LOCKED_STOCK_PLUS",
        "LOCKED_STOCK_TO_DELIVERABLE_STOCK",
        "LOCKED_STOCK_TO_QUALITY_LOCKED_STOCK",
        "LOCKED_STOCK_TO_STOCK_IN_TRANSIT",
        "STOCK_DIFFERENCE_TO_DELIVERABLE_STOCK",
        "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK",
        "GOODS_RECEIPT_LOCKED_STOCK",
        "GOODS_RECEIPT_LOCKED_STOCK_CANCELED",
        "INVENTORY_DIFFERENCE",
        "INVENTORY_DIFFERENCE_CANCELED",
        "OUTGOING_GOODS_CUSTOMER_LOCKED_STOCK",
        "QUALITY_LOCKED_STOCK_CHANNEL_BOOKING",
        "QUALITY_LOCKED_STOCK_TO_CREDIT_THIRD_PARTY_SALE",
        "QUALITY_LOCKED_STOCK_TO_LOCKED_STOCK",
        "QUALITY_LOCKED_STOCK_TO_STOCK_DIFFERENCE",
        "QUALITY_LOCKED_STOCK_TO_STOCK_IN_TRANSIT",
        "QUALITY_LOCKED_STOCK_TO_TOTAL_LOSS",
        "QUALITY_LOCKED_STOCK_TO_TREASURE_DROVE",
        "REVERSE_INBOUND_RETURNS",
        "REVERSE_INBOUND_RETURNS_CANCELED",
        "STOCK_DIFFERENCE_TO_QUALITY_LOCKED_STOCK",
        "STOCK_IN_TRANSIT_TO_LOCKED_STOCK",
        "STOCK_IN_TRANSIT_TO_QUALITY_LOCKED_STOCK",
        "STOCK_DIFFERENCE_TO_STOCK_IN_TRANSIT",
        "STOCK_IN_TRANSIT_TO_STOCK_DIFFERENCE",
        "LOCKED_STOCK_TO_RETURNS",
        "TRANSIT_LOCKED_STOCK_MINUS",
        "TRANSIT_LOCKED_STOCK_TO_LOCKED_STOCK",
        "WAREHOUSE_DAMAGE",
        "WAREHOUSE_DAMAGE_CANCELED",
        "DELIVERABLE_STOCK_TO_QUALITY_LOCKED_STOCK",
        "DELIVERABLE_STOCK_TO_RESERVED_SHIPPING_STOCK",
        "GOODS_RECEIPT_QS_UNAUDITED_STOCK",
        "GOODS_RECEIPT_QUALITY_LOCKED_STOCK",
        "GOODS_RECEIPT_STOCK_DIFFERENCE",
        "INVENTORY_DIFFERENCE_DELIVERABLE_STOCK",
        "INVENTORY_DIFFERENCE_STOCK_DIFFERENCE",
        "IWA_STOCK_DIFFERENCE",
        "OUTGOING_GOODS_CUSTOMER_CANCEL",
        "OUTGOING_GOODS_CUSTOMER_STOCK_DIFFERENCE",
        "QS_UNAUDITED_STOCK_GOODS_RECEIPT",
        "QS_UNAUDITED_STOCK_TO_DELIVERABLE_STOCK",
        "QUALITY_LOCKED_STOCK_GOODS_RECEIPT",
        "QUALITY_LOCKED_STOCK_INVENTORY_DIFFERENCE",
        "QUALITY_LOCKED_STOCK_IWA",
        "QUALITY_LOCKED_STOCK_RAS_RES",
        "QUALITY_LOCKED_STOCK_TO_DELIVERABLE_STOCK",
        "RAS_RES_STOCK_DIFFERENCE",
        "RESERVABLE_LOCKED_STOCK_TO_DELIVERABLE_STOCK",
        "RESERVABLE_STOCK_IN_TRANSIT_DELIVERABLE_STOCK",
        "RESERVABLE_STOCK_IN_TRANSIT_STOCK_DIFFERENCE",
        "RESERVABLE_STOCK_IN_TRANSIT_TO_RESERVABLE_LOCKED_STOCK",
        "RESERVED_SHIPPING_STOCK_DELIVERABLE_STOCK",
        "RESERVED_SHIPPING_STOCK_INVENTORY_DIFFERENCE",
        "RESERVED_SHIPPING_STOCK_OUTGOING_GOODS_CUSTOMER",
        "STOCK_DIFFERENCE_INVENTORY",
        "STOCK_DIFFERENCE_OUTGOING_GOODS",
        "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK_H162",
        "STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK_H46",
        "STOCK_IN_TRANSIT_TO_RESERVED_SHIPPING_STOCK",
        "TOTAL_LOSS_LOCKED_STOCK",
        "TOTAL_LOSS_STOCK_DIFFERENCE",
        "DELIVERABLE_STOCK_INVENTORY_DIFFERENCE",
        "DELIVERABLE_STOCK_TO_RESERVABLE_LOCKED_STOCK",
        "RESERVABLE_LOCKED_STOCK_TO_RESERVABLE_STOCK_IN_TRANSIT",
        "GOODS_RECEIPT_TOTAL_LOSS",
        "RETURNS_MANUAL_STORAGE",
        "RETURNS_AUTOMATIC_STORAGE",
        "TRANSFER_MANUAL_STORAGE",
        "TRANSFER_AUTOMATIC_STORAGE",
        "REVERSE_INBOUND_MANUAL_STORAGE",
        "REVERSE_INBOUND_AUTOMATIC_STORAGE",

        "STOCK_AVAILABILITY_CHECK_NOK",
        "INVENTORY_DIFFERENCE_ERP_STOCK",
        "IN_FULFILLMENT_MISSING",

        "HIGH_LEVEL_RESERVATION_OK",
        "RESERVATION_OK",
        "IN_FULFILLMENT_CUSTOMER",
        "IN_FULFILLMENT_MANUAL_SUBSTITUTION",
        "IN_FULFILLMENT_B2B",
        "IN_FULFILLMENT_QUALITY_LOCKED",
        
        "HIGH_LEVEL_RESERVATION_NOK",
        "RESERVATION_NOK",
        "INVENTORY_DIFFERENCE_ERP_STOCK_MEANWHILE_REDUCED",

        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND",

        "OUTGOING_GOODS",
        "OUTGOING_GOODS_CUSTOMER",
        "OUTGOING_GOODS_TRANSFER",
        "OUTGOING_GOODS_B2B",
        
        "INVENTORY_DIFFERENCE_COMMON",
        "INVENTORY_PLUS_DIFFERENCE",
        
        "GOODS_RECEIPT_QUALITY_LOCKED",
        "GOODS_RECEIPT_QUALITY_CHECK_APPROVED",
        "GOODS_RECEIPT_RETURN",
        
        "INVENTORY_LOCK",
        "INVENTORY_LOCK_QUALITY_LOCKED",
        "INVENTORY_CHECK_FINAL",
        "INVENTORY_CHECK_FINAL_QUALITY_LOCKED",
        "IN_FULFILLMENT_CANCEL",
        "IN_FULFILLMENT_CANCEL_QUALITY_LOCKED",

        "TRANSFER_TRANSIT_BACK_TO_SOURCE",
        "INVENTORY_TRANSFER_TRANSIT",
        "RETURNS_TRANSIT_BACK_TO_SOURCE",
        "INVENTORY_RETURNS_TRANSIT",

        "DELIVERABLE_STOCK_PLUS_TEST",
        "DELIVERABLE_STOCK_MINUS_TEST",
        "QUALITY_LOCKED_STOCK_PLUS_TEST",
        "QUALITY_LOCKED_STOCK_MINUS_TEST",
        "STOCK_IN_FULFILLMENT_PLUS_TEST",
        "STOCK_IN_FULFILLMENT_MINUS_TEST",
        
        "INVENTORY_PLUS_DIFFERENCE_INVENTORY_LOCKED",

        "LOCKING_STOCK",
        "UNLOCKING_STOCK",

        "GOODS_RECEIPT_FROM_REWORK",
        "INVENTORY_MINUS_DIFFERENCE",
        "INVENTORY_PLUS_DIFFERENCE_QUALITY_LOCKED",
        "INVENTORY_MINUS_DIFFERENCE_QUALITY_LOCKED",

        "IN_FULFILLMENT_RESERVATION_CANCEL",
        "IN_FULFILLMENT_CANCEL_CUSTOMER",
        "IN_FULFILLMENT_CANCEL_B2B",
        "IN_FULFILLMENT_RESERVATION_CANCEL_CUSTOMER",
        "IN_FULFILLMENT_RESERVATION_CANCEL_B2B",
        "IN_FULFILLMENT_RESERVATION_CANCEL_QUALITY_LOCKED",
        "RESERVE_REPLENISHMENT",
        "UNRESERVE_REPLENISHMENT",

        "TRANSFER_MANUAL_STORAGE_QUALITY_LOCKED",
        "TRANSFER_AUTOMATIC_STORAGE_QUALITY_LOCKED",
        
        "IN_FULFILLMENT_B2B_QUALITY_LOCKED",
        "IN_FULFILLMENT_MANUAL_SUBSTITUTION_B2B",
        "IN_FULFILLMENT_MANUAL_SUBSTITUTION_B2B_QUALITY_LOCKED",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK_B2B",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK_B2B_QUALITY_LOCKED",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT_B2B",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT_B2B_QUALITY_LOCKED",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK_B2B",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK_B2B_QUALITY_LOCKED",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND_B2B",
        "IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND_B2B_QUALITY_LOCKED",
        "IN_FULFILLMENT_CANCEL_B2B_QUALITY_LOCKED",
        "IN_FULFILLMENT_RESERVATION_CANCEL_B2B_QUALITY_LOCKED",
        "OUTGOING_GOODS_TRANSFER_B2B",
        "OUTGOING_GOODS_TRANSFER_B2B_QUALITY_LOCKED",
        "OUTGOING_GOODS_B2B_QUALITY_LOCKED",
        "INVENTORY_DIFFERENCE_INVENTORY_LOCKED",
        
        "LOCKED_STOCK_TO_STOCK_DIFFERENCE",
        "QUALITY_LOCKED_STOCK_TO_RESERVABLE_LOCKED_STOCK",
        "QUALITY_LOCKED_STOCK_TO_RESERVABLE_STOCK_IN_TRANSIT",
        "RESERVABLE_LOCKED_STOCK_TO_QUALITY_LOCKED_STOCK",
        "RESERVABLE_LOCKED_STOCK_TO_STOCK_DIFFERENCE",
        "RESERVABLE_STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK",
        "RESERVABLE_STOCK_IN_TRANSIT_TO_QUALITY_LOCKED_STOCK",
        "RESERVABLE_STOCK_IN_TRANSIT_TO_STOCK_DIFFERENCE",
        "STOCK_DIFFERENCE_TO_LOCKED_STOCK",
        "RESERVABLE_STOCK_IN_TRANSIT_TO_LOCKED_STOCK"
      ],
      "maxLength": 100
    },
    "metaData":{
      "type":"object",
      "title":"additional meta data",
      "description":"additional meta information for booking interface",
      "required":[
        "sender",
        "instance",
        "client",
        "sourceIdentifier"
      ],
      "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.v8.schema.json"
        },
        "instance": {
          "title": "instance of producer",
          "description": "instance of the application or warehouse context",
          "$ref": "#/definitions/instance"
        },
        "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...)",
          "type": "string",
          "maxLength": 50,
          "examples": [
            "FBO"
          ]
        },
        "sourceIdentifier": {
          "title": "source identifier",
          "description": "identifies the source system of the bookings, mapped from sender and instance of the origin wms booking message in fine bube",
          "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/system.v8.schema.json"
        }
      }
    },
    "data": {
      "title": "Data Erp",
      "description": "Data of the JSON message",
      "type": "object",
      "properties": {
        "sourceTimestamp": {
          "title": "the booking timestamp",
          "description": "Booking timestamp UTC+ISO-8601 format",
          "type": "string",
          "format": "date-time",
          "examples": [
            "2022-04-19T08:51:05.266869Z",
            "2022-04-19T08:51:05+02:00"
          ]
        },
        "creationType": {
          "title": "creation type",
          "description": "identifies specific creation conditions if necessary, in first version only automatic and manual bookings are used for stock journal",
          "type": "string",
          "enum": [
            "AUTOMATIC",
            "MANUAL"
          ]
        },
        "location": {
          "title": "the location where where the event was created",
          "description": "the location where the event was created, warehouse that emits the booking",
          "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/warehouselocations.v1.schema.json"
        },
        "erpSnapshotId": {
          "title": "the id of the following inventory snapshot",
          "description": "Consecutive number (sequence) of a long number. each inventory snapshot gets its own ID, which is identical for all records of the snapshot. all bookings get the id of the following snapshot",
          "type": "number",
          "maxLength": 18,
          "minimum": 1,
          "maximum": 999999999999999999,
          "examples": [
            122
          ]
        },
        "product": {
          "title": "Product Erp",
          "description": "product related information to identify the product and part",
          "type": "object",
          "properties": {
            "itemNumber": {
              "title": "item number",
              "description": "item number (article data) - used for old systems",
              "type": "integer",
              "maximum": 9999999999,
              "examples": [
                80473011
              ]
            },
            "itemSize": {
              "title": "item size",
              "description": "Numeric item size (article data) - used for old systems",
              "type": "integer",
              "maximum": 99999,
              "examples": [
                907
              ]
            },
            "erpProductId": {
              "title": "ERP product ID",
              "description": "ERP product ID - the id of the product in erp received from LSAS",
              "type": "string",
              "examples": [
                "54985132"
              ]
            },
            "erpPartId": {
              "title": "ERP part ID",
              "description": "GL/bulky items: ID for the part/packing unit based on item - size - part from ERP (LSAS gets it from MOLA)",
              "type": "string",
              "examples": [
                "58785132"
              ]
            },
            "partNumber": {
              "title": "part number (bulky items)",
              "description": "part number for specific packing unit (bulky items)",
              "type": "integer",
              "maximum": 999,
              "examples": [
                2
              ]
            },
            "numberOfParts": {
              "title": "number of all parts",
              "description": "number of all parts for this item (bulky items)",
              "type": "integer",
              "maximum": 999,
              "examples": [
                4
              ]
            }
          },
          "anyOf": [
            {
              "description": "PL booking to CORE and Cormorant or multi part result booking (bulky items) based on item size to CORE",
              "required": [
                "itemNumber",
                "itemSize"
              ]
            },
            {
              "description": "part booking (bulky items) based on item size and part to Humpback",
              "required": [
                "itemNumber",
                "itemSize",
                "partNumber",
                "numberOfParts"
              ]
            },
            {
              "description": "part booking (bulky items) based on erpProductId, erpPartId and part to Humpback",
              "required": [
                "erpProductId",
                "erpPartId",
                "partNumber",
                "numberOfParts"
              ]
            },
            {
              "description": "part booking (bulky items) based on product and partId to Humpback or Cormorant",
              "required": [
                "erpProductId",
                "erpPartId"
              ]
            }
          ]
        },
        "stockInfo": {
          "type": "object",
          "title": "Stock Info Erp",
          "description": "the information for booking related warehouses, filled dependent on event type",
          "properties": {
            "sourceLocation": {
              "type": "object",
              "title": "source location",
              "description": "the source location structure for the booking",
              "properties": {
                "location": {
                  "title": "location",
                  "description": "source location of booking",
                  "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/warehouselocations.v1.schema.json"
                }
              }
            },
            "destinationLocation": {
              "type": "object",
              "title": "destination location",
              "description": "the destination location for the booking",
              "properties": {
                "location": {
                  "title": "location",
                  "description": "destination location of booking",
                  "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/warehouselocations.v1.schema.json"
                }
              }
            }
          },
          "minProperties": 1,
          "additionalProperties": false
        },
        "movementInfo": {
          "title": "Movement Info Erp",
          "description": "movement/booking informations",
          "type": "object",
          "properties": {
            "quantity": {
              "title": "quantity",
              "description": "quantity to be booked, in case of goods receipt the delivery note original quantity for this detail, in case of goods receipt release booking the released quantity for this detail",
              "type": "integer",
              "minimum": 1,
              "maximum": 9999999999,
              "examples": [
                2
              ]
            },
            "movementInfoDetails": {
              "title": "Movement Info Details Erp",
              "description": "Detailed Info about the movement, also used for deprecated data for old systems",
              "type": "object",
              "properties": {
                "documentNumber": {
                  "title": "document number",
                  "description": "Depending on type, in case of goods release booking then receiptDocumentNo (44xxx) from delivery, in case of return vendor sheet booking the rvsNumber (9x?xxx), otherwise other document numbers.",
                  "type": "integer",
                  "maximum": 9999999999,
                  "examples": [
                    973184
                  ]
                },
                "supplierNumber": {
                  "title": "supplier number",
                  "description": "Number of supplier, mandatory for goods release, return vendor sheet",
                  "type": "integer",
                  "maximum": 9999999999,
                  "examples": [
                    13901
                  ]
                },
                "externalReferenceView": {
                  "title": "External reference view",
                  "description": "External reference view - used in core as posting text",
                  "type": "string",
                  "maxLength": 50,
                  "examples": [
                    "Korrekturbuchung",
                    "449898"
                  ]
                },
                "customerCompany": {
                  "title": "customer company",
                  "description": "Company of the customer account. For example: SON - LDG Großkunden mit Belegnummer",
                  "type": "integer",
                  "maximum": 9999999999,
                  "examples": [
                    68
                  ]
                },
                "purchaseOrderNumber": {
                  "title": "purchase order number",
                  "description": "purchase order number (sent from SON for goods released bookings, ordernumber OVA)",
                  "type": "string",
                  "examples": [
                    "11887"
                  ]
                },
                "externalReference": {
                  "title": "external reference",
                  "description": "externalReference - Cobra - Unigro reference ano from unigro order",
                  "type": "string",
                  "examples": [
                    "364277"
                  ]
                },
                "goodsInId": {
                  "title": "goods in id",
                  "description": "unique id of a goods receipt see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/",
                  "type": "string",
                  "maxLength": 36,
                  "examples":["123"]
                },
                "buaid": {
                  "title": "buaid",
                  "description": "bi unique article ID, unique identification of an individual unit in the logistical process",
                  "type": "string",
                  "maxLength": 50,
                  "examples":["2344545-334542-465g45ddf"]
                },
                "returnKey": {
                  "title": "returnKey",
                  "description": "returnKey",
                  "type": "string",
                  "maxLength": 500,
                  "examples":["2344545-334542-465g45ddf"]
                },
                "b2bOrderId": {
                  "title": "b2b Order Id",
                  "description": "ERP Order Id - for stock transfers ordered from ERP",
                  "type": "string",
                  "maxLength": 36,
                  "examples": [
                    "390c4228-20b9-11ed-861d-0242ac120002"
                  ]
                },
                "loadingNumber": {
                  "description": "generated per sender; generation specification from OTTO, unique within 13 years for stock transfers",
                  "type": "string",
                  "maxLength": 12,
                  "title": "Loading Number",
                  "examples": [
                    "784414470093"
                  ]
                },
                "merchantErpIdentifier": {
                  "title": "merchant erp identifier",
                  "description": "enums that specifies the merchant erp that generated the orders",
                  "type": "string",
                  "enum": [
                    "DEEP_SEA_CORMORANT",
                    "CORE",
                    "B2B_DEEP_SEA_CORMORANT",
                    "B2B_CORE"
                  ],
                  "maxLength": 30
                },
                "merchantSingleItemId": {
                 "title": "merchant single item Id",
                  "description": "single item id for orders used in merchant erp",
                  "type": "string",
                  "maxLength": 255,
                  "examples": [
                    "390c4228-20b9-11ed-861d-0242ac120002"
                  ]
                },
                "stockTransferType": {
                    "title": "stock transfer type",
                    "description": "additional transfer type information for stock transfers",
                  "type": "string",
                    "maxLength": 50,
                    "enum": [
                        "UMF",
                        "WRS_WE",
                        "WRS_L",
                        "IWA_WE",
                        "IWA_M",
                        "GKD"
                    ]
                },
                "orderPart": {
                  "title": "order part",
                  "description": "number of the attempt to reserve or check the stock for orders - starts with zero",
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 999999999,
                  "examples": [
                    1
                  ]
                },
                "stockType": {
                  "title": "stock type",
                  "description": "stockType for B2B orders which indicates from which stock the order has to be fulfilled",
                  "type": "string",
                  "maxLength": 50,
                  "enum": [
                    "AVAILABLE",
                    "LOCKED"
                  ]
                },
                "lockTypeCode": {
                  "title": "lock type code",
                  "description": "lock type code from wms for locked stock which can also differentiate between the locked stock types used in B2B order bookings",
                  "type": "string",
                  "maxLength": 50
                },
                "returnOrderUUID": {
                  "title": "returnOrderUUID",
                  "description": "the UID of the associated return order contract, can be a UUID4",
                  "type": "string",
                  "maxLength": 100,
                  "examples":["b1eb5758-b9b5-43b9-a92f-142be61f73f1"]
                },
                "originalGoodsInId": {
                  "title": "original goods in id",
                  "description": "unique id of the original goods receipt for a goods in from rework see interface https://docs.osp-fine.de/page/fine-common/20_inbound/i04_goods_in/i04_goods_in/",
                  "type": "string",
                  "maxLength": 36,
                  "examples":["123"]
                },
                "b2bShipmentType": {
                  "title": "b2b shipment type",
                  "description": "the shipment type for b2b orders - UMF for stock transfer to another warehouse (with known subtypes in stockTransferType) or GKD for real major customer orders, mandatory for b2b order bookings, null for B2C",
                  "type": "string",
                  "maxLength": 30,
                  "enum": [
                    "UMF",
                    "GKD"
                  ]
                }
              },
              "minProperties": 1
            }
          },
          "required": [
            "quantity"
          ]
        }
      },
      "required": [
        "sourceTimestamp",
        "location",
        "product",
        "movementInfo",
        "stockInfo"
      ]
    }
  },
  "required": [
    "eventId",
    "traceId",
    "eventTime",
    "version",
    "context",
    "eventType",
    "metaData",
    "data"
  ],
  "examples": [
    {
      "eventId": "4f02ed14-db77-4fc8-a7da-98620f2ea5e7",
      "traceId": "a2b9691c-95a8-4f8e-80c3-fefa05f058df",
      "version": "2.6",
      "eventType": "GOODS_RECEIPT_QS_UNAUDITED_STOCK",
      "context": "STOCKPOSTING",
      "eventTime": "2021-05-31T18:45:47.123333Z",
      "metaData": {
        "client": "FBO",
        "sender": "BUBE",
        "instance": "SONNEFELD",
        "sourceIdentifier": "RETAILSCHICHT"
      },
      "data": {
        "sourceTimestamp": "2021-05-31T18:45:47Z",
        "creationType":"AUTOMATIC",
        "location": "SONNEFELD",
        "product": {
          "itemNumber": 29905444,
          "itemSize": 0,
          "partNumber": 1,
          "numberOfParts": 1
        },
        "stockInfo": {
          "destinationLocation": {
            "location": "SONNEFELD"
          }
        },
        "movementInfo": {
          "quantity": 4,
          "movementInfoDetails": {
            "documentNumber": 453756,
            "supplierNumber": 83224,
            "purchaseOrderNumber": "11887"
          }
        }
      }
    },
    {
      "eventId": "4f02ed14-db77-4fc8-a7da-98620f2ea5e7",
      "traceId": "a2b9691c-95a8-4f8e-80c3-fefa05f058df",
      "version": "2.6",
      "eventType": "GOODS_RECEIPT_STOCK_DIFFERENCE",
      "context": "STOCKPOSTING",
      "eventTime": "2021-05-31T18:45:47.123333Z",
      "metaData": {
        "client": "FBO",
        "sender": "BUBE",
        "instance": "SONNEFELD",
        "sourceIdentifier": "RETAILSCHICHT"
      },
      "data": {
        "sourceTimestamp": "2021-05-31T18:45:47Z",
        "creationType":"MANUAL",
        "location": "SONNEFELD",
        "product": {
          "itemNumber": 29905444,
          "itemSize": 0,
          "partNumber": 1,
          "numberOfParts": 1
        },
        "stockInfo": {
          "sourceLocation": {
            "location": "SONNEFELD"
          },
          "destinationLocation": {
            "location": "SONNEFELD"
          }
        },
        "movementInfo": {
          "quantity": 4,
          "movementInfoDetails": {
            "documentNumber": 453756,
            "supplierNumber": 83224,
            "purchaseOrderNumber": "11887"
          }
        }
      }
    },
    {
      "eventId": "4f02ed14-db77-4fc8-a7da-98620f2ea5e7",
      "traceId": "a2b9691c-95a8-4f8e-80c3-fefa05f058df",
      "version": "2.6",
      "eventType": "DELIVERABLE_STOCK_MINUS",
      "context": "STOCKPOSTING",
      "eventTime": "2021-05-31T18:45:47.123333Z",
      "metaData": {
        "client": "FBO",
        "sender": "BUBE",
        "instance": "OHRDRUF",
        "sourceIdentifier": "COBRA"
      },
      "data": {
        "sourceTimestamp": "2021-05-31T18:45:47Z",
        "location": "OHRDRUF",
        "product": {
          "erpProductId": "990167111",
          "erpPartId": "29905444",
          "partNumber": 2,
          "numberOfParts": 2
        },
        "stockInfo": {
          "sourceLocation":  {
            "location": "LANGENSELBOLD"
          }
        },
        "movementInfo": {
          "quantity": 4,
          "movementInfoDetails": {
            "documentNumber": 93000,
            "supplierNumber": 13901
          }
        }
      }
    },
    {
      "eventId": "4f02ed14-db77-4fc8-a7da-98620f2ea5e7",
      "traceId": "a2b9691c-95a8-4f8e-80c3-fefa05f058df",
      "version": "2.6",
      "eventType": "DELIVERABLE_STOCK_TO_STOCK_IN_TRANSIT",
      "context": "STOCKPOSTING",
      "eventTime": "2021-05-31T18:45:47.123333Z",
      "metaData": {
        "client": "FBO",
        "sender": "BUBE",
        "instance": "OHRDRUF",
        "sourceIdentifier": "COBRA"
      },
      "data": {
        "sourceTimestamp": "2021-05-31T18:45:47Z",
        "location": "OHRDRUF",
        "product": {
          "erpProductId": "990167111",
          "erpPartId": "29905444"
        },
        "stockInfo": {
          "sourceLocation": {
            "location": "OHRDRUF"
          },
          "destinationLocation": {
            "location": "LANGENSELBOLD"
          }
        },
        "movementInfo": {
          "quantity": 4,
          "movementInfoDetails": {
            "documentNumber": 93000,
            "supplierNumber": 13901
          }
        }
      }
    },
    {
      "eventId": "fa6c72ab-ccdd-4d0e-b075-1117b4340320",
      "traceId": "d2123101-0a0b-4142-ae43-9ea1a4b90fcc",
      "eventTime": "2022-04-21T14:57:14.641+00:00",
      "version": "2.6",
      "context": "STOCKPOSTING",
      "eventType": "OUTGOING_GOODS_CUSTOMER_LOCKED_STOCK",
      "metaData": {
        "sender": "BUBE",
        "instance": "LOEHNE_CP",
        "client": "FBO",
        "sourceIdentifier": "COBRA"
      },
      "data": {
        "sourceTimestamp": "2022-04-21T14:57:14.641+00:00",
        "location": "LOEHNE_CP",
        "product": {
          "itemNumber": 613527,
          "itemSize": 0,
          "partNumber": 1,
          "numberOfParts": 1
        },
        "stockInfo": {
          "sourceLocation": {
            "location": "LOEHNE_CP"
          }
        },
        "movementInfo": {
          "quantity": 1,
          "movementInfoDetails": {
            "documentNumber": 647300,
            "externalReferenceView": "647300",
            "externalReference": "371520"
          }
        }
      }
    },
    {
      "eventId": "7d2d2832-18fa-4be1-9a75-d30629f89c12",
      "traceId": "75dd30a4-3326-4784-aa80-4c9b2307923a",
      "eventTime": "2022-04-21T14:57:17.284+00:00",
      "version": "2.6",
      "context": "STOCKPOSTING",
      "eventType": "GOODS_RECEIPT",
      "metaData": {
        "sender": "BUBE",
        "instance": "OHRDRUF",
        "client": "FBO",
        "sourceIdentifier": "COBRA"
      },
      "data": {
        "sourceTimestamp": "2022-04-21T14:57:17.284+00:00",
        "location": "OHRDRUF",
        "product": {
          "itemNumber": 58155821,
          "itemSize": 0,
          "partNumber": 1,
          "numberOfParts": 1
        },
        "stockInfo": {
          "destinationLocation": {
            "location": "OHRDRUF"
          }
        },
        "movementInfo": {
          "quantity": 1,
          "movementInfoDetails": {
            "documentNumber": 404985,
            "supplierNumber": 81792,
            "externalReferenceView": "404985"
          }
        }
      }
    },
    {
      "eventId": "0e16cd1b-ad2d-4230-bc6d-853b4ef9c651",
      "traceId": "8e544e45-2c71-4925-934f-c5a5f2eb1eb0",
      "eventTime": "2022-04-21T14:57:18.429+00:00",
      "version": "2.6",
      "context": "STOCKPOSTING",
      "eventType": "LOCKED_STOCK_TO_DELIVERABLE_STOCK",
      "metaData": {
        "sender": "BUBE",
        "instance": "OHRDRUF",
        "client": "FBO",
        "sourceIdentifier": "COBRA"
      },
      "data": {
        "sourceTimestamp": "2022-04-21T14:57:18.429+00:00",
        "location": "OHRDRUF",
        "product": {
          "itemNumber": 27703966,
          "itemSize": 0,
          "partNumber": 1,
          "numberOfParts": 1
        },
        "stockInfo": {
          "sourceLocation": {
            "location": "OHRDRUF_RT"
          },
          "destinationLocation": {
            "location": "OHRDRUF"
          }
        },
        "movementInfo": {
          "quantity": 1
        }
      }
    },
    {
      "eventId": "0e133d1b-ad2d-4230-bc6d-853b4ef9c651",
      "traceId": "8e533e45-2c71-4925-934f-c5a5f2eb1eb0",
      "eventTime": "2023-11-17T14:57:18.429+00:00",
      "version": "2.6",
      "context": "STOCKPOSTING",
      "eventType": "IN_FULFILLMENT_CUSTOMER",
      "metaData": {
        "sender": "BUBE",
        "instance": "ILOWA",
        "client": "FBO",
        "sourceIdentifier": "KMOTION_ILO"
      },
      "data": {
        "sourceTimestamp": "2022-04-21T14:57:18.429+00:00",
        "location": "ILOWA",
        "product": {
          "itemNumber": 27703966,
          "itemSize": 0,
          "erpProductId": "1381743776",
          "erpPartId": "34345555",
          "partNumber": 1,
          "numberOfParts": 1
        },
        "stockInfo": {
          "sourceLocation": {
             "location": "ILOWA"
          },
          "destinationLocation": {
             "location": "ILOWA"
          }
        },
        "movementInfo": {
          "quantity": 1,
          "movementInfoDetails": {
              "buaid":"ed5807dd-c141-4b91-9f76-b6cbfa41cb73",
              "merchantErpIdentifier": "DEEP_SEA_CORMORANT",
              "merchantSingleItemId": "390c4228-20b9-11ed-861d-0242ac120002"
          }
        }
      }
    },
    {
      "eventId": "1e133d1b-ad2d-4230-bc6d-853b4ef9c651",
      "traceId": "3e533e45-2c71-4925-934f-c5a5f2eb1eb0",
      "eventTime": "2023-11-17T14:57:18.429+00:00",
      "version": "2.6",
      "context": "STOCKPOSTING",
      "eventType": "RETURNS_MANUAL_STORAGE",
      "metaData": {
        "sender": "BUBE",
        "instance": "GERNSHEIM",
        "client": "TAZZIO",
        "sourceIdentifier": "KMOTION_GHM"
      },
      "data": {
        "sourceTimestamp": "2022-04-21T14:57:18.429+00:00",
        "location": "GERNSHEIM",
        "product": {
          "itemNumber": 27703966,
          "itemSize": 0,
          "erpProductId": "1381743776",
          "erpPartId": "34345555",
          "partNumber": 1,
          "numberOfParts": 1
        },
        "stockInfo": {
          "sourceLocation": {
             "location": "GERNSHEIM"
          },
          "destinationLocation": {
             "location": "GERNSHEIM"
          }
        },
        "movementInfo": {
          "quantity": 1,
          "movementInfoDetails": {
              "buaid":"ed5807dd-c141-4b91-9f76-b6cbfa41cb73",
              "returnKey":"12345678886",
              "returnOrderUUID": "394c4228-20b9-11ed-861d-0242ac120002",
              "stockType":"AVAILABLE"
          }
        }
      }
    },
    {
      "eventId":"f1f9c1bd-974f-4c43-b15a-609ffcfe6c19",
      "traceId":"f1f9c1bd-974f-4c43-b15a-609ffcfe6c19",
      "eventTime":"2024-11-28T14:30:01.227+01:00",
      "version":"2.6",
      "context":"STOCKPOSTING",
      "eventType":"OUTGOING_GOODS",
      "metaData":{
        "sender":"BUBE",
        "instance":"ILOWA",
        "client":"FBO",
        "sourceIdentifier":"KMOTION_ILO"
      },
      "data":{
        "sourceTimestamp":"2024-11-28T14:30:00.000+01:00",
        "location":"ILOWA",
        "erpSnapshotId":3268.0,
        "product":{
          "itemNumber":10000239,
          "itemSize":908,
          "erpProductId":"149860236",
          "erpPartId": "149860236-1",
          "partNumber":1,
          "numberOfParts":1
        },
        "stockInfo":{
          "sourceLocation": {
            "location": "ILOWA"
          },
          "destinationLocation": {
            "location": "HALDENSLEBEN"
          }
        },
        "movementInfo":{
          "quantity":4,
          "movementInfoDetails":{
            "documentNumber":123456,
            "supplierNumber":10010,
            "b2bOrderId":"827410101",
            "loadingNumber":"227000004333",
            "stockTransferType":"GKD",
            "orderPart":1,
            "stockType":"AVAILABLE",
            "lockTypeCode":"------",
            "merchantErpIdentifier": "B2B_DEEP_SEA_CORMORANT",
            "merchantSingleItemId": "494c4228-20b9-11ed-861d-0242ac120123",
            "b2bShipmentType": "UMF"
          }
        }
      }
    }
  ]
}

7 - S02 Stock Booking Enums

1. StockBooking.eventType

This table describes the FINE enumerations used from different WMS for CORE and DeepSea

BusinessCase Core ID BC Core Name BC Core Enum FINE ENUM Quelle Beleg Y/N Belegnr SPT Credit Creditname Debit Debitname DiffWh Force CR WH Force DB WH Strategy Cobra/KR-GID Bemerkung Verwendungsbeispiele im LVS

10221

Erhöhung Transportbestand

ERHOEHUNG_TRANSPORT

LOCKED_STOCK_TO_STOCK_IN_TRANSIT

COBRA

N

0

5

1

LOCKED_STOCK

2

STOCK_IN_TRANSIT

23

unused

10222

Erhöhung fakturierfähiger Bestand

ERHOEHUNG_FAKT_BESTAND

LOCKED_STOCK_TO_DELIVERABLE_STOCK

COBRA

N

0

278

1

LOCKED_STOCK

3

DELIVERABLE_STOCK

24

div. Einlagerungen ( 23 Sonstige, 33 WE Lieferant, 34 WE aus NB, 64 Verdichtung Fachboden, 12x Umfuhren aus anderen Lägern ohne TLIB, 149 Normanpassung, 140 interne Veränderung …), Entsperrungen

110329

Reduzierung fakturierfähiger Bestand Lagerschaden storno

REDUZIERUNG_FAK_BEST_LS_CAN

WAREHOUSE_DAMAGE_CANCELED

COBRA

N

0

459

1

LOCKED_STOCK

3

DELIVERABLE_STOCK

75

sep. Lagerschäden

Ein 339 Storno WRS Lagerschaden

10223

Bestandsdifferenz aus Kto 1

BESTANDSDIFF_AUS_KTO1

LOCKED_STOCK_TO_STOCK_DIFFERENCE

COBRA

N

0

243

1

LOCKED_STOCK

4

STOCK_DIFFERENCE

N

25

unused

10248

Wareneingang gesperrter Bestand Storno

WE_GESPERRT_STORNO

GOODS_RECEIPT_LOCKED_STOCK_CANCELED

COBRA

Y

XXXXXX

207

1

LOCKED_STOCK

6

WE Lieferant

N

55

448 - Storno KP, 555 - DLW Rücksendung

10078

Warenausgang

WARENAUSGANG

OUTGOING_GOODS_CUSTOMER_LOCKED_STOCK

COBRA

N

0

3153

1

LOCKED_STOCK

8

WA Kunde

N

68

447 Auslagerung KP

100031

Minusdifferenz gesperrter Bestand

MINUSDIFF_GESPERRT_BESTAND

INVENTORY_DIFFERENCE

COBRA

N

0

446

1

LOCKED_STOCK

10

Inventurdifferenz

69

448 - Storno im KP, Ausbuchung auf Invdiff

10228

Einlagerung in QS-gesperrt

EINLAGERUNG_IN_QS_GESPERRT

LOCKED_STOCK_TO_QUALITY_LOCKED_STOCK

COBRA

N

0

570

1

LOCKED_STOCK

15

QUALITY_LOCKED_STOCK

N

26

557 Retoure Rücksendung Umsteuerung LSB, 558 Retoure Umbuchung OHR

10009

BBW

BBW

LOCKED_STOCK_MINUS

COBRA

N

0

3150

1

LOCKED_STOCK

93

BUB-wirks. BestKorr

N

57

298 - RÜ externe Aufbereitung

100033

Transportbestand Storno RT-Betrieb

TRANSPORTBESTAND_STORNO

LOCKED_STOCK_TO_RETURNS

COBRA

N

0

538

1

LOCKED_STOCK

98

WA Konzern Retoure

N

398

398

72

448 - Storno im KP - Rücksendung

10231

Ausbuchung Umfuhr

AUSBUCHUNG_UMFUHR

STOCK_IN_TRANSIT_TO_LOCKED_STOCK

COBRA

N

0

404

2

STOCK_IN_TRANSIT

1

LOCKED_STOCK

27

Rü 449 Wannenrückstorno

10027

Einlagerung aus Transport

EINLAGERUNG_TRANSPORT

STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK

COBRA

N

0

3363

2

STOCK_IN_TRANSIT

3

DELIVERABLE_STOCK

30

Einlagerung aus TLIB ( 135 Retoure, 452 Retoure mit TLIB (aus OHR RT für OTL), 170 Umfuhr Ziellager TLIB)

10233

Bestandsdifferenz aus Transport

BESTANDSDIFF_AUS_TRANSPORT

STOCK_IN_TRANSIT_TO_STOCK_DIFFERENCE

COBRA

N

0

294

2

STOCK_IN_TRANSIT

4

STOCK_DIFFERENCE

32

450 - Wannenstorno Diff IFC in Quellbetrieb

10234

QS-Warenzugang aus Transport

QS_WARENZUGANG_AUS_TRANSPORT

STOCK_IN_TRANSIT_TO_QUALITY_LOCKED_STOCK

COBRA

N

0

96

2

STOCK_IN_TRANSIT

15

QUALITY_LOCKED_STOCK

N

33

Rü 157 - Retoure Rücksendung automatisch (IFC)

10235

Reduzierung fakturierfähiger Bestand

REDUZIERUNG_FAKTURF_BESTAND

DELIVERABLE_STOCK_TO_LOCKED_STOCK

COBRA

N

0

3401

3

DELIVERABLE_STOCK

1

LOCKED_STOCK

N

34

Sperrbuchungen bei allen Auslagerungsvorgängen, die noch nicht abgeschlossen sind, Sonstige Sperren auf Lagerbestand manuell setzen, Umlagerungen, Verdichtungen, div. Auslagerungen (3 - Rücksendung, 7 - Muster, 8 - Sonstige, 15 - WE Storno, Umfuhr nicht Cobra Läger, 50 IWA, 119 Nachbearbeitung, 6 - Verschrottung, 149 - Normanpassung, 140 - Interne Veränderung…​), Container korrigieren - ohne Bestandskorrektur

110328

Reduzierung fakturierfähiger Bestand Lagerschaden

REDUZIERUNG_FAK_BEST_LS

WAREHOUSE_DAMAGE

COBRA

N

0

458

3

DELIVERABLE_STOCK

1

LOCKED_STOCK

74

Lagerschaden sep. notwendig für Abrechung

Auslagerung 330 WRS Lagerschaden

10236

Einstellung in Umfuhr

EINSTELLUNG_IN_UMFUHR

DELIVERABLE_STOCK_TO_STOCK_IN_TRANSIT

COBRA

N

0

102

3

DELIVERABLE_STOCK

2

STOCK_IN_TRANSIT

35

170 - Umfuhr Ziellager TLIB

10237

Minusdifferenz freier Bestand

MINUSDIFFERENZ_FREIER_BESTAND

DELIVERABLE_STOCK_TO_STOCK_DIFFERENCE

COBRA

N

0

220

3

DELIVERABLE_STOCK

4

STOCK_DIFFERENCE

N

37

Auslagerung 61 - Karton nicht gefunden, 321/322 Ersatzauslagerungen Kommissionierung, 5 - Minusdifferenz, 91/92 Inventur Storno/Klärung, Bestandskorrektur (analog Container korrigieren, aber mit K4)

10010

WRS 97

WRS_97

REVERSE_INBOUND

COBRA

Y

XXXXXX

143

3

DELIVERABLE_STOCK

6

WE Lieferant

N

65

Warenrücksendung An Lieferanten nicht Retouren, (bei WE Freischaltung bzw. Auslagerung 4 - WRS…)

10238

QS Sperrung

QS_SPERRUNG

DELIVERABLE_STOCK_TO_QUALITY_LOCKED_STOCK

COBRA

N

0

86

3

DELIVERABLE_STOCK

15

QUALITY_LOCKED_STOCK

N

38

keine Verwendung

10006

IWA

IWA

DELIVERABLE_STOCK_MINUS

COBRA

N

0

3101

3

DELIVERABLE_STOCK

93

BUB-wirks. BestKorr

N

1574

58

Totalschadenbuchungen im WE nach Freischaltung, Auslagerung für Corso, SLO Sperren, Ausbuchung aus BUB z.B. beim Lagerschaden, Transportschaden nach WE2

10239

Plusdiff. Vorgesehen zur Einlagerung

PLUSDIFF_ZUR_EINLAGERUNG

STOCK_DIFFERENCE_TO_LOCKED_STOCK

COBRA

N

0

242

4

STOCK_DIFFERENCE

1

LOCKED_STOCK

N

39

unbenutzt

10240

Transportbestand Korrektur Plus

TRANSPORTBESTAND_PLUS

STOCK_DIFFERENCE_TO_STOCK_IN_TRANSIT

COBRA

N

0

218

4

STOCK_DIFFERENCE

2

STOCK_IN_TRANSIT

N

40

unused

10241

Plusdifferenz freier Bestand

PLUSDIFFERENZ_FREIER_BESTAND

STOCK_DIFFERENCE_TO_DELIVERABLE_STOCK

COBRA

N

0

228

4

STOCK_DIFFERENCE

3

DELIVERABLE_STOCK

N

41

Einlagerung 32 Plusdifferenz, 90 Inventur Einlagerung, Bestandskorrekturen (positive)

10242

Plusdifferenz QS-gesperrt

PLUSDIFFERENZ_QS_GESPERRT

STOCK_DIFFERENCE_TO_QUALITY_LOCKED_STOCK

COBRA

N

0

97

4

STOCK_DIFFERENCE

15

QUALITY_LOCKED_STOCK

N

42

Rü 100 Container korrigieren (Ein), Rü 156 Retoure Rücksendung (man. Erfassung), Container korrigieren für RÜ

10247

Wareneingang gesperrter Bestand

WE_GESPERRT

GOODS_RECEIPT_LOCKED_STOCK

COBRA

Y

XXXXXX

3050

6

WE Lieferant

1

LOCKED_STOCK

N

54

MC 148 - Freischaltung DLW Ware für Unigro im GL bzw. MC 447 - Einlagerung für NLW im KP

10077

Wareneingang

WARENEINGANG

GOODS_RECEIPT

COBRA

Y

XXXXXX

3001

6

WE Lieferant

3

DELIVERABLE_STOCK

N

49

Bei Freischaltung eines Wareneingangs WE2.0 (auch vor WRS bei Freischaltung), Auch verwendet bei Storno WRS für nicht Retouren (97er…)

100030

Warenrücksendung Retoure Storno

WRR_STORNO

REVERSE_INBOUND_RETURNS_CANCELED

COBRA

Y

XXXXXX

426

7

Rueckgabe Lieferant

1

LOCKED_STOCK

67

Storno eines WRR (bucht in hinterlegten RB)

10027

Einlagerung aus Transport

EINLAGERUNG_TRANSPORT

INVENTORY_DIFFERENCE_CANCELED

COBRA

N

0

445

10

Inventurdifferenz

1

LOCKED_STOCK

70

unused

100032

Minusdifferenz Storno

MINUSDIFFERENZ_STORNO

TRANSIT_LOCKED_STOCK_TO_LOCKED_STOCK

COBRA

N

0

407

13

Transp.best gesperrt

1

LOCKED_STOCK

71

447 - Einlagerung KP (bei DLW)

100034

Inventurdifferenz aus Transport

INVENTURDIFFERENZ_TRANSPORT

TRANSIT_LOCKED_STOCK_MINUS

COBRA

N

0

547

13

Transp.best gesperrt

10

Inventurdifferenz

N

73

448 - Storno KP für DLW

10243

Auslagerung QS-gesperrt

AUSLAGERUNG_QS_GESPERRT

QUALITY_LOCKED_STOCK_TO_LOCKED_STOCK

COBRA

N

0

552

15

QUALITY_LOCKED_STOCK

1

LOCKED_STOCK

43

ungenutzt

10244

int.Umlag. aus QS-gesp. via Transport

INT_UMLAG_QS_GESP_TRANSPORT

QUALITY_LOCKED_STOCK_TO_STOCK_IN_TRANSIT

COBRA

N

0

574

15

QUALITY_LOCKED_STOCK

2

STOCK_IN_TRANSIT

N

44

unused in Cobra

10245

QS Entsperrung

QS_ENTSPERRUNG

QUALITY_LOCKED_STOCK_TO_DELIVERABLE_STOCK

COBRA

N

0

87

15

QUALITY_LOCKED_STOCK

3

DELIVERABLE_STOCK

N

47

Rü 269 Umfuhr WLS intern, Rü 557/558 Umsteuerung LSB/bzw. Rücksendung

10246

Minusdiff. m QS-gesp. Bestand

MINUSDIFF_QS_GESP_BESTAND

QUALITY_LOCKED_STOCK_TO_STOCK_DIFFERENCE

COBRA

N

0

98

15

QUALITY_LOCKED_STOCK

4

STOCK_DIFFERENCE

48

Rü 101 Container korrigieren, Bestandsdifferenzen Rü, Rü 159 Umfuhr NLR mit WLS intern (in Ziellager)

100029

Warenrücksendung Retoure

WRR

REVERSE_INBOUND_RETURNS

COBRA

Y

XXXXXX

532

15

QUALITY_LOCKED_STOCK

7

Rueckgabe Lieferant

66

Rü 272 - Warenrücksendung Retouren

10229

Totalschaden

TOTALSCHADEN

QUALITY_LOCKED_STOCK_TO_TOTAL_LOSS

COBRA

N

0

95

15

QUALITY_LOCKED_STOCK

22

Totalschaden

N

59

Rü 292 - Totalschaden

100024

Einlagerung VAL/WSI Gutschriften

EINLAGERUNG_VAL_WSI_GUT

QUALITY_LOCKED_STOCK_TO_CREDIT_THIRD_PARTY_SALE

COBRA

N

0

530

15

QUALITY_LOCKED_STOCK

33

Drittverk. /Verwert.

60

Rü 291 SDV

100025

Kanalbuchung SDV

SDV

QUALITY_LOCKED_STOCK_CHANNEL_BOOKING

COBRA

N

0

553

15

QUALITY_LOCKED_STOCK

77

KTO 77 / Fundgrube

61

Rü 293 Fundgrube

100026

Kanalbuchung Fundgrube

FUNDGRUBE

QUALITY_LOCKED_STOCK_TO_TREASURE_DROVE

COBRA

N

0

419

15

QUALITY_LOCKED_STOCK

93

BUB-wirks. BestKorr

62

RÜ 295 Verkaufslager Möbel, Rü 296 - Braune Ware, Rü 297 - Weiße Ware

100027

Ausbuchung QS gesperrter Bestand

AUSBUCHUNG_QS

LOCKED_STOCK_PLUS

COBRA

N

0

3051

93

BUB-wirks. BestKorr

1

LOCKED_STOCK

N

63

294 - Rü Lager, 308 Rü Kanalumbuchung - ungenutzt?

10080

IWR

IWR

DELIVERABLE_STOCK_PLUS

COBRA

N

0

3003

93

BUB-wirks. BestKorr

3

DELIVERABLE_STOCK

N

64

SLO Entsperrung - bucht Bestand wieder in BUB

10221

Erhöhung Transportbestand

ERHOEHUNG_TRANSPORT

LOCKED_STOCK_TO_STOCK_IN_TRANSIT

KR CORE SYNC DS

N

0

3391

1

LOCKED_STOCK

2

STOCK_IN_TRANSIT

N

23

BWA 1011 - EAL-Karton für interne Einlagerung vorbereitet [Verladung] (von 102 → 104, in 505), BWA 1521 - Storno eingelagerter BKZ-Artikel nach Doppelavise, Schritt 1 [Retouren-Avise] (von 131 → 130, in 505), BWA 1521 - Storno eingelagerter BKZ-Artikel nach Doppelavise, Schritt 1 [Retouren-Avise] (von 131 → 130, in 506), BWA 1606 - Verladung in externen Transport (eigener Betrieb) [WE2-OSS] (von 102 → 104, in 505)

110307

Umfuhr aus gesperrtem Bestand

UMFUHR_AUS_GESPERRTEM_BESTAND

LOCKED_STOCK_TO_STOCK_IN_TRANSIT

KR CORE SYNC DS

N

0

3390

1

LOCKED_STOCK

2

STOCK_IN_TRANSIT

Y

91

BWA 1607 - Verladung in externen Transport (Fremdbetrieb) [BU] (von 102 → 150, in 505)

10222

Erhöhung fakturierfähiger Bestand

ERHOEHUNG_FAKT_BESTAND

LOCKED_STOCK_TO_DELIVERABLE_STOCK

KR CORE SYNC DS

N

0

3301

1

LOCKED_STOCK

3

DELIVERABLE_STOCK

N

24

BWA 1018 - Einlagerung aus externem Transport ungezielt [HRL] (von 109 → 101, in 515), BWA 1019 - Einlagerung Umfuhr aus anderem Lagerbetrieb ohne Transport-ID (PRL) [SEIN-PRL] (von 109 → 101, in 515), BWA 1021 - Einlagerung Irrläufer aus ENDKO (HRL) [HRL] (von 123 → 101, in 505) BWA 1022 - Einlagerung aus ENDKO (PRL) [SEIN-PRL] (von 123 → 101, in 505), BWA 1023 - Einlagerung aus int. Umlagerung [FEIN] (von 102 → 101, in 505), BWA 1024 - Einlagerung eines Musters ins KS (RMW) [FS-RMW] (von 102 → 101, in 505), BWA 1029 - Nachbearbeitung-Einlagerung (PRL) [SEIN-PRL] (von 108 → 101, in 515), BWA 1031 - Einlagerung in verf. Bestand aus int. Transport [FS-RL] (von 102 → 101, in 505), BWA 1043 - Einlagerung in KS-Bestand [FS-KS] (von 102 → 101, in 505), BWA 1090 - Einlagerung auf HRL-Lagerplatz [HRL] (von 102 → 101, in 505), BWA 1095 - Gassenfreigabe HRL [HRL] (von 102 → 101, in 505), BWA 1096 - Einlagerung aus gesperrtem Bestand [HRL] (von 108 → 101, in 515), BWA 1311 - Ware aus WRS-Storno ins PRL [SEIN-PRL] (von 108 → 101, in 515), BWA 1332 - Mehrmenge aus SDV/Verwertung (PRL) [SEIN-PRL] (von 108 → 101, in 515), BWA 1454 - Einlagerung von OSS-Ware ins KS (RMW) [FS-RMW] (von 102 → 101, in 505), BWA 1455 - Einlagerung einer Plusdifferenz ins KS (RMW) [FS-RMW] (von 102 → 101, in 505), BWA 1456 - Einlagerung von Zeitware ins KS (RMW) [FS-RMW] (von 102 → 101, in 505), BWA 1457 - Einlagerung einer LF-BKZ Ware ins KS (RMW) [FS-RMW] (von 102 → 101, in 505), BWA 1458 - Einlagerung umgelagerter Retouren ins RS (RMW) [FS-RMW] (von 102 → 101, in 505), BWA 1465 - Zulagerung Retoure aus ARL-FBW [FS-FBW] (von 102 → 101, in 505), BWA 1476 - Zulagerung eines Artikels [FS-Verdichtung] (von 102 → 101, in 505), BWA 1602 - OM - Palette Einlagerung PRL/KS [WE2-OSS] (von 102 → 101, in 505), BWA 1604 - OM - Palette in freien Bestand [WE2-OSS] (von 102 → 101, in 505), BWA 1701 - ARL-Einlagerung "M"-Avise [ARL] (von 102 → 101, in 505), BWA 1702 - ARL-Einlagerung "P"-Avise [ARL] (von 102 → 101, in 505), BWA 1705 - ARL-Einlagerung "O"-Avise [ARL] (von 102 → 101, in 505), BWA 1706 - ARL-Einlagerung "S"-Avise [ARL] (von 102 → 101, in 505), BWA 1707 - ARL-Einlagerung "Z"-Avise [ARL] (von 102 → 101, in 505), BWA 1708 - ARL-Einlagerung LF-BKZ [ARL] (von 102 → 101, in 505), BWA 1715 - ARL-Einlagerung umgelagerter Retouren [ARL] (von 102 → 101, in 505), BWA 1751 - Einlagerung WER am BS [FS-BS] (von 102 → 101, in 505), BWA 1752 - Einlagerung OM-Wanne am BS [FS-BS] (von 102 → 101, in 505)

10223

Bestandsdifferenz aus Kto 1

BESTANDSDIFF_AUS_KTO1

LOCKED_STOCK_TO_STOCK_DIFFERENCE

KR CORE SYNC DS

N

0

243

1

LOCKED_STOCK

4

STOCK_DIFFERENCE

N

25

BWA 1027 - Minuskorr. int. Transport [FEIN] (von 102 → 106, in 505), BWA 1058 - KOKO - Reduzierung Transport [KOKO] (von 102 → 106, in 505), BWA 1073 - Löschen - int. Transp. [LOESCH / Kolli-Avise-Storno] (von 102 → 106, in 505), BWA 1174 - Löschen - ungezielte Umlagerung [LOESCH] (von 109 → 106, in 515), BWA 1185 - Streifenfehler - Minuskorrektur ausgelagerte Rest-AK [Streifenfehler] (von 108 → 106, in 515), BWA 1201 - Ersatzauslagerung aus KS-Bestand, Schritt 2 [Ersatzauslagerung] (von 102 → 121, in 505), BWA 1206 - Löschen - ENDKO-Gebinde [LOESCH / Kolli-Avise-Storno] (von 123 → 106, in 505), BWA 1208 - Minus-Korrektur bei Erfassung von SEIN-Gebinden [SEIN-PRL + SEIN-KS] (von 123 → 106, in 505), BWA 1209 - KOKO - Reduzierung Transport ohne WE Bezug / Inventurbuchung [KOKO] (von 102 → 106, in 505), BWA 1215 - Batchsorter-Rest für Irrläufer [TR] (von 102 → 105, in 505), BWA 1335 - BKZ-Minusdifferenz [Wannen-Storno] (von 131 → 106, in 505), BWA 1462 - Löschen eines Artikels aus OM-Palette [OM-E] (von 102 → 106, in 505), BWA 1470 - Minusdifferenz bei Funkscanner-Verdichtung [FS-Verdichtung] (von 102 → 106, in 505), BWA 1493 - Storno eines Artikels aus intern gebildeter Wanne [Wannen-Storno] (von 102 → 106, in 505), BWA 1500 - Storno eines Artikels aus W-Wanne [Wannen-Storno] (von 102 → 106, in 505), BWA 1713 - ARL-Minusdifferenz vor geplanter WER [ARL] (von 101 → 106, in 505)

10248

Wareneingang gesperrter Bestand Storno

WE_GESPERRT_STORNO

LOCKED_STOCK_MINUS

KR CORE SYNC DS

Y

4XXXXX

207

1

LOCKED_STOCK

6

WE Lieferant

N

55

Abweichung KR Enum in DS zu Fine/HB

10228

Einlagerung in QS-gesperrt

EINLAGERUNG_IN_QS_GESPERRT

LOCKED_STOCK_TO_QUALITY_LOCKED_STOCK

KR CORE SYNC DS

N

0

570

1

LOCKED_STOCK

15

QUALITY_LOCKED_STOCK

N

26

BWA 1018 - Einlagerung aus externem Transport ungezielt [HRL] (von 109 → 101, in 516), BWA 1019 - Einlagerung Umfuhr aus anderem Lagerbetrieb ohne Transport-ID (PRL) [SEIN-PRL] (von 109 → 101, in 516), BWA 1022 - Einlagerung aus ENDKO (PRL) [SEIN-PRL] (von 123 → 101, in 506), BWA 1025 - Korrektur - gesperrt → intern [FEIN] (von 108 → 102, in 516), BWA 1096 - Einlagerung aus gesperrtem Bestand [HRL] (von 108 → 101, in 516), BWA 1108 - Erfassung aus ENDKO in int. Transport (HRL, MRL) [SEIN-KS] (von 123 → 102, in 506), BWA 1136 - Mismatch-Korrektur gesperrter Bestand [HRL] (von 108 → 102, in 516), BWA 5005 - man. S-Sperre (von 505 → 506, in 102)

110308

RAS, Abgabe an NB

RAS_ABGABE_AN_NB

LOCKED_STOCK_MINUS

KR CORE SYNC DS

N

0

3150

1

LOCKED_STOCK

93

BUB-wirks. BestKorr

N

57

BWA 1302 - Auslagerung BKZ-Ware [FS-BKZ] (von 131 → 132, in 505)

10231

Ausbuchung Umfuhr

AUSBUCHUNG_UMFUHR

STOCK_IN_TRANSIT_TO_LOCKED_STOCK

KR CORE SYNC DS

N

0

3491

2

STOCK_IN_TRANSIT

1

LOCKED_STOCK

Y

27

BWA 1179 - Löschen Avis aus ext. Betrieb mit Belastung Quellbetrieb V2 [Kolli-Avise-Storno] (von 151 → 152, in 515), BWA 1179 - Löschen Avis aus ext. Betrieb mit Belastung Quellbetrieb V2 [Kolli-Avise-Storno] (von 151 → 152, in 516), BWA 1488 - Storno einer Retoure aus K-Wanne mit Belastung Betrieb V2 [Wannen-Storno] (von 151 → 152, in 515), BWA 1488 - Storno einer Retoure aus K-Wanne mit Belastung Betrieb V2 [Wannen-Storno] (von 151 → 152, in 516), BWA 1489 - Storno einer Retoure aus U/A-Wanne mit Belastung Betrieb V2 [Wannen-Storno] (von 151 → 152, in 515), BWA 1489 - Storno einer Retoure aus U/A-Wanne mit Belastung Betrieb V2 [Wannen-Storno] (von 151 → 152, in 516), BWA 1490 - Storno einer Retoure aus R-Wanne mit Belastung RTB [Wannen-Storno] (von 140 → 141, in 515), BWA 1490 - Storno einer Retoure aus R-Wanne mit Belastung RTB [Wannen-Storno] (von 140 → 141, in 516), BWA 1494 - Storno einer Retoure aus N-Wanne mit Belastung RTB [Wannen-Storno] (von 130 → 133, in 515), BWA 1494 - Storno einer Retoure aus N-Wanne mit Belastung RTB [Wannen-Storno] (von 130 → 133, in 516), BWA 1522 - Storno eingelagerter BKZ-Artikel nach Doppelavise, Schritt 2 [Retouren-Avise] (von 130 → 133, in 515), BWA 1522 - Storno eingelagerter BKZ-Artikel nach Doppelavise, Schritt 2 [Retouren-Avise] (von 130 → 133, in 516)

10231

Ausbuchung Umfuhr

AUSBUCHUNG_UMFUHR

STOCK_IN_TRANSIT_TO_LOCKED_STOCK

KR CORE SYNC DS

N

0

3492

2

STOCK_IN_TRANSIT

1

LOCKED_STOCK

N

28

BWA 1010 - EAL-Karton für externe Verladung vorbereitet [Verladung] (von 104 → 102, in 515), BWA 1020 - Einlagerung KABA aus anderem Lagerbetrieb [SEIN-Luke] (von 151 → 102, in 515), BWA 1123 - Mismatch-Korrektur Ext Transport [HRL] (von 104 → 102, in 515), BWA 1127 - Einlagerung Umfuhr aus anderem Lagerbetrieb mit Transport-ID [SEIN-Luke] (von 151 → 102, in 515), BWA 1132 - Einlagerung aus ENDAUS in int. Transport [SEIN-Luke] (von 104 → 102, in 515), BWA 1301 - Einlagerung BKZ-Ware [FS-BKZ] (von 130 → 131, in 515), BWA 1608 - WE aus externem Transport (eigener Betrieb) [Diverse] (von 104 → 102, in 515), BWA 1609 - WE aus externem Transport (Fremdbetrieb) [Diverse] (von 151 → 102, in 515), BWA 1714 - Umlagerung Retouren nach Höhenkontrolle [ARL] (von 140 → 102, in 505)

10027

Einlagerung aus Transport

EINLAGERUNG_TRANSPORT

STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK

KR CORE SYNC DS

N

0

3361

2

STOCK_IN_TRANSIT

3

DELIVERABLE_STOCK

N

46

29

bei RTS = STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK_H46

BWA 1001 - Einlagerung mit TID [FS-RL] (von 104 → 101, in 515), BWA 1002 - Einlagerung ohne TID [FS-RL] (von 104 → 101, in 515), BWA 1091 - Einlagerung aus Transport in verf.Bestand [HRL] (von 104 → 101, in 515), BWA 1128 - Einlagerung Paletten aus ext. Betrieb mit Transp.-ID [WE-PRL] (von 151 → 101, in 515), BWA 1451 - Einlagerung einer Kundenumfuhr aus anderem Lagerbetrieb ins KS (RMW) [FS-RMW] (von 151 → 101, in 515), BWA 1452 - Einlagerung einer Umfuhr aus anderem Lagerbetrieb ins KS (RMW) [FS-RMW] (von 151 → 101, in 515), BWA 1615 - Zulagerung OM-/Muster-Umfuhr aus FBW [FS-FBW] (von 142 → 101, in 505), BWA 1619 - WE OM-Kolli aus externem Transport (Fremdbetrieb) [WE2-OSS] (von 151 → 101, in 515), BWA 1703 - ARL-Einlagerung "U"-Avise [ARL] (von 151 → 101, in 515), BWA 1704 - ARL-Einlagerung "K"-Avise [ARL] (von 151 → 101, in 515), BWA 1753 - Einlagerung OM-Wanne am BS aus Verladung [FS-BS] (von 104 → 101, in 515), BWA 5059 - Freischaltung I-gesperrt (von 507 → 505, in 101)

10027

Einlagerung aus Transport

EINLAGERUNG_TRANSPORT

STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK

KR CORE SYNC DS

N

0

3362

2

STOCK_IN_TRANSIT

3

DELIVERABLE_STOCK

Y

46

30

bei RTS = STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK_H46

100019

Einlagerung Transport RMW

EINLAGERUNG_TRANSPORT_RTMW

STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK

KR CORE SYNC DS

N

0

3363

2

STOCK_IN_TRANSIT

3

DELIVERABLE_STOCK

56

BWA 1450 - Einlagerung einer Retoure ins KS (RMW) [FS-RMW] (von 140 → 101, in 515), BWA 1461 - Zulagerung Einzelteil aus FBW [FS-FBW] (von 142 → 101, in 505), BWA 1700 - ARL-Einlagerung "R"-Avise [ARL] (von 140 → 101, in 515), BWA 1750 - Einlagerung einer Retoure auf den Batchsorter (RMW) [FS-BS] (von 140 → 101, in 515)

10232

Ausbuchung Transportdifferenzen

AUSBUCHUNG_TRANSPORTDIFF

STOCK_IN_TRANSIT_TO_STOCK_DIFFERENCE

KR CORE SYNC DS

N

0

379

2

STOCK_IN_TRANSIT

4

STOCK_DIFFERENCE

N

31

BWA 1078 - Löschen - int. Umlag. mit TLIB [LOESCH / Kolli-Avise-Storno] (von 104 → 106, in 515), BWA 1078 - Löschen - int. Umlag. mit TLIB [LOESCH / Kolli-Avise-Storno] (von 104 → 106, in 516), BWA 1089 - Minuskorrektur ext. Transport [SEIN-Korrektur] (von 104 → 106, in 515), BWA 1089 - Minuskorrektur ext. Transport [SEIN-Korrektur] (von 104 → 106, in 516), BWA 1170 - Löschen Avise HDL [LOESCH / Kolli-Avise-Storno] (von 104 → 106, in 515), BWA 1170 - Löschen Avise HDL [LOESCH / Kolli-Avise-Storno] (von 104 → 106, in 516), BWA 1177 - Löschen Avis aus ext. Betrieb ohne Belastung Quellbetrieb [Kolli-Avise-Storno] (von 151 → 106, in 515), BWA 1177 - Löschen Avis aus ext. Betrieb ohne Belastung Quellbetrieb [Kolli-Avise-Storno] (von 151 → 106, in 516), BWA 1463 - Storno einer Retoure aus FBW ohne Belastung Quellbetrieb [Wannen-Storno] (von 142 → 106, in 505), BWA 1463 - Storno einer Retoure aus FBW ohne Belastung Quellbetrieb [Wannen-Storno] (von 142 → 106, in 506), BWA 1464 - Storno OM-/Muster-Umfuhr aus FBW ohne Belastung Quellbetrieb [Wannen-Storno] (von 142 → 106, in 505), BWA 1464 - Storno OM-/Muster-Umfuhr aus FBW ohne Belastung Quellbetrieb [Wannen-Storno] (von 142 → 106, in 506), BWA 1495 - Storno einer Retoure aus N-Wanne ohne Belastung RTB [Wannen-Storno] (von 130 → 106, in 515), BWA 1495 - Storno einer Retoure aus N-Wanne ohne Belastung RTB [Wannen-Storno] (von 130 → 106, in 516), BWA 1496 - Storno einer Retoure aus R-Wanne ohne Belastung RTB [Wannen-Storno] (von 140 → 106, in 515), BWA 1496 - Storno einer Retoure aus R-Wanne ohne Belastung RTB [Wannen-Storno] (von 140 → 106, in 516), BWA 1497 - Storno einer Retoure aus N-Wanne vor Umbuchung [WER-BKZ] (von 130 → 106, in 515), BWA 1498 - Storno einer Retoure aus K-Wanne ohne Belastung Betrieb [Wannen-Storno] (von 151 → 106, in 515), BWA 1498 - Storno einer Retoure aus K-Wanne ohne Belastung Betrieb [Wannen-Storno] (von 151 → 106, in 516), BWA 1499 - Storno einer Retoure aus U/A-Wanne ohne Belastung Betrieb [Wannen-Storno] (von 151 → 106, in 515), BWA 1499 - Storno einer Retoure aus U/A-Wanne ohne Belastung Betrieb [Wannen-Storno] (von 151 → 106, in 516), BWA 1503 - Endauslagerung Korrektur EAF-Bestand [Diverse] (von 122 → 106, in 515), BWA 1520 - Storno BKZ-Avise nach Doppelavise [Retouren-Avise] (von 130 → 133, in 515), BWA 1520 - Storno BKZ-Avise nach Doppelavise [Retouren-Avise] (von 130 → 133, in 516), BWA 1524 - Storno nicht eingelagerte BS-Überware [Retouren-Avise] (von 140 → 106, in 515), BWA 1524 - Storno nicht eingelagerte BS-Überware [Retouren-Avise] (von 140 → 106, in 516), BWA 1613 - Storno OM-/Muster-Umfuhr ohne Belastung Quellbetrieb [Wannen-Storno] (von 151 → 106, in 515), BWA 1614 - Storno einer OM-Wanne (eigener Betrieb) [Wannen-Storno] (von 104 → 106, in 515)

10233

Bestandsdifferenz aus Transport

BESTANDSDIFF_AUS_TRANSPORT

STOCK_IN_TRANSIT_TO_STOCK_DIFFERENCE

KR CORE SYNC DS

N

0

294

2

STOCK_IN_TRANSIT

4

STOCK_DIFFERENCE

32

BWA 1178 - Löschen Avis aus ext. Betrieb mit Belastung Quellbetrieb V1 [Kolli-Avise-Storno] (von 151 → 152, in 515), BWA 1178 - Löschen Avis aus ext. Betrieb mit Belastung Quellbetrieb V1 [Kolli-Avise-Storno] (von 151 → 152, in 516), BWA 1491 - Storno einer Retoure aus K-Wanne mit Belastung Betrieb [Wannen-Storno] (von 151 → 152, in 515), BWA 1491 - Storno einer Retoure aus K-Wanne mit Belastung Betrieb [Wannen-Storno] (von 151 → 152, in 516), BWA 1492 - Storno einer Retoure aus U/A-Wanne mit Belastung Betrieb [Wannen-Storno] (von 151 → 152, in 515), BWA 1492 - Storno einer Retoure aus U/A-Wanne mit Belastung Betrieb [Wannen-Storno] (von 151 → 152, in 516), BWA 1612 - Storno OM-/Muster-Umfuhr mit Belastung Quellbetrieb [Wannen-Storno] (von 151 → 152, in 515)

10234

QS-Warenzugang aus Transport

QS_WARENZUGANG_AUS_TRANSPORT

STOCK_IN_TRANSIT_TO_QUALITY_LOCKED_STOCK

KR CORE SYNC DS

N

0

96

2

STOCK_IN_TRANSIT

15

QUALITY_LOCKED_STOCK

N

33

BWA 1001 - Einlagerung mit TID [FS-RL] (von 104 → 101, in 516), BWA 1002 - Einlagerung ohne TID [FS-RL] (von 104 → 101, in 516), BWA 1010 - EAL-Karton für externe Verladung vorbereitet [Verladung] (von 104 → 102, in 516), BWA 1020 - Einlagerung KABA aus anderem Lagerbetrieb [SEIN-Luke] (von 151 → 102, in 516), BWA 1091 - Einlagerung aus Transport in verf.Bestand [HRL] (von 104 → 101, in 516), BWA 1123 - Mismatch-Korrektur Ext Transport [HRL] (von 104 → 102, in 516), BWA 1127 - Einlagerung Umfuhr aus anderem Lagerbetrieb mit Transport-ID [SEIN-Luke] (von 151 → 102, in 516), BWA 1128 - Einlagerung Paletten aus ext. Betrieb mit Transp.-ID [WE-PRL] (von 151 → 101, in 516), BWA 1132 - Einlagerung aus ENDAUS in int. Transport [SEIN-Luke] (von 104 → 102, in 516), BWA 1450 - Einlagerung einer Retoure ins KS (RMW) [FS-RMW] (von 140 → 101, in 516), BWA 1451 - Einlagerung einer Kundenumfuhr aus anderem Lagerbetrieb ins KS (RMW) [FS-RMW] (von 151 → 101, in 516), BWA 1452 - Einlagerung einer Umfuhr aus anderem Lagerbetrieb ins KS (RMW) [FS-RMW] (von 151 → 101, in 516), BWA 1461 - Zulagerung Einzelteil aus FBW [FS-FBW] (von 142 → 101, in 506), BWA 1619 - WE OM-Kolli aus externem Transport (Fremdbetrieb) [WE2-OSS] (von 151 → 101, in 516), BWA 1700 - ARL-Einlagerung "R"-Avise [ARL] (von 140 → 101, in 516), BWA 1703 - ARL-Einlagerung "U"-Avise [ARL] (von 151 → 101, in 516), BWA 1704 - ARL-Einlagerung "K"-Avise [ARL] (von 151 → 101, in 516), BWA 1750 - Einlagerung einer Retoure auf den Batchsorter (RMW) [FS-BS] (von 140 → 101, in 516), BWA 1753 - Einlagerung OM-Wanne am BS aus Verladung [FS-BS] (von 104 → 101, in 516)

10235

Reduzierung fakturierfähiger Bestand

REDUZIERUNG_FAKTURF_BESTAND

DELIVERABLE_STOCK_TO_LOCKED_STOCK

KR CORE SYNC DS

N

0

3401

3

DELIVERABLE_STOCK

1

LOCKED_STOCK

N

34

BWA 1007 - Auslagerung via AUS [AUS] (von 101 → 108, in 505), BWA 1067 - Auslagerung zur Rücksendung (WRS) [AUS] (von 101 → 108, in 505), BWA 1069 - Musteraufteilung für 2. Stichprobe aus RL [QS2] (von 101 → 115, in 505), BWA 1094 - Ausbuchung wegen Gassensperre [HRL] (von 101 → 102, in 505), BWA 1112 - Ausschleusung zur Qual-Bahn eingel. [WE] (von 101 → 102, in 505), BWA 1116 - Ausschleusung zur Nako-Bahn [WE] (von 101 → 102, in 505), BWA 1117 - Musteraufteilung aus RL [WE] (von 101 → 115, in 505), BWA 1119 - Umlagerung innerhalb des VZ in int. RL [HRLUML] (von 101 → 102, in 505), BWA 1122 - Mismatch-Korrektur Int Umlagerung [HRL] (von 119 → 102, in 505), BWA 1131 - Bestandsumfuhr per int. Transport [BU] (von 101 → 102, in 505), BWA 1145 - Mismatch-Korrektur verf. Bestand [HRL] (von 101 → 102, in 505), BWA 1154 - Mismatch-Korrektur CK-Rest [HRL] (von 119 → 102, in 505), BWA 1165 - Lagerraster-Storno KS mit Ziel KS [LR-Editor] (von 101 → 102, in 505), BWA 1193 - Lagerraster-Storno PRL mit Ziel PRL [LR-Editor] (von 101 → 102, in 505), BWA 1200 - Ersatzauslagerung aus KS-Bestand, Schritt 1 [Ersatzauslagerung] (von 101 → 102, in 505), BWA 1308 - SDV A-Ware / MM [AUS] (von 101 → 108, in 505), BWA 1312 - Auslagerung IWA [AUS] (von 101 → 108, in 505), BWA 1314 - SDV B-Ware und Vernichtung [AUS] (von 101 → 108, in 505), BWA 1316 - Auslagerung zur Nachverarbeitung [AUS] (von 101 → 108, in 505), BWA 1321 - Differenzenklärung HRL [AUS] (von 101 → 102, in 505), BWA 1322 - Umlagerung intern [AUS] (von 101 → 102, in 505), BWA 1323 - Umlagerung in andere Betriebe [AUS] (von 101 → 109, in 505), BWA 1327 - Umlagerung intern ohne Zielvorgabe [AUS] (von 101 → 108, in 505), BWA 1331 - Auslagerung zur Endauslagerung von Kartons (ENDKO) [ENDKO] (von 101 → 123, in 505), BWA 1474 - Entnahme eines Artikels [FS-Verdichtung] (von 101 → 102, in 505), BWA 1712 - ARL-Bildung FBW [ARL] (von 101 → 102, in 505)

10236

Einstellung in Umfuhr

EINSTELLUNG_IN_UMFUHR

DELIVERABLE_STOCK_TO_STOCK_IN_TRANSIT

KR CORE SYNC DS

N

0

3461

3

DELIVERABLE_STOCK

2

STOCK_IN_TRANSIT

Y

35

BWA 1012 - Bestandsumfuhr in anderen Lagerbetrieb [BU] (von 101 → 150, in 505)

10236

Einstellung in Umfuhr

EINSTELLUNG_IN_UMFUHR

DELIVERABLE_STOCK_TO_STOCK_IN_TRANSIT

KR CORE SYNC DS

N

0

3462

3

DELIVERABLE_STOCK

2

STOCK_IN_TRANSIT

N

36

BWA 1006 - Auslagerung via LRSTORNO [LR-Editor] (von 101 → 104, in 505), BWA 1014 - Umlagerung intern (Wunschliste) [BU] (von 101 → 104, in 505), BWA 1114 - Bestandsumfuhr intern via ext. Transport [HRLUML] (von 101 → 104, in 505), BWA 1319 - Umlagerung intern via Transport [AUS] (von 101 → 104, in 505), BWA 1330 - Auslagerung zur Endauslagerung via Sorter [EAL-Sorter] (von 101 → 122, in 505)

10237

Minusdifferenz freier Bestand

MINUSDIFFERENZ_FREIER_BESTAND

DELIVERABLE_STOCK_TO_STOCK_DIFFERENCE

KR CORE SYNC DS

N

0

220

3

DELIVERABLE_STOCK

4

STOCK_DIFFERENCE

N

37

BWA 1008 - Ersatzauslagerung - Nachschub [Ersatzauslagerung] (von 101 → 103, in 505), BWA 1013 - Minusdifferenz [AUS] (von 101 → 106, in 505), BWA 1034 - Batchsorter-Rest (1bbb) [Fakturierung/BS] (von 101 → 105, in 505), BWA 1042 - Ersatzauslagerung aus KS-Bestand [Ersatzauslagerung] (von 101 → 121, in 505), BWA 1074 - Löschen - Nachschub-Rest [LOESCH] (von 103 → 106, in 505), BWA 1074 - Löschen - Nachschub-Rest [LOESCH] (von 103 → 106, in 506), BWA 1077 - Löschen - int. Umlag. [LOESCH] (von 119 → 106, in 505), BWA 1164 - Lagerraster-Storno KS ohne Ziel [LR-Editor] (von 101 → 108, in 505), BWA 1167 - KOKO - Reduzierung eingel. [KOKO] (von 101 → 106, in 505), BWA 1181 - Streifenfehler - Minuskorrektur Rest-AK [Streifenfehler] (von 101 → 106, in 505), BWA 1186 - Zwangs-Quittierung CKS Restmenge [LPF manuell] (von 119 → 106, in 505), BWA 1192 - Lagerraster-Storno PRL ohne Ziel [LR-Editor] (von 101 → 108, in 505), BWA 1196 - Ersatzauslagerung - Nachschub BS/CK/KLX, Schritt 1 [Ersatzauslagerung] (von 101 → 102, in 505), BWA 1198 - Ersatzauslagerung - Batchsorter-Rest [Ersatzauslagerung] (von 101 → 105, in 505), BWA 1211 - KOKO - Reduzierung eingel. ohne WE Bezug / Inventurbuchung [KOKO] (von 101 → 106, in 505), BWA 1250 - Ersatzauslagerung aus RL-Bestand, Schritt 1 [Ersatzauslagerung] (von 101 → 102, in 505), BWA 1253 - Ersatzauslagerung aus freiem Nachschub, Schritt 2 [Ersatzauslagerung] (von 101 → 102, in 505), BWA 1253 - Ersatzauslagerung aus freiem Nachschub, Schritt 2 [Ersatzauslagerung] (von 101 → 102, in 506), BWA 1320 - Differenz [AUS] (von 101 → 106, in 505), BWA 1472 - Minusdifferenz bei Funkscanner-Inventur [FS-Inventur] (von 101 → 106, in 505), BWA 1475 - Minusdifferenz auf Lagerplatz [FS-Verdichtung] (von 101 → 106, in 505), BWA 1482 - Minuskorrektur [Tablet] (von 101 → 106, in 505), BWA 1710 - ARL-Bestandsabgleich: Minusdifferenz [ARL] (von 101 → 106, in 505)

10238

QS Sperrung

QS_SPERRUNG

DELIVERABLE_STOCK_TO_QUALITY_LOCKED_STOCK

KR CORE SYNC DS

N

0

86

3

DELIVERABLE_STOCK

15

QUALITY_LOCKED_STOCK

N

38

BWA 1040 - Einlagerung - KS-Bestand aus Nachschub [FS-KS-NS] (von 103 → 101, in 506), BWA 5005 - man. S-Sperre (von 505 → 506, in 101), BWA 5005 - man. S-Sperre (von 505 → 506, in 119)

110312

frei an zGesperrt

FREI_AN_ZGESPERRT

DELIVERABLE_STOCK_TO_RESERVABLE_LOCKED_STOCK

KR CORE SYNC DS

N

0

6000

3

DELIVERABLE_STOCK

78

RESERVABLE_LOCKED_STOCK

1562

70

BWA 1009 - Bestandsumfuhr via int. zusagb. Transport [BU] (von 101 → 124, in 505)

10239

Plusdiff. Vorgesehen zur Einlagerung

PLUSDIFF_ZUR_EINLAGERUNG

STOCK_DIFFERENCE_TO_LOCKED_STOCK

KR CORE SYNC DS

N

0

242

4

STOCK_DIFFERENCE

1

LOCKED_STOCK

N

39

BWA 1026 - Pluskorr. int. Transport [FEIN] (von 105 → 102, in 515), BWA 1103 - Mismatch-Korrektur Großkunde (Ganzkolli) [HRL] (von 107 → 102, in 515), BWA 1105 - Plusdiff.-Erfassung für Funkscanner [FEIN] (von 105 → 102, in 515), BWA 1109 - Einlagerung Umfuhr aus anderem Lagerbetrieb ohne Transport-ID in int. Transport [SEIN-Luke] (von 105 → 102, in 515), BWA 1110 - Plusdifferenzen-Einlagerung in int. Transport [SEIN-Luke] (von 105 → 102, in 515), BWA 1140 - Einlagerung ENDAUS ohne Transport-ID [SEIN-Luke] (von 105 → 102, in 515), BWA 1152 - Mismatch-Korrektur BS/CK/KLX [HRL] (von 121 → 102, in 515), BWA 1153 - Mismatch-Korrektur BS-Rest [HRL] (von 105 → 102, in 515), BWA 1160 - Mismatch-Korrektur Differenz [HRL] (von 106 → 102, in 515), BWA 1182 - Korrektur - gelöscht → intern [FEIN] (von 106 → 102, in 515), BWA 1195 - Mismatch-Korrektur KS fakt. (final) [HRL] (von 121 → 102, in 515), BWA 1207 - Plus-Korrektur bei Erfassung von SEIN-Gebinden [SEIN-PRL + SEIN-KS] (von 105 → 123, in 515), BWA 1210 - KOKO - Erhöhung Transport ohne WE Bezug / Inventurbuchung [KOKO] (von 105 → 102, in 515), BWA 1334 - BKZ-Zulagerung eingelagert [WER-BKZ] (von 106 → 131, in 515), BWA 1337 - BKZ-Artikel Plusdifferenz [WER-BKZ] (von 105 → 131, in 515), BWA 1404 - Einlagerung einer Plusdifferenz in PD-Wanne [WER-P] (von 105 → 102, in 515), BWA 1408 - Erfassung von Ware als Zeit/Identware [WER-Z] (von 105 → 102, in 515), BWA 1409 - Einlagerung von Collins-Ware als Plusdifferenz [WER-P] (von 105 → 102, in 515), BWA 1045 - Einlagerung aus Differenz [HRL] (von 106 → 101, in 514)

10240

Transportbestand Korrektur Plus

TRANSPORTBESTAND_PLUS

STOCK_DIFFERENCE_TO_STOCK_IN_TRANSIT

KR CORE SYNC DS

N

0

218

4

STOCK_DIFFERENCE

2

STOCK_IN_TRANSIT

N

40

BWA 1088 - Pluskorrektur ext. Transport [SEIN-Korrektur] (von 105 → 104, in 515), BWA 1333 - BKZ-Zulagerung nicht eingelagert [FS-BKZ] (von 106 → 130, in 515)

10241

Plusdifferenz freier Bestand

PLUSDIFFERENZ_FREIER_BESTAND

STOCK_DIFFERENCE_TO_DELIVERABLE_STOCK

KR CORE SYNC DS

N

0

228

4

STOCK_DIFFERENCE

3

DELIVERABLE_STOCK

N

41

BWA 1005 - Plusdiff.-Einlagerung [FEIN] (von 105 → 101, in 515), BWA 1028 - Plusdifferenzen-Einlagerung (PRL) [SEIN-PRL] (von 105 → 101, in 515), BWA 1045 - Einlagerung aus Differenz [HRL] (von 106 → 101, in 515), BWA 1046 - Umleitung BS-Nachschub [FS-KS-NS] (von 105 → 101, in 515), BWA 1124 - Storno-Korrektur Großkunde (Ganzkolli) [HRL] (von 107 → 101, in 515), BWA 1125 - Storno-Korrektur KS frei [HRL] (von 103 → 101, in 505), BWA 1155 - Storno-Korrektur BS/CK/KLX [HRL] (von 121 → 101, in 515), BWA 1156 - Storno-Korrektur BS-Rest [HRL] (von 105 → 101, in 515), BWA 1168 - KOKO - Erhöhung eingel. [KOKO] (von 105 → 101, in 515), BWA 1203 - Storno-Korrektur KS fakt. (final) [HRL] (von 121 → 101, in 515), BWA 1212 - KOKO - Erhöhung eingel. ohne WE Bezug / Inventurbuchung [KOKO] (von 105 → 101, in 515), BWA 1471 - Plusdifferenz bei Funkscanner-Verdichtung [FS-Verdichtung] (von 105 → 101, in 515), BWA 1473 - Plusdifferenz bei Funkscanner-Inventur [FS-Inventur] (von 105 → 101, in 515), BWA 1480 - Plusdifferenzen-Zulagerungen mit Funkscanner [FS-RMW] (von 105 → 101, in 515), BWA 1711 - ARL-Bestandsabgleich: Plusdifferenz [ARL] (von 105 → 101, in 515)

10242

Plusdifferenz QS-gesperrt

PLUSDIFFERENZ_QS_GESPERRT

STOCK_DIFFERENCE_TO_QUALITY_LOCKED_STOCK

KR CORE SYNC DS

N

0

97

4

STOCK_DIFFERENCE

15

QUALITY_LOCKED_STOCK

N

42

BWA 1026 - Pluskorr. int. Transport [FEIN] (von 105 → 102, in 516), BWA 1210 - KOKO - Erhöhung Transport ohne WE Bezug / Inventurbuchung [KOKO] (von 105 → 102, in 516), BWA 1212 - KOKO - Erhöhung eingel. ohne WE Bezug / Inventurbuchung [KOKO] (von 105 → 101, in 516), BWA 1404 - Einlagerung einer Plusdifferenz in PD-Wanne [WER-P] (von 105 → 102, in 516), BWA 1711 - ARL-Bestandsabgleich: Plusdifferenz [ARL] (von 105 → 101, in 516)

10247

Wareneingang gesperrter Bestand

WE_GESPERRT

LOCKED_STOCK_PLUS

KR CORE SYNC DS

Y

4XXXXX

3050

6

WE Lieferant

1

LOCKED_STOCK

N

54

Abweichung KR Enum in DS zu Fine/HB

BWA 5003 - R-Freischaltung (von 502 → 504, in 101), BWA 5003 - R-Freischaltung (von 502 → 504, in 102), BWA 5003 - R-Freischaltung (von 502 → 504, in 119), BWA 5004 - Freischaltung (von 502 → 505, in 102), BWA 5040 - Freischaltung ext. (von 512 → 515, in 115), BWA 5040 - Freischaltung ext. (von 512 → 515, in 120), BWA 5042 - R-Freischaltung ext. (von 512 → 514, in 115), BWA 5042 - R-Freischaltung ext. (von 512 → 514, in 120), BWA 5045 - Freischaltung manuell (von 502 → 505, in 102), BWA 5046 - Freischaltung manuell ext. (von 512 → 515, in 115), BWA 5046 - Freischaltung manuell ext. (von 512 → 515, in 120), BWA 5070 - Rücksendung nach Nachbearbeitung (von 513 → 514, in 108)

10077

Wareneingang

WARENEINGANG

DELIVERABLE_STOCK_PLUS

KR CORE SYNC DS

Y

4XXXXX

3001

6

WE Lieferant

3

DELIVERABLE_STOCK

N

49

Abweichung KR Enum in DS zu Fine/HB

BWA 5004 - Freischaltung (von 502 → 505, in 101), BWA 5004 - Freischaltung (von 502 → 505, in 119), BWA 5045 - Freischaltung manuell (von 502 → 505, in 101), BWA 5045 - Freischaltung manuell (von 502 → 505, in 119)

10243

Auslagerung QS-gesperrt

AUSLAGERUNG_QS_GESPERRT

QUALITY_LOCKED_STOCK_TO_LOCKED_STOCK

KR CORE SYNC DS

N

0

572

15

QUALITY_LOCKED_STOCK

1

LOCKED_STOCK

N

43

BWA 1066 - Musteraufteilung für 2. Stichprobe aus Transport [QS2] (von 102 → 115, in 506), BWA 1067 - Auslagerung zur Rücksendung (WRS) [AUS] (von 101 → 108, in 506), BWA 1069 - Musteraufteilung für 2. Stichprobe aus RL [QS2] (von 101 → 115, in 506), BWA 1117 - Musteraufteilung aus RL [WE] (von 101 → 115, in 506), BWA 1304 - Auslagerung aus gesperrtem Bestand nach WE2 Storno [AUS] (von 101 → 108, in 506), BWA 1308 - SDV A-Ware / MM [AUS] (von 101 → 108, in 506), BWA 1312 - Auslagerung IWA [AUS] (von 101 → 108, in 506), BWA 1314 - SDV B-Ware und Vernichtung [AUS] (von 101 → 108, in 506), BWA 1316 - Auslagerung zur Nachverarbeitung [AUS] (von 101 → 108, in 506), BWA 5006 - man. S-Freigabe (von 506 → 505, in 102)

10244

int.Umlag. aus QS-gesp. via Transport

INT_UMLAG_QS_GESP_TRANSPORT

QUALITY_LOCKED_STOCK_TO_STOCK_IN_TRANSIT

KR CORE SYNC DS

N

0

574

15

QUALITY_LOCKED_STOCK

2

STOCK_IN_TRANSIT

N

44

BWA 1006 - Auslagerung via LRSTORNO [LR-Editor] (von 101 → 104, in 506), BWA 1011 - EAL-Karton für interne Einlagerung vorbereitet [Verladung] (von 102 → 104, in 506), BWA 1014 - Umlagerung intern (Wunschliste) [BU] (von 101 → 104, in 506), BWA 1607 - Verladung in externen Transport (Fremdbetrieb) [BU] (von 102 → 150, in 506)

10245

QS Entsperrung

QS_ENTSPERRUNG

QUALITY_LOCKED_STOCK_TO_DELIVERABLE_STOCK

KR CORE SYNC DS

N

0

87

15

QUALITY_LOCKED_STOCK

3

DELIVERABLE_STOCK

N

47

BWA 5006 - man. S-Freigabe (von 506 → 505, in 101), BWA 5006 - man. S-Freigabe (von 506 → 505, in 119)

10246

Minusdiff. m QS-gesp. Bestand

MINUSDIFF_QS_GESP_BESTAND

QUALITY_LOCKED_STOCK_TO_STOCK_DIFFERENCE

KR CORE SYNC DS

N

0

98

15

QUALITY_LOCKED_STOCK

4

STOCK_DIFFERENCE

48

BWA 1027 - Minuskorr. int. Transport [FEIN] (von 102 → 106, in 506), BWA 1034 - Batchsorter-Rest (1bbb) [Fakturierung/BS] (von 101 → 105, in 506), BWA 1042 - Ersatzauslagerung aus KS-Bestand [Ersatzauslagerung] (von 101 → 121, in 506), BWA 1055 - Löschen - zusagb. int Transport [LOESCH] (von 124 → 106, in 506), BWA 1058 - KOKO - Reduzierung Transport [KOKO] (von 102 → 106, in 506), BWA 1073 - Löschen - int. Transp. [LOESCH / Kolli-Avise-Storno] (von 102 → 106, in 506), BWA 1077 - Löschen - int. Umlag. [LOESCH] (von 119 → 106, in 506), BWA 1167 - KOKO - Reduzierung eingel. [KOKO] (von 101 → 106, in 506), BWA 1181 - Streifenfehler - Minuskorrektur Rest-AK [Streifenfehler] (von 101 → 106, in 506), BWA 1197 - Ersatzauslagerung - Nachschub BS/CK/KLX, Schritt 2 [Ersatzauslagerung] (von 102 → 121, in 506), BWA 1198 - Ersatzauslagerung - Batchsorter-Rest [Ersatzauslagerung] (von 101 → 105, in 506), BWA 1201 - Ersatzauslagerung aus KS-Bestand, Schritt 2 [Ersatzauslagerung] (von 102 → 121, in 506), BWA 1209 - KOKO - Reduzierung Transport ohne WE Bezug / Inventurbuchung [KOKO] (von 102 → 106, in 506), BWA 1211 - KOKO - Reduzierung eingel. ohne WE Bezug / Inventurbuchung [KOKO] (von 101 → 106, in 506), BWA 1320 - Differenz [AUS] (von 101 → 106, in 506), BWA 1462 - Löschen eines Artikels aus OM-Palette [OM-E] (von 102 → 106, in 506), BWA 1470 - Minusdifferenz bei Funkscanner-Verdichtung [FS-Verdichtung] (von 102 → 106, in 506), BWA 1472 - Minusdifferenz bei Funkscanner-Inventur [FS-Inventur] (von 101 → 106, in 506), BWA 1475 - Minusdifferenz auf Lagerplatz [FS-Verdichtung] (von 101 → 106, in 506), BWA 1482 - Minuskorrektur [Tablet] (von 101 → 106, in 506), BWA 1493 - Storno eines Artikels aus intern gebildeter Wanne [Wannen-Storno] (von 102 → 106, in 506), BWA 1710 - ARL-Bestandsabgleich: Minusdifferenz [ARL] (von 101 → 106, in 506)

110319

QS-gesperrt an zGesperrt

QSGESPERRT_AN_ZGESPERRT

QUALITY_LOCKED_STOCK_TO_RESERVABLE_LOCKED_STOCK

KR CORE SYNC DS

N

0

6014

15

QUALITY_LOCKED_STOCK

78

RESERVABLE_LOCKED_STOCK

78

BWA 5006 - man. S-Freigabe (von 506 → 505, in 124)

110321

QS-gesperrt an zTLIB

QSGESPERRT_AN_ZTLIB

QUALITY_LOCKED_STOCK_TO_RESERVABLE_STOCK_IN_TRANSIT

KR CORE SYNC DS

N

0

6017

15

QUALITY_LOCKED_STOCK

79

RESERVABLE_STOCK_IN_TRANSIT

79

BWA 1015 - Verladung in ext. zusagb. Transport [BU] (von 124 → 153, in 506)

110313

zGesperrt an gesperrt

ZGESPERRT_AN_GESPERRT

RESERVABLE_LOCKED_STOCK_TO_LOCKED_STOCK 

KR CORE SYNC DS

N

0

6002

78

RESERVABLE_LOCKED_STOCK

1

LOCKED_STOCK

71

110320

zGesperrt an Frei

ZGESPERRT_AN_FREI

RESERVABLE_LOCKED_STOCK_TO_DELIVERABLE_STOCK

KR CORE SYNC DS

N

0

6001

78

RESERVABLE_LOCKED_STOCK

3

DELIVERABLE_STOCK

1562

76

BWA 1016 - Einlagerung aus int. zusagb. Transport [HRL] (von 124 → 101, in 505)

110316

zGesperrt an Bestandsdifferenz

ZGESPERRT_AN_BESTANDSDIFF

RESERVABLE_LOCKED_STOCK_TO_STOCK_DIFFERENCE

KR CORE SYNC DS

N

0

6007

78

RESERVABLE_LOCKED_STOCK

4

STOCK_DIFFERENCE

74

BWA 1055 - Löschen - zusagb. int Transport [LOESCH] (von 124 → 106, in 505)

110318

zGesperrt an QS-gesperrt

ZGESPERRT_AN_QSGESPERRT

RESERVABLE_LOCKED_STOCK_TO_QUALITY_LOCKED_STOCK 

KR CORE SYNC DS

N

0

6013

78

RESERVABLE_LOCKED_STOCK

15

QUALITY_LOCKED_STOCK

77

BWA 5005 - man. S-Sperre (von 505 → 506, in 124)

110314

zGesperrt an zTLIB

ZGESPERRT_AN_ZTLIB

RESERVABLE_LOCKED_STOCK_TO_RESERVABLE_STOCK_IN_TRANSIT 

KR CORE SYNC DS

N

0

6003

78

RESERVABLE_LOCKED_STOCK

79

RESERVABLE_STOCK_IN_TRANSIT

1562

72

BWA 1015 - Verladung in ext. zusagb. Transport [BU] (von 124 → 153, in 505)

110315

zTLIB an frei

ZTLIB_AN_FREI

RESERVABLE_STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK

KR CORE SYNC DS

N

0

6005

79

RESERVABLE_STOCK_IN_TRANSIT

3

DELIVERABLE_STOCK

1562

73

mit TO

BWA 1060 - Einlagerung einer Umfuhr(Z) aus anderem Lagerbetrieb - Kolli [FS] (von 154 → 101, in 515), BWA 1061 - Einlagerung einer Umfuhr(Z) aus anderem Lagerbetrieb - Pal. [FS] (von 154 → 101, in 515)

110317

zTLIB an Bestandsdifferenz

ZTLIB_AN_BESTANDSDIFF

RESERVABLE_STOCK_IN_TRANSIT_TO_STOCK_DIFFERENCE

KR CORE SYNC DS

N

0

6008

79

RESERVABLE_STOCK_IN_TRANSIT

4

STOCK_DIFFERENCE

75

mit TO

BWA 1056 - Löschen Avis aus zus. TLIB ohne Belastung Quellbetrieb [Kolli-Avise-Storno] (von 154 → 106, in 515), BWA 1057 - Löschen Avis aus zus. TLIB mit Belastung Quellbetrieb [Kolli-Avise-Storno] (von 154 → 152, in 515)

110309

RES, Rueckfuehrung aus NB

RES_RUECKFUEHRUNG_AUS_NB

LOCKED_STOCK_PLUS

KR CORE SYNC DS

N

0

3051

93

BUB-wirks. BestKorr

1

LOCKED_STOCK

N

63

BWA 1303 - Einlagerung BKZ Luke [BKZ-SEIN-Luke] (von 132 → 102, in 515), BWA 1410 - Einlagerung von Lagerfähiger BKZ-Ware [WER-W] (von 132 → 102, in 515)

110348

Reteingang ZL Konzern

RETAILSCHICHT_RETEIN_ZL_KONZER

LOCKED_STOCK_TO_DELIVERABLE_STOCK

RETAILSCHICHT

N

0

3114

1

LOCKED_STOCK

3

DELIVERABLE_STOCK

Y

BA41+ Retoureneingang von Lager 0, BA52+ Ret. Eing. O. feste Einlagerung von Lager 0

110342

Nachreservierfehler KABA

RETAILSCHICHT_NACHRESER_KABA

INVENTORY_DIFFERENCE

RETAILSCHICHT

N

0

262

1

LOCKED_STOCK

10

Inventurdifferenz

N

BA61+ Nachreservierfehler KaBa/Präv.

110346

Kanalbu.in Retst. Konz.

RETAILSCHICHT_KAN_RETST_KONZ

LOCKED_STOCK_MINUS

RETAILSCHICHT

N

0

81

1

LOCKED_STOCK

93

BUB-wirks. BestKorr

N

0

0

Use Case Kanalbuchung BBA bucht in Lager 0

10231

Ausbuchung Umfuhr

AUSBUCHUNG_UMFUHR

STOCK_IN_TRANSIT_TO_LOCKED_STOCK

RETAILSCHICHT

N

0

3491

2

STOCK_IN_TRANSIT

1

LOCKED_STOCK

Y

27

BA20+ StornoRet.EingPLSbl.Wanne bucht in Quelllager zurück, wenn ohne z-Kz

110365

Direkteinlagerung TLIB

RETAILSCHICHT_DIREKTEINLA_TLIB

STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK

RETAILSCHICHT

N

0

3363

2

STOCK_IN_TRANSIT

3

DELIVERABLE_STOCK

56

BA15+ Storno KABA Lagerfach aus Lager 4, BA38+ Direkteinlagerung TLIB (bei nicht z-KZ gesetzt - Umfuhr aus xxx)

110366

KABA Rueckwaerts

RETAILSCHICHT_KABA_RUECKWAERTS

STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK_H162

RETAILSCHICHT

N

0

5004

2

STOCK_IN_TRANSIT

3

DELIVERABLE_STOCK

N

162

andere Zusagenhandler in CORE

BA72+ KABA Rueckwaerts

110367

Ret Eingang PLS (blaue Wannen)

RETAILSCHICHT_RET_EINGANG_PLS

STOCK_IN_TRANSIT_TO_DELIVERABLE_STOCK_H46

RETAILSCHICHT

N

0

214

2

STOCK_IN_TRANSIT

3

DELIVERABLE_STOCK

N

46

andere Zusagenhandler in CORE

BA19+ Ret. Eingang PLS blaue Wanne

10233

Bestandsdifferenz aus Transport

BESTANDSDIFF_AUS_TRANSPORT

STOCK_IN_TRANSIT_TO_STOCK_DIFFERENCE

RETAILSCHICHT

N

0

294

2

STOCK_IN_TRANSIT

4

STOCK_DIFFERENCE

32

BA20+ StornoRet.EingPLSbl.Wanne - in Quelllager 40 zurück, wenn z-KZ gesetzt (Umfuhr aus SHF, aber ohne zTLIB)

10234

QS-Warenzugang aus Transport

QS_WARENZUGANG_AUS_TRANSPORT

STOCK_IN_TRANSIT_TO_QUALITY_LOCKED_STOCK

RETAILSCHICHT

N

0

96

2

STOCK_IN_TRANSIT

15

QUALITY_LOCKED_STOCK

N

33

BA31+ Warenzugang aus Transit - ohne z-Kz

110368

Storno KABA-Auslag. an Transit

RETAILSCHICHT_STOR_KABA_AUS_TR

STOCK_IN_TRANSIT_TO_RESERVED_SHIPPING_STOCK

RETAILSCHICHT

N

0

213

2

STOCK_IN_TRANSIT

38

RESERVED_SHIPPING_STOCK

Y

ungenutzt. Früher BA64+ Nachreservierfehler KARL (buchte früher 2 HDL → 38 SON und 38 → 10 SON)

110337

Storno Reteing Lager Konzern

RETAILSCHICHT_CANCEL_WH_GROUP

DELIVERABLE_STOCK_TO_LOCKED_STOCK

RETAILSCHICHT

N

0

3116

3

DELIVERABLE_STOCK

1

LOCKED_STOCK

Y

0

BA51+ Storno Retoureneingang bucht an Lager 0, BA52- Sto RetEing. O. feste Einlager bucht an Lager 0

10236

Einstellung in Umfuhr

EINSTELLUNG_IN_UMFUHR

DELIVERABLE_STOCK_TO_STOCK_IN_TRANSIT

RETAILSCHICHT

N

0

102

3

DELIVERABLE_STOCK

2

STOCK_IN_TRANSIT

35

BA31- Storno Warenzugang aus Transit, BA37+ Umlagerung nach Ziellager (bucht nach Lager 23 o. 47 um)

110336

Negative Inventurdifferenz

RETSCHICHT_NEG_INV_DIF

DELIVERABLE_STOCK_INVENTORY_DIFFERENCE

RETAILSCHICHT

N

0

111

3

DELIVERABLE_STOCK

10

Inventurdifferenz

N

BA43- Inventur neg. Komm. Bestand

10238

QS Sperrung

QS_SPERRUNG

DELIVERABLE_STOCK_TO_QUALITY_LOCKED_STOCK

RETAILSCHICHT

N

0

86

3

DELIVERABLE_STOCK

15

QUALITY_LOCKED_STOCK

N

38

BA14+ QS-Sperrung freien Bestandes, BA32+ Präventiver Nachschub HDL

110338

Reserv. f. Entnahme Vers SM

RETAILSCHICHT_RES_ENT_VERS_SM

DELIVERABLE_STOCK_TO_RESERVED_SHIPPING_STOCK

RETAILSCHICHT

N

0

157

3

DELIVERABLE_STOCK

38

RESERVED_SHIPPING_STOCK

N

WWS Client Korrekturbuchung

110363

Storno Entl. WA Kd Pickf. BUB0

RETAILSCHICHT_STOR_ENT_WA_BUB0

STOCK_DIFFERENCE_OUTGOING_GOODS

RETAILSCHICHT

N

0

240

4

STOCK_DIFFERENCE

8

WA Kunde

N

Teil BA67- Storno Inv.-Diff. nach Pickf. (10→4 und 4→8)

110362

Inventur-Ausbuchung Fehlbest.

RETAILSCHICHT_INV_AUSB_FEHLBES

STOCK_DIFFERENCE_INVENTORY

RETAILSCHICHT

N

0

200

4

STOCK_DIFFERENCE

10

Inventurdifferenz

N

Teil BA67+ Ausb. Invent.diff. nach Pickf. (8→4 und 4→10) = LDG

110364

Warenvereinnahmung Tor 99

RETAILSCHICHT_WARENVER_TOR_99

STOCK_DIFFERENCE_TO_QUALITY_LOCKED_STOCK

RETAILSCHICHT

N

0

478

4

STOCK_DIFFERENCE

15

QUALITY_LOCKED_STOCK

BA22+ Sonstige Warenvereinn. Tor 99, BA44+ Vorl. pos. Differenz, UC: QS-Korrektur Konzern aus Fehlbestand, Teilbuchung in Use Case St. Abbng. 2.Wahl/Fehl.Art. , RES-Zugang Retouren, RES-Zugang aus QS-Prüfung…

110341

Storno Rückg.Lief.?Überhang

RETAILSCHICHT_STOR_LIEF_UBHANG

GOODS_RECEIPT_STOCK_DIFFERENCE

RETAILSCHICHT

N

0

247

6

WE Lieferant

4

STOCK_DIFFERENCE

N

BA24+ Mengenkorr.+ QS d.Bestandsbüro, BA93+ Storno Rückg.Lief.aus Überh., BA98+ Einbuchung Umzeichnung

110340

Bestandsbericht.Pos. QS-Sperre

RETAILSCHICHT_BESTAND_POS_QS

GOODS_RECEIPT_QUALITY_LOCKED_STOCK

RETAILSCHICHT

N

0

89

6

WE Lieferant

15

QUALITY_LOCKED_STOCK

N

BA23+ Mengenkorr. + QS d.QS-Stelle

110339

WE1/Wareneingang vom Lief.

RETAILSCHICHT_WE1_VOM_LIEF

GOODS_RECEIPT_QS_UNAUDITED_STOCK

RETAILSCHICHT

N

0

202

6

WE Lieferant

25

QS_UNAUDITED_STOCK

N

BA11+ Wareneingang Versand WE1, BA13+ Inventur + QS-gesperr. Bestand

110257

Grosskundenstorno bedingt durch Lagerbestandsdifferenz

GROSSKUNDENSTORNO_LAGERDIFF

OUTGOING_GOODS_CUSTOMER_STOCK_DIFFERENCE

RETAILSCHICHT

N

0

199

8

WA Kunde

4

STOCK_DIFFERENCE

N

Teil BA67+ Ausb. Invent.diff. nach Pickf. (8→4 und 4→10) = LDG

110349

Storno Auslagerung Versand

RETAILSCHICHT_STOR_AUSLAG_VERS

OUTGOING_GOODS_CUSTOMER_CANCEL

RETAILSCHICHT

N

0

193

8

WA Kunde

38

RESERVED_SHIPPING_STOCK

N

WWS Client Korrekturbuchung, BA65- Storno Auslagerung Versand, BA70- Storno Vorreserv.-Fehler Vers.

110343

Neg. Inv.diff. Komm.B. Versand

RETAILSCHICHT_NEG_INV_DIF_VERS

INVENTORY_DIFFERENCE_DELIVERABLE_STOCK

RETAILSCHICHT

N

0

112

10

Inventurdifferenz

3

DELIVERABLE_STOCK

N

BA42+ Sonstige Einlager. Einzelteil, BA43+ Inventur pos. Komm.Bestand, Teilbuchung bei 77+ Umbuchung Inventur nach Kanal (10→3→15→22), Teilbuchung UC Korr. Ret.Einl.→Findling bzw. Korrektur Einlagerung als QS-Freigabe

110344

Storno Inventur-Ausb. Fehlbest

RETAILSCHICHT_STOR_INV_AU_FLB

INVENTORY_DIFFERENCE_STOCK_DIFFERENCE

RETAILSCHICHT

N

0

429

10

Inventurdifferenz

4

STOCK_DIFFERENCE

Teil BA67- Storno Inv.-Diff. nach Pickf. (10→4 und 4→8)

110358

RES-Zugang

RETAILSCHICHT_RES_ZUGANG

RAS_RES_STOCK_DIFFERENCE

RETAILSCHICHT

N

0

301

11

RAS/RES Umsatz

4

STOCK_DIFFERENCE

N

BA97+ RAS/RES Zugang

110356

Umlagerung Ziellager inkl. 23

RETAILSCHICHT_UMLA_ZIEL_INK_23

QUALITY_LOCKED_STOCK_TO_LOCKED_STOCK

RETAILSCHICHT

N

0

347

15

QUALITY_LOCKED_STOCK

1

LOCKED_STOCK

BA73+ Umlagerung Konzern (bucht in Ziellager)

110357

KARL-Auslag. an TLIB Ziel K.15

RETAILSCHICHT_KAR_AUS_TLIB_K15

QUALITY_LOCKED_STOCK_TO_STOCK_IN_TRANSIT

RETAILSCHICHT

N

0

534

15

QUALITY_LOCKED_STOCK

2

STOCK_IN_TRANSIT

Y

BA63+ Auslagerung KARL (bucht in Ziellager)

10245

QS Entsperrung

QS_ENTSPERRUNG

QUALITY_LOCKED_STOCK_TO_DELIVERABLE_STOCK

RETAILSCHICHT

N

0

87

15

QUALITY_LOCKED_STOCK

3

DELIVERABLE_STOCK

N

47

BA40+ Freischaltung QS-Sperre, Teilbuchung BA36+ Umlagerung QS nach Ziellager (15→3 →2 ins Ziellager), Teilbuchung bei div. UC

10246

Minusdiff. m QS-gesp. Bestand

MINUSDIFF_QS_GESP_BESTAND

QUALITY_LOCKED_STOCK_TO_STOCK_DIFFERENCE

RETAILSCHICHT

N

0

98

15

QUALITY_LOCKED_STOCK

4

STOCK_DIFFERENCE

48

BA22- St.Sonst. Warenvereinn. Tor 99, BA44- Vorl. Neg. Differenz

110352

Rückgabe Liefer. aus Überhang

RETAILSCHICHT_RUCK_LIEFER_UBER

QUALITY_LOCKED_STOCK_GOODS_RECEIPT

RETAILSCHICHT

N

0

93

15

QUALITY_LOCKED_STOCK

6

WE Lieferant

N

BA23- Mengenkorr. - QS d.QS-Stelle, BA24- Mengenkorr.- QS d.Bestandsbüro, BA83+ Rückgabe an Lief. aus Überhang -→ WRS, BA88+ Ausbuchung Umzeichnung

110353

Neg.Inventurdiff.in Retourenst

RETAILSCHICHT_NEG_INV_DIF_RET

QUALITY_LOCKED_STOCK_INVENTORY_DIFFERENCE

RETAILSCHICHT

N

0

320

15

QUALITY_LOCKED_STOCK

10

Inventurdifferenz

N

BA57+ Nachreservierung

110355

RAS-Abgang

RETAILSCHICHT_RAS_ABSGANG

QUALITY_LOCKED_STOCK_RAS_RES

RETAILSCHICHT

N

0

316

15

QUALITY_LOCKED_STOCK

11

RAS/RES Umsatz

N

BA87+ RAS/RES Abgang

10229

Totalschaden

TOTALSCHADEN

QUALITY_LOCKED_STOCK_TO_TOTAL_LOSS

RETAILSCHICHT

N

0

95

15

QUALITY_LOCKED_STOCK

22

Totalschaden

N

59

BA86+ Kanalbuchung

110354

Auslager. Musterung Zentr.Lg.

RETAILSCHICHT_AUSLAG_MUST_ZENT

QUALITY_LOCKED_STOCK_IWA

RETAILSCHICHT

N

0

91

15

QUALITY_LOCKED_STOCK

42

Int.warenabzug IWA

N

BA80+ Musteranforderung

110369

Storno Kanalbu.in Retourenst.

RETAILSCHICHT_STOR_KANA_IN_RET

TOTAL_LOSS_LOCKED_STOCK

RETAILSCHICHT

N

0

187

22

Totalschaden

1

LOCKED_STOCK

N

WWS Client Korrekturbuchung

110370

Storno Kanalbuchung QS-Sperre

RETAILSCHICHT_STOR_KANA_QS_SPE

TOTAL_LOSS_STOCK_DIFFERENCE

RETAILSCHICHT

N

0

249

22

Totalschaden

4

STOCK_DIFFERENCE

N

BA96+ Storno Kanalbuchung

110351

WE2 Vereinnahmung Versand

RETAILSCHICHT_WE2_VEREIN_VERSA

QS_UNAUDITED_STOCK_TO_DELIVERABLE_STOCK

RETAILSCHICHT

N

0

205

25

QS_UNAUDITED_STOCK

3

DELIVERABLE_STOCK

N

BA30+ WE2-Freischaltung

110350

Mengenkorrektur WE1 negativ

RETAILSCHICHT_MENGENKO_WE1_NEG

QS_UNAUDITED_STOCK_GOODS_RECEIPT

RETAILSCHICHT

N

0

203

25

QS_UNAUDITED_STOCK

6

WE Lieferant

N

BA13- Inventur - QS-gesperr. Bestand

110360

Storno Ausl.Vers 38→3

RETAILSCHICHT_STOR_AUS_VE_38_3

RESERVED_SHIPPING_STOCK_DELIVERABLE_STOCK

RETAILSCHICHT

N

0

291

38

RESERVED_SHIPPING_STOCK

3

DELIVERABLE_STOCK

WWS Client Korrekturbuchungen, BA15+ Storno KABA Witt Lagerfach

10078

Warenausgang

WARENAUSGANG

RESERVED_SHIPPING_STOCK_OUTGOING_GOODS_CUSTOMER

RETAILSCHICHT

N

0

161

38

RESERVED_SHIPPING_STOCK

8

WA Kunde

N

BA65+ Auslagerung/Verkauf Kunde Vers, BA68+ Auslagerung KABA WITT, BA70+ VorreservierFehler Versand (anschl. Ggf. LDG)

110361

Ausb. Invent.diff. nach Pickf.

RETAILSCHICHT_AUS_INV_DIFF_PIC

RESERVED_SHIPPING_STOCK_INVENTORY_DIFFERENCE

RETAILSCHICHT

N

0

160

38

RESERVED_SHIPPING_STOCK

10

Inventurdifferenz

N

WWS Client Korrekturbuchung

110345

Zugang aus Musterug Zentr.Lg.

RETAILSCHICHT_ZUG_MUSTERUG_ZEN

IWA_STOCK_DIFFERENCE

RETAILSCHICHT

N

0

244

42

Int.warenabzug IWA

4

STOCK_DIFFERENCE

N

BA90+ Musterrückgabe

110320

zGesperrt an Frei

ZGESPERRT_AN_FREI

RESERVABLE_LOCKED_STOCK_TO_DELIVERABLE_STOCK

RETAILSCHICHT

N

0

6001

78

RESERVABLE_LOCKED_STOCK

3

DELIVERABLE_STOCK

1562

76

BA40+ Freischaltung QS-Sperre mit z-KZ, WWS Client

110315

zTLIB an frei

ZTLIB_AN_FREI

RESERVABLE_STOCK_IN_TRANSIT_DELIVERABLE_STOCK

RETAILSCHICHT

N

0

6005

79

RESERVABLE_STOCK_IN_TRANSIT

3

DELIVERABLE_STOCK

1562

73

BA38+ Direkteinlagerung aus Transit mit z-Kz

110317

zTLIB an Bestandsdifferenz

ZTLIB_AN_BESTANDSDIFF

RESERVABLE_STOCK_IN_TRANSIT_STOCK_DIFFERENCE

RETAILSCHICHT

N

0

6008

79

RESERVABLE_STOCK_IN_TRANSIT

4

STOCK_DIFFERENCE

75

BA20+ StornoRet.EingPLSbl.Wanne - in Quelllager 4 zurück, wenn z-KZ gesetzt (Umfuhr aus HDL über zTLIB)

110359

zTLIB an zGesperrt

RETAILSCHICHT_ZTLIB_AN_ZGESPER

RESERVABLE_STOCK_IN_TRANSIT_TO_RESERVABLE_LOCKED_STOCK

RETAILSCHICHT

N

0

6006

79

RESERVABLE_STOCK_IN_TRANSIT

78

RESERVABLE_LOCKED_STOCK

1562

BA31+ Warenzugang aus Transit - mit z-Kz

110347

Storno Kanalbu.in Retst. Konz.

RETAILSCHICHT_STOR_KAN_RETS_KO

LOCKED_STOCK_PLUS

RETAILSCHICHT

N

0

370

93

BUB-wirks. BestKorr

1

LOCKED_STOCK

N

0

0

Use Case Kanalbuchung BBZ - bucht in Lager 0

GOODS_RECEIPT

NEON

DELIVERABLE_STOCK

N

kMotion→FINE und FINE→ERP

WE Lieferant abgeschlossen, Ware freigegeben in verfügbaren Bestand

GOODS_RECEIPT_QUALITY_LOCKED

NEON

QUALITY_LOCKED_STOCK

kMotion→FINE und FINE→ERP

WE Lieferant abgeschlossen, Ware noch in QS Bestand

RETURNS_MANUAL_STORAGE

NEON

STOCK_IN_TRANSIT

DELIVERABLE_STOCK

kMotion→FINE und FINE→ERP

manuelle Einlagerung von lagerfähigen Retouren

RETURNS_AUTOMATIC_STORAGE

NEON

STOCK_IN_TRANSIT

DELIVERABLE_STOCK

kMotion→FINE und FINE→ERP

autom. Einlagerung von lgerfähigen Retouren

TRANSFER_MANUAL_STORAGE

NEON

STOCK_IN_TRANSIT

DELIVERABLE_STOCK

kMotion→FINE und FINE→ERP

manuelle Einlagerung Umfuhr

TRANSFER_AUTOMATIC_STORAGE

NEON

STOCK_IN_TRANSIT

DELIVERABLE_STOCK

kMotion→FINE und FINE→ERP

autom. Einlagerung Umfuhr

STOCK_AVAILABILITY_CHECK_NOK

NEON

kMotion→FINE

Bestandsverfügbarkeitsprüfung (BVP) kMotion nicht ok. Mit Angabe TA wird daraus durch FINE ein anderer EventType gemappt, nicht ans ERP weitergegeben

INVENTORY_DIFFERENCE_ERP_STOCK

NEON

FINE→ERP

bei BVP_NOK und TA = 0 an ERP gesendet, ebenso bei HLR_NOK und TA > 0, im ERP ignoriert, da LIB/LAB Differenz ggf. nur kurzfristig

IN_FULFILLMEMT_MISSING

NEON

STOCK_IN_FULFILLMENT

Inventurdifferenz

FINE→ERP

bei BVP_NOK und TA > 0 an ERP gesendet, kein Ersatz mehr da, dann ausbuchen auf Diff

HIGH_LEVEL_RESERVATION_OK

NEON

kMotion→FINE

High Level Reservierung (HLR) kMotion erfolgreich. Mit Angabe TA wird daraus durch FINE ein anderer EventType für das ERP gemappt, nicht ans ERP weitergegeben

IN_FULFILLMENT_CUSTOMER

NEON

DELIVERABLE_STOCK

STOCK_IN_FULFILLMENT

FINE→ERP

HLR_OK und TA = 0 an ERP gesendet

IN_FULFILLMENT_MANUAL_SUBSTITUTION

NEON

DELIVERABLE_STOCK

Inventurdifferenz

FINE→ERP

HLR_OK und TA > 0 an ERP gesendet - Ersatz für ursprünglich reservierten Bestand, dieser wurde zwar mit PICK/PACK/SORT/OUTBOUND etc. gemeldet, aber im ERP nicht ausgebucht

HIGH_LEVEL_RESERVATION_NOK

NEON

kMotion→FINE

High Level Reservierung (HLR) kMotion nicht erfolgreich. Mit Angabe TA wird daraus durch FINE ein anderer EventType für das ERP gemappt

INVENTORY_DIFFERENCE_ERP_STOCK_MEANWHILE_REDUCED

NEON

FINE→ERP

HLR_NOK und TA = 0 an ERP gesendet

IN_FULFILLMENT_INVENTORY_DIFFERENCE_PICK

NEON

kMotion→FINE und FINE→ERP

Ware beim Picken nicht gefunden, Streifenfehler, für reservierte Menge gemeldet, im ERP ignoriert, da unklar, ob Ersatz klappt

IN_FULFILLMENT_INVENTORY_DIFFERENCE_PACK

NEON

kMotion→FINE und FINE→ERP

Ware beim Packen nicht gefunden, Fehlerstelle meldet, wenn kein Ersatz, im ERP ignoriert, da unklar, ob Ersatz klappt

IN_FULFILLMENT_INVENTORY_DIFFERENCE_SORT

NEON

kMotion→FINE und FINE→ERP

Ware beim internen Transport/Sortieren nicht gefunden

IN_FULFILLMENT_INVENTORY_DIFFERENCE_OUTBOUND

NEON

kMotion→FINE und FINE→ERP

Ware beim Versand/Warenausgang nicht gefunden, Fehlerstelle meldet, wenn kein Ersatz, im ERP ignoriert, da unklar, ob Ersatz klappt

OUTGOING_GOODS

NEON

kMotion→FINE

Warenausgang abgeschlossen, anhand stockTransferType und stockType entscheidet FINE über das Mapping Richtung ERP

OUTGOING_GOODS_CUSTOMER

NEON

STOCK_IN_FULFILLMENT

WA Kunde

FINE→ERP

Warenausgang B2C abgeschlossen

INVENTORY_DIFFERENCE_COMMON

NEON

DELIVERABLE_STOCK

Inventurdifferenz

kMotion→FINE und FINE→ERP

Ausbuchung des freien Bestandes eines Quanten bei Pickfehler

INVENTORY_PLUS_DIFFERENCE

NEON

Inventurdifferenz

DELIVERABLE_STOCK

kMotion→FINE und FINE→ERP

Plusdifferenz in freien Bestand, FUND buchen

IN_FULFILLMENT_B2B

NEON

DELIVERABLE_STOCK

STOCK_IN_FULFILLMENT

FINE→ERP

bei HLR_OK und TA = 0 mit stockTransferType gesetzt und lockType AVAILABLE - B2B Auftrag für freien Bestand

IN_FULFILLMENT_QUALITY_LOCKED

NEON

QUALITY_LOCKED_STOCK

STOCK_IN_FULFILLMENT

FINE→ERP

bei HLR_OK und TA = 0 mit stockTransferType gesetzt und lockType LOCKED - B2B Auftrag für QS gesperrten Bestand, z.B. für Warenrücksendungen über anderes Lager

IN_FULFILLMENT_CANCEL

NEON

STOCK_IN_FULFILLMENT

DELIVERABLE_STOCK

kMotion→FINE und FINE→ERP

Storno eines B2C (Teil-) Auftrages

IN_FULFILLMENT_CANCEL_QUALITY_LOCKED

NEON

STOCK_IN_FULFILLMENT

QUALITY_LOCKED_STOCK

FINE→ERP

Storno eines B2B (Teil-) Auftrages für QS gesperrten Bestand (bei kMotion IN_FULFILLMENT_CANCEL und stockType= LOCKED an ERP gesendet)

OUTGOING_GOODS_TRANSFER

NEON

STOCK_IN_FULFILLMENT

STOCK_IN_TRANSIT

FINE→ERP

Warenausgang B2B Umfuhrauftrag (bei kMotion OUTGOING_GOODS und stockTransferType UMF an ERP gemeldet)

INVENTORY_LOCK

NEON

DELIVERABLE_STOCK

INVENTORY_LOCKED_STOCK

kMotion→FINE und FINE→ERP

Inventursperre auf freie Ware anhand Inventurprüfliste setzen

INVENTORY_LOCK_QUALITY_LOCKED

NEON

QUALITY_LOCKED_STOCK

INVENTORY_LOCKED_STOCK

FINE→ERP

Inventursperre auf QS gesperrte Ware anhand Inventurprüfliste setzen (bei kMotion INVENTORY_LOCK und stockType LOCKED ans ERP gesendet)

INVENTORY_CHECK_FINAL

NEON

INVENTORY_LOCKED_STOCK

DELIVERABLE_STOCK

kMotion→FINE und FINE→ERP

Nach Inventurprüfung Ware wieder freigeben

INVENTORY_CHECK_FINAL_QUALITY_LOCKED

NEON

INVENTORY_LOCKED_STOCK

QUALITY_LOCKED_STOCK

FINE→ERP

Nach Inventurprüfung Ware wieder in QS gesperrt freigeben (bei kMotion INVENTORY_CHECK_FINAL und stockType LOCKED ans ERP gesendet)

2. Sonstige

8 - S14 Accumulated Warehouse Stock

Status

Version 1.0 published 17.07.2024

Approval
  1. DeepSea:

Comment

Die erste Version wird für die Anbindung von FINE Richtung Händler im Kontext NEON entwickelt.

Assumption

BISKO wird nicht betrachtet und bekommt die Daten aus den Bestandsystemen über die bestehenden Bestandsschnittstellen. Für NEON ist keine Anbindung an BISKO geplant.

1. Stakeholder

Role Application Responsible

Communication

Integration Layer

Leading App

Bube

InterfaceOwner

Bube

Producer

FINE

Consumer

Comorant

Consumer

Humpback

2. Business Context

Aus den über die S01 WarehouseStock gesendeten Lagerbestandsdaten auf Einzelquantenbasis werden durch FINE Daten auf erpPackingUnitId Ebene (Teile) aggregiert und dem Händler zur Verfügung gestellt. Anhand der Daten soll ein LIB/LAB Abgleich ermöglicht werden.

3. Information flow

Partner Direction FINE-Service Topic/API Description Status

WMS:kMotion ILOWA

send

BuBe:StockService

stock.warehousestock.kmotion.v3

WarehouseStockWms.v3.1

ready

ERP:DeepSea

receive

BuBe:StockService

stock.accumulatedwarehousestock.deepsea.v1

AccumulatedWarehouseStock.v1.1

ready

Diagram

4. Interface

4.1. Direction FINE to ERP

4.1.1. Header

This interface uses the Service Header

Special expressions for this interface:

Table 1. Attribute

Fieldname

Expression

Version

eventType

STOCK

*

context

ACCUMULATED_WAREHOUSE_STOCK

*

4.1.2. Data model

Property Type Description

(Root)

object

    eventId*

string (uuid)

The unique eventId
Global unique Id

Minimum Length: 36
Maximum Length: 36

    traceId*

string (uuid)

The unique traceId
Global unique Id for tracing the flow of events

Minimum Length: 36
Maximum Length: 36

    eventTime*

string (date-time)

Time of occurrence of the event
Time at which the record was generated (single event - not the businessEvent/snapshot) in UTC +ISO-8601 format YYYY-MM-DD'T'HH24:MM:SS'Z'

    version*

The number of version schema
Number of version of this data structure. Only required if no $schema is specified!

    context

string (enum)

The context / business case
The context specified here means the business domain.

Any of: [ "ACCUMULATED_WAREHOUSE_STOCK" ]
Maximum Length: 50

    eventType*

string (enum)

Snapshot event
the snapshot type to which the data belongs, currently only snapshots are supported

Any of: [ "STOCK" ]
Maximum Length: 20

    metaData*

object

additional meta information
optional, can be used with different characteristics for technical data per interface

        sender*

string (enum)

sender
Name of the source system, that has sent this message.

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
Client/mandant (messages of different clients have different processing rules and destination interfaces) - use FBO for Fulfillment by Otto (CORE, DeepSea…​)

Any of: [ "FBO", "MYTOYS", "BONPRIX", "WITT", "CORSO", "HEINE", "BAUMARKT_DIREKT", "BAUR", "OTTO", "ABOUTYOU", "F2X", "F2X_MANUFACTUM", "PSAUT", "F2X_SHEEGO", "F2X_CLEARANCE" ]

        messageNumber

integer

current message number
the current message number that is transmitted

Minimum: 1
Maximum: 1000000000000000000

        lastMessageNumber

integer

last message number
how many messages are to be transferred

Minimum: 1
Maximum: 1000000000000000000

        dailySnapshotNumber*

integer

daily snapshot number
sequence number of the snapshot per day, starts every day again with number 1

Minimum: 1
Maximum: 100

        snapshotTime

string (date-time)

snapshot time
time of the snapshot creation

    data*

object

        erpSnapshotId*

integer

the id of the inventory snapshot
Consecutive number (sequence) of a long number. each inventory snapshot gets its own ID from WMS, which is identical for all records of the snapshot. all bookings get the id of the following snapshot, generated by wms, each wms has his own scope

Maximum Length: 18
Minimum: 1
Maximum: 1000000000000000000

        erpProductId*

string

¨ERP Product Id
master communication key between Erp and LSAS for item sizes

Maximum Length: 36

        erpPackingUnitId*

string

¨ERP PackingUnit Id
master communication key between LSAS and ERP for packing units of an item sized - used in Deep Sea for identification

Maximum Length: 36

        packingUnitIndex

integer

¨PackingUnit Number
Part Number for products with multiple parts - use 1 for PL

Maximum: 99

        location*

string (enum)

location
the location where the event was created

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" ]

        quantity*

integer

quantity
quantity containing to this stock type

Minimum: 1
Maximum: 9999999999

        erpStockType*

string (enum)

ERP Stock Type
stock type, which are defined at ERP

Any of: [ "DELIVERABLE_STOCK", "QUALITY_LOCKED_STOCK", "LOCKED_STOCK", "STOCK_IN_FULFILLMENT", "RESERVABLE_LOCKED_STOCK", "STOCK_IN_TRANSIT", "RESERVABLE_STOCK_IN_TRANSIT", "STOCK_IN_FULFILLMENT_QUALITY_LOCKED" ]
Maximum Length: 50

4.1.3. Enumeration

Field: erpStockType

Table 2. erpStockType

Meta Value

Description

Short Value

DELIVERABLE_STOCK

deliverable stock that can be sold after WE2.0

LOCKED_STOCK

temporary locked stock e.g. for inventory processes

QUALITY_LOCKED_STOCK

for quality reasons locked stock after WE2.0

STOCK_IN_FULFILLMENT

reserved for orders after logistic buffer call - for orders of deliverable stock (B2C and B2B)

STOCK_IN_TRANSIT

stock adviced for returns or stock transfers to the warehouse

RESERVABLE_LOCKED

locked stock available for customer reservations

RESERVABLE_STOCK_IN_TRANSIT

stock in transport (detours) available for customer reservations used in KR1 context

STOCK_IN_FULFILLMENT_QUALITY_LOCKED

reserved for orders after logistic buffer call - for B2B orders from quality locked stock

4.1.4. Example

Message FINE to ERP
{
    "eventId":"f48cfc26-0615-4351-9966-cdb4ec41bbcc",
    "traceId":"f48cfc26-0615-4351-9966-cdb4ec41bbcc",
    "eventTime":"2016-04-16T01:03:17Z",
    "version":"1.1",
    "eventType":"STOCK",
    "metaData":{
        "sender":"BUBE",
        "client":"FBO",
        "messageNumber":1,
        "lastMessageNumber":10,
        "dailySnapshotNumber":1,
        "snapshotTime":"2016-04-16T01:00:00Z"
    },
    "data":{
        "erpSnapshotId":427,
        "erpProductId":"Artikel1",
        "erpPackingUnitId":"Teil1",
        "location":"ILOWA",
        "quantity":13,
        "erpStockType":"DELIVERABLE_STOCK"
    }
}

4.1.5. Version history

Table 3. Version FINE to ERP
Version Number File Published on Changes

previous version

current version

1.0

Download

17.07.2024

- Look at chapter "Changelog"

coming version

1.1

Download

tbd

4.1.6. Changelog

Changes V1.0

  • first draft

Changes V1.0 → V2.0

  • add new erpStockType STOCK_IN_FULFILLMENT_QUALITY_LOCKED

4.1.7. Schema

Interface FINE to ERP
{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$comment": "Schema for accumulated stock in a warehouse direction ERP Version 1.1",
    "$id": "https://doc.fine.gcp.osp-dev.de/registry/Stock/AccumulatedWarehouseStock.v1.1.schema.json",
    "type": "object",
    "definitions": {
        "erpStockType": {
            "title": "Type of the stock",
            "description": "stockType, which are defined at ERP",
            "type": "string",
            "maxLength": 50,
            "enum": ["DELIVERABLE_STOCK", "QUALITY_LOCKED_STOCK", "LOCKED_STOCK", "STOCK_IN_FULFILLMENT","RESERVABLE_LOCKED_STOCK","STOCK_IN_TRANSIT", "RESERVABLE_STOCK_IN_TRANSIT", "STOCK_IN_FULFILLMENT_QUALITY_LOCKED"]
        }
    },
    "properties": {
        "eventId": {
            "title": "The unique eventId",
            "description": "Global unique Id",
            "type": "string",
            "format": "uuid",
            "minLength": 36,
            "maxLength": 36,
            "examples": [
                "00ce536f-923a-42f4-8128-be118faf1d87"
            ]
        },
        "traceId": {
            "title": "The unique traceId",
            "description": "Global unique Id for tracing the flow of events",
            "type": "string",
            "format": "uuid",
            "minLength": 36,
            "maxLength": 36,
            "examples": [
                "00ce536f-923a-42f4-8138-33418faf1342"
            ]
        },    
        "eventTime": {
            "title": "Time of occurrence of the event",
            "description": "Time at which the record was generated (single event - not the businessEvent/snapshot) in UTC +ISO-8601 format YYYY-MM-DD'T'HH24:MM:SS'Z'",
            "type": "string",
            "format": "date-time",
            "examples": [
                "2022-04-16T16:06:05.123456Z",
                "2022-04-19T08:51:05+02:00"
            ]
        },
        "version": {
            "title": "The number of version schema",
            "description": "Number of version of this data structure. Only required if no $schema is specified!",
            "oneOf": [
                {
                    "type": "string",
                    "pattern": "\\d+\\.\\d{1,2}",
                    "examples": ["1.01", "01.02"]
                },
                {
                    "type": "integer",
                    "examples": [1, 2]
                }
            ]
        },
        "context": {
            "title": "The context / business case",
            "description": "The context specified here means the business domain.",
            "type": "string",
            "maxLength":50,
            "enum": [
                "ACCUMULATED_WAREHOUSE_STOCK"
            ]
        },
        "eventType": {
            "title": "Snapshot event",
            "description": "the snapshot type to which the data belongs, currently only snapshots are supported",
            "type": "string",
            "maxLength": 20,
            "enum": ["STOCK"],
            "examples":["STOCK"]
        },
        "metaData": {
            "title": "additional meta information",
            "description": "optional, can be used with different characteristics for technical data per interface",
            "type": "object",
            "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.v7.schema.json"
                },
                "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.v5.schema.json"
                },
                "messageNumber": {
                    "title": "current message number",
                    "description": "the current message number that is transmitted",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 999999999999999999
                },
                "lastMessageNumber": {
                    "title": "last message number",
                    "description": "how many messages are to be transferred",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 999999999999999999
                },
                "dailySnapshotNumber": {
                    "title": "daily snapshot number",
                    "description": "sequence number of the snapshot per day, starts every day again with number 1",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100
                },
                "snapshotTime": {
                    "title": "snapshot time",
                    "description": "time of the snapshot creation",
                    "type": "string",
                    "format": "date-time",
                    "examples": [
                        "2022-04-16T16:06:05.123456Z",
                        "2022-04-19T08:51:05+02:00"
                    ]
                }
            }, 
            "required": [
                "sender",
                "client",
                "dailySnapshotNumber"
            ]   
        },
        "data": {
            "type": "object",
            "properties": {
                "erpSnapshotId": {
                    "title": "the id of the inventory snapshot",
                    "description": "Consecutive number (sequence) of a long number. each inventory snapshot gets its own ID from WMS, which is identical for all records of the snapshot. all bookings get the id of the following snapshot, generated by wms, each wms has his own scope",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 999999999999999999,
                    "maxLength": 18,
                    "examples": [
                        122
                    ]
                },
                "erpProductId": {
                    "title": "¨ERP Product Id",
                    "description": "master communication key between Erp and LSAS for item sizes",
                    "type": "string",
                    "maxLength": 36,
                    "examples":["123"]
                },  
                "erpPackingUnitId": {
                    "title": "¨ERP PackingUnit Id",
                    "description": "master communication key between LSAS and ERP for packing units of an item sized - used in Deep Sea for identification",
                    "type": "string",
                    "maxLength": 36,
                    "examples":["123"]
                },
                "packingUnitIndex": {
                    "title": "¨PackingUnit Number",
                    "description": "Part Number for products with multiple parts - use 1 for PL",
                    "type": "integer",
                    "mininmum": 1,
                    "maximum": 99,
                    "examples":["123"]
                },              
                "location": {
                    "title": "location",
                    "description": "the location where the event was created",
                    "$ref": "https://doc.fine.gcp.osp-dev.de/registry/MetaData/warehouselocations.v1.schema.json"
                },
                "quantity": {
                    "title": "quantity",
                    "description": "quantity containing to this stock type",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9999999999,
                    "examples":[90]
                },
                "erpStockType": {
                    "title": "ERP Stock Type",
                    "description": "stock type, which are defined at ERP",
                    "$ref": "#/definitions/erpStockType"
                }
            },
            "required": [
                "erpSnapshotId",
                "erpProductId",
                "erpPackingUnitId",
                "location",
                "quantity",
                "erpStockType"
            ]              
        }
    },
    "required": [
      "eventId",
      "traceId",
      "eventTime",
      "version",
      "eventType",
      "metaData",
      "data"
    ],
    
    "examples":[
        {
            "eventId":"f48cfc26-0615-4351-9966-cdb4ec41bbcc",
            "traceId":"f48cfc26-0615-4351-9966-cdb4ec41bbcc",
            "eventTime":"2016-04-16T01:03:17Z",
            "version":"1.1",
            "eventType":"STOCK",
            "metaData":{
                "sender":"BUBE",
                "client":"FBO",
                "messageNumber":1,
                "lastMessageNumber":10,
                "dailySnapshotNumber":1,
                "snapshotTime":"2016-04-16T01:00:00Z"
            },
            "data":{
                "erpSnapshotId":427,
                "erpProductId":"Artikel1",
                "erpPackingUnitId":"Teil1",
                "location":"ILOWA",
                "quantity":13,
                "erpStockType":"DELIVERABLE_STOCK"
            }
        }
    ]
}

9 - S15 Unique Article Identifier Data

Status

Version 1.0 published 04.04.2024

Approval
  1. DeepSea:

Comment

Die erste Version wird für die Anbindung von FINE Richtung Händler im Kontext NEON entwickelt.

1. Stakeholder

Role Application Responsible

Communication

Integration Layer

Leading App

Bube

InterfaceOwner

Bube

Producer

FINE

Consumer

ReTuna

2. Business Context

Bereitstellung von Daten (z.B. Lieferantenstammdaten, IMEI, etc.) über eine REST-API mittels Angabe einer BUAID. Die Sammlung der Daten auf Seiten FINE erfolgt über die S01 WarehouseStock gesendeten Lagerbestandsdaten.

3. Information flow

Partner Direction FINE-Service Topic/API Description Status

WMS:kMotion ILOWA

send

BuBe:StockService

to define

UniqueArticleIdentifierDataWms.v2.0

planned

ERP:DeepSea (reTuna)

receive

BuBe:UniqueArticleIdentifierRestService

REST endpoint: /buaid/{buaid}

UniqueArticleIdentifierDataErp.v1.0

ready

ERP:DeepSea (reTuna)

receive

BuBe:UniqueArticleIdentifierRestService

REST endpoint: /v2/buaid/{buaid}

UniqueArticleIdentifierDataErp.v2.0

planned

Diagram
Table 1. Attribute
Enivronment REST-Endpoint

non-live

https://test.uniquearticleidentifiermapper.osp-fine.de

live

https://prod.uniquearticleidentifiermapper.osp-fine.de

Autorisierung erfolgt über den entsprechenden Service-Account.

4. Interface

4.1. Direction WMS to FINE

4.1.1. Header

This interface uses the Service Header

Special expression for this interface:

Table 2. Attribute
Fieldname Expression Version

eventType

STOCK

context

UNIQUE_ARTICLE_IDENTIFIER_DATA

4.1.2. Data model

Property Type Description

(Root)

object

Unique Article Identifier
Get unique article identifier data for a Buaid

    eventId*

string (uuid)

UUID for this event
UUID for this event

Minimum Length: 36
Maximum Length: 36
Regular expression: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

    eventTime*

string (date-time)

the date and time, when this event occured as an ISO-8601 timestamp.
the date and time, when this event occured as an ISO-8601 timestamp.

    traceId*

string (uuid)

The unique traceId
Global unique Id for tracing the flow of events

Minimum Length: 36
Maximum Length: 36

    eventType*

string (enum)

event type
the snapshot type to which the data belongs, currently only snapshots are supported

Any of: [ "STOCK" ]
Maximum Length: 20

    context*

string (enum)

context
The context specified here means the business domain.

Any of: [ "UNIQUE_ARTICLE_IDENTIFIER_DATA" ]
Maximum Length: 50

    version*

string

Json schema version
JSON schema version

Minimum Length: 3
Maximum Length: 4
Regular expression: ^[0-9]+[.][0-9]+$

    data*

object

        status*

string (enum)

Status
Status

Any of: [ "UPDATE" ]
Maximum Length: 50

        buaid*

string

buaid
bi unique article ID, unique identification of an individual unit in the logistical process

Maximum Length: 50

        supplier*

object

            logisticsSupplierId*

string

technical logistics supplier id
logistics supplier ID - LSAS based ID

Maximum Length: 36

            id

string

supplier number
supplier number (LKZ) - deprecated

Maximum Length: 50

        bestBeforeDate

string (date)

best Before Date
best before date

        batch

string

batch
batch number

Maximum Length: 100

        imei

string

imei
IMEI of a technical device

Maximum Length: 50

        imei2

string

imei2
second IMEI of dual sim technical device

Maximum Length: 50

        serialNumber

string

serial number
serial number of the manufacturer

Maximum Length: 100

4.1.3. Enumeration

4.1.4. Example

4.1.5. Version history

Table 3. Version WMS to FINE
Version Number File Published on Changes

previous version

current version WMS

coming version

2.0 APLHA

Download

4.1.6. Changelog

4.1.7. Schema

Message WMS to FINE V2.0
{
  "$schema": "http://json-schema.org/draft-07/schema",
  "type": "object",
  "title": "Unique Article Identifier",
  "description": "Get unique article identifier data for a Buaid",
  "definitions": {
    "status": {
      "title": "Type of status",
      "description": "Type of status",
      "type": "string",
      "maxLength": 50,
        "enum": ["UPDATE"]
    }
  },
  "required": [
    "eventId",
    "eventTime",
    "traceId",
    "eventType",
    "context",
    "version",
    "data"
  ],
  "properties": {
    "eventId": {
      "description": "UUID for this event",
      "type": "string",
      "format": "uuid",
      "minLength": 36,
      "maxLength": 36,
      "title": "UUID for this event",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ],
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
    },
    "eventTime": {
      "description": "the date and time, when this event occured as an ISO-8601 timestamp.",
      "type": "string",
      "format": "date-time",
      "title": "the date and time, when this event occured as an ISO-8601 timestamp.",
      "examples": [
        "2022-03-31T12:41:06.036+0200"
      ]
    },
    "traceId": {
      "title": "The unique traceId",
      "description": "Global unique Id for tracing the flow of events",
      "type": "string",
      "format": "uuid",
      "minLength": 36,
      "maxLength": 36,
      "examples": ["00ce536f-923a-42f4-8138-33418faf1342"]
    },
    "eventType": {
      "title": "event type",
      "description": "the snapshot type to which the data belongs, currently only snapshots are supported",
      "type": "string",
      "maxLength": 20,
      "enum": ["STOCK"],
      "examples":["STOCK"]
    },
    "context": {
      "title": "context",
      "description": "The context specified here means the business domain.",
      "type": "string",
      "maxLength":50,
      "enum": [
          "UNIQUE_ARTICLE_IDENTIFIER_DATA"
      ]
    },
    "version": {
      "description": "JSON schema version",
      "type": "string",
      "pattern": "^[0-9]+[.][0-9]+$",
      "minLength": 3,
      "maxLength": 4,
      "title": "Json schema version",
      "examples": [
        "1.0",
        "1.11",
        "1.1"
      ]
    },
    "data": {
      "type": "object",
      "properties": {
        "status": {
          "title": "Status",
          "description": "Status",
          "$ref": "#/definitions/status"
        },
        "buaid": {
          "title": "buaid",
          "description": "bi unique article ID, unique identification of an individual unit in the logistical process",
          "type": "string",
          "maxLength": 50,
          "examples":["2344545-334542-465g45ddf"]
        },
        "supplier": {
          "type": "object",
          "properties": {
            "logisticsSupplierId": {
              "title": "technical logistics supplier id",
              "description": "logistics supplier ID - LSAS based ID",
              "type": "string",
              "maxLength": 36,
              "examples":["123"]
            },
            "id": {
              "title": "supplier number",
              "description": "supplier number (LKZ) - deprecated",
              "type": "string",
              "maxLength": 50,
              "examples":["4"]
            }
          },
          "required": [
            "logisticsSupplierId"
          ]
        },
        "bestBeforeDate": {
          "title": "best Before Date",
          "description": "best before date",
          "type": "string",
          "format":"date",
          "examples":["2022-12-31"]
        },
        "batch": {
          "title": "batch",
          "description": "batch number",
          "type": "string",
          "maxLength": 100,
          "examples":["124345d"]
        },
        "imei": {
          "title": "imei",
          "description": "IMEI of a technical device",
          "type": "string",
          "maxLength": 50,
          "examples":["2345-45452-43365-5643"]
        },
        "imei2": {
          "title": "imei2",
          "description": "second IMEI of dual sim technical device",
          "type": "string",
          "maxLength": 50,
          "examples":["2345-45452-43365-5643"]
        },
        "serialNumber": {
          "title": "serial number",
          "description": "serial number of the manufacturer",
          "type": "string",
          "maxLength": 100,
          "examples":["D345-gkjpo-3112"]
        }
      },
      "required": [
        "status",
        "buaid",
        "supplier"
      ]
    }
  }
}

4.2. Direction FINE to ERP

4.2.1. Header

This interface uses the Service Header

Special expressions for this interface:

Table 4. Attribute
Fieldname Expression

eventType

STOCK

context

UNIQUE_ARTICLE_IDENTIFIER_DATA

4.2.2. Data model

Property Type Description

(Root)

object

Unique Article Identifier
Get unique article identifier data for a Buaid

    eventId*

string (uuid)

UUID for this event
UUID for this event

Minimum Length: 36
Maximum Length: 36
Regular expression: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

    eventTime*

string (date-time)

the date and time, when this event occured as an ISO-8601 timestamp.
the date and time, when this event occured as an ISO-8601 timestamp.

    traceId*

string (uuid)

The unique traceId
Global unique Id for tracing the flow of events

Minimum Length: 36
Maximum Length: 36

    eventType*

string (enum)

event type
the snapshot type to which the data belongs, currently only snapshots are supported

Any of: [ "STOCK" ]
Maximum Length: 20

    context*

string (enum)

context
The context specified here means the business domain.

Any of: [ "UNIQUE_ARTICLE_IDENTIFIER_DATA" ]
Maximum Length: 50

    version*

string

Json schema version
JSON schema version

Minimum Length: 3
Maximum Length: 4
Regular expression: ^[0-9]+[.][0-9]+$

    data*

object

        status*

string (enum)

Status
Status

Any of: [ "NOT_FOUND", "SUCCESS" ]
Maximum Length: 50

        buaid*

string

buaid
bi unique article ID, unique identification of an individual unit in the logistical process

Maximum Length: 50

        supplier

object

            id

string

supplier number
supplier number (LKZ) - deprecated

Maximum Length: 50

            name

string

Name of supplier
Name of supplier

Maximum Length: 50

            erpSupplierId

string

technical erp supplier id
erp supplier ID - LSAS based ID

Maximum Length: 36

        bestBeforeDate

string (date)

best Before Date
best before date

        batch

string

batch
batch number

Maximum Length: 100

        imei

string

imei
IMEI of a technical device

Maximum Length: 50

        imei2

string

imei2
second IMEI of dual sim technical device

Maximum Length: 50

        serialNumber

string

serial number
serial number of the manufacturer

Maximum Length: 100

4.2.3. Enumeration

Field: status

Table 5. erpStockType
Meta Value Description

NOT_FOUND

no data found for BUAID

SUCCESS

data found for BUAID

4.2.4. Example

Message FINE to ERP
{
	"eventId": "86da275a-cdaa-4a5a-87a3-371d8d816ee4",
	"traceId": "86da275a-cdaa-4a5a-87a3-371d8d816ee4",
	"version": "2.0",
	"eventTime": "2024-03-07T11:02:06.928Z",
	"eventType": "STOCK",
	"context": "UNIQUE_ARTICLE_IDENTIFIER_DATA",
	"data": {
		"status": "SUCCESS",
		"buaid": "aaada2c3-b46d-4a95-a1c6-576a07170eea",
		"supplier": {
			"id": "12345",
			"name": "Mustermann AG"
		}
	}
}

4.2.5. Version history

Table 6. Version FINE to ERP
Version Number File Published on Changes

previous version

current version

1.0

Download

04.03.2024

- first draft

coming version

2.0

Download ALPHA

- change event type

- add context

- rename fields of supplier

- Look at chapter "Changelog"

4.2.6. Changelog

Changes V1.0

  • first draft

Changes V2.0

  1. Standard header:

    • event type is now "STOCK"

    • context "UNIQUE_ARTICLE_IDENTIFIER_DATA"

  2. Payload (Data)

    • rename fields of supplier

4.2.7. Schema

Interface FINE to ERP
{
  "$schema": "http://json-schema.org/draft-07/schema",
  "type": "object",
  "title": "Unique Article Identifier",
  "description": "Get unique article identifier data for a Buaid",
  "definitions": {
    "status": {
      "title": "Type of status",
      "description": "Type of status",
      "type": "string",
      "maxLength": 50,
        "enum": ["NOT_FOUND", "SUCCESS"]
    }
  },
  "required": [
    "eventId",
    "eventTime",
    "traceId",
    "eventType",
    "context",
    "version",
    "data"
  ],
  "properties": {
    "eventId": {
      "description": "UUID for this event",
      "type": "string",
      "format": "uuid",
      "minLength": 36,
      "maxLength": 36,
      "title": "UUID for this event",
      "examples": [
        "00ce536f-923a-42f4-8128-be118faf1d87"
      ],
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
    },
    "eventTime": {
      "description": "the date and time, when this event occured as an ISO-8601 timestamp.",
      "type": "string",
      "format": "date-time",
      "title": "the date and time, when this event occured as an ISO-8601 timestamp.",
      "examples": [
        "2022-03-31T12:41:06.036+0200"
      ]
    },
    "traceId": {
      "title": "The unique traceId",
      "description": "Global unique Id for tracing the flow of events",
      "type": "string",
      "format": "uuid",
      "minLength": 36,
      "maxLength": 36,
      "examples": ["00ce536f-923a-42f4-8138-33418faf1342"]
    },
    "eventType": {
      "title": "event type",
      "description": "the snapshot type to which the data belongs, currently only snapshots are supported",
      "type": "string",
      "maxLength": 20,
      "enum": ["STOCK"],
      "examples":["STOCK"]
    },
    "context": {
      "title": "context",
      "description": "The context specified here means the business domain.",
      "type": "string",
      "maxLength":50,
      "enum": [
          "UNIQUE_ARTICLE_IDENTIFIER_DATA"
      ]
    },
    "version": {
      "description": "JSON schema version",
      "type": "string",
      "pattern": "^[0-9]+[.][0-9]+$",
      "minLength": 3,
      "maxLength": 4,
      "title": "Json schema version",
      "examples": [
        "1.0",
        "1.11",
        "1.1"
      ]
    },
    "data": {
      "type": "object",
      "properties": {
        "status": {
          "title": "Status",
          "description": "Status",
          "$ref": "#/definitions/status"
        },
        "buaid": {
          "title": "buaid",
          "description": "bi unique article ID, unique identification of an individual unit in the logistical process",
          "type": "string",
          "maxLength": 50,
          "examples":["2344545-334542-465g45ddf"]
        },
      "supplier": {
        "type": "object",
        "properties": {
          "id": {
            "title": "supplier number",
            "description": "supplier number (LKZ) - deprecated",
            "type": "string",
            "maxLength": 50,
            "examples":["4"]
          },
          "name": {
            "title": "Name of supplier",
            "description": "Name of supplier",
            "type": "string",
            "maxLength": 50,
            "examples":["Zomtec GmbH"]
          },
          "erpSupplierId": {
            "title": "technical erp supplier id",
            "description": "erp supplier ID - LSAS based ID",
            "type": "string",
            "maxLength": 36,
            "examples":["123"]
          }
        }
      },
      "bestBeforeDate": {
        "title": "best Before Date",
        "description": "best before date",
        "type": "string",
        "format":"date",
        "examples":["2022-12-31"]
      },
      "batch": {
        "title": "batch",
        "description": "batch number",
        "type": "string",
        "maxLength": 100,
        "examples":["124345d"]
      },
      "imei": {
        "title": "imei",
        "description": "IMEI of a technical device",
        "type": "string",
        "maxLength": 50,
        "examples":["2345-45452-43365-5643"]
      },
      "imei2": {
        "title": "imei2",
        "description": "second IMEI of dual sim technical device",
        "type": "string",
        "maxLength": 50,
        "examples":["2345-45452-43365-5643"]
      },
      "serialNumber": {
        "title": "serial number",
        "description": "serial number of the manufacturer",
        "type": "string",
        "maxLength": 100,
        "examples":["D345-gkjpo-3112"]
      }
    },
    "required": [
      "status",
      "buaid"
    ]
    }
  }
}