Serviços / Documentos

Leitura de faturamento da empresa

POST/api/v1/oracle/document/revenue

Lê o demonstrativo de faturamento enviado pela empresa e extrai razão social, CNPJ, período e o valor de cada mês.

Envie o PDF ou a imagem em file. Em PDF, até 12 páginas são lidas e os meses voltam numa lista só, em número decimal e sem símbolo de moeda.

É leitura do documento enviado: não consulta a Receita nem confere os valores com outra fonte.

Fonte: OCR com visão computacional · tempo real

Parâmetros

filefileObrigatório

PDF ou imagem do demonstrativo de faturamento.

file

Campos da resposta

Tipo de documento

document_type

string

Arquivo enviado

filename

string

Faturamento consolidado

validation_result

Parecer da validação. Em faturamento, os meses vêm consolidados.

object

Documento reconhecido

validation_result.is_valid

boolean

Tipo de documento

validation_result.document_kind

string

Razão social

validation_result.company_name

string

CNPJ

validation_result.cnpj

string

Período

validation_result.period

object

Faturamento mensal

validation_result.monthly

array

Mês

validation_result.monthly[].month

string

Valor

validation_result.monthly[].amount

number

Parecer

validation_result.descricao

string

Páginas lidas

validation_result.pages_analyzed

integer

Exemplo de resposta

Modelo de resposta: DocumentValidateOutput
JSON · response
{
  "success": true,
  "code": 200,
  "code_message": "A requisição foi processada com sucesso.",
  "errors": [],
  "header": null,
  "data_count": 1,
  "data": [
    {
      "document_type": "FATURAMENTO_EMPRESA",
      "filename": "faturamento-2026.pdf",
      "validation_result": {
        "is_valid": true,
        "document_kind": "faturamento",
        "company_name": "COIN NODES LTDA",
        "cnpj": "49.670.293/0001-03",
        "period": {
          "start": "01/2026",
          "end": "03/2026"
        },
        "monthly": [
          {
            "month": "01/2026",
            "amount": 128400
          },
          {
            "month": "02/2026",
            "amount": 141250
          },
          {
            "month": "03/2026",
            "amount": 136900.5
          }
        ],
        "descricao": "Documento de faturamento com 3 meses identificados",
        "pages_analyzed": 2
      }
    }
  ]
}

Casos de uso

Análise de crédito PJ

Transformar o demonstrativo enviado pelo cliente em série mensal para alimentar o modelo de limite.

Enquadramento de porte

Conferir a receita declarada contra o porte informado no cadastro.