Seller API

Connect your inventory system, your shop software or your dropshipping supplier directly to your eveyamin shop: create and update products, sync stock within seconds, pick up paid orders and report shipments.

Create an API key OpenAPI file Deutsche Fassung

Getting started

The seller API is a JSON REST interface at https://eveyamin.com/api/v1. Field names and values are German – categories, colours, sizes and statuses exactly as the shop stores them. A connection is built by your developer, your agency or a middleware service; there are no ready-made plugins for particular inventory systems.

Create a key

Under Settings → API access, create a key and pick only the scopes the connection needs.
Copy the key right away and keep it safe – it is shown this one time only.
Send it with every request in the header Authorization: Bearer <key>.

Scope	Allows
`produkte:schreiben`	Create, change, read and archive products
`bestand:schreiben`	Read and set stock
`bestellungen:lesen`	Pick up and acknowledge orders (once your shop is live)
`bestellungen:versenden`	Report shipments with a tracking number

Keys belong on a server, never in a web page or an app. You can have up to 10 keys – use one per connection, so you can revoke one on its own. Revoke a key at once if it may have fallen into the wrong hands.

First call

Request

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

Response

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

Live and test

Keys start with evy_live_ (the shop) or evy_test_ (the test environment) and work only where they were created. A key from the other environment gets 401 keyWrongEnvironment.

German values

Categories come as their full path (eve-Home > Bettwäsche > Bettwäsche-Sets), colours and sizes exactly as in the shop. GET /api/v1/taxonomy returns every category with its sizes and every colour. The API fixes small differences itself (weiss → Weiß, 200x200 → 200 x 200 cm) and reports them as hints. Map your inventory system's own names once in the CSV import; the mapping applies to the API too.

Limits

What	Limit
Requests per key	120 a minute, then 429 with `Retry-After`
Request size	1024 KB
Lines per stock call	500
Variants per product	500
Images per product	20
Products per page	100
Orders per page	100

Every answer is JSON and is never cached. Calls from a browser (CORS) are not allowed.

Products

A product is its details plus its variants (colour × size). The rules are the product form's and the CSV import's: whatever they refuse, the API refuses too – with the same codes. The field names are the CSV template's column names.

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 (parent SKU) is your key for the product, unique in your shop. You address it with it later: /products/BW-SATIN-01.
kategorie is the full path; every groesse must belong to the category.
preis is per variant. Prices may differ by size only, not by colour; the lowest is the base price. rabattpreis (sale price) applies to the whole product; without it there is no discount.
Numbers may also come as text, German or English ("59,90").
sku and ean per variant are optional. Leave the field out and the stored code stays; null clears it. An EAN needs a valid check digit.
bild_urls: https addresses. The images are downloaded and stored with us; the gallery may also sit on the first variant only.
versandkosten (shipping) is optional: without it a new product gets your default, an existing one keeps its value.

Create, replace, read

Call	Effect
`POST /products`	Creates the product: 201. If the parent SKU exists already: 409 `productExists` with the existing product.
`PUT /products/{id}`	Replaces the whole product; missing variants are archived. If `{id}` does not exist yet and the body names `{id}` as its `uebergeordnete_sku`, the product is created (upsert); otherwise 404.
`GET /products/{id}`	The product in exactly the shape PUT takes, plus read-only fields (`id`, `artikelnummer`, `status`, `geaendert_am`, `variant_id`). You can send it back as it is.
`GET /products`	All your products, oldest change first, archived ones included – with `geaendert_seit` only those changed since.
`DELETE /products/{id}`	Archives the product; a second call changes nothing.

{id} may be the eveyamin product id, your parent SKU or the eveyamin article number (artikelnummer). A product created in the form gets its parent SKU once through PUT /products/{artikelnummer} with uebergeordnete_sku in the body; an existing one is changed in the product form only.

Result

ergebnis is angelegt (created), aktualisiert (updated) or unveraendert (unchanged). When nothing changed, nothing is written and nothing re-translated – so a full sync of every product costs almost nothing. hinweise (hints) names corrected spellings and images that could not be loaded. New products are translated first (status “Wird übersetzt”) and then go online.

Images

Images are downloaded during the call. If that takes too long, the API answers 202 with a job (Location: /api/v1/jobs/{id}). Poll the job until it is fertig (done); the product is saved only once its images are there.
Each image address is downloaded once. A changed picture therefore needs a new address, e.g. with ?v=2.
If a newer request for the same product arrives, an open job becomes ersetzt (superseded).

Stock in the product call

For variants already on sale, a product call does not change the stock – that is the stock call's job. A different lagerbestand comes back as the hint stockIgnored. New products and new variants take the stock sent.

Archived, blocked, sold by the metre

Restore archived products in the dashboard; PUT and POST answer 409 productArchived. Blocked products: 409 productBlocked. Products sold by the metre (fabrics) are not in the API yet: 409 productMeterware.

Stock sync

The stock call changes stock only, never the product. Your inventory system keeps eveyamin's stock current with it, so nothing sells twice when you sell on several channels.

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

A line addresses a variant by sku, or by produkt + farbe + groesse. Up to 500 lines per call, across all products.
lagerbestand is your stock. It is stored minus the pieces in open eveyamin orders your system has not acknowledged yet – your count cannot know about those.
Send stand, the time of your count. A line with an older stand than the last one taken is ignored (veraltet, stale).
Every line has its own result: ok, unveraendert, veraltet or fehler. A failing line does not hold up the others.
On 503 busy nothing was saved; repeat the request after Retry-After seconds.

How to go about it

Fetch GET /stock once, page by page, and map your articles to the variants, preferably by sku.
On every stock change, or e.g. every five minutes, send PATCH /stock with the changed lines and stand.
Pick up and acknowledge new orders – only then do they stop counting as open.

Orders and dropshipping

You pick up paid orders with your lines, acknowledge them and report the shipment. Lines of other sellers in the same order are not shown to you.

GET /orders/new – paid orders your system has not acknowledged yet, oldest first. An order stays there until you acknowledge it; if an answer gets lost, it comes again on the next call.
POST /orders/{id}/acknowledge – your system has it. Up to 100 at once with POST /orders/acknowledge.
POST /orders/{id}/fulfill with the carrier and tracking number – the lines become “Versendet” (shipped), and the buyer gets a mail with the tracking link.
GET /orders?geaendert_seit=… – cancellations and refunds that happen later. Remember the last geaendert_am and ask again with some overlap.

POST /api/v1/orders/1042/fulfill

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

{id} is the eveyamin order id or the order number (bestellnummer).
Carriers: DHL, DPD, Hermes, GLS, UPS, Deutsche Post or Sonstige (other – then with your own tracking_url).
Several parcels: one call per tracking number, with the parcel's positionen. The same tracking number again changes nothing and sends no second mail.
The delivery address has the name, address and phone, but no email address: eveyamin communicates with the buyer.

Dropshipping: give your supplier a key of their own with only bestellungen:lesen and bestellungen:versenden. They then see neither products nor stock. You stay responsible for them, including how they handle buyer data – see the terms and the privacy policy.

Test environment

For development there is a test environment at https://staging--eveyamin.netlify.app. It has its own data and its own keys (evy_test_…), and it sends no mail to buyers.

Sign up at https://staging--eveyamin.netlify.app and write to info@eveyamin.com – we set your account up as a test shop.
Create a test key there under Settings → API access.
Create products through the API and make test orders.

Test order

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

POST /sandbox/orders creates a paid order for one of your variants – without a body for the first one with stock, or specifically with {"positionen": [{"sku": "…", "menge": 2}]}. The buyer is the fictitious Erika Mustermann. The order goes through everything a real one does: /orders/new, acknowledge, report the shipment. At most 30 an hour. The same button is under API access in the test environment; the live shop has no such call.

The test environment is no archive: its data can be reset at any time.

Errors

Errors always have the same shape:

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

Evaluate code: it is stable and English. nachricht (message) is German and may change; feld (field) is the JSON path of the field concerned, or null.

Status	Meaning
200 / 201	Done; 201 for a newly created product or a test order
202	Accepted, the images are still loading (job)
400	Not valid JSON, or invalid parameters
401	No key, or an invalid or revoked one
403	Scope missing, or the shop is not approved yet
404	Not found – or not yours
409	Conflict with a key or a state (e.g. parent SKU taken)
422	Invalid body
429	Too many requests
500 / 503	Error on our side or briefly unavailable – retry later

Every call

