Glossário
Os termos da operação de loja e da API que aparecem nos guias, explicados em uma frase cada.
Operação de loja
| Termo | O que é |
|---|---|
| Loja | Qualquer unidade onde a operação acontece: loja, centro de distribuição (CD) ou fábrica |
| Código de integração | O código da loja no seu ERP, cadastrado também no BIX. É ele que liga as duas pontas |
| Código interno | O código do produto no seu ERP. Um mesmo produto pode ter vários códigos de barras |
| EAN | O código de barras. A unidade, a caixa e o fardo do mesmo produto têm EANs diferentes |
| Multiplicador | Quantas unidades um código de barras representa: a caixa com 12 tem multiplicador 12 |
| Estrutura mercadológica | A árvore de categorias da loja, em até cinco níveis (ex.: Mercearia › Arroz e Feijão) |
| Curva ABC | A importância do produto na venda: A vende muito, C vende pouco |
| Gôndola | A prateleira da área de venda, onde o cliente pega o produto |
| PDV | O ponto de venda: o caixa, onde o preço é cobrado |
Módulos do BIX
| Termo | O que é |
|---|---|
| Contagem (inventário) | A loja conta o estoque com o app, e o BIX compara com o saldo do ERP |
| Divergência | A diferença entre o que foi contado e o saldo esperado. Pode virar recontagem e ajuste |
| Ruptura | O produto que falta na gôndola |
| Ruptura de gôndola | O produto está no estoque da loja, mas não está na prateleira. É a ruptura que dá para resolver na hora |
| Ruptura por não venda | A ruptura que o BIX deduz da venda: o produto parou de vender muito antes do normal para o giro dele |
| Validade | O controle das datas de validade por loja, produto e lote |
| Alerta (verde, amarelo, vermelho) | A cor que a regra do cliente dá para os dias que faltam até o vencimento |
| Rebaixa | O desconto aplicado ao produto perto do vencimento, para vender antes de vencer |
| Código de barras de vencimento | Um segundo código do produto, só para a etiqueta da rebaixa: o caixa cobra o preço rebaixado só de quem bipa esse código |
| Vigência | O período em que a rebaixa vale (de starts_on a ends_on) |
| WMS | O controle do estoque por endereço dentro da loja |
| Depósito | Uma divisão do estoque da loja: estoque de loja, depósito, avaria |
| Endereço | A posição física do produto: rua, prédio, nível, apartamento |
| A endereçar | O endereço de espera de cada depósito: a mercadoria que entrou e ainda não foi guardada |
| Item de estoque | O código que o WMS usa para controlar o saldo de um produto (em geral, a unidade) |
| Livro de movimentações | O registro de tudo o que mexeu no estoque. Não se altera: uma correção é um novo lançamento |
API
| Termo | O que é |
|---|---|
| Chave de API | A credencial do integrador, criada pelo administrador do BIX do cliente. Vai em toda chamada |
| Escopo | O que a chave pode fazer. Ler e enviar são escopos separados |
| Ambiente | O endereço do BIX de cada cliente. A chave só vale no ambiente em que foi criada |
| Sandbox | O ambiente de testes, com dados fictícios |
| Paginação | Listas grandes vêm em páginas de até 100 itens |
| Sincronização incremental | Buscar só o que mudou desde a última leitura (updated_since) |
| Lote | Um envio com vários itens (até 500), cada um com o seu resultado |
| Idempotência | Poder repetir uma chamada sem gravar duas vezes. É o que o Idempotency-Key garante |
| Evento | O aviso de que algo aconteceu no BIX: uma tarefa terminou, um dado mudou |
| Webhook | O endereço do seu sistema que recebe os eventos do BIX, por POST |
Código de erro (code) |
O identificador fixo de cada erro. Seu sistema decide por ele, não pelo texto |