Aller au contenu
ShopentlyLearn

Stocks

Consultez les stocks et appliquez des ajustements, limites de vente et réservations manuelles contrôlés.

Opérations

Lister · Stocks — StocksConsultez le stock de produits, les entrepôts et les emplacements internes. GET Créer · Ajustement de stock — StocksModifier les quantités de produits physiques et vendables. POST Obtenir · Stocks — StocksConsultez le stock de produits, les entrepôts et les emplacements internes. GET Modifier · Stocks — StocksModifier les quantités de produits physiques et vendables. PATCH Modifier · Réservation manuelle — StocksModifier les réservations manuelles. Pour les opérations des intégrations externes. PATCH Modifier · Limite de vente — StocksModifier les limites de vente. Pour les opérations des intégrations externes. PATCH Créer un importPréparez un brouillon de 1000 codes ou 100 fichiers au maximum. Le stock vendable ne change pas encore. POST Annuler un importAbandonnez un brouillon inachevé. Cette opération ne retire pas une livraison déjà confirmée. DELETE Consulter un importVérifiez son état, sa version et sa validation. Le brouillon appartient à la clé API qui l’a créé. GET Confirmer une livraisonCréez une livraison prévue ou reçue à partir du lot validé. Une livraison prévue n’est pas encore vendable. POST Réceptionner une livraison prévueRéceptionnez les éléments existants sans importer une seconde fois leurs codes ou fichiers. POST Valider un importVérifiez le lot complet. Un doublon ou une entrée incorrecte rejette le lot ; les codes ne sont jamais tronqués. POST Retirer une livraisonRetirez uniquement les unités libres. Les unités réservées ou attribuées restent liées à leurs commandes. POST Lire les paramètres du stock numériqueConsultez les réglages et les quantités avant toute modification. La réponse ne contient ni codes ni fichiers. GET Modifier le stock numériqueActivez les codes ou fichiers individuels à partir de Professional. La désactivation conserve les accès des achats antérieurs. PATCH Lister les unitésConsultez au maximum 100 unités par page. La liste fournit les métadonnées sans révéler les codes. GET Modifier l’ordre d’attributionEnvoyez toute la page non filtrée dans l’ordre souhaité. Une version périmée renvoie 409. POST Lire une unité libreUn code est renvoyé en JSON, un fichier en binaire. Chaque requête exige Bearer et le droit reveal. GET Vérifier l’accès à une unité libreVérifiez les mêmes droits que GET sans télécharger le contenu. Cela ne réserve pas l’unité. HEAD Retirer une unité libreRetirez un code ou fichier invendu en indiquant le motif. Les unités réservées ou attribuées sont refusées. POST Remplacer une unité libreRemplacez le code ou fichier sans changer sa place. La modification figure dans l’historique du stock. POST Préparer un envoi privéRéservez l’espace d’un fichier et rattachez-le à un import ou à l’unité à remplacer. POST Vérifier un envoiVérifiez la taille, la somme de contrôle et le format. Un envoi prêt ne signifie pas que la livraison est réceptionnée. GET Envoyer un fichierTransmettez le fichier en multipart/form-data par HTTPS. N’envoyez ni Base64 ni URL à récupérer. PUT

Fonctionnement

Les enregistrements distinguent la quantité physique on_hand, les réservations de commandes, les réservations manuelles et la quantité vendable. Utilisez l'identifiant de stock et la version renvoyés. Les stocks d'un produit et d'une variante sont des cibles distinctes.

sellable_limit égal à -1 signifie illimité, tandis que 0 signifie aucune vente disponible. Une disponibilité illimitée est représentée par null dans available. Ne traitez pas null comme zéro. Ajustements, limites de vente et réservations manuelles utilisent des opérations et autorisations distinctes.