Satıcı API'si

Stok yönetim sistemini, mağaza yazılımını veya dropshipping tedarikçini doğrudan eveyamin mağazana bağla: ürün oluştur ve güncelle, stoku saniyeler içinde eşitle, ödenmiş siparişleri al ve gönderileri bildir.

API anahtarı oluştur OpenAPI dosyası English version

Başlarken

Satıcı API'si, https://eveyamin.com/api/v1 adresinde JSON ile çalışan bir REST arayüzüdür. Alan adları ve değerler Almancadır – kategoriler, renkler, bedenler ve durumlar tam olarak mağazada kayıtlı oldukları gibi. Bağlantıyı geliştiricin, ajansın veya bir ara katman (middleware) hizmeti kurar; belirli stok yönetim sistemleri için hazır eklentiler yoktur.

Anahtar oluştur

Ayarlar → API erişimi altında bir anahtar oluştur ve yalnızca bağlantının ihtiyaç duyduğu yetkileri seç.
Anahtarı hemen kopyala ve güvenli bir yerde sakla – yalnızca bu bir kez gösterilir.
Her istekte Authorization: Bearer <anahtar> başlığıyla gönder.

Yetki	İzin verdiği
`produkte:schreiben`	Ürün oluşturma, değiştirme, okuma ve arşivleme
`bestand:schreiben`	Stoku okuma ve ayarlama
`bestellungen:lesen`	Siparişleri alma ve onaylama (mağazan yayına girdiği anda)
`bestellungen:versenden`	Gönderileri takip numarasıyla bildirme

Anahtarlar bir sunucuda durmalı, asla bir web sayfasında veya uygulamada değil. En fazla 10 anahtarın olabilir – her bağlantı için ayrı bir anahtar kullan, böylece birini tek başına iptal edebilirsin. Yanlış ellere geçmiş olabilecek bir anahtarı hemen iptal et.

İlk çağrı

İstek

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

Yanıt

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

Canlı ve test

Anahtarlar evy_live_ (mağaza) veya evy_test_ (test ortamı) ile başlar ve yalnızca oluşturuldukları yerde çalışır. Diğer ortamdan gelen bir anahtar 401 keyWrongEnvironment alır.

Almanca değerler

Kategoriler tam yollarıyla gelir (eve-Home > Bettwäsche > Bettwäsche-Sets), renkler ve bedenler tam olarak mağazadaki gibi. GET /api/v1/taxonomy her kategoriyi bedenleriyle birlikte ve her rengi döndürür. API küçük farkları kendisi düzeltir (weiss → Weiß, 200x200 → 200 x 200 cm) ve bunları uyarı olarak bildirir. Stok yönetim sisteminin kendi adlarını CSV içe aktarımında bir kez eşleştir; eşleştirme API için de geçerlidir.

Sınırlar

Ne	Sınır
Anahtar başına istek	Dakikada 120, sonrasında `Retry-After` ile 429
İstek boyutu	1024 KB
Stok çağrısı başına satır	500
Ürün başına varyant	500
Ürün başına görsel	20
Sayfa başına ürün	100
Sayfa başına sipariş	100

Her yanıt JSON'dur ve asla önbelleğe alınmaz. Tarayıcıdan yapılan çağrılara (CORS) izin verilmez.

Ürünler

