Developers
Novidades

Novidades

Toda mudança da API pública, da mais recente para a mais antiga. Dentro da v1 a API só ganha coisas: nada é removido sem uma versão nova. Ver Versionamento.

10/11/2026 · O caminho de volta: do BIX para o ERP

  • A API passa a se chamar API pública. O endereço continua /external-api/v1: nada muda para quem já integrou.
  • Guias novos: a prévia de eventos e webhooks (o BIX vai avisar quando uma tarefa termina ou um dado muda), o que o ERP precisa ter para receber a contagem do inventário e o que o ERP precisa ter para receber a promoção da rebaixa.

10/11/2026 · Ruptura e venda diária

  • POST /sales/daily: a venda do dia por loja e código de barras, com o perfil por hora (contrato bix.sales.daily/v1). Base da ruptura por não venda e do encerramento da rebaixa.
  • GET /rupture/items: o que a loja encontrou em cada produto auditado.
  • GET /rupture/signals: as rupturas prováveis apontadas pela venda.
  • Escopos novos: sales.write, rupture.read.
  • Guias novos: o que integrar para a Ruptura, venda diária, rupturas.

10/11/2026 · Validade e rebaixa

  • POST /expiries: o ERP envia as validades dos lotes (só insere; lotes do mesmo dia são somados).
  • GET /expiries: validades com a cor do alerta e os dias para vencer.
  • GET /markdowns: as rebaixas no layout do contrato bix.markdown.publication/v1.
  • POST /markdowns/publications: o ERP confirma a rebaixa aplicada, recusada ou retirada do PDV.
  • Escopos novos: expiry.read, expiry.write, markdown.read, markdown.write.
  • Guias novos: o que integrar para a Validade, validades, rebaixa.

10/11/2026 · WMS para o ERP

  • POST /wms/movements: o ERP lança entradas, saídas e vendas. Sem endereço, vai para o "A endereçar" do depósito. O external_id de cada linha impede lançar duas vezes.
  • GET /wms/movements: o livro de movimentações, com cursor since_id, inclusive os ajustes de inventário feitos pela operação.
  • GET /wms/bin-stocks: saldo por endereço, lote e validade.
  • GET /wms/storage-locations, /wms/bins e /wms/reasons: depósitos, endereços e motivos.
  • Escopos novos: wms.structure.read, wms.movements.read, wms.movements.write.
  • Guias novos: o que integrar no WMS, estrutura e saldo por endereço, movimentações.

10/11/2026 · Cadastros base

  • GET /stores: as lojas do cliente, com o código de integração.
  • GET e POST /products: cadastro de produtos, criar ou atualizar em lote pela chave (internal_code, ean), com atualização parcial.
  • GET e POST /categories: estrutura mercadológica, em até cinco níveis.
  • GET e POST /stock-prices: preço, saldo, curva e custos por loja e depósito.
  • GET e POST /suppliers e /buyers: fornecedores e compradores.
  • GET e POST /store-groups: grupos de lojas.
  • Envio em lote (até 500 itens, resultado por item) e cabeçalho Idempotency-Key em todo POST.
  • Novo código de erro: idempotency_key_reused (409).
  • Escopos novos: stores.read, catalog.read, catalog.write, store_groups.write, stock_prices.read, stock_prices.write.
  • Guia novo: o que integrar para usar a Contagem.

10/11/2026 · Portal do desenvolvedor

  • Este portal: guias de integração, referência da API gerada do código e busca.

09/11/2026 · v1.0.0, primeira versão

  • API pública em https://<ambiente>.appbix.com.br/external-api/v1, com chave por integrador, escopos, lojas permitidas, expiração e log de cada chamada.
  • GET /wms/stock-balances: saldo atual do WMS por loja e produto.