#Exposición cambiaria

Revalúa tus saldos abiertos (por cobrar y por pagar) denominados en moneda extranjera (USD/EUR) de una Fiscal Entity, comparando el tipo de cambio original (al que se emitieron los CFDIs) contra el tipo de cambio de referencia actual, para estimar tu ganancia o pérdida no realizada por movimientos cambiarios.

Cuelga de https://api.clarisfy.com/v1/cfdi/ y es tenant-gated: tu organización debe tener una conexión activa al RFC (fiscalEntityId), o el endpoint responde 404.

Los montos son NUMERIC serializados como string.

#Exposición por moneda

GET/cfdi/fx-exposure

Parámetro (query)	Tipo	Descripción
`fiscalEntityId`	string	Requerido. Identificador de la `FiscalEntity` (`fe_…`).
`asOf`	string (date)	Opcional. Fecha ISO para el tipo de cambio de referencia; por defecto, hoy.

curl "https://api.clarisfy.com/v1/cfdi/fx-exposure?fiscalEntityId=fe_9a1c2b3d4e5f6071&asOf=2026-07-25" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

{
  "as_of": "2026-07-25",
  "currencies": [
    {
      "currency": "USD",
      "open_receivable_fx": "25000.00",
      "open_payable_fx": "8000.00",
      "rate_original_weighted": "17.20",
      "rate_current": "18.65",
      "rate_source_bank": "Banxico FIX",
      "rate_current_source_date": "2026-07-25",
      "original_rate_source": "cfdi",
      "receivable_mxn_original": "430000.00",
      "receivable_mxn_current": "466250.00",
      "receivable_unrealized": "36250.00",
      "payable_mxn_original": "137600.00",
      "payable_mxn_current": "149200.00",
      "payable_unrealized": "11600.00",
      "net_unrealized": "24650.00"
    }
  ],
  "total_net_unrealized_mxn": "24650.00",
  "disclaimer": "Revaluación de tus saldos abiertos con tipos de cambio de referencia; la ganancia/pérdida es no realizada, no una cifra contable ni fiscal."
}

Campo	Tipo	Descripción
`as_of`	string	Fecha de referencia usada para el tipo de cambio actual.
`currencies[].currency`	string	Moneda del bloque (`USD`, `EUR`).
`currencies[].open_receivable_fx`	string	Saldo abierto por cobrar, en moneda extranjera.
`currencies[].open_payable_fx`	string	Saldo abierto por pagar, en moneda extranjera.
`currencies[].rate_original_weighted`	string	Tipo de cambio original ponderado (al que se emitieron los CFDIs).
`currencies[].rate_current`	string	Tipo de cambio de referencia actual.
`currencies[].rate_source_bank`	string	Fuente/banco del tipo de cambio actual.
`currencies[].rate_current_source_date`	string	Fecha del tipo de cambio actual.
`currencies[].original_rate_source`	string	Origen del tipo original: `cfdi` \| `reference` \| `mixed` \| `none`.
`currencies[].receivable_mxn_original`	string	Por cobrar valuado en MXN al tipo original.
`currencies[].receivable_mxn_current`	string	Por cobrar valuado en MXN al tipo actual.
`currencies[].receivable_unrealized`	string	Ganancia/pérdida no realizada por cobrar.
`currencies[].payable_mxn_original`	string	Por pagar valuado en MXN al tipo original.
`currencies[].payable_mxn_current`	string	Por pagar valuado en MXN al tipo actual.
`currencies[].payable_unrealized`	string	Ganancia/pérdida no realizada por pagar.
`currencies[].net_unrealized`	string	Neto no realizado de la moneda (por cobrar − por pagar).
`total_net_unrealized_mxn`	string	Neto no realizado consolidado en MXN de todas las monedas.
`disclaimer`	string	Recordatorio de que la ganancia/pérdida es no realizada.

#Errores

Código HTTP	Causa
`202`	El reporte aún se está calculando. Cuerpo: `{"status":"computing","report_kind":"…","fiscal_entity_id":"fe_…","retry_after_seconds":15}`, más el header `Retry-After`. Reintenta después de los segundos indicados (`retry_after_seconds`).
`400`	`fiscalEntityId` malformado.
`404`	Tu organización no tiene conexión activa al RFC.