API ya firoşkaran

Pergala xwe ya embarê, nermalava firotgehê an dabînkerê xwe yê dropshipping rasterast bi firotgeha xwe ya eveyamin ve girê bide: berheman çêke û nû bike, embarê di nav çend çirkeyan de hevdem bike, fermanên dayî bîne û şandinan ragihîne.

Mifteya API çêke Pelê OpenAPI English version

Destpêk

API ya firoşkaran navrûyeke REST e ku bi JSON li https://eveyamin.com/api/v1 dixebite. Navên qadan û nirx bi almanî ne – kategorî, reng, mezinahî û rewş tam wek ku di firotgehê de tomarkirî ne. Girêdanê pêşdebirê te, ajansa te an xizmeteke navber (middleware) ava dike; ji bo pergalên embarê yên taybet pêvekên amade tune ne.

Miftê çêke

Di bin Mîheng → Gihîştina API de mifteyekê çêke û tenê wan destûran hilbijêre ku girêdan hewce dike.
Miftê yekser kopî bike û li cihekî ewle biparêze – ew tenê vê carê tê nîşandan.
Wê bi her daxwazê re di sernivîsa Authorization: Bearer <mifte> de bişîne.

Destûr	Destûrê dide
`produkte:schreiben`	Çêkirin, guhertin, xwendin û arşîvkirina berheman
`bestand:schreiben`	Xwendin û danîna embarê
`bestellungen:lesen`	Anîn û pejirandina fermanan (gava firotgeha te zindî bibe)
`bestellungen:versenden`	Ragihandina şandinan bi hejmara şopandinê

Cihê miftan li ser serverê ye, qet ne di rûpeleke webê an sepanekê de. Herî zêde 10 mifteyên te dikarin hebin – ji bo her girêdanê mifteyeke cuda bi kar bîne, da ku tu karibî yekê bi tenê betal bikî. Heke dibe ku mifteyek ketibe destên çewt, wê yekser betal bike.

Banga yekem

Daxwaz

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

Bersiv

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

Zindî û ceribandin

Mifte bi evy_live_ (firotgeh) an evy_test_ (jîngeha ceribandinê) dest pê dikin û tenê li cihê ku hatine çêkirin dixebitin. Mifteyeke ji jîngeha din 401 keyWrongEnvironment distîne.

Nirxên almanî

Kategorî bi rêya xwe ya tevahî tên (eve-Home > Bettwäsche > Bettwäsche-Sets), reng û mezinahî tam wek di firotgehê de. GET /api/v1/taxonomy her kategoriyê bi mezinahiyên wê û her rengî vedigerîne. API cudahiyên biçûk bixwe rast dike (weiss → Weiß, 200x200 → 200 x 200 cm) û wan wek nîşe radigihîne. Navên taybet ên pergala xwe ya embarê carekê di împorta CSV de li hev bîne; ev hevgirtin ji bo API jî derbasdar e.

Sînor

Çi	Sînor
Daxwaz ji bo her miftê	120 di deqîqeyê de, paşê 429 bi `Retry-After`
Mezinahiya daxwazê	1024 KB
Rêz ji bo her banga embarê	500
Varyant ji bo her berhemê	500
Wêne ji bo her berhemê	20
Berhem di her rûpelê de	100
Ferman di her rûpelê de	100

Her bersiv JSON e û qet nayê veşartin (cache). Bangên ji gerokê (CORS) nayên destûrdan.

Berhem

Berhemek ji agahiyên xwe û varyantên xwe (reng × mezinahî) pêk tê. Rêzik ew in ên forma berhemê û împorta CSV: tiştê ku ew red dikin, API jî red dike – bi heman kodan. Navên qadan navên stûnên şablona CSV ne.

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, ango SKU ya jorîn) mifteya te ya berhemê ye û di firotgeha te de yekta ye. Paşê tu bi wê xwe digihînî berhemê: /products/BW-SATIN-01.
kategorie rêya tevahî ye; divê her groesse girêdayî kategoriyê be.
preis ji bo her varyantê ye. Biha tenê li gorî mezinahiyê dikarin cuda bin, ne li gorî rengî; ya herî kêm bihayê bingehîn e. rabattpreis (bihayê daxistinê) ji bo tevahiya berhemê ye; bê wê daxistin tune ye.
Hejmar dikarin wek nivîs jî werin, bi şêweya almanî an îngilîzî ("59,90").
sku û ean ji bo her varyantê vebijarkî ne. Heke tu qadê neşînî, koda tomarkirî dimîne; null wê jê dibe. EAN hewceyê hejmareke kontrolê ya derbasdar e.
bild_urls: navnîşanên https. Wêne tên daxistin û li cem me tên hilanîn; galerî dikare tenê li ser varyanta yekem jî be.
versandkosten (lêçûnên şandinê) vebijarkî ye: bê wê, berhemeke nû nirxa te ya standard distîne, berhemeke heyî nirxa xwe diparêze.

