FacturaSend posee varias opciones de configuración de decimales para el redondeo de los montos del documento electrónico tanto para el documento XML que será generado como así también para la visualización del KUDE.

A continuación en éste articulo le presentamos todas las opciones para que usted pueda probar la flexibilidad.

Configuración Global

Primeramente veremos la opción global utilizada para la generación del XML. La configuración global es válida para todos los documentos, si no se especifica lo contrario, ésta es la opción que será utilizada para todos los documentos de la empresa.

En la consola de FacturaSend, una vez que haya ingresado a la Empresa que desea configurar, presione clic sobre el logo que se encuentra en la parte superior derecha, luego Opciones:

Ahí estando en la opción de Parámetros, desplácese hacia abajo

hasta encontrar los siguientes 4 campos referentes a los decimales:

En la imagen de arriba se puede observar los valores que debería dejar por defecto, ya que sirve para la mayoría de los casos, salvo tenga alguna necesidad particular.

A continuación se describe cada opción y cómo es utilizado para generar el documento electrónico:

• Cant. decimales PYG (pygDecimals): Es la cantidad de decimales que se aplicará a los resultados de cálculos de algunos campos en los documentos que están en PYG/Guaraníes.
  
  Estos campos pueden ser los subtotales de la mercadería (cantidad x precio), cálculos de descuentos o anticipos y el total general de la operación.
  
  Su valor en PYG conviene que esté siempre en 0 (cero) ya que en Guaraníes no existen moneda de cambio para los valores en decimales.
  
  
• Cant decimales redondeo impuesto PYG (pygTaxDecimals): De forma análoga éste campo representa la cantidad de decimales que se aplicará a los resultados de cálculos de impuestos totales en los documentos que están en PYG/Guaraníes.
  
  Entre estos campos se encuentran la base gravada del IVA (5 % o 10 %), la liquidación del IVA (5 % o 10 %) y los valores en exenta del total general del documento.
  
  Ya que SIFEN posee un rango de aproximación mínimo y máximo permitido para los cálculos de éstos campos del cual no se puede salir, el valor de éste campo conviene que esté siempre en 2 (dos) de esa forma no se generan grandes diferencias en el total del impuesto del Documento electrónico. Un valor menor a 2 puede generar problemas de rechazo por el motivo de “Cálculo del total de la base gravada del IVA incorrecto“.
  
  No obstante es importante saber que los resultados parciales (calculados para cada ítem) de impuestos para la base gravada del IVA (5 % o 10 %), la liquidación del IVA (5 % o 10 %) y los valores en exenta de cada ítem del XML se calculan todos en 8 decimales de forma predeterminada, pero existe una opción interna llamada (partialTaxDecimals) para reducir éste valor. El cambio de dicha opción puede ser solicitada a pedido.
  
  
• Cant. decimales otras monedas (decimals): Decimales utilizados para los resultados de los subtotales de la mercadería (cantidad x precio), cálculos de descuentos o anticipos y el total general de la operación para aquellos documentos que son en USD, por ejemplo.
  
  Como en USD si se tienen en cuenta los decimales en ésta configuración se puede dejar de 2 a 8, pero recomendamos 2, ya que es lo que se estila más visualizar de esa forma en el KuDE.
  
  
• Cant. decimales redondeo impuesto otras Monedas (taxDecimals): Es el valor de decimales que se utilizará para la base gravada del IVA (5 % o 10 %), la liquidación del IVA (5 % o 10 %) y los valores en exenta, del total general del documento, para aquellos documentos que son en USD, por ejemplo.
  
  Su valor predeterminado también conviene dejarlo a partir de 2 hasta 8, pero recomendamos 2.

NOTA: A los valores de cantidad y de precio del producto o servicio que se pasa en el JSON nunca son aplicados redondeos. Dichos valores, con sus respectivos decimales, se aplica al XML, tal cual se envió en la petición.

Vea también que al lado de cada campo se anexa un nombre de configuración, así verá pygDecimals, pygTaxDecimals, decimals y taxDecimals, recuerdo esto pues se utilizará más adelante.

Recuerde que lo que se estuvo mostrando arriba sirve para calibrar los decimales en la generación del archivo XML, tanto para moneda PYG como en otras monedas y esas configuraciones que están arriba son las que se utilizarán para todos los documentos electrónicos.

Así, si todos los documentos deben generarse de esa forma, entonces usted ya no tiene de que preocuparse, pero que pasaría si por ejemplo un cliente especial pide que para el impuesto USD la cantidad de decimales sea redondeado a 0 (cero), es decir sin decimales, pero sólo éste cliente solicita eso, y usted no desea modificar la configuración global.

