Do Prompt ao Código: Como enviar seu documento para a API da Qive usando sua IA favorita

Automação e Inteligência de Dados

Tendências

Do Prompt ao Código: Como enviar seu documento para a API da Qive usando sua IA favorita

11 min de leitura

Por:

Thiago Ribeiro

Publicado:

Atualizado:

September 23, 2026

Sabemos que, no dia a dia da tecnologia, nem sempre o caminho padrão é o que melhor se adapta à sua realidade. Às vezes, o volume de documentos exige algo mais robusto que o upload manual; em outras, a solução via e-mail (eu@qive) não oferece o controle necessário. Talvez até o nosso Sincroniza Notas (que a gente adora!) não se encaixe perfeitamente naquele fluxo específico do seu servidor ou da sua aplicação.

Se você chegou à conclusão de que utilizar a API da Qive para enviar seus documentos é o caminho, mas o seu time de TI está sobrecarregado ou você quer apenas um "empurrãozinho" para começar, temos uma novidade: você pode usar a Inteligência Artificial para construir essa ponte.

Não importa se você prefere o ChatGPT, Claude, Gemini ou a IA interna da sua empresa. Hoje, vamos te dar os "mapas da mina" (prompts) para você gerar código de integração em segundos.

Por que usar uma IA para integrar com a Qive?

Se comunicar com APIs pode parecer complexo à primeira vista: autenticação, headers, payloads, tratamento de erros... a lista é longa. Ao usar um modelo de linguagem (LLM), você pula a etapa de "quebrar a cabeça" com a sintaxe e vai direto para a implementação.

As vantagens são claras:

Linguagem da sua preferência: Quer em Python? Node.js? Go? C#? A IA escreve para você.
Velocidade: O que levaria horas lendo documentações pode ser resumido em um exemplo prático imediato.
Customização: Você molda a ferramenta conforme a sua necessidade do seu negócio.

Checklist rápido

Antes de começar, tenha certeza que você tem em mãos:

as credenciais de uso da API da Qive;
acesso a um ambiente com a linguagem de sua preferência instalada e configurada;
ao menos um arquivo XML válido, que pode ser uma NF-e, CT-e ou NFS-e.

Opção 1: O Exemplo Prático

Se você precisa apenas de um exemplo básico de como enviar um documento para a Qive via código para entender a estrutura da requisição, use o prompt abaixo.‍

Dica: Basta copiar o texto abaixo, substituir o que está em [INSERIR LINGUAGEM AQUI] pela sua linguagem de preferência e colar na sua IA.

‍

O Prompt:

O prompt

Atue como um Engenheiro de Software Sênior especializado em integrações de API.

Crie um exemplo simples e funcional em [INSERIR LINGUAGEM AQUI] que faça o upload de um único arquivo XML para a API da Qive.

## Requisitos
1. O código deve enviar uma requisição POST para:
   https://api.arquivei.com.br/v1/dfe/upload
2. A requisição deve conter exatamente estes headers:
   * X-API-ID
   * X-API-KEY
   * Content-Type: application/json
3. O XML deve ser lido de um caminho fixo no código, por exemplo:
   ./input/exemplo.xml
4. O conteúdo do XML deve ser:
   * lido do arquivo;
   * convertido para Base64;
   * enviado no payload JSON no formato:
   {"xml":""}
5. O exemplo deve:
   * ser o mais simples possível;
   * ser completo e executável;
   * evitar frameworks e bibliotecas externas, usando recursos nativos da linguagem sempre que possível;
   * exibir no terminal o status HTTP da resposta e o corpo retornado pela API;
   * conter tratamento básico de erro de leitura de arquivo e erro de requisição.

## Saída esperada
Sua resposta deve conter, nesta ordem:
1. Um breve resumo do que o exemplo faz.
2. O código completo.
3. Instruções curtas de execução.
4. Um lembrete final dizendo:
   "As credenciais da Qive API devem ser obtidas com o time de atendimento da Qive."

Opção 2: A Ferramenta Completa

Agora, se você quer algo pronto para rodar e já sair enviando seus documentos, este prompt é para você. Ele vai pedir para a IA criar um CLI (Interface de Linha de Comando) que carrega os documentos a partir de uma pasta e envia para a Qive.

Este script fará o seguinte:

Carrega todos os documentos da pasta input;
A cada documento, aciona a API da Qive;
Se a API retornar sucesso, ele move o arquivo para a pasta output.

O Prompt:

O prompt

Papel: Atue como um Engenheiro de Software Sênior especializado em integrações de API e processamento de arquivos em lote. Pense passo a passo para garantir a melhor arquitetura e tratamento de erros.

Objetivo: Crie uma aplicação de linha de comando (CLI) completa e robusta utilizando a linguagem [INSERIR LINGUAGEM AQUI]. A aplicação deve ler arquivos XML de um diretório local, enviá-los para a API da Qive e gerenciar os arquivos com base na resposta da API.

## Requisitos funcionais
1. A aplicação deve se comunicar com o endpoint:
   POST https://api.arquivei.com.br/v1/dfe/upload