Çêkirin, guhertin, xwendin

Bang	Encam
`POST /products`	Berhemê çêdike: 201. Heke Übergeordnete SKU jixwe hebe: 409 `productExists` bi berhema heyî re.
`PUT /products/{id}`	Tevahiya berhemê diguherîne; varyantên ku nehatine şandin tên arşîvkirin. Heke `{id}` hêj tune be û naverok `{id}` wek `uebergeordnete_sku` bide, berhem tê çêkirin (upsert); wekî din 404.
`GET /products/{id}`	Berhemê tam bi wê şêweyê dide ku PUT distîne, plus qadên tenê-xwendinê (`id`, `artikelnummer`, `status`, `geaendert_am`, `variant_id`). Tu dikarî wê wek xwe paş ve bişînî.
`GET /products`	Hemû berhemên te, guhertina herî kevn pêşî, yên arşîvkirî jî tê de – bi `geaendert_seit` tenê yên ku ji wê demê ve hatine guhertin.
`DELETE /products/{id}`	Berhemê arşîv dike; banga duyem tiştekî naguherîne.

{id} dikare nasnameya berhemê ya eveyamin, Übergeordnete SKU ya te an hejmara berhemê ya eveyamin (artikelnummer) be. Berhemeke ku di formê de hatiye çêkirin, Übergeordnete SKU ya xwe carekê bi PUT /products/{artikelnummer} û uebergeordnete_sku di naverokê de distîne; Übergeordnete SKU-yeke heyî tenê di forma berhemê de tê guhertin.

Encam

ergebnis dibe angelegt (hate çêkirin), aktualisiert (hate nûkirin) an unveraendert (nehate guhertin). Gava tiştek neguhere, tiştek nayê nivîsandin û ji nû ve nayê wergerandin – ji ber vê yekê hevdemkirina tevahî ya hemû berheman hema hema bê lêçûn e. hinweise (nîşe) nivîsandinên rastkirî û wêneyên ku nehatin barkirin nîşan dide. Berhemên nû pêşî tên wergerandin (rewş “Wird übersetzt”) û paşê diçin ser xetê.

Wêne

Wêne di dema bangê de tên daxistin. Heke ev pir dirêj bikişîne, API bi karekî (job) bersiva 202 dide (Location: /api/v1/jobs/{id}). Karê bipirse heta ku bibe fertig (qediya); berhem tenê gava wêneyên wê amade bin tê tomarkirin.
Her navnîşaneke wêneyê carekê tê daxistin. Ji ber vê wêneyekî guherî navnîşaneke nû hewce dike, mînak bi ?v=2.
Heke daxwazeke nûtir ji bo heman berhemê were, karê vekirî dibe ersetzt (bi yekî nûtir hate guhertin).

Embar di banga berhemê de

Ji bo varyantên ku jixwe di firotinê de ne, banga berhemê embarê naguherîne – ev karê banga embarê ye. lagerbestand-eke cuda wek nîşeya stockIgnored vedigere. Berhemên nû û varyantên nû embara şandî distînin.

Arşîvkirî, astengkirî, bi metreyan

Berhemên arşîvkirî di daşbordê de vegerîne; PUT û POST bi 409 productArchived bersiv didin. Berhemên astengkirî: 409 productBlocked. Berhemên ku bi metreyan tên firotin (qumaş) hêj di API de tune ne: 409 productMeterware.

Hevdemkirina embarê

Banga embarê tenê embarê diguherîne, qet ne berhemê. Pergala te ya embarê bi wê embara eveyamin nûjen dihêle, da ku gava tu li ser çend kanalan difiroşî tiştek du caran neyê firotin.

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

