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

# BP-e — jornada do bilhete

> Mapa da API pública de BP-e (modelo 63): emissão de passagem rodoviária, consultas e cancelamento via $bpe->…->handle().

O **BP-e** (modelo 63) cobre bilhete de passagem rodoviária. O client público é `Suot\Fiscal\Bpe\Application\Bpe` via `$bpe->…->handle()`.

<Warning>
  Capacidades fiscais só são production-ready após schemas importados, fixtures, ciclo de vida completo e evidência de homologação. O ciclo mínimo (status, emissão, consulta, cancelamento) está implementado, mas a homologação de emissão ainda **não** atingiu `cStat 100` — bloqueio atual `203` (emitente não habilitado para BP-e). Status do serviço homologado com `cStat 107` (2026-07-16).
</Warning>

## Jornada

<CardGroup cols={2}>
  <Card title="Emissão" icon="ticket" href="/fiscal/bpe/emissao">
    `$bpe->issue()…->handle()` — passagem rodoviária, trecho, valores e pagamento.
  </Card>

  <Card title="Resultados" icon="circle-check" href="/fiscal/bpe/resultados">
    `IssueBpeResult`: autorizado, rejeitado, `failure()`, campos a persistir.
  </Card>
</CardGroup>

## Consultas

<CardGroup cols={2}>
  <Card title="Status do serviço" href="/fiscal/bpe/consultas/status-servico" />

  <Card title="Por chave" href="/fiscal/bpe/consultas/por-chave" />
</CardGroup>

## Eventos

<CardGroup cols={2}>
  <Card title="Cancelamento" href="/fiscal/bpe/eventos/cancelamento" />
</CardGroup>

## Pacote e instalação

```bash theme={null}
composer require suot/fiscal-core suot/fiscal-sefaz suot/fiscal-bpe
```

Vendas, reservas, assentos e embarque ficam no host — o SDK trata apenas o documento fiscal.

## Variantes

BP-e TM (metropolitano) e BP-e TA (aéreo) têm jornadas próprias:

* [BP-e TM](/fiscal/bpe/tm) — transporte metropolitano (`BPeRecepcaoTM`).
* [BP-e TA](/fiscal/bpe/ta) — transporte aéreo (`BPeRecepcaoTA`, SVRS-only).

## Próximos passos

Trilha didática: [Avaliar o SDK](/fiscal/avaliar). Fretamento: [CT-e OS](/fiscal/cte-os).