Bir ürün, bilgileri ile varyantlarından (renk × beden) oluşur. Kurallar ürün formunun ve CSV içe aktarımının kurallarıdır: onların reddettiğini API de aynı kodlarla reddeder. Alan adları, CSV şablonunun sütun adlarıdır.

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 (Übergeordnete SKU, yani üst SKU) ürün için senin anahtarındır ve mağazanda benzersizdir. Ürüne daha sonra onunla ulaşırsın: /products/BW-SATIN-01.
kategorie tam yoldur; her groesse bu kategoriye ait olmalıdır.
preis varyant başınadır. Fiyatlar yalnızca bedene göre farklı olabilir, renge göre değil; en düşük olanı taban fiyattır. rabattpreis (indirimli fiyat) tüm ürün için geçerlidir; yoksa indirim de yoktur.
Sayılar metin olarak da gelebilir, Almanca veya İngilizce biçimde ("59,90").
Varyant başına sku ve ean isteğe bağlıdır. Alanı göndermezsen kayıtlı kod kalır; null onu siler. Bir EAN'ın kontrol hanesi geçerli olmalıdır.
bild_urls: https adresleri. Görseller indirilir ve bizde saklanır; galeri yalnızca ilk varyantta da olabilir.
versandkosten (kargo ücreti) isteğe bağlıdır: yoksa yeni bir ürün senin varsayılan değerini alır, mevcut bir ürün kendi değerini korur.

Oluştur, değiştir, oku

Çağrı	Etkisi
`POST /products`	Ürünü oluşturur: 201. Übergeordnete SKU zaten varsa: mevcut ürünle birlikte 409 `productExists`.
`PUT /products/{id}`	Ürünün tamamını değiştirir; gönderilmeyen varyantlar arşivlenir. `{id}` henüz yoksa ve gövde `{id}` değerini `uebergeordnete_sku` olarak veriyorsa ürün oluşturulur (upsert); aksi halde 404.
`GET /products/{id}`	Ürünü tam olarak PUT'un aldığı biçimde verir, artı salt okunur alanlar (`id`, `artikelnummer`, `status`, `geaendert_am`, `variant_id`). Olduğu gibi geri gönderebilirsin.
`GET /products`	Tüm ürünlerin, en eski değişiklik önce, arşivlenenler dahil – `geaendert_seit` ile yalnızca o tarihten beri değişenler.
`DELETE /products/{id}`	Ürünü arşivler; ikinci bir çağrı hiçbir şeyi değiştirmez.

{id}, eveyamin ürün kimliği, senin Übergeordnete SKU'n veya eveyamin ürün numarası (artikelnummer) olabilir. Formda oluşturulmuş bir ürün, Übergeordnete SKU'sunu bir kez, gövdede uebergeordnete_sku ile PUT /products/{artikelnummer} üzerinden alır; mevcut bir Übergeordnete SKU yalnızca ürün formunda değiştirilir.

Sonuç

ergebnis değeri angelegt (oluşturuldu), aktualisiert (güncellendi) veya unveraendert (değişmedi) olur. Hiçbir şey değişmediyse hiçbir şey yazılmaz ve yeniden çevrilmez – bu yüzden tüm ürünlerin tam eşitlemesi neredeyse hiçbir yük getirmez. hinweise (uyarılar) düzeltilen yazımları ve yüklenemeyen görselleri belirtir. Yeni ürünler önce çevrilir (durum “Wird übersetzt”) ve ardından yayına girer.

Görseller

Görseller çağrı sırasında indirilir. Bu çok uzun sürerse API bir iş (job) ile 202 yanıtı verir (Location: /api/v1/jobs/{id}). İş fertig (tamamlandı) olana kadar sorgula; ürün ancak görselleri hazır olduğunda kaydedilir.
Her görsel adresi bir kez indirilir. Bu yüzden değişen bir görselin yeni bir adrese ihtiyacı vardır, örneğin ?v=2 ile.
Aynı ürün için daha yeni bir istek gelirse açık bir iş ersetzt (yerine yenisi geldi) olur.

Ürün çağrısında stok

Zaten satışta olan varyantlar için ürün çağrısı stoku değiştirmez – bu stok çağrısının işidir. Farklı bir lagerbestand değeri stockIgnored uyarısı olarak geri gelir. Yeni ürünler ve yeni varyantlar gönderilen stoku alır.

Arşivlenmiş, engellenmiş, metre ile satılan

