Condición de Pago

Schema de la condición de pago — contado con medio de pago o crédito con cuotas.

El objeto condicionPago describe cómo paga el cliente una Factura Electrónica. Es obligatorio tanto para condicionOperacion = CONTADO como para condicionOperacion = CREDITO, y su campo tipo debe coincidir con esa condición.

Schema

Campo	Tipo	Requerido	Descripción
`tipo`	`enum`	Sí	`CONTADO` o `CREDITO`; debe coincidir con `condicionOperacion`
`tipoPago`	`enum`	Para `CONTADO` y para crédito con entrega inicial	Medio de pago — ver tabla abajo
`monedaPago`	`enum`	Para `CONTADO` y para crédito con entrega inicial	Moneda del pago; en una entrega inicial debe coincidir con `monedaOperacion`
`tipoCambio`	`number`	Condicional	Obligatorio cuando `monedaPago` no es `PYG`; no se informa para pagos en `PYG`
`montoPago`	`number`	Sí para `CONTADO`	Monto pagado; si `monedaPago` coincide con `monedaOperacion`, debe ser igual al total de la operación. No se informa para `CREDITO`
`numeroCheque`	`string`	Sí para `tipoPago = CHEQUE`	Número del cheque
`bancoCheque`	`string`	Sí para `tipoPago = CHEQUE`	Banco emisor del cheque
`tipoTarjeta`	`enum`	No (sólo tarjetas)	Denominación de la tarjeta. Si no se informa, se asume `OTRO`
`formaProcesamientoPago`	`enum`	No (sólo tarjetas)	Forma de procesamiento. Si no se informa, se asume `OTRO`
`condicionCredito`	`enum`	Sí para `CREDITO`	Modalidad: `PLAZO` o `CUOTA`
`plazoCredito`	`string`	Una alternativa para `PLAZO`	Texto libre de 2 a 15 caracteres. No genera un vencimiento calculable.
`plazoEstructurado`	`object`	Una alternativa para `PLAZO`	`{ "cantidad": 30, "unidad": "DIAS" }`; cantidad entera de 1 a 9999, unidad `DIAS` o `MESES`.
`cuotas`	`integer`	Sí para `CUOTA`	Cantidad, entre 1 y 999; debe coincidir con `detalleCuotas.length`
`detalleCuotas`	`array`	Sí para `CUOTA`	Un detalle por cuota; cada monto es positivo y la fecha es opcional
`montoEntregaInicial`	`number`	No (sólo `CREDITO`)	Entrega inicial; `null` o `0` significa que no hay entrega

Pago con tarjeta

tipoTarjeta y formaProcesamientoPago sólo aplican cuando tipoPago es TARJETA_DE_CREDITO o TARJETA_DE_DEBITO, tanto al contado como en una entrega inicial a crédito. Si omitís uno de estos campos, se asume OTRO para ese campo. Estos valores no se incluyen en /api/v1/public/enums.

tipoTarjeta

Valor	Descripción
`VISA`	Visa
`MASTERCARD`	Mastercard
`AMERICAN_EXPRESS`	American Express
`MAESTRO`	Maestro
`PANAL`	Panal
`CABAL`	Cabal
`OTRO`	Otro

formaProcesamientoPago

Valor	Descripción
`POS`	POS
`PAGO_ELECTRONICO`	Pago Electrónico
`OTRO`	Otro

Tipo de cambio del pago

condicionPago.tipoCambio describe la conversión de la moneda del pago y se valida independientemente del tipo de cambio GLOBAL o POR_ITEM de la operación. Debe ser positivo, menor que 99999.9999 y admitir como máximo 4 decimales.

{
  "condicionPago": {
    "tipo": "CONTADO",
    "tipoPago": "TRANSFERENCIA",
    "monedaPago": "USD",
    "tipoCambio": 7130.5000,
    "montoPago": 30.75
  }
}

Una operación en USD pagada en PYG no lleva condicionPago.tipoCambio. Un pago en USD sí lo requiere, aunque ya hayas informado la cotización de la operación. Ver Facturar en Moneda Extranjera.

Modalidades de crédito

PLAZO y CUOTA son ramas excluyentes. Para PLAZO enviá exactamente uno de plazoCredito o plazoEstructurado. No envíes cuotas ni detalleCuotas con PLAZO, ni ningún plazo con CUOTA. El plazo estructurado produce el texto (30 días o 2 meses) y una fecha desde la fecha efectiva de emisión. Los meses se suman como meses calendario y se ajustan al último día del mes.

{
  "condicionPago": {
    "tipo": "CREDITO",
    "condicionCredito": "PLAZO",
    "plazoCredito": "30 días",
    "montoEntregaInicial": 0
  }
}

También se puede emitir con vencimiento calculable:

{
  "condicionPago": {
    "tipo": "CREDITO",
    "condicionCredito": "PLAZO",
    "plazoEstructurado": { "cantidad": 30, "unidad": "DIAS" }
  }
}

plazoCredito se envía como texto libre y no se interpreta como una fecha.

Entrega inicial

Una entrega positiva agrega tipoPago y monedaPago al mismo bloque:

{
  "condicionPago": {
    "tipo": "CREDITO",
    "condicionCredito": "PLAZO",
    "plazoCredito": "30 días",
    "tipoPago": "TRANSFERENCIA",
    "monedaPago": "PYG",
    "montoEntregaInicial": 20000
  }
}

La entrega no puede superar el total fiscal de los ítems. CHEQUE también exige numeroCheque y bancoCheque. PAGO_BANCARIO no está admitido para la entrega inicial.

Toda Factura Electrónica a crédito debe usar monedaOperacion: "PYG". La API devuelve 400 validation-error para crédito en otra moneda, antes de reservar la secuencia.

Valores comunes de `tipoPago`

Valor	Descripción
`EFECTIVO`	Pago en efectivo
`CHEQUE`	Cheque
`TARJETA_DE_CREDITO`	Tarjeta de crédito
`TARJETA_DE_DEBITO`	Tarjeta de débito
`TRANSFERENCIA`	Transferencia bancaria
`GIRO`	Giro u orden de pago
`BILLETERA_ELECTRONICA`	Billetera electrónica
`TARJETA_EMPRESARIAL`	Tarjeta empresarial
`PAGO_MOVIL`	Pago móvil
`OTRO`	Otros medios no contemplados

Consultá enumeraciones para el listado completo y actualizado.

Ejemplo — Pago contado en efectivo

{
  "condicionPago": {
    "tipo": "CONTADO",
    "tipoPago": "EFECTIVO",
    "monedaPago": "PYG",
    "montoPago": 110000
  }
}