fiscalRepresentation drops its fixed per-country fields and now carries the order's current document, with the previous ones in history.

• Breaking — sequential, serie and claveAcceso are no longer fields of the block. The authority identifiers now live in countryData, in the vocabulary of the country that numbered: claveAcceso, establecimiento, puntoEmision, secuencial and ambiente in Ecuador; numeroControl, numeroFactura and serie in Venezuela. Iterate the keys, do not index them: a channel reading countryData.claveAcceso outright works in Ecuador and breaks with the first country added. The fields that mean the same everywhere —documentNumber, issuedAt, authorizationMode, numberingStatus— did not move.
• history and compensates — when a cancellation numbers, the credit note becomes the top document, compensates points at the invoice it voids, and the whole invoice moves down into history. Every history entry has the same keys as the block above, so they read the same.
• environment — which environment Fire numbered in: SANDBOX or PRODUCTION. It is ours, not the authority's; the authority's still travels inside countryData with its own code.
• providerCode, providerIdentity and providerMetadata — these used to be a single object mixing three things. providerCode is our adapter identifier; providerIdentity is the provider's block (name, version, reference) and has a shape; providerMetadata is an opaque bag and you should not program against its keys. The numbering endpoint's response now returns exactly the same three fields, under the same names.

Note If your reconciliation assumes documentNumber is always the sale's, revisit it: after a cancellation the number on top is the credit note's. What the customer walked away with is not lost — it is in history — but you have to go there for it.

Documented on order.opened, order.completed, order.cancelled, order.invoiced, order.reversed, in the endpoint reference and in the Integrating fiscalization guide.

Updated in EN / ES / PT.

Español

15 de agosto de 2026 — El bloque fiscal: identificadores por país, anulación y proveedor

fiscalRepresentation deja de tener campos fijos por país y pasa a llevar el documento vigente de la orden, con los anteriores en history.

• Breaking — sequential, serie y claveAcceso ya no son campos del bloque. Los identificadores del ente viven ahora en countryData, con el vocabulario del país que numeró: claveAcceso, establecimiento, puntoEmision, secuencial y ambiente en Ecuador; numeroControl, numeroFactura y serie en Venezuela. Recorré las claves, no las indexes: un canal que lea countryData.claveAcceso directo funciona en Ecuador y se rompe con el primer país que entre. Los campos que significan lo mismo en todo país —documentNumber, issuedAt, authorizationMode, numberingStatus— no se movieron.
• history y compensates — cuando una anulación numera, la nota de crédito pasa a ser el documento de arriba, compensates apunta a la factura que anula, y la factura entera baja a history. Cada entrada de history tiene las mismas claves que el bloque de arriba, así que se leen igual.
• environment — en qué ambiente numeró Fire: SANDBOX o PRODUCTION. Es nuestro, no del ente; el del ente sigue viajando dentro de countryData con su propio código.
• providerCode, providerIdentity y providerMetadata — antes eran un solo objeto que mezclaba tres cosas. providerCode es nuestro identificador de adaptador; providerIdentity es el bloque del proveedor (name, version, reference) y tiene forma; providerMetadata es una bolsa opaca y no hay que programar contra sus claves. La respuesta del endpoint de numeración devuelve ahora exactamente los mismos tres campos, con los mismos nombres.

Note Si tu conciliación asume que documentNumber es siempre el de la venta, revisala: después de una anulación el número de arriba es el de la nota de crédito. Lo que el cliente se llevó impreso no se pierde —está en history— pero hay que ir a buscarlo ahí.

Documentado en order.opened, order.completed, order.cancelled, order.invoiced, order.reversed, en la referencia del endpoint y en la guía Integrar un punto de venta.

Actualizado en EN / ES / PT.

Português

15 de agosto de 2026 — O bloco fiscal: identificadores por país, cancelamento e provedor

fiscalRepresentation deixa de ter campos fixos por país e passa a levar o documento vigente do pedido, com os anteriores em history.

• Breaking — sequential, serie e claveAcceso não são mais campos do bloco. Os identificadores do órgão vivem agora em countryData, com o vocabulário do país que numerou: claveAcceso, establecimiento, puntoEmision, secuencial e ambiente no Equador; numeroControl, numeroFactura e serie na Venezuela. Percorra as chaves, não as indexe: um canal que leia countryData.claveAcceso direto funciona no Equador e quebra com o primeiro país que entrar. Os campos que significam o mesmo em qualquer país —documentNumber, issuedAt, authorizationMode, numberingStatus— não se moveram.
• history e compensates — quando um cancelamento numera, a nota de crédito passa a ser o documento do topo, compensates aponta para a nota de venda que ela cancela, e a nota de venda inteira desce para history. Cada entrada de history tem as mesmas chaves que o bloco acima, então se leem igual.
• environment — em qual ambiente o Fire numerou: SANDBOX ou PRODUCTION. É nosso, não do órgão; o do órgão continua viajando dentro de countryData com o próprio código.
• providerCode, providerIdentity e providerMetadata — antes eram um único objeto que misturava três coisas. providerCode é o nosso identificador de adaptador; providerIdentity é o bloco do provedor (name, version, reference) e tem forma; providerMetadata é uma bolsa opaca e não se deve programar contra suas chaves. A resposta do endpoint de numeração devolve agora exatamente os mesmos três campos, com os mesmos nomes.

Note Se a sua conciliação assume que documentNumber é sempre o da venda, revise-a: após um cancelamento o número do topo é o da nota de crédito. O que o cliente levou impresso não se perde — está em history — mas é preciso ir buscá-lo lá.

Documentado em order.opened, order.completed, order.cancelled, order.invoiced, order.reversed, na referência do endpoint e no guia Integrar um ponto de venda.

Atualizado em EN / ES / PT.

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