Nóminas y Transferencia

Una vez enviadas las órdenes en batch, InvWallet las agrupa en nóminas por fondo y tipo de operación. La Wallet debe consultar estas nóminas para conocer el monto total a transferir.

Consulta de nóminas

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

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

Buena práctica

En vez de realizar transferencias individuales por orden, se recomienda generar un único pago en globo por el total de la nómina (amount). Esto reduce costos operativos y simplifica la conciliación.

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 retiros. 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. Procesar nóminas — POST /v1/paysheets/sandbox_process_paysheets/

info

En producción, los pasos 1 y 2 son automáticos según los horarios configurados. La transferencia de fondos la realiza la Wallet de forma real.