Revisión manual y devoluciones

Estado documental: Contrato propuesto. YUPY organiza y da seguimiento a las devoluciones; la empresa conserva la decisión y la ejecución financiera.

Cuándo se requiere revisión manual

Puede ser necesaria ante:

• ambigüedad;
• pago tardío;
• diferencia;
• constancia contradictoria;
• ingreso posterior a cancelación;
• múltiples posibilidades;
• reclamo;
• falta de información;
• devolución;
• error operativo.

Bandeja de revisión

Debe mostrar, según permisos:

• orden;
• información financiera relacionada;
• montos;
• fechas;
• cuenta receptora;
• información coincidente;
• información contradictoria;
• constancias;
• datos extraídos de la evidencia;
• historial;
• responsable;
• acción sugerida;
• estado.

Principio de resolución

La revisión manual no reemplaza la evidencia financiera. Permite decidir cómo tratar comercial y operativamente un caso cuyo resultado no puede automatizarse con seguridad.

Acciones de revisión

confirmar conciliación
mantener pendiente
solicitar evidencia
aceptar pago tardío
rechazar operación comercial
crear orden complementaria
crear caso de devolución
cerrar sin coincidencia financiera

Pagos incompletos

monto esperado: S/ 85.50
monto recibido: S/ 80.00
faltante: S/ 5.50

YUPY puede crear una solicitud complementaria vinculada.

orden original
    └── orden complementaria por S/ 5.50

La orden original no debe alterarse silenciosamente.

Pagos en exceso

monto esperado: S/ 85.50
monto recibido: S/ 90.00
exceso: S/ 4.50

YUPY puede identificar la necesidad de devolución y crear un caso.

Responsabilidad de devolución

Estados

refund_identified
refund_requested
refund_under_review
refund_approved
refund_pending_execution
refund_completed
refund_rejected
refund_failed
refund_cancelled

refund_approved
≠ refund_completed

Registrar ejecución

Ejemplo conceptual:

{
  "result": "success",
  "amount": "4.50",
  "currency": "PEN",
  "executed_at": "2026-07-20T16:10:00-05:00",
  "external_reference": "DEV-884120",
  "evidence_id": "evi_ref_01JXYZ"
}

Intento fallido:

{
  "result": "failed",
  "amount": "4.50",
  "currency": "PEN",
  "failure_reason": "recipient_data_not_available"
}

Evidencia de devolución

Puede incluir:

• constancia;
• referencia bancaria;
• fecha;
• monto;
• destinatario;
• usuario que ejecutó;
• comentario;
• archivo adjunto.

YUPY registra la evidencia. No debe afirmar que verificó automáticamente la devolución si todavía no existe una fuente financiera que lo confirme.

Webhooks relacionados

Los siguientes ejemplos reutilizan los nombres y el sobre canónico documentados en API y Webhooks.

refund.identified

{
  "event_id": "evt_01J011",
  "event_type": "refund.identified",
  "event_version": "1.0",
  "created_at": "2026-07-20T15:20:00-05:00",
  "data": {
    "yupy_transaction_id": "ypt_01JXYZ",
    "external_transaction_id": "ORDER-10482",
    "refund_case_id": "rfc_01JXYZ",
    "amount_to_refund": "4.50",
    "currency": "PEN",
    "reason": "overpayment",
    "refund_executor": "client_company",
    "state": {
      "refund": "refund_identified"
    }
  }
}

refund.pending_execution

{
  "event_id": "evt_01J012",
  "event_type": "refund.pending_execution",
  "event_version": "1.0",
  "created_at": "2026-07-20T15:25:00-05:00",
  "data": {
    "yupy_transaction_id": "ypt_01JXYZ",
    "external_transaction_id": "ORDER-10482",
    "refund_case_id": "rfc_01JXYZ",
    "amount_to_refund": "4.50",
    "currency": "PEN",
    "state": {
      "refund": "refund_pending_execution"
    }
  }
}

refund.completed

Se emite cuando la empresa registra la ejecución y YUPY acepta la evidencia correspondiente.

{
  "event_id": "evt_01J013",
  "event_type": "refund.completed",
  "event_version": "1.0",
  "created_at": "2026-07-20T16:10:00-05:00",
  "data": {
    "yupy_transaction_id": "ypt_01JXYZ",
    "external_transaction_id": "ORDER-10482",
    "refund_case_id": "rfc_01JXYZ",
    "refunded_amount": "4.50",
    "currency": "PEN",
    "executed_by": "client_company",
    "state": {
      "refund": "refund_completed"
    }
  }
}

Auditoría

Cada caso debe registrar:

• origen;
• orden;
• información financiera relacionada;
• razón;
• monto;
• responsable;
• aprobación;
• rechazo;
• intentos;
• evidencia;
• referencia externa;
• fecha de ejecución;
• resultado;
• notas;
• cambios de estado.

Criterios de aceptación

1. La revisión manual requiere autorización.
2. La resolución conserva la información utilizada.
3. Los faltantes pueden generar una orden complementaria.
4. Los excesos pueden generar un caso de devolución.
5. YUPY no ejecuta devoluciones.
6. La empresa registra cada intento.
7. Aprobado y completado son estados distintos.
8. La evidencia queda asociada.
9. Los casos aparecen en alertas y reportes.
10. Toda decisión conserva auditoría.