Podatkovne sheme: Zaloga

Podatkovne sheme: Zaloga. Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

Podatkovne sheme

Količine, dodeljene lokacijam skladišča

AllocationData · Shema · Podatkovne sheme: Zaloga

location_codeNizObvezno: Koda lokacije skladišča.

Primer: "example"
location_idNizObvezno: Identifikator lokacije skladišča.

Primer: "example"
location_nameNizObvezno: Ime lokacije skladišča.

Primer: "example"
on_handCelo številoObvezno: Fizična količina na zalogi.

Primer: 10

Dodatna polja: Ne

ApiResponse[CodeContentData]

ApiResponse_CodeContentData_ · Koda se vrne kot JSON, datoteka kot binarni podatki. Vsaka zahteva potrebuje Bearer in pravico reveal.

dataCodeContentData Obvezno: Vsebina uspešnega odgovora.

Primer: {"code":"DEMO-ONE","delivery_id":null,"kind":"code","payload_id":"00000000-0000-4000-8000-000000000004","unit_id":"00000000-0000-4000-8000-000000000003"}
metaContextPageMeta ContextMeta PageMeta RequestMeta Obvezno: Metapodatki odgovora.

Primer: {"request_id":"example-request"}

Dodatna polja: Ne

ApiResponse[DigitalUploadData]

ApiResponse_DigitalUploadData_ · Preveri velikost, kontrolno vsoto in obliko. Končan prenos še ne pomeni prejete dobave.

dataDigitalUploadData Obvezno: Vsebina uspešnega odgovora.

Primer: {"consumer_id":"00000000-0000-4000-8000-000000000001","consumer_kind":"digital_import","expires_at":"2026-11-03T13:00:00Z","filename":"codes.txt","id":"00000000-0000-4000-8000-000000000002","product_id":"example","purpose":"digital_import","received_bytes":18,"sha256":"636e307039d9ca307836e9a93ea492425545bcccb6cb4ef935ab635560db828a","size_bytes":18,"status":"ready"}
metaContextPageMeta ContextMeta PageMeta RequestMeta Obvezno: Metapodatki odgovora.

Primer: {"request_id":"example-request"}

Dodatna polja: Ne

ApiResponse[ImportData]

ApiResponse_ImportData_ · Preveri stanje, različico in potrditev. Osnutek pripada ključu API, ki ga je ustvaril.

dataImportData Obvezno: Vsebina uspešnega odgovora.

Primer: {"delivery_id":null,"delivery_status":null,"delivery_version":null,"expected_count":2,"expires_at":"2026-11-03T13:00:00Z","id":"00000000-0000-4000-8000-000000000001","kind":"code","product_id":"example","status":"validated","validated_count":2,"validation_digest":"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb","version":2}
metaContextPageMeta ContextMeta PageMeta RequestMeta Obvezno: Metapodatki odgovora.

Primer: {"request_id":"example-request"}

Dodatna polja: Ne

Prikaži seznam · Zaloge — Zaloga — Odgovor

ApiResponse_list_StockData__ · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

dataPolje elementov <StockData > Obvezno: Primer odgovora · ApiResponse_list_StockData__.

Primer: [{"active":true,"available":5,"id":"stock_v1_WyJleGFtcGxlIiwicHJvZHVjdCIsImV4YW1wbGUiXQ","manual_reserved":2,"on_hand":10,"reserved":3,"sellable_limit":10,"target_id":"example","target_type":"product","total_reserved":5,"updated_at":"2026-01-01T12:00:00Z","version":1,"warehouse_id":"example"}]
metaContextPageMeta ContextMeta PageMeta RequestMeta Obvezno: Metapodatki odgovora.

Primer: {"pagination":{"has_more":false,"limit":20,"next_cursor":null},"request_id":"example"}

Dodatna polja: Ne

ApiResponse[PoolData]

ApiResponse_PoolData_ · Pred spremembo preberi nastavitve in količine. Odgovor ne vsebuje kod ali vsebine datotek.

dataPoolData Obvezno: Vsebina uspešnega odgovora.

Primer: {"configured":true,"counts":{"available":1,"held":0,"issued":1,"planned":0,"retired":0,"staged":0},"email_mode":"order_link","enabled":true,"order_version":2,"product_id":"example","retention_days":null,"version":1}
metaContextPageMeta ContextMeta PageMeta RequestMeta Obvezno: Metapodatki odgovora.

Primer: {"request_id":"example-request"}

Dodatna polja: Ne

Pridobi · Zaloge — Zaloga — Odgovor

ApiResponse_StockDetailData_ · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

dataStockDetailData Obvezno: Primer odgovora · StockDetailData.

Primer: {"active":true,"allocations":[{"location_code":"example","location_id":"example","location_name":"example","on_hand":10}],"available":5,"id":"stock_v1_WyJleGFtcGxlIiwicHJvZHVjdCIsImV4YW1wbGUiXQ","manual_reserved":2,"on_hand":10,"reserved":3,"sellable_limit":10,"target_id":"example","target_type":"product","total_reserved":5,"updated_at":"2026-01-01T12:00:00Z","version":1,"warehouse_id":"example"}
metaContextPageMeta ContextMeta PageMeta RequestMeta Obvezno: Metapodatki odgovora.

Primer: {"request_id":"example"}

Dodatna polja: Ne

ApiResponse[UnitsData]

ApiResponse_UnitsData_ · Preberi največ 100 enot na stran. Seznam kaže metapodatke brez razkritja kod.

dataUnitsData Obvezno: Vsebina uspešnega odgovora.

Primer: {"order_version":2,"total":1,"units":[{"content_state":"present","delivery_id":"delivery-example","filename":null,"id":"00000000-0000-4000-8000-000000000003","issued_at":null,"kind":"code","location_id":"location-digital","mime_type":null,"payload_id":"00000000-0000-4000-8000-000000000004","product_id":"example","size_bytes":null,"sort_order":1,"state":"available","version":1,"warehouse_id":"warehouse-main"}]}
metaContextPageMeta ContextMeta PageMeta RequestMeta Obvezno: Metapodatki odgovora.

Primer: {"pagination":{"has_more":false,"limit":50,"next_cursor":null},"request_id":"example-request"}

Dodatna polja: Ne

CodeContentData

CodeContentData · Koda se vrne kot JSON, datoteka kot binarni podatki. Vsaka zahteva potrebuje Bearer in pravico reveal.

codeNizObvezno: Natančna digitalna koda. Ohranite velike črke in notranje presledke.

minLength: 1maxLength: 512

Primer: "DEMO-ONE"
delivery_idNiz nullIzbirno: ID dobave ali dodelitve naročila.

Niz:format: "uuid"

Primer: null
kindNizIzbirno: Vrsta podatkovne strukture, opisana z dovoljenimi vrednostmi.

const: "code"

Privzeto: "code"Primer: "code"
payload_idNizObvezno: ID vsebine; ni javni naslov za prenos.

format: "uuid"

Primer: "00000000-0000-4000-8000-000000000004"
unit_idNizObvezno: ID posamezne kode ali datoteke.

format: "uuid"

Primer: "00000000-0000-4000-8000-000000000003"

Dodatna polja: Ne

DigitalUploadCreate

DigitalUploadCreate · Rezerviraj prostor za datoteko in jo poveži z uvozom ali enoto za zamenjavo.

consumer_idNizObvezno

ID povezanega uvoza ali enote.

format: "uuid"

Primer: "00000000-0000-4000-8000-000000000001"

consumer_kindNizObvezno

Povezava prenosa: digital_import / digital_unit.

Omejitve

enum: ["digital_import", "digital_unit"]

Primer: "digital_import"

filenameNizObvezno

Datoteka

minLength: 1maxLength: 255

Primer: "codes.txt"

purposeNizObvezno

digital_import: TXT/CSV; digital_unit: posamično prodana datoteka.

Omejitve

enum: ["digital_unit", "digital_import"]

Primer: "digital_import"

sha256NizObvezno

SHA-256 (hex, 64)

Omejitve

pattern: "^[0-9a-f]{64}$"

Primer: "636e307039d9ca307836e9a93ea492425545bcccb6cb4ef935ab635560db828a"

size_bytesCelo številoObvezno

Velikost v bajtih

minimum: 1maximum: 262144000

Primer: 18

Dodatna polja: Ne

DigitalUploadData

DigitalUploadData · Preveri velikost, kontrolno vsoto in obliko. Končan prenos še ne pomeni prejete dobave.

consumer_idNizObvezno

ID povezanega uvoza ali enote.

format: "uuid"

Primer: "00000000-0000-4000-8000-000000000001"

consumer_kindNizObvezno

Povezava prenosa: digital_import / digital_unit.

Omejitve

enum: ["digital_import", "digital_unit"]

Primer: "digital_import"

expires_atNizObvezno

Čas poteka tega nalaganja ali uvoza.

format: "date-time"

Primer: "2026-11-03T13:00:00Z"

filenameNizObvezno

Datoteka

Primer: "codes.txt"

idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki.

format: "uuid"

Primer: "00000000-0000-4000-8000-000000000002"

product_idNizObvezno

Identifikator izdelka.

Primer: "example"

purposeNizObvezno

digital_import: TXT/CSV; digital_unit: posamično prodana datoteka.

Omejitve

enum: ["digital_unit", "digital_import"]

Primer: "digital_import"

received_bytesCelo številoObvezno

Nalaganje… · Velikost v bajtih

Primer: 18

sha256NizObvezno

SHA-256 (hex, 64)

Primer: "636e307039d9ca307836e9a93ea492425545bcccb6cb4ef935ab635560db828a"

size_bytesCelo številoObvezno

Velikost v bajtih

Primer: 18

statusNizObvezno

Status, ki ga sprejema ta operacija.

Primer: "ready"

Dodatna polja: Ne

ImportCommit

ImportCommit · Iz preverjene serije ustvari načrtovano ali prejeto dobavo. Načrtovane enote še niso naprodaj.

delivered_atNizObvezno

Datum in čas dostave.

format: "date-time"

Primer: "2026-11-03T12:00:00Z"

expected_delivery_versionCelo številoObvezno

Različica dobave; 0 za novo dobavo.

minimum: 0maximum: 0

Primer: 0

expected_sales_limit_versionCelo število nullIzbirno

Različica prodajne omejitve; obvezna pri publish_for_sale=true.

Celo število:minimum: 0maximum: 9223372036854775807

Primer: 0

expected_versionCelo številoObvezno

Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 1maximum: 9223372036854775807

Primer: 2

location_idNizObvezno

Identifikator lokacije skladišča.

Omejitve

pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"

Primer: "location-digital"

publish_for_saleLogična vrednostIzbirno

true poveča tudi končno prodajno omejitev; false je ne spremeni.

Privzeto: falsePrimer: true

statusNizObvezno

Status, ki ga sprejema ta operacija.

Omejitve

enum: ["planned", "received"]

Primer: "received"

validation_digestNizObvezno

Kontrolna vsota preverjanja; ob potrditvi jo pošlji nespremenjeno.

Omejitve

pattern: "^[0-9a-f]{64}$"

Primer: "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"

warehouse_idNizObvezno

Identifikator skladišča.

Omejitve

pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"

Primer: "warehouse-main"

Dodatna polja: Ne

ImportCreate

ImportCreate · Pripravi osnutek z največ 1000 kodami ali 100 datotekami. Prodajna zaloga se še ne poveča.

countCelo številoObvezno

Točno število enot v seriji.

minimum: 1maximum: 1000

Primer: 2

kindNizObvezno

Vrsta podatkovne strukture, opisana z dovoljenimi vrednostmi.

Omejitve

enum: ["code", "file"]

Primer: "code"

Dodatna polja: Ne

ImportData

ImportData · Preveri stanje, različico in potrditev. Osnutek pripada ključu API, ki ga je ustvaril.

delivery_idNiz nullObvezno

ID dobave ali dodelitve naročila.

Primer: null

delivery_statusNiz nullObvezno

Stanje dobave: planned / received; pred potrditvijo null.

Primer: null

delivery_versionCelo število nullObvezno

Trenutna različica skladiščne dobave.

Primer: null

expected_countCelo številoObvezno

Pričakovano število; sprejme se le celotna serija.

Primer: 2

expires_atNizObvezno

Čas poteka tega nalaganja ali uvoza.

format: "date-time"

Primer: "2026-11-03T13:00:00Z"

idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki.

format: "uuid"

Primer: "00000000-0000-4000-8000-000000000001"

kindNizObvezno

Vrsta podatkovne strukture, opisana z dovoljenimi vrednostmi.

Omejitve

enum: ["code", "file"]

Primer: "code"

product_idNizObvezno

Identifikator izdelka.

Primer: "example"

statusNizObvezno

Status, ki ga sprejema ta operacija.

Primer: "validated"

validated_countCelo številoObvezno

Število enot, sprejetih pri zadnjem uspešnem preverjanju.

Primer: 2

validation_digestNiz nullObvezno

Kontrolna vsota preverjanja; ob potrditvi jo pošlji nespremenjeno.

Primer: "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"

versionCelo številoObvezno

Različica vira za nadzor sočasnosti.

Primer: 2

Dodatna polja: Ne

ImportReceive

ImportReceive · Prejmi obstoječe enote brez ponovnega uvoza kod ali datotek.

expected_delivery_versionCelo številoObvezno: Različica dobave; 0 za novo dobavo.

minimum: 1maximum: 9223372036854775807

Primer: 1
expected_sales_limit_versionCelo število nullIzbirno: Različica prodajne omejitve; obvezna pri publish_for_sale=true.

Celo število:minimum: 0maximum: 9223372036854775807
expected_versionCelo številoObvezno: Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 1maximum: 9223372036854775807

Primer: 3
publish_for_saleLogična vrednostIzbirno: true poveča tudi končno prodajno omejitev; false je ne spremeni.

Privzeto: false

Dodatna polja: Ne

ImportValidate

ImportValidate · Preveri celotno serijo. Podvojena ali neveljavna postavka zavrne serijo; kode se ne krajšajo.

code_columnNiz nullIzbirno

Stolpec CSV s kodami; uporabi code.

Niz:const: "code"

expected_versionCelo številoObvezno

Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 1maximum: 9223372036854775807

Primer: 1

formatNiz nullIzbirno

Seznam kod: txt / csv; za datoteke uporabi upload_ids.

Omejitve · Niz 1

enum: ["txt", "csv"]

Primer: "txt"

source_upload_idNiz nullIzbirno

Pripravljen zasebni prenos TXT/CSV tega uvoza.

Niz:format: "uuid"

Primer: "00000000-0000-4000-8000-000000000002"

upload_idsPolje elementov <Niz> nullIzbirno

1–100 pripravljenih zasebnih prenosov datotek tega uvoza.

Polje elementov:minItems: 1maxItems: 100

Polje elementov / Polje elementov:format: "uuid"

Dodatna polja: Ne

ImportWithdrawal

ImportWithdrawal · Umakni samo proste enote. Rezervirane in dodeljene enote ostanejo povezane z naročili.

expected_delivery_versionCelo številoObvezno: Različica dobave; 0 za novo dobavo.

minimum: 1maximum: 9223372036854775807

Primer: 1
expected_order_versionCelo številoObvezno: Različica vrstnega reda dodeljevanja, ne kupčevega naročila.

minimum: 0maximum: 9223372036854775807

Primer: 1
expected_versionCelo številoObvezno: Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 1maximum: 9223372036854775807

Primer: 3
reasonNizObvezno: Zabeleženi razlog spremembe.

minLength: 1maxLength: 500

Primer: "Withdraw a revoked license"

Dodatna polja: Ne

Posodobi · Ročna rezervacija — Zaloga — Telo zahteve

ManualReservationUpdate · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

expected_versionCelo številoObvezno: Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 1maximum: 9223372036854775807

Primer: 1
manual_reservedCelo številoObvezno: Ročno rezervirana količina.

minimum: 0maximum: 2147483647

Primer: 1
reasonNizIzbirno: Zabeleženi razlog spremembe.

maxLength: 500

Privzeto: ""

Dodatna polja: Ne

PoolChange

PoolChange · Vključi posamezne kode ali datoteke od paketa Professional. Izklop ohrani dostop do prejšnjih nakupov.

email_modeNizIzbirno

disabled: brez e-pošte; order_link: povezava do naročila; code_text: možne tudi kode.

Omejitve

enum: ["disabled", "order_link", "code_text"]

Privzeto: "disabled"Primer: "order_link"

enabledLogična vrednostObvezno

Ali je nastavitev omogočena.

Primer: true

expected_versionCelo številoObvezno

Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 0maximum: 9223372036854775807

Primer: 0

retention_daysCelo število nullIzbirno

null: brez roka; 1–3650 dni od prvega dostopa. Kode se ne brišejo samodejno.

Celo število:minimum: 1maximum: 3650

Primer: null

Dodatna polja: Ne

PoolCounts

PoolCounts · Pred spremembo preberi nastavitve in količine. Odgovor ne vsebuje kod ali vsebine datotek.

availableCelo številoObvezno: Število prostih enot, ki niso rezervirane ali izdane.

Primer: 1
heldCelo številoObvezno: Enote, rezervirane za naročila, še niso izdane.

Primer: 0
issuedCelo številoObvezno: Enote, že izdane za plačane nakupe.

Primer: 1
plannedCelo številoObvezno: Enote potrjenih, še neprejetih dobav.

Primer: 0
retiredCelo številoObvezno: Umaknjene enote, ohranjene v zgodovini.

Primer: 0
stagedCelo številoObvezno: Enote nedokončanih uvozov, še niso zaloga.

Primer: 0

Dodatna polja: Ne

PoolData

PoolData · Pred spremembo preberi nastavitve in količine. Odgovor ne vsebuje kod ali vsebine datotek.

configuredLogična vrednostObvezno

Ali so nastavitve digitalne zaloge shranjene.

Primer: true

countsPoolCounts Obvezno

Število enot po stanju zaloge.

Primer: {"available":1,"held":0,"issued":1,"planned":0,"retired":0,"staged":0}

email_modeNizObvezno

disabled: brez e-pošte; order_link: povezava do naročila; code_text: možne tudi kode.

Omejitve

enum: ["disabled", "order_link", "code_text"]

Primer: "order_link"

enabledLogična vrednostObvezno

Ali je nastavitev omogočena.

Primer: true

order_versionCelo številoObvezno

Različica vrstnega reda dodeljevanja zaloge.

Primer: 2

product_idNizObvezno

Identifikator izdelka.

Primer: "example"

retention_daysCelo število nullObvezno

null: brez roka; 1–3650 dni od prvega dostopa. Kode se ne brišejo samodejno.

Primer: null

versionCelo številoObvezno

Različica vira za nadzor sočasnosti.

Primer: 1

Dodatna polja: Ne

Posodobi · Prodajna omejitev — Zaloga — Telo zahteve

SalesLimitUpdate · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

expected_versionCelo številoObvezno: Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 1maximum: 9223372036854775807

Primer: 1
reasonNizIzbirno: Zabeleženi razlog spremembe.

maxLength: 500

Privzeto: ""
sellable_limitCelo številoObvezno: Prodajna omejitev: -1 pomeni neomejeno, 0 pa onemogoči razpoložljivo prodajo.

minimum: -1maximum: 2147483647

Primer: 1

Dodatna polja: Ne

Ustvari · Popravek zalog — Zaloga — Telo zahteve

StockAdjustmentCreate · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

expected_versionCelo številoObvezno

Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 0maximum: 9223372036854775807

Primer: 0

locationsPolje elementov <LocationQuantity > Obvezno

Lokacije skladišča.

minItems: 1maxItems: 100

Primer: [{"location_id":"example","on_hand":1}]

reasonNizObvezno

Zabeleženi razlog spremembe.

minLength: 1maxLength: 500

Primer: "Example"

target_idNizObvezno

Identifikator izdelka ali različice, na katero vpliva operacija.

Omejitve

pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"

Primer: "example"

target_typeNizObvezno

Ali se operacija nanaša na izdelek ali različico.

Omejitve

enum: ["product", "variant"]

Primer: "product"

warehouse_idNizObvezno

Identifikator skladišča.

Omejitve

pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"

Primer: "example"

Dodatna polja: Ne

Posodobi · Zaloge — Zaloga — Telo zahteve

StockAdjustmentUpdate · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

expected_versionCelo številoObvezno: Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 1maximum: 9223372036854775807

Primer: 1
locationsPolje elementov <LocationQuantity > Obvezno: Lokacije skladišča.

minItems: 1maxItems: 100

Primer: [{"location_id":"example","on_hand":1}]
reasonNizObvezno: Zabeleženi razlog spremembe.

minLength: 1maxLength: 500

Primer: "Example"

Dodatna polja: Ne

Prikaži seznam · Zaloge — Zaloga — Odgovor

StockData · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

activeLogična vrednostObvezno

Ali je vir aktiven.

Primer: true

availableCelo število nullObvezno

Količina, razpoložljiva za prodajo; null pomeni neomejeno količino.

Primer: 5

idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki. (StockData).

Primer: "stock_v1_WyJleGFtcGxlIiwicHJvZHVjdCIsImV4YW1wbGUiXQ"

manual_reservedCelo številoObvezno

Ročno rezervirana količina.

Primer: 2

on_handCelo številoObvezno

Fizična količina na zalogi.

Primer: 10

reservedCelo številoObvezno

Količina, rezervirana z naročili.

Primer: 3

sellable_limitCelo številoObvezno

Prodajna omejitev: -1 pomeni neomejeno, 0 pa onemogoči razpoložljivo prodajo.

Primer: 10

target_idNizObvezno

Identifikator izdelka ali različice, na katero vpliva operacija.

Primer: "example"

target_typeNizObvezno

Ali se operacija nanaša na izdelek ali različico.

Omejitve

enum: ["product", "variant"]

Primer: "product"

total_reservedCelo številoObvezno

Skupna rezervirana količina.

Primer: 5

updated_atNizObvezno

Čas zadnje posodobitve.

format: "date-time"

Primer: "2026-01-01T12:00:00Z"

versionCelo številoObvezno

Različica vira za nadzor sočasnosti.

Primer: 1

warehouse_idNizObvezno

Identifikator skladišča.

Primer: "example"

Dodatna polja: Ne

Pridobi · Zaloge — Zaloga — Odgovor

StockDetailData · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

activeLogična vrednostObvezno

Ali je vir aktiven.

Primer: true

allocationsPolje elementov <AllocationData > Obvezno

Količine, dodeljene lokacijam skladišča.

Primer: [{"location_code":"example","location_id":"example","location_name":"example","on_hand":10}]

availableCelo število nullObvezno

Količina, razpoložljiva za prodajo; null pomeni neomejeno količino.

Primer: 5

idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki. (StockDetailData).

Primer: "stock_v1_WyJleGFtcGxlIiwicHJvZHVjdCIsImV4YW1wbGUiXQ"

manual_reservedCelo številoObvezno

Ročno rezervirana količina.

Primer: 2

on_handCelo številoObvezno

Fizična količina na zalogi.

Primer: 10

reservedCelo številoObvezno

Količina, rezervirana z naročili.

Primer: 3

sellable_limitCelo številoObvezno

Prodajna omejitev: -1 pomeni neomejeno, 0 pa onemogoči razpoložljivo prodajo.

Primer: 10

target_idNizObvezno

Identifikator izdelka ali različice, na katero vpliva operacija.

Primer: "example"

target_typeNizObvezno

Ali se operacija nanaša na izdelek ali različico.

Omejitve

enum: ["product", "variant"]

Primer: "product"

total_reservedCelo številoObvezno

Skupna rezervirana količina.

Primer: 5

updated_atNizObvezno

Čas zadnje posodobitve.

format: "date-time"

Primer: "2026-01-01T12:00:00Z"

versionCelo številoObvezno

Različica vira za nadzor sočasnosti.

Primer: 1

warehouse_idNizObvezno

Identifikator skladišča.

Primer: "example"

Dodatna polja: Ne

UnitData

UnitData · Preberi največ 100 enot na stran. Seznam kaže metapodatke brez razkritja kod.

content_stateNizObvezno

Stanje vsebine: present / deleting / deleted.

Primer: "present"

delivery_idNiz nullObvezno

ID dobave ali dodelitve naročila.

Primer: "delivery-example"

filenameNiz nullObvezno

Datoteka

Primer: null

idNizObvezno

Identifikator vira; ohranite ga v vrnjeni obliki.

format: "uuid"

Primer: "00000000-0000-4000-8000-000000000003"

issued_atNiz nullObvezno

Prva izdaja; pred njo null.

Niz:format: "date-time"

Primer: null

kindNizObvezno

Vrsta podatkovne strukture, opisana z dovoljenimi vrednostmi.

Omejitve

enum: ["file", "code"]

Primer: "code"

location_idNiz nullObvezno

Identifikator lokacije skladišča.

Primer: "location-digital"

mime_typeNiz nullObvezno

Vrsta medijske vsebine.

Primer: null

payload_idNizObvezno

ID vsebine; ni javni naslov za prenos.

format: "uuid"

Primer: "00000000-0000-4000-8000-000000000004"

product_idNizObvezno

Identifikator izdelka.

Primer: "example"

size_bytesCelo število nullObvezno

Velikost v bajtih

Primer: null

sort_orderCelo številoObvezno

Položaj v urejeni zbirki.

Primer: 1

stateNizObvezno

Stanje

Primer: "available"

versionCelo številoObvezno

Različica vira za nadzor sočasnosti.

Primer: 1

warehouse_idNiz nullObvezno

Identifikator skladišča.

Primer: "warehouse-main"

Dodatna polja: Ne

UnitDeletion

UnitDeletion · Odstrani neprodano kodo ali datoteko z razlogom. Rezervirane ali dodeljene enote se zavrnejo.

expected_versionCelo številoObvezno: Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 1

Primer: 1
reasonNizObvezno: Zabeleženi razlog spremembe.

minLength: 1maxLength: 500

Primer: "Withdraw a revoked license"

Dodatna polja: Ne

UnitReorder

UnitReorder · Pošlji celotno nefiltrirano stran v želenem vrstnem redu. Zastarela različica vrne 409.

expected_order_versionCelo številoObvezno: Različica vrstnega reda dodeljevanja, ne kupčevega naročila.

minimum: 1

Primer: 1
unit_idsPolje elementov <Niz> Obvezno: Vse enote nefiltrirane strani v želenem vrstnem redu.

minItems: 2maxItems: 100
Polje elementov:format: "uuid"

Primer: ["00000000-0000-4000-8000-000000000008","00000000-0000-4000-8000-000000000003"]
window_cursorNiz nullIzbirno: Kazalec nefiltrirane strani; null za prvo stran.

Niz:maxLength: 1024

Dodatna polja: Ne

UnitReplacement

UnitReplacement · Zamenjaj kodo ali datoteko brez spremembe vrstnega reda. Sprememba ostane v zgodovini skladišča.

codeNiz nullIzbirno: Natančna digitalna koda. Ohranite velike črke in notranje presledke.

Niz:minLength: 1maxLength: 512

Primer: "SYNTHETIC-REPLACEMENT"
expected_versionCelo številoObvezno: Različica, prebrana pred zapisom; neujemanje zavrne posodobitev.

minimum: 1

Primer: 1
reasonNizObvezno: Zabeleženi razlog spremembe.

minLength: 1maxLength: 500

Primer: "Replace an invalid activation code"
upload_idNiz nullIzbirno: Identifikator vira; ohranite ga v vrnjeni obliki. · upload_id

Niz:format: "uuid"

Dodatna polja: Ne

UnitsData

UnitsData · Preberi največ 100 enot na stran. Seznam kaže metapodatke brez razkritja kod.

order_versionCelo številoObvezno: Različica vrstnega reda dodeljevanja zaloge.

Primer: 2
totalCelo številoObvezno: Skupni znesek.

Primer: 1
unitsPolje elementov <UnitData > Obvezno: Metapodatki enot; vsebina zahteva ločeno pooblaščeno zahtevo.

Primer: [{"content_state":"present","delivery_id":"delivery-example","filename":null,"id":"00000000-0000-4000-8000-000000000003","issued_at":null,"kind":"code","location_id":"location-digital","mime_type":null,"payload_id":"00000000-0000-4000-8000-000000000004","product_id":"example","size_bytes":null,"sort_order":1,"state":"available","version":1,"warehouse_id":"warehouse-main"}]

Dodatna polja: Da