Documentos fiscais transformados em dados estruturados

https://document.pes2b.com

X-API-Key: SUA_CHAVE

curl -X GET \
  'https://document.pes2b.com/api/v1/diagnostics' \
  -H 'X-API-Key: SUA_CHAVE'

{
  "success": true,
  "message": "Diagnóstico operacional do serviço.",
  "requestId": "a1cb5279-4b56-442d-876c-bf4b1ae23aca",
  "data": {
    "service": "pes2b-document-service",
    "environment": "production",
    "engineVersion": "1.10.0",
    "uptimeSeconds": 104,
    "processedDocuments": 0,
    "successfulDocuments": 0,
    "failedDocuments": 0,
    "successRate": 1,
    "blockedByConfidence": 0,
    "unknownDocuments": 0,
    "rejectedUploads": 0,
    "averageProcessingMs": 0,
    "parsers": { "total": 7, "active": 7, "inactive": 0 },
    "byDocumentType": {},
    "byConfidenceLevel": { "HIGH": 0, "MEDIUM": 0, "LOW": 0 }
  },
  "errors": [],
  "warnings": [
    "As métricas são mantidas em memória e reiniciadas quando o serviço é reiniciado."
  ]
}

curl -X POST \
  'https://document.pes2b.com/api/v1/pdf/extract' \
  -H 'X-API-Key: SUA_CHAVE' \
  -F 'file=@documento.pdf;type=application/pdf'

curl -X POST \
  'https://document.pes2b.com/api/v1/pdf/extract' \
  -H 'X-API-Key: SUA_CHAVE' \
  -F 'file=@dec-poa.pdf;type=application/pdf' \
  -F 'expectedCnpj=12.345.678/0001-90' \
  -F 'expectedCompetence=2026-07' \
  -F 'expectedMunicipalityIbge=4314902' \
  -F 'expectedUf=RS'

{
  "success": true,
  "documentType": "DECLARACAO_PGDAS",
  "engine": {
    "version": "1.10.0",
    "family": "SIMPLES_NACIONAL",
    "detector": "simples.detector",
    "parser": "declaracao",
    "parserVersion": "1.0.0",
    "schemaVersion": "1.0",
    "confidence": 1,
    "confidenceLevel": "HIGH",
    "minimumConfidence": 0.8,
    "parserExecuted": true,
    "parserBlocked": false
  },
  "pages": 2,
  "data": {
    "identificacao": {
      "empresa": "EMPRESA EXEMPLO LTDA.",
      "cnpj": "12.345.678/0001-90",
      "competencia": "06/2026"
    }
  },
  "warnings": [],
  "errors": [],
  "requestId": "00000000-0000-4000-8000-000000000001"
}

{
  "resumo": {
    "receitaBrutaMesNumero": 10238.00,
    "rbt12Numero": 122916.51,
    "faixaEnquadramento": "0,00 a 180.000,00",
    "valorSimplesRecolherNumero": 332.78,
    "cargaTributariaTotalNumero": 3.2504
  },
  "consolidacaoPorAnexo": [
    {
      "anexo": "I",
      "descricaoAnexo": "Comércio",
      "receitaTributadaNumero": 8378.00,
      "valorSimplesNumero": 221.18,
      "aliquotaMediaNumero": 2.64
    }
  ]
}

{
  "validation": {
    "valid": true,
    "mismatches": []
  }
}

{
  "validation": {
    "valid": false,
    "mismatches": [
      {
        "field": "cnpj",
        "expected": "12345678000190",
        "actual": "98765432000110",
        "code": "CNPJ_MISMATCH"
      }
    ]
  }
}

