1. Dirígete al icono Mi cuenta > Perfil y configuraciones en tu cuenta de Escala.2. Navega hasta la sección de Apps y haz clic en el botón Agregar.3. En el catálogo de aplicaciones, selecciona Contífico.
Configuración inicial
1. Activa la integración marcando la casilla Habilitar esta App.2. Luego, si ya has realizado otras integraciones en tu cuenta, la Escala API Key se reflejará en el campo automáticamente. En caso de que esta sea la primera integración que realizas, dirígete nuevamente a la pestaña de Apps y haz clic en Conectar API Escala, de esta forma podrás generar una API Key única para tus integraciones.3. Después, ingresa la Contífico API Key. Esta clave se obtiene desde la configuración de tu cuenta de Contífico, para ello:
- Inicia sesión en Contífico, accediendo desde este enlace: https://app.contifico.com/sistema/accounts/login/?next=/sistema/
- Ve a Mi compañía, en el icono de maletín.
- Selecciona la pestaña API.
- Copia la Contífico API Key y pégala en Escala, en el campo Contífico API Key.
4. Ahora, ingresa la clave de acceso de Contífico. Esta es única para cada cuenta y para obtenerla debes comunicarle al equipo de Contífico que vas a integrar tu cuenta a Escala. Cuando la obtengas, cópiala y pégala en el campo correspondiente.5. Selecciona la dirección del flujo, es decir, la dirección en la que se sincronizarán los datos:
- Crear oportunidades en Escala a partir de facturas en Contífico.
- Crear documentos en Contífico a partir de oportunidades ganadas en Escala.
6. Recuerda que solo puedes elegir una de las dos. A continuación te enseñamos cómo hacer la configuración en cada caso.Caso 1: Crear oportunidades en Escala a partir de facturas en Contífico
Este caso de uso permite crear automáticamente oportunidades, contactos y productos en Escala cuando se generan facturas (documentos) en Contífico.
1. Selecciona la opción Crear oportunidades en Escala a partir de facturas en Contífico en el campo Dirección del flujo.2. Haz clic en Guardar.3. Se mostrarán campos para mapear la información entre Contífico y Escala, como:
- Asociar vendedores.
- Seleccionar el campo personalizado para guardar la cédula del contacto proveniente de Contífico.
- Elegir si quieres ejecutar la sincronización diaria de manera automática.
- Seleccionar la etapa de la oportunidad en donde quieres que se creen las oportunidades provenientes de Contífico.
4. Luego de mapear los campos correspondientes, es decir, seleccionar qué campo de Contífico corresponde a qué campo de Escala, haz clic en Guardar.Para sincronizar la información de Contífico a Escala:
1. Ve a la pestaña Tareas.2. Selecciona el rango de fechas de las facturas que deseas sincronizar.3. Haz clic en Sincronizar a demanda.Caso 2: Crear documentos en Contífico a partir de oportunidades ganadas en Escala
Esta opción permite crear automáticamente facturas (documentos) en Contífico cuando se ganan oportunidades en Escala. Para utilizar este caso, debes crear previamente algunos campos personalizados, donde las oportunidades cumplan con los siguientes requisitos:
Tener un contacto asociado con campos personalizados específicos (creados previamente):
- Cédula (tipo texto)
- Razón social (tipo texto)
- Tener campos personalizados de oportunidad específicos y con información completa:
- ID Contífico (tipo texto, este campo se crea e inicialmente debe estar vacío, nunca se llena de forma manual)
- Número de documento (tipo texto)
- Número de autorización (tipo texto)
- Subtotal 0 (tipo número decimal)
- Subtotal 12 (tipo número decimal)
- ICE (tipo texto)
- IVA (tipo número decimal)
- Total (tipo número decimal)
- Tener campos personalizados de producto específicos y con información completa.
- Porcentaje de descuento (tipo número decimal)
- Base cero (tipo número decimal)
- Base gravable (tipo número decimal)
- Base no gravable (tipo número decimal)
- Porcentaje IVA (tipo número decimal)
Una vez tengas tus campos creados, realiza la configuración de la siguiente manera:1. Selecciona la opción Crear documentos en Contífico a partir de oportunidades ganadas en Escala en el campo Dirección del flujo.2. Haz clic en Guardar. Así, se mostrarán los siguientes campos para mapear la información entre Escala y Contífico.3. Primero, asocia tus vendedores con los usuarios que tienes en Escala, es decir, mapea los vendedores de Contífico con los usuarios (dueños de oportunidad) en Escala. Este paso es opcional.4. En caso de que la oportunidad no tenga dueño, selecciona el dueño por defecto de Escala para asignar al documento de Contífico. Este paso es obligatorio.5. Elige el momento en que se enviará la información a Contífico. Puedes elegir entre:
- Cuando se gana una oportunidad.
- Cuando una oportunidad llega a una etapa específica: en este caso debes seleccionar las etapas de oportunidad que dispararán el evento.
6. Después, selecciona el campo personalizado para guardar el ID generado por Contífico. Debes selecciona el campo de oportunidad ID Contífico (creado previamente) para guardar el ID.7. Ahora, debes mapear los campos entre Escala y Contífico correspondientes a las tres entidades de Escala: contacto, oportunidad y producto. Este proceso consiste en seleccionar qué campos de Escala corresponden a los campos requeridos en Contífico.
- Primero, selecciona los campos personalizados de tu deal (oportunidad de Escala) que corresponden a los campos de Contífico. Ejemplo: Campo "Número de documento" en Escala se mapea con "Número de documento" en Contífico.
- Después, selecciona los campos personalizados de contacto de Escala que corresponden a los campos de Contífico.
- Por último, selecciona los campos personalizados de producto de Escala que corresponden a los campos de Contífico.
Para el mapeo te recomendamos:
- Utilizar los mismos nombres para los campos personalizados en Escala que los campos correspondientes en Contífico (para facilitar el proceso).
- Es obligatorio mapear los 15 campos (2 de contacto, 8 de oportunidad y 5 de producto) para que la integración funcione correctamente. Si algún campo no se mapea, la creación del documento en Contífico fallará.
8. Luego, selecciona el tipo de documento que se creará en Contífico, que puede ser factura o liquidación de compra. La opción seleccionada dependerá del uso que le dé tu empresa a Contífico.9. Selecciona el tipo de cobro, entre efectivo, cheque, tarjeta de crédito, transferencia, etc. La opción seleccionada dependerá de los tipos de facturación de la empresa.10. Selecciona los tipos de personas como se crearán en contífico: natural, jurídica, sin ID, etc.11. Selecciona el tipo de transacción. La opción seleccionada dependerá del caso de uso de la empresa; puede ser: datafast, medianet, dataexpress, entre otros.12. Después de mapear todos los campos y definir las opciones anteriores, haz clic en Guardar para finalizar la configuración. De esta manera, habrás realizado la integración de Escala con Contifico para este caso de uso.