> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rocky.global/llms.txt
> Use this file to discover all available pages before exploring further.

# Conceptos clave: inscripciones y órdenes

> Diferencia entre inscripciones y órdenes, estados de pago, historial de cambios y transferencias.

Antes de operar el panel de organizador conviene entender cómo Rocky Global modela las inscripciones, las órdenes de pago y su historial.

## Inscripciones vs. órdenes

| Concepto        | Qué es                                                                                                                      | Ejemplos                                                                     |
| --------------- | --------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| **Inscripción** | Registro principal del participante en el evento. Tiene un **localizador** único que no cambia.                             | Juan Pérez inscrito en Oceanman 5K                                           |
| **Orden**       | Transacción de pago vinculada a una inscripción (o a una compra de tienda). Una inscripción puede tener **varias órdenes**. | Tarifa inicial, compra de hoodie, cambio de distancia, servicios adicionales |

### Regla operativa

Mientras la inscripción esté en estado **OK**, el atleta está **oficialmente inscrito**, aunque alguna orden complementaria (tienda, cambio de tarifa, extras) siga **pendiente** de pago.

Ejemplo típico:

1. Orden #1001 — tarifa 5K — **APPROVED** → inscripción **OK**.
2. Orden #1045 — hoodie oficial — **PENDING** → el atleta sigue inscrito; solo falta pagar el producto.
3. Orden #1089 — cambio a 10K — **PENDING** → la inscripción pasa temporalmente a **CR** hasta que se apruebe el pago del cambio.

Ver el detalle de órdenes en [Órdenes](/roles/organizador/finanzas-liquidacion/ordenes).

## Estados de pago de las órdenes

| Estado                   | Significado                                                                                       |
| ------------------------ | ------------------------------------------------------------------------------------------------- |
| **APPROVED**             | Pago exitoso en la pasarela (Redsys o Stripe).                                                    |
| **OK**                   | Orden sin cobro (100 % de descuento o cortesía). Cuenta como pagada.                              |
| **FAILED**               | Problemas con la pasarela: tarjeta rechazada, fondos insuficientes o transacción declinada.       |
| **PENDING**              | El usuario llegó al checkout pero no completó el pago, o hay un cambio de tarifa esperando cobro. |
| **PARTIALLY\_CANCELLED** | Reembolso parcial aplicado; la orden conserva el saldo no reembolsado.                            |
| **CANCELADO**            | Orden anulada por reembolso total o cancelación administrativa.                                   |

<Info>
  En el detalle de cada inscripción verás el listado de todas sus órdenes con su estado, monto e ítems. Desde **Finanzas → Órdenes** puedes consultar el listado global del evento.
</Info>

## Estados de la inscripción

| Código        | Significado                                                                                                                                                |
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **OK**        | Inscripción confirmada con al menos una orden pagada.                                                                                                      |
| **CR**        | *Change Rate* (cambio de tarifa). Hay un cambio de distancia/tarifa **pendiente de pago**. El atleta sigue inscrito si ya tenía una orden aprobada previa. |
| **PENDING**   | Inscripción creada pero sin pago aprobado de la orden principal.                                                                                           |
| **CANCELADO** | Inscripción anulada.                                                                                                                                       |

## Cronología de cambios e historial

### Código CR en el historial

Cuando un atleta solicita un **cambio de tarifa**, la inscripción pasa a estado **CR** hasta que la nueva orden sea aprobada. En el detalle de la inscripción verás:

* La tarifa activa actual.
* Las órdenes asociadas (inicial, de cambio, tienda, etc.).
* Notas de auditoría indicando cuándo se inició el cambio y qué orden quedó pendiente.

Tras aprobarse el pago del cambio, la inscripción vuelve a **OK** con la nueva tarifa aplicada.

### Transferencias de cupo

Al **transferir** una inscripción a otro atleta:

* El **localizador original no cambia**. Permanece el mismo código que aparece en comprobantes, QR y dorsal.
* Cambia el titular (`user_id`) y se registra la transferencia en el **historial de transferencias** del detalle de inscripción (fecha, remitente, destinatario, quién ejecutó la acción).

Esto permite rastrear toda la cronología si un atleta presenta un comprobante físico antiguo para reclamar un cupo que ya transfirió: el localizador sigue siendo el mismo, pero el historial muestra al titular actual.

<Warning>
  Un participante solo puede transferir su propia inscripción **una vez** desde el autoservicio del atleta. El organizador puede ejecutar transferencias adicionales desde el panel si tiene permiso.
</Warning>

## Diagrama de relación

```mermaid theme={null}
flowchart TD
    R[Inscripción\nlocalizador fijo] --> O1[Orden 1: tarifa inicial]
    R --> O2[Orden 2: tienda / extras]
    R --> O3[Orden 3: cambio de tarifa]
    O1 -->|APPROVED| OK[Inscripción OK]
    O3 -->|PENDING| CR[Inscripción CR]
    O3 -->|APPROVED| OK
```

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Órdenes del evento" icon="receipt" href="/roles/organizador/finanzas-liquidacion/ordenes">
    Listado completo de transacciones.
  </Card>

  <Card title="Editar inscripción" icon="pen-to-square" href="/roles/organizador/gestion-participantes/editar-inscripcion">
    Cambios manuales desde el panel.
  </Card>
</CardGroup>