Arşivlenmiş ürünleri kontrol panelinden geri yükle; PUT ve POST 409 productArchived yanıtı verir. Engellenmiş ürünler: 409 productBlocked. Metre ile satılan ürünler (kumaşlar) henüz API'de yok: 409 productMeterware.

Stok eşitleme

Stok çağrısı yalnızca stoku değiştirir, asla ürünü değil. Stok yönetim sistemin eveyamin'deki stoku bununla güncel tutar; böylece birden fazla kanalda satış yaptığında hiçbir şey iki kez satılmaz.

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

Bir satır, bir varyantı sku ile veya produkt + farbe + groesse ile belirtir. Tüm ürünler genelinde çağrı başına en fazla 500 satır.
lagerbestand senin stokundur. Sisteminin henüz onaylamadığı açık eveyamin siparişlerindeki adetler düşülerek kaydedilir – senin sayımın bunları bilemez.
Sayımının zamanını stand olarak gönder. Son alınandan daha eski bir stand içeren satır yok sayılır (veraltet, eskimiş).
Her satırın kendi sonucu vardır: ok, unveraendert, veraltet veya fehler. Hatalı bir satır diğerlerini durdurmaz.
503 busy durumunda hiçbir şey kaydedilmemiştir; isteği Retry-After saniye sonra tekrarla.

Nasıl ilerlenir

GET /stock ile bir kez sayfa sayfa çek ve ürünlerini varyantlarla eşleştir, tercihen sku ile.
Her stok değişikliğinde veya örneğin beş dakikada bir, değişen satırlar ve stand ile PATCH /stock gönder.
Yeni siparişleri al ve onayla – ancak o zaman açık sayılmaktan çıkarlar.

Siparişler ve dropshipping

Senin kalemlerini içeren ödenmiş siparişleri alır, onaylar ve gönderiyi bildirirsin. Aynı siparişteki diğer satıcıların kalemleri sana gösterilmez.

GET /orders/new – sisteminin henüz onaylamadığı ödenmiş siparişler, en eskisi önce. Bir sipariş sen onaylayana kadar orada kalır; bir yanıt kaybolursa bir sonraki çağrıda yeniden gelir.
POST /orders/{id}/acknowledge – sistemin siparişi aldı. POST /orders/acknowledge ile bir seferde en fazla 100.
Kargo firması ve takip numarasıyla POST /orders/{id}/fulfill – kalemler “Versendet” (kargoya verildi) olur ve alıcı takip bağlantısını içeren bir e-posta alır.
GET /orders?geaendert_seit=… – sonradan gerçekleşen iptaller ve iadeler. Son geaendert_am değerini sakla ve biraz örtüşmeyle yeniden sor.

POST /api/v1/orders/1042/fulfill

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

{id}, eveyamin sipariş kimliği veya sipariş numarasıdır (bestellnummer).
Kargo firmaları: DHL, DPD, Hermes, GLS, UPS, Deutsche Post veya Sonstige (diğer – o zaman kendi tracking_url adresinle).
Birden fazla koli: her takip numarası için bir çağrı, kolinin positionen değeriyle. Aynı takip numarası yeniden gönderilirse hiçbir şey değişmez ve ikinci bir e-posta gitmez.
Teslimat adresinde ad, adres ve telefon vardır, ancak e-posta adresi yoktur: alıcıyla eveyamin iletişim kurar.

Dropshipping: tedarikçine yalnızca bestellungen:lesen ve bestellungen:versenden yetkilerine sahip kendi anahtarını ver. Böylece ne ürünleri ne de stoku görür. Alıcı verilerini nasıl kullandığı dahil, tedarikçinden sen sorumlu kalırsın – bkz. Şartlar ve Koşullar ve Gizlilik Politikası.

Test ortamı

Geliştirme için https://staging--eveyamin.netlify.app adresinde bir test ortamı vardır. Kendi verileri ve kendi anahtarları (evy_test_…) vardır ve alıcılara e-posta göndermez.

