Pular para o conteúdo
notemnotemDocumentação

Primeiros passos

Este roteiro leva da criação da chave até a primeira nota emitida em homologação (sem validade fiscal). Cada passo aponta para a página com os detalhes.

1. Crie a chave de homologação

No painel da notem, abra Integrações, escolha a integração e gere uma chave de homologação (começa com ntm_homolog_). Ela aparece uma única vez: guarde-a no cofre de segredos do seu sistema. Veja Autenticação.

2. Teste a chave

cURL
curl https://app.notemfiscal.com.br/api/v1/status \
  -H "Authorization: Bearer ntm_homolog_EXEMPLO0000000000000000"

A resposta 200 informa o ambiente, a organização e a integração da chave. Veja Consultar status.

3. Cadastre a empresa emitente

POST /empresas com CNPJ, razão social e endereço. Guarde o id devolvido. Veja Empresa e certificado.

4. Grave a configuração fiscal

PUT /empresas/{id}/configuracao-fiscal com a situação no Simples Nacional, o regime especial e os tributos aproximados. Veja Configuração fiscal.

5. Envie o certificado A1

POST /empresas/{id}/certificado com o arquivo .pfx em base64 e a senha. O arquivo e a senha nunca são devolvidos.

6. Cadastre um serviço e confira a situação

POST /empresas/{id}/servicos com o código nacional do serviço. Depois, GET /empresas/{id}/situacao: quando pronta_para_emitir for true, a empresa pode emitir. Veja Serviços e códigos e Municípios conveniados.

7. Emita a nota de teste

POST /notas com uma Idempotency-Key gerada pelo seu sistema:

cURL
curl -X POST https://app.notemfiscal.com.br/api/v1/notas \
  -H "Authorization: Bearer ntm_homolog_EXEMPLO0000000000000000" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7d1f0a52-2c1e-4f7e-9a51-0c6a3b8e4d21" \
  -d '{"empresa_id":"00000000-0000-4000-8000-000000000201","servico_id":"00000000-0000-4000-8000-000000000301","valores":{"servico":"150.00"}}'
  • 201: nota autorizada.
  • 202: a notem ainda está confirmando com o governo; o resultado chega por webhook ou pela consulta da nota.
  • 422: a nota não foi aceita; erro.detalhes diz o que corrigir.

Próximos passos