> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.
# Cómo funciona lo fiscal en Fire
> Los dos actos de un documento fiscal (numeración y autorización), los dos bloques que dejan en la orden y las dos formas en que un documento llega a Fire.
Todo documento fiscal en Fire pasa por **dos actos separados**, en momentos distintos, y cada uno deja su propio bloque en la orden. La mayor parte de la confusión viene de mezclarlos, así que esta página los nombra una vez y todas las demás páginas fiscales se apoyan en ella.
## Los dos actos
| | Acto 1 — Numeración | Acto 2 — Autorización |
| ------------------------- | ---------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| **Cuándo** | Antes de que exista la orden, en la caja | Segundos o minutos después de la venta |
| **Quién lo inicia** | El punto de venta le pide identificadores a Fire | El proveedor fiscal reporta el veredicto del ente fiscal |
| **Cómo llega a Fire** | Petición de [numeración fiscal](/es/api-reference/fiscal-documents-v2) | [Callback fiscal](/es/api-reference/fiscal-callback) (o PlugNotas, en Brasil) |
| **Bloque en la orden** | `data.fiscalRepresentation` | `data.fiscal.authority` |
| **Pregunta que responde** | *¿Qué se imprimió?* | *¿Qué decidió el ente?* |
| **¿Cambia después?** | Solo cuando se numera un documento nuevo (una nota de crédito) | Sí: autorizado, luego cancelado |
**`fiscalRepresentation` nunca dice que el documento fue autorizado.** Guarda los números impresos en la caja. El veredicto del ente es `fiscal.authority`, y el estado actual es `fiscal.status` en los eventos fiscales y `lastKnown.fiscal.status` en todos los demás. Los tres pueden discrepar legítimamente durante un tiempo.
## Dos formas en que un documento llega a Fire
Ocurren los dos actos. La caja numera primero a través de Fire, imprime, inyecta la orden, y el proveedor reporta después el veredicto por el callback fiscal.
* `data.fiscalRepresentation` está poblado desde el momento en que existe la orden.
* `data.fiscal.authority` aparece cuando llega el callback.
* `fiscal.providerCode` es `generic`.
**No hay Acto 1.** Fire emite la NFC-e / NF-e a través de PlugNotas después de la venta y conoce el veredicto de SEFAZ directamente por PlugNotas — sin callback fiscal ni petición de numeración.
* `data.fiscalRepresentation` es `null`.
* `data.fiscal.authority` aparece cuando SEFAZ autoriza.
* `fiscal.providerCode` es `plugnotas`.
* `authority.providerIdentity` y `authority.providerMetadata` son `null`: PlugNotas no envía ninguno de los dos. Una anulación conserva los valores del documento previo.
Otros países también pueden reportar por el callback fiscal sin numerar antes. Lo que le importa a un consumidor es lo mismo en todos los casos: **el veredicto es siempre `fiscal.authority`, con la misma forma**, sin importar por qué camino entró.
## El ciclo completo
```mermaid theme={null}
sequenceDiagram
autonumber
participant POS as Punto de venta
participant Fire
participant Prov as Proveedor fiscal
participant Auth as Ente fiscal
participant You as Consumidor de eventos
rect rgba(99, 102, 241, 0.12)
Note over POS,Fire: Acto 1 — numeración (solo países con Gateway)
POS->>Fire: petición de numeración fiscal (orderCode)
Fire->>Prov: pide identificadores
Prov-->>Fire: document + graphic + provider + metadata
Fire-->>POS: identificadores a imprimir
POS->>Fire: inyecta la orden (mismo orderCode)
Fire-->>You: order.completed — data.fiscalRepresentation
end
rect rgba(16, 185, 129, 0.12)
Note over Prov,You: Acto 2 — autorización (todos los países)
Note over Prov,Fire: En Brasil el proveedor es PlugNotas y no hay callback
Prov->>Auth: envía el documento
Auth-->>Prov: veredicto
Prov->>Fire: callback fiscal (eventType, eventId)
Fire-->>Prov: 202 Accepted
Fire-->>You: order.invoiced — data.fiscal.authority
end
rect rgba(245, 158, 11, 0.12)
Note over POS,You: Cancelación
Note over POS,Fire: Orden anulada en Fire (POS, backoffice o adaptador)
Fire-->>You: order.cancelled — documento tal como estaba
Prov->>Fire: callback fiscal eventType: cancelled (su propio eventId)
Fire-->>You: order.reversed — cancellation.fiscal.authority
end
```
Lo que pasa entre el callback y los eventos — qué evento sale para cada resultado y cómo viaja cada campo — está en [Del callback a los eventos](/es/fiscal/callback-to-events).
## Cuatro palabras para "estado"
El mismo hecho se nombra distinto según dónde lo leas. No son intercambiables:
| Dónde | Campo | Valores | Describe |
| ------------------------------------------------------------------------ | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| Respuesta de numeración fiscal | `numberingStatus` | `GENERATED`, `PENDING`, `FAILED_RETRYABLE`, `FAILED_FINAL`, `NOT_APPLICABLE`, `BLOCKED_BY_POLICY` | Si la **numeración** funcionó |
| Respuesta de numeración fiscal | `documentStatus` | `PENDING`, `AUTHORIZED`, `REJECTED`, `CANCELLED` | El documento, según lo último que supo el gateway |
| Callback fiscal (lo envías tú) | `eventType` | `fiscal_graphic`, `authorized`, `cancelled`, `rejected`, `denied`, `error` | Lo que acaba de pasar en el ente |
| Eventos fiscales (`order.invoiced`, `order.cancelled`, `order.reversed`) | `fiscal.status` | `awaiting_payment`, `not_issued`, `pending`, `processing`, `fiscal_graphic`, `authorized`, `cancelling`, `cancelled`, `rejected`, `denied`, `error` | El estado fiscal de la orden guardado con el documento |
| Todos los demás eventos de orden | `lastKnown.fiscal.status` | `pending`, `processing`, `fiscal_graphic`, `authorized`, `cancelling`, `cancelled`, `rejected`, `denied`, `error` | El estado fiscal **actual** de la orden |
## Adónde seguir
Qué evento sale para cada callback y dónde cae cada campo.
El contrato que envía tu proveedor.
El Acto 1, paso a paso, para puntos de venta y kioscos.
Lo que un proveedor implementa en ambos actos.