Developers

Validades

Envie as datas de validade dos lotes que o ERP conhece e leia as validades com a cor do alerta.

Enviar

POST/expiries

{
  "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

GET/expiries

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)