Inventario

Consulta existencias y aplica ajustes, límites de venta y reservas manuales controlados.

Operaciones

Listar · Existencias — InventarioVer stock de productos, almacenes y ubicaciones internas. GET Crear · Ajuste de existencias — InventarioCambiar las cantidades de productos físicos y vendibles. POST Obtener · Existencias — InventarioVer stock de productos, almacenes y ubicaciones internas. GET Actualizar · Existencias — InventarioCambiar las cantidades de productos físicos y vendibles. PATCH Actualizar · Reserva manual — InventarioCambiar reservas manuales. Para operaciones de integraciones externas. PATCH Actualizar · Límite de ventas — InventarioCambiar límites de venta. Para operaciones de integraciones externas. PATCH Crear una importaciónPrepara un borrador con hasta 1000 códigos o 100 archivos. Todavía no aumenta las existencias a la venta. POST Cancelar una importaciónDescarta un borrador sin terminar. Esta operación no retira una entrega ya confirmada. DELETE Consultar una importaciónComprueba su estado, versión y validación. El borrador pertenece a la clave API que lo creó. GET Confirmar una entregaCrea una entrega prevista o recibida con el lote validado. Una entrega prevista aún no se puede vender. POST Recibir una entrega previstaRecibe las unidades existentes sin volver a importar sus códigos o archivos. POST Validar una importaciónComprueba el lote completo. Los duplicados o entradas incorrectas rechazan el lote; los códigos nunca se recortan. POST Retirar una entregaRetira solo las unidades libres. Las reservadas y asignadas siguen vinculadas a sus pedidos. POST Consultar el inventario digitalLee la configuración y las cantidades antes de cambiarlas. La respuesta no incluye códigos ni archivos. GET Configurar el inventario digitalActiva códigos o archivos individuales desde Professional. Al desactivarlos se conserva el acceso a compras anteriores. PATCH Listar unidadesConsulta hasta 100 unidades por página. La lista muestra metadatos sin revelar los códigos. GET Cambiar el orden de asignaciónEnvía la página completa sin filtros en el orden deseado. Una versión desactualizada devuelve 409. POST Leer una unidad libreLos códigos se devuelven en JSON y los archivos en binario. Cada petición exige Bearer y el permiso reveal. GET Comprobar acceso a una unidad libreComprueba los mismos permisos que GET sin descargar contenido. No reserva la unidad. HEAD Eliminar una unidad libreRetira un código o archivo sin vender e indica el motivo. No admite unidades reservadas ni asignadas. POST Sustituir una unidad libreCambia el código o archivo sin alterar su posición. El cambio queda en el historial del almacén. POST Preparar una subida privadaReserva espacio para un archivo y vincúlalo a una importación o a la unidad que sustituirá. POST Comprobar una subidaComprueba tamaño, suma de verificación y formato. Una subida lista todavía no confirma la recepción de existencias. GET Subir un archivoEnvía el archivo mediante multipart/form-data y HTTPS. No envíes Base64 ni una URL para descargar. PUT

Cómo funciona

Los registros de existencias distinguen la cantidad física on_hand, las reservas de pedidos, las reservas manuales y la cantidad disponible para la venta. Utiliza el identificador y la versión de existencias devueltos; las existencias de productos y variantes son destinos diferentes.

Un sellable_limit de -1 significa ilimitado, mientras que 0 significa que no hay disponibilidad para la venta. La disponibilidad ilimitada se representa con null en available. No interpretes null como cero. Los ajustes, límites de venta y reservas manuales tienen operaciones y permisos independientes.