Usuarios autorizados: Administradores.

La misión: Sincroniza y automatiza la gestión de tus clientes y oportunidades entre Bsale y Escala.

Bsale es un software de venta y boleta electrónica. Al integrar tu cuenta de Bsale con Escala, podrás sincronizar automáticamente la información de clientes, oportunidades y productos entre ambas plataformas, optimizando tus procesos comerciales y evitando la duplicidad de trabajo manual.

 Importante: Para realizar la integración de Bsale con Escala, debes tener creada y configurada la cuenta de BSale en su totalidad, así como también, solicitar a BSale el token de acceso para poder habilitar la integración y que les habiliten los eventos (webhooks) de productos y documentos y envíen a este URL.

Flujo de la integración (v2.0)

La integración con Bsale ahora permite una sincronización más completa y bidireccional:

1. Creación de clientes: Al crear un contacto en Escala (manual, por importación o automatización), este se creará automáticamente como cliente en Bsale.
2. Sincronización de productos: Los productos creados en Bsale se crearán automáticamente en el módulo de Productos de Escala.
3. Actualización de oportunidades: Cuando se crea una cotización o boleta en Bsale, la integración busca si el contacto asociado ya tiene una oportunidad abierta en Escala y la actualiza. Si no existe, crea una nueva oportunidad.
   

Requisitos para la integración

Para iniciar la integración, asegúrate de cumplir con los siguientes puntos:

1. Cuenta de Bsale configurada: Debes tener una cuenta de Bsale completamente configurada.
2. Token de acceso y webhooks: Debes solicitar a Bsale el token de acceso e indicarles que habiliten los eventos (webhooks) de productos y documentos hacia el URL de Escala.
3. Campos personalizados: Antes de iniciar, crea los siguientes campos personalizados tipo texto en Escala para la entidad de Oportunidades y Contactos:
4. Oportunidades: Número de Documento, Fecha de Emisión, Fecha de Vencimiento, Total Documento.
5. Contactos: Rut del Cliente del Documento, Origen de los contactos.

Crea los campos personalizados en Escala

1. Haz clic en el ícono de Perfil y configuraciones ubicado en la esquina superior derecha de la pantalla y dirígete a la sección de CRM, ubicada en la columna izquierda de la pantalla bajo la categoría de Configuraciones.

2. Una vez te encuentres en dicha sección, selecciona Campos personalizados y selecciona la pestaña Oportunidades para crear un nuevo campo personalizado.

3. Haz clic en el botón Crear ubicado en la parte superior derecha y completa la información para este nuevo campo.

4. En la casilla Tipo de campo, selecciona el tipo de campo que estás creando (tipo texto) y rellena el campo Nombre. Los campos que debes crear son los siguientes: 

1. Número de Documento
2. Fecha de Emisión
3. Fecha de Vencimiento
4. Total Documento

5. Al completar la información, haz clic en el botón Crear campo.

6. Ahora, haz clic y selecciona la opción de Contactos, seguidamente en el botón Crear ubicado en la parte superior derecha, para crear campos personalizados de contactos. 

7. En la casilla Tipo de campo, selecciona el tipo de campo que estás creando (tipo texto) y rellena el campo Nombre. Los campos que debes crear son los siguientes:

1. Rut del Cliente del Documento
   
2. Origen de los contactos
   

8. Al completar la información, haz clic en el botón Crear campo y verás cómo se añade automáticamente este nuevo campo.

 Importante: Si deseas conocer más sobre la creación de campos personalizados de oportunidades, ingresa aquí. Y si deseas conocer más sobre la creación de campos personalizados de contactos, ingresa aquí. 

1. Habilita la API Escala

1. Para integrar Bsale a tu CRM, debes dirigirte a Perfil y configuraciones en tu cuenta Escala.

2. Luego, en el apartado CRM selecciona la pestaña Apps.

3. Seguidamente, haz clic en Conectar API Escala, de esta forma podrás generar una API Key única para tus integraciones.

2. Inicia la integración con Bsale

1. En la sección de Apps, haz clic en +Agregar.

2. Ubica la opción de Bsale y haz clic en Seleccionar.

3. Haz clic en Configurar y luego en Habilitar esta App.

4. Ingresa el Token de Acceso a Bsale. Recuerda que debes solicitar tu token de acceso al mail <ayuda@bsale.app> indicando que requieres un token de acceso para conectar Escala a tu tienda en línea.

3. Define las reglas de sincronización

1. Creación de clientes en Bsale: En el selector "¿Deseas crear clientes en Bsale cada vez que se cree un nuevo contacto en Escala?", elige Sí o No.

2. Actualización o creación de oportunidades: En el campo "Actualizar o crear oportunidades en Escala a partir de los siguientes documentos de Bsale", elige los documentos que deseas sincronizar (Boletas, Cotizaciones, Ambos) o selecciona "No traer oportunidades a Escala".

1. Si eliges Sí, en el siguiente campo "Actualizar y mover de etapa oportunidades abiertas...", define la etapa en la que estarán las oportunidades a actualizar y la etapa a la que se moverán al crearse un nuevo documento en Bsale.
2. Si no hay oportunidades para actualizar, en el campo "Crear oportunidad de cero en Escala..." define en qué etapa se crearán las nuevas oportunidades.
   

3. Asignación de dueño: Elige la referencia de campo vendedor. Ten en cuenta que Escala usará el email del usuario en ambas cuentas para asignarlos a la información creada. Si el email no coincide, la oportunidad se creará sin dueño.

 Nota: Este campo se refiere a la asignación automática de dueños o responsables de la creación de la cotización en Bsale, el contacto y la oportunidad en Escala. 

4. Asocia los campos de Bsale a Escala

1. Asocia los campos de los documentos de Bsale (número de documento, fecha de emisión, total, etc.) con los campos de oportunidades que creaste previamente en Escala.

2. Asocia los campos de contactos de Bsale con los campos de contactos en Escala (email, teléfono, etc.). Ten en cuenta que la información de email y teléfono primario debe coincidir y agregarse de forma correcta en Bsale, de lo contrario el contacto no se podrá crear de forma automática en Escala. 

3. Haz clic en Guardar para finalizar la configuración. La información se sincronizará automáticamente.