Verfügbarkeitsanfrage / Fachliche Definitionen
- Riana Henning
Inhalte der Anfrage
Folgende Inhalte sind in der Anfrage enthalten:
Inhalte | Beschreibung | Pflicht | Format |
|---|---|---|---|
SellerID | Identifikation des Unternehmens (Lieferant) an dem angefragt wird (GLN). | Ja | Text 13 Stellen (0-9) |
BuyerID | Identifikation des Unternehmens (Händler), welche die Anfrage stellt (GLN). Ist der spätere “Bestellende” bzw. der “Rechnungsempfänger”. Die ID dient nicht zur Ableitung eines Standortes an den geliefert werden soll. | Ja | Text 13 Stellen (0-9) |
Kundennummer | Kundennummer des Handels beim Lieferanten, mit der die Anfrage erfolgt. | Ja | Text 15 Stellen |
Werksartikelnummer | Werksartikelnummer | Ja | Text 15 Stellen |
Menge | Menge | Ja | Zahl 18 Vorkommastellen 4 Nachkommastellen |
Mengeneinheit | Mengeneinheit analog den Stammdaten. Die Angabe von Verpackungseinheiten ist nicht möglich. Die Logik ist analog der Bestellung in EDIFACT. | Nein | Codeliste |
Lieferdatum | Angabe des gewünschten Lieferdatums (Eintreffen der Ware an der angegebenen Adresse) Folgende Angaben sind möglich:
| Nein | Datum |
Lieferziel | Angabe ob als Lieferziel ein Lager oder eine Kundenadresse angegeben wird.
| Nein | Codeliste |
GLN des Lieferziels | Wenn angegeben, kann diese direkt von der Industrie zur Identifizierung genutzt werden. | Ja, wenn “Lager” als Lieferziel angegeben wurde. | 13 Stellen (0-9) |
Adresse | Angabe der Adresse, an die die Lieferung erfolgen soll.
| Ja, wenn Lieferziel “Lager” oder “Strecke” |
|
Name 1 |
| Ja, wenn Adresse angegeben | String 30 Zeichen |
Name 2 |
| Nein | String 30 Zeichen |
Name 3 |
| Nein | String 30 Zeichen |
Strasse |
| Ja, wenn Adresse angegeben | String 30 Zeichen |
Hausnummer |
| Ja, wenn Adresse angegeben | String 15 Zeichen |
PLZ |
| Ja, wenn Adresse angegeben | String 6 Zeichen |
Ort |
| Ja, wenn Adresse angegeben | String 30 Zeichen |
Land |
| Ja, wenn Adresse angegeben | Codeliste |
Inhalte der Antwort
Inhalte | Beschreibung | Pflicht | Format |
|---|---|---|---|
Parameter aus der Anfrage | |||
SellerID | Identifikation des Unternehmens (Lieferant) an dem angefragt wird (GLN). | Ja | Text 13 Stellen (0-9) |
BuyerID | Identifikation des Unternehmens (Händler), welche die Anfrage stellt (GLN). Ist der spätere “Bestellende” bzw. der “Rechnungsempfänger”. Die ID dient nicht zur Ableitung eines Standortes an den geliefert werden soll. | Ja | Text 13 Stellen (0-9) |
Kundennummer | Kundennummer, mit der die Anfrage erfolgt. | Nein | Text 15 Stellen |
Werksartikelnummer | Werksartikelnummer | Ja | Text 15 Stellen |
Menge | Menge | Ja | Zahl 18 Vorkommastellen 4 Nachkommastellen |
Mengeneinheit | Mengeneinheit | Nein | Codeliste |
Lieferdatum | Angabe des gewünschten Lieferdatums. Wenn kein Datum angegeben ist, wird die Information zur grundsätzlichen Verfügbarkeit angegeben. | Nein | Datum |
Lieferadresse | Angabe der Adresse an die die Lieferung erfolgen soll. Wenn keine Adresse angegeben ist, wird die Information zur grundsätzlichen Verfügbarkeit angegeben. | Nein, einfach | Struktur |
Name 1 |
| Ja, wenn Adresse angegeben | String 30 Zeichen |
Name 2 |
| Nein | String 30 Zeichen |
Name 3 |
| Nein | String 30 Zeichen |
Strasse |
| Ja, wenn Adresse angegeben | String 30 Zeichen |
Hausnummer |
| Ja, wenn Adresse angegeben | String 15 Zeichen |
PLZ |
| Ja, wenn Adresse angegeben | String 6 Zeichen |
Ort |
| Ja, wenn Adresse angegeben | String 30 Zeichen |
Land |
| Ja, wenn Adresse angegeben | Codeliste |
Antwortparameter | |||
Status | Status der Verfügbarkeitsanfrage | Ja, einfach | Struktur |
| Codierter Status | Ja | Codeliste |
| Subtyp des Status | Nein | Codeliste |
| Meldung zum Status | Nein | Text 250 Zeichen |
Lieferplan | Liste der Lieferungen zu den verschiedenen Zeitpunkten | Nein, mehrfach | Struktur |
| Datumsangabe, zu dem die Menge verfügbar ist | Ja | Datum |
| Angabe der Menge (ggf. Teilmenge oder Restmenge) die zu dem Datum verfügbar ist | Ja | Zahl 18 Vorkommastellen 4 Nachkommastellen |
| Mengeneinheit | Ja | Codeliste |
Fälle in der korrekten Antwort
Fall | Beschreibung | Daten in der Antwort | ||
|---|---|---|---|---|
statusCode | SubType | Beispiel | ||
OK | Artikel ist in der Menge verfügbar und kann an das Lager oder die Adresse geliefert werden. | OK | - | "avalibility": {
"status": {
"statusCode": "OK"
},
"deliveryPlan": [
{
"deliveryDate": "2021-10-22",
"quantity": "20",
"quantityUnit": "PCE"
}
]
} |
OK, generelle Verfügbarkeit | Artikel ist in der Menge verfügbar, es werden aber keine informationen zur Lieferung bereitgestellt | OK | - | "avalibility": {
"status": {
"statusCode": "OK"
}
} |
Geändert | Menge geändert erhöht | changed | quantity changed | "avalibility":
{
"status": {
"statusCode": "changed",
"subType": "quantity changed",
"statusMassage": "Menge aufgrund der VPE angepasst"
},
"deliveryPlan": [
{
"deliveryDate": "2021-10-22",
"quantity": "25",
"quantityUnit": "PCE"
}
]
} |
| Menge geändert reduziert | changed | quantity changed | |
| Datum geändert | changed | deliverydate changed | |
| Datum und Menge geändert | changed | quantity and deliverydate changed | |
Nicht möglich | An das Lager oder die Adresse ist eine Lieferung nicht möglich. | not possible | no delivery | |
| Artikel kann nicht, auch nicht später, geliefert werden. | not possible | not available | |
| Artikel kann aktuell nicht geliefert werden. | not possible | temporary not available | |
Fehlerfälle
Folgende Fehlerfälle können bereitgestellt werden:
'400': description: Bad Request
'401': description: Unauthorized
'403': description: Forbidden
'404': description: Not Found (z. B. Artikel nicht bekannt)
'405': description: Method Not Allowed
'429': description: Too Many Requests
'500': description: Internal Server Error
'501': description: Not implemented
'502': description: Bad gateway
'503': description: Service Unavailable
'504': description: Gateway timeout
'550': Angefragter Lieferant stellt keine Informationen in der Verfügbarkeitsanfrage bereit
‘551’: Angefragter Lieferant hat keine Partnerbeziehung zum anfragenden Unternehmen