Guidis Reinf

Como usar Claude Code para preparar envios da EFD-Reinf

Use o Claude Code com os arquivos da apuração na sua máquina para cruzar documentos, destacar dúvidas, organizar as informações do envio e só então seguir para transmissão, recibos e acompanhamento técnico da EFD-Reinf pela API do Guidis Reinf.

Quando faz sentido

O ganho aparece quando o time já tem XML, PDF, planilhas, CSV e outros documentos de apoio, mas ainda precisa cruzar dados, resolver divergências e preparar uma chamada real da API com menos retrabalho manual.

O Claude Code entra antes da transmissão. A intenção não é pular conferência humana: é fazer a leitura inicial dos arquivos, consultar o OpenAPI público, levantar campos incertos e transformar a apuração em informações revisáveis antes da chamada da API.

  • Arquivos da apuração primeiro - o Claude Code pode ler XML, PDF, Excel, CSV e documentos de apoio antes de organizar as informações do envio na integração.
  • Contrato público como referência - o Claude Code consulta o OpenAPI público e a documentação da API antes de montar ou corrigir chamadas.
  • Confirmação antes do envio - depois da montagem, o Claude Code pode apontar lacunas, pedir confirmação e só então seguir com envio e leitura de retornos.

Passo a passo

  1. Crie a Chave de API - gere a chave em Administração > Controle de Acesso > Integrações API e guarde-a com segurança, pois é exibida uma única vez.
  2. Obtenha o access token - troque a Chave de API por um token em POST /api/integracao/token antes de qualquer chamada do Claude Code.
  3. Valide o contexto e leia os arquivos - comece por GET /v1/integracao/contexto e só então peça ao Claude Code para ler os arquivos da apuração e os documentos do fluxo.
  4. Monte, revise e envie - use o OpenAPI público para organizar as informações do envio, revise contribuinte, ambiente e competência e só depois transmita.

Exemplo prático

Garanta primeiro a Chave de API e o token da conta:

POST /api/integracao/token
Authorization: Bearer SUA_CHAVE_DE_API

Prompt base para a montagem assistida:

Leia os arquivos da apuração desta rotina na minha máquina, consulte o OpenAPI público do Guidis Reinf, organize as informações do fluxo que preciso enviar e destaque qualquer campo incerto antes de preparar a chamada da API.

Depois da transmissão, use a mesma integração para consultar recibos, retornos, status e evidências operacionais.

Quando houver lacuna, divergência de CNPJ, competência ambígua ou documento de apoio incompleto, peça ao Claude Code para parar e formular a pergunta de confirmação antes de preparar a chamada final.

Veja também a documentação completa da API e a versão para Codex.