https://staging--eveyamin.netlify.app adresinde kaydol ve info@eveyamin.com adresine yaz – hesabını test mağazası olarak ayarlarız.
Orada Ayarlar → API erişimi altında bir test anahtarı oluştur.
API üzerinden ürün oluştur ve test siparişleri ver.

Test siparişi

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

POST /sandbox/orders varyantlarından biri için ödenmiş bir sipariş oluşturur – gövde olmadan stoğu olan ilk varyant için ya da belirli olarak {"positionen": [{"sku": "…", "menge": 2}]} ile. Alıcı hayali Erika Mustermann'dır. Sipariş, gerçek bir siparişin geçtiği her adımdan geçer: /orders/new, onaylama, gönderiyi bildirme. Saatte en fazla 30. Aynı düğme test ortamında API erişimi altında da var; canlı mağazada böyle bir çağrı yoktur.

Test ortamı bir arşiv değildir: verileri her an sıfırlanabilir.

Hatalar

Hatalar her zaman aynı biçimdedir:

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

code değerini değerlendir: kalıcıdır ve İngilizcedir. nachricht (mesaj) Almancadır ve değişebilir; feld (alan) ilgili alanın JSON yoludur ya da null.

Durum	Anlamı
200 / 201	Tamam; yeni oluşturulan bir ürün veya test siparişi için 201
202	Kabul edildi, görseller hâlâ yükleniyor (iş)
400	Geçerli bir JSON değil veya parametreler geçersiz
401	Anahtar yok ya da geçersiz veya iptal edilmiş
403	Yetki eksik veya mağaza henüz onaylanmadı
404	Bulunamadı – ya da senin değil
409	Bir anahtar veya durumla çakışma (örn. Übergeordnete SKU zaten kullanımda)
422	Geçersiz gövde
429	Çok fazla istek
500 / 503	Bizim tarafımızda hata veya kısa süreli kesinti – daha sonra tekrar dene

Her çağrı

Kod	Durum	Anlamı
`invalidJson`	400	İstek gövdesi geçerli bir JSON değil.
`invalidQuery`	400	`seite`, `pro_seite` veya `geaendert_seit` geçersiz.
`keyMissing`	401	`Authorization: Bearer …` başlığında anahtar yok.
`keyInvalid`	401	Anahtar bilinmiyor veya iptal edilmiş ya da hesap etkin değil.
`keyWrongEnvironment`	401	Canlı mağazada bir test anahtarı ya da tam tersi.
`scopeMissing`	403	Anahtarın bu çağrı için gereken yetkisi yok.
`registrationNotApproved`	403	Mağaza kaydı henüz onaylanmadı (siparişler: mağaza henüz yayında değil).
`apiNotEnabled`	403	API mağazan için henüz etkinleştirilmedi.
`notFound`	404	Bilinmeyen yol.
`bodyTooLarge`	413	İstek çok büyük.
`rateLimited`	429	Çok fazla istek; `Retry-After` kaç saniye diyorsa o kadar bekle.
`internal`	500	Bizim tarafımızda beklenmeyen bir hata; daha sonra tekrar dene.
`unavailable`	503	Hizmet kısa süreliğine kullanılamıyor; `Retry-After` süresinden sonra tekrar dene.

Ürünler

Kod	Durum	Anlamı
`productNotFound`	404	Sana ait böyle bir ürün yok.
`jobNotFound`	404	Sana ait böyle bir iş yok.
`productExists`	409	Übergeordnete SKU zaten var; yanıt ürünü belirtir. PUT kullan.
`productArchived`	409	Ürün arşivlenmiş; kontrol panelinden geri yükle.
`productBlocked`	409	Ürün engellenmiş ve değiştirilemez.
`productMeterware`	409	Metre ile satılan ürünler henüz API'de yok.
`parentSkuDuplicate`	409	Bu Übergeordnete SKU'yu zaten kullanıyorsun.
`imagesFailed`	422	Ürünün hiçbir görseli yüklenemedi.
`writeFailed`	500	Ürün kaydedilemedi; daha sonra tekrar dene.
`tooManyVariants`	422	İzin verilenden fazla varyant.
`invalidValue`	422	Bir değerin biçimi yanlış.

