Guidis Reinf

Como usar Codex para automatizar a EFD-Reinf por API

Use o Codex com os arquivos da apuração na sua máquina para consultar o OpenAPI público, preparar chamadas, executar envios e acompanhar a EFD-Reinf fora do portal, usando a API do Guidis Reinf como trilha principal da automação.

Quando faz sentido

O ganho aparece quando o time já tem XML, PDF, planilhas, CSV e outros documentos de apoio, mas quer transformar esse material em rotina executável, com validação e acompanhamento técnico no mesmo fluxo.

O Codex faz mais sentido quando a equipe quer operar fora do portal no dia a dia, usando a API como trilha principal. O portal continua útil para criar a credencial, acompanhar exceções e servir como fallback manual, mas a rotina pode ser preparada e executada por chamadas autenticadas.

  • Arquivos da apuração como entrada - o Codex pode ler XML, PDF, Excel, CSV e documentos de apoio antes de preparar as informações do envio na integração.
  • Contrato público como referência - o Codex consulta o OpenAPI público e a documentação da API antes de montar ou corrigir chamadas.
  • Execução fora do portal - depois da montagem, o Codex pode ajudar no envio e na leitura de recibos e retornos operacionais sem depender do portal como interface principal.

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 Codex.
  3. Valide o contexto e leia os arquivos - comece por GET /v1/integracao/contexto e só então peça ao Codex para ler os arquivos da apuração e os documentos do fluxo.
  4. Monte, revise e execute - 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 preparação operacional:

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.

Mantenha o fallback manual no portal quando a rotina precisar de intervenção. Veja também a documentação completa da API e a versão para Claude Code.

Depois do envio, use a mesma integração para consultar status, recibos, retornos e evidências operacionais. A automação não deve encerrar no POST: ela precisa acompanhar o resultado fiscal até existir prova suficiente para a operação.