Händler-API

Verbinde deine Warenwirtschaft, dein Shopsystem oder deinen Dropshipping-Lieferanten direkt mit deinem eveyamin-Shop: Produkte anlegen und pflegen, Bestand in Sekunden abgleichen, bezahlte Bestellungen abholen und den Versand melden.

API-Schlüssel erstellen OpenAPI-Datei English version

Einstieg

Die Händler-API ist eine REST-Schnittstelle mit JSON unter https://eveyamin.com/api/v1. Feldnamen und Werte sind deutsch – Kategorien, Farben, Größen und Status genau so, wie sie im Shop stehen. Eine Anbindung baut dein Entwickler, deine Agentur oder ein Middleware-Dienst; fertige Plugins für einzelne Warenwirtschaften gibt es nicht.

Schlüssel erstellen

Unter Einstellungen → API-Zugang einen Schlüssel erstellen und nur die Berechtigungen wählen, die die Anbindung braucht.
Den Schlüssel sofort kopieren und sicher ablegen – er wird nur dieses eine Mal angezeigt.
Bei jeder Anfrage im Header Authorization: Bearer <Schlüssel> mitsenden.

Berechtigung	Erlaubt
`produkte:schreiben`	Produkte anlegen, ändern, lesen und archivieren
`bestand:schreiben`	Bestand lesen und setzen
`bestellungen:lesen`	Bestellungen abrufen und bestätigen (sobald dein Shop live ist)
`bestellungen:versenden`	Versand mit Sendungsnummer melden

Schlüssel gehören auf einen Server, nie in eine Webseite oder App. Bis zu 10 Schlüssel sind möglich – nimm für jede Anbindung einen eigenen, dann kannst du einen einzeln widerrufen. Widerrufe einen Schlüssel sofort, wenn er in falsche Hände geraten sein könnte.

Erster Aufruf

Anfrage

curl https://eveyamin.com/api/v1/ping \
  -H "Authorization: Bearer evy_live_…"

Antwort

{
  "ok": true,
  "umgebung": "live",
  "haendler_id": "5a03da19-…",
  "schluessel": {
    "name": "Warenwirtschaft",
    "praefix": "evy_live_Ab3x",
    "berechtigungen": ["bestand:schreiben", "bestellungen:lesen"]
  }
}

Live und Test

Schlüssel beginnen mit evy_live_ (Shop) oder evy_test_ (Testumgebung) und gelten nur dort, wo sie erstellt wurden. Ein Schlüssel aus der anderen Umgebung bekommt 401 keyWrongEnvironment.

Deutsche Werte

Kategorien kommen als vollständiger Pfad (eve-Home > Bettwäsche > Bettwäsche-Sets), Farben und Größen genau wie im Shop. GET /api/v1/taxonomy liefert alle Kategorien mit ihren Größen und alle Farben. Kleine Abweichungen korrigiert die API selbst (weiss → Weiß, 200x200 → 200 x 200 cm) und meldet das als Hinweis. Eigene Bezeichnungen deiner Warenwirtschaft ordnest du einmal im CSV-Import zu; die Zuordnung gilt auch für die API.

Grenzen

Was	Grenze
Anfragen pro Schlüssel	120 pro Minute, darüber 429 mit `Retry-After`
Größe einer Anfrage	1024 KB
Zeilen pro Bestandsaufruf	500
Varianten pro Produkt	500
Bilder pro Produkt	20
Produkte pro Seite	100
Bestellungen pro Seite	100

Jede Antwort ist JSON und wird nicht zwischengespeichert. Aufrufe aus dem Browser (CORS) sind nicht freigeschaltet.

Produkte

Ein Produkt besteht aus seinen Angaben und seinen Varianten (Farbe × Größe). Es gelten dieselben Regeln wie im Produktformular und im CSV-Import: Was dort abgelehnt wird, lehnt auch die API ab – mit denselben Codes. Die Feldnamen sind die Spaltennamen der CSV-Vorlage.

POST /api/v1/products

{
  "uebergeordnete_sku": "BW-SATIN-01",
  "titel": "Satin-Bettwäsche Uni",
  "beschreibung": "Bettwäsche aus 100 % Baumwollsatin, mit Reißverschluss.",
  "kategorie": "eve-Home > Bettwäsche > Bettwäsche-Sets",
  "rabattpreis": 44.90,
  "varianten": [
    {
      "farbe": "Weiß",
      "groesse": "135 x 200 cm",
      "preis": 49.90,
      "lagerbestand": 12,
      "sku": "BW-SATIN-01-W-135",
      "ean": "4006381333931",
      "bild_urls": ["https://bilder.example-shop.de/bw-satin-weiss.jpg"]
    },
    {
      "farbe": "Weiß",
      "groesse": "155 x 220 cm",
      "preis": "59,90",
      "lagerbestand": 5,
      "sku": "BW-SATIN-01-W-155"
    }
  ]
}

uebergeordnete_sku ist dein Schlüssel für das Produkt, eindeutig in deinem Shop. Damit sprichst du es später an: /products/BW-SATIN-01.
kategorie ist der vollständige Pfad; jede groesse muss zur Kategorie gehören.
preis steht je Variante. Preise dürfen sich nur je Größe unterscheiden, nicht je Farbe; der niedrigste ist der Grundpreis. rabattpreis gilt für das ganze Produkt, ohne ihn gibt es keinen Rabatt.
Zahlen dürfen auch als Text kommen, deutsch oder englisch ("59,90").
sku und ean je Variante sind freiwillig. Fehlt das Feld, bleibt der gespeicherte Code; null löscht ihn. Die EAN braucht eine gültige Prüfziffer.
bild_urls: https-Adressen. Die Bilder werden geladen und bei uns gespeichert; die Galerie darf auch nur an der ersten Variante stehen.
versandkosten ist freiwillig: ohne gilt bei neuen Produkten deine Voreinstellung, bei vorhandenen bleibt der Wert.

Anlegen, ersetzen, lesen

Aufruf	Wirkung
`POST /products`	Legt das Produkt an: 201. Gibt es die Übergeordnete SKU schon: 409 `productExists` mit dem vorhandenen Produkt.
`PUT /products/{id}`	Ersetzt das ganze Produkt; Varianten, die fehlen, werden archiviert. Gibt es `{id}` noch nicht und nennt der Inhalt `{id}` als `uebergeordnete_sku`, wird es angelegt (Upsert); sonst 404.
`GET /products/{id}`	Das Produkt in genau der Form, die PUT erwartet, plus Lesefelder (`id`, `artikelnummer`, `status`, `geaendert_am`, `variant_id`). Du kannst es unverändert zurückschicken.
`GET /products`	Alle deine Produkte, älteste Änderung zuerst, archivierte inklusive – mit `geaendert_seit` nur die seither geänderten.
`DELETE /products/{id}`	Archiviert das Produkt; ein zweiter Aufruf ändert nichts.

{id} darf die eveyamin-Produkt-ID, deine Übergeordnete SKU oder die eveyamin-Artikelnummer sein. Ein Produkt, das du im Formular angelegt hast, bekommt seine Übergeordnete SKU einmal über PUT /products/{artikelnummer} mit uebergeordnete_sku im Inhalt; eine vorhandene änderst du nur im Produktformular.

Ergebnis

ergebnis ist angelegt, aktualisiert oder unveraendert. Hat sich nichts geändert, wird nichts geschrieben und nichts neu übersetzt – ein vollständiger Abgleich aller Produkte kostet daher fast nichts. hinweise nennt korrigierte Schreibweisen und Bilder, die nicht geladen werden konnten. Neue Produkte werden zuerst übersetzt (Status „Wird übersetzt“) und gehen dann online.

Bilder

Bilder werden während des Aufrufs geladen. Dauert das zu lange, antwortet die API mit 202 und einem Auftrag (Location: /api/v1/jobs/{id}). Frag den Auftrag ab, bis er fertig ist; das Produkt wird erst gespeichert, wenn seine Bilder da sind.
Jede Bildadresse wird nur einmal geladen. Für ein geändertes Bild brauchst du eine neue Adresse, z. B. mit ?v=2.
Kommt für dasselbe Produkt eine neuere Anfrage, wird ein offener Auftrag ersetzt.

Bestand im Produktaufruf

Für Varianten, die schon im Verkauf sind, ändert ein Produktaufruf den Bestand nicht – dafür ist der Bestandsaufruf da. Ein abweichender lagerbestand kommt als Hinweis stockIgnored zurück. Neue Produkte und neue Varianten übernehmen den gesendeten Bestand.

Archiviert, gesperrt, Meterware

Archivierte Produkte stellst du im Dashboard wieder her; PUT und POST antworten 409 productArchived. Gesperrte Produkte: 409 productBlocked. Meterware (Stoffe) gibt es in der API noch nicht: 409 productMeterware.

Bestand abgleichen

Der Bestandsaufruf ändert nur Bestände, nie das Produkt. So hält deine Warenwirtschaft den Bestand auf eveyamin aktuell und verkauft nichts doppelt, wenn du auf mehreren Kanälen verkaufst.

PATCH /api/v1/stock

{
  "positionen": [
    { "sku": "BW-SATIN-01-W-135", "lagerbestand": 11, "stand": "2026-10-09T14:05:00+02:00" },
    { "produkt": "BW-SATIN-01", "farbe": "Weiß", "groesse": "155 x 220 cm", "lagerbestand": 0 }
  ]
}

Eine Zeile spricht eine Variante über sku an oder über produkt + farbe + groesse. Bis zu 500 Zeilen pro Aufruf, über alle Produkte.
lagerbestand ist dein Bestand. Gespeichert wird er minus der Stück in offenen eveyamin-Bestellungen, die dein System noch nicht bestätigt hat – die kennt deine Zählung ja noch nicht.
Sende stand mit, den Zeitpunkt deiner Zählung. Eine Zeile mit älterem stand als dem zuletzt übernommenen wird ignoriert (veraltet).
Jede Zeile hat ihr eigenes Ergebnis: ok, unveraendert, veraltet oder fehler. Eine fehlerhafte Zeile hält die anderen nicht auf.
Bei 503 busy wurde nichts gespeichert; wiederhole die Anfrage nach Retry-After Sekunden.

So gehst du vor

Einmal GET /stock seitenweise abrufen und deine Artikel den Varianten zuordnen, am besten über die sku.
Bei jeder Bestandsänderung, oder z. B. alle fünf Minuten, PATCH /stock mit den geänderten Zeilen und stand.
Neue Bestellungen abholen und bestätigen – erst danach zählen sie nicht mehr als offen.

Bestellungen und Dropshipping

Bezahlte Bestellungen mit deinen Positionen holst du ab, bestätigst sie und meldest den Versand. Positionen anderer Händler derselben Bestellung siehst du nicht.

GET /orders/new – bezahlte Bestellungen, die dein System noch nicht bestätigt hat, älteste zuerst. Eine Bestellung bleibt dort, bis du sie bestätigst; geht eine Antwort verloren, kommt sie beim nächsten Abruf wieder.
POST /orders/{id}/acknowledge – dein System hat sie übernommen. Bis zu 100 auf einmal mit POST /orders/acknowledge.
POST /orders/{id}/fulfill mit Versanddienstleister und Sendungsnummer – die Positionen werden „Versendet“, und der Käufer bekommt eine Mail mit dem Link zur Sendungsverfolgung.
GET /orders?geaendert_seit=… – später eingetretene Stornierungen und Erstattungen. Merke dir das letzte geaendert_am und frag mit etwas Überlappung.

POST /api/v1/orders/1042/fulfill

{
  "versanddienstleister": "DHL",
  "sendungsnummer": "00340434161234567890"
}

{id} ist die eveyamin-Bestell-ID oder die Bestellnummer.
Versanddienstleister: DHL, DPD, Hermes, GLS, UPS, Deutsche Post oder Sonstige (dann mit eigenem tracking_url).
Mehrere Pakete: ein Aufruf je Sendungsnummer, mit den positionen des Pakets. Dieselbe Sendungsnummer noch einmal ändert nichts und schickt keine zweite Mail.
Die Lieferadresse enthält Name, Anschrift und Telefon, aber keine E-Mail-Adresse: Mit dem Käufer kommuniziert eveyamin.

