NFapi / Instalar o cofre

Instalar o cofre na sua conta Cloudflare

O cofre guarda o seu certificado digital A1, assina as notas e arquiva os XML. Ele roda na sua conta: o NFapi nunca recebe o certificado.

Antes de começar

Gere o segredo do cofre

O segredo cifra o seu certificado e é a senha da tela de configuração. Ele é gerado aqui, no seu navegador, e não é enviado a lugar nenhum.

Instale pelo botão do Cloudflare

O botão abre o painel do Cloudflare com tudo preenchido: o Worker, o banco de dados e o armazenamento dos XML.

No formulário que abrir:

  1. Escolha a sua conta Git.
  2. No campo VAULT_SECRET, apague o que estiver lá e cole o segredo que você copiou no passo 1.
  3. Deixe Proteger com Cloudflare Access desligado.
  4. Clique em Implantar e aguarde o build terminar.

Atenção ao preenchimento automático. O navegador pode colocar uma senha salva sua no campo VAULT_SECRET. Limpe o campo antes de colar o segredo.

Instale o certificado no cofre

Quando o build terminar, o Cloudflare mostra o endereço do seu cofre (algo como nfapi-cofre.sua-conta.workers.dev). Abra-o acrescentando /setup e entre com o segredo.

  1. Envie o arquivo .pfx e a senha do certificado.
  2. Rode o teste de conexão: ele consulta os serviços de homologação do governo, sem emitir nada.
  3. Gere o código de pareamento.

A produção começa bloqueada: o cofre só assina documentos de homologação até você liberar nessa mesma tela.

Conecte o cofre à API

Envie o código de pareamento à API do NFapi, com a sua chave de API:

curl -X POST https://api.nfapi.queven.app/v1/emitentes \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json" \
  -d '{"codigoPareamento": "nfapi-cofre-v1...."}'

A API consulta o cofre, lê o CNPJ do certificado e registra o emitente. A partir daí, as notas emitidas por ele são assinadas e arquivadas no seu cofre.