Stok

Kod	Durum	Anlamı
`invalidBody`	422	`{ "positionen": [ … ] }` bekleniyor (ya da çağrının biçimi).
`noLines`	422	`positionen` boş.
`tooManyLines`	422	Çok fazla satır; birkaç isteğe böl.
`busy`	503	Stok şu anda başka bir yerde değiştiriliyor; hiçbir şey kaydedilmedi, tekrar dene.
`invalidLine`	satırda	Satır bir nesne değil.
`identifierMissing`	satırda	Ne `sku` ne de `produkt` + `farbe` + `groesse` var.
`stockInvalid`	satırda	`lagerbestand` izin verilen bir tam sayı değil.
`standInvalid`	satırda	`stand` saat dilimi içeren bir ISO 8601 zamanı değil.
`standInFuture`	satırda	`stand` gelecekte.
`variantNotFound`	satırda	Eşleşen etkin bir varyant yok.
`keyMismatch`	satırda	SKU, satırın diğer değerlerinden farklı bir kombinasyona ait.
`duplicateLine`	satırda	Aynı varyant daha önceki bir satırda zaten var.

Siparişler ve gönderim

Kod	Durum	Anlamı
`orderNotFound`	404	Senin kalemlerini içeren böyle ödenmiş bir sipariş yok.
`noEntries`	422	`bestellungen` boş.
`tooManyEntries`	422	Tek istekte çok fazla sipariş.
`invalidEntry`	satırda	Ne sipariş kimliği ne de sipariş numarası.
`orderNotShippable`	409	Yalnızca ödenmiş siparişler gönderilebilir.
`nothingToShip`	409	Kalemlerinden hiçbiri artık “In Bearbeitung” (işleniyor) durumunda değil.
`invalidCarrier`	422	Bilinmeyen kargo firması.
`invalidTrackingNumber`	422	Takip numarası: A–Z, 0–9 ve - karakterlerinden 4–40 karakter.
`invalidTrackingUrl`	422	`tracking_url` bir https bağlantısı değil.
`lineNotFound`	422	Bu siparişteki kalemlerinden hiçbiri bu kimliğe sahip değil.
`lineNotShippable`	422	Kalem artık “In Bearbeitung” durumunda değil.
`lineInOtherShipment`	422	Kalem zaten başka bir takip numarasıyla gönderildi.

Test ortamı

Kod	Durum	Anlamı
`noStock`	422	Test siparişi için stoğu olan bir varyant yok.
`sandboxLimit`	429	Son bir saatte çok fazla test siparişi.

Uyarılar

Kod	Durum	Anlamı
`stockIgnored`	uyarı	Satıştaki bir varyantın stoğu alınmadı; bunun için stok çağrısını kullan.
`valueMapped`	uyarı	Değer, eşleştirmen üzerinden alındı.

Ürün kontrolleri

Ürünler CSV içe aktarımındaki gibi kontrol edilir. Bu kodlar fehler içinde (anahtar çakışmalarında 409, aksi halde 422) veya uyarı olarak gelir. Mesajların kendisi Almancadır; burada Türkçeleri verilmiştir:

Kod	Durum	Anlamı
`required`	422	“…” zorunlu bir alandır.
`tooLong`	422	“…” çok uzun (en fazla … karakter).
`tooShort`	422	“…” çok kısa (en az … karakter).
`numberInvalid`	422	“…” geçerli bir sayı değil.
`priceRange`	422	“…”, … ile … arasında değil.
`stockInvalid`	422	“…” geçerli bir stok değil (0 ile … arasında tam sayı).
`categoryUnknown`	422	Bilinmeyen kategori “…”.
`categoryIncomplete`	422	“…” kategorisi eksik – lütfen en alt seviyeye kadar belirt.
`categoryNotOffered`	422	“…” kategorisi artık sunulmuyor.
`colorUnknown`	422	Bilinmeyen renk “…”.
`sizeUnknown`	422	Bilinmeyen beden “…”.
`sizeNotInCategory`	422	“…” bedeni “…” kategorisinde sunulmuyor.
`duplicateCombination`	422	… kombinasyonu zaten ⁦varianten[…]⁩ içinde var.
`priceVariesByColor`	422	… için fiyat ⁦varianten[…]⁩ değerinden farklı. Fiyatlar yalnızca bedene göre değişebilir, renge göre değil.
`discountAboveBase`	422	İndirimli fiyat (… €) en düşük fiyatın (… €) üzerinde.
`imageUrlInvalid`	422	“…” geçerli bir görsel adresi değil (https://…).
`tooManyImages`	422	… görsel – ürün başına en fazla ….
`noImages`	422	Lütfen her ürün için en az bir görsel URL’si gir.
`skuDuplicateInFile`	422	“…” SKU’su zaten ⁦varianten[…]⁩ içinde kullanılıyor.
`skuTaken`	409	“…” SKU’su zaten başka bir ürününe ait.
`eanInvalid`	422	“…” geçerli bir EAN değil (geçerli kontrol basamaklı 8, 12, 13 veya 14 rakam).
`ambiguousMatch`	409	“…” birden fazla mevcut ürünle eşleşiyor (ürün numarası …).
`parentSkuLocked`	409	… ürününün zaten “…” Übergeordnete SKU’su var. Mevcut bir Übergeordnete SKU’yu ürün formunda değiştirebilirsin.
`parentSkuOfOther`	409	“…” zaten … ürününe ait, ancak eveyamin-Artikelnummer … ürününe ait. Lütfen başka bir Übergeordnete SKU kullan.
`categoryFixed`	uyarı	Kategori “…” olarak alındı.
`colorFixed`	uyarı	“…” rengi “…” olarak alındı.
`sizeFixed`	uyarı	“…” bedeni “…” olarak alındı.
`imageFailed`	uyarı	Görsel alınmadı (…): …

Referans

Her çağrı, parametreleri ve alanlarıyla birlikte, doğrudan arayüzün kendisinden üretilir; açıklamalar API gibi Almancadır. Postman, Insomnia veya kod üreticileri için OpenAPI dosyası var.

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.

Yetki: geçerli herhangi bir anahtar

Yanıtlar

200 Der Schlüssel gilt. – Ping

Alan	Tür	Zorunlu	Açıklama
`ok`	true	evet
`umgebung`	string	evet	live = Shop, test = Testumgebung.Değerler: live, test
`haendler_id`	string	evet	Deine Händler-ID bei eveyamin.
`schluessel`	object	evet
`schluessel.name`	string	evet
`schluessel.praefix`	string	evet	Anfang des Schlüssels, z. B. evy_live_Ab3x.
`schluessel.berechtigungen`	string[]	evet	Değerler: 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.

Yetki: geçerli herhangi bir anahtar

Yanıtlar

200 Die aktuellen Listen. – Taxonomie

Alan	Tür	Zorunlu	Açıklama
`kategorien`	object[]	evet	Jede Kategorie, unter der ein Produkt stehen kann.
`kategorien[].pfad`	string	evet	Vollständiger Kategoriepfad, mit „ > “ getrennt, z. B. „eve-Home > Bettwäsche > Bettwäsche-Sets“.
`kategorien[].groessen`	string[]	evet	Größen, die diese Kategorie anbietet.
`farben`	string[]	evet	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.

Yetki: produkte:schreiben

Gövde – ProduktAnfrage

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

Yanıtlar

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

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

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

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

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.

Yetki: produkte:schreiben

Parametreler

Alan	Tür	Zorunlu	Açıklama
`seite (query)`	integer	hayır	Seite, ab 1.
`pro_seite (query)`	integer	hayır	Produkte pro Seite, höchstens 100.
`geaendert_seit (query)`	string (date-time)	hayır	Nur Produkte, die danach geändert wurden (ISO 8601 mit Zeitzone).

Yanıtlar

200 Eine Seite Produkte. – ProduktListe

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

Yetki: produkte:schreiben

Parametreler

Alan	Tür	Zorunlu	Açıklama
`id (path)`	string	evet	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.

Yanıtlar

200 Das Produkt. – Produkt

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

Yetki: produkte:schreiben

Parametreler

Alan	Tür	Zorunlu	Açıklama
`id (path)`	string	evet	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.

Gövde – ProduktAnfrage

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

Yanıtlar

200 Aktualisiert, oder unveraendert. – ProduktErgebnis

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

201 Angelegt. – ProduktErgebnis

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

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

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

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

Yetki: produkte:schreiben

Parametreler

Alan	Tür	Zorunlu	Açıklama
`id (path)`	string	evet	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.

Yanıtlar

200 Archiviert. – ProduktArchiviert

Alan	Tür	Zorunlu	Açıklama
`ergebnis`	string	evet	Değerler: archiviert, bereits_archiviert
`produkt`	object	evet
`produkt.id`	string	evet
`produkt.artikelnummer`	string	evet
`produkt.uebergeordnete_sku`	string \| null	evet
`produkt.status`	string	evet	Değerler: 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).