Code	Status	Meaning
`invalidJson`	400	The body is not valid JSON.
`invalidQuery`	400	`seite`, `pro_seite` or `geaendert_seit` is invalid.
`keyMissing`	401	No key in the `Authorization: Bearer …` header.
`keyInvalid`	401	Unknown or revoked key, or the account is not active.
`keyWrongEnvironment`	401	A test key in the live shop, or the other way round.
`scopeMissing`	403	The key lacks the scope this call needs.
`registrationNotApproved`	403	The shop's registration is not approved yet (orders: the shop is not live yet).
`apiNotEnabled`	403	The API is not enabled for your shop yet.
`notFound`	404	Unknown path.
`bodyTooLarge`	413	The request is too large.
`rateLimited`	429	Too many requests; wait as many seconds as `Retry-After` says.
`internal`	500	Unexpected error on our side; retry later.
`unavailable`	503	The service is briefly unavailable; retry after `Retry-After`.

Products

Code	Status	Meaning
`productNotFound`	404	No such product of yours.
`jobNotFound`	404	No such job of yours.
`productExists`	409	The parent SKU exists already; the answer names the product. Use PUT.
`productArchived`	409	The product is archived; restore it in the dashboard.
`productBlocked`	409	The product is blocked and cannot be changed.
`productMeterware`	409	Products sold by the metre are not in the API yet.
`parentSkuDuplicate`	409	You use this parent SKU already.
`imagesFailed`	422	None of the product's images could be loaded.
`writeFailed`	500	The product could not be saved; retry later.
`tooManyVariants`	422	More variants than allowed.
`invalidValue`	422	A value has the wrong shape.

Stock

