Introducción

• Cómo empezar
• Gestión de datos de operativa diaria

Checklist carga de datos

Glosario

Documentación de usuario

• API
• Autenticación

Introducción

Bienvenido a la guía técnica de Bright Market, diseñada para ayudarte a comprender y sacar el máximo provecho de nuestra plataforma.

En esta guía, encontrarás una descripción paso a paso del proceso de parametrización de la cuenta, detalles de los módulos y los datos que manejan, y cómo realizar el onboarding de información. Además, se incluye un glosario de términos clave y enlaces directos a la documentación de usuario y API, con explicaciones claras sobre la autenticación y más.

Cómo empezar

Proceso de onboarding

Esta sección cubre los pasos necesarios para configurar el sistema antes de iniciar las operaciones diarias, desde la configuración inicial de parámetros clave hasta la integración de datos y la personalización de las funcionalidades según las necesidades del negocio.

<aside> ⚠️ Es importante seguir los pasos del proceso de onboarding en el orden indicado para garantizar la correcta configuración del sistema. Al seguir este orden, evitarás problemas relacionados con dependencias entre módulos y la integridad de los datos.

</aside>

Paso a paso:

Paso 1: Creación de la cuenta

Paso 2: Creación de usuarios y permisos

Paso 3: Revisión y carga de datos de la organización

Paso 4: Carga de parámetros

Paso 5: Carga de tiendas y depósitos

Paso 6: Carga del catálogo

Estructura del catálogo

Artículos

Paso 7: Carga de datos históricos

Tickets de venta

Promociones

Órdenes de compra

Órdenes de reposición

Creación de la Cuenta y Acceso Inicial

El equipo de Bright Market realiza la configuración inicial de la cuenta de la organización, cargando los datos básicos de la misma.

Una vez creada la organización, se otorga acceso al primer usuario, quien será designado como administrador. Este usuario será responsable de crear y gestionar las cuentas adicionales dentro del sistema, asignando los permisos correspondientes a cada miembro del equipo.

El usuario administrador recibirá un correo electrónico con un enlace para establecer su contraseña y acceder al sistema por primera vez.

Creación de Usuarios y Asignación de Permisos

• Roles

  Antes de crear usuarios en Bright Market, es fundamental primero configurar los roles en el sistema. Los roles definen los permisos y accesos específicos que cada usuario tendrá. Una vez que los roles están configurados, se pueden asignar a los usuarios correspondientes.

  Los roles pueden crearse solo a través del panel de administración por parte de un usuario Admin (ver Guía de usuario)

• Usuarios

  Una vez que el usuario administrador ha accedido al sistema, puede proceder a crear cuentas adicionales para otros miembros del equipo y definir sus niveles de acceso.

  Este proceso se puede llevar a cabo exclusivamente a través del panel de administración (Ver Guía de usuario). Al crear un nuevo usuario desde el panel, se debe proporcionar la información básica del mismo. El sistema enviará automáticamente un correo electrónico al nuevo usuario con instrucciones para establecer su contraseña y acceder al sistema por primera vez.

Revisión y Carga de Datos de la Empresa

Una vez creada la organización en Bright Market, es esencial que el cliente revise los datos básicos cargados inicialmente y complete cualquier información faltante. Este proceso de revisión y carga de datos garantiza que toda la información relevante de la empresa esté correctamente registrada en el sistema desde el principio.

El cliente puede realizar esta tarea de manera manual a través del portal de administración, lo que permite una verificación detallada y la carga de cualquier dato adicional que sea necesario (ver Guía de usuario).

Después de la revisión y carga de datos de la organización, el siguiente paso es la creación de las unidades de negocio y canales.

• Unidad de Negocio: Una unidad de negocio representa una subdivisión de la organización que opera de manera semi-independiente, como una línea de productos, una región geográfica, o un área específica dentro de la empresa. Configurar estas unidades permite a Bright Market organizar y segmentar las operaciones de manera efectiva, facilitando una gestión precisa y enfocada en las distintas áreas de la empresa.
• Canal: Un canal se refiere a las diferentes vías a través de las cuales la empresa interactúa con sus clientes, como tiendas físicas, comercio electrónico, ventas al por mayor, entre otros. Establecer los canales correctamente es fundamental para gestionar cómo y dónde se realizan las transacciones y cómo se implementan las estrategias de marketing y ventas.

Este proceso de creación de unidades de negocio y canales puede llevarse a cabo de manera manual a través del portal (ver Guía de usuario).

La correcta configuración de estas unidades y canales es vital para la organización y gestión eficiente de las operaciones diarias en Bright Market.

Parámetros Generales

El siguiente paso es la carga de parámetros generales del sistema.

• Medios de Pago (Requerido):

  Configurar los medios de pago es un paso esencial para garantizar que las transacciones se realicen de manera eficiente y sin interrupciones. Los medios de pago pueden configurarse manualmente a través del panel de administración (ver Guía de usuario).

  Es importante completar esta configuración antes de iniciar las operaciones.

