Revertir movimiento
Revierte un anticipo o un reembolso de saldo a favor.
Descripción general
Este endpoint revierte un movimiento de saldo a favor: crea un movimiento reversal con el monto contrario al original. A partir de ese momento, el movimiento original responde con reversed: true.
Solo se pueden revertir anticipos (manualAdvance) y reembolsos (refundAdjustment). Los movimientos ligados a un pago (overpayment y applicationToInvoice) se revierten al cancelar o eliminar el pago relacionado, y una reversa no se puede revertir.
- Revertir un anticipo descuenta su monto del saldo a favor, así que requiere que el saldo disponible en esa moneda sea mayor o igual al monto del anticipo.
- Revertir un reembolso devuelve su monto al saldo a favor.
No lleva cuerpo. Requiere el permiso Administrar en Pagos.
Endpoint
https://app.credonix.mx/api/v1/credit-movements/{movementId}/reversePath param: movementId — ID del movimiento que se revierte.
Revierte un reembolso
Revierte un reembolso de -100.00: la respuesta es el nuevo movimiento reversal, no el original. Su amount es el monto original con signo contrario, reverses_movement_id apunta al reembolso y notes es "Reversa manual del movimiento de saldo a favor.". related_invoice_id y related_payment_id se copian del movimiento original.
Anticipo con saldo ya aplicado
Un anticipo de 500.00 cuyo saldo ya se aplicó en parte a una orden de cobro: el saldo disponible en MXN es menor al monto del anticipo, así que la API responde 409 y no registra nada.
Errores
| Status | Código | Causa |
|---|---|---|
401 | — | API key ausente, inválida o revocada. |
403 | INSUFFICIENT_PERMISSIONS | La API key no tiene el permiso Administrar en Pagos. |
404 | CREDIT_MOVEMENT_NOT_FOUND | El movimiento no existe o no pertenece a la organización. |
409 | CREDIT_MOVEMENT_NOT_REVERSIBLE | El movimiento es overpayment, applicationToInvoice o reversal. Para revertirlo, cancela el pago relacionado desde la orden de cobro. |
409 | CREDIT_MOVEMENT_ALREADY_REVERSED | Este movimiento ya fue revertido. |
409 | CREDIT_REVERSAL_CONFLICT | Al revertir un anticipo, el saldo a favor disponible es menor al monto del anticipo porque ya fue aplicado o devuelto. |