En ese caso FacturaSend da la posibilidad de usar una configuración particular el cual puede realizarse en la petición de la Creación del documento. Esto es explicado a continuación.

Especificar configuración de decimales por petición de nuevo documento.

Si desea cambiar la configuración de los decimales, justo en el momento de la creación del DE y sólo para un grupo de documentos, usted puede enviar en el JSON los datos de configuración “config” al momento de lote/create

El atributo “config” debe ir en el primer objeto json del Array y se debe especificar de la siguiente forma:

	"config" : {
		"pygDecimals" : 3, 
		"pygTaxDecimals" : 3,
		"decimals" : 3, 
		"taxDecimals" : 3
	}

Si el lote posee más de un documento, esa misma configuración que se envió en el primero documento se aplicará a todos los documentos enviados en dicho lote.

No es necesario que especifique siempre todos los valores, por ejemplo si está generando un documento en USD y solo desea cambiar los decimales de subtotales y total general, puede enviar solo ésa configuración, como se muestra abajo.

	"config" : {
		"decimals" : 3
	}

Tenga en cuenta que se aplicará solo a los documentos que están en USD, caso en el mismo lote se hayan enviados documentos en varias monedas.

Tenga en cuenta también que esta “config” pisa a la configuración global momentáneamente, solo para esa petición, tal es así que otros documentos no serán alterados.

Opciones de formato de decimales en el KuDE

Los decimales también pueden ser configurados a nivel de visualización, pero eso no significa que los valores internos del XML vayan a cambiar, al contrario, la aplicación de los decimales se aplica sobre los valores ya guardados en el XML.

Para personalizar cómo desea formatear los decimales del KuDE, al momento de llamar al endpoint para obtener el PDF KuDE, puede enviar la siguiente configuración:

 "config" : {
		"kudeParam.quantityDecimals" : 3, 
		"kudeParam.pygDecimals" : 3, 
		"kudeParam.pygTaxDecimals" : 3,
		"kudeParam.decimals" : 3, 
		"kudeParam.taxDecimals" : 3
    }

Note que además de las configuraciones sobre los precios y subtotales, aquí también puede aplicar configuración de decimales sobre la cantidad.

Cada configuración para el KuDE tiene una relación con la configuración que se utiliza para generar el XML y que ya se explicó anteriormente:

• kudeParam.pygDecimals: Es el formato de decimales que se aplicará a la columna descuentos/anticipos, exentas, gravada 5, grabada 10 de los ítems y a los totales de la operación, exceptuando los campos de impuestos, para los documentos en PYG/Guaraníes.
  
  El campo precio no tiene formato específico de decimales, se muestra tal cual se envió en el JSON y tal cual se guardó en el XML
  
  
• kudeParam.pygTaxDecimals: Es el formato de decimales que se aplicará a la liquidación de impuestos: Iva 5, Iva 10 y al Iva Total en los documentos que están en PYG/Guaraníes.
  
  
• kudeParam.decimals: Idem kudeParam.pygDecimals, pero para documentos que son en otras monedas como USD, por ejemplo.
  
  
• kudeParam.taxDecimals: Idem kudeParam.pygTaxDecimals, pero para aquellos documentos que son en otras monedas como USD, por ejemplo.
  
  
• (kudeParam.quantityDecimals): Es el formato de decimales para la columna cantidad, independiente de la moneda del documento.
  

Conclusión

En definitiva, la capacidad de definir la lógica de decimales en FacturaSend no es simplemente un detalle técnico, sino una herramienta clave para adaptar la facturación electrónica a la realidad de cada negocio. Al permitir establecer con precisión cuántos decimales utilizar en montos, precios y cantidades, el sistema garantiza coherencia, cumplimiento y menor riesgo de errores en los procesos.

Para las empresas usuarias —desde pequeñas PyMEs hasta grupos con múltiples sucursales— esta configuración ofrece:

• Flexibilidad para ajustarse al contexto específico de la operación (por ejemplo ventas por unidad, por peso o en operaciones fraccionadas).
• Seguridad de que los documentos electrónicos que emitan a través de DNIT (antes SET) cumplirán con los criterios de redondeos y presentación exigidos.
• Mejora en la calidad de los datos analíticos y reportes, al evitar discrepancias fruto de redondeos inconsistentes.

En conclusión, dedicar unos minutos para revisar y optar por la configuración correcta de decimales —y reevaluarla cuando cambien los productos, unidades o modelos de negocio— es una inversión que potencia la eficiencia operativa y la conformidad fiscal. FacturaSend pone en tus manos esta funcionalidad crítica; ahora depende de cada empresa aprovecharla para alinear su facturación con sus necesidades reales.