Code	Status	Meaning
`invalidBody`	422	Expected `{ "positionen": [ … ] }` (or the call's shape).
`noLines`	422	`positionen` is empty.
`tooManyLines`	422	Too many lines; split them over several requests.
`busy`	503	Stock is being changed elsewhere; nothing saved, retry.
`invalidLine`	in the line	The line is not an object.
`identifierMissing`	in the line	Neither `sku` nor `produkt` + `farbe` + `groesse`.
`stockInvalid`	in the line	`lagerbestand` is not an allowed whole number.
`standInvalid`	in the line	`stand` is not an ISO 8601 time with a time zone.
`standInFuture`	in the line	`stand` is in the future.
`variantNotFound`	in the line	No active variant matches.
`keyMismatch`	in the line	The SKU belongs to another combination than the line's other values.
`duplicateLine`	in the line	The same variant is in an earlier line already.

Orders and shipping

Code	Status	Meaning
`orderNotFound`	404	No such paid order with lines of yours.
`noEntries`	422	`bestellungen` is empty.
`tooManyEntries`	422	Too many orders in one request.
`invalidEntry`	in the line	Neither an order id nor an order number.
`orderNotShippable`	409	Only paid orders can be shipped.
`nothingToShip`	409	None of your lines is still “In Bearbeitung”.
`invalidCarrier`	422	Unknown carrier.
`invalidTrackingNumber`	422	Tracking number: 4–40 characters from A–Z, 0–9 and -.
`invalidTrackingUrl`	422	`tracking_url` is not an https link.
`lineNotFound`	422	None of your lines of this order has this id.
`lineNotShippable`	422	The line is no longer “In Bearbeitung”.
`lineInOtherShipment`	422	The line has shipped under another tracking number already.

Test environment

Code	Status	Meaning
`noStock`	422	No variant with stock for the test order.
`sandboxLimit`	429	Too many test orders in the past hour.

Hints

Code	Status	Meaning
`stockIgnored`	hint	Stock of a variant on sale not taken; use the stock call for that.
`valueMapped`	hint	Value taken through your mapping.

Product checks

Products are checked as in the CSV import. These codes come in fehler (409 for key conflicts, otherwise 422) or as a hint. The messages themselves are German; here they are in English:

Code	Status	Meaning
`required`	422	“…” is required.
`tooLong`	422	“…” is too long (at most … characters).
`tooShort`	422	“…” is too short (at least … characters).
`numberInvalid`	422	“…” is not a valid number.
`priceRange`	422	“…” is not between … and ….
`stockInvalid`	422	“…” is not a valid stock level (a whole number from 0 to …).
`categoryUnknown`	422	Unknown category “…”.
`categoryIncomplete`	422	The category “…” is incomplete – please give it down to the lowest level.
`categoryNotOffered`	422	The category “…” is no longer offered.
`colorUnknown`	422	Unknown colour “…”.
`sizeUnknown`	422	Unknown size “…”.
`sizeNotInCategory`	422	The size “…” is not offered in “…”.
`duplicateCombination`	422	The combination … is already in ⁦varianten[…]⁩.
`priceVariesByColor`	422	The price for … differs from ⁦varianten[…]⁩. Prices may differ by size only, not by colour.
`discountAboveBase`	422	The discount price (… €) is above the lowest price (… €).
`imageUrlInvalid`	422	“…” is not a valid image address (https://…).
`tooManyImages`	422	… images – at most … per product.
`noImages`	422	Please give at least one image URL per product.
`skuDuplicateInFile`	422	The SKU “…” is already used in ⁦varianten[…]⁩.
`skuTaken`	409	The SKU “…” already belongs to another of your products.
`eanInvalid`	422	“…” is not a valid EAN (8, 12, 13 or 14 digits with a valid check digit).
`ambiguousMatch`	409	“…” matches more than one existing product (article number …).
`parentSkuLocked`	409	Product … already has the Übergeordnete SKU “…”. An existing Übergeordnete SKU is changed in the product form.
`parentSkuOfOther`	409	“…” already belongs to your product …, but the eveyamin-Artikelnummer belongs to …. Please use another Übergeordnete SKU.
`categoryFixed`	hint	Category taken as “…”.
`colorFixed`	hint	Colour “…” taken as “…”.
`sizeFixed`	hint	Size “…” taken as “…”.
`imageFailed`	hint	Image not taken over (…): …

Reference

Every call with its parameters and fields, generated from the interface itself; the descriptions are German, like the API. For Postman, Insomnia or code generators there is the OpenAPI file.

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.

Scope: any valid key

Responses

200 Der Schlüssel gilt. – Ping

Field	Type	Required	Description
`ok`	true	yes
`umgebung`	string	yes	live = Shop, test = Testumgebung.Values: live, test
`haendler_id`	string	yes	Deine Händler-ID bei eveyamin.
`schluessel`	object	yes
`schluessel.name`	string	yes
`schluessel.praefix`	string	yes	Anfang des Schlüssels, z. B. evy_live_Ab3x.
`schluessel.berechtigungen`	string[]	yes	Values: 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.

Scope: any valid key

Responses

200 Die aktuellen Listen. – Taxonomie

Field	Type	Required	Description
`kategorien`	object[]	yes	Jede Kategorie, unter der ein Produkt stehen kann.
`kategorien[].pfad`	string	yes	Vollständiger Kategoriepfad, mit „ > “ getrennt, z. B. „eve-Home > Bettwäsche > Bettwäsche-Sets“.
`kategorien[].groessen`	string[]	yes	Größen, die diese Kategorie anbietet.
`farben`	string[]	yes	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.

Scope: produkte:schreiben

Body – ProduktAnfrage

Field	Type	Required	Description
`uebergeordnete_sku`	string \| null	no	Deine Produktnummer, eindeutig in deinem Shop, max. 100 Zeichen. Pflicht beim Anlegen.
`titel`	string	yes	Max. 100 Zeichen.
`beschreibung`	string	yes	10 bis 10.000 Zeichen.
`kategorie`	string	yes	Vollständiger Pfad, z. B. „eve-Home > Bettwäsche > Bettwäsche-Sets“ (siehe /taxonomy).
`rabattpreis`	number \| string \| null	no
`versandkosten`	number \| string \| null	no
`varianten`	ProduktVarianteEingabe[]	yes
`varianten[].farbe`	string	yes	Farbe wie im Shop, z. B. „Weiß“ (siehe /taxonomy).
`varianten[].groesse`	string	yes	Größe aus der Größenliste der Kategorie, z. B. „M“ oder „200 x 200 cm“.
`varianten[].preis`	number \| string	yes	Preis dieser Variante in EUR, brutto. Preise dürfen sich nur je Größe unterscheiden; der niedrigste ist der Grundpreis.
`varianten[].lagerbestand`	number \| string	yes	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	no	Deine SKU dieser Kombination, eindeutig in deinem Shop, max. 64 Zeichen.
`varianten[].ean`	string \| null	no	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[]	no	Ö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.

Responses

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

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

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

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

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.

Scope: produkte:schreiben

Parameters

Field	Type	Required	Description
`seite (query)`	integer	no	Seite, ab 1.
`pro_seite (query)`	integer	no	Produkte pro Seite, höchstens 100.
`geaendert_seit (query)`	string (date-time)	no	Nur Produkte, die danach geändert wurden (ISO 8601 mit Zeitzone).

Responses

200 Eine Seite Produkte. – ProduktListe

Field	Type	Required	Description
`seite`	integer	yes	(-9007199254740991–9007199254740991)
`pro_seite`	integer	yes	(-9007199254740991–9007199254740991)
`gesamt`	integer	yes	Produkte insgesamt (mit geaendert_seit: seither geänderte). (-9007199254740991–9007199254740991)
`produkte`	Produkt[]	yes
`produkte[].id`	string	yes	eveyamin-Produkt-ID.
`produkte[].artikelnummer`	string	yes	eveyamin-Artikelnummer.
`produkte[].uebergeordnete_sku`	string \| null	yes
`produkte[].status`	string	yes	Neue und geänderte Texte werden erst übersetzt; ohne eingerichteten Zahlungsanbieter bleibt das Produkt verborgen.Values: Aktiv, Wird übersetzt, Wartet auf Zahlungsanbieter, Gesperrt, Archiviert
`produkte[].titel`	string	yes
`produkte[].beschreibung`	string	yes
`produkte[].kategorie`	string	yes
`produkte[].rabattpreis`	number \| null	yes
`produkte[].versandkosten`	number \| null	yes
`produkte[].geaendert_am`	string	yes	Letzte Änderung am Produkt, auch am Bestand. ISO 8601, UTC.
`produkte[].varianten`	object[]	yes
`produkte[].varianten[].variant_id`	string	yes
`produkte[].varianten[].farbe`	string	yes
`produkte[].varianten[].groesse`	string	yes
`produkte[].varianten[].preis`	number	yes
`produkte[].varianten[].lagerbestand`	integer	yes	Gespeicherter, kaufbarer Bestand. (-9007199254740991–9007199254740991)
`produkte[].varianten[].sku`	string \| null	yes
`produkte[].varianten[].ean`	string \| null	yes
`produkte[].varianten[].bild_urls`	string[]	yes	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).

Scope: produkte:schreiben

Parameters

Field	Type	Required	Description
`id (path)`	string	yes	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.

Responses

200 Das Produkt. – Produkt

Field	Type	Required	Description
`id`	string	yes	eveyamin-Produkt-ID.
`artikelnummer`	string	yes	eveyamin-Artikelnummer.
`uebergeordnete_sku`	string \| null	yes
`status`	string	yes	Neue und geänderte Texte werden erst übersetzt; ohne eingerichteten Zahlungsanbieter bleibt das Produkt verborgen.Values: Aktiv, Wird übersetzt, Wartet auf Zahlungsanbieter, Gesperrt, Archiviert
`titel`	string	yes
`beschreibung`	string	yes
`kategorie`	string	yes
`rabattpreis`	number \| null	yes
`versandkosten`	number \| null	yes
`geaendert_am`	string	yes	Letzte Änderung am Produkt, auch am Bestand. ISO 8601, UTC.
`varianten`	object[]	yes
`varianten[].variant_id`	string	yes
`varianten[].farbe`	string	yes
`varianten[].groesse`	string	yes
`varianten[].preis`	number	yes
`varianten[].lagerbestand`	integer	yes	Gespeicherter, kaufbarer Bestand. (-9007199254740991–9007199254740991)
`varianten[].sku`	string \| null	yes
`varianten[].ean`	string \| null	yes
`varianten[].bild_urls`	string[]	yes	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.

Scope: produkte:schreiben

Parameters

Field	Type	Required	Description
`id (path)`	string	yes	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.

Body – ProduktAnfrage

Field	Type	Required	Description
`uebergeordnete_sku`	string \| null	no	Deine Produktnummer, eindeutig in deinem Shop, max. 100 Zeichen. Pflicht beim Anlegen.
`titel`	string	yes	Max. 100 Zeichen.
`beschreibung`	string	yes	10 bis 10.000 Zeichen.
`kategorie`	string	yes	Vollständiger Pfad, z. B. „eve-Home > Bettwäsche > Bettwäsche-Sets“ (siehe /taxonomy).
`rabattpreis`	number \| string \| null	no
`versandkosten`	number \| string \| null	no
`varianten`	ProduktVarianteEingabe[]	yes
`varianten[].farbe`	string	yes	Farbe wie im Shop, z. B. „Weiß“ (siehe /taxonomy).
`varianten[].groesse`	string	yes	Größe aus der Größenliste der Kategorie, z. B. „M“ oder „200 x 200 cm“.
`varianten[].preis`	number \| string	yes	Preis dieser Variante in EUR, brutto. Preise dürfen sich nur je Größe unterscheiden; der niedrigste ist der Grundpreis.
`varianten[].lagerbestand`	number \| string	yes	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	no	Deine SKU dieser Kombination, eindeutig in deinem Shop, max. 64 Zeichen.
`varianten[].ean`	string \| null	no	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[]	no	Ö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.

Responses

200 Aktualisiert, oder unveraendert. – ProduktErgebnis

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

201 Angelegt. – ProduktErgebnis

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

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

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

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).