Yetki: produkte:schreiben

Parametreler

Alan	Tür	Zorunlu	Açıklama
`id (path)`	string	evet	Auftrags-ID aus der 202-Antwort.

Yanıtlar

200 Der Auftrag. – Auftrag

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

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

Yetki: bestand:schreiben

Parametreler

Alan	Tür	Zorunlu	Açıklama
`seite (query)`	integer	hayır	Seite, ab 1.
`pro_seite (query)`	integer	hayır	Varianten pro Seite, höchstens 500.

Yanıtlar

200 Eine Seite Varianten. – BestandListe

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

Yetki: bestand:schreiben

Gövde – BestandAnfrage

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

Yanıtlar

200 Ergebnis je Zeile. – BestandErgebnis

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

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

Yetki: bestand:schreiben

Parametreler

Alan	Tür	Zorunlu	Açıklama
`id (path)`	string	evet	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.
`seite (query)`	integer	hayır	Seite, ab 1.
`pro_seite (query)`	integer	hayır	Varianten pro Seite, höchstens 500.

Yanıtlar

200 Die Varianten des Produkts. – BestandListe

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

Yetki: bestand:schreiben

Parametreler

Alan	Tür	Zorunlu	Açıklama
`id (path)`	string	evet	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.

Gövde – ProduktBestandAnfrage

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

Yanıtlar

200 Ergebnis je Zeile. – BestandErgebnis

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

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.

Yetki: bestellungen:lesen

Parametreler

Alan	Tür	Zorunlu	Açıklama
`seite (query)`	integer	hayır	Seite, ab 1.
`pro_seite (query)`	integer	hayır	Bestellungen pro Seite, höchstens 100.

Yanıtlar

200 Eine Seite Bestellungen. – BestellListe

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

Yetki: bestellungen:lesen

Parametreler

Alan	Tür	Zorunlu	Açıklama
`geaendert_seit (query)`	string (date-time)	hayır	Zeitpunkt nach ISO 8601 mit Zeitzone, z. B. 2026-10-07T09:15:00Z.
`seite (query)`	integer	hayır	Seite, ab 1.
`pro_seite (query)`	integer	hayır	Bestellungen pro Seite, höchstens 100.

Yanıtlar

200 Eine Seite Bestellungen. – BestellListe

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

Yetki: bestellungen:lesen

Parametreler

