Dicionário de dados
Abaixo estão os schemas das cinco entidades aceitas. Todos os arquivos devem ser enviados no formato CSV com encoding UTF-8 e separador vírgula.
Os nomes das colunas são combinados no onboarding
A ingestão usa nomes canônicos próprios e aceita um mapeamento de colunas por parceiro. Confirme com o time quais nomes valem para você antes da primeira carga — você não precisa mudar o seu export, mas o mapeamento precisa existir.
Lojas
| Campo | Tipo | Obrig. | Descrição | Exemplo |
|---|---|---|---|---|
location_name | Texto | Sim | Nome/descrição da loja | Loja Shopping SP |
location_code | Texto | Sim | Código único (CNPJ ou ID comercial) | S74 |
is_active | Booleano | Sim | Status da loja (true / false) | true |
category | Texto | Não | Ramo de atuação | Alimentação |
cep | Numérico | Não | CEP da loja | 81000-000 |
uf | Texto | Não | UF do estado | SP |
city | Texto | Não | Cidade | São Paulo |
segment | Texto | Não | Segmento da loja | Alimentação |
channel | Texto | Não | Canal de vendas (varejo, atacado) | Varejo |
Produtos
| Campo | Tipo | Obrig. | Descrição | Exemplo |
|---|---|---|---|---|
product_name | Texto | Sim | Nome/descrição do produto | Bateria p/Celular |
product_code | Texto | Sim | Código único (SKU) | P123 |
is_active | Booleano | Sim | Status do produto (true / false) | true |
category | Texto | Sim | Categoria | Smartphones |
sub_category | Texto | Não | Subcategoria | Android |
master_product | Texto | Não | Produto principal/agrupador | Galaxy |
multiple | Numérico | Não | Múltiplos de venda (padrão: 1) | 5.0 |
ean_code | Texto | Não | Código de barras internacional (GTIN/EAN) | 7891000001234 |
ncm_code | Texto | Não | Nomenclatura Comum do Mercosul (8 dígitos) | 2523.29.10 |
base_price | Decimal | Não | Preço base líquido unitário do produto — referência única para todas as lojas | 58.90 |
Preços
| Campo | Tipo | Obrig. | Descrição | Exemplo |
|---|---|---|---|---|
location_code | Texto | Sim | Código da loja (deve existir em Lojas) | L01 |
product_code | Texto | Sim | Código do produto (deve existir em Produtos) | P123 |
price_name | Texto | Sim | Nome da condição comercial. Identifica a linha e é referenciado em Orders | ATACADO |
unit_cost_price | Decimal | Sim | Custo unitário do produto (CMV) associado a esta condição | 25.00 |
unit_sale_price | Decimal | Sim | Valor líquido unitário de venda desta condição | 47.90 |
Inventory
Posição de estoque. Idealmente o fechamento de D-1.
| Campo | Tipo | Obrig. | Descrição | Exemplo |
|---|---|---|---|---|
location_code | Texto | Sim | Código da loja (deve existir em Lojas) | L01 |
product_code | Texto | Sim | Código do produto (deve existir em Produtos) | P123 |
date | Data | Sim | Data de fechamento do estoque (YYYY-MM-DD) | 2026-04-14 |
quantity | Numérico | Sim | Quantidade em estoque na data | 60.0 |
Orders
Cada item do pedido é um registro individual.
| Campo | Tipo | Obrig. | Descrição | Exemplo |
|---|---|---|---|---|
order_code | Texto | Sim | Código único do pedido | PED-20260414-001 |
location_code | Texto | Sim | Código da loja (deve existir em Lojas) | L01 |
product_code | Texto | Sim | Código do produto (deve existir em Produtos) | P123 |
date | Data | Sim | Data do pedido (YYYY-MM-DD) | 2026-04-14 |
quantity | Numérico | Sim | Quantidade solicitada no pedido | 15.0 |
unit_sale_price | Decimal | Sim | Valor líquido unitário de venda do item (já deduzidos descontos do item e impostos de saída) | 40.00 |
unit_cost_price | Decimal | Sim | Custo unitário do produto em estoque (CMV) associado a este pedido | 25.00 |
order_status | Texto | Sim | Status do pedido (pending / confirmed / shipped / delivered / cancelled) | confirmed |
price_name | Texto | Não | Condição comercial aplicada no item (deve existir em Preços) | ATACADO |
customer_code | Texto | Não | Código do cliente que fez o pedido | CLI-0472 |
delivery_date | Data | Não | Data prevista de entrega (YYYY-MM-DD) | 2026-04-21 |
freight_price | Decimal | Não | Valor total do frete cobrado ou atribuído ao pedido | 150.00 |
discount_price | Decimal | Não | Desconto global aplicado no fechamento do carrinho (valor rateado entre os itens) | 50.00 |
notes | Texto | Não | Observações adicionais do pedido | Entrega urgente |