Rêzek varyantekê bi sku, an bi produkt + farbe + groesse destnîşan dike. Herî zêde 500 rêz di her bangê de, ji bo hemû berheman bi hev re.
lagerbestand embara te ye. Ew kêmî wan perçeyan tê tomarkirin ku di fermanên vekirî yên eveyamin de ne û pergala te hêj nepejirandine – hejmartina te nikare ji wan haydar be.
stand, ango dema hejmartina xwe bişîne. Rêzeke ku stand-a wê ji ya dawî ya hatî wergirtin kevntir be tê paşguhkirin (veraltet, kevnbûyî).
Her rêz encama xwe heye: ok, unveraendert, veraltet an fehler. Rêzeke bi çewtî yên din nasekinîne.
Di rewşa 503 busy de tiştek nehatiye tomarkirin; daxwazê piştî Retry-After çirkeyan dubare bike.

Çawa dest pê bikî

Carekê GET /stock rûpel bi rûpel bîne û berhemên xwe bi varyantan re li hev bîne, çêtir bi sku.
Di her guhertina embarê de, an mînak her pênc deqîqeyan carekê, PATCH /stock bi rêzên guherî û stand bişîne.
Fermanên nû bîne û bipejirîne – tenê wê demê ew êdî wek vekirî nayên hejmartin.

Ferman û dropshipping

Tu fermanên dayî yên ku rêzên te tê de ne tînî, wan dipejirînî û şandinê radigihînî. Rêzên firoşkarên din ên di heman fermanê de ji te re nayên nîşandan.

GET /orders/new – fermanên dayî yên ku pergala te hêj nepejirandine, ya herî kevn pêşî. Fermanek heta ku tu wê bipejirînî li wir dimîne; heke bersivek winda bibe, di banga din de dîsa tê.
POST /orders/{id}/acknowledge – pergala te ew wergirt. Bi POST /orders/acknowledge herî zêde 100 bi carekê.
POST /orders/{id}/fulfill bi şirketa şandinê û hejmara şopandinê – rêz dibin “Versendet” (hate şandin), û kirrîar e-nameyek bi girêdana şopandinê distîne.
GET /orders?geaendert_seit=… – betalkirin û vegerandinên pereyan ên ku paşê çêdibin. geaendert_am-a dawî bîne bîra xwe û dîsa ji demeke hinekî zûtir bipirse.

POST /api/v1/orders/1042/fulfill

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

{id} nasnameya fermanê ya eveyamin an hejmara fermanê ye (bestellnummer).
Şirketên şandinê: DHL, DPD, Hermes, GLS, UPS, Deutsche Post an Sonstige (yên din – wê demê bi tracking_url-a xwe).
Çend pakêt: ji bo her hejmara şopandinê bangek, bi positionen-ên wê pakêtê. Heman hejmara şopandinê dîsa tiştekî naguherîne û e-nameya duyem naşîne.
Navnîşana radestkirinê nav, navnîşan û telefonê dihewîne, lê navnîşana e-nameyê nahewîne: eveyamin bi kirrîar re têkilî datîne.

Dropshipping: mifteyeke taybet bide dabînkerê xwe ku tenê bestellungen:lesen û bestellungen:versenden tê de hebin. Wê demê ew ne berheman dibîne û ne jî embarê. Berpirsiyariya wî li ser te dimîne, di nav de çawa ew bi daneyên kirrîaran re tevdigere – binêre Mercên Bikaranînê û Parastina Daneyan.

Jîngeha ceribandinê

Ji bo pêşdebirinê jîngeheke ceribandinê li https://staging--eveyamin.netlify.app heye. Daneyên wê û miftên wê yên taybet hene (evy_test_…), û ew ji kirrîaran re e-nameyan naşîne.

Li https://staging--eveyamin.netlify.app qeyd bibe û ji info@eveyamin.com re binivîse – em hesabê te wek firotgeheke ceribandinê saz dikin.
Li wir di bin Mîheng → Gihîştina API de mifteyeke ceribandinê çêke.
Bi riya API berheman çêke û fermanên ceribandinê bide.

Fermana ceribandinê

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

POST /sandbox/orders ji bo yek ji varyantên te fermaneke dayî çêdike – bê naverok ji bo varyanta yekem a bi embar, an bi taybetî bi {"positionen": [{"sku": "…", "menge": 2}]}. Kirrîar Erika Mustermann a xeyalî ye. Ferman hemû gavên fermaneke rastîn derbas dike: /orders/new, pejirandin, ragihandina şandinê. Herî zêde 30 di saetekê de. Heman bişkok di jîngeha ceribandinê de di bin Gihîştina API de jî heye; firotgeha zindî bangeke wiha nîne.

