Comece aquiVisão geral

API do Emissor de Nota

Emita NFS-e no padrão nacional, consulte guias do Simples e mantenha a carteira de empresas em dia direto do seu sistema contábil ou ERP. A API é REST, fala JSON e usa os mesmos dados que você vê no painel.

Endereço base

Todas as chamadas usam HTTPS e começam por um destes endereços. O formato é o mesmo nos dois ambientes; só a chave e o endereço mudam.

  • Produção
    Endereço
    https://api.emissordenota.com/v1
    Para quê
    Notas e guias com valor fiscal
  • Sandbox
    Endereço
    https://sandbox.api.emissordenota.com/v1
    Para quê
    Testes. Nada é transmitido

Por onde começar

O que dá para fazer

  • Empresas
    O que faz
    Lista e cadastra empresas da organização
    Caminho
    /empresas
  • NFS-e
    O que faz
    Emite, consulta, cancela e baixa o XML e o PDF das notas
    Caminho
    /nfse
  • Clientes
    O que faz
    Mantém os tomadores de cada empresa
    Caminho
    /clientes
  • Serviços
    O que faz
    Mantém os serviços com código de tributação nacional
    Caminho
    /servicos
  • Guias
    O que faz
    Consulta DAS e demais guias com valor, vencimento e PDF
    Caminho
    /guias
  • Certificados
    O que faz
    Informa a validade do certificado A1 de cada empresa
    Caminho
    /certificados
  • Webhooks
    O que faz
    Cadastra os endereços que recebem os eventos
    Caminho
    /webhooks

Uma chamada de exemplo

Liste as empresas que a sua chave acessa. Se a resposta for 200, a autenticação está funcionando.

cURL
curl https://api.emissordenota.com/v1/empresas \  -H "Authorization: Bearer edn_live_SUA_CHAVE"
200 OK
{  "dados": [    {      "id": "emp_8Kq2mXv41c",      "razao_social": "Padaria Santa Clara Ltda",      "cnpj": "12345678000190",      "regime": "simples_nacional",      "certificado_valido_ate": "2027-03-14"    }  ],  "proximo_cursor": null}

Convenções

  • Datas e horas em ISO 8601, no horário de Brasília (UTC−3).
  • Valores em reais com ponto decimal, sem separador de milhar: 1500.00.
  • CNPJ, CPF e CEP só com dígitos, sem pontos nem traços.
  • Listas paginadas por cursor, com 50 itens por página.

Precisa de acesso?

Em um plano com acesso à API, o proprietário ou um administrador autorizado gera chaves em Configurações › API e integrações.