Cambios en los elementos priceReference y exchangeRate en Documento Equivalente

Este changelog documenta las actualizaciones realizadas a las estructuras de datos para documentos equivalentes y sus notas de ajuste, con el fin de cumplir con los estándares de la DIAN (Dirección de Impuestos y Aduanas Nacionales).

Estos cambios se desplegarán a producción el 12 de Noviembre del 2025.

Cambios Implementados

1. Reestructuración del elemento priceReference

Aplica a: Documento Equivalente y su Nota de Ajuste

Descripción: El elemento priceReference se convirtió de un valor simple a un objeto con dos propiedades para cumplir con el estandar de la DIAN.

Antes:

{
  "items": [
    {
      "priceReference": "100.00" // Valor simple
    }
  ]
}

Después:

{
  "items": [
    {
      "priceReference": { // Objeto
        "priceAmount": "100.00",
        "priceTypeCode": "01"
      }
    }
  ]
}

Campos del objeto:

• priceAmount (string, requerido): Monto del precio de referencia
• priceTypeCode (string, requerido): Código del tipo de precio

Campo oficial DIAN: <PriceReference>

Validaciones:

• priceAmount debe ser un valor numérico válido
• priceTypeCode debe ser un código válido según estándares DIAN

2. Implementación de foreignCurrency y eliminación de exchangeRate

Aplica a: Documento Equivalente y su Nota de Ajuste

Descripción: Reemplazo del objeto exchangeRate por el nuevo objeto foreignCurrency para una gestión más precisa de las monedas extranjeras.

Antes:

{
  "exchangeRate": {
    "calculationRate": "4000.00",
    "date": "2024-08-22"
  }
}

Después:

{
  "foreignCurrency": {
    "currencyCode": "USD",
    "calculationRate": "4000.00",
    "date": "2024-08-22"
  }
}

Campos del nuevo objeto:

• currencyCode (string, requerido): Código ISO de la moneda extranjera
• calculationRate (string, requerido): Tasa de cambio para cálculo
• date (string, requerido): Fecha de la tasa de cambio (YYYY-MM-DD)

Campo oficial DIAN: <PricingExchangeRate>

Validaciones:

• currencyCode debe ser un código ISO válido
• calculationRate debe ser un valor numérico positivo
• date debe estar en formato YYYY-MM-DD

Pasos de Migración Recomendados

1. Revisar estructura de precios: Actualice priceReference al nuevo formato de objeto en todos los documentos afectados.
2. Actualizar manejo de moneda: Migre de exchangeRate a foreignCurrency únicamente para documentos POS/NAS que manejen monedas extranjeras.

RECUERDE: Estos cambios son obligatorios para cumplir con los requisitos de la DIAN y evitar rechazos en la validación de documentos electrónicos. Y seran llevados a producción el 12 de Noviembre del 2025.