Jîngeha ceribandinê ne arşîv e: daneyên wê dikarin her dem ji nû ve werin sifirkirin.

Çewtî

Şêweya çewtiyan her tim heman e:

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

Li code binêre: ew naguhere û bi îngilîzî ye. nachricht (peyam) bi almanî ye û dikare biguhere; feld (qad) rêya JSON a qada têkildar e, an null.

Rewş	Wate
200 / 201	Qediya; 201 ji bo berhemeke nû hatî çêkirin an fermaneke ceribandinê
202	Hate qebûlkirin, wêne hêj tên barkirin (kar)
400	Ne JSON-a derbasdar e, an parametre ne derbasdar in
401	Mifte tune ye, an mifte ne derbasdar e an hatiye betalkirin
403	Destûr kêm e, an firotgeh hêj nehatiye pejirandin
404	Nehate dîtin – an ne ya te ye
409	Pevçûn bi mifteyekê an rewşekê re (mînak Übergeordnete SKU jixwe tê bikaranîn)
422	Naveroka ne derbasdar
429	Pir zêde daxwaz
500 / 503	Çewtî li aliyê me an ji bo demeke kurt ne berdest – paşê dîsa biceribîne

Her bang

Kod	Rewş	Wate
`invalidJson`	400	Naveroka daxwazê ne JSON-a derbasdar e.
`invalidQuery`	400	`seite`, `pro_seite` an `geaendert_seit` ne derbasdar e.
`keyMissing`	401	Di sernivîsa `Authorization: Bearer …` de mifte tune ye.
`keyInvalid`	401	Mifte nenas e an hatiye betalkirin, an jî hesab ne çalak e.
`keyWrongEnvironment`	401	Mifteyeke ceribandinê di firotgeha zindî de, an berevajî.
`scopeMissing`	403	Destûra ku ev bang hewce dike di miftê de tune ye.
`registrationNotApproved`	403	Qeyda firotgehê hêj nehatiye pejirandin (ferman: firotgeh hêj ne zindî ye).
`apiNotEnabled`	403	API hêj ji bo firotgeha te nehatiye vekirin.
`notFound`	404	Rêya nenas.
`bodyTooLarge`	413	Daxwaz pir mezin e.
`rateLimited`	429	Pir zêde daxwaz; bi qasî çirkeyên ku `Retry-After` dibêje bisekine.
`internal`	500	Çewtiyeke nediyar li aliyê me; paşê dîsa biceribîne.
`unavailable`	503	Xizmet ji bo demeke kurt ne berdest e; piştî `Retry-After` dîsa biceribîne.

Berhem

Kod	Rewş	Wate
`productNotFound`	404	Berhemeke te ya wiha tune ye.
`jobNotFound`	404	Karekî te yê wiha tune ye.
`productExists`	409	Übergeordnete SKU jixwe heye; bersiv berhemê nîşan dide. PUT bi kar bîne.
`productArchived`	409	Berhem arşîvkirî ye; wê di daşbordê de vegerîne.
`productBlocked`	409	Berhem astengkirî ye û nayê guhertin.
`productMeterware`	409	Berhemên ku bi metreyan tên firotin hêj di API de tune ne.
`parentSkuDuplicate`	409	Tu vê Übergeordnete SKU jixwe bi kar tînî.
`imagesFailed`	422	Tu wêneyekî berhemê nehat barkirin.
`writeFailed`	500	Berhem nehat tomarkirin; paşê dîsa biceribîne.
`tooManyVariants`	422	Ji destûrê zêdetir varyant.
`invalidValue`	422	Şêweya nirxekî şaş e.

Embar