Scope: produkte:schreiben

Parameters

Field	Type	Required	Description
`id (path)`	string	yes	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.

Responses

200 Archiviert. – ProduktArchiviert

Field	Type	Required	Description
`ergebnis`	string	yes	Values: archiviert, bereits_archiviert
`produkt`	object	yes
`produkt.id`	string	yes
`produkt.artikelnummer`	string	yes
`produkt.uebergeordnete_sku`	string \| null	yes
`produkt.status`	string	yes	Values: 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).

Scope: produkte:schreiben

Parameters

Field	Type	Required	Description
`id (path)`	string	yes	Auftrags-ID aus der 202-Antwort.

Responses

200 Der Auftrag. – Auftrag

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

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).

Scope: bestand:schreiben

Parameters

Field	Type	Required	Description
`seite (query)`	integer	no	Seite, ab 1.
`pro_seite (query)`	integer	no	Varianten pro Seite, höchstens 500.

Responses

200 Eine Seite Varianten. – BestandListe

Field	Type	Required	Description
`seite`	integer	yes	(-9007199254740991–9007199254740991)
`pro_seite`	integer	yes	(-9007199254740991–9007199254740991)
`gesamt`	integer	yes	Varianten insgesamt. (-9007199254740991–9007199254740991)
`positionen`	object[]	yes
`positionen[].produkt_id`	string	yes
`positionen[].artikelnummer`	string	yes
`positionen[].uebergeordnete_sku`	string \| null	yes
`positionen[].sku`	string \| null	yes
`positionen[].ean`	string \| null	yes	EAN / GTIN der Variante, sonst null.
`positionen[].farbe`	string	yes
`positionen[].groesse`	string	yes
`positionen[].titel`	string	yes
`positionen[].lagerbestand`	integer	yes	Gespeicherter, kaufbarer Bestand. (-9007199254740991–9007199254740991)
`positionen[].offen`	integer	yes	Stück in offenen eveyamin-Bestellungen. (-9007199254740991–9007199254740991)
`positionen[].stand`	string \| null	yes	Zuletzt übernommener stand.
`positionen[].gesperrt`	boolean	yes	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.

