Scorte

Leggi le scorte e applica rettifiche controllate, limiti di vendita e prenotazioni manuali.

Operazioni

Elenca · Giacenze — ScorteVisualizza lo stock dei prodotti, i magazzini e le ubicazioni interne. GET Crea · Rettifica delle giacenze — ScorteModificare le quantità di prodotti fisici e vendibili. POST Recupera · Giacenze — ScorteVisualizza lo stock dei prodotti, i magazzini e le ubicazioni interne. GET Aggiorna · Giacenze — ScorteModificare le quantità di prodotti fisici e vendibili. PATCH Aggiorna · Prenotazione manuale — ScorteModificare le prenotazioni manuali. Per le operazioni delle integrazioni esterne. PATCH Aggiorna · Limite di vendita — ScorteModificare i limiti di vendita. Per le operazioni delle integrazioni esterne. PATCH Creare un’importazionePrepara una bozza con al massimo 1000 codici o 100 file. Le disponibilità in vendita non aumentano ancora. POST Annullare un’importazioneScarta una bozza incompleta. L’operazione non ritira una consegna già confermata. DELETE Consultare un’importazioneControlla stato, versione e convalida. La bozza appartiene alla chiave API che l’ha creata. GET Confermare una consegnaCrea una consegna prevista o ricevuta dal lotto convalidato. Una consegna prevista non è ancora vendibile. POST Ricevere una consegna previstaRicevi le unità esistenti senza importare nuovamente codici o file. POST Convalidare un’importazioneVerifica l’intero lotto. Duplicati o voci non valide fanno rifiutare il lotto; i codici non vengono troncati. POST Ritirare una consegnaRitira solo le unità libere. Quelle riservate o assegnate restano collegate ai rispettivi ordini. POST Leggere le impostazioni della scortaConsulta impostazioni e quantità prima di modificarle. La risposta non contiene codici o file. GET Configurare la scorta digitaleAttiva codici o file individuali da Professional. La disattivazione conserva gli accessi degli acquisti precedenti. PATCH Elencare le unitàLeggi fino a 100 unità per pagina. L’elenco mostra i metadati senza rivelare i codici. GET Cambiare l’ordine di assegnazioneInvia tutta la pagina senza filtri nell’ordine desiderato. Una versione superata restituisce 409. POST Leggere un’unità liberaI codici vengono restituiti in JSON, i file come dati binari. Ogni richiesta richiede Bearer e il permesso reveal. GET Verificare l’accesso a un’unità liberaControlla gli stessi permessi di GET senza scaricare il contenuto. L’unità non viene riservata. HEAD Rimuovere un’unità liberaRitira un codice o file invenduto indicando il motivo. Le unità riservate o assegnate sono escluse. POST Sostituire un’unità liberaSostituisci codice o file senza cambiarne la posizione. La modifica resta nella cronologia del magazzino. POST Preparare un caricamento privatoRiserva spazio per un file e collegalo a un’importazione o all’unità da sostituire. POST Controllare un caricamentoVerifica dimensione, checksum e formato. Un caricamento pronto non equivale a una consegna ricevuta. GET Caricare un fileInvia il file con multipart/form-data tramite HTTPS. Non inviare Base64 o un URL da recuperare. PUT

Principi

I record distinguono quantità fisica on_hand, prenotazioni degli ordini, prenotazioni manuali e quantità disponibile alla vendita. Usa identificativo e versione del record restituiti; scorte del prodotto e della variante sono destinazioni distinte.

sellable_limit uguale a -1 indica assenza di limite, mentre 0 impedisce la disponibilità alla vendita. Una disponibilità illimitata viene esposta come null in available. Non interpretare null come zero. Rettifiche, limiti di vendita e prenotazioni manuali hanno operazioni e permessi separati.