Dropshipping: Gib deinem Lieferanten einen eigenen Schlüssel mit nur bestellungen:lesen und bestellungen:versenden. Er sieht dann weder Produkte noch Bestand. Du bleibst für ihn verantwortlich, auch für den Umgang mit den Käuferdaten – siehe AGB und Datenschutzerklärung.

Testumgebung

Zum Entwickeln gibt es eine Testumgebung unter https://staging--eveyamin.netlify.app. Sie hat eigene Daten und eigene Schlüssel (evy_test_…), und von dort geht keine Mail an Käufer.

Registriere dich auf https://staging--eveyamin.netlify.app und schreib uns an info@eveyamin.com – wir richten dein Konto als Testshop ein.
Erstelle dort unter Einstellungen → API-Zugang einen Testschlüssel.
Lege Produkte über die API an und erzeuge Testbestellungen.

Testbestellung

curl -X POST https://staging--eveyamin.netlify.app/api/v1/sandbox/orders \
  -H "Authorization: Bearer evy_test_…"

POST /sandbox/orders legt eine bezahlte Bestellung über eine deiner Varianten an – ohne Inhalt über die erste mit Bestand, oder gezielt mit {"positionen": [{"sku": "…", "menge": 2}]}. Käuferin ist die erfundene Erika Mustermann. Die Bestellung läuft durch alles wie eine echte: /orders/new, Bestätigen, Versand melden. Höchstens 30 pro Stunde. Den gleichen Knopf findest du in der Testumgebung unter API-Zugang; im Live-Shop gibt es den Aufruf nicht.

Die Testumgebung ist kein Archiv: Ihre Daten können jederzeit zurückgesetzt werden.

Fehler

Fehler haben immer dieselbe Form:

{
  "fehler": [
    {
      "code": "colorUnknown",
      "feld": "varianten[1].farbe",
      "nachricht": "Unbekannte Farbe „Weis“. Meintest du „Weiß“?"
    }
  ]
}

Werte code aus: Er ist stabil und englisch. nachricht ist deutsch und kann sich ändern; feld ist der JSON-Pfad des betroffenen Felds oder null.

Status	Bedeutung
200 / 201	Erledigt; 201 bei einem neu angelegten Produkt oder einer Testbestellung
202	Angenommen, die Bilder laden noch (Auftrag)
400	Kein gültiges JSON oder ungültige Parameter
401	Kein, ungültiger oder widerrufener Schlüssel
403	Berechtigung fehlt oder Shop noch nicht freigegeben
404	Nicht gefunden – oder nicht deins
409	Konflikt mit Schlüssel oder Zustand (z. B. Übergeordnete SKU schon vergeben)
422	Inhalt ungültig
429	Zu viele Anfragen
500 / 503	Fehler bei uns oder kurz nicht erreichbar – später wiederholen

Jeder Aufruf

Code	Status	Bedeutung
`invalidJson`	400	Der Inhalt ist kein gültiges JSON.
`invalidQuery`	400	`seite`, `pro_seite` oder `geaendert_seit` ist ungültig.
`keyMissing`	401	Kein Schlüssel im Header `Authorization: Bearer …`.
`keyInvalid`	401	Unbekannter oder widerrufener Schlüssel, oder das Konto ist nicht aktiv.
`keyWrongEnvironment`	401	Ein Testschlüssel im Live-Shop oder umgekehrt.
`scopeMissing`	403	Dem Schlüssel fehlt die Berechtigung für diesen Aufruf.
`registrationNotApproved`	403	Die Shop-Registrierung ist noch nicht freigegeben (Bestellungen: Shop noch nicht live).
`apiNotEnabled`	403	Die API ist für deinen Shop noch nicht freigeschaltet.
`notFound`	404	Unbekannter Pfad.
`bodyTooLarge`	413	Die Anfrage ist zu groß.
`rateLimited`	429	Zu viele Anfragen; warte so viele Sekunden, wie `Retry-After` sagt.
`internal`	500	Unerwarteter Fehler bei uns; später wiederholen.
`unavailable`	503	Der Dienst ist kurz nicht erreichbar; nach `Retry-After` wiederholen.

Produkte

Code	Status	Bedeutung
`productNotFound`	404	Kein solches Produkt von dir.
`jobNotFound`	404	Kein solcher Auftrag von dir.
`productExists`	409	Die Übergeordnete SKU gibt es schon; die Antwort nennt das Produkt. Nimm PUT.
`productArchived`	409	Das Produkt ist archiviert; im Dashboard wiederherstellen.
`productBlocked`	409	Das Produkt ist gesperrt und kann nicht geändert werden.
`productMeterware`	409	Meterware gibt es in der API noch nicht.
`parentSkuDuplicate`	409	Die Übergeordnete SKU ist bei dir schon vergeben.
`imagesFailed`	422	Kein Bild des Produkts ließ sich laden.
`writeFailed`	500	Das Produkt konnte nicht gespeichert werden; später wiederholen.
`tooManyVariants`	422	Mehr Varianten als erlaubt.
`invalidValue`	422	Ein Wert hat die falsche Form.

Bestand

Code	Status	Bedeutung
`invalidBody`	422	Erwartet wird `{ "positionen": [ … ] }` (bzw. die Form des Aufrufs).
`noLines`	422	`positionen` ist leer.
`tooManyLines`	422	Zu viele Zeilen; auf mehrere Anfragen aufteilen.
`busy`	503	Der Bestand wird gerade anderswo geändert; nichts gespeichert, wiederholen.
`invalidLine`	in der Zeile	Die Zeile ist kein Objekt.
`identifierMissing`	in der Zeile	Weder `sku` noch `produkt` + `farbe` + `groesse`.
`stockInvalid`	in der Zeile	`lagerbestand` ist keine erlaubte ganze Zahl.
`standInvalid`	in der Zeile	`stand` ist kein Zeitpunkt nach ISO 8601 mit Zeitzone.
`standInFuture`	in der Zeile	`stand` liegt in der Zukunft.
`variantNotFound`	in der Zeile	Keine aktive Variante dazu.
`keyMismatch`	in der Zeile	Die SKU gehört zu einer anderen Kombination als die übrigen Angaben der Zeile.
`duplicateLine`	in der Zeile	Dieselbe Variante steht schon in einer früheren Zeile.

Bestellungen und Versand

Code	Status	Bedeutung
`orderNotFound`	404	Keine solche bezahlte Bestellung mit Positionen von dir.
`noEntries`	422	`bestellungen` ist leer.
`tooManyEntries`	422	Zu viele Bestellungen in einer Anfrage.
`invalidEntry`	in der Zeile	Weder Bestell-ID noch Bestellnummer.
`orderNotShippable`	409	Nur bezahlte Bestellungen lassen sich versenden.
`nothingToShip`	409	Keine deiner Positionen ist mehr „In Bearbeitung“.
`invalidCarrier`	422	Unbekannter Versanddienstleister.
`invalidTrackingNumber`	422	Sendungsnummer: 4–40 Zeichen aus A–Z, 0–9 und -.
`invalidTrackingUrl`	422	`tracking_url` ist kein https-Link.
`lineNotFound`	422	Keine deiner Positionen dieser Bestellung hat diese ID.
`lineNotShippable`	422	Die Position ist nicht mehr „In Bearbeitung“.
`lineInOtherShipment`	422	Die Position ist schon mit einer anderen Sendungsnummer versendet.

Testumgebung

Code	Status	Bedeutung
`noStock`	422	Keine Variante mit Bestand für die Testbestellung.
`sandboxLimit`	429	Zu viele Testbestellungen in der letzten Stunde.

Hinweise

Code	Status	Bedeutung
`stockIgnored`	Hinweis	Bestand einer Variante im Verkauf nicht übernommen; dafür ist der Bestandsaufruf da.
`valueMapped`	Hinweis	Wert über deine Zuordnung übernommen.

Produktprüfung

Produkte werden wie im CSV-Import geprüft. Diese Codes kommen in fehler (409 bei Schlüsselkonflikten, sonst 422) oder als Hinweis:

Code	Status	Bedeutung
`required`	422	„…“ ist ein Pflichtfeld.
`tooLong`	422	„…“ ist zu lang (höchstens … Zeichen).
`tooShort`	422	„…“ ist zu kurz (mindestens … Zeichen).
`numberInvalid`	422	„…“ ist keine gültige Zahl.
`priceRange`	422	„…“ liegt nicht zwischen … und ….
`stockInvalid`	422	„…“ ist kein gültiger Lagerbestand (ganze Zahl von 0 bis …).
`categoryUnknown`	422	Unbekannte Kategorie „…“.
`categoryIncomplete`	422	Die Kategorie „…“ ist unvollständig – bitte bis zur untersten Ebene angeben.
`categoryNotOffered`	422	Die Kategorie „…“ wird nicht mehr angeboten.
`colorUnknown`	422	Unbekannte Farbe „…“.
`sizeUnknown`	422	Unbekannte Größe „…“.
`sizeNotInCategory`	422	Die Größe „…“ wird in „…“ nicht angeboten.
`duplicateCombination`	422	Die Kombination … steht bereits in ⁦varianten[…]⁩.
`priceVariesByColor`	422	Der Preis für … weicht von ⁦varianten[…]⁩ ab. Preise dürfen sich nur je Größe unterscheiden, nicht je Farbe.
`discountAboveBase`	422	Der Rabattpreis (… €) liegt über dem niedrigsten Preis (… €).
`imageUrlInvalid`	422	„…“ ist keine gültige Bildadresse (https://…).
`tooManyImages`	422	… Bilder – höchstens … pro Produkt.
`noImages`	422	Bitte mindestens eine Bild-URL pro Produkt angeben.
`skuDuplicateInFile`	422	Die SKU „…“ steht bereits in ⁦varianten[…]⁩.
`skuTaken`	409	Die SKU „…“ gehört schon zu einem anderen deiner Produkte.
`eanInvalid`	422	„…“ ist keine gültige EAN (8, 12, 13 oder 14 Ziffern mit gültiger Prüfziffer).
`ambiguousMatch`	409	„…“ passt zu mehr als einem bestehenden Produkt (Artikelnummer …).
`parentSkuLocked`	409	Das Produkt … hat schon die Übergeordnete SKU „…“. Eine vorhandene Übergeordnete SKU änderst du im Produktformular.
`parentSkuOfOther`	409	„…“ gehört schon zu deinem Produkt …, die eveyamin-Artikelnummer aber zu …. Bitte gib eine andere Übergeordnete SKU an.
`categoryFixed`	Hinweis	Kategorie als „…“ übernommen.
`colorFixed`	Hinweis	Farbe „…“ als „…“ übernommen.
`sizeFixed`	Hinweis	Größe „…“ als „…“ übernommen.
`imageFailed`	Hinweis	Bild nicht übernommen (…): …

Referenz

Alle Aufrufe mit Parametern und Feldern, direkt aus der Schnittstelle erzeugt. Für Postman, Insomnia oder Code-Generatoren gibt es die OpenAPI-Datei.

Allgemein

Schlüssel prüfen und die deutschen Werte des Shops abrufen.

GET/api/v1/ping

Schlüssel prüfen

Antwortet mit dem Händler und den Berechtigungen des Schlüssels.

Berechtigung: jeder gültige Schlüssel

Antworten

200 Der Schlüssel gilt. – Ping

Feld	Typ	Pflicht	Beschreibung
`ok`	true	ja
`umgebung`	string	ja	live = Shop, test = Testumgebung.Werte: live, test
`haendler_id`	string	ja	Deine Händler-ID bei eveyamin.
`schluessel`	object	ja
`schluessel.name`	string	ja
`schluessel.praefix`	string	ja	Anfang des Schlüssels, z. B. evy_live_Ab3x.
`schluessel.berechtigungen`	string[]	ja	Werte: produkte:schreiben, bestand:schreiben, bestellungen:lesen, bestellungen:versenden

401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.

GET/api/v1/taxonomy

Kategorien, Größen und Farben

Die Werte, die Produkte und Bestand verwenden – zum Zuordnen der eigenen Werte. Dieselben Listen wie in der Import-Vorlage.

Berechtigung: jeder gültige Schlüssel

Antworten

200 Die aktuellen Listen. – Taxonomie

Feld	Typ	Pflicht	Beschreibung
`kategorien`	object[]	ja	Jede Kategorie, unter der ein Produkt stehen kann.
`kategorien[].pfad`	string	ja	Vollständiger Kategoriepfad, mit „ > “ getrennt, z. B. „eve-Home > Bettwäsche > Bettwäsche-Sets“.
`kategorien[].groessen`	string[]	ja	Größen, die diese Kategorie anbietet.
`farben`	string[]	ja	Alle Farben, z. B. „Weiß“ oder „Ohne Farbe“.

401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.

Produkte

Produkte anlegen, ersetzen, lesen und archivieren (WP2).

POST/api/v1/products

Produkt anlegen

Ein Produkt mit allen Farbe-×-Größe-Kombinationen (varianten, höchstens 500), geprüft nach denselben Regeln wie der Katalog-Import und das Produktformular, mit denselben Fehlercodes. Den Bestand bestehender Kombinationen ändert nur PATCH /products/{id}/stock: ein abweichender lagerbestand bleibt unberücksichtigt (Hinweis stockIgnored); neue Produkte und neue Kombinationen übernehmen ihn. Fehlende Kombinationen werden archiviert. Fehlen sku oder ean bei einer Variante, bleiben die gespeicherten. Bilder werden zu eveyamin geladen; eine schon geladene Adresse wird nicht erneut geladen, ein geändertes Bild braucht also eine neue Adresse. Dauert das Laden zu lange, antwortet der Aufruf mit 202 und einem Auftrag (/jobs/{id}); das Produkt wird geschrieben, sobald die Bilder da sind. Ein unverändertes Produkt wird nicht geschrieben und nicht neu übersetzt (unveraendert). Neue und geänderte Titel und Beschreibungen werden übersetzt, bevor das Produkt sichtbar wird. uebergeordnete_sku ist hier Pflicht; gibt es sie schon: 409 productExists mit dem Produkt.

Berechtigung: produkte:schreiben

Inhalt – ProduktAnfrage

Feld	Typ	Pflicht	Beschreibung
`uebergeordnete_sku`	string \| null	nein	Deine Produktnummer, eindeutig in deinem Shop, max. 100 Zeichen. Pflicht beim Anlegen.
`titel`	string	ja	Max. 100 Zeichen.
`beschreibung`	string	ja	10 bis 10.000 Zeichen.
`kategorie`	string	ja	Vollständiger Pfad, z. B. „eve-Home > Bettwäsche > Bettwäsche-Sets“ (siehe /taxonomy).
`rabattpreis`	number \| string \| null	nein
`versandkosten`	number \| string \| null	nein
`varianten`	ProduktVarianteEingabe[]	ja
`varianten[].farbe`	string	ja	Farbe wie im Shop, z. B. „Weiß“ (siehe /taxonomy).
`varianten[].groesse`	string	ja	Größe aus der Größenliste der Kategorie, z. B. „M“ oder „200 x 200 cm“.
`varianten[].preis`	number \| string	ja	Preis dieser Variante in EUR, brutto. Preise dürfen sich nur je Größe unterscheiden; der niedrigste ist der Grundpreis.
`varianten[].lagerbestand`	number \| string	ja	Bestand, 0 bis 10.000. Gilt nur für neue Produkte und neue Kombinationen; den Bestand bestehender Kombinationen änderst du über /products/{id}/stock.
`varianten[].sku`	string \| null	nein	Deine SKU dieser Kombination, eindeutig in deinem Shop, max. 64 Zeichen.
`varianten[].ean`	string \| null	nein	EAN / GTIN (8, 12, 13 oder 14 Ziffern mit Prüfziffer). Fehlt der Schlüssel, bleibt die gespeicherte EAN; null löscht sie.
`varianten[].bild_urls`	string[]	nein	Öffentliche https-Bildadressen. Ein Bild nur bei Varianten bestimmter Farben gehört zu diesen Farben, eines bei allen Farben gilt für alle; stehen alle Bilder nur bei einer Farbe (z. B. nur bei der ersten Variante), gelten sie für alle. Bekannte Adressen werden nicht neu geladen – ein geändertes Bild braucht eine neue Adresse.

Antworten

201 Angelegt (Location: /api/v1/products/{id}). – ProduktErgebnis

Feld	Typ	Pflicht	Beschreibung
`ergebnis`	string	ja	unveraendert: Das Produkt war schon so; nichts wurde geschrieben oder neu übersetzt.Werte: angelegt, aktualisiert, unveraendert
`produkt`	Produkt	ja
`produkt.id`	string	ja	eveyamin-Produkt-ID.
`produkt.artikelnummer`	string	ja	eveyamin-Artikelnummer.
`produkt.uebergeordnete_sku`	string \| null	ja
`produkt.status`	string	ja	Neue und geänderte Texte werden erst übersetzt; ohne eingerichteten Zahlungsanbieter bleibt das Produkt verborgen.Werte: Aktiv, Wird übersetzt, Wartet auf Zahlungsanbieter, Gesperrt, Archiviert
`produkt.titel`	string	ja
`produkt.beschreibung`	string	ja
`produkt.kategorie`	string	ja
`produkt.rabattpreis`	number \| null	ja
`produkt.versandkosten`	number \| null	ja
`produkt.geaendert_am`	string	ja	Letzte Änderung am Produkt, auch am Bestand. ISO 8601, UTC.
`produkt.varianten`	object[]	ja
`produkt.varianten[].variant_id`	string	ja
`produkt.varianten[].farbe`	string	ja
`produkt.varianten[].groesse`	string	ja
`produkt.varianten[].preis`	number	ja
`produkt.varianten[].lagerbestand`	integer	ja	Gespeicherter, kaufbarer Bestand. (-9007199254740991–9007199254740991)
`produkt.varianten[].sku`	string \| null	ja
`produkt.varianten[].ean`	string \| null	ja
`produkt.varianten[].bild_urls`	string[]	ja	Die Bilder dieser Farbe, bei eveyamin gespeichert.
`hinweise`	object[]	ja	Z. B. korrigierte Schreibweisen, nicht geladene Bilder, ignorierter Bestand.
`hinweise[].code`	string	ja
`hinweise[].feld`	string \| null	ja
`hinweise[].nachricht`	string	ja

202 Die Bilder werden noch geladen (Location: /api/v1/jobs/{id}). – ProduktInArbeit

Feld	Typ	Pflicht	Beschreibung
`ergebnis`	"in_arbeit"	ja
`auftrag`	Auftrag	ja
`auftrag.id`	string	ja
`auftrag.status`	string	ja	ersetzt: Eine neuere Anfrage für dasselbe Produkt kam dazwischen; dieser Auftrag wird nicht mehr geschrieben.Werte: wartet, in_arbeit, fertig, fehlgeschlagen, ersetzt
`auftrag.aktion`	string	ja	Werte: anlegen, aktualisieren
`auftrag.schluessel`	string	ja	Übergeordnete SKU des Produkts, oder seine Artikelnummer, wenn es keine hat.
`auftrag.bilder`	object	ja
`auftrag.bilder.gesamt`	integer	ja	(-9007199254740991–9007199254740991)
`auftrag.bilder.geladen`	integer	ja	(-9007199254740991–9007199254740991)
`auftrag.bilder.fehlgeschlagen`	integer	ja	(-9007199254740991–9007199254740991)
`auftrag.produkt`	object \| null	ja	Sobald das Produkt geschrieben ist.
`auftrag.produkt.id`	string	ja
`auftrag.produkt.artikelnummer`	string	ja
`auftrag.produkt.uebergeordnete_sku`	string \| null	ja
`auftrag.produkt.status`	string	ja	Werte: Aktiv, Wird übersetzt, Wartet auf Zahlungsanbieter, Gesperrt, Archiviert
`auftrag.fehler`	string \| null	ja	Warum der Auftrag fehlgeschlagen ist.
`auftrag.hinweise`	object[]	ja
`auftrag.hinweise[].code`	string	ja
`auftrag.hinweise[].feld`	string \| null	ja
`auftrag.hinweise[].nachricht`	string	ja
`auftrag.erstellt_am`	string	ja	Eingang der Anfrage. ISO 8601, UTC.
`auftrag.abgeschlossen_am`	string \| null	ja
`hinweise`	object[]	ja
`hinweise[].code`	string	ja
`hinweise[].feld`	string \| null	ja
`hinweise[].nachricht`	string	ja

401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
409 Schlüssel- oder Zustandskonflikt: productExists, productArchived, productBlocked, productMeterware, skuTaken, parentSkuLocked, parentSkuOfOther, ambiguousMatch.
422 Ungültige Angaben, mit den Codes des Katalog-Imports (z. B. required, colorUnknown, sizeNotInCategory, priceVariesByColor, noImages, eanInvalid) und dem JSON-Pfad in feld.
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.

GET/api/v1/products

Produkte

Deine Produkte, älteste Änderung zuerst, auch archivierte (status Archiviert), damit dein System Löschungen sieht. Meterware fehlt. Mit geaendert_seit nur seither geänderte – auch Bestandsänderungen zählen.

Berechtigung: produkte:schreiben

Parameter

Feld	Typ	Pflicht	Beschreibung
`seite (query)`	integer	nein	Seite, ab 1.
`pro_seite (query)`	integer	nein	Produkte pro Seite, höchstens 100.
`geaendert_seit (query)`	string (date-time)	nein	Nur Produkte, die danach geändert wurden (ISO 8601 mit Zeitzone).

Antworten

200 Eine Seite Produkte. – ProduktListe

Feld	Typ	Pflicht	Beschreibung
`seite`	integer	ja	(-9007199254740991–9007199254740991)
`pro_seite`	integer	ja	(-9007199254740991–9007199254740991)
`gesamt`	integer	ja	Produkte insgesamt (mit geaendert_seit: seither geänderte). (-9007199254740991–9007199254740991)
`produkte`	Produkt[]	ja
`produkte[].id`	string	ja	eveyamin-Produkt-ID.
`produkte[].artikelnummer`	string	ja	eveyamin-Artikelnummer.
`produkte[].uebergeordnete_sku`	string \| null	ja
`produkte[].status`	string	ja	Neue und geänderte Texte werden erst übersetzt; ohne eingerichteten Zahlungsanbieter bleibt das Produkt verborgen.Werte: Aktiv, Wird übersetzt, Wartet auf Zahlungsanbieter, Gesperrt, Archiviert
`produkte[].titel`	string	ja
`produkte[].beschreibung`	string	ja
`produkte[].kategorie`	string	ja
`produkte[].rabattpreis`	number \| null	ja
`produkte[].versandkosten`	number \| null	ja
`produkte[].geaendert_am`	string	ja	Letzte Änderung am Produkt, auch am Bestand. ISO 8601, UTC.
`produkte[].varianten`	object[]	ja
`produkte[].varianten[].variant_id`	string	ja
`produkte[].varianten[].farbe`	string	ja
`produkte[].varianten[].groesse`	string	ja
`produkte[].varianten[].preis`	number	ja
`produkte[].varianten[].lagerbestand`	integer	ja	Gespeicherter, kaufbarer Bestand. (-9007199254740991–9007199254740991)
`produkte[].varianten[].sku`	string \| null	ja
`produkte[].varianten[].ean`	string \| null	ja
`produkte[].varianten[].bild_urls`	string[]	ja	Die Bilder dieser Farbe, bei eveyamin gespeichert.

400 geaendert_seit, seite oder pro_seite ungültig (invalidQuery).
401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.

GET/api/v1/products/{id}

Ein Produkt

In der Form, die PUT annimmt: den Inhalt kannst du unverändert zurückschicken (dann: unveraendert).

Berechtigung: produkte:schreiben

Parameter

Feld	Typ	Pflicht	Beschreibung
`id (path)`	string	ja	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.

Antworten

200 Das Produkt. – Produkt

Feld	Typ	Pflicht	Beschreibung
`id`	string	ja	eveyamin-Produkt-ID.
`artikelnummer`	string	ja	eveyamin-Artikelnummer.
`uebergeordnete_sku`	string \| null	ja
`status`	string	ja	Neue und geänderte Texte werden erst übersetzt; ohne eingerichteten Zahlungsanbieter bleibt das Produkt verborgen.Werte: Aktiv, Wird übersetzt, Wartet auf Zahlungsanbieter, Gesperrt, Archiviert
`titel`	string	ja
`beschreibung`	string	ja
`kategorie`	string	ja
`rabattpreis`	number \| null	ja
`versandkosten`	number \| null	ja
`geaendert_am`	string	ja	Letzte Änderung am Produkt, auch am Bestand. ISO 8601, UTC.
`varianten`	object[]	ja
`varianten[].variant_id`	string	ja
`varianten[].farbe`	string	ja
`varianten[].groesse`	string	ja
`varianten[].preis`	number	ja
`varianten[].lagerbestand`	integer	ja	Gespeicherter, kaufbarer Bestand. (-9007199254740991–9007199254740991)
`varianten[].sku`	string \| null	ja
`varianten[].ean`	string \| null	ja
`varianten[].bild_urls`	string[]	ja	Die Bilder dieser Farbe, bei eveyamin gespeichert.

401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
404 Kein solches Produkt von dir (productNotFound).
409 Meterware wird über die API noch nicht unterstützt (productMeterware).
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.

PUT/api/v1/products/{id}

Produkt ersetzen

Ein Produkt mit allen Farbe-×-Größe-Kombinationen (varianten, höchstens 500), geprüft nach denselben Regeln wie der Katalog-Import und das Produktformular, mit denselben Fehlercodes. Den Bestand bestehender Kombinationen ändert nur PATCH /products/{id}/stock: ein abweichender lagerbestand bleibt unberücksichtigt (Hinweis stockIgnored); neue Produkte und neue Kombinationen übernehmen ihn. Fehlende Kombinationen werden archiviert. Fehlen sku oder ean bei einer Variante, bleiben die gespeicherten. Bilder werden zu eveyamin geladen; eine schon geladene Adresse wird nicht erneut geladen, ein geändertes Bild braucht also eine neue Adresse. Dauert das Laden zu lange, antwortet der Aufruf mit 202 und einem Auftrag (/jobs/{id}); das Produkt wird geschrieben, sobald die Bilder da sind. Ein unverändertes Produkt wird nicht geschrieben und nicht neu übersetzt (unveraendert). Neue und geänderte Titel und Beschreibungen werden übersetzt, bevor das Produkt sichtbar wird. Gibt es {id} noch nicht und ist es die uebergeordnete_sku des Inhalts, wird das Produkt angelegt. Ein Produkt ohne Übergeordnete SKU bekommt sie über seine Artikelnummer als {id}; eine vorhandene ändert nur das Produktformular.

Berechtigung: produkte:schreiben

Parameter

Feld	Typ	Pflicht	Beschreibung
`id (path)`	string	ja	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.

Inhalt – ProduktAnfrage

Feld	Typ	Pflicht	Beschreibung
`uebergeordnete_sku`	string \| null	nein	Deine Produktnummer, eindeutig in deinem Shop, max. 100 Zeichen. Pflicht beim Anlegen.
`titel`	string	ja	Max. 100 Zeichen.
`beschreibung`	string	ja	10 bis 10.000 Zeichen.
`kategorie`	string	ja	Vollständiger Pfad, z. B. „eve-Home > Bettwäsche > Bettwäsche-Sets“ (siehe /taxonomy).
`rabattpreis`	number \| string \| null	nein
`versandkosten`	number \| string \| null	nein
`varianten`	ProduktVarianteEingabe[]	ja
`varianten[].farbe`	string	ja	Farbe wie im Shop, z. B. „Weiß“ (siehe /taxonomy).
`varianten[].groesse`	string	ja	Größe aus der Größenliste der Kategorie, z. B. „M“ oder „200 x 200 cm“.
`varianten[].preis`	number \| string	ja	Preis dieser Variante in EUR, brutto. Preise dürfen sich nur je Größe unterscheiden; der niedrigste ist der Grundpreis.
`varianten[].lagerbestand`	number \| string	ja	Bestand, 0 bis 10.000. Gilt nur für neue Produkte und neue Kombinationen; den Bestand bestehender Kombinationen änderst du über /products/{id}/stock.
`varianten[].sku`	string \| null	nein	Deine SKU dieser Kombination, eindeutig in deinem Shop, max. 64 Zeichen.
`varianten[].ean`	string \| null	nein	EAN / GTIN (8, 12, 13 oder 14 Ziffern mit Prüfziffer). Fehlt der Schlüssel, bleibt die gespeicherte EAN; null löscht sie.
`varianten[].bild_urls`	string[]	nein	Öffentliche https-Bildadressen. Ein Bild nur bei Varianten bestimmter Farben gehört zu diesen Farben, eines bei allen Farben gilt für alle; stehen alle Bilder nur bei einer Farbe (z. B. nur bei der ersten Variante), gelten sie für alle. Bekannte Adressen werden nicht neu geladen – ein geändertes Bild braucht eine neue Adresse.

Antworten

200 Aktualisiert, oder unveraendert. – ProduktErgebnis

Feld	Typ	Pflicht	Beschreibung
`ergebnis`	string	ja	unveraendert: Das Produkt war schon so; nichts wurde geschrieben oder neu übersetzt.Werte: angelegt, aktualisiert, unveraendert
`produkt`	Produkt	ja
`produkt.id`	string	ja	eveyamin-Produkt-ID.
`produkt.artikelnummer`	string	ja	eveyamin-Artikelnummer.
`produkt.uebergeordnete_sku`	string \| null	ja
`produkt.status`	string	ja	Neue und geänderte Texte werden erst übersetzt; ohne eingerichteten Zahlungsanbieter bleibt das Produkt verborgen.Werte: Aktiv, Wird übersetzt, Wartet auf Zahlungsanbieter, Gesperrt, Archiviert
`produkt.titel`	string	ja
`produkt.beschreibung`	string	ja
`produkt.kategorie`	string	ja
`produkt.rabattpreis`	number \| null	ja
`produkt.versandkosten`	number \| null	ja
`produkt.geaendert_am`	string	ja	Letzte Änderung am Produkt, auch am Bestand. ISO 8601, UTC.
`produkt.varianten`	object[]	ja
`produkt.varianten[].variant_id`	string	ja
`produkt.varianten[].farbe`	string	ja
`produkt.varianten[].groesse`	string	ja
`produkt.varianten[].preis`	number	ja
`produkt.varianten[].lagerbestand`	integer	ja	Gespeicherter, kaufbarer Bestand. (-9007199254740991–9007199254740991)
`produkt.varianten[].sku`	string \| null	ja
`produkt.varianten[].ean`	string \| null	ja
`produkt.varianten[].bild_urls`	string[]	ja	Die Bilder dieser Farbe, bei eveyamin gespeichert.
`hinweise`	object[]	ja	Z. B. korrigierte Schreibweisen, nicht geladene Bilder, ignorierter Bestand.
`hinweise[].code`	string	ja
`hinweise[].feld`	string \| null	ja
`hinweise[].nachricht`	string	ja

201 Angelegt. – ProduktErgebnis

Feld	Typ	Pflicht	Beschreibung
`ergebnis`	string	ja	unveraendert: Das Produkt war schon so; nichts wurde geschrieben oder neu übersetzt.Werte: angelegt, aktualisiert, unveraendert
`produkt`	Produkt	ja
`produkt.id`	string	ja	eveyamin-Produkt-ID.
`produkt.artikelnummer`	string	ja	eveyamin-Artikelnummer.
`produkt.uebergeordnete_sku`	string \| null	ja
`produkt.status`	string	ja	Neue und geänderte Texte werden erst übersetzt; ohne eingerichteten Zahlungsanbieter bleibt das Produkt verborgen.Werte: Aktiv, Wird übersetzt, Wartet auf Zahlungsanbieter, Gesperrt, Archiviert
`produkt.titel`	string	ja
`produkt.beschreibung`	string	ja
`produkt.kategorie`	string	ja
`produkt.rabattpreis`	number \| null	ja
`produkt.versandkosten`	number \| null	ja
`produkt.geaendert_am`	string	ja	Letzte Änderung am Produkt, auch am Bestand. ISO 8601, UTC.
`produkt.varianten`	object[]	ja
`produkt.varianten[].variant_id`	string	ja
`produkt.varianten[].farbe`	string	ja
`produkt.varianten[].groesse`	string	ja
`produkt.varianten[].preis`	number	ja
`produkt.varianten[].lagerbestand`	integer	ja	Gespeicherter, kaufbarer Bestand. (-9007199254740991–9007199254740991)
`produkt.varianten[].sku`	string \| null	ja
`produkt.varianten[].ean`	string \| null	ja
`produkt.varianten[].bild_urls`	string[]	ja	Die Bilder dieser Farbe, bei eveyamin gespeichert.
`hinweise`	object[]	ja	Z. B. korrigierte Schreibweisen, nicht geladene Bilder, ignorierter Bestand.
`hinweise[].code`	string	ja
`hinweise[].feld`	string \| null	ja
`hinweise[].nachricht`	string	ja

202 Die Bilder werden noch geladen (Location: /api/v1/jobs/{id}). – ProduktInArbeit

Feld	Typ	Pflicht	Beschreibung
`ergebnis`	"in_arbeit"	ja
`auftrag`	Auftrag	ja
`auftrag.id`	string	ja
`auftrag.status`	string	ja	ersetzt: Eine neuere Anfrage für dasselbe Produkt kam dazwischen; dieser Auftrag wird nicht mehr geschrieben.Werte: wartet, in_arbeit, fertig, fehlgeschlagen, ersetzt
`auftrag.aktion`	string	ja	Werte: anlegen, aktualisieren
`auftrag.schluessel`	string	ja	Übergeordnete SKU des Produkts, oder seine Artikelnummer, wenn es keine hat.
`auftrag.bilder`	object	ja
`auftrag.bilder.gesamt`	integer	ja	(-9007199254740991–9007199254740991)
`auftrag.bilder.geladen`	integer	ja	(-9007199254740991–9007199254740991)
`auftrag.bilder.fehlgeschlagen`	integer	ja	(-9007199254740991–9007199254740991)
`auftrag.produkt`	object \| null	ja	Sobald das Produkt geschrieben ist.
`auftrag.produkt.id`	string	ja
`auftrag.produkt.artikelnummer`	string	ja
`auftrag.produkt.uebergeordnete_sku`	string \| null	ja
`auftrag.produkt.status`	string	ja	Werte: Aktiv, Wird übersetzt, Wartet auf Zahlungsanbieter, Gesperrt, Archiviert
`auftrag.fehler`	string \| null	ja	Warum der Auftrag fehlgeschlagen ist.
`auftrag.hinweise`	object[]	ja
`auftrag.hinweise[].code`	string	ja
`auftrag.hinweise[].feld`	string \| null	ja
`auftrag.hinweise[].nachricht`	string	ja
`auftrag.erstellt_am`	string	ja	Eingang der Anfrage. ISO 8601, UTC.
`auftrag.abgeschlossen_am`	string \| null	ja
`hinweise`	object[]	ja
`hinweise[].code`	string	ja
`hinweise[].feld`	string \| null	ja
`hinweise[].nachricht`	string	ja

401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
404 Kein solches Produkt von dir, und der Inhalt nennt {id} nicht als uebergeordnete_sku (productNotFound).
409 Schlüssel- oder Zustandskonflikt: productExists, productArchived, productBlocked, productMeterware, skuTaken, parentSkuLocked, parentSkuOfOther, ambiguousMatch.
422 Ungültige Angaben, mit den Codes des Katalog-Imports (z. B. required, colorUnknown, sizeNotInCategory, priceVariesByColor, noImages, eanInvalid) und dem JSON-Pfad in feld.
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.

DELETE/api/v1/products/{id}

Produkt archivieren

Archiviert das Produkt; es wird nicht gelöscht und kann im Dashboard wiederhergestellt werden. Wiederholbar (bereits_archiviert).

Berechtigung: produkte:schreiben

Parameter

Feld	Typ	Pflicht	Beschreibung
`id (path)`	string	ja	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.

Antworten

200 Archiviert. – ProduktArchiviert

Feld	Typ	Pflicht	Beschreibung
`ergebnis`	string	ja	Werte: archiviert, bereits_archiviert
`produkt`	object	ja
`produkt.id`	string	ja
`produkt.artikelnummer`	string	ja
`produkt.uebergeordnete_sku`	string \| null	ja
`produkt.status`	string	ja	Werte: Aktiv, Wird übersetzt, Wartet auf Zahlungsanbieter, Gesperrt, Archiviert

401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
404 Kein solches Produkt von dir (productNotFound).
409 Das Produkt ist gesperrt (productBlocked).
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.

GET/api/v1/jobs/{id}

Auftrag

Stand eines Produktaufrufs, der mit 202 geantwortet hat: wartet, in_arbeit, fertig (mit dem Produkt), fehlgeschlagen (mit dem Grund) oder ersetzt (eine neuere Anfrage für dasselbe Produkt kam dazwischen).

Berechtigung: produkte:schreiben

Parameter

Feld	Typ	Pflicht	Beschreibung
`id (path)`	string	ja	Auftrags-ID aus der 202-Antwort.

Antworten

200 Der Auftrag. – Auftrag

Feld	Typ	Pflicht	Beschreibung
`id`	string	ja
`status`	string	ja	ersetzt: Eine neuere Anfrage für dasselbe Produkt kam dazwischen; dieser Auftrag wird nicht mehr geschrieben.Werte: wartet, in_arbeit, fertig, fehlgeschlagen, ersetzt
`aktion`	string	ja	Werte: anlegen, aktualisieren
`schluessel`	string	ja	Übergeordnete SKU des Produkts, oder seine Artikelnummer, wenn es keine hat.
`bilder`	object	ja
`bilder.gesamt`	integer	ja	(-9007199254740991–9007199254740991)
`bilder.geladen`	integer	ja	(-9007199254740991–9007199254740991)
`bilder.fehlgeschlagen`	integer	ja	(-9007199254740991–9007199254740991)
`produkt`	object \| null	ja	Sobald das Produkt geschrieben ist.
`produkt.id`	string	ja
`produkt.artikelnummer`	string	ja
`produkt.uebergeordnete_sku`	string \| null	ja
`produkt.status`	string	ja	Werte: Aktiv, Wird übersetzt, Wartet auf Zahlungsanbieter, Gesperrt, Archiviert
`fehler`	string \| null	ja	Warum der Auftrag fehlgeschlagen ist.
`hinweise`	object[]	ja
`hinweise[].code`	string	ja
`hinweise[].feld`	string \| null	ja
`hinweise[].nachricht`	string	ja
`erstellt_am`	string	ja	Eingang der Anfrage. ISO 8601, UTC.
`abgeschlossen_am`	string \| null	ja

401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
404 Kein solcher Auftrag von dir (jobNotFound).
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.

Bestand

Bestand lesen und setzen, ohne das Produkt anzufassen (WP3).

GET/api/v1/stock

Bestand aller Varianten

Jede aktive Variante mit Artikelnummer, Übergeordneter SKU, SKU, Farbe, Größe, gespeichertem Bestand und offenen Stück – zum Zuordnen deiner Artikel und zum Abgleich. Meterware fehlt (noch nicht in der API).

Berechtigung: bestand:schreiben

Parameter

Feld	Typ	Pflicht	Beschreibung
`seite (query)`	integer	nein	Seite, ab 1.
`pro_seite (query)`	integer	nein	Varianten pro Seite, höchstens 500.

Antworten

200 Eine Seite Varianten. – BestandListe

Feld	Typ	Pflicht	Beschreibung
`seite`	integer	ja	(-9007199254740991–9007199254740991)
`pro_seite`	integer	ja	(-9007199254740991–9007199254740991)
`gesamt`	integer	ja	Varianten insgesamt. (-9007199254740991–9007199254740991)
`positionen`	object[]	ja
`positionen[].produkt_id`	string	ja
`positionen[].artikelnummer`	string	ja
`positionen[].uebergeordnete_sku`	string \| null	ja
`positionen[].sku`	string \| null	ja
`positionen[].ean`	string \| null	ja	EAN / GTIN der Variante, sonst null.
`positionen[].farbe`	string	ja
`positionen[].groesse`	string	ja
`positionen[].titel`	string	ja
`positionen[].lagerbestand`	integer	ja	Gespeicherter, kaufbarer Bestand. (-9007199254740991–9007199254740991)
`positionen[].offen`	integer	ja	Stück in offenen eveyamin-Bestellungen. (-9007199254740991–9007199254740991)
`positionen[].stand`	string \| null	ja	Zuletzt übernommener stand.
`positionen[].gesperrt`	boolean	ja	Das Produkt ist gesperrt; sein Bestand kann nicht geändert werden.

400 seite oder pro_seite ungültig (invalidQuery).
401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.

PATCH/api/v1/stock

Bestand mehrerer Produkte setzen

Bis zu 500 Zeilen über alle Produkte, je über sku oder produkt + farbe + groesse. Gespeichert wird lagerbestand minus der Stück in offenen eveyamin-Bestellungen (reserviert, noch nicht erledigt und von deinem System noch nicht bestätigt), mindestens 0 – so werden Bestellungen, die dein System noch nicht kennt, nicht doppelt verkauft. Eine Bestellung, die du nach dem stand der Zeile bestätigt hast, zählt noch als offen: deine Zählung war älter. Sende daher stand mit. Jede Zeile hat ihr eigenes Ergebnis; eine fehlerhafte Zeile hält die anderen nicht auf. Unveränderte Werte werden nicht geschrieben.

Berechtigung: bestand:schreiben

Inhalt – BestandAnfrage

Feld	Typ	Pflicht	Beschreibung
`positionen`	BestandZeile[]	ja
`positionen[].sku`	string	nein	Deine SKU der Variante. Alternativ: produkt + farbe + groesse.
`positionen[].farbe`	string	nein	Farbe wie im Shop, z. B. „Weiß“.
`positionen[].groesse`	string	nein	Größe wie im Shop, z. B. „M“ oder „200 x 200 cm“.
`positionen[].lagerbestand`	integer	ja	Dein Bestand der Variante. Gespeichert wird dieser Wert abzüglich der offenen eveyamin-Bestellungen (siehe offen). (0–10000)
`positionen[].stand`	string (date-time)	nein	Zeitpunkt deiner Zählung (ISO 8601 mit Zeitzone). Eine Zeile mit älterem stand als dem zuletzt übernommenen wird ignoriert (veraltet).
`positionen[].produkt`	string	nein	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.

Antworten

200 Ergebnis je Zeile. – BestandErgebnis

Feld	Typ	Pflicht	Beschreibung
`zusammenfassung`	object	ja
`zusammenfassung.ok`	integer	ja	(-9007199254740991–9007199254740991)
`zusammenfassung.unveraendert`	integer	ja	(-9007199254740991–9007199254740991)
`zusammenfassung.veraltet`	integer	ja	(-9007199254740991–9007199254740991)
`zusammenfassung.fehler`	integer	ja	(-9007199254740991–9007199254740991)
`positionen`	object[]	ja
`positionen[].zeile`	integer	ja	Index der Zeile in positionen, ab 0. (-9007199254740991–9007199254740991)
`positionen[].status`	string	ja	ok = gespeichert, unveraendert = war schon so, veraltet = älterer stand, fehler = siehe fehler.Werte: ok, unveraendert, veraltet, fehler
`positionen[].produkt_id`	string	nein
`positionen[].artikelnummer`	string	nein
`positionen[].uebergeordnete_sku`	string \| null	nein
`positionen[].sku`	string \| null	nein
`positionen[].ean`	string \| null	nein	EAN / GTIN der Variante, sonst null.
`positionen[].farbe`	string	nein
`positionen[].groesse`	string	nein
`positionen[].gesendet`	integer	nein	Dein lagerbestand. (-9007199254740991–9007199254740991)
`positionen[].offen`	integer	nein	Stück in offenen eveyamin-Bestellungen, die abgezogen wurden. (-9007199254740991–9007199254740991)
`positionen[].vorher`	integer	nein	Gespeicherter Bestand vor dieser Anfrage. (-9007199254740991–9007199254740991)
`positionen[].lagerbestand`	integer	nein	Gespeicherter Bestand jetzt: gesendet − offen, mindestens 0. (-9007199254740991–9007199254740991)
`positionen[].fehler`	object	nein
`positionen[].fehler.code`	string	ja
`positionen[].fehler.feld`	string \| null	ja
`positionen[].fehler.nachricht`	string	ja
`positionen[].hinweise`	object[]	nein	Z. B. eine korrigierte Schreibweise.
`positionen[].hinweise[].code`	string	ja
`positionen[].hinweise[].feld`	string \| null	ja
`positionen[].hinweise[].nachricht`	string	ja

401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
422 Kein { positionen: [...] }, leer, oder mehr als 500 Zeilen.
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.
503 Der Bestand wird gerade an anderer Stelle geändert (busy); nichts wurde gespeichert, bitte wiederholen.

GET/api/v1/products/{id}/stock

Bestand eines Produkts

Berechtigung: bestand:schreiben

Parameter

Feld	Typ	Pflicht	Beschreibung
`id (path)`	string	ja	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.
`seite (query)`	integer	nein	Seite, ab 1.
`pro_seite (query)`	integer	nein	Varianten pro Seite, höchstens 500.

Antworten

200 Die Varianten des Produkts. – BestandListe

Feld	Typ	Pflicht	Beschreibung
`seite`	integer	ja	(-9007199254740991–9007199254740991)
`pro_seite`	integer	ja	(-9007199254740991–9007199254740991)
`gesamt`	integer	ja	Varianten insgesamt. (-9007199254740991–9007199254740991)
`positionen`	object[]	ja
`positionen[].produkt_id`	string	ja
`positionen[].artikelnummer`	string	ja
`positionen[].uebergeordnete_sku`	string \| null	ja
`positionen[].sku`	string \| null	ja
`positionen[].ean`	string \| null	ja	EAN / GTIN der Variante, sonst null.
`positionen[].farbe`	string	ja
`positionen[].groesse`	string	ja
`positionen[].titel`	string	ja
`positionen[].lagerbestand`	integer	ja	Gespeicherter, kaufbarer Bestand. (-9007199254740991–9007199254740991)
`positionen[].offen`	integer	ja	Stück in offenen eveyamin-Bestellungen. (-9007199254740991–9007199254740991)
`positionen[].stand`	string \| null	ja	Zuletzt übernommener stand.
`positionen[].gesperrt`	boolean	ja	Das Produkt ist gesperrt; sein Bestand kann nicht geändert werden.

401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
404 Kein solches Produkt bei dir (productNotFound).
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.

PATCH/api/v1/products/{id}/stock

Bestand eines Produkts setzen

Zeilen dieses Produkts, je über sku oder farbe + groesse. Gespeichert wird lagerbestand minus der Stück in offenen eveyamin-Bestellungen (reserviert, noch nicht erledigt und von deinem System noch nicht bestätigt), mindestens 0 – so werden Bestellungen, die dein System noch nicht kennt, nicht doppelt verkauft. Eine Bestellung, die du nach dem stand der Zeile bestätigt hast, zählt noch als offen: deine Zählung war älter. Sende daher stand mit. Jede Zeile hat ihr eigenes Ergebnis; eine fehlerhafte Zeile hält die anderen nicht auf. Unveränderte Werte werden nicht geschrieben.

Berechtigung: bestand:schreiben

Parameter

Feld	Typ	Pflicht	Beschreibung
`id (path)`	string	ja	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.

Inhalt – ProduktBestandAnfrage

Feld	Typ	Pflicht	Beschreibung
`positionen`	object[]	ja
`positionen[].sku`	string	nein	Deine SKU der Variante. Alternativ: produkt + farbe + groesse.
`positionen[].farbe`	string	nein	Farbe wie im Shop, z. B. „Weiß“.
`positionen[].groesse`	string	nein	Größe wie im Shop, z. B. „M“ oder „200 x 200 cm“.
`positionen[].lagerbestand`	integer	ja	Dein Bestand der Variante. Gespeichert wird dieser Wert abzüglich der offenen eveyamin-Bestellungen (siehe offen). (0–10000)
`positionen[].stand`	string (date-time)	nein	Zeitpunkt deiner Zählung (ISO 8601 mit Zeitzone). Eine Zeile mit älterem stand als dem zuletzt übernommenen wird ignoriert (veraltet).

Antworten

200 Ergebnis je Zeile. – BestandErgebnis

Feld	Typ	Pflicht	Beschreibung
`zusammenfassung`	object	ja
`zusammenfassung.ok`	integer	ja	(-9007199254740991–9007199254740991)
`zusammenfassung.unveraendert`	integer	ja	(-9007199254740991–9007199254740991)
`zusammenfassung.veraltet`	integer	ja	(-9007199254740991–9007199254740991)
`zusammenfassung.fehler`	integer	ja	(-9007199254740991–9007199254740991)
`positionen`	object[]	ja
`positionen[].zeile`	integer	ja	Index der Zeile in positionen, ab 0. (-9007199254740991–9007199254740991)
`positionen[].status`	string	ja	ok = gespeichert, unveraendert = war schon so, veraltet = älterer stand, fehler = siehe fehler.Werte: ok, unveraendert, veraltet, fehler
`positionen[].produkt_id`	string	nein
`positionen[].artikelnummer`	string	nein
`positionen[].uebergeordnete_sku`	string \| null	nein
`positionen[].sku`	string \| null	nein
`positionen[].ean`	string \| null	nein	EAN / GTIN der Variante, sonst null.
`positionen[].farbe`	string	nein
`positionen[].groesse`	string	nein
`positionen[].gesendet`	integer	nein	Dein lagerbestand. (-9007199254740991–9007199254740991)
`positionen[].offen`	integer	nein	Stück in offenen eveyamin-Bestellungen, die abgezogen wurden. (-9007199254740991–9007199254740991)
`positionen[].vorher`	integer	nein	Gespeicherter Bestand vor dieser Anfrage. (-9007199254740991–9007199254740991)
`positionen[].lagerbestand`	integer	nein	Gespeicherter Bestand jetzt: gesendet − offen, mindestens 0. (-9007199254740991–9007199254740991)
`positionen[].fehler`	object	nein
`positionen[].fehler.code`	string	ja
`positionen[].fehler.feld`	string \| null	ja
`positionen[].fehler.nachricht`	string	ja
`positionen[].hinweise`	object[]	nein	Z. B. eine korrigierte Schreibweise.
`positionen[].hinweise[].code`	string	ja
`positionen[].hinweise[].feld`	string \| null	ja
`positionen[].hinweise[].nachricht`	string	ja

401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
404 Kein solches Produkt bei dir (productNotFound).
422 Kein { positionen: [...] }, leer, oder mehr als 500 Zeilen.
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.
503 Der Bestand wird gerade an anderer Stelle geändert (busy); nichts wurde gespeichert, bitte wiederholen.

Bestellungen

Bezahlte Bestellungen abrufen und bestätigen (WP4).

GET/api/v1/orders/new

Neue Bestellungen

Bezahlte Bestellungen mit Positionen in Bearbeitung, die dein System noch nicht bestätigt hat, älteste zuerst. Nur deine Positionen und nur bezahlte Bestellungen. Eine Bestellung bleibt in /orders/new, bis dein System sie mit /orders/{id}/acknowledge bestätigt – geht eine Antwort verloren, kommt sie beim nächsten Abruf wieder. Gleiche Bestellungen erkennst du an der bestellnummer.

Berechtigung: bestellungen:lesen

Parameter

Feld	Typ	Pflicht	Beschreibung
`seite (query)`	integer	nein	Seite, ab 1.
`pro_seite (query)`	integer	nein	Bestellungen pro Seite, höchstens 100.

Antworten

200 Eine Seite Bestellungen. – BestellListe

Feld	Typ	Pflicht	Beschreibung
`seite`	integer	ja	(-9007199254740991–9007199254740991)
`pro_seite`	integer	ja	(-9007199254740991–9007199254740991)
`gesamt`	integer	ja	Bestellungen insgesamt. (-9007199254740991–9007199254740991)
`bestellungen`	Bestellung[]	ja
`bestellungen[].id`	string	ja	eveyamin-Bestell-ID; in Pfaden geht auch die Bestellnummer.
`bestellungen[].bestellnummer`	integer	ja	(-9007199254740991–9007199254740991)
`bestellungen[].bestelldatum`	string	ja	Wann der Käufer bestellt hat. ISO 8601, UTC.
`bestellungen[].status`	string	ja	Werte: Bezahlt, Versendet, Abgeschlossen, Storniert, Erstattet, Rückbuchung
`bestellungen[].versandart`	string	ja	Werte: Standardversand, Expressversand
`bestellungen[].bestaetigt_am`	string \| null	ja
`bestellungen[].geaendert_am`	string	ja	Letzte Änderung eines Status deiner Positionen oder der Bestellung. ISO 8601, UTC.
`bestellungen[].lieferadresse`	Lieferadresse	ja	Wohin das Paket geht. Die E-Mail-Adresse des Käufers wird nicht weitergegeben.
`bestellungen[].lieferadresse.vorname`	string	ja
`bestellungen[].lieferadresse.nachname`	string	ja
`bestellungen[].lieferadresse.firma`	string \| null	ja
`bestellungen[].lieferadresse.strasse`	string	ja	Straße und Hausnummer.
`bestellungen[].lieferadresse.plz`	string	ja
`bestellungen[].lieferadresse.ort`	string	ja
`bestellungen[].lieferadresse.land`	string	ja	Wie vom Käufer eingegeben, z. B. „Deutschland“ (noch kein Ländercode).
`bestellungen[].lieferadresse.telefon`	string \| null	ja	Für den Versanddienstleister; optional beim Kauf.
`bestellungen[].summen`	object	ja	Nur deine Positionen, in EUR, brutto.
`bestellungen[].summen.waren`	number	ja
`bestellungen[].summen.versandkosten`	number	ja
`bestellungen[].summen.gesamt`	number	ja
`bestellungen[].positionen`	BestellPosition[]	ja	Nur deine Positionen; andere Händler derselben Bestellung fehlen.
`bestellungen[].positionen[].position_id`	string	ja	eveyamin-ID der Bestellposition.
`bestellungen[].positionen[].produkt_id`	string	ja
`bestellungen[].positionen[].variant_id`	string \| null	ja
`bestellungen[].positionen[].artikelnummer`	string \| null	ja
`bestellungen[].positionen[].uebergeordnete_sku`	string \| null	ja	Aktuelle Übergeordnete SKU des Produkts.
`bestellungen[].positionen[].sku`	string \| null	ja	Aktuelle SKU der Variante, sonst die beim Kauf gespeicherte.
`bestellungen[].positionen[].ean`	string \| null	ja	Aktuelle EAN / GTIN der Variante, sonst null.
`bestellungen[].positionen[].titel`	string	ja	Produkttitel zum Zeitpunkt des Kaufs.
`bestellungen[].positionen[].farbe`	string \| null	ja
`bestellungen[].positionen[].groesse`	string \| null	ja	Größe wie im Shop, oder „Maßanfertigung“.
`bestellungen[].positionen[].menge`	number	ja	Stückzahl, bei Meterware Meter.
`bestellungen[].positionen[].einheit`	string	ja	Werte: Stück, Meter
`bestellungen[].positionen[].einzelpreis`	number	ja	Bezahlter Preis je Stück bzw. Meter in EUR, brutto.
`bestellungen[].positionen[].summe`	number	ja	Bezahlter Warenwert der Position in EUR, brutto, ohne Versand.
`bestellungen[].positionen[].versandkosten`	number	ja	Versandkosten in EUR, brutto. Sie stehen bei einer Position je Bestellung.
`bestellungen[].positionen[].lieferstatus`	string	ja	Werte: In Bearbeitung, Versendet, Abgeschlossen, Storniert, Zahlung ausstehend, Erstattet, Fehlgeschlagen
`bestellungen[].positionen[].bestaetigt_am`	string \| null	ja
`bestellungen[].positionen[].sendung_id`	string \| null	ja	Das Paket, in dem die Position versendet wurde (sendungen[].id), sonst null.
`bestellungen[].positionen[].versendet_am`	string \| null	ja
`bestellungen[].positionen[].massanfertigung`	Massanfertigung \| null	ja	Die Körpermaße bei einer Maßanfertigung, sonst null.
`bestellungen[].positionen[].massanfertigung.einheit`	string	ja	So, wie der Käufer gemessen hat; nicht umgerechnet.Werte: cm, Zoll
`bestellungen[].positionen[].massanfertigung.brustumfang`	number	ja
`bestellungen[].positionen[].massanfertigung.taillenumfang`	number	ja
`bestellungen[].positionen[].massanfertigung.hueftumfang`	number	ja
`bestellungen[].positionen[].massanfertigung.koerpergroesse`	number	ja	Barfuß.
`bestellungen[].positionen[].massanfertigung.schluesselbein_boden`	number	ja	Vom Schlüsselbein bis zum Boden.
`bestellungen[].positionen[].massanfertigung.schulterlaenge`	number	ja
`bestellungen[].positionen[].massanfertigung.extralaenge`	number \| null	ja
`bestellungen[].sendungen`	Sendung[]	ja	Deine Pakete dieser Bestellung, ältestes zuerst.
`bestellungen[].sendungen[].id`	string	ja
`bestellungen[].sendungen[].versanddienstleister`	string	ja	Werte: DHL, DPD, Hermes, GLS, UPS, Deutsche Post, Sonstige
`bestellungen[].sendungen[].sendungsnummer`	string	ja	Ohne Leerzeichen, in Großbuchstaben.
`bestellungen[].sendungen[].tracking_url`	string \| null	ja	Link zur Sendungsverfolgung; null bei „Sonstige“ ohne eigenen Link.
`bestellungen[].sendungen[].versendet_am`	string	ja	Wann das Paket gemeldet wurde. ISO 8601, UTC.
`bestellungen[].sendungen[].positionen`	string[]	ja	position_id der Positionen in diesem Paket.

400 seite oder pro_seite ungültig (invalidQuery).
401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.

GET/api/v1/orders

Geänderte Bestellungen

Deine Bestellungen, deren Status oder Lieferstatus sich nach geaendert_seit geändert hat (ohne Parameter alle), älteste Änderung zuerst – so erfährt dein System nach dem Import von Stornierungen und Erstattungen. Merke dir das letzte geaendert_am und frage mit etwas Überlappung erneut. Nur deine Positionen und nur bezahlte Bestellungen. Eine Bestellung bleibt in /orders/new, bis dein System sie mit /orders/{id}/acknowledge bestätigt – geht eine Antwort verloren, kommt sie beim nächsten Abruf wieder. Gleiche Bestellungen erkennst du an der bestellnummer.

Berechtigung: bestellungen:lesen

Parameter

Feld	Typ	Pflicht	Beschreibung
`geaendert_seit (query)`	string (date-time)	nein	Zeitpunkt nach ISO 8601 mit Zeitzone, z. B. 2026-10-07T09:15:00Z.
`seite (query)`	integer	nein	Seite, ab 1.
`pro_seite (query)`	integer	nein	Bestellungen pro Seite, höchstens 100.

Antworten

200 Eine Seite Bestellungen. – BestellListe

Feld	Typ	Pflicht	Beschreibung
`seite`	integer	ja	(-9007199254740991–9007199254740991)
`pro_seite`	integer	ja	(-9007199254740991–9007199254740991)
`gesamt`	integer	ja	Bestellungen insgesamt. (-9007199254740991–9007199254740991)
`bestellungen`	Bestellung[]	ja
`bestellungen[].id`	string	ja	eveyamin-Bestell-ID; in Pfaden geht auch die Bestellnummer.
`bestellungen[].bestellnummer`	integer	ja	(-9007199254740991–9007199254740991)
`bestellungen[].bestelldatum`	string	ja	Wann der Käufer bestellt hat. ISO 8601, UTC.
`bestellungen[].status`	string	ja	Werte: Bezahlt, Versendet, Abgeschlossen, Storniert, Erstattet, Rückbuchung
`bestellungen[].versandart`	string	ja	Werte: Standardversand, Expressversand
`bestellungen[].bestaetigt_am`	string \| null	ja
`bestellungen[].geaendert_am`	string	ja	Letzte Änderung eines Status deiner Positionen oder der Bestellung. ISO 8601, UTC.
`bestellungen[].lieferadresse`	Lieferadresse	ja	Wohin das Paket geht. Die E-Mail-Adresse des Käufers wird nicht weitergegeben.
`bestellungen[].lieferadresse.vorname`	string	ja
`bestellungen[].lieferadresse.nachname`	string	ja
`bestellungen[].lieferadresse.firma`	string \| null	ja
`bestellungen[].lieferadresse.strasse`	string	ja	Straße und Hausnummer.
`bestellungen[].lieferadresse.plz`	string	ja
`bestellungen[].lieferadresse.ort`	string	ja
`bestellungen[].lieferadresse.land`	string	ja	Wie vom Käufer eingegeben, z. B. „Deutschland“ (noch kein Ländercode).
`bestellungen[].lieferadresse.telefon`	string \| null	ja	Für den Versanddienstleister; optional beim Kauf.
`bestellungen[].summen`	object	ja	Nur deine Positionen, in EUR, brutto.
`bestellungen[].summen.waren`	number	ja
`bestellungen[].summen.versandkosten`	number	ja
`bestellungen[].summen.gesamt`	number	ja
`bestellungen[].positionen`	BestellPosition[]	ja	Nur deine Positionen; andere Händler derselben Bestellung fehlen.
`bestellungen[].positionen[].position_id`	string	ja	eveyamin-ID der Bestellposition.
`bestellungen[].positionen[].produkt_id`	string	ja
`bestellungen[].positionen[].variant_id`	string \| null	ja
`bestellungen[].positionen[].artikelnummer`	string \| null	ja
`bestellungen[].positionen[].uebergeordnete_sku`	string \| null	ja	Aktuelle Übergeordnete SKU des Produkts.
`bestellungen[].positionen[].sku`	string \| null	ja	Aktuelle SKU der Variante, sonst die beim Kauf gespeicherte.
`bestellungen[].positionen[].ean`	string \| null	ja	Aktuelle EAN / GTIN der Variante, sonst null.
`bestellungen[].positionen[].titel`	string	ja	Produkttitel zum Zeitpunkt des Kaufs.
`bestellungen[].positionen[].farbe`	string \| null	ja
`bestellungen[].positionen[].groesse`	string \| null	ja	Größe wie im Shop, oder „Maßanfertigung“.
`bestellungen[].positionen[].menge`	number	ja	Stückzahl, bei Meterware Meter.
`bestellungen[].positionen[].einheit`	string	ja	Werte: Stück, Meter
`bestellungen[].positionen[].einzelpreis`	number	ja	Bezahlter Preis je Stück bzw. Meter in EUR, brutto.
`bestellungen[].positionen[].summe`	number	ja	Bezahlter Warenwert der Position in EUR, brutto, ohne Versand.
`bestellungen[].positionen[].versandkosten`	number	ja	Versandkosten in EUR, brutto. Sie stehen bei einer Position je Bestellung.
`bestellungen[].positionen[].lieferstatus`	string	ja	Werte: In Bearbeitung, Versendet, Abgeschlossen, Storniert, Zahlung ausstehend, Erstattet, Fehlgeschlagen
`bestellungen[].positionen[].bestaetigt_am`	string \| null	ja
`bestellungen[].positionen[].sendung_id`	string \| null	ja	Das Paket, in dem die Position versendet wurde (sendungen[].id), sonst null.
`bestellungen[].positionen[].versendet_am`	string \| null	ja
`bestellungen[].positionen[].massanfertigung`	Massanfertigung \| null	ja	Die Körpermaße bei einer Maßanfertigung, sonst null.
`bestellungen[].positionen[].massanfertigung.einheit`	string	ja	So, wie der Käufer gemessen hat; nicht umgerechnet.Werte: cm, Zoll
`bestellungen[].positionen[].massanfertigung.brustumfang`	number	ja
`bestellungen[].positionen[].massanfertigung.taillenumfang`	number	ja
`bestellungen[].positionen[].massanfertigung.hueftumfang`	number	ja
`bestellungen[].positionen[].massanfertigung.koerpergroesse`	number	ja	Barfuß.
`bestellungen[].positionen[].massanfertigung.schluesselbein_boden`	number	ja	Vom Schlüsselbein bis zum Boden.
`bestellungen[].positionen[].massanfertigung.schulterlaenge`	number	ja
`bestellungen[].positionen[].massanfertigung.extralaenge`	number \| null	ja
`bestellungen[].sendungen`	Sendung[]	ja	Deine Pakete dieser Bestellung, ältestes zuerst.
`bestellungen[].sendungen[].id`	string	ja
`bestellungen[].sendungen[].versanddienstleister`	string	ja	Werte: DHL, DPD, Hermes, GLS, UPS, Deutsche Post, Sonstige
`bestellungen[].sendungen[].sendungsnummer`	string	ja	Ohne Leerzeichen, in Großbuchstaben.
`bestellungen[].sendungen[].tracking_url`	string \| null	ja	Link zur Sendungsverfolgung; null bei „Sonstige“ ohne eigenen Link.
`bestellungen[].sendungen[].versendet_am`	string	ja	Wann das Paket gemeldet wurde. ISO 8601, UTC.
`bestellungen[].sendungen[].positionen`	string[]	ja	position_id der Positionen in diesem Paket.

400 geaendert_seit, seite oder pro_seite ungültig (invalidQuery).
401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.

GET/api/v1/orders/{id}

Eine Bestellung

Berechtigung: bestellungen:lesen

Parameter

Feld	Typ	Pflicht	Beschreibung
`id (path)`	string	ja	eveyamin-Bestell-ID oder Bestellnummer.

Antworten

200 Die Bestellung mit deinen Positionen. – Bestellung

Feld	Typ	Pflicht	Beschreibung
`id`	string	ja	eveyamin-Bestell-ID; in Pfaden geht auch die Bestellnummer.
`bestellnummer`	integer	ja	(-9007199254740991–9007199254740991)
`bestelldatum`	string	ja	Wann der Käufer bestellt hat. ISO 8601, UTC.
`status`	string	ja	Werte: Bezahlt, Versendet, Abgeschlossen, Storniert, Erstattet, Rückbuchung
`versandart`	string	ja	Werte: Standardversand, Expressversand
`bestaetigt_am`	string \| null	ja
`geaendert_am`	string	ja	Letzte Änderung eines Status deiner Positionen oder der Bestellung. ISO 8601, UTC.
`lieferadresse`	Lieferadresse	ja	Wohin das Paket geht. Die E-Mail-Adresse des Käufers wird nicht weitergegeben.
`lieferadresse.vorname`	string	ja
`lieferadresse.nachname`	string	ja
`lieferadresse.firma`	string \| null	ja
`lieferadresse.strasse`	string	ja	Straße und Hausnummer.
`lieferadresse.plz`	string	ja
`lieferadresse.ort`	string	ja
`lieferadresse.land`	string	ja	Wie vom Käufer eingegeben, z. B. „Deutschland“ (noch kein Ländercode).
`lieferadresse.telefon`	string \| null	ja	Für den Versanddienstleister; optional beim Kauf.
`summen`	object	ja	Nur deine Positionen, in EUR, brutto.
`summen.waren`	number	ja
`summen.versandkosten`	number	ja
`summen.gesamt`	number	ja
`positionen`	BestellPosition[]	ja	Nur deine Positionen; andere Händler derselben Bestellung fehlen.
`positionen[].position_id`	string	ja	eveyamin-ID der Bestellposition.
`positionen[].produkt_id`	string	ja
`positionen[].variant_id`	string \| null	ja
`positionen[].artikelnummer`	string \| null	ja
`positionen[].uebergeordnete_sku`	string \| null	ja	Aktuelle Übergeordnete SKU des Produkts.
`positionen[].sku`	string \| null	ja	Aktuelle SKU der Variante, sonst die beim Kauf gespeicherte.
`positionen[].ean`	string \| null	ja	Aktuelle EAN / GTIN der Variante, sonst null.
`positionen[].titel`	string	ja	Produkttitel zum Zeitpunkt des Kaufs.
`positionen[].farbe`	string \| null	ja
`positionen[].groesse`	string \| null	ja	Größe wie im Shop, oder „Maßanfertigung“.
`positionen[].menge`	number	ja	Stückzahl, bei Meterware Meter.
`positionen[].einheit`	string	ja	Werte: Stück, Meter
`positionen[].einzelpreis`	number	ja	Bezahlter Preis je Stück bzw. Meter in EUR, brutto.
`positionen[].summe`	number	ja	Bezahlter Warenwert der Position in EUR, brutto, ohne Versand.
`positionen[].versandkosten`	number	ja	Versandkosten in EUR, brutto. Sie stehen bei einer Position je Bestellung.
`positionen[].lieferstatus`	string	ja	Werte: In Bearbeitung, Versendet, Abgeschlossen, Storniert, Zahlung ausstehend, Erstattet, Fehlgeschlagen
`positionen[].bestaetigt_am`	string \| null	ja
`positionen[].sendung_id`	string \| null	ja	Das Paket, in dem die Position versendet wurde (sendungen[].id), sonst null.
`positionen[].versendet_am`	string \| null	ja
`positionen[].massanfertigung`	Massanfertigung \| null	ja	Die Körpermaße bei einer Maßanfertigung, sonst null.
`positionen[].massanfertigung.einheit`	string	ja	So, wie der Käufer gemessen hat; nicht umgerechnet.Werte: cm, Zoll
`positionen[].massanfertigung.brustumfang`	number	ja
`positionen[].massanfertigung.taillenumfang`	number	ja
`positionen[].massanfertigung.hueftumfang`	number	ja
`positionen[].massanfertigung.koerpergroesse`	number	ja	Barfuß.
`positionen[].massanfertigung.schluesselbein_boden`	number	ja	Vom Schlüsselbein bis zum Boden.
`positionen[].massanfertigung.schulterlaenge`	number	ja
`positionen[].massanfertigung.extralaenge`	number \| null	ja
`sendungen`	Sendung[]	ja	Deine Pakete dieser Bestellung, ältestes zuerst.
`sendungen[].id`	string	ja
`sendungen[].versanddienstleister`	string	ja	Werte: DHL, DPD, Hermes, GLS, UPS, Deutsche Post, Sonstige
`sendungen[].sendungsnummer`	string	ja	Ohne Leerzeichen, in Großbuchstaben.
`sendungen[].tracking_url`	string \| null	ja	Link zur Sendungsverfolgung; null bei „Sonstige“ ohne eigenen Link.
`sendungen[].versendet_am`	string	ja	Wann das Paket gemeldet wurde. ISO 8601, UTC.
`sendungen[].positionen`	string[]	ja	position_id der Positionen in diesem Paket.

401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
404 Keine solche bezahlte Bestellung mit Positionen von dir (orderNotFound).
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.

POST/api/v1/orders/{id}/acknowledge

Bestellung bestätigen

Dein System hat die Bestellung übernommen: Sie verschwindet aus /orders/new und wird bei Bestandsmeldungen nicht mehr abgezogen. Wiederholbar; ein zweiter Aufruf ändert nichts (bereits_bestaetigt).

Berechtigung: bestellungen:lesen

Parameter

Feld	Typ	Pflicht	Beschreibung
`id (path)`	string	ja	eveyamin-Bestell-ID oder Bestellnummer.

Antworten

200 Bestätigt. – Bestaetigung

Feld	Typ	Pflicht	Beschreibung
`id`	string	ja
`bestellnummer`	integer	ja	(-9007199254740991–9007199254740991)
`bestaetigt_am`	string	ja	Wann die Bestellung zum ersten Mal bestätigt wurde. ISO 8601, UTC.
`bereits_bestaetigt`	boolean	ja	true: war schon bestätigt; nichts hat sich geändert.

401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
404 Keine solche bezahlte Bestellung mit Positionen von dir (orderNotFound).
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.

POST/api/v1/orders/acknowledge

Mehrere Bestellungen bestätigen

Bis zu 100 Bestellungen auf einmal, je über Bestell-ID oder Bestellnummer; ein Ergebnis je Eintrag.

Berechtigung: bestellungen:lesen

Inhalt – BestaetigungAnfrage

Feld	Typ	Pflicht	Beschreibung
`bestellungen`	string \| integer[]	ja	Bestell-IDs oder Bestellnummern.

Antworten

200 Ergebnis je Eintrag. – BestaetigungErgebnis

Feld	Typ	Pflicht	Beschreibung
`zusammenfassung`	object	ja
`zusammenfassung.ok`	integer	ja	(-9007199254740991–9007199254740991)
`zusammenfassung.bereits_bestaetigt`	integer	ja	(-9007199254740991–9007199254740991)
`zusammenfassung.fehler`	integer	ja	(-9007199254740991–9007199254740991)
`bestellungen`	object[]	ja
`bestellungen[].zeile`	integer	ja	Index in bestellungen, ab 0. (-9007199254740991–9007199254740991)
`bestellungen[].status`	string	ja	Werte: ok, bereits_bestaetigt, fehler
`bestellungen[].id`	string	nein
`bestellungen[].bestellnummer`	integer	nein	(-9007199254740991–9007199254740991)
`bestellungen[].bestaetigt_am`	string	nein	Wann die Bestellung zum ersten Mal bestätigt wurde. ISO 8601, UTC.
`bestellungen[].fehler`	object	nein
`bestellungen[].fehler.code`	string	ja
`bestellungen[].fehler.feld`	string \| null	ja
`bestellungen[].fehler.nachricht`	string	ja

401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
422 Kein { bestellungen: [...] }, leer, oder mehr als 100 Einträge.
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.

Versand

Pakete mit Sendungsnummer melden; die Bestellung wird „Versendet“ (WP5).

POST/api/v1/orders/{id}/fulfill

Versand melden

Ein Paket deiner Positionen: Versanddienstleister, Sendungsnummer und die Positionen darin (ohne positionen: alle deine Positionen „In Bearbeitung“). Die Positionen werden „Versendet“, der Käufer bekommt eine E-Mail mit dem Link zur Sendungsverfolgung, und die Bestellung gilt als bestätigt. Mehrere Pakete: ein Aufruf je Sendungsnummer. Dieselbe Sendungsnummer noch einmal ist dasselbe Paket: Nichts passiert doppelt, neue Positionen kommen hinzu. Geht eine Position nicht, wird nichts versendet.

Berechtigung: bestellungen:versenden

Parameter

Feld	Typ	Pflicht	Beschreibung
`id (path)`	string	ja	eveyamin-Bestell-ID oder Bestellnummer.

Inhalt – VersandAnfrage

Feld	Typ	Pflicht	Beschreibung
`versanddienstleister`	string	ja	Werte: DHL, DPD, Hermes, GLS, UPS, Deutsche Post, Sonstige
`sendungsnummer`	string	ja	Gespeichert ohne Leerzeichen und in Großbuchstaben: 4–40 Zeichen aus A–Z, 0–9 und -.
`tracking_url`	string \| null	nein	Eigener https-Link. Ohne ihn baut eveyamin den Link des Versanddienstleisters (bei „Sonstige“ gibt es keinen).
`positionen`	string[]	nein	position_id der Positionen im Paket. Ohne: alle deine Positionen „In Bearbeitung“.

Antworten

200 Gemeldet, oder schon so gemeldet (bereits_erfasst). – VersandErgebnis

Feld	Typ	Pflicht	Beschreibung
`bereits_erfasst`	boolean	ja	true: Dieses Paket war mit diesen Positionen schon gemeldet; nichts hat sich geändert, keine Mail.
`sendung`	Sendung	ja	Ein Paket: ganze Positionen, eine Sendungsnummer.
`sendung.id`	string	ja
`sendung.versanddienstleister`	string	ja	Werte: DHL, DPD, Hermes, GLS, UPS, Deutsche Post, Sonstige
`sendung.sendungsnummer`	string	ja	Ohne Leerzeichen, in Großbuchstaben.
`sendung.tracking_url`	string \| null	ja	Link zur Sendungsverfolgung; null bei „Sonstige“ ohne eigenen Link.
`sendung.versendet_am`	string	ja	Wann das Paket gemeldet wurde. ISO 8601, UTC.
`sendung.positionen`	string[]	ja	position_id der Positionen in diesem Paket.
`bestellung`	Bestellung	ja
`bestellung.id`	string	ja	eveyamin-Bestell-ID; in Pfaden geht auch die Bestellnummer.
`bestellung.bestellnummer`	integer	ja	(-9007199254740991–9007199254740991)
`bestellung.bestelldatum`	string	ja	Wann der Käufer bestellt hat. ISO 8601, UTC.
`bestellung.status`	string	ja	Werte: Bezahlt, Versendet, Abgeschlossen, Storniert, Erstattet, Rückbuchung
`bestellung.versandart`	string	ja	Werte: Standardversand, Expressversand
`bestellung.bestaetigt_am`	string \| null	ja
`bestellung.geaendert_am`	string	ja	Letzte Änderung eines Status deiner Positionen oder der Bestellung. ISO 8601, UTC.
`bestellung.lieferadresse`	Lieferadresse	ja	Wohin das Paket geht. Die E-Mail-Adresse des Käufers wird nicht weitergegeben.
`bestellung.lieferadresse.vorname`	string	ja
`bestellung.lieferadresse.nachname`	string	ja
`bestellung.lieferadresse.firma`	string \| null	ja
`bestellung.lieferadresse.strasse`	string	ja	Straße und Hausnummer.
`bestellung.lieferadresse.plz`	string	ja
`bestellung.lieferadresse.ort`	string	ja
`bestellung.lieferadresse.land`	string	ja	Wie vom Käufer eingegeben, z. B. „Deutschland“ (noch kein Ländercode).
`bestellung.lieferadresse.telefon`	string \| null	ja	Für den Versanddienstleister; optional beim Kauf.
`bestellung.summen`	object	ja	Nur deine Positionen, in EUR, brutto.
`bestellung.summen.waren`	number	ja
`bestellung.summen.versandkosten`	number	ja
`bestellung.summen.gesamt`	number	ja
`bestellung.positionen`	BestellPosition[]	ja	Nur deine Positionen; andere Händler derselben Bestellung fehlen.
`bestellung.positionen[].position_id`	string	ja	eveyamin-ID der Bestellposition.
`bestellung.positionen[].produkt_id`	string	ja
`bestellung.positionen[].variant_id`	string \| null	ja
`bestellung.positionen[].artikelnummer`	string \| null	ja
`bestellung.positionen[].uebergeordnete_sku`	string \| null	ja	Aktuelle Übergeordnete SKU des Produkts.
`bestellung.positionen[].sku`	string \| null	ja	Aktuelle SKU der Variante, sonst die beim Kauf gespeicherte.
`bestellung.positionen[].ean`	string \| null	ja	Aktuelle EAN / GTIN der Variante, sonst null.
`bestellung.positionen[].titel`	string	ja	Produkttitel zum Zeitpunkt des Kaufs.
`bestellung.positionen[].farbe`	string \| null	ja
`bestellung.positionen[].groesse`	string \| null	ja	Größe wie im Shop, oder „Maßanfertigung“.
`bestellung.positionen[].menge`	number	ja	Stückzahl, bei Meterware Meter.
`bestellung.positionen[].einheit`	string	ja	Werte: Stück, Meter
`bestellung.positionen[].einzelpreis`	number	ja	Bezahlter Preis je Stück bzw. Meter in EUR, brutto.
`bestellung.positionen[].summe`	number	ja	Bezahlter Warenwert der Position in EUR, brutto, ohne Versand.
`bestellung.positionen[].versandkosten`	number	ja	Versandkosten in EUR, brutto. Sie stehen bei einer Position je Bestellung.
`bestellung.positionen[].lieferstatus`	string	ja	Werte: In Bearbeitung, Versendet, Abgeschlossen, Storniert, Zahlung ausstehend, Erstattet, Fehlgeschlagen
`bestellung.positionen[].bestaetigt_am`	string \| null	ja
`bestellung.positionen[].sendung_id`	string \| null	ja	Das Paket, in dem die Position versendet wurde (sendungen[].id), sonst null.
`bestellung.positionen[].versendet_am`	string \| null	ja
`bestellung.positionen[].massanfertigung`	Massanfertigung \| null	ja	Die Körpermaße bei einer Maßanfertigung, sonst null.
`bestellung.positionen[].massanfertigung.einheit`	string	ja	So, wie der Käufer gemessen hat; nicht umgerechnet.Werte: cm, Zoll
`bestellung.positionen[].massanfertigung.brustumfang`	number	ja
`bestellung.positionen[].massanfertigung.taillenumfang`	number	ja
`bestellung.positionen[].massanfertigung.hueftumfang`	number	ja
`bestellung.positionen[].massanfertigung.koerpergroesse`	number	ja	Barfuß.
`bestellung.positionen[].massanfertigung.schluesselbein_boden`	number	ja	Vom Schlüsselbein bis zum Boden.
`bestellung.positionen[].massanfertigung.schulterlaenge`	number	ja
`bestellung.positionen[].massanfertigung.extralaenge`	number \| null	ja
`bestellung.sendungen`	Sendung[]	ja	Deine Pakete dieser Bestellung, ältestes zuerst.
`bestellung.sendungen[].id`	string	ja
`bestellung.sendungen[].versanddienstleister`	string	ja	Werte: DHL, DPD, Hermes, GLS, UPS, Deutsche Post, Sonstige
`bestellung.sendungen[].sendungsnummer`	string	ja	Ohne Leerzeichen, in Großbuchstaben.
`bestellung.sendungen[].tracking_url`	string \| null	ja	Link zur Sendungsverfolgung; null bei „Sonstige“ ohne eigenen Link.
`bestellung.sendungen[].versendet_am`	string	ja	Wann das Paket gemeldet wurde. ISO 8601, UTC.
`bestellung.sendungen[].positionen`	string[]	ja	position_id der Positionen in diesem Paket.

401 Kein, ungültiger oder widerrufener Schlüssel (keyMissing, keyInvalid, keyWrongEnvironment).
403 Dem Schlüssel fehlt die Berechtigung (scopeMissing), der Shop ist dafür noch nicht freigegeben (registrationNotApproved) oder die API ist für deinen Shop noch nicht freigeschaltet (apiNotEnabled).
404 Keine solche bezahlte Bestellung mit Positionen von dir (orderNotFound).
409 Die Bestellung ist nicht mehr bezahlt, z. B. erstattet (orderNotShippable), oder keine deiner Positionen ist mehr „In Bearbeitung“ (nothingToShip).
422 Ungültige Angaben (invalidCarrier, invalidTrackingNumber, invalidTrackingUrl, invalidBody) oder Positionen, die sich nicht versenden lassen (lineNotFound, lineNotShippable, lineInOtherShipment) – dann wurde nichts versendet.
429 Mehr als 120 Anfragen pro Minute und Schlüssel (rateLimited). Siehe Header Retry-After.

Versionen und Kontakt

Die API ist versioniert (/api/v1). Neue Felder und Aufrufe kommen in v1 hinzu – ignoriere also Felder, die du nicht kennst. Was bestehende Anbindungen bricht, kommt erst in v2 und wird mit Vorlauf angekündigt.

Fragen zur Anbindung: info@eveyamin.com.

Technischer Support

Mit den Informationen oben sollte dein technisches Team die Anbindung abschließen können. Brauchst du weitere Unterstützung, hilft dir unser Technologiepartner gern bei der Anbindung.