Leitor de Documentos

Esta skill lê documentos (notas fiscais, recibos, boletos, contratos, comprovantes) e extrai os campos relevantes em formato estruturado — tabela ou JSON — pronto para colar em planilha ou importar em um sistema. O foco é precisão, padronização de formatos brasileiros (datas, CNPJ, valores em R$) e marcação clara do que não foi encontrado.

Quando usar

• Tirar valores e datas de várias notas fiscais para uma planilha de despesas.
• Extrair cláusulas-chave de um contrato (prazo, valor, multa, foro).
• Organizar recibos e comprovantes de pagamento em uma tabela.
• Conferir dados de um boleto (vencimento, valor, beneficiário, linha digitável).
• Padronizar informações de documentos com formatos diferentes em um só esquema.

Gatilhos: "extraia os dados dessa nota", "tire as cláusulas desse contrato", "organize esses recibos em tabela", "leia esse documento e me dê em JSON".

O que esta skill faz

• Identifica o tipo de documento e os campos esperados para ele.
• Extrai os campos em formato consistente (datas DD/MM/AAAA, valores R$ 0.000,00, CNPJ formatado).
• Devolve em tabela (para conferência) ou JSON (para sistema), conforme pedido.
• Marca campos ausentes ou ilegíveis como "não encontrado" — nunca inventa.
• Sinaliza incertezas (texto borrado, ambiguidade) para revisão humana.

Como usar (passo a passo)

1. Receba o documento (texto colado, imagem ou PDF) e o objetivo (quais campos importam).
2. Classifique o tipo (nota fiscal, recibo, boleto, contrato, comprovante).
3. Liste os campos-alvo conforme o tipo (veja o template).
4. Extraia cada campo literalmente do documento; não deduza valores que não estão escritos.
5. Padronize os formatos (data, moeda, documentos) para o padrão brasileiro.
6. Marque ausências como "não encontrado" e dúvidas como "verificar".
7. Escolha o formato de saída (tabela markdown para revisão, JSON para integração).
8. Resuma ao final: total de documentos, soma de valores (se aplicável) e itens a revisar.

Estrutura / Template

TIPO: (nota fiscal / recibo / boleto / contrato / comprovante)
OBJETIVO: (quais campos importam)
FORMATO DE SAÍDA: ( ) tabela ( ) JSON

CAMPOS POR TIPO
- Nota fiscal: número, série, data emissão, emitente (nome+CNPJ),
  destinatário, descrição, valor total, impostos
- Recibo: nº, data, pagador, recebedor, valor, referente a, forma de pagamento
- Boleto: beneficiário, pagador, vencimento, valor, linha digitável, nosso número
- Contrato: partes, objeto, vigência (início/fim), valor, forma de pagamento,
  multa/rescisão, foro, data de assinatura
- Comprovante: data, valor, origem, destino, ID/autenticação

SAÍDA (JSON):
{
  "tipo": "",
  "campos": { ... },
  "itens_a_revisar": []
}

Exemplo preenchido

TIPO: nota fiscal de serviço
OBJETIVO: alimentar planilha de despesas do mês
FORMATO: tabela + resumo

| Campo            | Valor                          |
|------------------|--------------------------------|
| Número           | 001234                         |
| Data emissão     | 12/03/2026                     |
| Emitente         | Gráfica Sol Ltda               |
| CNPJ emitente    | 12.345.678/0001-90             |
| Descrição        | Impressão de 2.000 folders     |
| Valor total      | R$ 1.480,00                    |
| ISS retido       | não encontrado (verificar)     |

RESUMO: 1 nota processada. Valor total: R$ 1.480,00.
Itens a revisar: ISS retido (campo não localizado no documento).

Mesma nota em JSON:

{
  "tipo": "nota_fiscal_servico",
  "campos": {
    "numero": "001234",
    "data_emissao": "12/03/2026",
    "emitente": "Gráfica Sol Ltda",
    "cnpj_emitente": "12.345.678/0001-90",
    "descricao": "Impressão de 2.000 folders",
    "valor_total": "1480.00",
    "iss_retido": null
  },
  "itens_a_revisar": ["iss_retido"]
}

Dicas e boas práticas

• Nunca invente um valor. Se não está no documento, marque "não encontrado".
• Padronize sempre datas, moeda e documentos — facilita somar e importar.
• No JSON, use valores numéricos sem máscara ("1480.00") para cálculo; mantenha a versão formatada na tabela.
• Sinalize o que está borrado/ambíguo em "itens_a_revisar".
• Em contratos, cite o número da cláusula de onde tirou cada dado.
• Para lote de documentos, devolva uma linha por documento e um resumo somando os valores.

Erros comuns a evitar

• Deduzir impostos ou totais que não estão escritos — isso corrompe a contabilidade.
• Misturar formatos (uma data DD/MM, outra MM/DD) — quebra fórmulas na planilha.
• Confundir emitente e destinatário em notas.
• Tratar texto ilegível como certo. Marque para revisão.
• Esquecer a moeda/centavos (R$ 1.480 ≠ R$ 1.480,00).
• Entregar JSON inválido (vírgulas sobrando, aspas faltando). Valide a sintaxe.