tax_id is now a first-class field on BOH stores (RUC, CNPJ, CUIT, NIT, RUT, RFC, or any fiscal code up to 64 characters). It is optional, not unique, and accepted in POST /identity/stores and PATCH /identity/stores/{id}.

When creating a purchase order via the API you can now identify the receiving store with any of three mutually exclusive fields:

• store_id — existing UUID (unchanged).
• external_store_id — cross-system external identifier.
• store_tax_id (new) — fiscal identifier. Returns 422 with purchase_order_store_tax_id_ambiguous if multiple active stores share the value (e.g. Ecuador RUC shared across branches) — use store_id or external_store_id in that case.

Combined with Phase 17–18 ERP fields, ERPs can now create purchase orders using only external identifiers — no internal UUIDs needed.

Updated in EN / ES / PT.

Español

11 de agosto de 2026 — BOH API: resolución de establecimiento por ID fiscal en órdenes de compra (Fase 19)

tax_id es ahora un campo de primera clase en los establecimientos de BOH (RUC, CNPJ, CUIT, NIT, RUT, RFC u otro código fiscal de hasta 64 caracteres). Es opcional, no único, y se acepta en POST /identity/stores y PATCH /identity/stores/{id}.

Al crear una orden de compra por API puedes identificar el establecimiento receptor con cualquiera de estos tres campos mutuamente exclusivos:

• store_id — UUID interno (sin cambios).
• external_store_id — identificador cruzado externo.
• store_tax_id (nuevo) — identificador fiscal. Devuelve 422 con purchase_order_store_tax_id_ambiguous si varios establecimientos activos comparten el mismo valor (p. ej. RUC de Ecuador compartido entre sucursales) — en ese caso usa store_id o external_store_id.

Combinado con los campos ERP de las Fases 17–18, los ERPs pueden crear órdenes de compra sin conocer ningún UUID interno.

Actualizado en EN / ES / PT.

Português

11 de agosto de 2026 — BOH API: resolução de estabelecimento por ID fiscal em pedidos de compra (Fase 19)

tax_id é agora um campo de primeira classe nos estabelecimentos do BOH (RUC, CNPJ, CUIT, NIT, RUT, RFC ou qualquer código fiscal até 64 caracteres). É opcional, não único, e aceito em POST /identity/stores e PATCH /identity/stores/{id}.

Ao criar um pedido de compra via API você pode identificar o estabelecimento receptor com qualquer um destes três campos mutuamente exclusivos:

• store_id — UUID interno (sem alterações).
• external_store_id — identificador externo cruzado.
• store_tax_id (novo) — identificador fiscal. Retorna 422 com purchase_order_store_tax_id_ambiguous se vários estabelecimentos ativos compartilharem o mesmo valor (ex.: CNPJ compartilhado entre filiais) — nesse caso use store_id ou external_store_id.

Combinado com os campos ERP das Fases 17–18, os ERPs podem criar pedidos de compra sem conhecer nenhum UUID interno.

Atualizado em EN / ES / PT.

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