Stock disponible o cantidad exacta: qué demuestra realmente el dato

Un estado «disponible» solo demuestra que una fuente presenta el artículo como pedible en el momento observado; no indica el número de unidades. Una cantidad exacta, por ejemplo 27, aporta una información más precisa, pero no garantiza ni reserva, ni ausencia de pedidos de la competencia, ni entrega. Conserva, por tanto, el valor bruto, su tipo, su fuente y su marca de tiempo. No conviertas nunca InStock en 1 o en una cantidad supuesta. Para comprar, aplica el mínimo y el incremento de pedido a una cantidad numérica reciente, y solicita confirmación si lo que está en juego supera lo que el dato demuestra.

Cinco formas de stock que no hay que fusionar

Los catálogos utilizan vocabularios muy diferentes. Un campo llamado stock puede contener un entero, true, un texto como «en 5 días», una clase de umbral o una fecha de reabastecimiento. Antes de cualquier cálculo, asigna una categoría de prueba.

Schema.org define ItemAvailability como una lista de estados posibles asociados a una oferta, entre ellos InStock, OutOfStock, BackOrder o PreOrder. La página InStock indica simplemente que el artículo está en stock. No especifica ninguna cantidad. Esta convención es útil para interpretar un dato estructurado público, pero no constituye una garantía comercial del proveedor.

La cantidad exacta sigue siendo una observación, no una promesa

Incluso cuando un proveedor expone stock_quantity=27, quedan tres preguntas abiertas: ¿a qué hora se calculó la cantidad, para qué almacén y qué parte ya está reservada? El mismo número puede ser global, local, disponible para la venta o físico antes de compromisos. La documentación debe indicar el alcance.

Conserva campos distintos: stock_raw, stock_type, stock_quantity, availability, warehouse_scope, source_generated_at y observed_at. Si la fuente proporciona una cantidad exacta pero ningún alcance de almacén, no completes este último con una suposición. Una información incompleta puede seguir siendo utilizable con una advertencia; una información inventada no.

La política de actualidad del precio y el stock debe aplicarse antes de cualquier uso. Una cantidad antigua no se vuelve booleana: sigue siendo una cantidad histórica, marcada como caducada para las acciones que exigen una observación reciente.

Cantidad comprable, MOQ e incremento de pedido

El stock y la cantidad pedible no son lo mismo. Supongamos, como ejemplo hipotético, que una fuente muestra 27 unidades, un pedido mínimo de 10 y un incremento de 5. Las cantidades conformes serían entonces 10, 15, 20 o 25 dentro del límite del stock observado. Un pedido de 12 no respeta el incremento, y 30 supera el stock mostrado. Esta lógica depende de la definición contractual del MOQ y del incremento; no debe deducirse de un título o una foto.

Añade el envase: una caja anunciada con seis unidades puede significar que stock_quantity=27 cuenta cajas o unidades. Mientras la unidad de la cantidad no esté documentada, el cálculo de compra debe permanecer bloqueado. La lectura de las columnas del catálogo de mayorista permite detectar estas dependencias antes de importar.

Una regla segura sigue este orden:

1. Identificar la unidad de venta. 2. Verificar el contenido del envase con una prueba estructurada o contractual. 3. Leer el MOQ y el incremento como campos separados. 4. Clasificar el stock según el nivel de prueba. 5. Aplicar la actualidad a la observación. 6. Calcular las cantidades conformes solo si las unidades son compatibles. 7. Confirmar con el proveedor justo antes del pedido.

Los valores vacíos, cero y negativos

0 puede representar razonablemente una ausencia de cantidad si la documentación del campo lo confirma. Una celda vacía no es equivalente: puede traducir una información no disponible, un producto no gestionado o un error. Trata null, cadena vacía y campo ausente como estados distintos durante el diagnóstico, y mapéalos únicamente a partir de la documentación.

Una cantidad negativa puede representar un remanente en un sistema interno, pero no es una cantidad disponible para vender. Recházala del campo stock_quantity utilizable y consérvala en el valor bruto con un motivo. Del mismo modo, un decimal para un producto vendido por unidad debe ponerse en revisión; para un producto medido por peso, puede ser legítimo. El contexto de la unidad decide.

No ocultes nunca un problema sustituyendo todas las anomalías por cero. Esta práctica confunde la ausencia de prueba con una rotura de stock certera y distorsiona los diagnósticos de fuente.

Verificar un stock con un lote canario

Un lote canario de proveedor debería incluir al menos estados variados: producto disponible, rotura, valor vacío, cantidad baja, posible reabastecimiento y varias variantes. El objetivo no es agotar el catálogo, sino confrontar el parser con los casos que cambian la decisión.

Para cada línea, compara la respuesta bruta, la ficha oficial autorizada y el campo normalizado. Espera una actualización prevista o realiza una nueva observación con la cadencia permitida para verificar que las transiciones se gestionan correctamente. Un producto que pasa de InStock a OutOfStock no debe conservar una cantidad procedente de una recogida anterior.

Checklist de prueba del stock

• ☐ El valor bruto está conservado.
• ☐ Booleano, cantidad, umbral, plazo y desconocido están separados.
• ☐ La unidad de la cantidad está documentada.
• ☐ El almacén o el alcance se indica si se proporciona.
• ☐ La marca de tiempo de origen no se confunde con la hora del script.
• ☐ Un valor vacío no se transforma en cero.
• ☐ MOQ, incremento de pedido y envase están separados.
• ☐ Una cantidad caducada no desencadena una decisión silenciosa.
• ☐ Una transición de disponibilidad borra los derivados incompatibles.
• ☐ La disponibilidad se confirma antes de la compra.

Lo que ArbitragePro+ puede automatizar / lo que el vendedor debe verificar

La especificación propuesta controle-stock podría tipar cada valor, impedir la conversión de un booleano en cantidad, aplicar las reglas de actualidad y señalar las incoherencias con el MOQ, el incremento o el envase. El informe debería mostrar siempre la prueba bruta.

El vendedor debe confirmar el significado contractual del stock, la unidad, el alcance del almacén, las reservas eventuales y la cantidad realmente aceptada en el momento del pedido.

Controlar la salud de un dato de stock

Abrir la salud de las fuentes para examinar la información de disponibilidad y recogida disponible.

Fuentes oficiales

• Schema.org, «ItemAvailability», https://schema.org/ItemAvailability — consultado el 2026-08-17.
• Schema.org, «InStock», https://schema.org/InStock — consultado el 2026-08-17.
• IETF, RFC 9110, «HTTP Semantics», https://www.rfc-editor.org/rfc/rfc9110.html — consultado el 2026-08-17.