Skip to main content
A API da Spedy permite emitir e gerenciar documentos fiscais eletrônicos — NF-e, NFC-e e NFS-e — e os recursos ao redor deles: empresas, clientes, produtos, vendas (orders) e webhooks. Ela foi pensada para times de engenharia que precisam colocar a emissão fiscal dentro do próprio produto: e-commerces, ERPs, PDVs, marketplaces e sistemas de gestão que precisam emitir notas de forma programática, sem depender de digitação manual em um portal.

​
O que dá para fazer

Cadastrar empresas e certificados

Crie empresas emissoras, envie o certificado digital A1 e configure regime tributário, CSC e demais parâmetros fiscais.

Emitir documentos fiscais

Emita NF-e, NFC-e e NFS-e a partir de vendas (orders), acompanhando cada nota do envio até a autorização.

Acompanhar o ciclo de vida da nota

Consulte status, cancele, corrija e inutilize notas, com reconciliação direta junto à SEFAZ quando necessário.

Reagir a eventos em tempo real

Configure webhooks para saber assim que uma nota é autorizada, rejeitada ou cancelada, sem precisar ficar consultando a API.

​
Como a API funciona, em resumo

  • REST + JSON, autenticada por um header simples (X-Api-Key).
  • Dois ambientes: produção e sandbox, com a mesma superfície de API.
  • A emissão é assíncrona: uma resposta 2xx confirma que a solicitação foi aceita, não que a nota foi autorizada pela SEFAZ. O acompanhamento é feito por webhook ou por consulta de status.

​
Por onde começar

Primeiros passos

Do zero até a primeira nota emitida em sandbox, em 5 passos.

Autenticação

Como obter e usar sua chave de API.

Referência da API

Todos os endpoints, parâmetros e schemas.

Webhooks

Como receber eventos de mudança de status das notas.
Se você nunca emitiu documentos fiscais eletrônicos antes, vale começar pelo glossário fiscal para se situar nos termos usados no restante da documentação.