# Matriz funcional baseada na documentação do Bling

Esta matriz usa o Bling como referência de fluxo e linguagem de usuário, sem copiar código, identidade visual ou regras comerciais proprietárias.

## Princípios adotados

- Cadastro de produto concentra os dados reutilizados por venda, estoque, fiscal e canais.
- SKU é a chave operacional de integração; GTIN é identificador comercial/fiscal.
- Pedidos externos passam por uma caixa de entrada idempotente e podem ser conferidos antes da venda interna.
- Estoque só é sincronizado após vínculo inequívoco entre anúncio e variante.
- Baixa financeira pode ser parcial e seu estorno preserva auditoria.
- Nota fiscal é conferida antes da emissão e apresenta erros por campo.

## Campos comparados

| Área | Já existe no N4STi | Próxima evolução |
|---|---|---|
| Produto | nome, SKU, unidade, preço, tipo, categoria, marca, NCM, CEST, EAN, variações e imagens | condição, peso/dimensões, volumes, GTIN tributável, validade, garantia, fornecedor/custo e descrição multicanal |
| Venda | cliente, itens, depósito, desconto, frete, pagamento, representante, transportadora e notas | parcelas estruturadas, endereço alternativo e número de compra do cliente |
| Compra | fornecedor, itens, custo, previsão, aprovação e recebimento parcial | frete/desconto, devolução, qualidade e importação CSV/XML |
| Financeiro | pagar/receber, contas, baixa parcial, estorno e CNAB | categorias, parcelas, centro de custo, DRE, fluxo e OFX |
| Mercado Livre | OAuth, webhook, pedidos externos e vínculos de produto | tela de vinculação SKU/GTIN, conversão, status, anúncios, preço, estoque e logística |
| Fiscal | NF-e/NFC-e/NFS-e estruturadas, prévias e XML | homologação por cenário, inutilização, CC-e, DANFE NFC-e e transmissão NFS-e |

## Fluxos usados como referência

- Produto: dados básicos primeiro; detalhes fiscais/logísticos em seguida.
- Mercado Livre: importação automática e manual, mapeamento de status e estorno em cancelamento/devolução.
- Anúncios: associação automática somente por SKU ou GTIN exato, com revisão manual quando não houver correspondência.
- Financeiro: baixa parcial altera a situação sem apagar o título.
- Fiscal: campos obrigatórios são verificados ao salvar/emitir e o aviso informa o que deve ser corrigido.