Códigos de monedas

Esta guía te indica cómo usar correctamente los códigos de moneda en la API según el estándar internacional ISO 4217.

1. ¿Qué debes enviar?

En la integración, debes informar la moneda en un campo como:

currencyCode

El valor debe ser el código alfabético de 3 letras definido por ISO 4217, por ejemplo: COP, USD, EUR.

Usa siempre códigos de 3 letras en mayúscula.

No uses símbolos ($, €) ni nombres de moneda (peso, dólar).

Si tu operación es en Colombia, debes usar COP.

Factura en pesos colombianos:

{"currencyCode":"COP"}

Factura en dólares:

{"currencyCode":"USD"}

Nota crédito en euros:

{"code":"91","typeOperation":"20","currencyCode":"EUR"}

Rechaza valores nulos o vacíos en currencyCode.

Rechaza cualquier valor que no tenga exactamente 3 letras mayúsculas.

Valida que el código exista en el catálogo ISO 4217 soportado por tu sistema.

Enviar currencyCode: "$" en lugar de currencyCode: "COP" o currencyCode: "USD".

Enviar currencyCode: "cop" en minúsculas.

Enviar nombres como currencyCode: "peso colombiano" en lugar del código ISO.

Usar códigos no oficiales o internos que no estén mapeados al estándar ISO 4217.

Si tu producto maneja múltiples países, mantén un catálogo centralizado de monedas ISO 4217 y versiónalo para evitar inconsistencias entre servicios.