Configuração Logo & Mikro

Esta página é voltada a usuários de negócios e operações. Detalhes técnicos de arquitetura e desenvolvedor estão em docs/ERP_INTEGRATION.md.

Fluxo geral

1. Abra um registro Logo ou Mikro em Painel → Integrações contábeis, defina como Ativo e escolha um modo de gravação seguro (padrão: apenas CSV manual).
2. Em Painel → Mapeamentos de produtos ERP, complete os mapeamentos SKU → código de estoque ERP, unidade e IVA (sincronize a partir dos produtos ou adicione linhas).
3. Garanta que os clientes tenham código razão/cari ou ID fiscal; quando um pedido é criado, um job entra na fila de pedidos ERP.
4. Baixe CSV da fila ou detalhe do pedido e importe no ERP. Ative despacho automático somente após o processo estar estável.

Caminhos: /dashboard/accounting · /dashboard/integration-mapping?provider=logo ou provider=mikro · /dashboard/integration-outbox.

Preparação compartilhada

Esclarecer no lado do ERP

• Como os pedidos são criados: CSV manual, pasta de importação monitorada, stored procedure / agente local.
• Se os campos SKU de produto / variante Convord correspondem aos códigos de estoque ERP (ou use uma tabela de mapeamento).
• Como os clientes são resolvidos no ERP (<strong>código cari/razão</strong> preferido; caso contrário, ID fiscal).

Produtos e SKUs de variante no Convord

Preencha o SKU para cada produto. Se usar pesos/variantes, cada variante deve ter seu próprio SKU.

Painel de mapeamento

Gerencie seu conjunto de mapeamento ativo em Mapeamentos de produtos ERP: adicione linhas SKU ou “sincronizar a partir dos produtos”; verifique mapeamentos padrão de unidade e IVA. O download CSV da fila exige um snapshot de mapeamento.

Gravação segura e automação

Nas configurações, modo de gravação seguro: apenas CSV manual, apenas arquivo de importação ou apenas procedure. Despacho ERP automático fica desligado por padrão; habilite somente após ~20 transferências bem-sucedidas e mapeamento/dados de clientes sólidos.

Logo — perspectiva do usuário

O Convord primeiro grava o pedido na fila outbox. Caminhos comuns Logo: importação CSV manual ou (avançado) stored procedures SQL / agente local. O teste clássico de “conexão REST” não é usado para Logo; push REST direto Logo está desabilitado em produção.

No painel

1. Integrações contábeis → Logo → Iniciar configuração / Configurações.
2. Opcionalmente endpoint API / chave API para uma ponte; para operações, defina modo de gravação seguro e marque a integração como Ativa.
3. Complete o mapeamento SKU em Mapeamentos de produtos ERP (provider=logo).
4. Faça um pedido de teste → baixe CSV da fila de pedidos ERP ou do detalhe do pedido.

Mikro — perspectiva do usuário

Padrão comum: soltar um CSV delimitado em uma pasta de importação. Alternativa: ponte de pull de dados mestres (clientes/produtos/estoque) e Convord ERP Agent local opcional. O push de pedidos ainda passa pela outbox.

No painel

1. Integrações contábeis → Mikro → Configurações.
2. Escolha transporte: arquivo (caminho de importação + prefixo de arquivo) ou ponte (URL). Variante: Mikro Fly / Run / Jumbo, etc.
3. No modo arquivo, informe um caminho de importação gravável e Testar conexão; no modo ponte, use health check e botões de sincronização.
4. Painel de mapeamento (provider=mikro) + pedido de teste → fila / CSV.

CSV manual (início recomendado)

Caminho padrão e de fallback:

• Baixe o CSV do job na fila de pedidos ERP (snapshot de mapeamento deve estar presente).
• Alternativamente, baixe CSV Logo / Mikro em detalhe do pedido (/dashboard/orders/{id}/erp-manual-export/logo ou .../mikro).
• Colunas de nome do produto (PRODUCT_NAME / UrunAdi) ajudam na verificação no Excel; sem mapeamento, a coluna de estoque pode mostrar o SKU interno.

Colunas Logo: ORDER_NO;STOCK_CODE;PRODUCT_NAME;QTY;UNIT;UNIT_PRICE
Colunas Mikro: BelgeNo;StokKodu;UrunAdi;Miktar;Birim
Formato: UTF-8 (BOM), delimitador ;.

Checklist (resumo)