🚀 API NFe/NFCe • Em breve NFSe • Testando, até o final do primeiro semestre estará liberada comercialmente

Emita e consulte notas fiscais via API REST — simples, rápida e pronta para escalar.

Integre em minutos. Exemplo de requisições, autenticação e respostas. Ideal para ERPs, e‑commerce e integrações fiscais.

🔒 Autenticação por token ⚡ Retorno rápido 🧩 JSON padrão 📈 Pronta para testes em larga escala
POST/v1/auth/user/login
POST/v1/certificate
POST/v1/nfe
GET/v1/nfe?idDfe={{idDfe}}
POST/v1/nfce
GET/v1/nfe/cancel?idBatch={{idBatch}}
GET/v1/nfe/disenable?idInu={{idInu}}
GET/v1/nfe/correction?idCce={{idCce}}

Por que usar?

API testada em produção e liberada para a comunidade experimentar em larga escala. Já com as tags do IBS/CBS.

Autenticação

Use Authorization: Bearer <seu-token> em todas as chamadas. Solicite o token no contato privado.

Formato

Padrão REST com JSON. Erros padronizados com status, message e error.

Endpoints principais

  • POST/v1/nfe — emitir NFe
  • POST/v1/nfce — emitir NFCe
  • GET/v1/nfe?idDfe={idDfe} — consultar NFe
  • GET/v1/nfce?idDfe={idDfe} — consultar NFCe
  • GET/v1/health — status do serviço

⚠️ Ajuste a Base URL e o payload conforme sua documentação oficial no Postman.

Exemplo de payload (resumido)

{
  "tpOp": "VENDA",
  "emit": {
    "CPFCNPJ": "12345678901",
    "xNome": "João da Silva",
    "enderEmit": { "UF": "SP", "xMun": "São Paulo" }
  },
  "prod": [
    { "cProd": "ABC123", "xProd": "Produto A", "NCM": "22030000",
      "CFOP": "5102", "qCom": "2", "vProd": "50.0" }
  ],
  "pag": {
    "detPag": [
    { "tPag": "01", "vPag": "100.00" }
    ]
}

Inclua campos fiscais específicos (NCM, CST, CFOP, CSOSN, etc.) conforme regras da UF e do regime tributário.

Exemplos de código

Emitir NFe

curl -X POST https://api-notas-teste-api.jdmo92.easypanel.host/v1/nfe \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"async": true , NFe : [ { "idExternal" : "5", "infNF" : {}}]}'

Consultar NFe

curl -X GET \
  -H "Authorization: Bearer SEU_TOKEN" \
  https://api-notas-teste-api.jdmo92.easypanel.host/v1/nfe?chDfe=3515081234567890123455001

Resposta de sucesso (exemplo)

{
  "statusCode": 201,
  "data": {
    "NFe": [
      {
        "idDfe": "0e0ded7e-fdef-4d0d-b3c6-8430096520b5",
        "idExternal": "60",
        "dhEmi": "2025-08-19T10:30:00-03:00",
        "idBatch": "7d0128f8-3d31-436e-85a1-f16105b9477f",
        "nNF": "7769",
        "serie": "1",
        "chDfe": "3125000000000000000000000000000000",
        "vNF": "1200.50",
        "cStat": "100",
        "xMotivo": "Autorizado o uso da NF-e",
        "nProt": "100000000",
        "digVal": "ZT11AOAOqhxSUQuaiduaA=",
        "dhRecbto": "2025-08-19T10:35:15-03:00",
        "nRec": "310000086918980",
        "tpAmb": "2",
        "situation": "InProcessing",
        "situationDfe": "Emitido",
        "xml": "base64",
        "pdf": "base64",
        "xmlLink": "xmlLink",
        "pdfLink": "pdfLink"
      }
    ],
    "currentPage": "1",
    "totalPages": "1",
    "totalItens": "1"
  }
}

Erro padronizado (exemplo)

{
  "status": 401,
  "message": ["Email ou senha incorretos"],
  "error": "Unauthorized"
}

Boas práticas

  • Use ambiente de homologação antes de produção.
  • Versione chamadas: /v1/....
  • Trate retries exponenciais para timeouts.

Quer testar?

Envie um email para "patrick@ctec.com.br" com o assunto "Testar API Emissão Notas" e vamos conversar.

CTEC Service LTDA

CNPJ: 02.598.982/0001-90

Site

Instagram