{
"code": 400,
"message": "O arquivo do documento é obrigatório (campo \"file\")."
}
{
"code": 401,
"message": "Token de acesso inválido."
}
{
"code": 403,
"message": "Você não tem permissão para acessar este recurso."
}
{
"code": 404,
"message": "Recurso não encontrado."
}
{
"code": 413,
"message": "File too large"
}
{
"code": 500,
"message": "Internal server error"
}
{
"code": 502,
"message": "Não foi possível iniciar a validação do documento."
}
Quando usar
Você tem um arquivo e quer o parecer agora. Uma chamada, um arquivo, e o resultado volta na resposta.
A entrada é única
Você não diz que documento está mandando. A plataforma identifica entre os 25 tipos e o objeto extraction da resposta traz os campos daquele tipo. O mapa completo está em Formatos de retorno.expectedType não força nada: diz o que você pediu, e a plataforma confronta com o que leu. É o campo que pega o arquivo legítimo enviado no lugar errado. Já typeHintafirma o tipo e pula a classificação.
Trate o 202 como caminho normal
Documento longo ou digitalizado passa dos 55 segundos. Continue por Status do documento, ou assine o webhook registry.document.assessed.
Leia effectiveVerdict
assessment.verdict é o parecer da IA, que nunca é reescrito. Quando um operador discorda, a decisão dele entra em feedbackVerdict e effectiveVerdict passa a ser ela.
O arquivo, em multipart/form-data. PDF, JPG ou PNG, ate 15MB. Acima disso use presign_registry_document + confirm_registry_document.
expectedDocument
string
required
CNPJ ou CPF da jornada, com ou sem mascara. Obrigatorio: e o dono do cadastro onde o documento sera arquivado.
expectedName
string
Razao social ou nome da jornada. Alimenta a verificacao EXPECTED_NAME_MATCH.
waitSeconds
integer
Espera maxima pela resposta sincrona, de 5 a 55. Padrao 45.
Required range: 5 <= x <= 55
typeHint
enum<string>
AFIRMA o tipo do arquivo: o pipeline adota e pula a classificacao. So use quando a origem ja garante o tipo.
Available options:
CONTRATO_SOCIAL,
ALTERACAO_CONTRATUAL,
ESTATUTO_SOCIAL,
REQUERIMENTO_EMPRESARIO,
PROCURACAO_PJ,
IRPJ_ECF,
DECLARACAO_FATURAMENTO,
CERTIDAO_JUNTA,
ATA_ASSEMBLEIA,
DOC_IDENTIDADE,
COMPROVANTE_RESIDENCIA,
DIRPF,
COMPROVANTE_RENDA,
CERTIDAO_PF,
PROCURACAO_PF,
FORA_DE_ESCOPO,
NAO_IDENTIFICADO,
CERTIDAO_PGFN_PJ,
CERTIDAO_FGTS,
CADIN_FEDERAL,
CADIN_ESTADUAL,
CERTIDAO_QSA,
CERTIFICADO_SIMPLES_NACIONAL,
ESOCIAL_PJ,
COMPROVACAO_ESTADO_CIVIL,
DEMONSTRACOES_FINANCEIRAS,
EXTRATO_BANCARIO
expectedType
enum<string>
PEDE um tipo: a classificacao roda e o tipo lido e confrontado (verificacao EXPECTED_TYPE_MATCH). E o campo que pega documento trocado.
Available options:
CONTRATO_SOCIAL,
ALTERACAO_CONTRATUAL,
ESTATUTO_SOCIAL,
REQUERIMENTO_EMPRESARIO,
PROCURACAO_PJ,
IRPJ_ECF,
DECLARACAO_FATURAMENTO,
CERTIDAO_JUNTA,
ATA_ASSEMBLEIA,
DOC_IDENTIDADE,
COMPROVANTE_RESIDENCIA,
DIRPF,
COMPROVANTE_RENDA,
CERTIDAO_PF,
PROCURACAO_PF,
FORA_DE_ESCOPO,
NAO_IDENTIFICADO,
CERTIDAO_PGFN_PJ,
CERTIDAO_FGTS,
CADIN_FEDERAL,
CADIN_ESTADUAL,
CERTIDAO_QSA,
CERTIFICADO_SIMPLES_NACIONAL,
ESOCIAL_PJ,
COMPROVACAO_ESTADO_CIVIL,
DEMONSTRACOES_FINANCEIRAS,
EXTRATO_BANCARIO
Response
Resultado completo (200) com type, extraction, validation.checks[] e assessment; ou { documentId, statusUrl } (202) quando ainda processa.
Resultado completo de um documento, da classificacao ao parecer.
documentId
string
registryId
string
type
enum<string>
O tipo LIDO pela classificacao.
Available options:
CONTRATO_SOCIAL,
ALTERACAO_CONTRATUAL,
ESTATUTO_SOCIAL,
REQUERIMENTO_EMPRESARIO,
ATA_ASSEMBLEIA,
PROCURACAO_PJ,
CERTIDAO_JUNTA,
CERTIDAO_QSA,
IRPJ_ECF,
DECLARACAO_FATURAMENTO,
CERTIFICADO_SIMPLES_NACIONAL,
DEMONSTRACOES_FINANCEIRAS,
EXTRATO_BANCARIO,
CERTIDAO_PGFN_PJ,
CERTIDAO_FGTS,
CADIN_FEDERAL,
CADIN_ESTADUAL,
ESOCIAL_PJ,
DOC_IDENTIDADE,
COMPROVANTE_RESIDENCIA,
DIRPF,
COMPROVANTE_RENDA,
CERTIDAO_PF,
PROCURACAO_PF,
COMPROVACAO_ESTADO_CIVIL,
FORA_DE_ESCOPO,
NAO_IDENTIFICADO
expectedType
enum<string> | null
O tipo PEDIDO no envio. Sustenta a verificacao EXPECTED_TYPE_MATCH.
Available options:
CONTRATO_SOCIAL,
ALTERACAO_CONTRATUAL,
ESTATUTO_SOCIAL,
REQUERIMENTO_EMPRESARIO,
ATA_ASSEMBLEIA,
PROCURACAO_PJ,
CERTIDAO_JUNTA,
CERTIDAO_QSA,
IRPJ_ECF,
DECLARACAO_FATURAMENTO,
CERTIFICADO_SIMPLES_NACIONAL,
DEMONSTRACOES_FINANCEIRAS,
EXTRATO_BANCARIO,
CERTIDAO_PGFN_PJ,
CERTIDAO_FGTS,
CADIN_FEDERAL,
CADIN_ESTADUAL,
ESOCIAL_PJ,
DOC_IDENTIDADE,
COMPROVANTE_RESIDENCIA,
DIRPF,
COMPROVANTE_RENDA,
CERTIDAO_PF,
PROCURACAO_PF,
COMPROVACAO_ESTADO_CIVIL,
FORA_DE_ESCOPO,
NAO_IDENTIFICADO,
null
expectedTypes
enum<string>[]
O CONJUNTO pedido, quando o item nasceu de um requisito societario.
Available options:
CONTRATO_SOCIAL,
ALTERACAO_CONTRATUAL,
ESTATUTO_SOCIAL,
REQUERIMENTO_EMPRESARIO,
ATA_ASSEMBLEIA,
PROCURACAO_PJ,
CERTIDAO_JUNTA,
CERTIDAO_QSA,
IRPJ_ECF,
DECLARACAO_FATURAMENTO,
CERTIFICADO_SIMPLES_NACIONAL,
DEMONSTRACOES_FINANCEIRAS,
EXTRATO_BANCARIO,
CERTIDAO_PGFN_PJ,
CERTIDAO_FGTS,
CADIN_FEDERAL,
CADIN_ESTADUAL,
ESOCIAL_PJ,
DOC_IDENTIDADE,
COMPROVANTE_RESIDENCIA,
DIRPF,
COMPROVANTE_RENDA,
CERTIDAO_PF,
PROCURACAO_PF,
COMPROVACAO_ESTADO_CIVIL,
FORA_DE_ESCOPO,
NAO_IDENTIFICADO
status
enum<string>
Available options:
RECEIVED,
CLASSIFYING,
CLASSIFIED,
EXTRACTING,
EXTRACTED,
VALIDATING,
VALIDATED,
FAILED,
MANUAL_REVIEW,
OUT_OF_SCOPE,
REJECTED_QUALITY
version
integer
isCurrent
boolean
classification
object | null
O que a classificacao concluiu, com as alternativas consideradas.
Hide child attributes
classification.type
enum<string>
Available options:
CONTRATO_SOCIAL,
ALTERACAO_CONTRATUAL,
ESTATUTO_SOCIAL,
REQUERIMENTO_EMPRESARIO,
ATA_ASSEMBLEIA,
PROCURACAO_PJ,
CERTIDAO_JUNTA,
CERTIDAO_QSA,
IRPJ_ECF,
DECLARACAO_FATURAMENTO,
CERTIFICADO_SIMPLES_NACIONAL,
DEMONSTRACOES_FINANCEIRAS,
EXTRATO_BANCARIO,
CERTIDAO_PGFN_PJ,
CERTIDAO_FGTS,
CADIN_FEDERAL,
CADIN_ESTADUAL,
ESOCIAL_PJ,
DOC_IDENTIDADE,
COMPROVANTE_RESIDENCIA,
DIRPF,
COMPROVANTE_RENDA,
CERTIDAO_PF,
PROCURACAO_PF,
COMPROVACAO_ESTADO_CIVIL,
FORA_DE_ESCOPO,
NAO_IDENTIFICADO
classification.confidence
number
0 a 1.
classification.alternatives
object[]
Hide child attributes
classification.alternatives.type
enum<string>
Available options:
CONTRATO_SOCIAL,
ALTERACAO_CONTRATUAL,
ESTATUTO_SOCIAL,
REQUERIMENTO_EMPRESARIO,
ATA_ASSEMBLEIA,
PROCURACAO_PJ,
CERTIDAO_JUNTA,
CERTIDAO_QSA,
IRPJ_ECF,
DECLARACAO_FATURAMENTO,
CERTIFICADO_SIMPLES_NACIONAL,
DEMONSTRACOES_FINANCEIRAS,
EXTRATO_BANCARIO,
CERTIDAO_PGFN_PJ,
CERTIDAO_FGTS,
CADIN_FEDERAL,
CADIN_ESTADUAL,
ESOCIAL_PJ,
DOC_IDENTIDADE,
COMPROVANTE_RESIDENCIA,
DIRPF,
COMPROVANTE_RENDA,
CERTIDAO_PF,
PROCURACAO_PF,
COMPROVACAO_ESTADO_CIVIL,
FORA_DE_ESCOPO,
NAO_IDENTIFICADO
classification.alternatives.confidence
number
ambiguous
boolean
true quando outra alternativa passou de 0,35 de confianca.
statusReason
string | null
Por que o documento parou num terminal que nao e falha tecnica.
stages
object | null
O que rodou nesta tentativa e o que veio reaproveitado.
Hide child attributes
stages.executed
enum<string>[]
Available options:
CLASSIFY,
EXTRACT,
VALIDATE
stages.reused
object[]
Hide child attributes
stages.reused.stage
enum<string>
Available options:
CLASSIFY,
EXTRACT,
VALIDATE
stages.reused.fromAttempt
integer
extraction
object | null
Os campos lidos. A FORMA DEPENDE DO TIPO identificado: cada um dos 25 tipos tem o seu conjunto, documentado campo a campo em https://developers.gyramais.com.br/api-reference/kyc/formatos-de-retorno. Todo campo folha vem como { value, confidence, page }; campo ausente vem com value null e confidence 0.
fieldConfidences
object | null
Confianca por caminho de campo.
Hide child attributes
fieldConfidences.{key}
number
validation
object | null
Hide child attributes
validation.checks
object[]
Hide child attributes
validation.checks.code
string
Codigo da verificacao no catalogo (ex.: EXPECTED_DOCUMENT_MATCH).
validation.checks.result
enum<string>
WARN e ressalva: aparece no parecer e nao reprova sozinha.
Available options:
PASS,
WARN,
FAIL,
SKIP
validation.checks.message
string
Frase em portugues explicando o resultado.
validation.checks.evidence
object | null
Onde no documento a verificacao se apoiou.
Hide child attributes
validation.checks.evidence.page
integer | null
validation.checks.evidence.excerpt
string | null
validation.checks.evidence.checkCode
string
validation.checks.details
string[]
Indicios individuais, quando a verificacao produz varios.
validation.checks.source
enum<string>
Quem produziu o resultado.
Available options:
DETERMINISTIC,
RECONCILIATION,
LLM
validation.checks.rfi
integer
validation.reconciliation
object | null
Conferencia contra a fonte oficial.
assessment
object | null
Hide child attributes
assessment.verdict
enum<string>
O parecer da IA. NAO e o veredito que vale: use effectiveVerdict.
Available options:
VALIDO,
INVALIDO,
INCONCLUSIVO,
ANALISE_MANUAL
assessment.score
number
0 a 1.
assessment.justification
string
Por que, em portugues.
assessment.evidences
object[]
Hide child attributes
assessment.evidences.page
integer | null
assessment.evidences.excerpt
string | null
assessment.evidences.checkCode
string
assessment.ruleSetVersion
string
Qual versao da regua julgou este documento.
assessment.contentHash
string | null
Selo do parecer, conferivel na rota de integridade.
assessment.feedbackVerdict
enum<string> | null
A decisao que um operador registrou, quando houve.
Available options:
VALIDO,
INVALIDO,
INCONCLUSIVO,
ANALISE_MANUAL,
null
assessment.feedbackComment
string | null
assessment.feedbackAt
string<date-time> | null
assessment.feedbackUserId
string | null
assessment.effectiveVerdict
enum<string> | null
O VEREDITO QUE VALE HOJE (feedbackVerdict ?? verdict). Leia este.
Available options:
VALIDO,
INVALIDO,
INCONCLUSIVO,
ANALISE_MANUAL,
null
assessment.decidedByOperator
boolean
true quando quem decidiu foi uma pessoa, e nao o pipeline.
processedAt
string<date-time> | null
attempt
integer
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"GYRA+ Docs","colors":{"primary":"#1a54fa"},"logo":{"light":"https://mintcdn.com/gyra/e0CFjRCELp2Et0mP/logo/light.png?fit=max\u0026auto=format\u0026n=e0CFjRCELp2Et0mP\u0026q=85\u0026s=07c498e8ad046860d4087e2bb3031959","dark":"https://mintcdn.com/gyra/e0CFjRCELp2Et0mP/logo/dark.png?fit=max\u0026auto=format\u0026n=e0CFjRCELp2Et0mP\u0026q=85\u0026s=b619e9921d46fadcfc5ba6797472b83c"},"favicon":"https://mintcdn.com/gyra/NOR5Q9E-wRWiecYr/favicon.svg?fit=max\u0026auto=format\u0026n=NOR5Q9E-wRWiecYr\u0026q=85\u0026s=371669edce3dcdbb9f5774a41b7ff793","api":{"openapi":"openapi.yaml","params":{"expanded":"all"}},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode","mcp"],"display":"header"},"markdown":{"schema":true,"instructions":["A GYRA+ tem um servidor MCP oficial: https://mcp.gyramais.com.br/mcp. A autenticação é o login do próprio usuário na plataforma, não uma credencial separada. Instalação em https://developers.gyramais.com.br/mcp/instalacao.","Prefira as tools do MCP a montar chamadas HTTP na mão quando o usuário já tem o conector ligado.","Para analisar crédito de um CNPJ ou CPF, use create_report_v2 e assine um webhook em vez de fazer polling.","Para ler um documento (contrato social, comprovante de residência, imposto de renda, balanço), use validate_document: a entrada é um arquivo só e a plataforma reconhece o tipo sozinha.","Para pedir documentos ao cliente final, use create_collection com o slug de um modelo obtido em list_collection_templates.","Documento (CNPJ/CPF) é dado pessoal: não o repita em log nem o envie a serviços de terceiros."]},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gyra","hasAudioNarration":false,"actualSubdomain":"gyra","customDomains":["developers.gyramais.com.br"],"gitSource":{"type":"github","owner":"gyramais","repo":"gyra-mintlify-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"agentFeedback":true},"entitlements":{},"buildId":"6ac560c5562cca2062a5e1d5","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API: Onboarding","count":27},{"language":"default","tag":"Referência da API","count":20},{"language":"default","tag":"Guia do Toolbox","count":19},{"language":"default","tag":"Fontes de Dados","count":15},{"language":"default","tag":"Conceitos Fundamentais","count":13},{"language":"default","tag":"Onboarding","count":12},{"language":"default","tag":"Dicionário de Dados","count":9},{"language":"default","tag":"Solicitação","count":8},{"language":"default","tag":"API: Propostas e Esteiras","count":7},{"language":"default","tag":"Cadastro","count":7}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"mcp-banner.css","content":".mcp-banner{display:flex;align-items:center;gap:10px;margin:0 0 20px;padding:10px 14px;border-radius:12px;border:1px solid #1a54fa;background:rgba(26, 84, 250, 0.06);color:inherit;text-decoration:none!important;transition:background 0.15s ease}.mcp-banner:hover{background:rgba(26, 84, 250, 0.11)}.mcp-banner__badge{flex:none;font-size:10.5px;font-weight:700;letter-spacing:0.04em;text-transform:uppercase;padding:3px 7px;border-radius:999px;background:#1a54fa;color:#fff}.mcp-banner__text{flex:1;min-width:0;font-size:13.5px;line-height:1.45}.mcp-banner__cta{flex:none;font-size:13.5px;font-weight:600;color:#1a54fa;white-space:nowrap}.dark .mcp-banner{border-color:#6b8cff;background:rgba(107, 140, 255, 0.1)}.dark .mcp-banner:hover{background:rgba(107, 140, 255, 0.18)}.dark .mcp-banner__cta{color:#8fa8ff}@media (max-width: 720px){.mcp-banner{flex-wrap:wrap}.mcp-banner__text{flex-basis:100%;order:3}}"}]}
{"page":{"pagePath":"api-reference/registry/post-registry-validate-document","slug":"/api-reference/registry/post-registry-validate-document","pageMetadata":{"title":"Validar Documento","description":"Você tem um arquivo e quer o parecer agora.","surface":"api","domain":"cadastro","audience":"integrador","lang":"tecnica","openapi":"post /v1/registry/validate-document","href":"/api-reference/registry/post-registry-validate-document"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Você tem um arquivo e quer o parecer agora.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading,Note}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`3`,id:`quando-usar`,children:`Quando usar`}),`\n`,_jsx(_components.p,{children:`Você tem um arquivo e quer o parecer agora. Uma chamada, um arquivo, e o resultado volta na resposta.`}),`\n`,_jsx(Heading,{level:`3`,id:`a-entrada-é-única`,children:`A entrada é única`}),`\n`,_jsxs(_components.p,{children:[`Você `,_jsx(_components.strong,{children:`não diz`}),` que documento está mandando. A plataforma identifica entre os `,_jsx(_components.a,{href:`/onboarding/tipos-de-documento`,children:`25 tipos`}),` e o objeto `,_jsx(_components.code,{children:`extraction`}),` da resposta traz os campos `,_jsx(_components.strong,{children:`daquele tipo`}),`. O mapa completo está em `,_jsx(_components.a,{href:`/api-reference/onboarding/formatos-de-retorno`,children:`Formatos de retorno`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`expectedType`}),` não força nada: diz o que você `,_jsx(_components.strong,{children:`pediu`}),`, e a plataforma confronta com o que leu. É o campo que pega o arquivo legítimo enviado no lugar errado. Já `,_jsx(_components.code,{children:`typeHint`}),` `,_jsx(_components.strong,{children:`afirma`}),` o tipo e pula a classificação.`]}),`\n`,_jsx(Heading,{level:`3`,id:`trate-o-202-como-caminho-normal`,children:`Trate o 202 como caminho normal`}),`\n`,_jsxs(_components.p,{children:[`Documento longo ou digitalizado passa dos 55 segundos. Continue por `,_jsx(_components.a,{href:`/api-reference/registry/get-registry-documents-docid-status`,children:`Status do documento`}),`, ou assine o webhook `,_jsx(_components.code,{children:`registry.document.assessed`}),`.`]}),`\n`,_jsxs(Heading,{level:`3`,id:`leia-effectiveverdict`,children:[`Leia `,_jsx(_components.code,{children:`effectiveVerdict`})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`assessment.verdict`}),` é o parecer da IA, que nunca é reescrito. Quando um operador discorda, a decisão dele entra em `,_jsx(_components.code,{children:`feedbackVerdict`}),` e `,_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`effectiveVerdict`}),` passa a ser ela`]}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Contexto e vocabulário em `,_jsx(_components.a,{href:`/onboarding/analise-documental`,children:`Análise documental`}),`. Autenticação, versionamento e capacidades em `,_jsx(_components.a,{href:`/api-reference/onboarding/visao-geral`,children:`Visão geral da API`}),`.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Validar Documento","description":"Você tem um arquivo e quer o parecer agora.","surface":"api","domain":"cadastro","audience":"integrador","lang":"tecnica","openapi":"post /v1/registry/validate-document","href":"/api-reference/registry/post-registry-validate-document"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Quando usar","slug":"quando-usar","depth":3,"children":[]},{"title":"A entrada é única","slug":"a-entrada-é-única","depth":3,"children":[]},{"title":"Trate o 202 como caminho normal","slug":"trate-o-202-como-caminho-normal","depth":3,"children":[]},{"title":"Leia effectiveVerdict","slug":"leia-effectiveverdict","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"RegistryController_validateDocument","summary":"Validar um documento e receber o parecer","description":"Você tem um arquivo e quer o parecer agora.","parameters":[],"requestBody":"2e34c335-bfcb-4101-8de0-40d0bfe1eaf1","responses":{"200":"76e82330-9d9e-44f5-8377-8900a908ed71","202":"80ed1557-7393-4202-a61e-cce13a9606c0","400":"5b76416a-410a-41ec-8b5d-20667cf38f28","401":"47bd41a1-11aa-45eb-8721-ef016bd1d209","403":"0611183a-3faf-4626-af4e-49099bb46d3a","404":"8aaa2c4f-2f8c-4612-807c-40ed8bed1d34","413":"8cc4db55-2ced-41f6-8fc5-9511c5fef219","500":"1229af75-7306-4fd9-a0b4-882648718d9e","502":"d910d050-2333-4a37-9eda-35122029ebf5"},"tags":["registry"],"security":["8e2db591-d7cd-4655-90e7-bb0dd0adc598"],"x-codeSamples":[{"lang":"cURL","label":"cURL","source":"curl --request POST 'https://gyra-core.gyramais.com.br/v1/registry/validate-document' \\\n --header 'Authorization: Bearer \u003ctoken>' \\\n --form 'file=@\"/caminho/contrato-social.pdf\"' \\\n --form 'expectedDocument=\"11444777000161\"'\n"},{"lang":"JavaScript","label":"Node","source":"import fs from \"node:fs\";\n\nconst form = new FormData();\nform.append(\"file\", new Blob([fs.readFileSync(\"/caminho/contrato-social.pdf\")]), \"contrato-social.pdf\");\nform.append(\"expectedDocument\", \"11444777000161\");\n\nconst resposta = await fetch(\"https://gyra-core.gyramais.com.br/v1/registry/validate-document\", {\n method: \"POST\",\n headers: { Authorization: `Bearer ${token}` },\n body: form,\n});\n\nconst dados = await resposta.json();\n"},{"lang":"Python","label":"Python","source":"import requests\n\nwith open(\"/caminho/contrato-social.pdf\", \"rb\") as arquivo:\n resposta = requests.post(\n \"https://gyra-core.gyramais.com.br/v1/registry/validate-document\",\n headers={\"Authorization\": f\"Bearer {token}\"},\n files={\"file\": arquivo},\n data={\"expectedDocument\": \"11444777000161\"},\n )\n\ndados = resposta.json()\n"}],"method":"post","type":"path","servers":["42171238-82dd-4b6d-8980-cce1cc8ba345"],"path":"/v1/registry/validate-document","baseUrlOptions":["https://gyra-core.gyramais.com.br"],"title":"Validar um documento e receber o parecer","codeSamples":[{"label":"cURL","lang":"cURL","source":"curl --request POST 'https://gyra-core.gyramais.com.br/v1/registry/validate-document' \\\n --header 'Authorization: Bearer \u003ctoken>' \\\n --form 'file=@\"/caminho/contrato-social.pdf\"' \\\n --form 'expectedDocument=\"11444777000161\"'\n"},{"label":"Node","lang":"JavaScript","source":"import fs from \"node:fs\";\n\nconst form = new FormData();\nform.append(\"file\", new Blob([fs.readFileSync(\"/caminho/contrato-social.pdf\")]), \"contrato-social.pdf\");\nform.append(\"expectedDocument\", \"11444777000161\");\n\nconst resposta = await fetch(\"https://gyra-core.gyramais.com.br/v1/registry/validate-document\", {\n method: \"POST\",\n headers: { Authorization: `Bearer ${token}` },\n body: form,\n});\n\nconst dados = await resposta.json();\n"},{"label":"Python","lang":"Python","source":"import requests\n\nwith open(\"/caminho/contrato-social.pdf\", \"rb\") as arquivo:\n resposta = requests.post(\n \"https://gyra-core.gyramais.com.br/v1/registry/validate-document\",\n headers={\"Authorization\": f\"Bearer {token}\"},\n files={\"file\": arquivo},\n data={\"expectedDocument\": \"11444777000161\"},\n )\n\ndados = resposta.json()\n"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file","expectedDocument"],"properties":{"file":{"type":"string","format":"binary","description":"O arquivo, em multipart/form-data. PDF, JPG ou PNG, ate 15MB. Acima disso use presign_registry_document + confirm_registry_document.","isRequired":true,"uniqueKey":"file","typeLabel":"file"},"expectedDocument":{"type":"string","description":"CNPJ ou CPF da jornada, com ou sem mascara. Obrigatorio: e o dono do cadastro onde o documento sera arquivado.","isRequired":true,"uniqueKey":"expectedDocument","typeLabel":"string"},"expectedName":{"type":"string","description":"Razao social ou nome da jornada. Alimenta a verificacao EXPECTED_NAME_MATCH.","uniqueKey":"expectedName","typeLabel":"string"},"waitSeconds":{"type":"integer","minimum":5,"maximum":55,"description":"Espera maxima pela resposta sincrona, de 5 a 55. Padrao 45.","uniqueKey":"waitSeconds","typeLabel":"integer"},"typeHint":{"type":"string","enum":["CONTRATO_SOCIAL","ALTERACAO_CONTRATUAL","ESTATUTO_SOCIAL","REQUERIMENTO_EMPRESARIO","PROCURACAO_PJ","IRPJ_ECF","DECLARACAO_FATURAMENTO","CERTIDAO_JUNTA","ATA_ASSEMBLEIA","DOC_IDENTIDADE","COMPROVANTE_RESIDENCIA","DIRPF","COMPROVANTE_RENDA","CERTIDAO_PF","PROCURACAO_PF","FORA_DE_ESCOPO","NAO_IDENTIFICADO","CERTIDAO_PGFN_PJ","CERTIDAO_FGTS","CADIN_FEDERAL","CADIN_ESTADUAL","CERTIDAO_QSA","CERTIFICADO_SIMPLES_NACIONAL","ESOCIAL_PJ","COMPROVACAO_ESTADO_CIVIL","DEMONSTRACOES_FINANCEIRAS","EXTRATO_BANCARIO"],"description":"AFIRMA o tipo do arquivo: o pipeline adota e pula a classificacao. So use quando a origem ja garante o tipo.","uniqueKey":"typeHint","typeLabel":"enum\u003cstring>"},"expectedType":{"type":"string","enum":["CONTRATO_SOCIAL","ALTERACAO_CONTRATUAL","ESTATUTO_SOCIAL","REQUERIMENTO_EMPRESARIO","PROCURACAO_PJ","IRPJ_ECF","DECLARACAO_FATURAMENTO","CERTIDAO_JUNTA","ATA_ASSEMBLEIA","DOC_IDENTIDADE","COMPROVANTE_RESIDENCIA","DIRPF","COMPROVANTE_RENDA","CERTIDAO_PF","PROCURACAO_PF","FORA_DE_ESCOPO","NAO_IDENTIFICADO","CERTIDAO_PGFN_PJ","CERTIDAO_FGTS","CADIN_FEDERAL","CADIN_ESTADUAL","CERTIDAO_QSA","CERTIFICADO_SIMPLES_NACIONAL","ESOCIAL_PJ","COMPROVACAO_ESTADO_CIVIL","DEMONSTRACOES_FINANCEIRAS","EXTRATO_BANCARIO"],"description":"PEDE um tipo: a classificacao roda e o tipo lido e confrontado (verificacao EXPECTED_TYPE_MATCH). E o campo que pega documento trocado.","uniqueKey":"expectedType","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"file":"\u003cstring>","expectedDocument":"\u003cstring>","expectedName":"\u003cstring>","waitSeconds":30}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"76e82330-9d9e-44f5-8377-8900a908ed71":{"description":"Resultado completo (200) com type, extraction, validation.checks[] e assessment; ou { documentId, statusUrl } (202) quando ainda processa.","content":{"application/json":{"schema":{"type":"object","description":"Resultado completo de um documento, da classificacao ao parecer.","properties":{"documentId":{"type":"string","uniqueKey":"documentId","typeLabel":"string"},"registryId":{"type":"string","uniqueKey":"registryId","typeLabel":"string"},"type":{"type":"string","enum":["CONTRATO_SOCIAL","ALTERACAO_CONTRATUAL","ESTATUTO_SOCIAL","REQUERIMENTO_EMPRESARIO","ATA_ASSEMBLEIA","PROCURACAO_PJ","CERTIDAO_JUNTA","CERTIDAO_QSA","IRPJ_ECF","DECLARACAO_FATURAMENTO","CERTIFICADO_SIMPLES_NACIONAL","DEMONSTRACOES_FINANCEIRAS","EXTRATO_BANCARIO","CERTIDAO_PGFN_PJ","CERTIDAO_FGTS","CADIN_FEDERAL","CADIN_ESTADUAL","ESOCIAL_PJ","DOC_IDENTIDADE","COMPROVANTE_RESIDENCIA","DIRPF","COMPROVANTE_RENDA","CERTIDAO_PF","PROCURACAO_PF","COMPROVACAO_ESTADO_CIVIL","FORA_DE_ESCOPO","NAO_IDENTIFICADO"],"description":"O tipo LIDO pela classificacao.","uniqueKey":"type","typeLabel":"enum\u003cstring>"},"expectedType":{"oneOf":[{"type":"string","enum":["CONTRATO_SOCIAL","ALTERACAO_CONTRATUAL","ESTATUTO_SOCIAL","REQUERIMENTO_EMPRESARIO","ATA_ASSEMBLEIA","PROCURACAO_PJ","CERTIDAO_JUNTA","CERTIDAO_QSA","IRPJ_ECF","DECLARACAO_FATURAMENTO","CERTIFICADO_SIMPLES_NACIONAL","DEMONSTRACOES_FINANCEIRAS","EXTRATO_BANCARIO","CERTIDAO_PGFN_PJ","CERTIDAO_FGTS","CADIN_FEDERAL","CADIN_ESTADUAL","ESOCIAL_PJ","DOC_IDENTIDADE","COMPROVANTE_RESIDENCIA","DIRPF","COMPROVANTE_RENDA","CERTIDAO_PF","PROCURACAO_PF","COMPROVACAO_ESTADO_CIVIL","FORA_DE_ESCOPO","NAO_IDENTIFICADO",null],"description":"O tipo PEDIDO no envio. Sustenta a verificacao EXPECTED_TYPE_MATCH.","uniqueKey":"expectedType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["CONTRATO_SOCIAL","ALTERACAO_CONTRATUAL","ESTATUTO_SOCIAL","REQUERIMENTO_EMPRESARIO","ATA_ASSEMBLEIA","PROCURACAO_PJ","CERTIDAO_JUNTA","CERTIDAO_QSA","IRPJ_ECF","DECLARACAO_FATURAMENTO","CERTIFICADO_SIMPLES_NACIONAL","DEMONSTRACOES_FINANCEIRAS","EXTRATO_BANCARIO","CERTIDAO_PGFN_PJ","CERTIDAO_FGTS","CADIN_FEDERAL","CADIN_ESTADUAL","ESOCIAL_PJ","DOC_IDENTIDADE","COMPROVANTE_RESIDENCIA","DIRPF","COMPROVANTE_RENDA","CERTIDAO_PF","PROCURACAO_PF","COMPROVACAO_ESTADO_CIVIL","FORA_DE_ESCOPO","NAO_IDENTIFICADO",null],"description":"O tipo PEDIDO no envio. Sustenta a verificacao EXPECTED_TYPE_MATCH.","uniqueKey":"expectedType.oneOf.1","typeLabel":"null"}],"uniqueKey":"expectedType","typeLabel":"enum\u003cstring> | null"},"expectedTypes":{"type":"array","items":{"type":"string","enum":["CONTRATO_SOCIAL","ALTERACAO_CONTRATUAL","ESTATUTO_SOCIAL","REQUERIMENTO_EMPRESARIO","ATA_ASSEMBLEIA","PROCURACAO_PJ","CERTIDAO_JUNTA","CERTIDAO_QSA","IRPJ_ECF","DECLARACAO_FATURAMENTO","CERTIFICADO_SIMPLES_NACIONAL","DEMONSTRACOES_FINANCEIRAS","EXTRATO_BANCARIO","CERTIDAO_PGFN_PJ","CERTIDAO_FGTS","CADIN_FEDERAL","CADIN_ESTADUAL","ESOCIAL_PJ","DOC_IDENTIDADE","COMPROVANTE_RESIDENCIA","DIRPF","COMPROVANTE_RENDA","CERTIDAO_PF","PROCURACAO_PF","COMPROVACAO_ESTADO_CIVIL","FORA_DE_ESCOPO","NAO_IDENTIFICADO"],"uniqueKey":"expectedTypes.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"O CONJUNTO pedido, quando o item nasceu de um requisito societario.","uniqueKey":"expectedTypes","typeLabel":"enum\u003cstring>[]"},"status":{"type":"string","enum":["RECEIVED","CLASSIFYING","CLASSIFIED","EXTRACTING","EXTRACTED","VALIDATING","VALIDATED","FAILED","MANUAL_REVIEW","OUT_OF_SCOPE","REJECTED_QUALITY"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"version":{"type":"integer","uniqueKey":"version","typeLabel":"integer"},"isCurrent":{"type":"boolean","uniqueKey":"isCurrent","typeLabel":"boolean"},"classification":{"oneOf":[{"type":"object","description":"O que a classificacao concluiu, com as alternativas consideradas.","properties":{"type":{"type":"string","enum":["CONTRATO_SOCIAL","ALTERACAO_CONTRATUAL","ESTATUTO_SOCIAL","REQUERIMENTO_EMPRESARIO","ATA_ASSEMBLEIA","PROCURACAO_PJ","CERTIDAO_JUNTA","CERTIDAO_QSA","IRPJ_ECF","DECLARACAO_FATURAMENTO","CERTIFICADO_SIMPLES_NACIONAL","DEMONSTRACOES_FINANCEIRAS","EXTRATO_BANCARIO","CERTIDAO_PGFN_PJ","CERTIDAO_FGTS","CADIN_FEDERAL","CADIN_ESTADUAL","ESOCIAL_PJ","DOC_IDENTIDADE","COMPROVANTE_RESIDENCIA","DIRPF","COMPROVANTE_RENDA","CERTIDAO_PF","PROCURACAO_PF","COMPROVACAO_ESTADO_CIVIL","FORA_DE_ESCOPO","NAO_IDENTIFICADO"],"uniqueKey":"classification.oneOf.0.type","typeLabel":"enum\u003cstring>"},"confidence":{"type":"number","description":"0 a 1.","uniqueKey":"classification.oneOf.0.confidence","typeLabel":"number"},"alternatives":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["CONTRATO_SOCIAL","ALTERACAO_CONTRATUAL","ESTATUTO_SOCIAL","REQUERIMENTO_EMPRESARIO","ATA_ASSEMBLEIA","PROCURACAO_PJ","CERTIDAO_JUNTA","CERTIDAO_QSA","IRPJ_ECF","DECLARACAO_FATURAMENTO","CERTIFICADO_SIMPLES_NACIONAL","DEMONSTRACOES_FINANCEIRAS","EXTRATO_BANCARIO","CERTIDAO_PGFN_PJ","CERTIDAO_FGTS","CADIN_FEDERAL","CADIN_ESTADUAL","ESOCIAL_PJ","DOC_IDENTIDADE","COMPROVANTE_RESIDENCIA","DIRPF","COMPROVANTE_RENDA","CERTIDAO_PF","PROCURACAO_PF","COMPROVACAO_ESTADO_CIVIL","FORA_DE_ESCOPO","NAO_IDENTIFICADO"],"uniqueKey":"classification.oneOf.0.alternatives.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"confidence":{"type":"number","uniqueKey":"classification.oneOf.0.alternatives.items.[INDEX].confidence","typeLabel":"number"}},"uniqueKey":"classification.oneOf.0.alternatives.items.[INDEX]","typeLabel":"object"},"uniqueKey":"classification.oneOf.0.alternatives","typeLabel":"object[]"}},"uniqueKey":"classification.oneOf.0","typeLabel":"object"},{"type":"null","description":"O que a classificacao concluiu, com as alternativas consideradas.","properties":{"type":{"type":"string","enum":["CONTRATO_SOCIAL","ALTERACAO_CONTRATUAL","ESTATUTO_SOCIAL","REQUERIMENTO_EMPRESARIO","ATA_ASSEMBLEIA","PROCURACAO_PJ","CERTIDAO_JUNTA","CERTIDAO_QSA","IRPJ_ECF","DECLARACAO_FATURAMENTO","CERTIFICADO_SIMPLES_NACIONAL","DEMONSTRACOES_FINANCEIRAS","EXTRATO_BANCARIO","CERTIDAO_PGFN_PJ","CERTIDAO_FGTS","CADIN_FEDERAL","CADIN_ESTADUAL","ESOCIAL_PJ","DOC_IDENTIDADE","COMPROVANTE_RESIDENCIA","DIRPF","COMPROVANTE_RENDA","CERTIDAO_PF","PROCURACAO_PF","COMPROVACAO_ESTADO_CIVIL","FORA_DE_ESCOPO","NAO_IDENTIFICADO"]},"confidence":{"type":"number","description":"0 a 1."},"alternatives":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["CONTRATO_SOCIAL","ALTERACAO_CONTRATUAL","ESTATUTO_SOCIAL","REQUERIMENTO_EMPRESARIO","ATA_ASSEMBLEIA","PROCURACAO_PJ","CERTIDAO_JUNTA","CERTIDAO_QSA","IRPJ_ECF","DECLARACAO_FATURAMENTO","CERTIFICADO_SIMPLES_NACIONAL","DEMONSTRACOES_FINANCEIRAS","EXTRATO_BANCARIO","CERTIDAO_PGFN_PJ","CERTIDAO_FGTS","CADIN_FEDERAL","CADIN_ESTADUAL","ESOCIAL_PJ","DOC_IDENTIDADE","COMPROVANTE_RESIDENCIA","DIRPF","COMPROVANTE_RENDA","CERTIDAO_PF","PROCURACAO_PF","COMPROVACAO_ESTADO_CIVIL","FORA_DE_ESCOPO","NAO_IDENTIFICADO"]},"confidence":{"type":"number"}}}}},"uniqueKey":"classification.oneOf.1","typeLabel":"null"}],"uniqueKey":"classification","typeLabel":"object | null"},"ambiguous":{"type":"boolean","description":"true quando outra alternativa passou de 0,35 de confianca.","uniqueKey":"ambiguous","typeLabel":"boolean"},"statusReason":{"oneOf":[{"type":"string","description":"Por que o documento parou num terminal que nao e falha tecnica.","uniqueKey":"statusReason.oneOf.0","typeLabel":"string"},{"type":"null","description":"Por que o documento parou num terminal que nao e falha tecnica.","uniqueKey":"statusReason.oneOf.1","typeLabel":"null"}],"uniqueKey":"statusReason","typeLabel":"string | null"},"stages":{"oneOf":[{"type":"object","description":"O que rodou nesta tentativa e o que veio reaproveitado.","properties":{"executed":{"type":"array","items":{"type":"string","enum":["CLASSIFY","EXTRACT","VALIDATE"],"uniqueKey":"stages.oneOf.0.executed.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"stages.oneOf.0.executed","typeLabel":"enum\u003cstring>[]"},"reused":{"type":"array","items":{"type":"object","properties":{"stage":{"type":"string","enum":["CLASSIFY","EXTRACT","VALIDATE"],"uniqueKey":"stages.oneOf.0.reused.items.[INDEX].stage","typeLabel":"enum\u003cstring>"},"fromAttempt":{"type":"integer","uniqueKey":"stages.oneOf.0.reused.items.[INDEX].fromAttempt","typeLabel":"integer"}},"uniqueKey":"stages.oneOf.0.reused.items.[INDEX]","typeLabel":"object"},"uniqueKey":"stages.oneOf.0.reused","typeLabel":"object[]"}},"uniqueKey":"stages.oneOf.0","typeLabel":"object"},{"type":"null","description":"O que rodou nesta tentativa e o que veio reaproveitado.","properties":{"executed":{"type":"array","items":{"type":"string","enum":["CLASSIFY","EXTRACT","VALIDATE"]}},"reused":{"type":"array","items":{"type":"object","properties":{"stage":{"type":"string","enum":["CLASSIFY","EXTRACT","VALIDATE"]},"fromAttempt":{"type":"integer"}}}}},"uniqueKey":"stages.oneOf.1","typeLabel":"null"}],"uniqueKey":"stages","typeLabel":"object | null"},"extraction":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Os campos lidos. A FORMA DEPENDE DO TIPO identificado: cada um dos 25 tipos tem o seu conjunto, documentado campo a campo em https://developers.gyramais.com.br/api-reference/kyc/formatos-de-retorno. Todo campo folha vem como { value, confidence, page }; campo ausente vem com value null e confidence 0.","uniqueKey":"extraction.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Os campos lidos. A FORMA DEPENDE DO TIPO identificado: cada um dos 25 tipos tem o seu conjunto, documentado campo a campo em https://developers.gyramais.com.br/api-reference/kyc/formatos-de-retorno. Todo campo folha vem como { value, confidence, page }; campo ausente vem com value null e confidence 0.","uniqueKey":"extraction.oneOf.1","typeLabel":"null"}],"uniqueKey":"extraction","typeLabel":"object | null"},"fieldConfidences":{"oneOf":[{"type":"object","additionalProperties":{"type":"number","uniqueKey":"fieldConfidences.oneOf.0.additionalProperties","typeLabel":"number"},"description":"Confianca por caminho de campo.","uniqueKey":"fieldConfidences.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"number","uniqueKey":"fieldConfidences.oneOf.1.additionalProperties","typeLabel":"number"},"description":"Confianca por caminho de campo.","uniqueKey":"fieldConfidences.oneOf.1","typeLabel":"null"}],"uniqueKey":"fieldConfidences","typeLabel":"object | null"},"validation":{"oneOf":[{"type":"object","properties":{"checks":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Codigo da verificacao no catalogo (ex.: EXPECTED_DOCUMENT_MATCH).","uniqueKey":"validation.oneOf.0.checks.items.[INDEX].code","typeLabel":"string"},"result":{"type":"string","enum":["PASS","WARN","FAIL","SKIP"],"description":"WARN e ressalva: aparece no parecer e nao reprova sozinha.","uniqueKey":"validation.oneOf.0.checks.items.[INDEX].result","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Frase em portugues explicando o resultado.","uniqueKey":"validation.oneOf.0.checks.items.[INDEX].message","typeLabel":"string"},"evidence":{"oneOf":[{"type":"object","description":"Onde no documento a verificacao se apoiou.","properties":{"page":{"oneOf":[{"type":"integer","uniqueKey":"validation.oneOf.0.checks.items.[INDEX].evidence.oneOf.0.page.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"validation.oneOf.0.checks.items.[INDEX].evidence.oneOf.0.page.oneOf.1","typeLabel":"null"}],"uniqueKey":"validation.oneOf.0.checks.items.[INDEX].evidence.oneOf.0.page","typeLabel":"integer | null"},"excerpt":{"oneOf":[{"type":"string","uniqueKey":"validation.oneOf.0.checks.items.[INDEX].evidence.oneOf.0.excerpt.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"validation.oneOf.0.checks.items.[INDEX].evidence.oneOf.0.excerpt.oneOf.1","typeLabel":"null"}],"uniqueKey":"validation.oneOf.0.checks.items.[INDEX].evidence.oneOf.0.excerpt","typeLabel":"string | null"},"checkCode":{"type":"string","uniqueKey":"validation.oneOf.0.checks.items.[INDEX].evidence.oneOf.0.checkCode","typeLabel":"string"}},"uniqueKey":"validation.oneOf.0.checks.items.[INDEX].evidence.oneOf.0","typeLabel":"object"},{"type":"null","description":"Onde no documento a verificacao se apoiou.","properties":{"page":{"oneOf":[{"type":"integer"},{"type":"null"}]},"excerpt":{"oneOf":[{"type":"string"},{"type":"null"}]},"checkCode":{"type":"string"}},"uniqueKey":"validation.oneOf.0.checks.items.[INDEX].evidence.oneOf.1","typeLabel":"null"}],"uniqueKey":"validation.oneOf.0.checks.items.[INDEX].evidence","typeLabel":"object | null"},"details":{"type":"array","items":{"type":"string","uniqueKey":"validation.oneOf.0.checks.items.[INDEX].details.items.[INDEX]","typeLabel":"string"},"description":"Indicios individuais, quando a verificacao produz varios.","uniqueKey":"validation.oneOf.0.checks.items.[INDEX].details","typeLabel":"string[]"},"source":{"type":"string","enum":["DETERMINISTIC","RECONCILIATION","LLM"],"description":"Quem produziu o resultado.","uniqueKey":"validation.oneOf.0.checks.items.[INDEX].source","typeLabel":"enum\u003cstring>"},"rfi":{"type":"integer","uniqueKey":"validation.oneOf.0.checks.items.[INDEX].rfi","typeLabel":"integer"}},"uniqueKey":"validation.oneOf.0.checks.items.[INDEX]","typeLabel":"object"},"uniqueKey":"validation.oneOf.0.checks","typeLabel":"object[]"},"reconciliation":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Conferencia contra a fonte oficial.","uniqueKey":"validation.oneOf.0.reconciliation.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Conferencia contra a fonte oficial.","uniqueKey":"validation.oneOf.0.reconciliation.oneOf.1","typeLabel":"null"}],"uniqueKey":"validation.oneOf.0.reconciliation","typeLabel":"object | null"}},"uniqueKey":"validation.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"checks":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Codigo da verificacao no catalogo (ex.: EXPECTED_DOCUMENT_MATCH)."},"result":{"type":"string","enum":["PASS","WARN","FAIL","SKIP"],"description":"WARN e ressalva: aparece no parecer e nao reprova sozinha."},"message":{"type":"string","description":"Frase em portugues explicando o resultado."},"evidence":{"oneOf":[{"type":"object","description":"Onde no documento a verificacao se apoiou.","properties":{"page":{"oneOf":[{"type":"integer"},{"type":"null"}]},"excerpt":{"oneOf":[{"type":"string"},{"type":"null"}]},"checkCode":{"type":"string"}}},{"type":"null","description":"Onde no documento a verificacao se apoiou.","properties":{"page":{"oneOf":[{"type":"integer"},{"type":"null"}]},"excerpt":{"oneOf":[{"type":"string"},{"type":"null"}]},"checkCode":{"type":"string"}}}]},"details":{"type":"array","items":{"type":"string"},"description":"Indicios individuais, quando a verificacao produz varios."},"source":{"type":"string","enum":["DETERMINISTIC","RECONCILIATION","LLM"],"description":"Quem produziu o resultado."},"rfi":{"type":"integer"}}}},"reconciliation":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Conferencia contra a fonte oficial."},{"type":"null","additionalProperties":true,"description":"Conferencia contra a fonte oficial."}]}},"uniqueKey":"validation.oneOf.1","typeLabel":"null"}],"uniqueKey":"validation","typeLabel":"object | null"},"assessment":{"oneOf":[{"type":"object","properties":{"verdict":{"type":"string","enum":["VALIDO","INVALIDO","INCONCLUSIVO","ANALISE_MANUAL"],"description":"O parecer da IA. NAO e o veredito que vale: use effectiveVerdict.","uniqueKey":"assessment.oneOf.0.verdict","typeLabel":"enum\u003cstring>"},"score":{"type":"number","description":"0 a 1.","uniqueKey":"assessment.oneOf.0.score","typeLabel":"number"},"justification":{"type":"string","description":"Por que, em portugues.","uniqueKey":"assessment.oneOf.0.justification","typeLabel":"string"},"evidences":{"type":"array","items":{"type":"object","properties":{"page":{"oneOf":[{"type":"integer","uniqueKey":"assessment.oneOf.0.evidences.items.[INDEX].page.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"assessment.oneOf.0.evidences.items.[INDEX].page.oneOf.1","typeLabel":"null"}],"uniqueKey":"assessment.oneOf.0.evidences.items.[INDEX].page","typeLabel":"integer | null"},"excerpt":{"oneOf":[{"type":"string","uniqueKey":"assessment.oneOf.0.evidences.items.[INDEX].excerpt.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"assessment.oneOf.0.evidences.items.[INDEX].excerpt.oneOf.1","typeLabel":"null"}],"uniqueKey":"assessment.oneOf.0.evidences.items.[INDEX].excerpt","typeLabel":"string | null"},"checkCode":{"type":"string","uniqueKey":"assessment.oneOf.0.evidences.items.[INDEX].checkCode","typeLabel":"string"}},"uniqueKey":"assessment.oneOf.0.evidences.items.[INDEX]","typeLabel":"object"},"uniqueKey":"assessment.oneOf.0.evidences","typeLabel":"object[]"},"ruleSetVersion":{"type":"string","description":"Qual versao da regua julgou este documento.","uniqueKey":"assessment.oneOf.0.ruleSetVersion","typeLabel":"string"},"contentHash":{"oneOf":[{"type":"string","description":"Selo do parecer, conferivel na rota de integridade.","uniqueKey":"assessment.oneOf.0.contentHash.oneOf.0","typeLabel":"string"},{"type":"null","description":"Selo do parecer, conferivel na rota de integridade.","uniqueKey":"assessment.oneOf.0.contentHash.oneOf.1","typeLabel":"null"}],"uniqueKey":"assessment.oneOf.0.contentHash","typeLabel":"string | null"},"feedbackVerdict":{"oneOf":[{"type":"string","enum":["VALIDO","INVALIDO","INCONCLUSIVO","ANALISE_MANUAL",null],"description":"A decisao que um operador registrou, quando houve.","uniqueKey":"assessment.oneOf.0.feedbackVerdict.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["VALIDO","INVALIDO","INCONCLUSIVO","ANALISE_MANUAL",null],"description":"A decisao que um operador registrou, quando houve.","uniqueKey":"assessment.oneOf.0.feedbackVerdict.oneOf.1","typeLabel":"null"}],"uniqueKey":"assessment.oneOf.0.feedbackVerdict","typeLabel":"enum\u003cstring> | null"},"feedbackComment":{"oneOf":[{"type":"string","uniqueKey":"assessment.oneOf.0.feedbackComment.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"assessment.oneOf.0.feedbackComment.oneOf.1","typeLabel":"null"}],"uniqueKey":"assessment.oneOf.0.feedbackComment","typeLabel":"string | null"},"feedbackAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"assessment.oneOf.0.feedbackAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"assessment.oneOf.0.feedbackAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"assessment.oneOf.0.feedbackAt","typeLabel":"string\u003cdate-time> | null"},"feedbackUserId":{"oneOf":[{"type":"string","uniqueKey":"assessment.oneOf.0.feedbackUserId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"assessment.oneOf.0.feedbackUserId.oneOf.1","typeLabel":"null"}],"uniqueKey":"assessment.oneOf.0.feedbackUserId","typeLabel":"string | null"},"effectiveVerdict":{"oneOf":[{"type":"string","enum":["VALIDO","INVALIDO","INCONCLUSIVO","ANALISE_MANUAL",null],"description":"O VEREDITO QUE VALE HOJE (feedbackVerdict ?? verdict). Leia este.","uniqueKey":"assessment.oneOf.0.effectiveVerdict.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["VALIDO","INVALIDO","INCONCLUSIVO","ANALISE_MANUAL",null],"description":"O VEREDITO QUE VALE HOJE (feedbackVerdict ?? verdict). Leia este.","uniqueKey":"assessment.oneOf.0.effectiveVerdict.oneOf.1","typeLabel":"null"}],"uniqueKey":"assessment.oneOf.0.effectiveVerdict","typeLabel":"enum\u003cstring> | null"},"decidedByOperator":{"type":"boolean","description":"true quando quem decidiu foi uma pessoa, e nao o pipeline.","uniqueKey":"assessment.oneOf.0.decidedByOperator","typeLabel":"boolean"}},"uniqueKey":"assessment.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"verdict":{"type":"string","enum":["VALIDO","INVALIDO","INCONCLUSIVO","ANALISE_MANUAL"],"description":"O parecer da IA. NAO e o veredito que vale: use effectiveVerdict."},"score":{"type":"number","description":"0 a 1."},"justification":{"type":"string","description":"Por que, em portugues."},"evidences":{"type":"array","items":{"type":"object","properties":{"page":{"oneOf":[{"type":"integer"},{"type":"null"}]},"excerpt":{"oneOf":[{"type":"string"},{"type":"null"}]},"checkCode":{"type":"string"}}}},"ruleSetVersion":{"type":"string","description":"Qual versao da regua julgou este documento."},"contentHash":{"oneOf":[{"type":"string","description":"Selo do parecer, conferivel na rota de integridade."},{"type":"null","description":"Selo do parecer, conferivel na rota de integridade."}]},"feedbackVerdict":{"oneOf":[{"type":"string","enum":["VALIDO","INVALIDO","INCONCLUSIVO","ANALISE_MANUAL",null],"description":"A decisao que um operador registrou, quando houve."},{"type":"null","enum":["VALIDO","INVALIDO","INCONCLUSIVO","ANALISE_MANUAL",null],"description":"A decisao que um operador registrou, quando houve."}]},"feedbackComment":{"oneOf":[{"type":"string"},{"type":"null"}]},"feedbackAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]},"feedbackUserId":{"oneOf":[{"type":"string"},{"type":"null"}]},"effectiveVerdict":{"oneOf":[{"type":"string","enum":["VALIDO","INVALIDO","INCONCLUSIVO","ANALISE_MANUAL",null],"description":"O VEREDITO QUE VALE HOJE (feedbackVerdict ?? verdict). Leia este."},{"type":"null","enum":["VALIDO","INVALIDO","INCONCLUSIVO","ANALISE_MANUAL",null],"description":"O VEREDITO QUE VALE HOJE (feedbackVerdict ?? verdict). Leia este."}]},"decidedByOperator":{"type":"boolean","description":"true quando quem decidiu foi uma pessoa, e nao o pipeline."}},"uniqueKey":"assessment.oneOf.1","typeLabel":"null"}],"uniqueKey":"assessment","typeLabel":"object | null"},"processedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"processedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"processedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"processedAt","typeLabel":"string\u003cdate-time> | null"},"attempt":{"type":"integer","uniqueKey":"attempt","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"documentId":"6612a7f30000000000000031","registryId":"6612a7f30000000000000001","type":"CONTRATO_SOCIAL","expectedType":"CONTRATO_SOCIAL","expectedTypes":[],"status":"VALIDATED","version":2,"isCurrent":true,"classification":{"type":"CONTRATO_SOCIAL","confidence":0.94,"alternatives":[{"type":"ALTERACAO_CONTRATUAL","confidence":0.21}]},"ambiguous":false,"statusReason":null,"stages":{"executed":["CLASSIFY","EXTRACT","VALIDATE"],"reused":[]},"extraction":{"cnpj":{"value":"11444777000161","confidence":0.97,"page":1},"companyName":{"value":"AURORA COMPONENTES INDUSTRIAIS LTDA","confidence":0.96,"page":1},"signatureDate":{"value":"2021-04-30T00:00:00.000Z","confidence":0.93,"page":8},"capitalAmount":{"value":1200000,"confidence":0.95,"page":3},"capitalCurrency":{"value":"BRL","confidence":0.99,"page":3},"quotaUnitValue":{"value":null,"confidence":0,"page":null},"partners":[{"name":{"value":"CARLOS EDUARDO SILVA","confidence":0.96,"page":1},"document":{"value":"52998224725","confidence":0.95,"page":1},"documentType":{"value":"CPF","confidence":0.99,"page":1},"sharePercent":{"value":60,"confidence":0.95,"page":3},"isAdministrator":{"value":true,"confidence":0.92,"page":4}}],"representation":{"regime":{"value":"ISOLADA","confidence":0.95,"page":4},"signersRequired":{"value":1,"confidence":0.95,"page":4},"clauseNumber":{"value":"CLÁUSULA 8ª","confidence":0.94,"page":4},"clauseExcerpt":{"value":"A administração da sociedade caberá isoladamente ao sócio CARLOS EDUARDO SILVA...","confidence":0.94,"page":4}},"certification":{"certificationKind":{"value":"ORGAO_EMISSOR","confidence":0.97,"page":1},"certificationDetail":{"value":"Chancela digital da Junta Comercial","confidence":0.96,"page":1},"verificationCode":{"value":"A1B2C3D4E5","confidence":0.98,"page":1}}},"fieldConfidences":{"cnpj":0.97,"companyName":0.96,"capitalAmount":0.95},"validation":{"checks":[{"code":"EXPECTED_DOCUMENT_MATCH","result":"PASS","message":"O CNPJ do documento é o mesmo da análise.","evidence":{"page":1,"excerpt":"CNPJ 11.444.777/0001-61"},"source":"DETERMINISTIC"},{"code":"QSA_SHARE_SUM","result":"WARN","message":"A soma das participações fecha 98%, fora da tolerância de 0,5 ponto.","evidence":{"page":3,"excerpt":"CARLOS EDUARDO SILVA 60% ... MARIA HELENA SOUZA 38%"},"source":"DETERMINISTIC"}],"reconciliation":{"qsaMatched":true}},"assessment":{"verdict":"VALIDO","score":0.91,"justification":"Documento íntegro, titularidade confirmada e registro na Junta conferido. A soma das quotas ficou 2 pontos abaixo de 100%, o que é ressalva e não impedimento.","evidences":[],"ruleSetVersion":"org-v7","contentHash":"9f2b7c1e4a...","feedbackVerdict":null,"feedbackComment":null,"feedbackAt":null,"feedbackUserId":null,"effectiveVerdict":"VALIDO","decidedByOperator":false},"processedAt":"2026-09-05T13:07:44.000Z","attempt":1},"examples":{"Example":{"title":"Example","value":{"documentId":"6612a7f30000000000000031","registryId":"6612a7f30000000000000001","type":"CONTRATO_SOCIAL","expectedType":"CONTRATO_SOCIAL","expectedTypes":[],"status":"VALIDATED","version":2,"isCurrent":true,"classification":{"type":"CONTRATO_SOCIAL","confidence":0.94,"alternatives":[{"type":"ALTERACAO_CONTRATUAL","confidence":0.21}]},"ambiguous":false,"statusReason":null,"stages":{"executed":["CLASSIFY","EXTRACT","VALIDATE"],"reused":[]},"extraction":{"cnpj":{"value":"11444777000161","confidence":0.97,"page":1},"companyName":{"value":"AURORA COMPONENTES INDUSTRIAIS LTDA","confidence":0.96,"page":1},"signatureDate":{"value":"2021-04-30T00:00:00.000Z","confidence":0.93,"page":8},"capitalAmount":{"value":1200000,"confidence":0.95,"page":3},"capitalCurrency":{"value":"BRL","confidence":0.99,"page":3},"quotaUnitValue":{"value":null,"confidence":0,"page":null},"partners":[{"name":{"value":"CARLOS EDUARDO SILVA","confidence":0.96,"page":1},"document":{"value":"52998224725","confidence":0.95,"page":1},"documentType":{"value":"CPF","confidence":0.99,"page":1},"sharePercent":{"value":60,"confidence":0.95,"page":3},"isAdministrator":{"value":true,"confidence":0.92,"page":4}}],"representation":{"regime":{"value":"ISOLADA","confidence":0.95,"page":4},"signersRequired":{"value":1,"confidence":0.95,"page":4},"clauseNumber":{"value":"CLÁUSULA 8ª","confidence":0.94,"page":4},"clauseExcerpt":{"value":"A administração da sociedade caberá isoladamente ao sócio CARLOS EDUARDO SILVA...","confidence":0.94,"page":4}},"certification":{"certificationKind":{"value":"ORGAO_EMISSOR","confidence":0.97,"page":1},"certificationDetail":{"value":"Chancela digital da Junta Comercial","confidence":0.96,"page":1},"verificationCode":{"value":"A1B2C3D4E5","confidence":0.98,"page":1}}},"fieldConfidences":{"cnpj":0.97,"companyName":0.96,"capitalAmount":0.95},"validation":{"checks":[{"code":"EXPECTED_DOCUMENT_MATCH","result":"PASS","message":"O CNPJ do documento é o mesmo da análise.","evidence":{"page":1,"excerpt":"CNPJ 11.444.777/0001-61"},"source":"DETERMINISTIC"},{"code":"QSA_SHARE_SUM","result":"WARN","message":"A soma das participações fecha 98%, fora da tolerância de 0,5 ponto.","evidence":{"page":3,"excerpt":"CARLOS EDUARDO SILVA 60% ... MARIA HELENA SOUZA 38%"},"source":"DETERMINISTIC"}],"reconciliation":{"qsaMatched":true}},"assessment":{"verdict":"VALIDO","score":0.91,"justification":"Documento íntegro, titularidade confirmada e registro na Junta conferido. A soma das quotas ficou 2 pontos abaixo de 100%, o que é ressalva e não impedimento.","evidences":[],"ruleSetVersion":"org-v7","contentHash":"9f2b7c1e4a...","feedbackVerdict":null,"feedbackComment":null,"feedbackAt":null,"feedbackUserId":null,"effectiveVerdict":"VALIDO","decidedByOperator":false},"processedAt":"2026-09-05T13:07:44.000Z","attempt":1}}},"exampleType":"examples"}},"exampleType":"examples"},"80ed1557-7393-4202-a61e-cce13a9606c0":{"description":"O pipeline nao fechou dentro de `waitSeconds`. `statusUrl` e um caminho relativo, sem o prefixo de versao: continue por GET nele (ou em /v1/registry/documents/{docId}/status), ou assine o webhook `registry.document.assessed` e pare de fazer polling.","content":{"application/json":{"schema":{"type":"object","description":"Resposta 202: o pipeline nao fechou dentro de waitSeconds.","properties":{"documentId":{"type":"string","uniqueKey":"documentId","typeLabel":"string"},"statusUrl":{"type":"string","description":"Endereco para continuar por polling ate o status ser terminal.","uniqueKey":"statusUrl","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"documentId":"6612a7f30000000000000031","statusUrl":"/registry/documents/6612a7f30000000000000031/status"},"examples":{"Example":{"title":"Example","value":{"documentId":"6612a7f30000000000000031","statusUrl":"/registry/documents/6612a7f30000000000000031/status"}}},"exampleType":"examples"}},"exampleType":"examples"},"5b76416a-410a-41ec-8b5d-20667cf38f28":{"description":"Corpo invalido, arquivo ausente, tipo de arquivo fora de PDF/JPG/PNG ou conteudo que nao confere com o tipo declarado.","content":{"application/json":{"schema":{"type":"object","description":"Formato unico de erro da API. Nao faca match exato da mensagem: use o code.","properties":{"code":{"type":"integer","description":"Codigo HTTP.","uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Mensagem em portugues. Em erro de validacao, traz TODAS as falhas concatenadas por virgula.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":400,"message":"O arquivo do documento é obrigatório (campo \"file\")."},"examples":{"Example":{"title":"Example","value":{"code":400,"message":"O arquivo do documento é obrigatório (campo \"file\")."}}},"exampleType":"examples"}},"exampleType":"examples"},"47bd41a1-11aa-45eb-8721-ef016bd1d209":{"description":"Token ausente, expirado ou invalido. Gere outro em POST /auth/authenticate.","content":{"application/json":{"schema":{"type":"object","description":"Formato unico de erro da API. Nao faca match exato da mensagem: use o code.","properties":{"code":{"type":"integer","description":"Codigo HTTP.","uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Mensagem em portugues. Em erro de validacao, traz TODAS as falhas concatenadas por virgula.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":401,"message":"Token de acesso inválido."},"examples":{"Example":{"title":"Example","value":{"code":401,"message":"Token de acesso inválido."}}},"exampleType":"examples"}},"exampleType":"examples"},"0611183a-3faf-4626-af4e-49099bb46d3a":{"description":"O usuario autenticado nao tem a permissao exigida pela rota.","content":{"application/json":{"schema":{"type":"object","description":"Formato unico de erro da API. Nao faca match exato da mensagem: use o code.","properties":{"code":{"type":"integer","description":"Codigo HTTP.","uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Mensagem em portugues. Em erro de validacao, traz TODAS as falhas concatenadas por virgula.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":403,"message":"Você não tem permissão para acessar este recurso."},"examples":{"Example":{"title":"Example","value":{"code":403,"message":"Você não tem permissão para acessar este recurso."}}},"exampleType":"examples"}},"exampleType":"examples"},"8aaa2c4f-2f8c-4612-807c-40ed8bed1d34":{"description":"O modulo Onboarding nao esta liberado para a organizacao: para ela, a rota nao existe.","content":{"application/json":{"schema":{"type":"object","description":"Formato unico de erro da API. Nao faca match exato da mensagem: use o code.","properties":{"code":{"type":"integer","description":"Codigo HTTP.","uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Mensagem em portugues. Em erro de validacao, traz TODAS as falhas concatenadas por virgula.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":404,"message":"Recurso não encontrado."},"examples":{"Example":{"title":"Example","value":{"code":404,"message":"Recurso não encontrado."}}},"exampleType":"examples"}},"exampleType":"examples"},"8cc4db55-2ced-41f6-8fc5-9511c5fef219":{"description":"Arquivo acima de 15MB. Para arquivos maiores, use o envio por URL assinada (presign + confirmacao).","content":{"application/json":{"schema":{"type":"object","description":"Formato unico de erro da API. Nao faca match exato da mensagem: use o code.","properties":{"code":{"type":"integer","description":"Codigo HTTP.","uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Mensagem em portugues. Em erro de validacao, traz TODAS as falhas concatenadas por virgula.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":413,"message":"File too large"},"examples":{"Example":{"title":"Example","value":{"code":413,"message":"File too large"}}},"exampleType":"examples"}},"exampleType":"examples"},"1229af75-7306-4fd9-a0b4-882648718d9e":{"description":"Falha nossa. Tente de novo; se persistir, acione o suporte com o horario da chamada.","content":{"application/json":{"schema":{"type":"object","description":"Formato unico de erro da API. Nao faca match exato da mensagem: use o code.","properties":{"code":{"type":"integer","description":"Codigo HTTP.","uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Mensagem em portugues. Em erro de validacao, traz TODAS as falhas concatenadas por virgula.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":500,"message":"Internal server error"},"examples":{"Example":{"title":"Example","value":{"code":500,"message":"Internal server error"}}},"exampleType":"examples"}},"exampleType":"examples"},"d910d050-2333-4a37-9eda-35122029ebf5":{"description":"O armazenamento ou o servico de cadastro nao respondeu. Tente de novo.","content":{"application/json":{"schema":{"type":"object","description":"Formato unico de erro da API. Nao faca match exato da mensagem: use o code.","properties":{"code":{"type":"integer","description":"Codigo HTTP.","uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","description":"Mensagem em portugues. Em erro de validacao, traz TODAS as falhas concatenadas por virgula.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":502,"message":"Não foi possível iniciar a validação do documento."},"examples":{"Example":{"title":"Example","value":{"code":502,"message":"Não foi possível iniciar a validação do documento."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"8e2db591-d7cd-4655-90e7-bb0dd0adc598":{"authorization":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Enter JWT token","scopes":[],"schemeName":"authorization"}}},"servers":{"42171238-82dd-4b6d-8980-cce1cc8ba345":{"url":"https://gyra-core.gyramais.com.br","description":"Producao"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Enter JWT token","scopes":[],"schemeName":"authorization"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Enter JWT token","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"authorization","name":"Authorization"}],"title":"authorization"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"gyra","siteName":"GYRA+ Docs","title":"Validar Documento - GYRA+ Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-05T18:52:01.990Z","originalFileLocation":"api-reference/registry/post-registry-validate-document.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Você tem um arquivo e quer o parecer agora.\">\u003cmeta data-mint-head name=\"application-name\" content=\"GYRA+ Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gyra/URB4IAaB0VDk-1wo/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/gyra/URB4IAaB0VDk-1wo/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gyra/URB4IAaB0VDk-1wo/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gyra/URB4IAaB0VDk-1wo/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gyra/URB4IAaB0VDk-1wo/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gyra/URB4IAaB0VDk-1wo/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gyra/URB4IAaB0VDk-1wo/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gyra/URB4IAaB0VDk-1wo/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gyra/URB4IAaB0VDk-1wo/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Validar Documento - GYRA+ Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Você tem um arquivo e quer o parecer agora.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"GYRA+ Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.gyramais.com.br/api-reference/registry/post-registry-validate-document\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gyra.mintlify.site/_mintlify/api/og/v2?division=Documento\u0026amp;title=Validar+Documento\u0026amp;description=Voc%C3%AA+tem+um+arquivo+e+quer+o+parecer+agora.\u0026amp;theme=ea306aa6b40007f2fbe241ee\u0026amp;signature=0b582afe5d34435ee30645f830731a054aae54e110c3b585f047b3dd18b03d6d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Validar Documento - GYRA+ Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Você tem um arquivo e quer o parecer agora.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gyra.mintlify.site/_mintlify/api/og/v2?division=Documento\u0026amp;title=Validar+Documento\u0026amp;description=Voc%C3%AA+tem+um+arquivo+e+quer+o+parecer+agora.\u0026amp;theme=ea306aa6b40007f2fbe241ee\u0026amp;signature=0b582afe5d34435ee30645f830731a054aae54e110c3b585f047b3dd18b03d6d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/gyra/URB4IAaB0VDk-1wo/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"GYRA+ Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1a54fa\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.gyramais.com.br/api-reference/registry/post-registry-validate-document\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/registry/post-registry-validate-document.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.gyramais.com.br/#organization\",\"name\":\"GYRA+ Docs\",\"url\":\"https://developers.gyramais.com.br\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/gyra/e0CFjRCELp2Et0mP/logo/light.png?fit=max\u0026auto=format\u0026n=e0CFjRCELp2Et0mP\u0026q=85\u0026s=07c498e8ad046860d4087e2bb3031959\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.gyramais.com.br#website\",\"name\":\"GYRA+ Docs\",\"url\":\"https://developers.gyramais.com.br\",\"publisher\":{\"@id\":\"https://developers.gyramais.com.br/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.gyramais.com.br/api-reference/registry/post-registry-validate-document#webpage\",\"url\":\"https://developers.gyramais.com.br/api-reference/registry/post-registry-validate-document\",\"name\":\"Validar Documento\",\"description\":\"Você tem um arquivo e quer o parecer agora.\",\"dateModified\":\"2026-10-05T18:52:01.990Z\",\"isPartOf\":{\"@id\":\"https://developers.gyramais.com.br#website\"},\"breadcrumb\":{\"@id\":\"https://developers.gyramais.com.br/api-reference/registry/post-registry-validate-document#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.gyramais.com.br/api-reference/registry/post-registry-validate-document#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API: Onboarding\",\"item\":\"https://developers.gyramais.com.br/api-reference/onboarding/visao-geral\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Validar Documento\",\"item\":\"https://developers.gyramais.com.br/api-reference/registry/post-registry-validate-document\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.gyramais.com.br/api-reference/registry/post-registry-validate-document#apireference\",\"headline\":\"Validar Documento\",\"name\":\"Validar Documento\",\"description\":\"Você tem um arquivo e quer o parecer agora.\",\"url\":\"https://developers.gyramais.com.br/api-reference/registry/post-registry-validate-document\",\"mainEntityOfPage\":{\"@id\":\"https://developers.gyramais.com.br/api-reference/registry/post-registry-validate-document#webpage\"},\"dateModified\":\"2026-10-05T18:52:01.990Z\",\"publisher\":{\"@id\":\"https://developers.gyramais.com.br/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.gyramais.com.br#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"GYRA+ Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"GYRA+ Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/registry/post-registry-validate-document.md","siteName":"GYRA+ Docs","nav":{"global":null,"groups":[{"group":"Primeiros Passos","pages":[{"title":"Introdução","icon":"rocket","href":"/api-reference/introduction"},{"title":"Como Funciona","icon":"chart-network","href":"/api-reference/como-funciona"},{"title":"Chaves de API","icon":"key","href":"/api-reference/api-keys"}]},{"group":"Conceitos Fundamentais","pages":[{"title":"O que é um Relatório","icon":"file-chart-column","href":"/concepts/relatorio"},{"title":"Análise de Crédito","icon":"magnifying-glass-chart","href":"/concepts/analise-de-credito"},{"title":"Política de Crédito","icon":"shield-check","href":"/concepts/politica-de-credito"},{"title":"Templates de Política","icon":"sparkles","href":"/concepts/templates-de-politica"},{"title":"Seções do Relatório","icon":"layout-panel-top","href":"/concepts/secoes"},{"title":"Pareceres GYRA+ IA","icon":"sparkles","href":"/concepts/pareceres-gyra-ia"},{"title":"Comitê de Crédito IA","icon":"users","href":"/concepts/comite-de-credito"},{"title":"Análise Financeira (Balanços e DRE)","icon":"file-invoice-dollar","href":"/concepts/analise-financeira"},{"title":"Arquivos do Relatório","icon":"folder-open","href":"/concepts/arquivos-do-relatorio"},{"title":"Score","icon":"gauge-high","href":"/concepts/score"},{"title":"Decisão Automática","icon":"circle-check","href":"/concepts/decisao-automatica"},{"title":"Precificação","icon":"calculator","href":"/concepts/precificacao"},{"title":"Webhooks e Tempo Real","icon":"webhook","href":"/concepts/webhooks-e-tempo-real"},{"title":"Glossário","icon":"book","href":"/concepts/glossario"}]},{"group":"Onboarding","pages":[{"title":"Onboarding","icon":"folder-open","href":"/onboarding/visao-geral"},{"title":"Cadastro documental","icon":"folder-tree","href":"/onboarding/cadastro-documental"},{"title":"Tipos de documento aceitos","icon":"files","href":"/onboarding/tipos-de-documento"},{"title":"Análise documental","icon":"microscope","href":"/onboarding/analise-documental"},{"title":"Régua de validação","icon":"ruler","href":"/onboarding/regua-de-validacao"},{"title":"Solicitações de coleta","icon":"paper-plane","href":"/onboarding/solicitacoes"},{"title":"Formulários","icon":"rectangle-list","href":"/onboarding/formularios"},{"title":"Formulário público","icon":"globe","href":"/onboarding/formulario-publico"},{"title":"Termos e assinatura","icon":"file-signature","href":"/onboarding/termos-e-assinatura"},{"title":"Verificação de identidade","icon":"user-check","href":"/onboarding/verificacao-de-identidade"},{"title":"Página do destinatário","icon":"link","href":"/onboarding/pagina-do-destinatario"},{"title":"O que é cobrado","icon":"receipt","href":"/onboarding/cobranca"}]},{"group":"Propostas","pages":[{"title":"Propostas","icon":"inbox","href":"/propostas/visao-geral"},{"title":"Produtos e carteiras","icon":"box","href":"/propostas/produtos"},{"title":"Precificação do produto","icon":"calculator","href":"/propostas/precificacao"},{"title":"Pré-aprovação e oferta","icon":"hand-holding-dollar","href":"/propostas/pre-aprovacao-e-oferta"},{"title":"Painel gerencial","icon":"chart-line","href":"/propostas/gerencial"},{"title":"HubSpot","icon":"hubspot","href":"/propostas/hubspot"}]},{"group":"Esteiras","pages":[{"title":"Esteiras","icon":"route","href":"/esteiras/visao-geral"},{"title":"Etapas","icon":"list-ol","href":"/esteiras/etapas"},{"title":"Dados de entrada","icon":"table-list","href":"/esteiras/dados-de-entrada"},{"title":"Camadas e add-ons","icon":"layer-group","href":"/esteiras/camadas-e-add-ons"},{"title":"Chamada de API","icon":"brackets-curly","href":"/esteiras/chamada-de-api"},{"title":"Decisão, alçada e comitê","icon":"gavel","href":"/esteiras/decisao-alcada-e-comite"},{"title":"Execuções","icon":"play","href":"/esteiras/execucoes"}]},{"group":"Formalização","pages":[{"title":"Formalização","icon":"file-contract","href":"/formalizacao/visao-geral"},{"title":"Modelos de contrato","icon":"file-word","href":"/formalizacao/modelos-de-contrato"},{"title":"Variáveis do contrato","icon":"brackets-curly","href":"/formalizacao/variaveis-do-contrato"},{"title":"Partes e assinaturas","icon":"users","href":"/formalizacao/partes-e-assinaturas"},{"title":"Clicksign","icon":"signature","href":"/formalizacao/clicksign"}]},{"group":"BNDES Online","pages":[{"title":"BNDES Online","icon":"building-columns","href":"/bndes-online/visao-geral"}]},{"group":"Plataforma","pages":[{"title":"Módulos e capacidades","icon":"cubes","href":"/plataforma/modulos-e-capacidades"},{"title":"Assistente GYRA+","icon":"sparkles","href":"/plataforma/assistente-gyra"},{"title":"Correspondentes","icon":"handshake","href":"/plataforma/correspondentes"}]},{"group":"Guia do Toolbox","pages":[{"title":"Visão Geral do Toolbox","icon":"compass","href":"/toolbox/visao-geral"},{"title":"Início","icon":"house","href":"/toolbox/inicio"},{"title":"Primeiro Acesso","icon":"door-open","href":"/toolbox/primeiro-acesso"},{"title":"Propostas no toolbox","icon":"table-list","href":"/toolbox/propostas"},{"title":"Produtos no toolbox","icon":"box-open","href":"/toolbox/produtos"},{"title":"Rodar uma Análise","icon":"play","href":"/toolbox/rodar-operacao"},{"title":"Interpretar Resultado do Relatório","icon":"chart-line","href":"/toolbox/interpretar-resultado-operacao"},{"title":"Montar uma esteira","icon":"screwdriver-wrench","href":"/toolbox/montar-esteira"},{"title":"Acompanhar execuções","icon":"list-check","href":"/toolbox/acompanhar-execucoes"},{"title":"Contratos no toolbox","icon":"file-contract","href":"/toolbox/contratos"},{"title":"Clientes no toolbox","icon":"folder-open","href":"/toolbox/cadastros"},{"title":"Solicitações no toolbox","icon":"paper-plane","href":"/toolbox/solicitacoes"},{"title":"Validação de identidade","icon":"id-card","href":"/toolbox/validacao-de-identidade"},{"title":"Criar Política","icon":"wand-magic-sparkles","href":"/toolbox/criar-politica"},{"title":"Editar Política","icon":"pen-to-square","href":"/toolbox/editar-politica"},{"title":"Usar Templates de Política","icon":"sparkles","href":"/toolbox/usar-templates"},{"title":"Integrações no toolbox","icon":"plug","href":"/toolbox/integracoes"},{"title":"Usuários e Permissões","icon":"users-gear","href":"/toolbox/gerenciar-usuarios-permissoes"},{"title":"API \u0026 MCP: chaves e webhooks","icon":"key","href":"/toolbox/webhooks-e-api-keys"}]},{"group":"Fontes de Dados","pages":[{"title":"Visão Geral das Fontes","icon":"layer-group","href":"/sources/visao-geral"},{"title":"Cadastral","icon":"id-card","href":"/sources/cadastral"},{"title":"Bureau de Crédito","icon":"chart-simple","href":"/sources/bureau-credito"},{"title":"Processos Judiciais","icon":"gavel","href":"/sources/processos-judiciais"},{"title":"Protestos","icon":"file-circle-exclamation","href":"/sources/protestos"},{"title":"PEFIN e REFIN","icon":"circle-exclamation","href":"/sources/pefin-refin"},{"title":"SCR e Open Finance","icon":"building-columns","href":"/sources/scr-open-finance"},{"title":"PEP e Sanções","icon":"shield-halved","href":"/sources/pep-sancoes"},{"title":"Vínculos Societários","icon":"diagram-project","href":"/sources/vinculos-societarios"},{"title":"Contatos e Localização","icon":"address-book","href":"/sources/contatos"},{"title":"Financeira","icon":"sack-dollar","href":"/sources/financeira"},{"title":"Inteligência de Pagamentos (Núclea)","icon":"money-bill-transfer","href":"/sources/inteligencia-pagamentos"},{"title":"Certidões","icon":"stamp","href":"/sources/certidoes"},{"title":"Mídia e Reputação","icon":"newspaper","href":"/sources/midia-reputacao"},{"title":"Benefícios Sociais","icon":"hand-holding-heart","href":"/sources/beneficios-sociais"}]},{"group":"Guias","pages":[{"title":"Seu primeiro relatório em 5 minutos","icon":"rocket","href":"/guides/primeiro-relatorio"},{"title":"Integrar o Onboarding","icon":"route","href":"/guides/integrar-cadastro-documental"},{"title":"Configurar Webhook","icon":"webhook","href":"/guides/configurar-webhook"},{"title":"Interpretar uma Decisão de Crédito","icon":"magnifying-glass-chart","href":"/guides/interpretar-decisao"},{"title":"Criar uma Política de Crédito","icon":"sliders","href":"/guides/criar-politica-personalizada"}]},{"group":"Casos de Uso","pages":[{"title":"Fintech de Crédito","icon":"credit-card","href":"/use-cases/fintech-credito"},{"title":"Distribuidora e Crédito B2B","icon":"truck","href":"/use-cases/distribuidora-b2b"},{"title":"Fundo de Crédito e Factoring","icon":"building-columns","href":"/use-cases/fundo-e-factoring"}]},{"group":"MCP Server","pages":[{"title":"O que é o MCP da GYRA+","icon":"plug","href":"/mcp/o-que-e"},{"title":"Instalação do MCP","icon":"download","href":"/mcp/instalacao"},{"title":"Ferramentas Disponíveis","icon":"toolbox","href":"/mcp/ferramentas-disponiveis"},{"title":"Casos de Uso com MCP","icon":"lightbulb","href":"/mcp/casos-de-uso"},{"title":"Troubleshooting MCP","icon":"screwdriver-wrench","href":"/mcp/troubleshooting"}]},{"group":"Referência da API","pages":[{"title":"Gerar Token","openapi":"post /auth/authenticate","href":"/api-reference/auth/post-authauthenticate"},{"title":"Criar Relatório (v2)","openapi":"post /v2/report","href":"/api-reference/report-v2/post-v2report"},{"title":"Consultar Relatório (v2)","openapi":"get /v2/report/{id}","href":"/api-reference/report-v2/get-v2report"},{"title":"Enviar Balanço e DRE","openapi":"post /report/{id}/financial-tab","href":"/api-reference/report/post-report-financial-tab"},{"title":"Enviar Balanço e DRE por upload direto","href":"/api-reference/report/post-report-financial-tab-presign"},{"title":"Consulta Lista de Relatórios","openapi":"get /report/list","href":"/api-reference/report/get-reportlist"},{"title":"Consultar Seção por ID","openapi":"get /report/section/{id}","href":"/api-reference/report/get-reportsection"},{"title":"Consultar Seção por Tipo","openapi":"get /report/{id}/section/{sectionType}","href":"/api-reference/report/get-report-section"},{"title":"Reprocessar seção com falha","href":"/api-reference/report/post-report-section-retry"},{"title":"Consultar Pareceres do Relatório","openapi":"get /report/{id}/insights","href":"/api-reference/report/get-reportinsights"},{"title":"Convocar Comitê de Crédito IA","openapi":"post /report/{id}/committee","href":"/api-reference/report/post-reportcommittee"},{"title":"Consultar Deliberação do Comitê","openapi":"get /committee/deliberations/{reportId}","href":"/api-reference/committee/get-committeedeliberations"},{"title":"Analisar Relatório Manualmente","openapi":"post /report/analyze","href":"/api-reference/report/post-reportanalyze"},{"title":"Refazer Análise Manual","openapi":"post /report/re-analyze","href":"/api-reference/report/post-reportre-analyze"},{"title":"Exportar Relatório (Assíncrono)","openapi":"get /report/export/{id}","href":"/api-reference/report/get-reportexport"},{"title":"Exportar Relatório (Síncrono)","openapi":"get /report/export-sync/{id}","href":"/api-reference/report/get-reportexport-sync"},{"title":"Consultar políticas de decisão","openapi":"get /credit-policy/policy","href":"/api-reference/credit-policypolicy/get-credit-policypolicy"},{"title":"Criar Webhook","openapi":"post /webhook","href":"/api-reference/webhook/post-webhook"},{"title":"Consultar Webhook","openapi":"get /webhook/findBy","href":"/api-reference/webhook/get-webhookfindby"},{"title":"Remover Webhook","openapi":"delete /webhook/{id}","href":"/api-reference/webhook/delete-webhook"}]},{"group":"API: Onboarding","pages":[{"title":"Visão geral da API","description":"Endereço, autenticação, versionamento, capacidades e erros das rotas do Onboarding. Leia uma vez, vale para todas.","href":"/api-reference/onboarding/visao-geral"},{"group":"Documento","pages":[{"title":"Validar Documento","openapi":"post /v1/registry/validate-document","href":"/api-reference/registry/post-registry-validate-document"},{"title":"Status do Documento","description":"O envio respondeu `202` e você precisa acompanhar.","openapi":"get /v1/registry/documents/{docId}/status","href":"/api-reference/registry/get-registry-documents-docid-status"},{"title":"Preparar Upload de Documento","openapi":"post /v1/registry/{id}/documents/presign","href":"/api-reference/registry/post-registry-id-documents-presign"},{"title":"Confirmar Upload e Analisar","openapi":"post /v1/registry/{id}/documents","href":"/api-reference/registry/post-registry-id-documents"},{"title":"Resultado do Documento","openapi":"get /v1/registry/{id}/documents/{docId}/result","href":"/api-reference/registry/get-registry-id-documents-docid-result"},{"title":"Reprocessar Documento","openapi":"post /v1/registry/{id}/documents/{docId}/reprocess","href":"/api-reference/registry/post-registry-id-documents-docid-reprocess"}]},{"group":"Cadastro","pages":[{"title":"Criar Cadastro","openapi":"post /v1/registry","href":"/api-reference/registry/post-registry"},{"title":"Listar Cadastros","openapi":"get /v1/registry","href":"/api-reference/registry/get-registry"},{"title":"Consultar Cadastro","openapi":"get /v1/registry/{id}","href":"/api-reference/registry/get-registry-id"},{"title":"Consultar Cadastro por CNPJ ou CPF","openapi":"get /v1/registry/by-document/{document}","href":"/api-reference/registry/get-registry-by-document-document"},{"title":"Listar Documentos do Cadastro","openapi":"get /v1/registry/{id}/documents","href":"/api-reference/registry/get-registry-id-documents"},{"title":"Árvore Societária","openapi":"get /v1/registry/{id}/persons","href":"/api-reference/registry/get-registry-id-persons"},{"title":"Pessoas, contatos e dados declarados","href":"/api-reference/onboarding/pessoas-e-contatos"}]},{"group":"Solicitação","pages":[{"title":"Listar Modelos de Coleta","openapi":"get /v1/collection-templates","href":"/api-reference/collection/get-collection-templates"},{"title":"Criar Solicitação","openapi":"post /v1/collections","href":"/api-reference/collection/post-collections"},{"title":"Listar Solicitações","openapi":"get /v1/collections","href":"/api-reference/collection/get-collections"},{"title":"Consultar Solicitação","openapi":"get /v1/collections/{id}","href":"/api-reference/collection/get-collections-id"},{"title":"Enviar Solicitação","openapi":"post /v1/collections/{id}/send","href":"/api-reference/collection/post-collections-id-send"},{"title":"Cancelar Solicitação","openapi":"post /v1/collections/{id}/cancel","href":"/api-reference/collection/post-collections-id-cancel"},{"title":"Revisar Item","openapi":"post /v1/collections/{id}/items/{itemId}/review","href":"/api-reference/collection/post-collections-id-items-itemid-review"},{"title":"Baixar a via assinada","href":"/api-reference/onboarding/via-assinada"}]},{"group":"Webhook","pages":[{"title":"Catálogo de Eventos","openapi":"get /v1/webhook/events","href":"/api-reference/collection/get-webhook-events"},{"title":"Listar Assinaturas de Webhook","openapi":"get /v1/webhook/endpoints","href":"/api-reference/collection/get-webhook-endpoints"},{"title":"Criar ou Atualizar Assinatura","openapi":"post /v1/webhook/endpoints","href":"/api-reference/collection/post-webhook-endpoints"}]},{"title":"Formatos de retorno por documento","icon":"table-list","href":"/api-reference/onboarding/formatos-de-retorno"},{"title":"Eventos de webhook","icon":"bolt-lightning","href":"/api-reference/onboarding/eventos-de-webhook"}]},{"group":"API: Propostas e Esteiras","pages":[{"title":"Visão geral da API de Propostas","icon":"file-invoice-dollar","href":"/api-reference/propostas/visao-geral"},{"title":"Propostas","icon":"file-lines","href":"/api-reference/propostas/propostas"},{"title":"Ofertas","icon":"hand-holding-dollar","href":"/api-reference/propostas/ofertas"},{"title":"Produtos e precificação","icon":"calculator","href":"/api-reference/propostas/produtos-e-precificacao"},{"title":"Indicadores gerenciais","icon":"chart-line","href":"/api-reference/propostas/gerencial"},{"title":"Dados de entrada","icon":"table-list","href":"/api-reference/propostas/dados-de-entrada"},{"title":"Fechamento externo","icon":"flag-checkered","href":"/api-reference/esteiras/fechamento-externo"}]},{"group":"Dicionário de Dados","pages":[{"title":"Estrutura do Relatório","icon":"database","href":"/data/estrutura-relatorio"},{"title":"Seção, Resumo (SUMMARY)","icon":"chart-bar","href":"/data/secao-resumo"},{"title":"Seção, Informações Básicas (BASIC_INFORMATION)","icon":"address-card","href":"/data/secao-informacoes-basicas"},{"title":"Seção, Processos Judiciais (PROCESSES)","icon":"gavel","href":"/data/secao-processos"},{"title":"Seção, Protestos (PROTESTS)","icon":"stamp","href":"/data/secao-protestos"},{"title":"Seção, PEFIN e REFIN","icon":"triangle-exclamation","href":"/data/secao-pefin-refin"},{"title":"Seção, SCR (Banco Central)","icon":"chart-line","href":"/data/secao-scr"},{"title":"Seção, PEP e Sanções","icon":"landmark","href":"/data/secao-pep-sancoes"},{"title":"Seção, Política de Crédito (CREDIT_POLICY)","icon":"shield-check","href":"/data/secao-politica-credito"}]},{"group":"Integrações","pages":[{"title":"Collections para Postman e Insomnia","icon":"flask-vial","href":"/docs/postman-insomnia"},{"title":"Integração com n8n","icon":"diagram-project","href":"/docs/integracao-n8n"},{"title":"Políticas de Decisão e Tipos de Relatório","icon":"files","href":"/docs/tipos-relatorios"},{"title":"Dados Entregues","icon":"database","href":"/docs/dados-entregues"}]},{"group":"Referência","pages":[{"title":"Referência de Erros","icon":"circle-exclamation","href":"/reference/erros"},{"title":"Changelog","icon":"clock-rotate-left","href":"/reference/changelog"}]}]},"basePath":"","title":"Validar Documento - GYRA+ Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}