Backoffice - Guide

El Back Office de API Broker es una herramienta web disponible para los equipos operativos del partner. Permite consultar en tiempo real el estado de los usuarios, sus cuentas comitentes, carteras, activos, operaciones y movimientos, sin necesidad de interactuar directamente con la API.

Está pensada para roles de operaciones, atención al cliente y compliance que necesitan visibilidad sobre la actividad de los usuarios finales del día a día.

Acceso: las credenciales del Back Office son configuradas por API Broker durante el proceso de integración. Si necesitás acceso para tu equipo, solicitalo a tu oficial de cuenta.

¿Para qué lo usa tu equipo?

El Back Office es el punto de partida para resolver la mayoría de las consultas operativas sin necesidad de escalar a soporte técnico:

Verificar si un usuario fue dado de alta correctamente y existe en el sistema
Consultar el estado de una cuenta comitente (habilitada, deshabilitada, pendiente)
Ver la cartera completa de un usuario: saldos en ARS y USD, FCI, CEDEARs, acciones y bonos
Consultar instrumentos y activos disponibles
Revisar el historial de operaciones de mercado de un usuario
Revisar el historial de depósitos, retiros y boletos de mercado
Validar datos de contacto (email, teléfono) de un usuario
Gestionar configuraciones operativas y permisos del equipo

Secciones principales

📊 Dashboards

Vista general con métricas e indicadores clave de la operación. Permite tener una visión rápida del estado general de la plataforma: cuentas activas, volumen operado, depósitos recientes y actividad general de los usuarios.

👤 Personas

Menú lateral → Personas

Permite buscar cualquier persona (física o jurídica) registrada en el sistema.

Filtros disponibles:

Filtro	Descripción
Fecha desde / hasta	Rango de fechas de registro
Tipo de persona	Física, Jurídica o ambas
Investor ID / CUIT	Campo principal de búsqueda
Cliente	Filtro por partner

Qué información podés consultar:

Nombre completo o razón social
CUIT / CUIL y tipo de persona (Física / Jurídica)
Nacionalidad y datos de contacto (email, teléfono)
Estado del registro (activo / inactivo)
person_id — identificador único del usuario en el sistema

Tip: para búsquedas rápidas, usá solo el campo CUIT o Investor ID y dejá el resto vacío.

🏦 Cuentas

Menú lateral → Cuentas

Permite consultar el estado de las cuentas comitentes (investment_account_id) de los usuarios.

Filtros disponibles:

Filtro	Descripción
Investor ID	Número de comitente
Cuenta Comitente	ID interno de la cuenta
Cliente	Filtro por partner
Status	Estado de la cuenta
Aranceles / Oficial / Referido	Datos administrativos

Qué información podés consultar:

investment_account_id y número de cuenta comitente
Titular de la cuenta
Estado de cuenta: Habilitado / Deshabilitado
Estado general: approved y otros estados del proceso de alta
Grupo arancelario y oficial asignado
Código de referido

💼 Cartera

Menú lateral → Cartera

Muestra la composición completa de la cuenta de un usuario, organizada por tipo de activo. Es la vista más utilizada para consultas sobre saldos y tenencias.

Sección	Qué muestra
Currency	Saldo disponible en ARS y USD
Fund	Cuotapartes de FCI, precio y valorización total
CEDEAR	Cantidad de CEDEARs, precio unitario y valorización
Equity	Acciones locales, cantidad y valorización
Corporate Bond	Bonos, cantidad y valorización
ETF	ETFs disponibles en cartera

La cartera puede tener un pequeño delay de sincronización. Si hay una discrepancia que no se explica, reportala a soporte de API Broker con el investment_account_id y el detalle del descuadre.

📈 Activos

Menú lateral → Activos

Permite consultar el catálogo de instrumentos disponibles en la plataforma: CEDEARs, acciones, bonos, ETFs y FCI. Útil para verificar si un instrumento específico está habilitado para operar, consultar su ticker o validar su estado en el sistema.

⚙️ Operaciones

Menú lateral → Operaciones

Permite consultar el historial de operaciones de mercado de los usuarios: órdenes de compra y venta, suscripciones y rescates de FCI, operaciones MEP.

Útil para:

