Entrar Começar grátis
API e webhooks

Emita NFS-e pelo seu sistema com a API da Pluma Fiscal

Uma API REST simples para software houses, ERPs e plataformas: crie a nota com JSON, receba a chave de acesso e acompanhe tudo por webhooks.

Começar grátisPreços

O problema: integrar direto com o Sistema Nacional dá trabalho

Montar a DPS no leiaute oficial, assinar XML com certificado, falar com a Sefin Nacional por TLS mútuo e tratar rejeições e respostas incertas consome semanas de desenvolvimento — e manutenção a cada nota técnica.

A solução: a parte fiscal fica com a Pluma Fiscal

POST /api/v1/nfse
Authorization: Bearer pf_...
Content-Type: application/json

{
  "empresa_id": 1,
  "external_id": "pedido-1234",
  "servico_id": 3,
  "tomador": {"documento": "11222333000181", "nome": "Cliente Ltda", "email": "[email protected]"},
  "valor_servico": "1500.00"
}

A resposta traz a situação (autorizada, rejeitada ou incerta), o número e a chave de acesso. O mesmo external_id nunca gera duas notas.

Endpoints

  • GET /api/v1/empresas — empresas emissoras e pendências de configuração
  • GET /api/v1/servicos e GET /api/v1/clientes
  • POST /api/v1/nfse — cria e emite (ou só cria o rascunho com "emitir": false)
  • GET /api/v1/nfse/{id} e GET /api/v1/nfse/{id}/xml
  • POST /api/v1/nfse/{id}/emitir e POST /api/v1/nfse/{id}/cancelamento

Webhooks

Eventos nfse.emitida, nfse.rejeitada e nfse.cancelada, assinados com HMAC-SHA256 para você validar a origem.

Planos

A API está incluída nos planos Equipe e Enterprise e tem uma linha própria, API, com franquia por volume e excedente por nota mais barato. Veja em Planos e preços.

Emita a sua primeira NFS-e hoje

Comece no plano gratuito, sem cartão. Leva poucos minutos para cadastrar a empresa e o certificado.

Começar grátisVer planos e preços