• Fechas Comerciales (Opcional):

  Las fechas comerciales representan días específicos importantes para la empresa, como feriados, temporadas de ventas, o eventos promocionales. Aunque la configuración de estas fechas es opcional, hacerlo puede ayudar a planificar y gestionar campañas de manera más efectiva.

  Al igual que los medios de pago, las fechas comerciales pueden configurarse manualmente a través del panel de administración (ver Guía de usuario).

• Temporadas (Opcional):

  La configuración de temporadas permite a la empresa dividir el año en periodos específicos que pueden estar alineados con ciclos de ventas, tendencias de consumo, o estrategias de marketing. Configurar temporadas es opcional, pero puede ser útil para segmentar y analizar el rendimiento en diferentes periodos. Esta configuración también puede realizarse:

• Objetivos (Opcional):

  La definición de objetivos dentro del sistema permite a la empresa establecer metas claras y medibles que alineen las operaciones con las estrategias comerciales. Configurar objetivos es opcional, pero altamente recomendable para monitorear el progreso y tomar decisiones informadas.

  Los objetivos pueden configurarse manualmente a través del panel de administración (ver Guía de usuario).

• Colores El mantenimiento de colores permite registrar y gestionar los colores que posteriormente se podrán asociar a los artículos dentro de Bright Market.

  Estos colores pueden cargarse manualmente a través del panel de administración (ver Guía de usuario).

  Asegurarse de que los colores estén correctamente configurados es esencial para una correcta clasificación y personalización de los productos en el sistema.

Carga de Tiendas y Depósitos/Centros logísticos

El siguiente paso en la configuración es la creación y asociación de tiendas (físicas o eCommerce) y depósitos. Este proceso es fundamental para organizar la logística y gestión de inventarios dentro del sistema.

• Creación de Tiendas

  Primero, es necesario crear las tiendas en el sistema. Las tiendas pueden ser creadas:

  <aside> 1️⃣ A través del panel de administración

  Ver Guía de usuario incluyendo carga manual y por Excel.

  </aside>

  <aside> 2️⃣ Mediante la API

  Endpoint: POST /api/branchOffices/

  

  

  </aside>

  <aside> ➡️ Consulte la documentación de la API para conocer el resto de los servicios asociados a Tiendas (Sucursales):

  **- Obtener sucursal: GET /api/branchOffices/{id}

  • Editar sucursal: PUT /api/branchOffices/{id}
  • Eliminar sucursal: DELETE /api/branchOffices/{id}
  • Alternar el estado discontinuado de un SKU en una sucursal: PUT /api/branchOffices/{branchOfficeId}/toggleUnsupply/{skuId}
  • Editar punto de venta: PUT /api/branchOffices/salePoint/{id}
  • Eliminar punto de venta: DELETE /api/branchOffices/salePoint/{id}
  • Editar stocks de varios SKUs en varias sucursales: PUT /api/branchOffices/editStocks
  • Editar stock de un SKU en una sucursal: PUT /api/branchOffices/editStock/{id}
  • Agregar stock de SKU a la sucursal: POST /api/branchOffices/{branchOfficeId}/addSku/{skuId}
  • Carga de stock por Excel: POST /api/branchOffices/stocks/processExcelTemplate
  • Carga de sucursales por Excel: POST /api/branchOffices/processExcelTemplate
  • Obtener plantilla de carga en Excel: GET /api/branchOffices/stocks/excelTemplate
  • Obtener ajustes de stock de SKU en sucursal: GET /api/branchOffices/stockAdjustments/{id}
  • Consultar sucursales paginado: GET /api/branchOffices/query
  • Obtener sucursales por unidades de negocio: GET /api/branchOffices/getByBusinessUnitIds
  • Obtener plantilla de carga en Excel: GET /api/branchOffices/excelTemplate
  • Obtener tipo de sucursales: GET /api/branchOffices/branchOfficeTypes
  • Eliminar SKU de una sucursal: DELETE /api/branchOffices/deleteSku/{id}**

  </aside>

• Carga de Puntos de Venta (Sales Points):

  Una vez creadas las tiendas, es necesario configurar los puntos de venta (POS), que son las cajas facturadoras dentro de cada sucursal, y que se referencian en los tickets de venta.

  Los puntos de venta se pueden crear:

  <aside> 1️⃣ A través del panel de administración

  Dentro de cada sucursal.

  ****Ver Guía de usuario incluyendo carga manual y por Excel.

  </aside>

  <aside> 2️⃣ Mediante la API

  Endpoint: POST /api/branchOffices/salePoint

  </aside>

  Configurar correctamente los puntos de venta es esencial para un registro preciso de las transacciones y la gestión diaria de ventas en cada ubicación.

• Creación de Centros logísticos/Depósitos

Carga del Catálogo de Productos

Una vez completada la parametrización del sistema, el siguiente paso en la configuración es la carga del catálogo de productos.

Este proceso se lleva a cabo en varias etapas para asegurar que toda la información necesaria esté correctamente registrada y organizada.

• Marcas:
• Proveedores:
• Categorías: