Skip to main content
Resumo: você manda um arquivo e não diz o que ele é. A plataforma identifica o tipo e devolve, em extraction, os campos daquele tipo. Esta página lista todos, para os 25 tipos, com o rótulo em português que a plataforma usa nas telas.

A convenção de todo campo

Todo campo folha volta como uma tripla:
Regras que valem para todos os tipos:
  • Campo ausente no documento vem com value: null e confidence: 0. Nada é inventado.
  • Datas vêm como texto no formato YYYY-MM-DD; data e hora, em ISO 8601.
  • Valores monetários vêm como número puro, na moeda declarada em currency ou capitalCurrency (moeda antiga não é convertida).
  • Listas são arrays de objetos cujos campos também são triplas.
  • Um campo pode trazer discardReason quando uma checagem determinística o anulou de propósito. O valor sai nulo, e o motivo sobrevive para a auditoria.
Trate o schema como aditivo. Campo novo pode aparecer numa versão futura sem quebrar contrato, e o seu parser deve ignorar o que não conhece.

Campos críticos

Cada tipo tem um punhado de campos críticos: são eles que puxam o parecer para baixo quando vêm com confiança fraca, e é sobre eles que rodam as verificações de titularidade (EXPECTED_DOCUMENT_MATCH, EXPECTED_NAME_MATCH, DOC_CHECKSUM). Estão listados em cada tipo abaixo. O documento principal e o nome principal de cada tipo dizem qual campo representa a entidade do cadastro: no contrato social é cnpj e companyName; na procuração é grantorDocument e grantorName; no comprovante de residência é holderDocument e holderName.

Blocos compartilhados

Quatro blocos aparecem em vários tipos com exatamente a mesma forma. Estão documentados aqui uma vez, e referenciados nas tabelas de cada tipo.

Bloco Certificação

certification: o que dá fé ao documento. Está em todos os tipos.

Bloco Marcadores estruturais

structuralMarkers: os títulos e seções canônicos encontrados no documento. Insumo da checagem de anatomia, não dado do documento. Está em todos os tipos.

Bloco Marcadores de integridade

documentMarkers: marcas de integridade do arquivo. Insumo da heurística de página faltante. Aparece nos tipos societários e no requerimento de empresário.

Bloco Poderes de representação

representation: a cláusula de administração lida de forma estruturada. Aparece em contrato social, alteração contratual, estatuto, ata de assembleia e certidão da Junta.
Um mesmo trecho do contrato vai em um dos dois: ato que só exige aprovação ou quórum é alçada (thresholds); ato vedado é vedação (prohibitions). Nunca nos dois.

Pessoa jurídica

CONTRATO_SOCIAL

Contrato social. Ato que cria a sociedade limitada e diz quem são os sócios e quem assina pela empresa. Documento principal: cnpj, nome principal: companyName. Campos críticos: cnpj, companyName, signatureDate, capitalAmount, partners, administrators, representation.regime, representation.clauseExcerpt.

ALTERACAO_CONTRATUAL

Alteração contratual. Altera o contrato social; a última alteração consolidada substitui o contrato original. Documento principal: cnpj, nome principal: companyName. Campos críticos: cnpj, companyName, signatureDate, capitalAmount, partners, administrators, changesSummary, resultingQsa, representation.regime, representation.clauseExcerpt.

ESTATUTO_SOCIAL

Estatuto social. Equivalente ao contrato social na sociedade anônima, na cooperativa e na associação. Documento principal: cnpj, nome principal: companyName. Campos críticos: cnpj, companyName, signatureDate, capitalAmount, partners, administrators, representation.regime, representation.clauseExcerpt.

REQUERIMENTO_EMPRESARIO

Requerimento de empresário. Ato de abertura do empresário individual e do MEI, que não têm contrato social. Documento principal: cnpj, nome principal: companyName. Campos críticos: entrepreneurName, entrepreneurCpf, companyName, signatureDate.

ATA_ASSEMBLEIA

Ata de assembleia. Elege a diretoria da S.A. e prova quem representa a empresa hoje; o mandato tem prazo e vence. Documento principal: cnpj, nome principal: companyName. Campos críticos: cnpj, companyName, meetingDate, electedOfficers, administrators, representation.regime, representation.clauseExcerpt.

CERTIDAO_JUNTA

Certidão da Junta Comercial. Confirma na fonte oficial o que o contrato social afirma; a de inteiro teor traz a cláusula de administração. Documento principal: cnpj, nome principal: companyName. Campos críticos: cnpj, companyName, issuedBy, issuedAt.

PROCURACAO_PJ

Procuração (PJ). Transfere poderes de assinatura da empresa a um terceiro, com prazo e limites próprios. Documento principal: grantorDocument, nome principal: grantorName. Campos críticos: grantorName, grantorDocument, granteeName, powers, signatureDate.

IRPJ_ECF