Scope: bestand:schreiben

Body – BestandAnfrage

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

Responses

200 Ergebnis je Zeile. – BestandErgebnis

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

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

Scope: bestand:schreiben

Parameters

Field	Type	Required	Description
`id (path)`	string	yes	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.
`seite (query)`	integer	no	Seite, ab 1.
`pro_seite (query)`	integer	no	Varianten pro Seite, höchstens 500.

Responses

200 Die Varianten des Produkts. – BestandListe

Field	Type	Required	Description
`seite`	integer	yes	(-9007199254740991–9007199254740991)
`pro_seite`	integer	yes	(-9007199254740991–9007199254740991)
`gesamt`	integer	yes	Varianten insgesamt. (-9007199254740991–9007199254740991)
`positionen`	object[]	yes
`positionen[].produkt_id`	string	yes
`positionen[].artikelnummer`	string	yes
`positionen[].uebergeordnete_sku`	string \| null	yes
`positionen[].sku`	string \| null	yes
`positionen[].ean`	string \| null	yes	EAN / GTIN der Variante, sonst null.
`positionen[].farbe`	string	yes
`positionen[].groesse`	string	yes
`positionen[].titel`	string	yes
`positionen[].lagerbestand`	integer	yes	Gespeicherter, kaufbarer Bestand. (-9007199254740991–9007199254740991)
`positionen[].offen`	integer	yes	Stück in offenen eveyamin-Bestellungen. (-9007199254740991–9007199254740991)
`positionen[].stand`	string \| null	yes	Zuletzt übernommener stand.
`positionen[].gesperrt`	boolean	yes	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.