Kod	Rewş	Wate
`invalidBody`	422	`{ "positionen": [ … ] }` tê hêvîkirin (an şêweya bangê).
`noLines`	422	`positionen` vala ye.
`tooManyLines`	422	Pir zêde rêz; wan li ser çend daxwazan parve bike.
`busy`	503	Embar niha li cihekî din tê guhertin; tiştek nehat tomarkirin, dîsa biceribîne.
`invalidLine`	di rêzê de	Rêz ne objekt e.
`identifierMissing`	di rêzê de	Ne `sku` heye û ne jî `produkt` + `farbe` + `groesse`.
`stockInvalid`	di rêzê de	`lagerbestand` ne hejmareke tam a destûrdayî ye.
`standInvalid`	di rêzê de	`stand` ne demeke ISO 8601 bi herêma demê re ye.
`standInFuture`	di rêzê de	`stand` di pêşerojê de ye.
`variantNotFound`	di rêzê de	Tu varyanteke çalak li hev nayê.
`keyMismatch`	di rêzê de	SKU ya kombînasyoneke din e, ne ya nirxên din ên rêzê.
`duplicateLine`	di rêzê de	Heman varyant jixwe di rêzeke berê de ye.

Ferman û şandin

Kod	Rewş	Wate
`orderNotFound`	404	Fermaneke dayî ya wiha bi rêzên te tune ye.
`noEntries`	422	`bestellungen` vala ye.
`tooManyEntries`	422	Di daxwazekê de pir zêde ferman.
`invalidEntry`	di rêzê de	Ne nasnameya fermanê ye û ne jî hejmara fermanê.
`orderNotShippable`	409	Tenê fermanên dayî dikarin bên şandin.
`nothingToShip`	409	Ji rêzên te tu yek êdî ne di rewşa “In Bearbeitung” (di pêvajoyê de) de ye.
`invalidCarrier`	422	Şirketa şandinê nenas e.
`invalidTrackingNumber`	422	Hejmara şopandinê: 4–40 tîp ji A–Z, 0–9 û -.
`invalidTrackingUrl`	422	`tracking_url` ne girêdaneke https e.
`lineNotFound`	422	Tu rêzeke te ya vê fermanê xwediyê vê nasnameyê nîne.
`lineNotShippable`	422	Rêz êdî ne di rewşa “In Bearbeitung” de ye.
`lineInOtherShipment`	422	Rêz jixwe bi hejmareke şopandinê ya din hatiye şandin.

Jîngeha ceribandinê

Kod	Rewş	Wate
`noStock`	422	Ji bo fermana ceribandinê tu varyanteke bi embar tune ye.
`sandboxLimit`	429	Di saeta borî de pir zêde fermanên ceribandinê.

Nîşe

Kod	Rewş	Wate
`stockIgnored`	nîşe	Embara varyanteke ku di firotinê de ye nehat wergirtin; ji bo vê banga embarê bi kar bîne.
`valueMapped`	nîşe	Nirx bi riya hevgirtina te hat wergirtin.

Kontrolên berhemê

Berhem wek di împorta CSV de tên kontrolkirin. Ev kod di fehler de (409 ji bo pevçûna miftan, wekî din 422) an wek nîşe tên. Peyam bixwe bi almanî ne; li vir bi kurdî ne:

Kod	Rewş	Wate
`required`	422	“…” qadeke pêwîst e.
`tooLong`	422	“…” pir dirêj e (herî zêde … karakter).
`tooShort`	422	“…” pir kurt e (herî kêm … karakter).
`numberInvalid`	422	“…” ne hejmareke derbasdar e.
`priceRange`	422	“…” ne di navbera … û … de ye.
`stockInvalid`	422	“…” ne stokeke derbasdar e (hejmareke tam ji 0 heta …).
`categoryUnknown`	422	Kategoriya nenas “…”.
`categoryIncomplete`	422	Kategoriya “…” ne temam e – ji kerema xwe heta asta herî jêrîn binivîse.
`categoryNotOffered`	422	Kategoriya “…” êdî nayê pêşkêşkirin.
`colorUnknown`	422	Rengê nenas “…”.
`sizeUnknown`	422	Mezinahiya nenas “…”.
`sizeNotInCategory`	422	Mezinahiya “…” di “…” de nayê pêşkêşkirin.
`duplicateCombination`	422	Kombînasyona … jixwe di ⁦varianten[…]⁩ de ye.
`priceVariesByColor`	422	Bihayê … ji ⁦varianten[…]⁩ cuda ye. Biha tenê li gorî mezinahiyê dikarin cuda bin, ne li gorî rengî.
`discountAboveBase`	422	Bihayê daxistinê (… €) ji bihayê herî kêm (… €) bilindtir e.
`imageUrlInvalid`	422	“…” ne navnîşaneke wêneyê ya derbasdar e (https://…).
`tooManyImages`	422	… wêne – ji bo her berhemê herî zêde ….
`noImages`	422	Ji kerema xwe ji bo her berhemê herî kêm URL-ya wêneyekî binivîse.
`skuDuplicateInFile`	422	SKU “…” jixwe di ⁦varianten[…]⁩ de ye.
`skuTaken`	409	SKU “…” jixwe ya berhemeke te ya din e.
`eanInvalid`	422	“…” ne EAN-eke derbasdar e (8, 12, 13 an 14 hejmar bi hejmara kontrolê ya rast).
`ambiguousMatch`	409	“…” li gel ji yekê zêdetir berhemên heyî li hev tê (hejmara berhemê …).
`parentSkuLocked`	409	Berhema … jixwe Übergeordnete SKU “…” heye. Übergeordnete SKU-yeke heyî di forma berhemê de biguherîne.
`parentSkuOfOther`	409	“…” jixwe ya berhema te … e, lê eveyamin-Artikelnummer ya … e. Ji kerema xwe Übergeordnete SKU-yeke din bikar bîne.
`categoryFixed`	nîşe	Kategorî wek “…” hate wergirtin.
`colorFixed`	nîşe	Reng “…” wek “…” hate wergirtin.
`sizeFixed`	nîşe	Mezinahî “…” wek “…” hate wergirtin.
`imageFailed`	nîşe	Wêne nehat wergirtin (…): …

Referans

Hemû bang bi parametre û qadên xwe, rasterast ji navrûyê bixwe hatine çêkirin; şirove wek API bi almanî ne. Ji bo Postman, Insomnia an çêkerên kodê pelê OpenAPI heye.

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.

Destûr: her mifteyeke derbasdar

Bersiv

200 Der Schlüssel gilt. – Ping

Qad	Cure	Mecbûrî	Şirove
`ok`	true	erê
`umgebung`	string	erê	live = Shop, test = Testumgebung.Nirx: live, test
`haendler_id`	string	erê	Deine Händler-ID bei eveyamin.
`schluessel`	object	erê
`schluessel.name`	string	erê
`schluessel.praefix`	string	erê	Anfang des Schlüssels, z. B. evy_live_Ab3x.
`schluessel.berechtigungen`	string[]	erê	Nirx: 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.

Destûr: her mifteyeke derbasdar

Bersiv

200 Die aktuellen Listen. – Taxonomie

Qad	Cure	Mecbûrî	Şirove
`kategorien`	object[]	erê	Jede Kategorie, unter der ein Produkt stehen kann.
`kategorien[].pfad`	string	erê	Vollständiger Kategoriepfad, mit „ > “ getrennt, z. B. „eve-Home > Bettwäsche > Bettwäsche-Sets“.
`kategorien[].groessen`	string[]	erê	Größen, die diese Kategorie anbietet.
`farben`	string[]	erê	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.

Destûr: produkte:schreiben

Naverok – ProduktAnfrage

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

Bersiv

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

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

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

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

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.

Destûr: produkte:schreiben

Parametre

Qad	Cure	Mecbûrî	Şirove
`seite (query)`	integer	na	Seite, ab 1.
`pro_seite (query)`	integer	na	Produkte pro Seite, höchstens 100.
`geaendert_seit (query)`	string (date-time)	na	Nur Produkte, die danach geändert wurden (ISO 8601 mit Zeitzone).

Bersiv

200 Eine Seite Produkte. – ProduktListe

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

Destûr: produkte:schreiben

Parametre

Qad	Cure	Mecbûrî	Şirove
`id (path)`	string	erê	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.

Bersiv

200 Das Produkt. – Produkt

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

Destûr: produkte:schreiben

Parametre

Qad	Cure	Mecbûrî	Şirove
`id (path)`	string	erê	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.

Naverok – ProduktAnfrage

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

Bersiv

200 Aktualisiert, oder unveraendert. – ProduktErgebnis

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

201 Angelegt. – ProduktErgebnis

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

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

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

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

Destûr: produkte:schreiben

Parametre

Qad	Cure	Mecbûrî	Şirove
`id (path)`	string	erê	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.

Bersiv

200 Archiviert. – ProduktArchiviert

Qad	Cure	Mecbûrî	Şirove
`ergebnis`	string	erê	Nirx: archiviert, bereits_archiviert
`produkt`	object	erê
`produkt.id`	string	erê
`produkt.artikelnummer`	string	erê
`produkt.uebergeordnete_sku`	string \| null	erê
`produkt.status`	string	erê	Nirx: 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).

