Preguntas Frecuentes
Archivo de saldos
¿El archivo debe contener todas las cuentas o solo las que cambiaron?
Ambas opciones son válidas. Se pueden enviar todas las cuentas o solo las que tuvieron cambios. InvWallet compara cada saldo con el anterior y solo genera órdenes donde detecta diferencias. Las cuentas sin cambios simplemente se ignoran en el procesamiento.
¿Cómo verifico que mi archivo de saldos se procesó correctamente?
Después de enviar el archivo, consultá el endpoint de nóminas (GET /v1/paysheets/?file_id={file_id}). Si la nómina se generó con órdenes, el archivo fue procesado correctamente. Si viene vacía, puede deberse a que:
- Los saldos informados son iguales a los que InvWallet ya tiene registrados (no hay diferencia, no hay operación).
- El archivo fue enviado pero no se ejecutó el paso de procesamiento (
POST /v1/files/{file_id}/process/). - Hubo errores de validación en las filas del archivo.
¿Qué pasa si envío un archivo duplicado?
Si se envía un archivo con el mismo file_id, será rechazado. Ante un error de red, se recomienda verificar primero si el archivo ya fue recibido antes de reenviar.
¿Puedo reenviar un archivo si el anterior falló?
Sí, siempre que el nuevo archivo tenga un file_id diferente. InvWallet rechaza archivos con IDs duplicados. Si el primer archivo tuvo errores, generá uno nuevo con las correcciones y envialo normalmente.
¿Puedo separar suscripciones y retiros en archivos distintos?
Sí. Usando el sufijo BALANCETYPE en el nombre del archivo (SUS, RES, RES_TOT) se controla qué tipo de operaciones se procesan. Esto permite armar puntos de validación del lado de la Wallet para controlar las nóminas de forma independiente.
¿Qué es RES_TOT?
Indica que el archivo solo procesará retiros totales, es decir, cuentas que retiran el 100% de su inversión. A diferencia de RES (retiros parciales), RES_TOT liquida la posición completa del cliente en el fondo.
¿Hay un límite de tamaño para el archivo de saldos?
El límite es de 50 MB. Si el archivo supera este tamaño, se recomienda dividirlo por tipo de operación (SUS/RES/RES_TOT) para reducir el volumen.
Rendimientos
¿Cada cuánto se generan los rendimientos?
Los rendimientos se generan cada día hábil, una vez que el Asset Manager informa el precio del fondo (VCP).
¿A qué hora están disponibles los rendimientos?
Depende del horario en que el fondo informa el VCP (Valor Cuota Parte) provisorio. Generalmente es entre las 11:00 y 12:00 hs, pero varía por fondo. Una vez que InvWallet recibe el VCP, calcula los rendimientos y los deja disponibles para consulta. El horario exacto se confirma durante la configuración del fondo.
¿Qué pasa si no proceso los rendimientos antes de enviar el archivo de saldos?
InvWallet ya asignó internamente los rendimientos a cada cuenta. Si la Wallet no los procesa y envía saldos sin actualizar, InvWallet detectará una diferencia negativa entre el saldo informado y el saldo interno, y generará retiros innecesarios por esos montos.
Nóminas
¿Cuáles son los estados posibles de una nómina?
| Estado | Descripción |
|---|---|
| Pendiente | Nómina generada, esperando pago de la Wallet |
| Enviada | Nómina enviada al Asset Manager |
| Completa | Estado final para suscripciones. El AM procesó y confirmó la operación |
| Pago Instruido | Estado para retiros. El AM instruyó el pago al cliente. Cuando la Wallet confirma la recepción, pasa a Completa |
| Fallida | La nómina no pudo ser procesada |
¿El pago de suscripciones es por orden individual o por nómina?
Siempre por nómina. InvWallet agrupa todas las órdenes de suscripción en una nómina global. La Wallet debe consultar la nómina para conocer el monto total a transferir y realizar un único pago por ese total. No se deben pagar órdenes individualmente.
Varias integraciones intentaron enviar la confirmación de pago orden por orden usando el endpoint de registro de pago individual. Esto no es correcto para el flujo de saldos — se debe usar el endpoint de pago de nómina.
¿A qué cuenta transfiero para las suscripciones?
La cuenta de destino depende de la configuración con el AM. La transferencia va directamente a la Cuenta del Asset Manager. Los datos bancarios se definen durante la etapa de onboarding.
¿Qué pasa si la Wallet no transfiere los fondos a tiempo?
La nómina de suscripción queda en estado Pendiente. No se envía al Asset Manager hasta que el AM confirme la recepción de los fondos. Si la Wallet no transfiere, la nómina no avanza.
¿La nómina puede fallar y quedar en un estado intermedio?
Sí. Si la nómina falla durante el procesamiento, queda en un estado intermedio para revisión. Se recomienda consultar las órdenes fallidas del día (/api/v1/orders?status=7) para identificar y corregir los problemas.
Transferencias
¿La transferencia es en globo o individual por cliente?
Se define entre el AM y la Wallet. Se recomienda transferencia en globo (un solo monto por la suma total de la nómina) por simplicidad y menor costo operativo. Sin embargo, también es posible hacerlo de forma individual por cuenta.
Órdenes
¿Qué pasa con las órdenes fallidas?
Las órdenes que terminan en estado Fallida no se incluyen en las nóminas. Esto puede causar una discrepancia entre el monto que la Wallet calculó internamente y el monto que InvWallet determina en la nómina. Se recomienda consultar las órdenes fallidas diariamente y corregir la situación que las provocó (falta de documentación, cuenta bloqueada, límite de suscripción alcanzado, etc.).
¿Existen diferencias de redondeo?
Sí. Todos los montos se manejan con un redondeo de 2 decimales, por lo que puede surgir una diferencia mínima de $0,01.
¿Cuál es el estado final de una orden de retiro?
El flujo de una orden de retiro es: Lista para enviar → Enviada al AM → Cubierta (fitted) → Pago Instruido. El estado Pago Instruido indica que el AM instruyó el pago. La Wallet debe confirmar la recepción del dinero usando el endpoint de registro de pago de retiros, y recién ahí la orden pasa a Completa.
¿Por qué la cuenta me dice "no está lista para operar"?
El error "La cuenta no está lista para operar (estado: open, adeuda archivos)" aparece cuando la cuenta fue creada pero no se completó la validación de cuenta (POST /v1/accounts/{account_id}/validate/). Este paso confirma la asignación de archivos regulatorios a la cuenta. Sin validación, la cuenta puede suscribir pero no puede retirar.
Horarios operativos
¿Cuáles son los horarios operativos típicos?
Los horarios dependen del fondo y se definen contractualmente, pero una referencia típica para fondos Money Market es:
| Evento | Horario orientativo |
|---|---|
| Disponibilización de rendimientos (VCP provisorio) | 11:00 - 12:00 hs |
| Horario de corte (recepción de archivos y transferencias) | 14:00 hs |
| Envío de nóminas al AM | 14:30 hs |
| Disponibilización de liquidación | 16:30 hs |
| Actualización de tenencias | 21:00 hs |
Estos horarios son orientativos. Los horarios definitivos se confirman durante el onboarding con el AM y pueden variar según el fondo.
Tiempos de liquidación
¿Cuánto tarda la liquidación?
Depende del tipo de fondo:
- Fondos Money Market: liquidación T+0 (mismo día hábil).
- Otros fondos: liquidación T+1 o superior, según el reglamento de gestión de cada fondo.
Los tiempos específicos se definen durante la configuración del fondo con el AM.
Sandbox
¿Cuáles son los pasos para simular el flujo completo en Sandbox?
En sandbox, algunos pasos que en producción son automáticos deben ejecutarse manualmente:
- Crear cuenta y validar —
POST /v1/accounts/+POST /v1/accounts/{id}/validate/ - Enviar archivo de saldos —
POST /v1/files/+POST /v1/files/{id}/process/ - Generar nóminas —
POST /v1/paysheets/sandbox_generate_paysheets/ - Validar nóminas —
POST /v1/paysheets/sandbox_validate_paysheets/ - Simular pago de suscripción —
POST /v1/orders/{id}/simulate_payment/ - Procesar nóminas —
POST /v1/paysheets/sandbox_process_paysheets/ - Consultar órdenes —
GET /v1/orders/ - Confirmar pago de retiros —
POST /v1/orders/register_payment/
En producción, los pasos 3, 4 y 6 son automáticos según los horarios configurados. El paso 5 se reemplaza por la transferencia bancaria real.