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
- Uma conta Cloudflare com o plano Workers Paid (US$ 5/mês), exigido pelo Container que fala com o governo.
- Uma conta GitHub: o Cloudflare cria nela uma cópia do código do cofre.
- O arquivo
.pfxdo seu certificado A1 e a senha dele.
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.
Guarde este segredo. Baixe o arquivo e mantenha-o em um gerenciador de senhas ou outro local seguro. Se ele for perdido, será preciso reinstalar o certificado; quem o tiver consegue entrar na configuração do seu cofre.
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:
- Escolha a sua conta Git.
- No campo
VAULT_SECRET, apague o que estiver lá e cole o segredo que você copiou no passo 1. - Deixe Proteger com Cloudflare Access desligado.
- 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.
- Envie o arquivo
.pfxe a senha do certificado. - Rode o teste de conexão: ele consulta os serviços de homologação do governo, sem emitir nada.
- 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.