API do Notanexo

1. Crie a chave

No painel: Automação → Chaves de API → nome da chave, escopo "Emitir e consultar" e ambiente "Homologação". O segredo aparece uma única vez, na tela de criação.

export NOTANEXO_KEY="nx_test_<id>_<segredo>"

2. Confira a chave e o plano

curl https://api.notanexo.com.br/v1/status \
  -H "Authorization: Bearer $NOTANEXO_KEY"

Resposta, resumida:

{
  "key": { "prefix": "nx_test_<id>…", "name": "ERP da loja", "scope": "WRITE", "environment": "HOMOLOGATION" },
  "emitter": { "cnpj": "12345678000199", "corporateName": "Loja Exemplo LTDA", "uf": "MT", "modelsEnabled": ["NFE", "NFCE"] },
  "plan": { "code": "profissional", "name": "Profissional" },
  "limits": { "emissionsPerMinute": 10, "readsPerMinute": 60, "concurrentEmissions": 2 },
  "sefaz": {
    "mode": "direct",
    "services": [
      { "model": "NFE", "cStat": "107", "xMotivo": "Servico em Operacao", "authorizer": "SEFAZ/MT" },
      { "model": "NFCE", "cStat": "107", "xMotivo": "Servico em Operacao", "authorizer": "SEFAZ/MT" }
    ]
  }
}

3. Emita uma NF-e

Idempotency-Key é obrigatório aqui: um valor por pedido, não por tentativa. payments[].method aceita o código tPag de dois dígitos ou o apelido (veja a tabela mais abaixo).

O externalId é único por empresa somando homologação e produção: um valor usado em teste não pode ser reusado em produção. Mande sempre externalId: além de ligar a nota ao seu pedido, ele é uma segunda trava contra nota em dobro.

curl -X POST https://api.notanexo.com.br/v1/nfe \
  -H "Authorization: Bearer $NOTANEXO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-1001" \
  -d '{
    "externalId": "pedido-1001",
    "operationNature": "VENDA",
    "destinationUf": "MT",
    "consumerFinal": true,
    "isRetail": false,
    "consumer": {
      "name": "Maria Souza",
      "document": "12345678909",
      "address": { "street": "Rua das Flores", "number": "100", "district": "Centro", "city": "Cuiaba", "cityCode": "5103403", "state": "MT", "zipCode": "78005000" }
    },
    "items": [{ "sku": "CAMISETA-P", "description": "Camiseta", "quantity": 1, "unitPrice": 10, "taxMetadata": { "ncm": "61091000", "cfop": "5102" } }],
    "payments": [{ "method": "01", "amount": 10 }]
  }'

Troque endereço, UF e código IBGE pelos do seu cliente; o emitente deste exemplo é de MT. Resposta 201, resumida:

{
  "id": "clz1a2b3c4d5e6f7g8h9",
  "model": "NFE",
  "status": "AUTHORIZED",
  "number": 1042,
  "serie": 1,
  "accessKey": "5126…0421",
  "protocol": "135260000001234",
  "links": { "self": "/v1/documents/clz1a2b3c4d5e6f7g8h9", "xml": "/v1/documents/clz1a2b3c4d5e6f7g8h9/xml", "pdf": "/v1/documents/clz1a2b3c4d5e6f7g8h9/pdf" }
}

Serviços: emita uma NFS-e

Habilite NFS-e na empresa e cadastre o serviço e seus tributos no painel. A chave define a empresa e o ambiente; serviceId identifica o serviço cadastrado. externalId e Idempotency-Key são obrigatórios e devem permanecer iguais ao repetir a mesma operação.

POST /v1/nfse
Authorization: Bearer SUA_CHAVE
Content-Type: application/json
Idempotency-Key: servico-1001-homologacao

{
  "externalId": "servico-1001-homologacao",
  "serviceId": "ID_DO_SERVICO_CADASTRADO",
  "serie": 1,
  "amount": 150,
  "competenceDate": "2026-09-11",
  "tomador": { "name": "Tomador sintético", "document": "52998224725" }
}

Troque os exemplos pelos dados da prestação. Consulte o resultado, XML e DANFSe pelos mesmos endpoints de documentos. Uma resposta 202 mantém o mesmo ID enquanto a emissão termina. Em Integrações, há templates de NF-e/NFS-e para n8n e Make, com configuração das credenciais e do mapeamento da operação.

4. Consulte o documento

curl https://api.notanexo.com.br/v1/documents/clz1a2b3c4d5e6f7g8h9 \
  -H "Authorization: Bearer $NOTANEXO_KEY"

5. Baixe o XML e o DANFE

curl https://api.notanexo.com.br/v1/documents/clz1a2b3c4d5e6f7g8h9/xml \
  -H "Authorization: Bearer $NOTANEXO_KEY" \
  -o nota.xml

curl https://api.notanexo.com.br/v1/documents/clz1a2b3c4d5e6f7g8h9/pdf \
  -H "Authorization: Bearer $NOTANEXO_KEY" \
  -o danfe.pdf

6. Carta de correção e inutilização

Carta de correção só existe para NF-e (a NFC-e cancela e reemite), e só para nota AUTHORIZED (uma nota cancelada não aceita mais correção); correctionText entre 15 e 1000 caracteres; acknowledgeDeadline vale aqui também (prazo de 720 horas). Sem Idempotency-Key: a rota não é idempotente.

curl -X POST https://api.notanexo.com.br/v1/documents/clz1a2b3c4d5e6f7g8h9/correction \
  -H "Authorization: Bearer $NOTANEXO_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "correctionText": "Correção do CFOP do item 1, de 5102 para 5101, sem alterar valor, quantidade ou tributo." }'

Inutilização de faixa, com Idempotency-Key:

curl -X POST https://api.notanexo.com.br/v1/inutilizations \
  -H "Authorization: Bearer $NOTANEXO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: inutilizacao-serie1-1050-1052" \
  -d '{
    "model": "NFE",
    "serie": 1,
    "startNumber": 1050,
    "endNumber": 1052,
    "justification": "Numeracao pulada por falha no sistema de vendas antes da emissao."
  }'

7. Cancele, se precisar

Justificativa entre 15 e 255 caracteres. O prazo depende da UF: em geral 24 horas para NF-e (MT: 8 horas; PR e RS: 7 dias; PI: 60 dias) e 30 minutos para NFC-e. Fora do prazo sem acknowledgeDeadline, a resposta é 422 VALIDATION_ERROR com details.reasonCode: "CANCELLATION_DEADLINE_EXPIRED". Com acknowledgeDeadline: true a chamada tenta mesmo assim, e quem decide é a SEFAZ. Depois de cancelada, a nota não aceita mais carta de correção.

curl -X POST https://api.notanexo.com.br/v1/documents/clz1a2b3c4d5e6f7g8h9/cancel \
  -H "Authorization: Bearer $NOTANEXO_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "justification": "Pedido cancelado pelo cliente antes do envio." }'