Se a sua empresa já usa um sistema próprio — um ERP, uma plataforma de agendamento, um CRM — não faz sentido digitar cada nota de novo num emissor. Uma API de emissão de documentos fiscais deixa o seu sistema emitir a nota sozinho, no momento certo.
O que é uma API de emissão de documentos fiscais
É uma ponte entre o seu sistema e a SEFAZ (ou o Sistema Nacional, no caso da NFS-e). O seu sistema manda os dados da nota em formato simples (JSON); a API faz o trabalho pesado e devolve o resultado:
- Monta o XML no layout oficial, que muda a cada Nota Técnica.
- Assina com o certificado digital A1 da empresa.
- Transmite e interpreta a resposta: autorizada, rejeitada (com o motivo) ou pendente.
- Devolve o PDF e o XML para você mandar ao cliente e guardar.
Por que não fazer isso dentro do seu próprio sistema?
Dá para fazer, mas o custo de manutenção é alto: certificado digital e assinatura de XML, schemas que mudam com frequência (Reforma Tributária, CNPJ com letras), comunicação segura com os servidores do governo, tratamento de rejeições e de instabilidade. Com uma API, isso fica com quem cuida de nota fiscal todo dia — e o seu time foca no seu produto.
O que verificar ao escolher uma API
- Erros claros antes de transmitir: a API deve dizer qual campo está errado, em vez de devolver só a rejeição da SEFAZ.
- Proteção contra nota duplicada: se a internet cair e o seu sistema reenviar, não pode sair uma segunda nota.
- PDF, XML e cancelamento pela própria API.
- Atualização constante: quem mantém a API precisa acompanhar as Notas Técnicas por você.
- Suporte de verdade na hora de integrar.
A API de NFS-e do soluweb
Hoje o soluweb oferece API para NFS-e no padrão nacional (Sistema Nacional da NFS-e), já usada em produção por sistemas de clientes. A autenticação é por chave (cabeçalho X-API-Key) e a resposta da emissão é imediata: a nota volta autorizada, rejeitada com o motivo, ou recusada na validação com a lista de campos a corrigir.
| Endpoint | O que faz |
|---|---|
POST /emitir | Emite a NFS-e e devolve número, chave e valores calculados (ISS, retenções, valor líquido). |
GET /<id> | Consulta a nota. |
GET /listar | Lista as notas, com filtro por situação. |
GET /<id>/xml | Baixa o XML autorizado. |
GET /<id>/danfse | Baixa o PDF da nota (DANFSe). |
POST /<id>/cancelar | Cancela a nota. |
Exemplo de emissão (dados fictícios):
curl -X POST https://emissor.dev.br/zpdv/api/v2/nfse/emitir \
-H "X-API-Key: sua-chave" -H "Content-Type: application/json" \
-d '{
"competencia": "2026-10-08",
"tomador": {
"cpf_cnpj": "12345678000199", "razao_social": "CLIENTE EXEMPLO LTDA",
"endereco": { "cep": "09250640", "logradouro": "Rua Exemplo", "numero": "100",
"bairro": "Centro", "cidade": "Santo André", "uf": "SP" }
},
"servico": { "descricao": "Consultoria - outubro/2026", "codigo_tributacao_nacional": "170101" },
"valores": { "servico": 1000.00 },
"tributacao": { "issqn": { "situacao": "tributavel", "aliquota": 2.00, "retido": false } }
}'Alguns cuidados que a API já resolve:
- Nota repetida: uma emissão idêntica a uma nota das últimas 24h devolve a nota existente, sem transmitir de novo.
- Validação antes de enviar: CPF/CNPJ (inclusive CNPJ com letras) com dígito verificador conferido, endereço do tomador quando ele é empresa e caracteres que o layout não aceita.
- Pronta para a Reforma: já aceita o indicador de operação do IBS/CBS, para você não precisar mudar a integração quando ele entrar em vigor na NFS-e.
Preparada para a Reforma Tributária
A API acompanha as Notas Técnicas do Comitê Gestor da NFS-e: já aceita CNPJ alfanumérico e entrega o DANFSe no modelo nacional da NT 008. A NT 009 (IBS e CBS na NFS-e) entra assim que tiver data — e traz uma regra que vale preparar desde já: a nota será rejeitada se o município do tomador divergir do cadastro do CNPJ/CPF. Por isso a API pede o endereço completo do tomador. Detalhes em NFS-e e a Reforma Tributária.
E a NF-e e a NFC-e por API?
A emissão de NF-e (modelo 55) e NFC-e (modelo 65) pelo seu sistema é feita por integração sob consulta: a gente entende o seu caso e monta a integração com o seu sistema. Essas notas também podem ser emitidas direto pelo emissor do soluweb e pelo PDV. Para integrar, fale com a gente.
Como começar
- Plano: a API de NFS-e faz parte dos planos com NFS-e — veja em Planos e preços.
- Configuração: cadastramos a empresa e o certificado digital e liberamos a chave da API.
- Integração: você recebe o manual da API com todos os campos e acompanhamos as primeiras emissões.
Saiba mais sobre a nota de serviço em Emissor de NFS-e.