Alan	Tür	Zorunlu	Açıklama
`id (path)`	string	evet	eveyamin-Bestell-ID oder Bestellnummer.

Yanıtlar

200 Die Bestellung mit deinen Positionen. – Bestellung

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

Yetki: bestellungen:lesen

Parametreler

Alan	Tür	Zorunlu	Açıklama
`id (path)`	string	evet	eveyamin-Bestell-ID oder Bestellnummer.

Yanıtlar

200 Bestätigt. – Bestaetigung

Alan	Tür	Zorunlu	Açıklama
`id`	string	evet
`bestellnummer`	integer	evet	(-9007199254740991–9007199254740991)
`bestaetigt_am`	string	evet	Wann die Bestellung zum ersten Mal bestätigt wurde. ISO 8601, UTC.
`bereits_bestaetigt`	boolean	evet	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.

Yetki: bestellungen:lesen

Gövde – BestaetigungAnfrage

Alan	Tür	Zorunlu	Açıklama
`bestellungen`	string \| integer[]	evet	Bestell-IDs oder Bestellnummern.

Yanıtlar

200 Ergebnis je Eintrag. – BestaetigungErgebnis

Alan	Tür	Zorunlu	Açıklama
`zusammenfassung`	object	evet
`zusammenfassung.ok`	integer	evet	(-9007199254740991–9007199254740991)
`zusammenfassung.bereits_bestaetigt`	integer	evet	(-9007199254740991–9007199254740991)
`zusammenfassung.fehler`	integer	evet	(-9007199254740991–9007199254740991)
`bestellungen`	object[]	evet
`bestellungen[].zeile`	integer	evet	Index in bestellungen, ab 0. (-9007199254740991–9007199254740991)
`bestellungen[].status`	string	evet	Değerler: ok, bereits_bestaetigt, fehler
`bestellungen[].id`	string	hayır
`bestellungen[].bestellnummer`	integer	hayır	(-9007199254740991–9007199254740991)
`bestellungen[].bestaetigt_am`	string	hayır	Wann die Bestellung zum ersten Mal bestätigt wurde. ISO 8601, UTC.
`bestellungen[].fehler`	object	hayır
`bestellungen[].fehler.code`	string	evet
`bestellungen[].fehler.feld`	string \| null	evet
`bestellungen[].fehler.nachricht`	string	evet

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.

Yetki: bestellungen:versenden

Parametreler

Alan	Tür	Zorunlu	Açıklama
`id (path)`	string	evet	eveyamin-Bestell-ID oder Bestellnummer.

Gövde – VersandAnfrage

Alan	Tür	Zorunlu	Açıklama
`versanddienstleister`	string	evet	Değerler: DHL, DPD, Hermes, GLS, UPS, Deutsche Post, Sonstige
`sendungsnummer`	string	evet	Gespeichert ohne Leerzeichen und in Großbuchstaben: 4–40 Zeichen aus A–Z, 0–9 und -.
`tracking_url`	string \| null	hayır	Eigener https-Link. Ohne ihn baut eveyamin den Link des Versanddienstleisters (bei „Sonstige“ gibt es keinen).
`positionen`	string[]	hayır	position_id der Positionen im Paket. Ohne: alle deine Positionen „In Bearbeitung“.

Yanıtlar

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

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

Sürümler ve iletişim

API sürümlüdür (/api/v1). Yeni alanlar ve çağrılar v1 içinde eklenir – bu yüzden tanımadığın alanları yok say. Mevcut bağlantıları bozacak her şey yalnızca v2'de gelir ve önceden duyurulur.

Bağlantıyla ilgili sorular: info@eveyamin.com.

Teknik destek

Yukarıdaki bilgiler, teknik ekibinin entegrasyonu tamamlaması için yeterli olmalıdır. Ek desteğe ihtiyacın olursa teknoloji ortağımız entegrasyon konusunda sana memnuniyetle yardımcı olur.