Integradores ERP

O contrato Imp_Konica_* honrado à letra, com a máquina de estados Sync_Status.

O DocFlow replica o contrato de staging KTA/KOMI Doc → MacWin sem licenças: as tabelas Imp_Konica_* verbatim (PK DocumentNumber, precisões mistas, Sync_Status, Ok), um consumidor MacWin simulado que faz o handshake, e as cinco causas de falha do primeiro protótipo fechadas uma a uma.

  • DDL verbatim: FT_Cab/Lin + DT_Cab/Lin com as precisões exatas.
  • DocumentNumber é a única coluna NOT NULL / PK.
  • Sync_Status (0 pendente · 1 feito · 2 erro · 3 rejeitado) e Ok como flag.
  • UnitMeasure normalizado a códigos (UN, KG, MT…) para caber em varchar(10).
O que importa aqui

Resolução do fornecedor por NIF (nunca OCR do nome) — a causa nº1 da falha original.

FM Fatura de MateriaisFF Fatura FinanceiraGR Guia de RemessaGT Guia de TransporteNC Nota de CréditoND Nota de Débito
Exemplo extraído
Nota de Crédito
NC 2025/57
20/06/2025
PDF
Fornecedor
Fios & Malhas Atlântico, Lda
NIF 502442336
Total
-298,28 €
Devolução — Fio Algodão 30/1 (defeito de tingimento) · Cru-50 KG

Gates de validação

Ok = 1 — pode ir para staging
  • Nº Documento presente
    PK = NC 2025/57
  • NIF válido (checksum)
    502442336 ✓ mod-11
  • Fornecedor resolvido por NIF
    Fios & Malhas Atlântico, Lda (F-1042)
  • Σ base das linhas = base do cabeçalho
    Σ linhas -242.5000 vs base -242.5000 (tol ±0.01)
  • Base + IVA − descontos = Total
    Cálculo -298.2750 vs Total -298.2750
  • Taxas IVA plausíveis (23/13/6/0)
    Todas as taxas dentro do esperado
  • Qtd × Preço − Desc = Valor (por linha)
    Todas as linhas batem certo
  • Campos esperados extraídos
    12/12 campos esperados · 5 preenchidos pelo ERP · 10 não aplicáveis a NC
  • Campos cabem no tipo/precisão
    Unidades normalizadas, escalas corretas
  • Datas válidas (2000–2099)
    2025-06-20 · Vencimento 2025-06-20 ≥ Documento 2025-06-20