Verificar si una orden fue enviada y su estado actual
Consultar operaciones de un usuario en un rango de fechas
Identificar órdenes en estados anómalos (RETRY, NOT_SENT, REJECTED)
Responder consultas de usuarios sobre operaciones específicas

📄 Comprobantes

Menú lateral → Comprobantes

Permite consultar el historial completo de movimientos de fondos de una cuenta:

Depósitos: acreditaciones de fondos en la cuenta comitente, con fecha, monto y estado.
Extracciones: retiros solicitados con su estado actual (IN_PROGRESS, COMPLETED, REJECTED).
Boletos: comprobantes de operaciones de mercado ejecutadas.

Útil para responder consultas de usuarios sobre movimientos específicos, confirmar si un depósito fue acreditado o verificar el estado de un retiro.

🔧 Configuración

Menú lateral → Configuración

Permite gestionar parámetros operativos de la plataforma, como la configuración de webhooks, grupos arancelarios, oficiales de cuenta y otras opciones de configuración del partner. Cambios en esta sección pueden afectar el comportamiento de la integración. Ante dudas, consultá con el equipo de API Broker antes de modificar.

🔒 Seguridad

Menú lateral → Seguridad

Gestión de usuarios, roles y permisos del Back Office. Permite administrar qué integrantes del equipo tienen acceso y con qué nivel de permisos. Si necesitás agregar o remover usuarios del equipo operativo, esta es la sección correspondiente.

Casos de uso frecuentes

"Mi usuario dice que hizo una transferencia pero no ve el saldo"

Ir a Comprobantes → Depósitos. Buscar por investment_account_id o CUIT. Verificar si el depósito aparece y su estado. Si no aparece, el depósito puede no haber sido identificado por CUIT o puede estar pendiente por horario bancario.

"Mi usuario no puede operar"

Ir a Cuentas. Buscar la cuenta y verificar el campo Estado de cuenta. Si figura Deshabilitado, contactar a soporte de API Broker para gestionar la rehabilitación.

"Mi usuario dice que tiene saldo pero no puede retirar"

Ir a Cartera. Verificar que el saldo figure en la sección Currency (saldo líquido). Si el saldo está en Fund (FCI), primero debe rescatarse antes de poder retirar.

"Mi usuario hizo una orden pero no aparece ejecutada"

Ir a Operaciones. Buscar por cuenta comitente y rango de fechas. Verificar el estado de la orden. Si figura en RETRY o NOT_SENT, reportar a soporte de API Broker con el detalle.

"Mi usuario no recibe emails de confirmación"

Ir a Personas. Buscar por CUIT y verificar el email registrado. Si está incorrecto, reportarlo a soporte de API Broker para gestionar la actualización.

Estados de cuenta

Estado	Significado	Acción recomendada
`Habilitado` / `approved`	Cuenta activa y operativa	Ninguna
`Deshabilitado`	Cuenta bloqueada	Contactar soporte API Broker
Pendiente de aprobación	Alta en proceso	Esperar notificación o consultar a soporte

Troubleshooting frecuente

No aparece la cuenta buscada

Verificar que el número de comitente sea correcto. Probar con CUIT en lugar de Investor ID. Asegurarse de no tener espacios extra en el campo de búsqueda.

La cartera muestra Total ARS como NaN

Error de visualización. Sumar manualmente cada sección. Si persiste, reportarlo a soporte de API Broker.

Las tenencias no coinciden con lo esperado

Puede haber un delay de sincronización. Si el descuadre persiste más de 30 minutos, reportarlo a soporte con el investment_account_id y el detalle.

Una orden figura en estado RETRY o NOT_SENT

Reportar a soporte de API Broker con el investment_account_id y el identificador de la orden para gestionar el reintento o la corrección.

Notas importantes

El Back Office muestra información consolidada. Para casos complejos que requieran mayor detalle técnico, el equipo de soporte de API Broker tiene acceso a herramientas adicionales.
Los datos de los usuarios (CUIT, email, teléfono) son información sensible. Manejalos con confidencialidad y solo para fines operativos relacionados con la cuenta.
Ante cualquier acción que requiera modificar datos de un usuario (actualizar email, rehabilitar cuenta, corregir CBU), contactá al equipo de soporte de API Broker en lugar de intentarlo directamente.