Facturas a crédito, notas de interés y mejoras del API

09/06/2026

Esta actualización agrega el soporte de facturas a crédito (pago a plazos) según el estándar de la DGI, las notas de interés del emisor en el documento fiscal, y varias mejoras y endurecimientos del API de facturación. Todos los cambios son retrocompatibles: las integraciones existentes siguen funcionando sin modificaciones.

Nuevas funciones

Facturas a crédito (pago a plazos) Nuevo

Ahora puedes emitir facturas a crédito declarando el tiempo de pago y el detalle de las cuotas con su fecha de vencimiento:

Modo	Cómo funciona
Cuotas automáticas	Envías el objeto credit con el número de cuotas y el calendario (cada N días, o días fijos del mes como "el 15" o "el 15 y 30") y Solerba calcula los montos y fechas
Cuotas manuales	Defines cada cuota como un pago type: "PLAZO" con su monto y fecha de vencimiento

Las fechas se interpretan en hora de Panamá y aceptan formato "YYYY-MM-DD" o ISO 8601 con offset. El reparto automático divide el monto en cuotas iguales y asigna los centavos sobrantes a las primeras cuotas.

Ver la guía completa en .

Modo mixto no disponible

El modo Crédito (paymentTime: 2) está verificado contra el proveedor de facturación y listo para usarse. El modo Mixto (paymentTime: 3) aún no está disponible: el proveedor confirmó que la función está pendiente de implementación de su lado y por ahora rechaza las facturas mixtas.

Notas de interés Nuevo

El campo additionalData.infoInteres (hasta 5,000 caracteres) permite incluir una nota del emisor en cualquier factura: garantías, referencias a órdenes de compra, condiciones de entrega o cualquier aclaración comercial. La nota forma parte del documento fiscal y es visible para el receptor.

Creación de sucursales al vuelo Nuevo

Al crear una factura ahora puedes enviar el objeto branch completo (nombre, código DGI, dirección, coordenadas) en lugar de branchId, y la sucursal se crea automáticamente si aún no existe. Ver .

Envío de la factura a múltiples correos

El campo additionalData.emails permite indicar hasta 20 direcciones de correo a las que se envía la factura emitida.

Mejoras del API

Validación de datos fiscales del receptor

Para receptores Contribuyente (01), Gobierno (03) y Extranjero (04), el API ahora exige taxName, taxId, taxDv y taxIdType, tal como la documentación siempre lo indicó. Consumidor Final (02) no cambia. Se auditó el historial completo de facturación antes de aplicar el cambio: todas las integraciones activas ya envían estos campos.

Validaciones nuevas para crédito

Las facturas a crédito se validan antes de enviarse al proveedor, con errores 400 descriptivos:

• Cada cuota PLAZO requiere date con formato y fecha de calendario válidos
• Las cuotas deben sumar exactamente el total de la factura y venir en orden ascendente de fecha
• credit y cuotas PLAZO manuales son excluyentes
• El uso de crédito requiere additionalData.paymentTime 2 o 3 explícito
• Las notas de crédito (doctype: "04") no admiten cuotas

Documentación

• Sección nueva de con reglas, calendarios y ejemplos completos
• Catálogos nuevos en la : tiempo de pago (paymentTime) y forma de pago 01 (Crédito)
• Tabla del objeto client completada y corregida (campos opcionales, límites de longitud reales)
• Guías de y alineadas con el comportamiento real del API