Como rodar uma análise de crédito no toolbox pelo input sempre visível, individualmente ou em lote, por política ou esteira.
Resumo: toda análise começa pelo input sempre visível no topo do toolbox. Você digita o CPF ou CNPJ, o sistema identifica o tipo de documento, abre o dropdown com as políticas e as esteiras ativas e, ao apertar Enter, dispara o processamento. Em segundos o relatório está na tela. Para vários documentos, use o + do input e crie um lote.
O input sempre visível
No topo de todas as telas do toolbox fica o campo de análise. Ele é o ponto de entrada para qualquer consulta. O fluxo direto é:
1
Digitar o documento
CPF (11 dígitos) ou CNPJ (14 dígitos). O toolbox identifica o tipo automaticamente, valida o dígito verificador e filtra a lista de políticas compatíveis. Documento inválido é sinalizado antes de você poder prosseguir.
2
Escolher a política no dropdown
Logo abaixo do input abre um dropdown com as políticas e as esteiras ativas para o tipo de documento digitado, em dois grupos: Esteiras e Políticas. Se você marcou uma padrão (chave Definir como padrão, logo abaixo do dropdown), ela já vem pré-selecionada.Escolher uma esteira abre uma execução dela para o documento. Para acompanhar as etapas seguintes, veja Acompanhar execuções.
3
Apertar Enter
Dispara o processamento e redireciona você direto para a tela do relatório. Não há outro clique. Ctrl ou Cmd + Enter abre o relatório em nova guia.
4
Acompanhar o processamento
A análise passa pelos estados:
PROCESSING, coleta de dados em andamento.
EVALUATING, política rodando sobre os dados coletados.
COMPLETED, resultado disponível.
Tempo típico: 5 a 30 segundos, conforme as fontes consultadas.
5
Ler o resultado
Ao terminar, aparece status (APPROVED, ALERT, DENIED, ERROR), breakdown por regra e precificação, se houver. Guia em Interpretar Resultado do Relatório.
Se ao digitar o documento o dropdown vem vazio, é porque nenhuma política nem esteira compatível está ativa para aquele tipo. O gestor precisa ativar um template antes. Ver Usar Templates.
Para CNPJ, você pode anexar o PDF do balanço no próprio input (Adicionar PDF de balanço (opcional)), antes de disparar a análise. O relatório já nasce com a extração financeira em processamento. Também dá para enviar depois, pela gaveta Arquivos do relatório, em Enviar balanço / DRE. Detalhes em Análise Financeira.
Análise em lote
Para analisar vários documentos de uma vez, não precisa planilha nem upload de arquivo. Tudo começa pelo mesmo input:
1
Clicar no + do input
No canto do input sempre visível há o botão + (Lote de relatórios). Ele abre a janela Novo lote de relatórios.
2
Colar ou digitar os documentos
Copie uma coluna de CNPJs/CPFs de uma planilha, lista ou e-mail e cole na caixa. Também aceita digitação direta. O toolbox faz a checagem em tempo real: conta os documentos válidos, remove repetidos e lista os inválidos, que serão ignorados. Todos os documentos do lote precisam ser do mesmo tipo (CPF ou CNPJ). O limite recomendado é de 5.000 documentos por lote.
3
Nomear o lote e escolher a política
Clique em Próximo. Dê um nome reconhecível ao lote (ex: Revisão carteira Abril 2026) e selecione a política que vale para todos os documentos. Só aparecem políticas compatíveis com o tipo dos documentos.
4
Escolher quando rodar
Clique em Próximo de novo e escolha a frequência: Uma vez (entra no próximo ciclo de processamento, assim que criado), Diário, Semanal ou Mensal. Nos recorrentes, você escolhe os dias (no semanal e no mensal) e a janela de execução, e o lote roda até ser pausado.
5
Criar lote
Clique em Criar lote. O processamento roda em segundo plano, em paralelo, e o lote aparece em Análises de crédito, aba Em lote.
6
Acompanhar e baixar
Ao terminar, o lote entrega:
Um arquivo XLS com as principais informações agrupadas de cada documento (status, score, motivos, precificação).
O XLS fica disponível para download na aba Em lote.
Cada relatório individual também é acessível na plataforma pelo link no próprio XLS ou pela listagem do lote.
O XLS consolidado é o formato pensado para gestor de carteira ou analista revisar um grande volume rapidamente. Para investigar um caso específico, abra o relatório individual.
Resposta: objeto Report com id, que você pode consultar por polling ou receber via webhook. Referência em POST /v2/report.
Reanálise
A reanálise existe para casos em que um relatório foi gerado com dados incompletos ou com erro em alguma fonte, e ainda não fechou com decisão final (APPROVED ou DENIED).Como funciona:
Ao gerar o relatório novamente para o mesmo documento (pelo input ou pela API), o relatório existente é reprocessado caso ainda não esteja APPROVED ou DENIED. Os dados que estavam com erro ou parciais podem então ser revistos.
Se o relatório já fechou com status final (APPROVED ou DENIED), ele não é atualizado: uma nova chamada gera um relatório distinto.
Não há um botão “Reanalisar” no toolbox. A reanálise acontece automaticamente ao se solicitar uma nova análise para o mesmo documento, dentro das condições acima.
Limitações e considerações
Documento inválido é bloqueado antes do envio.
Dropdown vazio significa que não há política nem esteira ativa para o tipo, gestor precisa habilitar.
Fontes indisponíveis no momento da consulta podem gerar ERROR. O relatório mostra qual fonte falhou; basta reanalisar depois.
Concorrência do lote é paralelizada, mas lotes muito grandes podem ser enfileirados conforme o contrato.
Perguntas frequentes
Por que o dropdown aparece vazio quando digito o documento?
Porque nenhuma política nem esteira compatível com o tipo de documento (PF ou PJ) está ativa para a sua organização. O administrador ou gestor precisa ativar pelo menos um template em Motor de crédito, Políticas, aba Templates. Ver Usar Templates.
Qual a diferença entre política e esteira no dropdown?
Política é um conjunto de regras que roda sobre um documento e devolve um relatório com a decisão. Esteira é um fluxo com etapas (camadas de análise, documentos do cliente, alçada, contrato) que usa políticas no caminho; ver Esteiras.
Como defino uma política padrão?
Escolha a política (ou esteira) no dropdown que abre ao digitar o documento e ligue a chave Definir como padrão, logo abaixo. Vale uma padrão por tipo de documento (CPF e CNPJ).
Posso rodar o mesmo documento duas vezes?
Pode. Se o relatório anterior ainda não fechou com APPROVED ou DENIED, ele é reprocessado (reanálise). Se já fechou, uma nova chamada gera um relatório distinto.
Análise fica em PROCESSING há muito tempo, o que fazer?
Mais de 2 minutos em PROCESSING é sinal de fonte lenta ou falha temporária. Aguarde 1 minuto a mais e, se continuar, rode de novo. Se o padrão se repetir, fale com o suporte.
Relatório consome contrato mesmo quando dá ERROR?
Análises que terminam em ERROR antes da avaliação da política não contam. As que chegaram a rodar a política, mesmo com fonte parcial, contam normalmente.
Próximos passos
Interpretar resultado
Status, breakdown por regra, precificação.
Acompanhar execuções
Seguir uma esteira etapa por etapa.
Webhooks
Receber o resultado em tempo real no seu backend.
API de relatório
Integração direta via HTTP.
{"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.4143","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":"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":"llms-txt-v2","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":"toolbox/rodar-operacao","slug":"/toolbox/rodar-operacao","pageMetadata":{"title":"Rodar uma Análise","description":"Como rodar uma análise de crédito no toolbox pelo input sempre visível, individualmente ou em lote, por política ou esteira.","icon":"play","surface":"plataforma","domain":"relatorio","audience":"operador","lang":"nao-tecnica","href":"/toolbox/rodar-operacao"},"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: \"Como rodar uma análise de crédito no toolbox pelo input sempre visível, individualmente ou em lote, por política ou esteira.\"\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`,em:`em`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CardGroup,CodeBlock,Heading,Info,Note,Step,Steps,Tip}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Resumo:`}),` toda análise começa pelo `,_jsx(_components.strong,{children:`input sempre visível`}),` no topo do toolbox. Você digita o CPF ou CNPJ, o sistema identifica o tipo de documento, abre o dropdown com as políticas e as `,_jsx(_components.a,{href:`/esteiras/visao-geral`,children:`esteiras`}),` ativas e, ao apertar Enter, dispara o processamento. Em segundos o relatório está na tela. Para vários documentos, use o `,_jsx(_components.strong,{children:`+`}),` do input e crie um lote.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`o-input-sempre-visível`,children:`O input sempre visível`}),`\n`,_jsx(_components.p,{children:`No topo de todas as telas do toolbox fica o campo de análise. Ele é o ponto de entrada para qualquer consulta. O fluxo direto é:`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Digitar o documento`,children:_jsx(_components.p,{children:`CPF (11 dígitos) ou CNPJ (14 dígitos). O toolbox identifica o tipo automaticamente, valida o dígito verificador e filtra a lista de políticas compatíveis. Documento inválido é sinalizado antes de você poder prosseguir.`})}),_jsxs(Step,{title:`Escolher a política no dropdown`,children:[_jsxs(_components.p,{children:[`Logo abaixo do input abre um dropdown com as políticas e as esteiras ativas para o tipo de documento digitado, em dois grupos: `,_jsx(_components.strong,{children:`Esteiras`}),` e `,_jsx(_components.strong,{children:`Políticas`}),`. Se você marcou uma padrão (chave `,_jsx(_components.strong,{children:`Definir como padrão`}),`, logo abaixo do dropdown), ela já vem pré-selecionada.`]}),_jsxs(_components.p,{children:[`Escolher uma esteira abre uma execução dela para o documento. Para acompanhar as etapas seguintes, veja `,_jsx(_components.a,{href:`/toolbox/acompanhar-execucoes`,children:`Acompanhar execuções`}),`.`]})]}),_jsx(Step,{title:`Apertar Enter`,children:_jsxs(_components.p,{children:[`Dispara o processamento e redireciona você direto para a tela do relatório. Não há outro clique. `,_jsx(_components.strong,{children:`Ctrl`}),` ou `,_jsx(_components.strong,{children:`Cmd`}),` + `,_jsx(_components.strong,{children:`Enter`}),` abre o relatório em nova guia.`]})}),_jsxs(Step,{title:`Acompanhar o processamento`,children:[_jsx(_components.p,{children:`A análise passa pelos estados:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`PROCESSING`}),`, coleta de dados em andamento.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`EVALUATING`}),`, política rodando sobre os dados coletados.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`COMPLETED`}),`, resultado disponível.`]}),`\n`]}),_jsx(_components.p,{children:`Tempo típico: 5 a 30 segundos, conforme as fontes consultadas.`})]}),_jsx(Step,{title:`Ler o resultado`,children:_jsxs(_components.p,{children:[`Ao terminar, aparece status (`,_jsx(_components.code,{children:`APPROVED`}),`, `,_jsx(_components.code,{children:`ALERT`}),`, `,_jsx(_components.code,{children:`DENIED`}),`, `,_jsx(_components.code,{children:`ERROR`}),`), breakdown por regra e precificação, se houver. Guia em `,_jsx(_components.a,{href:`/toolbox/interpretar-resultado-operacao`,children:`Interpretar Resultado do Relatório`}),`.`]})})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Se ao digitar o documento o dropdown vem vazio, é porque `,_jsx(_components.strong,{children:`nenhuma política nem esteira compatível está ativa`}),` para aquele tipo. O gestor precisa ativar um template antes. Ver `,_jsx(_components.a,{href:`/toolbox/usar-templates`,children:`Usar Templates`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Para CNPJ, você pode `,_jsx(_components.strong,{children:`anexar o PDF do balanço`}),` no próprio input (`,_jsx(_components.strong,{children:`Adicionar PDF de balanço (opcional)`}),`), antes de disparar a análise. O relatório já nasce com a extração financeira em processamento. Também dá para enviar depois, pela gaveta `,_jsx(_components.strong,{children:`Arquivos`}),` do relatório, em `,_jsx(_components.strong,{children:`Enviar balanço / DRE`}),`. Detalhes em `,_jsx(_components.a,{href:`/concepts/analise-financeira`,children:`Análise Financeira`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`análise-em-lote`,children:`Análise em lote`}),`\n`,_jsx(_components.p,{children:`Para analisar vários documentos de uma vez, não precisa planilha nem upload de arquivo. Tudo começa pelo mesmo input:`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Clicar no + do input`,children:_jsxs(_components.p,{children:[`No canto do input sempre visível há o botão `,_jsx(_components.strong,{children:`+`}),` (`,_jsx(_components.strong,{children:`Lote de relatórios`}),`). Ele abre a janela `,_jsx(_components.strong,{children:`Novo lote de relatórios`}),`.`]})}),_jsx(Step,{title:`Colar ou digitar os documentos`,children:_jsxs(_components.p,{children:[`Copie uma coluna de CNPJs/CPFs de uma planilha, lista ou e-mail e cole na caixa. Também aceita digitação direta. O toolbox faz a `,_jsx(_components.strong,{children:`checagem em tempo real`}),`: conta os documentos válidos, remove repetidos e lista os inválidos, que serão ignorados. Todos os documentos do lote precisam ser do mesmo tipo (CPF ou CNPJ). O limite recomendado é de 5.000 documentos por lote.`]})}),_jsx(Step,{title:`Nomear o lote e escolher a política`,children:_jsxs(_components.p,{children:[`Clique em `,_jsx(_components.strong,{children:`Próximo`}),`. Dê um nome reconhecível ao lote (ex: `,_jsx(_components.em,{children:`Revisão carteira Abril 2026`}),`) e selecione a política que vale para todos os documentos. Só aparecem políticas compatíveis com o tipo dos documentos.`]})}),_jsx(Step,{title:`Escolher quando rodar`,children:_jsxs(_components.p,{children:[`Clique em `,_jsx(_components.strong,{children:`Próximo`}),` de novo e escolha a frequência: `,_jsx(_components.strong,{children:`Uma vez`}),` (entra no próximo ciclo de processamento, assim que criado), `,_jsx(_components.strong,{children:`Diário`}),`, `,_jsx(_components.strong,{children:`Semanal`}),` ou `,_jsx(_components.strong,{children:`Mensal`}),`. Nos recorrentes, você escolhe os dias (no semanal e no mensal) e a janela de execução, e o lote roda até ser pausado.`]})}),_jsx(Step,{title:`Criar lote`,children:_jsxs(_components.p,{children:[`Clique em `,_jsx(_components.strong,{children:`Criar lote`}),`. O processamento roda em segundo plano, em paralelo, e o lote aparece em `,_jsx(_components.strong,{children:`Análises de crédito`}),`, aba `,_jsx(_components.strong,{children:`Em lote`}),`.`]})}),_jsxs(Step,{title:`Acompanhar e baixar`,children:[_jsx(_components.p,{children:`Ao terminar, o lote entrega:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Um `,_jsx(_components.strong,{children:`arquivo XLS`}),` com as principais informações agrupadas de cada documento (status, score, motivos, precificação).`]}),`\n`,_jsxs(_components.li,{children:[`O XLS fica disponível para download na aba `,_jsx(_components.strong,{children:`Em lote`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Cada `,_jsx(_components.strong,{children:`relatório individual`}),` também é acessível na plataforma pelo link no próprio XLS ou pela listagem do lote.`]}),`\n`]})]})]}),`\n`,_jsx(Info,{children:_jsx(_components.p,{children:`O XLS consolidado é o formato pensado para gestor de carteira ou analista revisar um grande volume rapidamente. Para investigar um caso específico, abra o relatório individual.`})}),`\n`,_jsx(Heading,{level:`2`,id:`via-api`,children:`Via API`}),`\n`,_jsx(_components.p,{children:`O fluxo equivalente por integração direta:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` /v2/report`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Bearer`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`access_toke`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`n`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`Content-Type:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` application/json`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` \"document\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"43591367000130\",`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` \"policyId\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"6612a7f30000000000000001\",`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` \"amount\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 100000`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Resposta: objeto `,_jsx(_components.code,{children:`Report`}),` com id, que você pode consultar por polling ou receber via `,_jsx(_components.a,{href:`/concepts/webhooks-e-tempo-real`,children:`webhook`}),`. Referência em `,_jsx(_components.a,{href:`/api-reference/report-v2/post-v2report`,children:`POST /v2/report`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`reanálise`,children:`Reanálise`}),`\n`,_jsxs(_components.p,{children:[`A reanálise existe para casos em que um relatório foi gerado com `,_jsx(_components.strong,{children:`dados incompletos ou com erro`}),` em alguma fonte, e ainda `,_jsx(_components.strong,{children:`não fechou`}),` com decisão final (`,_jsx(_components.code,{children:`APPROVED`}),` ou `,_jsx(_components.code,{children:`DENIED`}),`).`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Como funciona:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Ao gerar o relatório novamente para o mesmo documento (pelo input ou pela API), o relatório existente é `,_jsx(_components.strong,{children:`reprocessado`}),` caso ainda `,_jsxs(_components.strong,{children:[`não esteja `,_jsx(_components.code,{children:`APPROVED`}),` ou `,_jsx(_components.code,{children:`DENIED`})]}),`. Os dados que estavam com erro ou parciais podem então ser revistos.`]}),`\n`,_jsxs(_components.li,{children:[`Se o relatório já fechou com status final (`,_jsx(_components.code,{children:`APPROVED`}),` ou `,_jsx(_components.code,{children:`DENIED`}),`), ele `,_jsx(_components.strong,{children:`não é atualizado`}),`: uma nova chamada gera um relatório distinto.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Não há um botão “Reanalisar” no toolbox. A reanálise acontece automaticamente ao se solicitar uma nova análise para o mesmo documento, dentro das condições acima.`})}),`\n`,_jsx(Heading,{level:`2`,id:`limitações-e-considerações`,children:`Limitações e considerações`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Documento inválido`}),` é bloqueado antes do envio.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Dropdown vazio`}),` significa que não há política nem esteira ativa para o tipo, gestor precisa habilitar.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Fontes indisponíveis`}),` no momento da consulta podem gerar `,_jsx(_components.code,{children:`ERROR`}),`. O relatório mostra qual fonte falhou; basta reanalisar depois.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Concorrência do lote`}),` é paralelizada, mas lotes muito grandes podem ser enfileirados conforme o contrato.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`perguntas-frequentes`,children:`Perguntas frequentes`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Por que o dropdown aparece vazio quando digito o documento?`,id:`por-que-o-dropdown-aparece-vazio-quando-digito-o-documento`,children:_jsxs(_components.p,{children:[`Porque nenhuma política nem esteira compatível com o tipo de documento (PF ou PJ) está ativa para a sua organização. O administrador ou gestor precisa ativar pelo menos um template em `,_jsx(_components.strong,{children:`Motor de crédito`}),`, `,_jsx(_components.strong,{children:`Políticas`}),`, aba `,_jsx(_components.strong,{children:`Templates`}),`. Ver `,_jsx(_components.a,{href:`/toolbox/usar-templates`,children:`Usar Templates`}),`.`]})}),_jsx(Accordion,{title:`Qual a diferença entre política e esteira no dropdown?`,id:`qual-a-diferenca-entre-politica-e-esteira-no-dropdown`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Política`}),` é um conjunto de regras que roda sobre um documento e devolve um relatório com a decisão. `,_jsx(_components.strong,{children:`Esteira`}),` é um fluxo com etapas (camadas de análise, documentos do cliente, alçada, contrato) que usa políticas no caminho; ver `,_jsx(_components.a,{href:`/esteiras/visao-geral`,children:`Esteiras`}),`.`]})}),_jsx(Accordion,{title:`Como defino uma política padrão?`,id:`como-defino-uma-politica-padrao`,children:_jsxs(_components.p,{children:[`Escolha a política (ou esteira) no dropdown que abre ao digitar o documento e ligue a chave `,_jsx(_components.strong,{children:`Definir como padrão`}),`, logo abaixo. Vale uma padrão por tipo de documento (CPF e CNPJ).`]})}),_jsx(Accordion,{title:`Posso rodar o mesmo documento duas vezes?`,id:`posso-rodar-o-mesmo-documento-duas-vezes`,children:_jsxs(_components.p,{children:[`Pode. Se o relatório anterior ainda não fechou com `,_jsx(_components.code,{children:`APPROVED`}),` ou `,_jsx(_components.code,{children:`DENIED`}),`, ele é `,_jsx(_components.strong,{children:`reprocessado`}),` (reanálise). Se já fechou, uma nova chamada gera um relatório distinto.`]})}),_jsx(Accordion,{title:`Análise fica em PROCESSING há muito tempo, o que fazer?`,id:`analise-fica-em-processing-ha-muito-tempo-o-que-fazer`,children:_jsxs(_components.p,{children:[`Mais de 2 minutos em `,_jsx(_components.code,{children:`PROCESSING`}),` é sinal de fonte lenta ou falha temporária. Aguarde 1 minuto a mais e, se continuar, rode de novo. Se o padrão se repetir, fale com o suporte.`]})}),_jsx(Accordion,{title:`Relatório consome contrato mesmo quando dá ERROR?`,id:`relatorio-consome-contrato-mesmo-quando-da-error`,children:_jsxs(_components.p,{children:[`Análises que terminam em `,_jsx(_components.code,{children:`ERROR`}),` antes da avaliação da política não contam. As que chegaram a rodar a política, mesmo com fonte parcial, contam normalmente.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`próximos-passos`,children:`Próximos passos`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Interpretar resultado`,icon:`chart-line`,href:`/toolbox/interpretar-resultado-operacao`,children:_jsx(_components.p,{children:`Status, breakdown por regra, precificação.`})}),_jsx(Card,{title:`Acompanhar execuções`,icon:`diagram-project`,href:`/toolbox/acompanhar-execucoes`,children:_jsx(_components.p,{children:`Seguir uma esteira etapa por etapa.`})}),_jsx(Card,{title:`Webhooks`,icon:`webhook`,href:`/concepts/webhooks-e-tempo-real`,children:_jsx(_components.p,{children:`Receber o resultado em tempo real no seu backend.`})}),_jsx(Card,{title:`API de relatório`,icon:`code`,href:`/api-reference/report-v2/post-v2report`,children:_jsx(_components.p,{children:`Integração direta via HTTP.`})})]})]})}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":"Rodar uma Análise","description":"Como rodar uma análise de crédito no toolbox pelo input sempre visível, individualmente ou em lote, por política ou esteira.","icon":"play","surface":"plataforma","domain":"relatorio","audience":"operador","lang":"nao-tecnica","href":"/toolbox/rodar-operacao"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"O input sempre visível","slug":"o-input-sempre-visível","depth":2,"children":[]},{"title":"Análise em lote","slug":"análise-em-lote","depth":2,"children":[]},{"title":"Via API","slug":"via-api","depth":2,"children":[]},{"title":"Reanálise","slug":"reanálise","depth":2,"children":[]},{"title":"Limitações e considerações","slug":"limitações-e-considerações","depth":2,"children":[]},{"title":"Perguntas frequentes","slug":"perguntas-frequentes","depth":2,"children":[]},{"title":"Próximos passos","slug":"próximos-passos","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"gyra","siteName":"GYRA+ Docs","title":"Rodar uma Análise - GYRA+ Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-05T18:51:56.485Z","originalFileLocation":"toolbox/rodar-operacao.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=\"Como rodar uma análise de crédito no toolbox pelo input sempre visível, individualmente ou em lote, por política ou esteira.\">\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=\"Rodar uma Análise - GYRA+ Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Como rodar uma análise de crédito no toolbox pelo input sempre visível, individualmente ou em lote, por política ou esteira.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"GYRA+ Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.gyramais.com.br/toolbox/rodar-operacao\">\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=Guia+do+Toolbox\u0026amp;title=Rodar+uma+An%C3%A1lise\u0026amp;description=Como+rodar+uma+an%C3%A1lise+de+cr%C3%A9dito+no+toolbox+pelo+input+sempre+vis%C3%ADvel%2C+individualmente+ou+em+lote%2C+por+pol%C3%ADtica+ou+esteira.\u0026amp;theme=ea306aa6b40007f2fbe241ee\u0026amp;signature=78eb292c2b04b979a9ad29e48338afd3f988322fcfb49efbca3c017d027188f0\">\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=\"Rodar uma Análise - GYRA+ Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Como rodar uma análise de crédito no toolbox pelo input sempre visível, individualmente ou em lote, por política ou esteira.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gyra.mintlify.site/_mintlify/api/og/v2?division=Guia+do+Toolbox\u0026amp;title=Rodar+uma+An%C3%A1lise\u0026amp;description=Como+rodar+uma+an%C3%A1lise+de+cr%C3%A9dito+no+toolbox+pelo+input+sempre+vis%C3%ADvel%2C+individualmente+ou+em+lote%2C+por+pol%C3%ADtica+ou+esteira.\u0026amp;theme=ea306aa6b40007f2fbe241ee\u0026amp;signature=78eb292c2b04b979a9ad29e48338afd3f988322fcfb49efbca3c017d027188f0\">\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/toolbox/rodar-operacao\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/toolbox/rodar-operacao.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/toolbox/rodar-operacao#webpage\",\"url\":\"https://developers.gyramais.com.br/toolbox/rodar-operacao\",\"name\":\"Rodar uma Análise\",\"description\":\"Como rodar uma análise de crédito no toolbox pelo input sempre visível, individualmente ou em lote, por política ou esteira.\",\"dateModified\":\"2026-10-05T18:51:56.485Z\",\"isPartOf\":{\"@id\":\"https://developers.gyramais.com.br#website\"},\"breadcrumb\":{\"@id\":\"https://developers.gyramais.com.br/toolbox/rodar-operacao#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.gyramais.com.br/toolbox/rodar-operacao#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guia do Toolbox\",\"item\":\"https://developers.gyramais.com.br/toolbox/visao-geral\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Rodar uma Análise\",\"item\":\"https://developers.gyramais.com.br/toolbox/rodar-operacao\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developers.gyramais.com.br/toolbox/rodar-operacao#article\",\"headline\":\"Rodar uma Análise\",\"name\":\"Rodar uma Análise\",\"description\":\"Como rodar uma análise de crédito no toolbox pelo input sempre visível, individualmente ou em lote, por política ou esteira.\",\"url\":\"https://developers.gyramais.com.br/toolbox/rodar-operacao\",\"mainEntityOfPage\":{\"@id\":\"https://developers.gyramais.com.br/toolbox/rodar-operacao#webpage\"},\"dateModified\":\"2026-10-05T18:51:56.485Z\",\"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":"/toolbox/rodar-operacao.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","description":"A tela de Produtos: o catálogo, o editor com identificação, valor, estrutura financeira, documentos e simulação ao vivo, e a aba Carteiras.","icon":"box-open","href":"/toolbox/produtos"},{"title":"Rodar uma Análise","icon":"play","href":"/toolbox/rodar-operacao"},{"title":"Interpretar Resultado do Relatório","description":"Status, score, breakdown por regra, precificação e motivos para aprovar, alertar ou negar.","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","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","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":"Rodar uma Análise - GYRA+ Docs","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}