Scope: bestand:schreiben

Parameters

Field	Type	Required	Description
`id (path)`	string	yes	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.

Body – ProduktBestandAnfrage

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

Responses

200 Ergebnis je Zeile. – BestandErgebnis

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

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.

Scope: bestellungen:lesen

Parameters

Field	Type	Required	Description
`seite (query)`	integer	no	Seite, ab 1.
`pro_seite (query)`	integer	no	Bestellungen pro Seite, höchstens 100.

Responses

200 Eine Seite Bestellungen. – BestellListe

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

Scope: bestellungen:lesen

Parameters

Field	Type	Required	Description
`geaendert_seit (query)`	string (date-time)	no	Zeitpunkt nach ISO 8601 mit Zeitzone, z. B. 2026-10-07T09:15:00Z.
`seite (query)`	integer	no	Seite, ab 1.
`pro_seite (query)`	integer	no	Bestellungen pro Seite, höchstens 100.

Responses

200 Eine Seite Bestellungen. – BestellListe

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

Scope: bestellungen:lesen

Parameters

Field	Type	Required	Description
`id (path)`	string	yes	eveyamin-Bestell-ID oder Bestellnummer.

Responses

200 Die Bestellung mit deinen Positionen. – Bestellung

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

Scope: bestellungen:lesen

Parameters

Field	Type	Required	Description
`id (path)`	string	yes	eveyamin-Bestell-ID oder Bestellnummer.

Responses

200 Bestätigt. – Bestaetigung

Field	Type	Required	Description
`id`	string	yes
`bestellnummer`	integer	yes	(-9007199254740991–9007199254740991)
`bestaetigt_am`	string	yes	Wann die Bestellung zum ersten Mal bestätigt wurde. ISO 8601, UTC.
`bereits_bestaetigt`	boolean	yes	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.

Scope: bestellungen:lesen

Body – BestaetigungAnfrage

Field	Type	Required	Description
`bestellungen`	string \| integer[]	yes	Bestell-IDs oder Bestellnummern.

Responses

200 Ergebnis je Eintrag. – BestaetigungErgebnis

Field	Type	Required	Description
`zusammenfassung`	object	yes
`zusammenfassung.ok`	integer	yes	(-9007199254740991–9007199254740991)
`zusammenfassung.bereits_bestaetigt`	integer	yes	(-9007199254740991–9007199254740991)
`zusammenfassung.fehler`	integer	yes	(-9007199254740991–9007199254740991)
`bestellungen`	object[]	yes
`bestellungen[].zeile`	integer	yes	Index in bestellungen, ab 0. (-9007199254740991–9007199254740991)
`bestellungen[].status`	string	yes	Values: ok, bereits_bestaetigt, fehler
`bestellungen[].id`	string	no
`bestellungen[].bestellnummer`	integer	no	(-9007199254740991–9007199254740991)
`bestellungen[].bestaetigt_am`	string	no	Wann die Bestellung zum ersten Mal bestätigt wurde. ISO 8601, UTC.
`bestellungen[].fehler`	object	no
`bestellungen[].fehler.code`	string	yes
`bestellungen[].fehler.feld`	string \| null	yes
`bestellungen[].fehler.nachricht`	string	yes

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.

Scope: bestellungen:versenden

Parameters

Field	Type	Required	Description
`id (path)`	string	yes	eveyamin-Bestell-ID oder Bestellnummer.

Body – VersandAnfrage

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

Responses

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

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

Versions and contact

The API is versioned (/api/v1). New fields and calls are added within v1 – so ignore fields you don't know. Anything that would break existing connections comes in v2 only, announced well ahead.

Questions about connecting: info@eveyamin.com.

Technical support

The information above should enable your technical team to complete the integration. If you need additional support, our technology partner is happy to assist you with the integration.