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

# Introdução

> Visão geral da API da Spedy: o que ela faz, para quem é e por onde começar.

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="/pages/start/primeiros-passos">
    Do zero até a primeira nota emitida em sandbox, em 5 passos.
  </Card>

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

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

  <Card title="Webhooks" icon="bell" href="/pages/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](/pages/start/glossario-fiscal) para se situar nos termos usados
  no restante da documentação.
</Tip>