Nóminas y Transferencia

Una vez que las órdenes son creadas por la Wallet, InvWallet las agrupa en nóminas según el fondo y tipo de operación. La Wallet debe consultar estas nóminas para conocer el monto a transferir.

Consulta de nóminas

Método: GET
URL: /api/v1/paysheets/

La respuesta incluye las nóminas generadas con el detalle de cada una:

{
    "count": 1,
    "results": [
        {
            "paysheet_by_fund_class_id": "pyfc_JjOKVsZrJpVVYyhHk",
            "fund_class_name": "B",
            "amount": "123450.60",
            "side": "buy",
            "status_detail": "Pendiente",
            "paid": false
        }
    ]
}

Error común — Pago por orden individual

El pago de suscripciones siempre se realiza por nómina, no por orden individual. La Wallet debe consultar la nómina y realizar un único pago por el total indicado en amount.

Circuito de pago

1. La Wallet consulta las nóminas para conocer el monto total a transferir.
2. La Wallet transfiere los fondos al ACDI/AM. La transferencia puede ser en globo (recomendado) o individual. El modo se define entre el ACDI/AM y la Wallet.
3. El ACDI/AM marca la nómina como pagada (paid: true).
4. El ACDI/AM envía la nómina a la Sociedad Gerente para su ejecución.

Importante

La nómina no se envía a la Sociedad Gerente hasta que el ACDI/AM confirme la recepción de los fondos.

Estados de las nóminas

Estado	Descripción
Pendiente	Nómina generada, esperando pago de la Wallet
Enviada	Nómina enviada a la Sociedad Gerente / Asset Manager
Completa	Estado final para suscripciones. La SG procesó y confirmó la operación
Pago Instruido	Estado para rescates. El AM/ACDI instruyó el pago al cliente. Cuando la Wallet confirma la recepción, pasa a Completa
Fallida	La nómina no pudo ser procesada

Simulación en Sandbox

En sandbox, los procesos de nóminas que en producción son automáticos deben ejecutarse manualmente:

1. Generar nóminas — POST /v1/paysheets/sandbox_generate_paysheets/
2. Validar nóminas — POST /v1/paysheets/sandbox_validate_paysheets/
3. Simular pago de suscripción — POST /v1/orders/{id}/simulate_payment/
4. Procesar nóminas — POST /v1/paysheets/sandbox_process_paysheets/

info

En producción, los pasos 1, 2 y 4 son automáticos según los horarios configurados. El paso 3 se reemplaza por la transferencia bancaria real.