News & Anleitungen » Produktverfügbarkeit (_item_:availability)

Produktverfügbarkeit (_item_:availability)

Inhalt

Jedes Produkt (_item_) besitzt ein availability-Objekt. Darüber werden Lagerbestand, Nachlieferbarkeit und die Lieferzeit an das Frontend übergeben.

Aufbau

{
"availability": {
"availability_allocatablecount_boxf": 12,
"availability_text_boxs": "",
"availability_delivery_days_from_boxi": 1,
"availability_delivery_days_till_boxi": 3,
"availability_delivery_date_from_boxd": null,
"availability_delivery_days_till_boxd": null,
"availability_reorder_boxi": 1
}
}

Felder

FeldTypBeschreibung
availability_allocatablecount_boxfIntegerAnzahl der aktuell verfügbaren, verkaufbaren Artikel. Werte größer als 0 bedeuten, dass Lagerbestand vorhanden ist.
availability_reorder_boxiInteger (0/1)Gibt an, ob der Artikel nachbestellt werden kann. 0 = nachlieferbar, 1 = nicht nachlieferbar.
availability_delivery_days_from_boxiIntegerFrühester Lieferzeitpunkt in Tagen. Wird zusammen mit availability_delivery_days_till_boxi verwendet.
availability_delivery_days_till_boxiIntegerSpätester Lieferzeitpunkt in Tagen.
availability_delivery_date_from_boxdISO-8601 Datum oder nullAlternativer Lieferbeginn als festes Datum. Überschreibt die Tagesangaben.
availability_delivery_days_till_boxdISO-8601 Datum oder nullAlternatives Lieferende als festes Datum.
availability_text_boxsStringOptionaler Freitext zur Lieferzeit. Kann zusätzlich oder unabhängig von den Datumsfeldern verwendet werden.

Logik

1. Lagerbestand

availability_allocatablecount_boxf > 0

Der Artikel ist auf Lager und kann sofort verkauft werden.

availability_allocatablecount_boxf = 0

Der Artikel ist aktuell nicht auf Lager.

2. Nachlieferbarkeit

availability_reorder_boxi = 0

Der Artikel kann trotz fehlendem Lagerbestand bestellt werden.

availability_reorder_boxi = 1

Der Artikel kann nicht nachbestellt werden.

Kaufbarkeit

LagerbestandNachlieferbarKaufbar
> 00 oder 1Ja (InStock)
00Ja (BackOrder)
01Nein (OutOfStock)

3. Lieferzeit

Es gibt drei Möglichkeiten, die Lieferzeit anzugeben.

Variante 1 – Lieferzeit in Tagen

{
"availability": {
"availability_delivery_days_from_boxi": 3,
"availability_delivery_days_till_boxi": 7
}
}

Beispielausgabe:

Lieferzeit: 3–7 Werktage

Variante 2 – Feste Lieferdaten

Falls der Händler konkrete Liefertermine kennt, können statt der Tagesangaben feste Datumswerte übergeben werden.

{
"availability": {
"availability_delivery_date_from_boxd": "2026-07-10T22:00:00+00:00",
"availability_delivery_days_till_boxd": "2026-07-12T22:00:00+00:00"
}
}

Beispielausgabe:

Lieferung zwischen 11.07.2026 und 13.07.2026

(Die Ausgabe sollte in die lokale Zeitzone und das gewünschte Datumsformat umgewandelt werden.)

Variante 3 – Freitext

Zusätzlich oder alternativ kann ein individueller Liefertext angegeben werden.

{
"availability": {
"availability_text_boxs": "Bestellt, Liefertermin am 10.07.2026"
}
}

Beispielausgabe:

Bestellt, Liefertermin am 10.07.2026

Der Freitext kann unabhängig von den Datumsfeldern verwendet werden, z. B. für:

  • Bestellt, Liefertermin am 10.07.2026
  • Vorbestellung möglich
  • Lieferung auf Anfrage
  • Individuelle Fertigung
  • Versand nach Freigabe

Beispiele

Sofort verfügbar (InStock)

{
  "availability": {
    "availability_allocatablecount_boxf": 15,
    "availability_reorder_boxi": 0,
    "availability_delivery_days_from_boxi": 1,
    "availability_delivery_days_till_boxi": 3,
    "availability_delivery_date_from_boxd": null,
    "availability_delivery_days_till_boxd": null,
    "availability_text_boxs": ""
  }
}

Anzeige:

✔ Sofort verfügbar
Lieferzeit: 1–3 Werktage

Nicht auf Lager, aber nachbestellbar (BackOrder)

{
  "availability": {
    "availability_allocatablecount_boxf": 0,
    "availability_reorder_boxi": 0,
    "availability_delivery_days_from_boxi": 3,
    "availability_delivery_days_till_boxi": 7,
    "availability_delivery_date_from_boxd": null,
    "availability_delivery_days_till_boxd": null,
    "availability_text_boxs": ""
  }
}

Anzeige:

Lieferzeit: 3–7 Werktage

Zukünftig fester Liefertermin bekannt (BackOrder)

{
  "availability": {
    "availability_allocatablecount_boxf": 0,
    "availability_reorder_boxi": 0,
    "availability_delivery_date_from_boxd": "2026-07-10T22:00:00+00:00",
    "availability_delivery_days_till_boxd": "2026-07-12T22:00:00+00:00",
    "availability_text_boxs": "Bestellt, Liefertermin am 10.07.2026"
  }
}

Anzeige:

Bestellt, Liefertermin ab 10.07.2026

Nicht kaufbar: Zukünftig fester Liefertermin bekannt (BackOrder)

{
  "availability": {
    "availability_allocatablecount_boxf": 0,
    "availability_reorder_boxi": 1,
    "availability_delivery_date_from_boxd": "2026-07-10T22:00:00+00:00",
    "availability_delivery_days_till_boxd": "2026-07-12T22:00:00+00:00",
    "availability_text_boxs": "Bestellt, Liefertermin am 10.07.2026"
  }
}

Anzeige:

Bestellt, Liefertermin ab 10.07.2026

Nicht kaufbar (OutOfStock)

{
  "availability": {
    "availability_allocatablecount_boxf": 0,
    "availability_reorder_boxi": 1,
    "availability_delivery_days_from_boxi": 0,
    "availability_delivery_days_till_boxi": 0,
    "availability_delivery_date_from_boxd": null,
    "availability_delivery_days_till_boxd": null,
    "availability_text_boxs": ""
  }
}

Anzeige:

Der Artikel ist derzeit nicht verfügbar.

Priorität der Lieferzeitanzeige

Produktseiten

Auf Produktseiten gilt folgende Priorität:

  1. availability_text_boxs
  2. availability_delivery_date_from_boxd bis availability_delivery_days_till_boxd
  3. availability_delivery_days_from_boxi bis availability_delivery_days_till_boxi

Zusätzlich kann im Produkttemplate definiert werden, wie Priorität 2 und 3 ausgegeben werden:

Einstellung im TemplateBeispielausgabe
Als Datum anzeigen10.07.2026 – 12.07.2026
Als Tage anzeigen3–7 Werktage

OBS-Interfaces Daten-Feed / strukturierte Daten

In den Daten-Feeds von OBS-Interfaces und den strukturierten Datenausgaben auf der Produktseite wird kein Freitext verwendet. Dort gilt:

  1. Datumsangabe from
  2. Tagesangabe form

Beispiel:

{
  "availability": {
    "availability_delivery_date_from_boxd": "2026-07-10T22:00:00+00:00"
  }
}

Alternativ:

{
  "availability": {
    "availability_delivery_days_from_boxi": 3
  }
}

Ausgabewerte Google XML Daten-Feed

LagerbestandNachlieferbar<g:availability><g:availability_date>
> 00 oder 1in_stock
00backorder2026-07-10T22:00:00+00:00
01out_of_stock

Siehe auch Platzhalter Typ Google Shopping

Ausgabewerte strukturierte Daten Produktseite

LagerbestandNachlieferbaroffers: availabilityoffers: availabilityStarts
> 00 oder 1https://schema.org/InStock
00https://schema.org/BackOrder2026-07-10T22:00:00+00:00
01https://schema.org/OutOfStock

Lieferzeit ab einer Uhrzeit um einen Tag erhöhen

In den Einstellungen kann zusätzlich aktiviert werden, dass ab einer bestimmten Tagesuhrzeit generell ein zusätzlicher Versandtag addiert wird. Dieser wird auf den Produktseiten addiert, nicht in den (Interfaces-) Feeds

Option Tageszeit, nach der ein zusätzlicher Liefertag angezeigt wird

Hilfecenter: