Validades
Envie as datas de validade dos lotes que o ERP conhece e leia as validades com a cor do alerta.
Enviar
{
"items": [
{"store_code": "0012", "internal_code": "1001", "expiry_date": "2026-11-20",
"quantity": 36, "batch": "L2611", "entry_date": "2026-11-03"}
]
}
| Regra | Detalhe |
|---|---|
| Só insere | A validade da mesma loja, produto e data que já existe não é alterada: volta skipped. Quantidade, baixa e auditoria do lote ficam com a operação na loja |
| Lotes somados | Lotes do mesmo produto, loja e data no mesmo envio viram um registro, com as quantidades somadas |
| Produto cadastrado | O produto precisa existir no BIX (internal_code ou ean) |
| Data | AAAA-MM-DD (também aceita DD/MM/AAAA) |
Mande a validade quando o lote entra na loja (o recebimento da nota). É o que dá tempo de a rebaixa agir antes do vencimento.
Ler
Cada validade traz a cor do alerta (alert), que a regra do cliente dá para os dias que faltam, e
days_to_expire, calculado na hora da consulta. A validade vem de qualquer origem: ERP, coleta
pelo app, auditoria ou planilha (source).
| Quero… | Use |
|---|---|
| Só as vermelhas | alert=red |
| Vencendo até uma data | expiry_to=2026-11-30 |
| Só o que mudou | updated_since com include_inactive=true (a validade é desativada quando o lote acaba) |