Pagos y notas de crédito

Complementos de pagoCopiar enlace a esta sección

Una factura PPD (a crédito o en parcialidades) se cobra con un complemento de pago (CFDI tipo P) por cada pago que recibe. El SAT pide timbrarlo a más tardar el quinto día natural del mes siguiente al del pago.

Usted solo dice qué facturas paga y cuánto de cada una. Fiscalisto calcula el número de parcialidad, el saldo anterior y el insoluto, y los impuestos de cada factura en proporción.

curl https://api.fiscalisto.com/v1/payments \
  -H "Authorization: Bearer $FISCALISTO_API_KEY" \
  -H "Idempotency-Key: pago-SPEI-2026102400123" \
  -H "Content-Type: application/json" \
  -d '{
    "payment_form": "03",
    "operation_number": "SPEI-2026102400123",
    "documents": [{ "invoice": "inv_OufpKqnrvx9p0Nfbydl9jG4UNGeTYcvdrg", "amount": 2900 }],
    "send_email": true
  }'

• documents acepta hasta 100 facturas del mismo cliente, por su id o su UUID. amount es lo que se paga de cada una, en la moneda de la factura. Solo se pueden pagar facturas timbradas con la API.
• Sin date, el pago es de hoy. Si se lo pagaron otro día, mande date (2026-10-20).
• Si la factura es en dólares y le pagaron en pesos, el pago va en MXN y cada documento lleva amount en dólares (lo que se abona a la factura) y received en pesos (lo que le llegó por ella). Si le pagaron en dólares, mande currency: "USD" y el exchange_rate del día del pago.
• Si amount es mayor que el saldo de la factura, no se timbra: el error dice el saldo que queda.
• Si el pago es un depósito que mandó a Conciliación bancaria, mande bank_transaction (btx_…): el complemento lleva la fecha del depósito y lo deja conciliado.

La respuesta es un objeto invoice de type: "P", con payment (forma, fecha, monto y cada documento con su parcialidad y saldos). Cada factura pagada baja su amount_due y llega invoice.partially_paid o invoice.paid (Cuentas por cobrar).

Notas de créditoCopiar enlace a esta sección

Un descuento, una bonificación o una devolución sobre una factura ya timbrada va en una nota de crédito (CFDI tipo E) relacionada a ella. amount es antes de impuestos: Fiscalisto aplica el IVA y las retenciones de la factura en la misma proporción.

curl https://api.fiscalisto.com/v1/credit_notes \
  -H "Authorization: Bearer $FISCALISTO_API_KEY" \
  -H "Idempotency-Key: descuento-A-1042" \
  -H "Content-Type: application/json" \
  -d '{
    "invoice": "inv_OufpKqnrvx9p0Nfbydl9jG4UNGeTYcvdrg",
    "amount": 500,
    "description": "Descuento por pronto pago",
    "payment_form": "03"
  }'

Por omisión la relación es 01 (nota de crédito); para una devolución de mercancía mande "relationship": "03". Si la factura es PPD y todavía no se paga, una nota de crédito reduce su saldo para los complementos de pago siguientes.

AnticiposCopiar enlace a esta sección

Si el cliente le paga antes de saber qué va a comprar, timbre la factura del anticipo con POST /v1/advances (amount es lo que pagó, con IVA). Cuando se entregue lo vendido, POST /v1/advances/{id}/apply timbra la factura de la venta relacionada al anticipo, con cualquiera de las dos opciones del SAT: con "method": "egreso" además una nota de crédito por lo anticipado; con "method": "remanente" la factura solo por lo que falta pagar.