Imposto de renda da empresa (ECF). Escrituração Contábil Fiscal entregue à Receita; o que prova a entrega é o recibo com número e hash. Documento principal: cnpj, nome principal: companyName, ano de referência: calendarYear. Campos críticos: cnpj, companyName, calendarYear, receiptNumber, hasReceipt.

DECLARACAO_FATURAMENTO

Declaração de faturamento (PJ). Faturamento mês a mês declarado pela empresa e assinado pelo contador. Documento principal: cnpj, nome principal: companyName. Campos críticos: companyName, cnpj, monthlyRevenues, issueDate.

DEMONSTRACOES_FINANCEIRAS

Demonstrações financeiras (balanço e DRE). Balanço patrimonial e demonstração do resultado assinados pelo contador. Documento principal: cnpj, nome principal: companyName. Campos críticos: companyName, cnpj, baseDate, statementScope.

CERTIDAO_PGFN_PJ

Certidão de débitos federais (PJ). Certidão conjunta da Receita e da PGFN sobre tributo federal e dívida ativa. Documento principal: cnpj, nome principal: companyName. Campos críticos: cnpj, companyName, issuedAt, validUntil, situation, authCode.

CERTIDAO_FGTS

Regularidade do FGTS (CRF). Certificado da Caixa que diz se a empresa está em dia com o FGTS dos empregados. Documento principal: cnpj, nome principal: companyName. Campos críticos: cnpj, companyName, validUntil, situation, authCode.

CADIN_FEDERAL

CADIN federal. Cadastro de inadimplentes com órgão federal. Documento principal: cnpj, nome principal: companyName. Campos críticos: cnpj, companyName, issuedAt, situation.

CADIN_ESTADUAL

CADIN estadual. O mesmo cadastro, no âmbito do estado. Documento principal: cnpj, nome principal: companyName. Campos críticos: cnpj, companyName, state, issuedAt, situation.

CERTIDAO_QSA

Quadro societário (QSA). Lista de sócios e participações na base da Receita. Documento principal: cnpj, nome principal: companyName. Campos críticos: cnpj, companyName, issuer, issuedAt, qsaSummary.

CERTIFICADO_SIMPLES_NACIONAL

Certificado do Simples Nacional. Comprova que a empresa é optante do Simples, o regime que dispensa a ECF. Documento principal: cnpj, nome principal: companyName. Campos críticos: cnpj, companyName, simplesStatus, optionDate.

ESOCIAL_PJ

eSocial (PJ). Tela ou recibo de entrega das obrigações trabalhistas. Documento principal: cnpj, nome principal: companyName. Campos críticos: cnpj, companyName, competence, payrollStatus.

Pessoa física

DOC_IDENTIDADE

Documento de identidade. RG, CNH, CIN, RNE ou passaporte, com foto e assinatura visíveis. Documento principal: cpf, nome principal: name. Campos críticos: documentKind, name, cpf, birthDate.

COMPROVANTE_RESIDENCIA

Comprovante de residência. Conta de luz, água, gás ou telefone no nome da pessoa. Documento principal: holderDocument, nome principal: holderName. Campos críticos: holderName, issuer, referenceDate, address.

DIRPF

Imposto de renda (PF). Declaração anual da pessoa física; o que prova a entrega é o recibo. Documento principal: cpf, nome principal: name, ano de referência: calendarYear. Campos críticos: name, cpf, calendarYear, receiptNumber, hasReceipt, incomeTaxable, assets, debts, summary.

COMPROVANTE_RENDA

Comprovante de renda (PF). Holerite, pró-labore ou recibo que mostra quanto a pessoa recebe. Documento principal: cpf, nome principal: name. Campos críticos: kind, name, cpf, referencePeriod, grossIncome.

CERTIDAO_PF

Certidão negativa (PF). Certidão de débito, protesto ou distribuição no nome da pessoa física. Documento principal: cpf, nome principal: name. Campos críticos: kind, name, cpf, issuer, issuedAt, result.

PROCURACAO_PF

Procuração (PF). Transfere poderes da pessoa física a um terceiro, com prazo e limites próprios. Documento principal: grantorDocument, nome principal: grantorName. Campos críticos: grantorName, grantorDocument, granteeName, powers, signatureDate.

COMPROVACAO_ESTADO_CIVIL

Estado civil (PF). Certidão de casamento, nascimento ou óbito; o divórcio é anotado na margem. Documento principal: holderCpf, nome principal: holderName. Campos críticos: documentKind, holderName, actDate, registryOffice.

Pessoa física e jurídica

EXTRATO_BANCARIO

Extrato bancário. Movimentação da conta: titularidade da conta de desembolso, entradas, saídas e gasto de risco. Documento principal: holderDocument, nome principal: holderName. Campos críticos: holderName, holderDocument, bankName, branchNumber, accountNumber, periodStart, periodEnd, openingBalance, closingBalance, transactions.