API de NFS-e

Emita a nota de serviço com um JSON.

Você envia prestador, tomador e serviço. A API devolve o status, o PDF e o XML. Consulta, cancelamento e webhook usam a mesma referência do pedido.

{
    "identificacao": "pedido-1042",
    "data_emissao": "2026-10-10T14:30:00-03:00",
    "numero": "15",
    "serie": "1",
    "tomador": {
        "cnpj": "19131243000197",
        "razao_social": "Cliente Exemplo Ltda",
        "email": "fiscal@cliente.exemplo",
        "endereco": {
            "logradouro": "Rua das Acácias",
            "numero": "120",
            "bairro": "Centro",
            "codigo_municipio": "3304557",
            "uf": "RJ",
            "cep": "20040020"
        }
    },
    "servico": {
        "codigo": "010101",
        "discriminacao": "Desenvolvimento de integração para emissão de NFS-e",
        "valor_servicos": 1500,
        "tributos_municipais": {
            "aliquota_iss": 2,
            "iss_retido": false
        }
    }
}

JSON único

Prestador, tomador e serviço no mesmo corpo. A referência do seu pedido identifica a nota em todas as chamadas.

PDF e XML

Quando o status fica autorizado, a resposta traz os endereços do DANFSE em PDF e do XML autorizado.

Webhooks

A API avisa autorização, rejeição da prefeitura e cancelamento. Dá para consultar a referência do mesmo jeito.

Idempotência

Repetir o POST com a mesma referência não emite uma segunda NFS-e. A chamada devolve a nota que já existe.

Documentos

Nota de serviço e nota de produto.

NFS-e e NF-e já têm rota publicada. NFC-e, CT-e e MDF-e continuam na fila.

Disponível

NFS-e

Nota fiscal de serviço eletrônica. Emissão, consulta, cancelamento, PDF, XML e aviso por webhook.

Ver a API de NFS-e

Disponível

NF-e

Nota de produto, modelo 55. Emissão na SEFAZ, consulta, cancelamento, carta de correção e DANFE.

Ver a API de NF-e

Em breve

NFC-e

Nota de cupom no varejo.

Em breve

CT-e

Conhecimento de transporte.

Em breve

MDF-e

Manifesto de carga.

Fluxo

Três passos até o PDF.

01

Crie a conta

O cadastro entrega a chave geral na hora. Cada emitente que você incluir depois recebe a própria chave.

02

Envie o JSON

O POST /nfse recebe a referência do pedido, o tomador e os dados do serviço prestado.

03

Acompanhe a nota

Consulte a referência ou espere o webhook. PDF e XML ficam disponíveis com status autorizado.

Recursos

O que a integração cobre.

Homologação e produção

A mesma rota, com chaves separadas. O teste não autoriza nota com valor fiscal.

Chave por emitente

A chave geral identifica a conta. Cada emitente cadastrado no painel tem a própria chave.

Cancelamento

DELETE na referência, com a justificativa exigida pela prefeitura.

Erros legíveis

Validação da API e retorno da prefeitura voltam em JSON, com código e campos.

Qualquer linguagem

A integração é HTTP. Os exemplos desta página estão em cURL, PHP e JavaScript.

Utilização da API

A emissão de NFS-e e NF-e consome a cota do plano. Consulta e download ficam de fora.

Exemplo

A emissão cabe numa requisição.

POST https://api.apisimples.com/v1/nfse com a chave no header Authorization. A resposta abaixo é uma nota já autorizada.

Abrir este exemplo na documentação

curl -X POST https://api.apisimples.com/v1/nfse \
  -H "Authorization: Bearer apse_sua_chave_do_emitente" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "identificacao": "pedido-1042",
    "data_emissao": "2026-10-10T14:30:00-03:00",
    "numero": "15",
    "serie": "1",
    "tomador": {
        "cnpj": "19131243000197",
        "razao_social": "Cliente Exemplo Ltda",
        "email": "fiscal@cliente.exemplo",
        "endereco": {
            "logradouro": "Rua das Acácias",
            "numero": "120",
            "bairro": "Centro",
            "codigo_municipio": "3304557",
            "uf": "RJ",
            "cep": "20040020"
        }
    },
    "servico": {
        "codigo": "010101",
        "discriminacao": "Desenvolvimento de integração para emissão de NFS-e",
        "valor_servicos": 1500,
        "tributos_municipais": {
            "aliquota_iss": 2,
            "iss_retido": false
        }
    }
}'

Preços

Planos de integração.

A mensalidade cobre a ligação do sistema, com NFS-e e NF-e. O plano Teste é gratuito.

Teste

R$ 0 / mês

Para ligar o sistema em homologação.

  • NFS-e e NF-e
  • Somente ambiente de homologação
  • 1 CNPJ
  • PDF e XML
  • Suporte por e-mail
Criar conta

Escala

R$ 499 / mês

Para mais de um CNPJ e operação contínua.

  • NFS-e e NF-e
  • Homologação e produção
  • CNPJs conforme o contrato
  • Webhooks e reprocessamento
  • Suporte com horário estendido
Criar conta

Emissão

Utilização da API.

Cada emissão de NFS-e ou NF-e consome a cota do plano de integração.

Teste

50

emissões por mês

Escala

10.000

emissões por mês

A cota é única para NFS-e e NF-e. Entra a nota autorizada e a nota rejeitada pela prefeitura ou pela SEFAZ. Consulta, PDF, XML e erro de validação da API ficam de fora. Acima de 10.000 emissões por mês, a utilização é fechada no contato.

Dúvidas

Antes de integrar.

A API emite só NFS-e?

NFS-e e NF-e de produto já estão na API. NFC-e, CT-e e MDF-e ainda não.

Qual certificado entra na emissão?

O certificado A1 do prestador, em arquivo. O modelo A3 fica acoplado a um dispositivo e não serve para este fluxo em nuvem.

O que é a referência?

É o identificador da nota no seu sistema, como o número do pedido. Ela evita emissão duplicada e é o caminho de consulta, cancelamento e download.

A consulta consome a utilização da API?

Não. A cota conta a emissão de NFS-e e NF-e autorizadas, e as rejeitadas pela prefeitura ou pela SEFAZ. Consulta, PDF e XML ficam de fora.

Quem define o imposto?

A API transmite os dados tributários que você enviar. Item da lista, código municipal, alíquota e retenção de ISS continuam a cargo do prestador e do contador.

Crie a conta e receba a chave geral.

O cadastro pede a empresa e o CNPJ. A chave fica no painel, e cada emitente ganha a chave dele.

Criar conta