{
  "success": true,
  "documentType": "DEC_POA_DECLARACAO_MENSAL",
  "compound": true,
  "engine": {
    "family": "DECLARACAO_MUNICIPAL",
    "parser": "dec-poa",
    "confidence": 1,
    "confidenceLevel": "HIGH",
    "parserExecuted": true
  },
  "data": {
    "municipality": {
      "ibgeCode": "4314902",
      "name": "Porto Alegre",
      "uf": "RS"
    },
    "company": {
      "cnpj": "12345678000190",
      "razaoSocial": "EMPRESA EXEMPLO PORTO ALEGRE LTDA.",
      "inscricaoMunicipal": "123456-7-8"
    },
    "competence": {
      "year": 2026,
      "month": 7,
      "reference": "2026-07",
      "display": "07/2026"
    },
    "financial": {
      "servicesRevenue": 20000.00,
      "issOwn": 1000.00,
      "issWithheldFromThirdParties": 0.00,
      "totalTaxDue": 1000.00,
      "totalToCollect": 1000.00
    },
    "receipt": {
      "status": "ENTREGUE",
      "submittedAt": "2026-08-04T19:19:45-03:00",
      "authentication": "AA BB CC DD EE FF 00 11 22 33 44 55 66 77 88 99"
    },
    "guide": {
      "present": true,
      "collectionCode": "328300123456789",
      "dueDate": "2026-09-30",
      "generatedAt": "2026-09-02T11:10:00-03:00",
      "barcode": "816700000119 315934332026 609300430327 830012345678",
      "taxAmount": 1000.00,
      "amountToPay": 1110.00,
      "revenue": 20000.00
    }
  },
  "validation": {
    "valid": true,
    "mismatches": []
  },
  "documents": [
    {
      "role": "DECLARACAO",
      "suggestedSuffix": "declaracao",
      "fileName": "EMPRESA_EXEMPLO_PORTO_ALEGRE_LTDA__12345678000190__07-2026_declaracao.pdf",
      "pages": [1, 2],
      "file": {
        "fileName": "EMPRESA_EXEMPLO_PORTO_ALEGRE_LTDA__12345678000190__07-2026_declaracao.pdf",
        "mimeType": "application/pdf",
        "extension": "pdf",
        "size": 4200,
        "base64": "JVBERi0xLjcKLi4u"
      }
    },
    {
      "role": "GUIA",
      "suggestedSuffix": "guia",
      "fileName": "EMPRESA_EXEMPLO_PORTO_ALEGRE_LTDA__12345678000190__07-2026_guia.pdf",
      "pages": [3],
      "file": { "mimeType": "application/pdf", "extension": "pdf", "size": 13000, "base64": "JVBERi0xLjcKLi4u" }
    },
    {
      "role": "RECIBO",
      "suggestedSuffix": "recibo",
      "fileName": "EMPRESA_EXEMPLO_PORTO_ALEGRE_LTDA__12345678000190__07-2026_recibo.pdf",
      "pages": [4],
      "file": { "mimeType": "application/pdf", "extension": "pdf", "size": 5300, "base64": "JVBERi0xLjcKLi4u" }
    }
  ],
  "requestId": "00000000-0000-4000-8000-000000000101"
}

// document.detector.js — exemplo ilustrativo
if (
  normalized.includes('RECIBO DE ENTREGA DE ESCRITURAÇÃO CONTÁBIL DIGITAL') &&
  normalized.includes('IDENTIFICAÇÃO DO ARQUIVO') &&
  normalized.includes('HASH DA ESCRITURAÇÃO')
) {
  return 'RECIBO_SPED_ECD';
}

// registry.js
RECIBO_SPED_ECD: require(
  path.join(__dirname, 'sped', 'recibo-ecd')
)

// src/document/parsers/sped/recibo-ecd/parser.js
exports.parse = (text) => ({
  identificacao: {
    empresa: extrairEmpresa(text),
    cnpj: extrairCnpj(text),
    periodo: extrairPeriodo(text)
  },
  documento: {
    tipo: 'RECIBO_SPED_ECD',
    numeroRecibo: extrairNumeroRecibo(text),
    hashEscrituracao: extrairHash(text)
  },
  transmissao: {
    dataHora: extrairDataHora(text),
    situacao: extrairSituacao(text)
  },
  extras: {}
});

{
  "success": true,
  "documentType": "RECIBO_SPED_ECD",
  "pages": 1,
  "data": {
    "identificacao": {
      "empresa": "EMPRESA EXEMPLO LTDA.",
      "cnpj": "12.345.678/0001-90",
      "periodo": {
        "inicio": "01/01/2025",
        "fim": "31/12/2025"
      }
    },
    "documento": {
      "tipo": "RECIBO_SPED_ECD",
      "numeroRecibo": "ECD-EXEMPLO-000001",
      "hashEscrituracao": "HASH_ANONIMIZADO"
    },
    "transmissao": {
      "dataHora": "30/06/2026 18:42:10",
      "situacao": "RECEBIDA"
    },
    "extras": {}
  },
  "warnings": [],
  "errors": [],
  "requestId": "00000000-0000-4000-8000-000000000100"
}

Entrada do subfluxo
json.system = "DEC_POA"
json.expected.cnpj = "12345678000190"
json.expected.competence = "2026-07"
json.expected.municipality.ibgeCode = "4314902"
json.expected.municipality.uf = "RS"
binary.pdf = PDF original

Saída com guia
item 1: role = DECLARACAO | binary.file
item 2: role = GUIA       | binary.file
item 3: role = RECIBO     | binary.file

Saída sem guia
item 1: role = DECLARACAO | binary.file
item 2: role = RECIBO     | binary.file