Fire Docs

Archives
Log in
Subscribe
August 13, 2026

13 August 2026 — Fiscal numbering now travels in every order event

Orders numbered by the Fiscal Gateway before injection now carry those identifiers in every event of the order, so you no longer need a second call to print or reconcile.

  • data.fiscalRepresentation — series, sequential, document number, access key and the QR (graphic), exactly as printed at the till. Its presence means numbering was attempted, not that it succeeded: numberingStatus tells you how the attempt ended and failure why, when it did not end well — a charged sale left with no fiscal receipt arrives with null identifiers and the reason in failure. Omitted (key absent, not null) only when no attempt was made: aggregators, countries without fiscal representation, or numbering turned off. Its presence does not mean the document is authorized — the authority's verdict stays in lastKnown.fiscal.status. It never changes, even after the authority authorizes or rejects.
  • data.lastKnown.fiscal.sourceEvent — now reports real provenance instead of deriving it from the status. A processing seeded at injection used to be reported as fiscal.callback even though no callback had occurred; it now says order.injected. Account for the new value if you branch on this field.
  • Documented on order.opened, order.completed, order.invoiced and order.cancelled.

Updated in EN / ES / PT.


Español

13 de agosto de 2026 — La numeración fiscal ahora viaja en todos los eventos de la orden

Las órdenes que el Fiscal Gateway numeró antes de inyectarse ahora llevan esos identificadores en todos sus eventos, así que ya no hace falta una segunda llamada para imprimir o conciliar.

  • data.fiscalRepresentation — serie, secuencial, número de documento, clave de acceso y el QR (graphic), tal como se imprimieron en la caja. Su presencia significa que se intentó numerar, no que se numeró: numberingStatus dice cómo terminó el intento y failure por qué, cuando no terminó bien — una venta cobrada que quedó sin comprobante fiscal llega con los identificadores en null y el motivo en failure. Se omite (la clave no aparece, no viene en null) solo cuando no hubo intento: agregadores, países sin representación fiscal, o numeración desactivada. Que esté presente no significa que el comprobante esté autorizado — el veredicto del ente sigue en lastKnown.fiscal.status. No cambia nunca, ni siquiera después de que el ente autorice o rechace.
  • data.lastKnown.fiscal.sourceEvent — ahora informa la procedencia real en vez de deducirla del estado. Un processing sembrado al inyectar se reportaba como fiscal.callback sin que ningún callback hubiera ocurrido; ahora dice order.injected. Contemplá el valor nuevo si ramificás por este campo.
  • Documentado en order.opened, order.completed, order.invoiced y order.cancelled.

Actualizado en EN / ES / PT.


Português

13 de agosto de 2026 — A numeração fiscal agora viaja em todos os eventos do pedido

Os pedidos que o Fiscal Gateway numerou antes da injeção agora levam esses identificadores em todos os seus eventos, então não é mais preciso uma segunda chamada para imprimir ou conciliar.

  • data.fiscalRepresentation — série, sequencial, número do documento, chave de acesso e o QR (graphic), exatamente como foram impressos no caixa. Sua presença significa que se tentou numerar, não que foi numerado: numberingStatus diz como a tentativa terminou e failure por quê, quando não terminou bem — uma venda cobrada que ficou sem comprovante fiscal chega com os identificadores em null e o motivo em failure. É omitido (a chave não aparece, não vem null) apenas quando não houve tentativa: agregadores, países sem representação fiscal, ou numeração desativada. Sua presença não significa que o comprovante esteja autorizado — o veredito do órgão continua em lastKnown.fiscal.status. Nunca muda, nem depois que o órgão autoriza ou rejeita.
  • data.lastKnown.fiscal.sourceEvent — agora informa a procedência real em vez de deduzi-la do status. Um processing semeado na injeção era reportado como fiscal.callback sem que nenhum callback tivesse ocorrido; agora diz order.injected. Contemple o valor novo se você ramifica por este campo.
  • Documentado em order.opened, order.completed, order.invoiced e order.cancelled.

Atualizado em EN / ES / PT.


Read the full changelog · Ver el registro completo · Ver o registro completo

Don't miss what's next. Subscribe to Fire Docs:
← Newer 15 August 2026 — The fiscal block: country identifiers, voiding and provider Older → 11 August 2026 — BOH API: qty_base derived server-side with item_unit_id
Powered by Buttondown, the easiest way to start and grow your newsletter.