API Condiciones de Pago

Esta API permite gestionar condiciones de pago utilizadas en la empresa para definir plazos, cuotas, recargos y vencimientos. Su objetivo es exponer la parametrización funcional de las condiciones de pago para su uso en procesos comerciales, financieros y de integración.

La funcionalidad asociada en el sistema se encuentra en Configuración > Condiciones de Pago.

Casos de uso

  • Consultar condiciones de pago configuradas en la empresa.
  • Crear nuevas condiciones de pago.
  • Modificar parámetros de cuotas, vencimientos y recargos.
  • Sincronizar condiciones de pago con sistemas externos.

Endpoint del servicio

Método Query

Permite obtener un listado paginado de condiciones de pago configuradas en la empresa.

Requisitos previos

  • Contar con acceso habilitado a la API.
  • Definir el rango de códigos a consultar.

Parámetros de entrada

ParámetroTipoObligatorioDescripción
CodigoDesdeT(3)Código inicial del rango de condiciones de pago a consultar.
CodigoHastaT(3)Código final del rango de condiciones de pago a consultar.
NombreContieneT(20)NoTexto a buscar dentro del nombre de la condición de pago.
PageN(2)Número de página a consultar.

Estructura del request

CodigoDesde
CodigoHasta
NombreContiene
Page

Estructura del response

Codigo
Nombre
CuotasIguales
CantidadCuotas
Desde
PorcentajeRecargo
VencimientoDias
VencimientoMes
SeparacionDias
SeparacionMes
DecimalesCuota1

Campos devueltos

CampoDescripción
CodigoCódigo de la condición de pago.
NombreNombre de la condición de pago.
CuotasIgualesIndica si las cuotas se calculan en importes iguales.
CantidadCuotasCantidad de cuotas definidas para la condición.
DesdeParámetro de referencia utilizado para el cálculo de vencimientos.
PorcentajeRecargoPorcentaje de recargo aplicado a la condición.
VencimientoDiasCantidad de días para el vencimiento.
VencimientoMesParámetro mensual asociado al vencimiento.
SeparacionDiasCantidad de días entre cuotas.
SeparacionMesSeparación mensual entre cuotas.
DecimalesCuota1Indica el criterio aplicado a decimales en la primera cuota.

Ejemplo de request

{
  "CodigoDesde": "001",
  "CodigoHasta": "999",
  "NombreContiene": "",
  "Page": 1
}

Ejemplo de response

[
  {
    "Codigo": "001",
    "Nombre": "30 días",
    "CuotasIguales": "S",
    "CantidadCuotas": 1,
    "Desde": "F",
    "PorcentajeRecargo": 0.00,
    "VencimientoDias": 30,
    "VencimientoMes": 0,
    "SeparacionDias": 0,
    "SeparacionMes": 0,
    "DecimalesCuota1": "S"
  }
]

Método Save

Permite crear o actualizar una condición de pago.

Al actualizar una condición de pago, los campos que no se envían en el payload no conservan automáticamente su valor anterior.

El sistema toma como referencia únicamente la información recibida. Por este motivo, los campos que no se incluyen en  la solicitud quedan sin valor.

Por lo tanto, al realizar una actualización, es necesario enviar también los datos que se desean conservar.

Parámetros de entrada

CampoTipoObligatorioDescripción
CodigoT(3)Código de la condición de pago.
NombreT(30)Nombre de la condición de pago.
CuotasIgualesT(1)Indica si las cuotas son iguales.
CantidadCuotasN(2)Cantidad de cuotas.
DesdeT(1)NoReferencia base para cálculo de vencimientos.
PorcentajeRecargoN(3.2)NoPorcentaje de recargo.
VencimientoDiasN(4)NoDías hasta el vencimiento.
VencimientoMesN(4)NoParámetro mensual de vencimiento.
SeparacionDiasN(4)NoDías de separación entre cuotas.
SeparacionMesN(4)NoSeparación mensual entre cuotas.
DecimalesCuota1T(1)NoCriterio de decimales aplicado a la primera cuota.

Resultado

Succeed
Error
Mensaje

Observaciones

  • Los parámetros CodigoDesde, CodigoHasta y Page son obligatorios en el método Query.
  • La API expone la configuración de condiciones de pago y permite su mantenimiento.
  • La definición de cuotas, vencimientos y recargos impacta directamente en procesos comerciales y financieros.

Consideraciones de integración

  • Se recomienda consumir esta API como fuente de parametrización para comprobantes, ventas, compras y cuentas corrientes.
  • Persistir localmente las condiciones de pago si otros procesos dependen de ellas.
  • Validar previamente la lógica de cuotas y vencimientos antes de automatizar cálculos externos.
  • Controlar el impacto de cambios en recargos y vencimientos sobre procesos ya integrados.
Compartir

API Condiciones de Pago

O copia el enlace

CONTENIDO