Adatsémák
Szállítási cím
AddressData · Séma · Adatsémák: Rendelések
address_line_1Karakterlánc nullKötelezőA cím első sora.
address_line_2Karakterlánc nullKötelezőTovábbi címadatok.
cityKarakterlánc nullKötelezőVáros vagy település.
country_codeKarakterlánc nullKötelezőOrszágkód.
first_nameKarakterlánc nullKötelezőUtónév.
house_numberKarakterlánc nullKötelezőÉpület- vagy házszám.
last_nameKarakterlánc nullKötelezőCsaládi név.
phoneKarakterlánc nullKötelezőTelefonszám.
postal_codeKarakterlánc nullKötelezőIrányítószám.
regionKarakterlánc nullKötelezőKözigazgatási régió.
streetKarakterlánc nullKötelezőUtcanév.
További mezők: Nem
ApiResponse_OrderFileListData_
ApiResponse_OrderFileListData_ · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.
dataOrderFileListDataKötelezőA sikeres válasz adatai.
metaContextPageMetaContextMetaPageMetaRequestMetaKötelezőA válasz metaadatai.
További mezők: Nem
ApiResponse_OrderReleaseListData_
ApiResponse_OrderReleaseListData_ · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.
dataOrderReleaseListDataKötelezőA sikeres válasz adatai.
metaContextPageMetaContextMetaPageMetaRequestMetaKötelezőA válasz metaadatai.
További mezők: Nem
Listázás — Rendelések — Válasz
ApiResponse_list_OrderSummaryData__ · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
dataTömb <OrderSummaryData> KötelezőPéldaválasz · ApiResponse_list_OrderSummaryData__.
metaContextPageMetaContextMetaPageMetaRequestMetaKötelezőA válasz metaadatai.
További mezők: Nem
Lekérés — Rendelések — Válasz
ApiResponse_OrderDetailData_ · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
dataOrderDetailDataKötelezőPéldaválasz · OrderDetailData.
metaContextPageMetaContextMetaPageMetaRequestMetaKötelezőA válasz metaadatai.
További mezők: Nem
CurrentReleaseData
CurrentReleaseData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.
acquiredLogikai értékKötelezőHozzáférés vásárlás után (true / false)
changelogKarakterláncKötelezőVáltozások leírása
covered_by_purchaseLogikai értékKötelezőHozzáférés vásárlás után (true / false)
idKarakterláncKötelezőErőforrás-azonosító; a visszaadott alakban őrizze meg.
published_atKarakterláncKötelezőKiadás közzététele · UTC
format:"date-time"requires_new_purchaseLogikai értékKötelezőNincs hozzáférés a vásárlás után hozzáadott fájlokhoz · requires_new_purchase
sequenceEgész számKötelezőPozíció a rendezett gyűjteményben.
version_labelKarakterláncKötelezőVerzió
További mezők: Nem
Az erőforráshoz rögzített ügyféladatok
CustomerData · Séma · Adatsémák: Rendelések
emailKarakterláncKötelezőE-mail-cím.
first_nameKarakterlánc nullKötelezőUtónév.
last_nameKarakterlánc nullKötelezőCsaládi név.
phoneKarakterlánc nullKötelezőTelefonszám.
További mezők: Nem
DeliveryContentDeletion
DeliveryContentDeletion · Töröld végleg a tartalmat az előzmények megőrzésével. A kód nem kerül vissza az eladható készletbe.
expected_versionEgész számKötelezőAz írás előtt kiolvasott verzió; eltérés esetén a módosítás elutasításra kerül.
minimum:1reasonKarakterláncKötelezőA módosításhoz rögzített indok.
minLength:1maxLength:500
További mezők: Nem
Feladási és kézbesítési dátumok
DeliveryDatesData · A rendeléslista és a részletek tartalmazzák a delivery.dates objektumot. A YYYY-MM-DD dátumok tervezettek, nem igazolják a feladást. Az aktuális dátumok elsőbbséget élveznek; a régebbi rendelések a mentett becslést használják. A törölt vagy ismeretlen érték null. A részletek minden tételt és termékképet is tartalmaznak.
dispatch_timezoneKarakterlánc nullKötelezőA feladás időzónája (IANA; null).
estimated_delivery_fromKarakterlánc nullKötelezőA várható kézbesítés kezdete (YYYY-MM-DD; null).
Karakterlánc:format:"date"estimated_delivery_toKarakterlánc nullKötelezőA várható kézbesítés vége (YYYY-MM-DD; null).
Karakterlánc:format:"date"planned_dispatch_onKarakterlánc nullKötelezőTervezett feladási dátum (YYYY-MM-DD; null).
Karakterlánc:format:"date"
További mezők: Nem
DeliveryReplacement
DeliveryReplacement · Válassz egy meglévő szabad egységet. A csere nem indítja újra a megőrzési időt.
expected_unit_versionEgész számKötelezőA szabad csereegység jelenlegi verziója.
minimum:1expected_versionEgész számKötelezőAz írás előtt kiolvasott verzió; eltérés esetén a módosítás elutasításra kerül.
minimum:1reasonKarakterláncKötelezőA módosításhoz rögzített indok.
minLength:1maxLength:500replacement_unit_idKarakterláncKötelezőEgy meglévő szabad csereegység azonosítója.
format:"uuid"
További mezők: Nem
DeliveryPickupPointData
DeliveryPickupPointData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
addressPickupPointAddressDataKötelezőSzállítási cím.
codeKarakterláncKötelezőStabil, géppel feldolgozható kód.
Korlátozások
pattern"^[A-Za-z0-9_-]{1,63}$"
coordinatesPickupPointCoordinatesDatanullKötelezőA környező séma által leírt érték.
country_codeKarakterláncKötelezőOrszágkód.
Korlátozások
pattern"^[A-Z]{2}$"
environmentKarakterláncKötelezőA rekordhoz csatolt környezeti adatok.
Korlátozások
enum["live", "sandbox"]
kindKarakterláncKötelezőAz adatstruktúra változata, a megengedett értékek szerint.
Korlátozások
enum["locker", "pickup_point"]
location_descriptionKarakterlánc nullKötelezőLeírás a kiválasztott nyelven.
Karakterlánc:maxLength:1000nameKarakterláncKötelezőAz erőforrás neve az adott környezetben.
minLength:1maxLength:160opening_hoursKarakterlánc nullKötelezőOpening hours
Karakterlánc:maxLength:500operatorKarakterláncKötelezőAz erőforrás neve az adott környezetben.
minLength:1maxLength:63verified_atKarakterláncKötelezőA legutóbbi módosítás időpontja.
format:"date-time"
További mezők: Nem
ApiResponse[list[DeliveryData]]
shopently_engine__runtime__public_api_http__responses__models__ApiResponse_list_DeliveryData____1 · Kérd le a kiosztott egységeket kódok nélkül. A visszatérítés csak az érintett rendelési sorok hozzáférését veszi el.
dataTömb <shopently_engine__domains__orders__adapters__public_http__digital_deliveries__schemas__DeliveryData> KötelezőA sikeres válasz adatai.
metaContextPageMetaContextMetaPageMetaRequestMetaKötelezőA válasz metaadatai.
További mezők: Nem
DeliveryData
shopently_engine__domains__orders__adapters__public_http__digital_deliveries__schemas__DeliveryData · Kérd le a kiosztott egységeket kódok nélkül. A visszatérítés csak az érintett rendelési sorok hozzáférését veszi el.
can_downloadLogikai értékKötelezőLetöltés (true / false)
content_stateKarakterláncKötelezőTartalomállapot: present / deleting / deleted.
delete_due_atKarakterlánc nullKötelezőÜtemezett fájltörlés; null kikapcsolja.
Karakterlánc:format:"date-time"filenameKarakterlánc nullKötelezőFájl
first_available_atKarakterlánc nullKötelezőA vásárlás első hozzáférése; a csere nem indítja újra a határidőt.
Karakterlánc:format:"date-time"generationEgész számKötelezőA kiosztás generációja; cserekor növekszik.
idKarakterláncKötelezőErőforrás-azonosító; a visszaadott alakban őrizze meg.
format:"uuid"kindKarakterlánc nullKötelezőAz adatstruktúra változata, a megengedett értékek szerint.
line_idKarakterláncKötelezőA rendelési tétel állandó azonosítója.
order_idKarakterláncKötelezőA kapcsolódó rendelés azonosítója.
payload_idKarakterláncKötelezőTartalomazonosító; nem nyilvános letöltési URL.
format:"uuid"product_idKarakterláncKötelezőTermékazonosító.
reasonKarakterláncKötelezőA módosításhoz rögzített indok.
size_bytesEgész szám nullKötelezőMéret bájtban
stateKarakterláncKötelezőÁllapot
unit_idKarakterláncKötelezőEgy egyedi kód vagy fájl azonosítója.
format:"uuid"unit_ordinalEgész számKötelezőA vásárolt egység sorszáma a rendelési sorban.
variant_idKarakterlánc nullKötelezőTermékvariáns-azonosító.
versionEgész számKötelezőAz erőforrás verziója az egyidejű módosítások ellenőrzéséhez.
További mezők: Nem
Számlaadatok
InvoiceData · Séma · Adatsémák: Rendelések
address_line_1Karakterlánc nullKötelezőA cím első sora.
address_line_2Karakterlánc nullKötelezőTovábbi címadatok.
cityKarakterlánc nullKötelezőVáros vagy település.
company_nameKarakterlánc nullKötelezőCégnév.
country_codeKarakterlánc nullKötelezőOrszágkód.
house_numberKarakterlánc nullKötelezőÉpület- vagy házszám.
postal_codeKarakterlánc nullKötelezőIrányítószám.
regionKarakterlánc nullKötelezőKözigazgatási régió.
streetKarakterlánc nullKötelezőUtcanév.
tax_identifierKarakterlánc nullKötelezőAdóazonosító szám.
tax_schemeKarakterlánc nullKötelezőAdószámítási séma.
További mezők: Nem
Nettó összeg / Adó összege / Bruttó összeg
OrderAmountBreakdownData · Az összegek és adókulcsok a mentett rendelésből származnak, a tételjavításokkal együtt. A hiányzó előzmény null, és nem helyettesíthető a katalógus aktuális adókulcsaival. Az összegek decimális karakterláncok maradnak.
grossMoneyDataKötelezőBruttó összeg · Kedvezmények után; Ismeretlen: null; ismert nulla: 0.
netMoneyDatanullKötelezőNettó összeg · Kedvezmények után; Ismeretlen: null; ismert nulla: 0.
taxMoneyDatanullKötelezőAdó összege · Kedvezmények után; Ismeretlen: null; ismert nulla: 0.
További mezők: Nem
Szállítás · Kedvezmények
OrderDeliveryDiscountData · Az összegek és adókulcsok a mentett rendelésből származnak, a tételjavításokkal együtt. A hiányzó előzmény null, és nem helyettesíthető a katalógus aktuális adókulcsaival. Az összegek decimális karakterláncok maradnak.
amountMoneyDataKötelezőBruttó összeg · Szállítás · Kedvezmények.
campaign_idKarakterláncKötelezőErőforrás-azonosító; a visszaadott alakban őrizze meg.
codeKarakterlánc nullKötelezőStabil, géppel feldolgozható kód.
kindKarakterláncKötelezőAz adatstruktúra változata, a megengedett értékek szerint.
Korlátozások
enum["coupon", "promotion"]
nameKarakterláncKötelezőAz erőforrás neve az adott környezetben.
sequenceEgész szám nullKötelezőPozíció a rendezett gyűjteményben.
versionEgész számKötelezőAz erőforrás verziója az egyidejű módosítások ellenőrzéséhez.
További mezők: Nem
Lekérés — Rendelések — Válasz
OrderDetailData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
created_atKarakterláncKötelezőA létrehozás időpontja.
format:"date-time"customerCustomerDataKötelezőAz erőforráshoz rögzített ügyféladatok.
deliveryShippingDetailDataKötelezőSzállítási mód és kapcsolódó adatok.
discount_amountMoneyDataKötelezőJSON-karakterláncként kódolt tizedes összeg; null csak ott, ahol engedélyezett.
discountsTömb <OrderDiscountData> KötelezőKedvezmények
idKarakterláncKötelezőErőforrás-azonosító; a visszaadott alakban őrizze meg. (OrderDetailData).
invoiceInvoiceDatanullKötelezőSzámlaadatok.
invoice_requestedLogikai értékKötelezőJelzi, hogy kértek-e számlát.
lifecycle_stateOrderLifecycleStateKötelezőAz üzleti életciklus állapota.
linesTömb <OrderLineData> KötelezőA rendelési tételek pillanatfelvételei.
localeKarakterláncKötelezőA kéréshez kiválasztott nyelv.
market_idKarakterláncKötelezőA környezetvégpont által visszaadott piacazonosító.
numberKarakterláncKötelezőA rendelés vagy bejelentés felhasználóknak szánt száma.
paymentPaymentDataKötelezőA rendeléshez rögzített fizetési adatok.
pickup_pointPickupPointDatanullKötelezőÁtvételi pont
prices_include_taxLogikai értékKötelezőJelzi, hogy a felsorolt árak tartalmazzák-e az adót.
shipping_addressAddressDatanullKötelezőSzállítási cím.
shipping_discount_amountMoneyDataKötelezőJSON-karakterláncként kódolt tizedes összeg; null csak ott, ahol engedélyezett.
statusOrderStatusDataKötelezőAz adott művelet által elfogadott állapot.
subtotalMoneyDataKötelezőÖsszeg a válaszban feltüntetett további összetevők hozzáadása előtt.
taxMoneyDataKötelezőAdóadatok.
tax_breakdownOrderTaxBreakdownDataKötelezőAdócsoportok · source + tax_rate; unallocated_tax.
tax_country_codeKarakterlánc nullKötelezőAdózási ország · Mentett rendelési adatok · ISO 3166-1 alpha-2; null.
totalMoneyDataKötelezőTeljes összeg.
totalsOrderTotalsDataKötelezőÖsszesítések · net / tax / gross; Kedvezmények előtt / Kedvezmények után.
További mezők: Nem
OrderFileData
OrderFileData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.
can_downloadLogikai értékKötelezőLetöltés (true / false)
categoryFileCategoryKötelezőFájlkategória: internal / customer_document / digital
filenameKarakterláncKötelezőFájl
idKarakterláncKötelezőErőforrás-azonosító; a visszaadott alakban őrizze meg.
labelKarakterláncKötelezőAz erőforrás neve az adott környezetben.
line_idKarakterláncKötelezőA rendelési tétel állandó azonosítója.
mime_typeKarakterláncKötelezőA média tartalomtípusa.
product_idKarakterláncKötelezőTermékazonosító.
purchase_idKarakterláncKötelezőErőforrás-azonosító; a visszaadott alakban őrizze meg. · purchase_id
reasonKarakterláncKötelezőA módosításhoz rögzített indok.
sha256KarakterláncKötelezőSHA-256 (hex, 64)
size_bytesEgész számKötelezőMéret bájtban
minimum:1maximum:262144000source_file_idKarakterláncKötelezőErőforrás-azonosító; a visszaadott alakban őrizze meg. · source_file_id
source_version_idKarakterláncKötelezőErőforrás-azonosító; a visszaadott alakban őrizze meg. · source_version_id
source_version_numberEgész számKötelezőVerzió
minimum:1stateKarakterláncKötelezőÁllapot
További mezők: Nem
OrderFileListData
OrderFileListData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.
filesTömb <OrderFileData> KötelezőTermékfájlok
updates_pendingLogikai értékKötelezőHozzáférés a jövőbeli fájlokhoz vásárlás után · updates_pending
További mezők: Nem
A kép metaadatai és URL-je
OrderImageData · Séma · Adatsémák: Rendelések
altKarakterlánc nullKötelezőA kép alternatív szövege.
sourceKarakterláncNem kötelezőA rögzített tevékenység forrása.
const:"current_catalog"urlKarakterláncKötelezőAz erőforrás URL-je.
További mezők: Nem
Az üzleti életciklus állapota
OrderLifecycleState · Séma · Adatsémák: Rendelések
KarakterláncKorlátozások
enum["placed", "cancelled", "fulfilled", "returned"]
További mezők: Igen
A rendelési tételek pillanatfelvételei
OrderLineData · Séma · Adatsémák: Rendelések
discount_amountMoneyDataKötelezőJSON-karakterláncként kódolt tizedes összeg; null csak ott, ahol engedélyezett.
discount_grossMoneyDataKötelezőBruttó összeg · Kedvezmények; Ismeretlen: null; ismert nulla: 0.
discount_netMoneyDatanullKötelezőNettó összeg · Kedvezmények; Ismeretlen: null; ismert nulla: 0.
discount_taxMoneyDatanullKötelezőAdó összege · Kedvezmények; Ismeretlen: null; ismert nulla: 0.
discountsTömb <OrderDiscountData> KötelezőKedvezmények · net / tax / gross.
identifiersObjektumTovábbi mezők: KarakterláncKötelezőA termék azonosítókódjai.
imageOrderImageDatanullKötelezőA kép metaadatai és URL-je.
line_idKarakterláncKötelezőA rendelési tétel állandó azonosítója.
manual_discountOrderManualDiscountDatanullKötelezőKézi kedvezmény; null.
nameKarakterláncKötelezőAz erőforrás neve az adott környezetben.
original_totalMoneyDataKötelezőTeljes összeg.
original_total_grossMoneyDataKötelezőBruttó összeg · Termékek · Kedvezmények előtt; Ismeretlen: null; ismert nulla: 0.
original_total_netMoneyDatanullKötelezőNettó összeg · Termékek · Kedvezmények előtt; Ismeretlen: null; ismert nulla: 0.
original_total_taxMoneyDatanullKötelezőAdó összege · Termékek · Kedvezmények előtt; Ismeretlen: null; ismert nulla: 0.
positionEgész számKötelezőPozíció a rendezett gyűjteményben.
product_idKarakterláncKötelezőTermékazonosító.
quantityEgész számKötelezőEgységek száma.
skuKarakterláncKötelezőKészletnyilvántartási cikkszám.
taxMoneyDatanullKötelezőAdó összege · Egy egység · Mentett rendelési adatok; tax ≠ unit_tax; Ismeretlen: null; ismert nulla: 0.
tax_category_idKarakterlánc nullKötelezőAdókategória azonosítója · Mentett rendelési adatok; null.
tax_category_nameKarakterlánc nullKötelezőAdókategória mentett neve; null.
tax_rateKarakterlánc nullKötelezőtax_rate · Mentett rendelési adatok: "0.23" = 23%; "0" ≠ null.
totalMoneyDataKötelezőTeljes összeg.
total_grossMoneyDataKötelezőBruttó összeg · Termékek · Kedvezmények után; Ismeretlen: null; ismert nulla: 0.
total_netMoneyDatanullKötelezőNettó összeg · Termékek · Kedvezmények után; Ismeretlen: null; ismert nulla: 0.
total_taxMoneyDatanullKötelezőAdó összege · Termékek · Kedvezmények után · Mentett rendelési adatok; Ismeretlen: null; ismert nulla: 0.
unit_grossMoneyDataKötelezőBruttó összeg · Egy egység · Kedvezmények előtt; Ismeretlen: null; ismert nulla: 0.
unit_netMoneyDatanullKötelezőNettó összeg · Egy egység · Kedvezmények előtt; Ismeretlen: null; ismert nulla: 0.
unit_priceMoneyDataKötelezőEgy egység ára.
unit_taxMoneyDatanullKötelezőAdó összege · Egy egység · Kedvezmények előtt; Ismeretlen: null; ismert nulla: 0.
variant_idKarakterlánc nullKötelezőTermékvariáns-azonosító.
variant_optionsTömb <shopently_engine__domains__orders__adapters__public_http__orders__schemas__VariantOptionData> KötelezőA termékhez vagy pillanatfelvételhez kapcsolódó variánsopciók.
További mezők: Nem
Kézi kedvezmény
OrderManualDiscountData · Az összegek és adókulcsok a mentett rendelésből származnak, a tételjavításokkal együtt. A hiányzó előzmény null, és nem helyettesíthető a katalógus aktuális adókulcsaival. Az összegek decimális karakterláncok maradnak.
amountMoneyDataKötelezőBruttó összeg · Kézi kedvezmény · Mentett rendelési adatok.
kindKarakterláncKötelezőKedvezmény típusa: percentage / fixed.
Korlátozások
enum["percentage", "fixed"]
valueKarakterláncKötelezőBeállított érték: percentage "10" = 10%; fixed = Bruttó összeg.
További mezők: Nem
Az adott művelet által elfogadott állapot
OrderPaymentStatus · Séma · Adatsémák: Rendelések
KarakterláncKorlátozások
enum["unpaid", "paid", "failed", "refunded"]
További mezők: Igen
OrderReleaseData
OrderReleaseData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.
access_reasonKarakterláncKötelezőHozzáférés vásárlás után · A módosításhoz rögzített indok.
access_stateKarakterláncKötelezőHozzáférés vásárlás után · Állapot
current_releaseCurrentReleaseDatanullKötelezőDigitális kiadások · current_release
grant_reasonKarakterláncKötelezőHozzáférés vásárlás után · A módosításhoz rögzített indok.
granted_atKarakterláncKötelezőHozzáférés vásárlás után · UTC
format:"date-time"idKarakterláncKötelezőErőforrás-azonosító; a visszaadott alakban őrizze meg.
line_idKarakterláncKötelezőA rendelési tétel állandó azonosítója.
manifest_sha256KarakterláncKötelezőDigitális kiadások · SHA-256
product_idKarakterláncKötelezőTermékazonosító.
published_atKarakterláncKötelezőKiadás közzététele · UTC
format:"date-time"purchase_idKarakterláncKötelezőErőforrás-azonosító; a visszaadott alakban őrizze meg. · purchase_id
release_idKarakterláncKötelezőErőforrás-azonosító; a visszaadott alakban őrizze meg. · release_id
release_sequenceEgész számKötelezőDigitális kiadások · Pozíció a rendezett gyűjteményben.
update_daysEgész szám nullKötelezőNapok száma (days; null)
update_modeKarakterláncKötelezőHozzáférés a jövőbeli fájlokhoz vásárlás után: none / period / unlimited
update_monthsEgész szám nullKötelezőHónapok (months; null)
updates_untilKarakterlánc nullKötelezőHozzáférés a jövőbeli fájlokhoz vásárlás után · UTC
Karakterlánc:format:"date-time"version_labelKarakterláncKötelezőVerzió
További mezők: Nem
OrderReleaseListData
OrderReleaseListData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai. Az upload_id létrehozása után küldje a fájlokat multipart/form-data formátumban, majd rendelje a termékhez. A letöltéshez Bearer-token és a category szerinti jogosultság szükséges; a válasz a fájl bájtjait tartalmazza nyilvános cím és jelszó nélkül. A mode=period esetén days (1–3650) vagy a korábbi months adható meg, egyszerre mindkettő nem. A feltételek vásárláskor rögzülnek; a visszatérítés csak az érintett tétel hozzáférését vonja vissza.
releasesTömb <OrderReleaseData> KötelezőDigitális kiadások
updates_pendingLogikai értékKötelezőHozzáférés a jövőbeli fájlokhoz vásárlás után · updates_pending
További mezők: Nem
Az adott művelet által elfogadott állapot
OrderStatusData · Séma · Adatsémák: Rendelések
idKarakterláncKötelezőErőforrás-azonosító; a visszaadott alakban őrizze meg. (OrderStatusData).
nameKarakterláncKötelezőAz erőforrás neve az adott környezetben.
updated_atKarakterláncKötelezőA legutóbbi módosítás időpontja.
format:"date-time"versionEgész számKötelezőAz erőforrás verziója az egyidejű módosítások ellenőrzéséhez.
További mezők: Nem
Listázás · Állapotok — Rendelések — Válasz
shopently_engine__domains__orders__adapters__public_http__orders__schemas__StatusDefinitionData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
created_atKarakterláncKötelezőA létrehozás időpontja.
format:"date-time"idKarakterláncKötelezőErőforrás-azonosító; a visszaadott alakban őrizze meg. (shopently_engine__domains__orders__adapters__public_http__orders__schemas__StatusDefinitionData).
is_initialLogikai értékKötelezőJelzi, hogy ez a kezdeti állapot-e.
nameKarakterláncKötelezőAz erőforrás neve az adott környezetben.
positionEgész számKötelezőPozíció a rendezett gyűjteményben.
További mezők: Nem
Listázás · Állapotok — Rendelések — Válasz
shopently_engine__runtime__public_api_http__responses__models__ApiResponse_list_StatusDefinitionData____1 · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
dataTömb <shopently_engine__domains__orders__adapters__public_http__orders__schemas__StatusDefinitionData> KötelezőPéldaválasz · shopently_engine__runtime__public_api_http__responses__models__ApiResponse_list_StatusDefinitionData____1.
metaContextPageMetaContextMetaPageMetaRequestMetaKötelezőA válasz metaadatai.
További mezők: Nem
Módosítás · Állapot — Rendelések — Kérés törzse
OrderStatusUpdate · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
expected_versionEgész számKötelezőAz írás előtt kiolvasott verzió; eltérés esetén a módosítás elutasításra kerül.
minimum:1maximum:9223372036854775807status_idKarakterláncKötelezőA megfelelő állapotszótárból kapott azonosító.
Korlátozások
pattern"^[a-z0-9][a-z0-9_-]{0,62}$"
További mezők: Nem
Listázás — Rendelések — Válasz
OrderSummaryData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
created_atKarakterláncKötelezőA létrehozás időpontja.
format:"date-time"customerCustomerDataKötelezőAz erőforráshoz rögzített ügyféladatok.
deliveryShippingDataKötelezőSzállítási mód és kapcsolódó adatok.
discount_amountMoneyDataKötelezőJSON-karakterláncként kódolt tizedes összeg; null csak ott, ahol engedélyezett.
idKarakterláncKötelezőErőforrás-azonosító; a visszaadott alakban őrizze meg. (OrderSummaryData).
lifecycle_stateOrderLifecycleStateKötelezőAz üzleti életciklus állapota.
localeKarakterláncKötelezőA kéréshez kiválasztott nyelv.
market_idKarakterláncKötelezőA környezetvégpont által visszaadott piacazonosító.
numberKarakterláncKötelezőA rendelés vagy bejelentés felhasználóknak szánt száma.
paymentPaymentDataKötelezőA rendeléshez rögzített fizetési adatok.
prices_include_taxLogikai értékKötelezőJelzi, hogy a felsorolt árak tartalmazzák-e az adót.
shipping_discount_amountMoneyDataKötelezőJSON-karakterláncként kódolt tizedes összeg; null csak ott, ahol engedélyezett.
statusOrderStatusDataKötelezőAz adott művelet által elfogadott állapot.
subtotalMoneyDataKötelezőÖsszeg a válaszban feltüntetett további összetevők hozzáadása előtt.
taxMoneyDataKötelezőAdóadatok.
tax_country_codeKarakterlánc nullKötelezőAdózási ország · Mentett rendelési adatok · ISO 3166-1 alpha-2; null.
totalMoneyDataKötelezőTeljes összeg.
További mezők: Nem
Rendelés · Adócsoportok
OrderTaxBreakdownData · Az összegek és adókulcsok a mentett rendelésből származnak, a tételjavításokkal együtt. A hiányzó előzmény null, és nem helyettesíthető a katalógus aktuális adókulcsaival. Az összegek decimális karakterláncok maradnak.
groupsTömb <OrderTaxGroupData> KötelezőAdócsoportok · source + tax_rate; Ismeretlen: null; ismert nulla: 0.
unallocated_taxMoneyDataKötelezőFel nem osztott adó = order.tax − Σ groups.tax; ±.
További mezők: Nem
Adócsoportok
OrderTaxGroupData · Az összegek és adókulcsok a mentett rendelésből származnak, a tételjavításokkal együtt. A hiányzó előzmény null, és nem helyettesíthető a katalógus aktuális adókulcsaival. Az összegek decimális karakterláncok maradnak.
grossMoneyDataKötelezőBruttó összeg · Kedvezmények után; Ismeretlen: null; ismert nulla: 0.
netMoneyDatanullKötelezőNettó összeg · Kedvezmények után; Ismeretlen: null; ismert nulla: 0.
sourceKarakterláncKötelezőForrás: products (Termékek), shipping (Szállítás).
Korlátozások
enum["products", "shipping"]
taxMoneyDatanullKötelezőAdó összege · Kedvezmények után; Ismeretlen: null; ismert nulla: 0.
tax_rateKarakterlánc nullKötelezőtax_rate · Mentett rendelési adatok: "0.23" = 23%; "0" ≠ null.
További mezők: Nem
Rendelés · Összesítések
OrderTotalsData · Az összegek és adókulcsok a mentett rendelésből származnak, a tételjavításokkal együtt. A hiányzó előzmény null, és nem helyettesíthető a katalógus aktuális adókulcsaival. Az összegek decimális karakterláncok maradnak.
before_discountsOrderAmountBreakdownDataKötelezőRendelés · Kedvezmények előtt · net / tax / gross.
discountsOrderAmountBreakdownDataKötelezőKedvezmények · net / tax / gross.
orderOrderAmountBreakdownDataKötelezőRendelés · Kedvezmények után · net / tax / gross.
product_discountsOrderAmountBreakdownDataKötelezőTermékek · Kedvezmények · net / tax / gross.
productsOrderAmountBreakdownDataKötelezőTermékek · Kedvezmények után · net / tax / gross.
products_before_discountsOrderAmountBreakdownDataKötelezőTermékek · Kedvezmények előtt · net / tax / gross.
shippingOrderAmountBreakdownDataKötelezőSzállítás · Kedvezmények után · net / tax / gross.
shipping_before_discountsOrderAmountBreakdownDataKötelezőSzállítás · Kedvezmények előtt · net / tax / gross.
shipping_discountsOrderAmountBreakdownDataKötelezőSzállítás · Kedvezmények · net / tax / gross.
További mezők: Nem
A termékhez vagy pillanatfelvételhez kapcsolódó variánsopciók
shopently_engine__domains__orders__adapters__public_http__orders__schemas__VariantOptionData · Séma · Adatsémák: Rendelések
nameKarakterláncKötelezőAz erőforrás neve az adott környezetben.
valueKarakterláncKötelezőA környező séma által leírt érték.
További mezők: Nem
OrderDiscountData
OrderDiscountData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
amountMoneyDataKötelezőBruttó összeg · Termékek · Kedvezmények.
campaign_idKarakterláncKötelezőErőforrás-azonosító; a visszaadott alakban őrizze meg.
codeKarakterlánc nullKötelezőStabil, géppel feldolgozható kód.
kindKarakterláncKötelezőAz adatstruktúra változata, a megengedett értékek szerint.
Korlátozások
enum["coupon", "promotion"]
nameKarakterláncKötelezőAz erőforrás neve az adott környezetben.
sequenceEgész szám nullNem kötelezőAlkalmazás sorrendje; null.
shipping_amountMoneyDatanullNem kötelezőBruttó összeg · Szállítás · Kedvezmények; null.
versionEgész számKötelezőAz erőforrás verziója az egyidejű módosítások ellenőrzéséhez.
További mezők: Nem
A rendeléshez rögzített fizetési adatok
PaymentData · Séma · Adatsémák: Rendelések
amountMoneyDataKötelezőA payment.amount a rendelés végösszege. A fizetési állapot nem határozza meg a fizetett, visszatérített vagy fennmaradó összegeket.
environmentKarakterláncKötelezőA rekordhoz csatolt környezeti adatok.
Korlátozások
enum["live", "sandbox"]
method_codeKarakterlánc nullKötelezőA szállítási vagy fizetési mód kódja.
method_nameKarakterlánc nullKötelezőA szállítási vagy fizetési mód neve.
paid_atKarakterlánc nullKötelezőA fizetett állapot rögzítésének dátuma és időpontja.
Karakterlánc:format:"date-time"statusOrderPaymentStatusKötelezőAz adott művelet által elfogadott állapot.
updated_atKarakterláncKötelezőA legutóbbi módosítás időpontja.
format:"date-time"versionEgész számKötelezőAz erőforrás verziója az egyidejű módosítások ellenőrzéséhez.
További mezők: Nem
Módosítás · Fizetési állapot — Rendelések — Kérés törzse
PaymentStatusUpdate · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
expected_versionEgész számKötelezőAz írás előtt kiolvasott verzió; eltérés esetén a módosítás elutasításra kerül.
minimum:0maximum:9223372036854775807reasonKarakterláncKötelezőA módosításhoz rögzített indok.
minLength:1maxLength:500statusPaymentStatusKötelezőAz adott művelet által elfogadott állapot. unpaid: kifizetetlen; paid: kifizetve; failed: sikertelen fizetés; refunded: visszatérítve.
További mezők: Nem
Az adott művelet által elfogadott állapot
PaymentStatus · Séma · Adatsémák: Rendelések
KarakterláncKorlátozások
enum["unpaid", "paid", "failed", "refunded"]
További mezők: Igen
PickupPointAddressData
PickupPointAddressData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
address_line_1KarakterláncKötelezőA cím első sora.
minLength:1maxLength:240cityKarakterláncKötelezőVáros vagy település.
minLength:1maxLength:160postal_codeKarakterláncKötelezőIrányítószám.
minLength:1maxLength:32
További mezők: Nem
PickupPointCoordinatesData
PickupPointCoordinatesData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
latitudeSzámKötelezőWGS84 φ (°)
minimum:-90.0maximum:90.0longitudeSzámKötelezőWGS84 λ (°)
minimum:-180.0maximum:180.0
További mezők: Nem
PickupPointData
PickupPointData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
address_line1KarakterláncKötelezőA cím első sora.
cityKarakterláncKötelezőVáros vagy település.
codeKarakterláncKötelezőStabil, géppel feldolgozható kód.
country_codeKarakterláncKötelezőOrszágkód.
kindKarakterláncKötelezőAz adatstruktúra változata, a megengedett értékek szerint.
Korlátozások
enum["locker", "pickup_point"]
latitudeSzám nullKötelezőWGS84 φ (°)
location_descriptionKarakterlánc nullKötelezőLeírás a kiválasztott nyelven.
longitudeSzám nullKötelezőWGS84 λ (°)
nameKarakterláncKötelezőAz erőforrás neve az adott környezetben.
opening_hoursKarakterlánc nullKötelezőOpening hours
operatorKarakterláncKötelezőAz erőforrás neve az adott környezetben.
postal_codeKarakterláncKötelezőIrányítószám.
További mezők: Nem
PickupPointSummaryData
PickupPointSummaryData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
codeKarakterláncKötelezőStabil, géppel feldolgozható kód.
Korlátozások
pattern"^[A-Za-z0-9_-]{1,63}$"
country_codeKarakterláncKötelezőOrszágkód.
Korlátozások
pattern"^[A-Z]{2}$"
environmentKarakterláncKötelezőA rekordhoz csatolt környezeti adatok.
Korlátozások
enum["live", "sandbox"]
kindKarakterláncKötelezőAz adatstruktúra változata, a megengedett értékek szerint.
Korlátozások
enum["locker", "pickup_point"]
operatorKarakterláncKötelezőAz erőforrás neve az adott környezetben.
minLength:1maxLength:63
További mezők: Nem
Az erőforráshoz rögzített ügyféladatok
RequestCustomerData · Séma · Adatsémák: Rendelések
emailKarakterláncKötelezőE-mail-cím.
nameKarakterláncKötelezőAz erőforrás neve az adott környezetben.
További mezők: Nem
Szállítási mód és kapcsolódó adatok
ShippingData · Séma · Adatsémák: Rendelések
amountMoneyDataKötelezőA rendelésben MoneyData formában rögzített bruttó szállítási összeg. A későbbi adóváltozások ezt a korábbi összeget nem módosítják.
datesDeliveryDatesDataKötelezőFeladási és kézbesítési dátumok. A rendeléslista és a részletek tartalmazzák a delivery.dates objektumot. A YYYY-MM-DD dátumok tervezettek, nem igazolják a feladást. Az aktuális dátumok elsőbbséget élveznek; a régebbi rendelések a mentett becslést használják. A törölt vagy ismeretlen érték null. A részletek minden tételt és termékképet is tartalmaznak.
method_codeKarakterlánc nullKötelezőA szállítási vagy fizetési mód kódja.
method_nameKarakterlánc nullKötelezőA szállítási vagy fizetési mód neve.
pickup_pointPickupPointSummaryDatanullKötelezőÁtvételi pont
recipient_modeKarakterláncKötelezőAz adatstruktúra változata, a megengedett értékek szerint.
Korlátozások
enum["full_address", "pickup_contact", "address_only", "name_contact", "contact_only"]
További mezők: Nem
ShippingDetailData
ShippingDetailData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
amountMoneyDataKötelezőA rendelésben MoneyData formában rögzített bruttó szállítási összeg. A későbbi adóváltozások ezt a korábbi összeget nem módosítják.
datesDeliveryDatesDataKötelezőFeladási és kézbesítési dátumok. A rendeléslista és a részletek tartalmazzák a delivery.dates objektumot. A YYYY-MM-DD dátumok tervezettek, nem igazolják a feladást. Az aktuális dátumok elsőbbséget élveznek; a régebbi rendelések a mentett becslést használják. A törölt vagy ismeretlen érték null. A részletek minden tételt és termékképet is tartalmaznak.
discount_grossMoneyDataKötelezőBruttó összeg · Kedvezmények; Ismeretlen: null; ismert nulla: 0.
discount_netMoneyDatanullKötelezőNettó összeg · Kedvezmények; Ismeretlen: null; ismert nulla: 0.
discount_taxMoneyDatanullKötelezőAdó összege · Kedvezmények; Ismeretlen: null; ismert nulla: 0.
discountsTömb <OrderDeliveryDiscountData> nullKötelezőSzállítás · Kedvezmények; []: 0; null: Ismeretlen: null; ismert nulla: 0.
grossMoneyDataKötelezőBruttó összeg · Kedvezmények után; Ismeretlen: null; ismert nulla: 0.
method_codeKarakterlánc nullKötelezőA szállítási vagy fizetési mód kódja.
method_nameKarakterlánc nullKötelezőA szállítási vagy fizetési mód neve.
netMoneyDatanullKötelezőNettó összeg · Kedvezmények után; Ismeretlen: null; ismert nulla: 0.
original_grossMoneyDataKötelezőBruttó összeg · Szállítás · Kedvezmények előtt; Ismeretlen: null; ismert nulla: 0.
original_netMoneyDatanullKötelezőNettó összeg · Szállítás · Kedvezmények előtt; Ismeretlen: null; ismert nulla: 0.
original_taxMoneyDatanullKötelezőAdó összege · Szállítás · Kedvezmények előtt; Ismeretlen: null; ismert nulla: 0.
pickup_pointDeliveryPickupPointDatanullKötelezőÁtvételi pont
recipient_modeKarakterláncKötelezőAz adatstruktúra változata, a megengedett értékek szerint.
Korlátozások
enum["full_address", "pickup_contact", "address_only", "name_contact", "contact_only"]
taxMoneyDatanullKötelezőAdó összege · Kedvezmények után; Ismeretlen: null; ismert nulla: 0.
tax_category_idKarakterlánc nullKötelezőAdókategória azonosítója · Mentett rendelési adatok; null.
tax_category_nameKarakterlánc nullKötelezőAdókategória mentett neve; null.
tax_rateKarakterlánc nullKötelezőtax_rate · Mentett rendelési adatok: "0.23" = 23%; "0" ≠ null.
További mezők: Nem