Empezá

Empresa activa

Sobre qué empresa opera cada llamada y para qué sirve X-Expected-Company.

Una instalación del ERP puede tener varias empresas legales. Sus clientes, artículos, comprobantes y saldos nunca se mezclan: cada llamada opera sobre una sola empresa.

La empresa de la llamada

La empresa la fija la credencial: la de la clave API, o la empresa activa de la sesión. Además, cada operación de empresa pide el encabezado X-Expected-Company con el id de la empresa sobre la que creés estar operando:

-H "X-Expected-Company: 3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90"

Si no coincide con la de la credencial, la llamada se rechaza con 409 y no hace nada. Así, una integración que quedó apuntando a otra empresa nunca carga un pedido donde no corresponde.

Situación	Respuesta	Código
Falta el encabezado	`428`	`company.expected-required`
La sesión no tiene empresa activa	`409`	`company.no-active`
La empresa no coincide	`409`	`company.mismatch`

Cómo saber el id

Listar empresas devuelve las empresas a las que accede el usuario, con su id. Las operaciones que no dependen de una empresa, como Listar alícuotas de IVA, no lo piden.