Destûr: produkte:schreiben

Parametre

Qad	Cure	Mecbûrî	Şirove
`id (path)`	string	erê	Auftrags-ID aus der 202-Antwort.

Bersiv

200 Der Auftrag. – Auftrag

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

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

Destûr: bestand:schreiben

Parametre

Qad	Cure	Mecbûrî	Şirove
`seite (query)`	integer	na	Seite, ab 1.
`pro_seite (query)`	integer	na	Varianten pro Seite, höchstens 500.

Bersiv

200 Eine Seite Varianten. – BestandListe

Qad	Cure	Mecbûrî	Şirove
`seite`	integer	erê	(-9007199254740991–9007199254740991)
`pro_seite`	integer	erê	(-9007199254740991–9007199254740991)
`gesamt`	integer	erê	Varianten insgesamt. (-9007199254740991–9007199254740991)
`positionen`	object[]	erê
`positionen[].produkt_id`	string	erê
`positionen[].artikelnummer`	string	erê
`positionen[].uebergeordnete_sku`	string \| null	erê
`positionen[].sku`	string \| null	erê
`positionen[].ean`	string \| null	erê	EAN / GTIN der Variante, sonst null.
`positionen[].farbe`	string	erê
`positionen[].groesse`	string	erê
`positionen[].titel`	string	erê
`positionen[].lagerbestand`	integer	erê	Gespeicherter, kaufbarer Bestand. (-9007199254740991–9007199254740991)
`positionen[].offen`	integer	erê	Stück in offenen eveyamin-Bestellungen. (-9007199254740991–9007199254740991)
`positionen[].stand`	string \| null	erê	Zuletzt übernommener stand.
`positionen[].gesperrt`	boolean	erê	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.

Destûr: bestand:schreiben

Naverok – BestandAnfrage

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

Bersiv

200 Ergebnis je Zeile. – BestandErgebnis

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

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

Destûr: bestand:schreiben

Parametre

Qad	Cure	Mecbûrî	Şirove
`id (path)`	string	erê	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.
`seite (query)`	integer	na	Seite, ab 1.
`pro_seite (query)`	integer	na	Varianten pro Seite, höchstens 500.

Bersiv

200 Die Varianten des Produkts. – BestandListe

Qad	Cure	Mecbûrî	Şirove
`seite`	integer	erê	(-9007199254740991–9007199254740991)
`pro_seite`	integer	erê	(-9007199254740991–9007199254740991)
`gesamt`	integer	erê	Varianten insgesamt. (-9007199254740991–9007199254740991)
`positionen`	object[]	erê
`positionen[].produkt_id`	string	erê
`positionen[].artikelnummer`	string	erê
`positionen[].uebergeordnete_sku`	string \| null	erê
`positionen[].sku`	string \| null	erê
`positionen[].ean`	string \| null	erê	EAN / GTIN der Variante, sonst null.
`positionen[].farbe`	string	erê
`positionen[].groesse`	string	erê
`positionen[].titel`	string	erê
`positionen[].lagerbestand`	integer	erê	Gespeicherter, kaufbarer Bestand. (-9007199254740991–9007199254740991)
`positionen[].offen`	integer	erê	Stück in offenen eveyamin-Bestellungen. (-9007199254740991–9007199254740991)
`positionen[].stand`	string \| null	erê	Zuletzt übernommener stand.
`positionen[].gesperrt`	boolean	erê	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.

Destûr: bestand:schreiben

Parametre

Qad	Cure	Mecbûrî	Şirove
`id (path)`	string	erê	eveyamin-Produkt-ID, Übergeordnete SKU oder Artikelnummer.

Naverok – ProduktBestandAnfrage

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

Bersiv

200 Ergebnis je Zeile. – BestandErgebnis

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

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.

Destûr: bestellungen:lesen

Parametre

Qad	Cure	Mecbûrî	Şirove
`seite (query)`	integer	na	Seite, ab 1.
`pro_seite (query)`	integer	na	Bestellungen pro Seite, höchstens 100.

Bersiv

200 Eine Seite Bestellungen. – BestellListe

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

Destûr: bestellungen:lesen

Parametre