2. A requisição HTTP deve conter exatamente estes headers:
   * X-API-ID
   * X-API-KEY
   * Content-Type: application/json
3. As credenciais da API devem poder ser informadas de duas formas:
   * por parâmetros na linha de comando; e/ou
   * por arquivo de configuração local.
4. O payload JSON enviado para a API deve estar no formato:
   {"xml":""}
5. A aplicação deve procurar arquivos .xml dentro da pasta ./input, incluindo todas as subpastas recursivamente.
6. Arquivos que não sejam .xml devem ser ignorados.
7. A implementação deve ser adequada para pastas com grande quantidade de arquivos, evitando travamentos, consumo excessivo de memória e abordagens que carreguem tudo de uma vez em memória.
8. Para cada arquivo XML encontrado:
   * ler o conteúdo do arquivo;
   * converter o conteúdo para Base64;
   * montar o JSON no formato exigido;
   * enviar para a API Qive.
9. Se a API responder com status HTTP 2XX:
   * o arquivo deve ser movido para a pasta ./output;
   * o nome original deve ser preservado sempre que possível;
   * se já existir arquivo com o mesmo nome no destino, deve haver tratamento de colisão com renomeação usando sufixo numérico, por exemplo:
     · arquivo.xml
     · arquivo-1.xml
     · arquivo-2.xml
10. Se a API responder qualquer status diferente de 2XX:
    * o arquivo deve permanecer na pasta ./input;
    * não deve ser movido;
    * deve haver log claro do erro.
11. A aplicação deve funcionar mesmo com muitos arquivos e deve priorizar recursos nativos da linguagem, evitando dependências externas sempre que possível.
12. Todo o código deve ser retornado em um único arquivo-fonte.

## Requisitos de implementação
* Prefira funções e bibliotecas padrão da linguagem.
* Evite frameworks e pacotes de terceiros, salvo se forem estritamente indispensáveis.
* O código deve ser claro, organizado e pronto para uso.
* Inclua tratamento de erros.
* Inclua logs objetivos no terminal para indicar:
   · arquivos encontrados;
   · arquivos enviados com sucesso;
   · arquivos mantidos no diretório de entrada por falha;
   · erros de leitura, serialização, HTTP ou movimentação.
* A implementação deve ser segura e estável.
* Se a linguagem permitir, use uma estratégia eficiente para percorrer diretórios recursivamente e processar arquivos sem acumular toda a lista em memória.
* Se a linguagem permitir concorrência nativa com segurança e simplicidade, ela pode ser usada, mas apenas se realmente agregar robustez sem complicar demais o uso. Caso contrário, prefira processamento sequencial bem estruturado.
* O código deve ser autocontido e fácil de copiar e executar.

## Saída esperada
Sua resposta deve conter, nesta ordem:
1. Um breve resumo técnico da solução proposta.
2. O código completo, em um único arquivo.
3. Instruções claras de execução, incluindo:
   * como salvar o arquivo;
   * como executar o programa;
   * como informar as credenciais por parâmetro;
   * como informar as credenciais por arquivo, se implementado.
4. Um exemplo de uso.
5. Uma observação final informando explicitamente que:
   "As credenciais da Qive API devem ser obtidas com o time de atendimento da Qive."

## Critérios de qualidade
* O código deve estar correto e executável.
* A solução deve ser prática para uso real.
* A resposta não deve ser abstrata: entregue implementação concreta.
* Não use pseudocódigo.
* Não divida em múltiplos arquivos.
* Não omita partes importantes.
* Não simplifique demais o tratamento de arquivos, HTTP ou colisão de nomes.
* Não use memória de forma ingênua para listar ou carregar volumes enormes de arquivos de uma só vez.

Agora gere a melhor implementação possível, obedecendo rigorosamente todos os requisitos acima.

‍

Conclusão

Integrar com a Qive não precisa ser uma tarefa complexa. Com os prompts certos e o apoio da Inteligência Artificial, você transforma o que era um "projeto de semanas" em uma "tarefa de minutos".

A tecnologia está aí para trabalhar a seu favor. Pegue esses prompts, escolha sua IA favorita e veja a mágica acontecer!

⚠️

É importante reforçar que os documentos só serão importados se o CNPJ cadastrado na Qive tiver algum papel no documento, por exemplo, na NF-e, ser o emitente, destinatário ou interessado.

Além disso, atente-se para importar apenas documentos válidos, pois não é possível remover documentos de uma conta após a importação.

Ficou com alguma dúvida sobre nossas APIs? Acesse nossa documentação técnica aqui ou fale com nosso time de atendimento!

Gostou dessa abordagem?

Usar IAs para facilitar a vida do desenvolvedor é uma das formas mais inteligentes de ganhar escala. Se você criar algo incrível com esses prompts, marque a Qive nas redes sociais!

‍

Thiago Ribeiro

É Senior Technical Product Manager na Qive, possui MBA em Gestão de Negócios pela USP, com vasta experiência em gestão de produtos e documentos fiscais. Com mais de 10 anos de atuação no setor de tecnologia, é um entusiasta da inovação em soluções fiscais e da liderança de equipes de alta performance.