> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spedy.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# API de emissão de documentos fiscais

> Emita documentos fiscais eletrônicos por API REST — NF-e, NFC-e e NFS-e — com autenticação, ambiente de testes, webhooks e referência de endpoints.

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

<CardGroup cols={2}>
  <Card title="Cadastrar empresas e certificados" icon="building">
    Crie empresas emissoras, envie o certificado digital A1 e configure regime
    tributário, CSC e demais parâmetros fiscais.
  </Card>

  <Card title="Emitir documentos fiscais" icon="file-invoice">
    Emita NF-e, NFC-e e NFS-e a partir de vendas (orders), acompanhando cada
    nota do envio até a autorização.
  </Card>

  <Card title="Acompanhar o ciclo de vida da nota" icon="arrows-rotate">
    Consulte status, cancele, corrija e inutilize notas, com reconciliação
    direta junto à SEFAZ quando necessário.
  </Card>

  <Card title="Reagir a eventos em tempo real" icon="webhook">
    Configure webhooks para saber assim que uma nota é autorizada, rejeitada
    ou cancelada, sem precisar ficar consultando a API.
  </Card>
</CardGroup>

## 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

<CardGroup cols={2}>
  <Card title="Primeiros passos" icon="rocket" href="/start/primeiros-passos">
    Do zero até a primeira nota emitida em sandbox, em 5 passos.
  </Card>

  <Card title="Autenticação" icon="key" href="/start/autenticacao">
    Como obter e usar sua chave de API.
  </Card>

  <Card title="Referência da API" icon="book" href="/reference/introducao">
    Todos os endpoints, parâmetros e schemas.
  </Card>

  <Card title="Webhooks" icon="bell" href="/webhooks/visao-geral">
    Como receber eventos de mudança de status das notas.
  </Card>
</CardGroup>

<Tip>
  Se você nunca emitiu documentos fiscais eletrônicos antes, vale começar pelo
  [glossário fiscal](/start/glossario-fiscal) para se situar nos termos usados
  no restante da documentação.
</Tip>