Condición de Pago

Una Factura Electrónica describe cómo paga el cliente con una de dos formas excluyentes:

• condicionPago: un solo objeto para el caso simple, un medio de contado o un crédito con una entrega inicial opcional.
• pagos + credito: la forma completa. Admite varios medios de pago, datos de tarjeta o cheque y medios OTRO con descripción propia.

No combines ambas formas: una solicitud con condicionPago y pagos o credito recibe 400 validation-error.

Forma completa: pagos y credito

Cada pago

PAGO_BANCARIO sólo corresponde a una operación bancaria: informalo con indicadorPresencia: "OPERACION_BANCARIA".

tarjeta

Contado con varios medios

La suma de los pagos debe ser igual al total a pagar de la factura: no se admite un saldo pendiente en una operación al contado. Un saldo a pagar después corresponde a crédito. En guaraníes el total a pagar se redondea hacia abajo a múltiplos de 50 (107.437 se paga 107.400). En otras monedas el total no se redondea: se paga el total general exacto (30,75 USD se paga 30,75).

{
  "condicionOperacion": "CONTADO",
  "pagos": [
    { "tipoPago": "EFECTIVO", "monedaPago": "PYG", "montoPago": 60000 },
    {
      "tipoPago": "TARJETA_DE_DEBITO",
      "monedaPago": "PYG",
      "montoPago": 50000,
      "tarjeta": {
        "tipoTarjeta": "VISA",
        "formaProcesamientoPago": "POS",
        "ultimosCuatroDigitos": "4321"
      }
    }
  ]
}

Cuando todos los pagos están en la moneda de la operación, la suma se compara con el total general en esa moneda. Si algún pago está en otra moneda, la comparación se hace en guaraníes: cada pago se convierte con su tipoCambio y se compara con el total en guaraníes de la factura.

credito

{
  "condicionOperacion": "CREDITO",
  "pagos": [
    { "tipoPago": "CHEQUE", "monedaPago": "PYG", "montoPago": 20000,
      "cheque": { "numeroCheque": "1234567", "bancoCheque": "Banco Continental" } }
  ],
  "credito": {
    "condicionCredito": "CUOTA",
    "cuotas": 2,
    "detalleCuotas": [
      { "monto": 45000, "fechaVencimiento": "2026-11-18" },
      { "monto": 45000, "fechaVencimiento": "2026-12-18" }
    ]
  }
}

Forma simple: condicionPago

Los datos de tarjeta sólo se informan con TARJETA_DE_CREDITO o TARJETA_DE_DEBITO, y los de cheque sólo con CHEQUE; con otro tipoPago la respuesta es 400 en el campo enviado. Para informar los datos de la procesadora o más de un medio de pago, usá la forma completa.

Tipo de cambio del pago

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 tipoCambio en el pago. 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, en condicionPago y en credito. 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
  }
}

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

Entrega inicial

Una entrega positiva agrega tipoPago y monedaPago al mismo bloque de condicionPago, o se informa como pagos en la forma completa:

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

La entrega se expresa en la moneda de la operación y debe ser menor que el total: sin saldo financiado, la operación es CONTADO. CHEQUE también exige numeroCheque y bancoCheque.

Valores de tipoPago

Consultá enumeraciones para el listado completo y actualizado.

tipoTarjeta

tipoTarjeta y formaProcesamientoPago también se publican en /api/v1/public/enums.

Próximos pasos

• Modelo Factura Electrónica
• Enumeraciones SIFEN