{
"eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
"eventTime": "2016-04-16T16:06:05+02:00",
"eventType": "QUALITY_RESULT",
"traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
"spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
"version": "1.0",
"context": "QS",
"metaData": {
"sender": "kMotion",
"instance": "kMotion-ILO",
"client": "OTTO"
},
"data": {
"location": "ILOWA",
"deliveryNumber": 124404,
"product": {
"erpProductId": "1234567890"
},
"supplierNumber": 11148,
"receivingDocumentNumber": 41123,
"qualityCode": 103,
"resultCode": "APPROPRIATE",
"rejectionCode": "F",
"inspectionId": "1234567890",
"wmsPositionId": "4552140011"
}
}
I07 Quality Result
- Status
-
Version 1.0 published 18.10.2022
- Approval
- Comment
- Assumption
-
_
1. Stakeholder
Role | Application | Responsible |
---|---|---|
Communication |
Integration Layer |
|
Leading App |
QS |
|
InterfaceOwner |
||
Producer |
Lionfish |
|
Consumer |
kMotion |
|
Consumer |
KR1 |
|
Consumer |
COBRA |
|
Consumer |
FLASH |
2. Business Context
Nach der Lieferscheinerfassung im Wareneingang muss die Prüfmenge ermittelt werden für die Qualitätsprüfung. Das LVS sendet eine Musterziehungsanfrage über und erhält die Prüfmenge oder bei Außenprüfung bereits ein Prüfergebnis zurück. Das Lager versendet die Ware physisch zur Prüfung. Nach Abschluss der Warenprüfung sendet das Warenprüfungssystem das Ergebnis an das LVS und das BI -System.
3. Informationflow
4. Interface
4.1. Direction ERP to FINE
4.1.1. Header
This interface uses the Service Header
Special expresion for this interface:
Fieldname | Expresion |
---|---|
context |
QUALITY_RESULT CMS_RESULT |
eventType |
QUALITY_RESULT CMS_RESULT |
4.1.2. Datamodel
Property | Type | Description |
---|---|---|
(Root) |
object |
QSResultErp |
eventId* |
string |
The uniq eventId Maximum Length: 36 |
traceId* |
string |
The uniq traceId Maximum Length: 36 |
spanId |
string |
The eventId of previous record or batchId Maximum Length: 36 |
eventTime* |
string (date-time) |
Time of occurrence of the event |
version* |
string |
Json schema version Minimum Length: 3 |
context |
string |
The context / business case Maximum Length: 36 |
eventType* |
string |
The concrete type = kind of record(event) Maximum Length: 36 |
metaData |
object |
additional meta information |
sender |
string |
The name of sender = producer Maximum Length: 30 |
instance |
string |
SW-Instance of the producing system |
client |
string |
Client / Tenant |
data* |
object |
|
location* |
string |
Request location Minimum Length: 3 |
deliveryNumber* |
string |
Delivery Number Maximum Length: 36 |
product* |
object |
|
erpProductId* |
string |
Erp product Id Maximum Length: 50 |
supplierNumber* |
integer |
Supplier number Minimum Length: 1 |
receivingDocumentNumber* |
integer |
Receiving document number Maximum Length: 20 |
qualityCode* |
integer |
Quality code Maximum Length: 6 |
resultCode* |
string |
Quality result code |
rejectionCode |
string |
Rejection code Minimum Length: 1 |
inspectionId |
string |
Inspection Id Maximum Length: 36 |
wmsPositionId* |
string |
LVS VorgangsID Maximum Length: 36 |
resultQuantity |
number |
Result quantity |
cmsId |
string |
CMS Id Maximum Length: 36 |
4.1.3. Enumeration
Field: Result Code
Meta Value | Description | Short Value |
---|---|---|
APPROPRIATE |
Freischaltung - Qualität in Ordnung |
|
INADEQUATE |
Keine Freischaltung - Qualität nicht in Ordnung |
|
RETURN |
Rücksendung |
|
REWORK |
Nacharbeit |
|
ONSTOCK |
Freischaltung nach Claim (ggf. trotz Fehlerbild) |
|
SCRAP |
Verschrottung |
|
THIRD_PARTY_SELLING |
Sonderdrittverkauf |
|
SECONDARY INSPECTION |
Zweitprüfung |
4.1.4. Example
4.1.5. Schema
Version | Number | File | Published on | Changes |
---|---|---|---|---|
current version |
1.0 |
26.05.2022 |
||
previous version |
||||
coming version |
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "QSResultErp",
"description": "Prüfergebnisse der Warenprüfung",
"type": "object",
"properties": {
"eventId": {
"type": "string",
"title": "The uniq eventId",
"maxLength": 36,
"description": "Global uniq Id, recommended as uuid",
"examples": [
"00ce536f-923a-42f4-8128-be118faf1d87"
]
},
"traceId": {
"type": "string",
"title": "The uniq traceId",
"maxLength": 36,
"description": "Global uniq Id for tracing the flow of events, recommended as uuid",
"examples": [
"00ce536f-923a-42f4-8138-33418faf1342"
]
},
"spanId": {
"type": "string",
"title": "The eventId of previous record or batchId",
"maxLength": 36,
"description": "Optionally, if this record (event) is one of a sequence of records and the order is important, then here is the id of the previous record (event) or event is a part of a batch, recommended as uuid, Special usecases can be specify for some interfaces",
"examples": [
"00ce536f-923a-42f4-5463-32a41877b3c2"
]
},
"eventTime": {
"type": "string",
"title": "Time of occurrence of the event",
"format": "date-time",
"description": "Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC.",
"examples": [
"2016-04-16T16:06:05Z",
"2016-04-16T16:06:05+02:00"
]
},
"version": {
"description": "Version of the interface",
"type": "string",
"pattern": "^[0-9]+[.][0-9]+$",
"minLength": 3,
"maxLength": 5,
"title": "Json schema version",
"examples": [
"1.0",
"1.11",
"1.1"
]
},
"context": {
"type": "string",
"title": "The context / business case",
"description": "The optional context specified here means the business domain.",
"maxLength": 36,
"examples": [
"QS"
]
},
"eventType": {
"type": "string",
"title": "The concrete type = kind of record(event)",
"maxLength": 36,
"description": "This attribute is to be used if the data set can have more than one characteristic. E.g. goods delivery start or goods delivery end. The possible values are to be co-ordinated here as Enum between the partners.",
"examples": [
"QUALITY_RESULT"
]
},
"metaData": {
"type": "object",
"title": "additional meta information",
"description": "optional, can be used with different characteristics for technical data per interface",
"properties": {
"sender": {
"type": "string",
"examples": [
"KR1",
"ADD"
],
"title": "The name of sender = producer",
"maxLength": 30,
"description": "Name of the source system, which has generated this data."
},
"instance": {
"type": "string",
"examples": [
"kMotion-ILO",
"kMotion-GERNSHEIM"
],
"title": "SW-Instance of the producing system",
"description": "Name of the source instance, which has generated this data"
},
"client": {
"type": "string",
"title": "Client / Tenant",
"description": "the client (messages of different clients have different processing rules and destination interfaces)",
"examples": [
"KONZERN",
"OTTO",
"MYTOYS"
]
}
}
},
"data": {
"type": "object",
"properties": {
"location": {
"description": "Standort. Bsp. für Kmotion@LSB einen Festwert: LANGENSELBOLD",
"type": "string",
"maxLength": 30,
"minLength": 3,
"title": "Request location",
"examples": [
"LANGENSELBOLD"
]
},
"deliveryNumber": {
"description": "Nummer der Anlieferung",
"type": "string",
"title": "Delivery Number",
"maxLength": 36,
"examples": [
"1"
]
},
"product": {
"type": "object",
"properties": {
"erpProductId": {
"description": "FINE-LSAS ERP Product Identifier.",
"type": "string",
"maxLength": 50,
"title": "Erp product Id",
"examples": [
"45896254"
]
}
},
"required": [
"erpProductId"
]
},
"supplierNumber": {
"description": "Lieferantenkennziffer",
"type": "integer",
"title": "Supplier number",
"examples": [
1
],
"maxLength": 6,
"minLength": 1
},
"receivingDocumentNumber": {
"description": "Warenannahmeprotokoll (WAP) Nummer",
"type": "integer",
"title": "Receiving document number",
"examples": [
12
],
"maxLength": 20
},
"qualityCode": {
"description": "Prüfergebnis. Bei 103 oder 110 --> manuelle Freigabe; Friegabe nur dann wenn qualityCode mit diesen Werten anfängt: 10,11,15,45,50,75",
"type": "integer",
"title": "Quality code",
"maxLength": 6,
"examples": [
10,
11,
15
]
},
"resultCode": {
"description": "Ergebnis der Warenprüfung. Mögliche Werte: APPROPRIATE, REWORK, RETURN, INADEQUATE",
"type": "string",
"title": "Quality result code",
"examples": [
"APPROPRIATE"
]
},
"rejectionCode": {
"description": "Beanstandungskennzeichen. Mögliche Werte: leer, F = Formale Fehler, S = Serienfehler, Q = Qualitätsfehler",
"type": "string",
"maxLength": 1,
"minLength": 1,
"title": "Rejection code",
"examples": [
"F",
"S",
"Q"
]
},
"inspectionId": {
"description": "Prüfauftrag Identifier",
"type": "string",
"title": "Inspection Id",
"maxLength": 36,
"examples": [
"12"
]
},
"wmsPositionId": {
"description": "LVS VorgangsID",
"type": "string",
"title": "LVS VorgangsID",
"maxLength": 36,
"examples": [
"45880014",
"390b8b08-20b9-11ed-861d-0242ac120002"
]
},
"resultQuantity": {
"description": "Optionale Ergebnismenge. Wenn nicht vorhanden, dann bezieht sich das Ergebnis auf die ganze Liefermenge. Mit dem Attribut kann man Prüfergebnisse bezugen auf eine Teilmenge übertragen",
"type": "number",
"title": "Result quantity",
"examples": [
12
]
},
"cmsId": {
"description": "CMS Identifier",
"type": "string",
"title": "CMS Id",
"maxLength": 36,
"examples": [
"12"
]
}
},
"required": [
"location",
"deliveryNumber",
"product",
"supplierNumber",
"receivingDocumentNumber",
"qualityCode",
"resultCode",
"wmsPositionId"
]
}
},
"required": [
"eventId",
"eventTime",
"traceId",
"eventType",
"version",
"data"
],
"examples": [
{
"eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
"eventTime": "2016-04-16T16:06:05+02:00",
"eventType": "QUALITY_RESULT",
"traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
"spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
"version": "1.0",
"context": "QS",
"metaData": {
"sender": "kMotion",
"instance": "kMotion-ILO",
"client": "OTTO"
},
"data": {
"location": "ILOWA",
"deliveryNumber": 124404,
"product": {
"erpProductId": "1234567890"
},
"supplierNumber": 11148,
"receivingDocumentNumber": 41123,
"qualityCode": 103,
"resultCode": "APPROPRIATE",
"rejectionCode": "F",
"inspectionId": "1234567890",
"wmsPositionId": "4552140011"
}
}
]
}
4.2. Direction FINE to WMS
4.2.1. Header
This interface uses the Service Header
Special expresion for this interface:
Fieldname | Expresion |
---|---|
context |
QUALITY_RESULT CMS_RESULT |
eventType |
QUALITY_RESULT CMS_RESULT |
4.2.2. Datamodel
Property | Type | Description |
---|---|---|
(Root) |
object |
QSResultWms |
eventId* |
string |
The uniq eventId Maximum Length: 36 |
traceId* |
string |
The uniq traceId Maximum Length: 36 |
spanId |
string |
The eventId of previous record or batchId Maximum Length: 36 |
eventTime* |
string (date-time) |
Time of occurrence of the event |
version* |
string |
Json schema version Minimum Length: 3 |
context |
string |
The context / business case Maximum Length: 36 |
eventType* |
string |
The concrete type = kind of record(event) Maximum Length: 36 |
metaData |
object |
additional meta information |
sender |
string |
The name of sender = producer Maximum Length: 30 |
instance |
string |
SW-Instance of the producing system |
client |
string |
Client / Tenant |
data* |
object |
|
location* |
string |
Request location Minimum Length: 3 |
deliveryNumber* |
string |
Delivery Number |
product* |
object |
|
logisticsProductId* |
string |
Logistics Product Id Maximum Length: 50 |
supplierNumber* |
integer |
Supplier number Minimum Length: 1 |
receivingDocumentNumber* |
integer |
Receiving document number Maximum Length: 20 |
qualityCode* |
integer |
Quality code Maximum Length: 6 |
resultCode* |
string |
Quality result code |
rejectionCode |
string |
Rejection code Minimum Length: 1 |
inspectionId |
string |
Inspection Id Maximum Length: 36 |
wmsPositionId* |
string |
LVS VorgangsID Maximum Length: 36 |
resultQuantity |
number |
Result quantity |
cmsId |
string |
CMS Id Maximum Length: 36 |
4.2.3. Enumeration
Field: Result Code
Meta Value | Description | Short Value |
---|---|---|
APPROPRIATE |
Freischaltung - Qualität in Ordnung |
|
INADEQUATE |
Keine Freischaltung - Qualität nicht in Ordnung |
|
RETURN |
Rücksendung |
|
REWORK |
Nacharbeit |
|
ONSTOCK |
Freischaltung nach Claim (ggf. trotz Fehlerbild) |
|
SCRAP |
Verschrottung |
|
THIRD_PARTY_SELLING |
Sonderdrittverkauf |
|
SECONDARY INSPECTION |
Zweitprüfung |
4.2.4. Example
{
"eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
"eventTime": "2016-04-16T16:06:05+02:00",
"eventType": "QUALITY_RESULT",
"traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
"spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
"version": "1.0",
"context": "QS",
"metaData": {
"sender": "kMotion",
"instance": "kMotion-ILO",
"client": "OTTO"
},
"data": {
"location": "ILOWA",
"deliveryNumber": 124404,
"product": {
"logisticsProductId": "1234567890"
},
"supplierNumber": 11148,
"receivingDocumentNumber": 41123,
"qualityCode": 103,
"resultCode": "APPROPRIATE",
"rejectionCode": "F",
"inspectionId": "1234567890",
"wmsPositionId": "4552140011"
}
}
4.2.5. Schema
Version | Number | File | Published on | Changes |
---|---|---|---|---|
current version |
1.0 |
26.05.2022 |
||
previous version |
||||
coming version |
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "QSResultWms",
"description": "Prüfergebnisse der Warenprüfung",
"type": "object",
"properties": {
"eventId": {
"type": "string",
"maxLength": 36,
"title": "The uniq eventId",
"description": "Global uniq Id, recommended as uuid",
"examples": [
"00ce536f-923a-42f4-8128-be118faf1d87"
]
},
"traceId": {
"type": "string",
"maxLength": 36,
"title": "The uniq traceId",
"description": "Global uniq Id for tracing the flow of events, recommended as uuid",
"examples": [
"00ce536f-923a-42f4-8138-33418faf1342"
]
},
"spanId": {
"type": "string",
"title": "The eventId of previous record or batchId",
"maxLength": 36,
"description": "Optionally, if this record (event) is one of a sequence of records and the order is important, then here is the id of the previous record (event) or event is a part of a batch, recommended as uuid, Special usecases can be specify for some interfaces",
"examples": [
"00ce536f-923a-42f4-5463-32a41877b3c2"
]
},
"eventTime": {
"type": "string",
"title": "Time of occurrence of the event",
"format": "date-time",
"description": "Time at which this record(event) was technically generated in RFC3339 format with timezone or UTC.",
"examples": [
"2016-04-16T16:06:05Z",
"2016-04-16T16:06:05+02:00"
]
},
"version": {
"description": "Version of the interface",
"type": "string",
"pattern": "^[0-9]+[.][0-9]+$",
"minLength": 3,
"maxLength": 5,
"title": "Json schema version",
"examples": [
"1.0",
"1.11",
"1.1"
]
},
"context": {
"type": "string",
"title": "The context / business case",
"maxLength": 36,
"description": "The optional context specified here means the business domain.",
"examples": [
"QS"
]
},
"eventType": {
"type": "string",
"title": "The concrete type = kind of record(event)",
"maxLength": 36,
"description": "This attribute is to be used if the data set can have more than one characteristic. E.g. goods delivery start or goods delivery end. The possible values are to be co-ordinated here as Enum between the partners.",
"examples": [
"QUALITY_RESULT"
]
},
"metaData": {
"type": "object",
"title": "additional meta information",
"description": "optional, can be used with different characteristics for technical data per interface",
"properties": {
"sender": {
"type": "string",
"examples": [
"KR1",
"ADD"
],
"maxLength": 30,
"title": "The name of sender = producer",
"description": "Name of the source system, which has generated this data."
},
"instance": {
"type": "string",
"examples": [
"kMotion-ILO",
"kMotion-GERNSHEIM"
],
"title": "SW-Instance of the producing system",
"description": "Name of the source instance, which has generated this data"
},
"client": {
"type": "string",
"title": "Client / Tenant",
"description": "the client (messages of different clients have different processing rules and destination interfaces)",
"examples": [
"KONZERN",
"OTTO",
"MYTOYS"
]
}
}
},
"data": {
"type": "object",
"properties": {
"location": {
"description": "Standort. Bsp. für Kmotion@LSB einen Festwert: LANGENSELBOLD",
"type": "string",
"maxLength": 30,
"minLength": 3,
"title": "Request location",
"examples": [
"LANGENSELBOLD"
]
},
"deliveryNumber": {
"description": "Nummer der Anlieferung",
"type": "string",
"title": "Delivery Number",
"examples": [
"1"
]
},
"product": {
"type": "object",
"properties": {
"logisticsProductId": {
"description": "FINE-LSAS Logistics Product Identifier.",
"type": "string",
"maxLength": 50,
"title": "Logistics Product Id",
"examples": [
"45896254"
]
}
},
"required": [
"logisticsProductId"
]
},
"supplierNumber": {
"description": "Lieferantenkennziffer",
"type": "integer",
"title": "Supplier number",
"examples": [
1
],
"maxLength": 6,
"minLength": 1
},
"receivingDocumentNumber": {
"description": "Warenannahmeprotokoll (WAP) Nummer",
"type": "integer",
"title": "Receiving document number",
"examples": [
12
],
"maxLength": 20
},
"qualityCode": {
"description": "Prüfergebnis. Bei 103 oder 110 --> manuelle Freigabe; Friegabe nur dann wenn qualityCode mit diesen Werten anfängt: 10,11,15,45,50,75",
"type": "integer",
"title": "Quality code",
"maxLength": 6,
"examples": [
10,
11,
15
]
},
"resultCode": {
"description": "Ergebnis der Warenprüfung. Mögliche Werte: APPROPRIATE, REWORK, RETURN, INADEQUATE",
"type": "string",
"title": "Quality result code",
"examples": [
"APPROPRIATE"
]
},
"rejectionCode": {
"description": "Beanstandungskennzeichen. Mögliche Werte: leer, F = Formale Fehler, S = Serienfehler, Q = Qualitätsfehler",
"type": "string",
"maxLength": 1,
"minLength": 1,
"title": "Rejection code",
"examples": [
"F",
"S",
"Q"
]
},
"inspectionId": {
"description": "Prüfauftrag Identifier",
"type": "string",
"title": "Inspection Id",
"maxLength": 36,
"examples": [
"12"
]
},
"wmsPositionId": {
"description": "LVS VorgangsID",
"type": "string",
"title": "LVS VorgangsID",
"maxLength": 36,
"examples": [
"45880014",
"390b8b08-20b9-11ed-861d-0242ac120002"
]
},
"resultQuantity": {
"description": "Optionale Ergebnismenge. Wenn nicht vorhanden, dann bezieht sich das Ergebnis auf die ganze Liefermenge. Mit dem Attribut kann man Prüfergebnisse bezugen auf eine Teilmenge übertragen",
"type": "number",
"title": "Result quantity",
"examples": [
12
]
},
"cmsId": {
"description": "CMS Identifier",
"type": "string",
"title": "CMS Id",
"maxLength": 36,
"examples": [
"12"
]
}
},
"required": [
"location",
"deliveryNumber",
"product",
"supplierNumber",
"receivingDocumentNumber",
"qualityCode",
"resultCode",
"wmsPositionId"
]
}
},
"required": [
"eventId",
"eventTime",
"traceId",
"eventType",
"version",
"data"
],
"examples": [
{
"eventId": "b7731f51-fa96-43e8-9035-46221d31fd26",
"eventTime": "2016-04-16T16:06:05+02:00",
"eventType": "QUALITY_RESULT",
"traceId": "4b8cce05-51a6-412e-89a0-sdfsdfsdfsdf",
"spanId": "00ce536f-923a-42f4-5463-32a41877b3c2",
"version": "1.0",
"context": "QS",
"metaData": {
"sender": "kMotion",
"instance": "kMotion-ILO",
"client": "OTTO"
},
"data": {
"location": "ILOWA",
"deliveryNumber": 124404,
"product": {
"logisticsProductId": "1234567890"
},
"supplierNumber": 11148,
"receivingDocumentNumber": 41123,
"qualityCode": 103,
"resultCode": "APPROPRIATE",
"rejectionCode": "F",
"inspectionId": "1234567890",
"wmsPositionId": "4552140011"
}
}
]
}