Qad	Cure	Mecbûrî	Şirove
`geaendert_seit (query)`	string (date-time)	na	Zeitpunkt nach ISO 8601 mit Zeitzone, z. B. 2026-10-07T09:15:00Z.
`seite (query)`	integer	na	Seite, ab 1.
`pro_seite (query)`	integer	na	Bestellungen pro Seite, höchstens 100.

Bersiv

200 Eine Seite Bestellungen. – BestellListe

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

Destûr: bestellungen:lesen

Parametre

Qad	Cure	Mecbûrî	Şirove
`id (path)`	string	erê	eveyamin-Bestell-ID oder Bestellnummer.

Bersiv

200 Die Bestellung mit deinen Positionen. – Bestellung

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

Destûr: bestellungen:lesen

Parametre

Qad	Cure	Mecbûrî	Şirove
`id (path)`	string	erê	eveyamin-Bestell-ID oder Bestellnummer.

Bersiv

200 Bestätigt. – Bestaetigung

Qad	Cure	Mecbûrî	Şirove
`id`	string	erê
`bestellnummer`	integer	erê	(-9007199254740991–9007199254740991)
`bestaetigt_am`	string	erê	Wann die Bestellung zum ersten Mal bestätigt wurde. ISO 8601, UTC.
`bereits_bestaetigt`	boolean	erê	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.

Destûr: bestellungen:lesen

Naverok – BestaetigungAnfrage

Qad	Cure	Mecbûrî	Şirove
`bestellungen`	string \| integer[]	erê	Bestell-IDs oder Bestellnummern.

Bersiv

200 Ergebnis je Eintrag. – BestaetigungErgebnis

Qad	Cure	Mecbûrî	Şirove
`zusammenfassung`	object	erê
`zusammenfassung.ok`	integer	erê	(-9007199254740991–9007199254740991)
`zusammenfassung.bereits_bestaetigt`	integer	erê	(-9007199254740991–9007199254740991)
`zusammenfassung.fehler`	integer	erê	(-9007199254740991–9007199254740991)
`bestellungen`	object[]	erê
`bestellungen[].zeile`	integer	erê	Index in bestellungen, ab 0. (-9007199254740991–9007199254740991)
`bestellungen[].status`	string	erê	Nirx: ok, bereits_bestaetigt, fehler
`bestellungen[].id`	string	na
`bestellungen[].bestellnummer`	integer	na	(-9007199254740991–9007199254740991)
`bestellungen[].bestaetigt_am`	string	na	Wann die Bestellung zum ersten Mal bestätigt wurde. ISO 8601, UTC.
`bestellungen[].fehler`	object	na
`bestellungen[].fehler.code`	string	erê
`bestellungen[].fehler.feld`	string \| null	erê
`bestellungen[].fehler.nachricht`	string	erê

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.

Destûr: bestellungen:versenden

Parametre

Qad	Cure	Mecbûrî	Şirove
`id (path)`	string	erê	eveyamin-Bestell-ID oder Bestellnummer.

Naverok – VersandAnfrage

Qad	Cure	Mecbûrî	Şirove
`versanddienstleister`	string	erê	Nirx: DHL, DPD, Hermes, GLS, UPS, Deutsche Post, Sonstige
`sendungsnummer`	string	erê	Gespeichert ohne Leerzeichen und in Großbuchstaben: 4–40 Zeichen aus A–Z, 0–9 und -.
`tracking_url`	string \| null	na	Eigener https-Link. Ohne ihn baut eveyamin den Link des Versanddienstleisters (bei „Sonstige“ gibt es keinen).
`positionen`	string[]	na	position_id der Positionen im Paket. Ohne: alle deine Positionen „In Bearbeitung“.

Bersiv

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

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

Guherto û têkilî

API guhertoyî ye (/api/v1). Qad û bangên nû di nav v1 de tên zêdekirin – ji ber vê qadên ku tu nas nakî paşguh bike. Tiştê ku girêdanên heyî bişkîne tenê di v2 de tê û demeke dirêj berê tê ragihandin.

Pirs li ser girêdanê: info@eveyamin.com.

Piştgiriya teknîkî

Agahiyên li jor divê bes bin ku tîma te ya teknîkî entegrasyonê temam bike. Heke tu hewceyê piştgiriyeke zêdetir bî, hevkarê me yê teknolojiyê bi kêfxweşî di entegrasyonê de alîkariya te dike.