Manual de configuración de Zoho Books como origen de datos en BillMySales
Requisitos
-
Tener cuenta en Zoho Books con cualquier plan de pago.
-
Tener cuenta en BillMySales con cualquier plan, incluyendo gratuito.
- Si requiere usar sondeo necesitará un plan que lo permita.
-
Crear pasarela usando el origen Zoho Books y el facturador de su elección.
Configuración básica de pasarela de facturación
Importante: Esta integración no se ha probado con casos con descuentos.
Para realizar la configuración de tu integración debes realizar los siguientes pasos:
1. Acceder a configuraciones de Zoho Books
Entrar a tu cuenta de Zoho Books y dirigirte a las configuraciones:

2. Seleccionar Automatización
En configuraciones debes seleccionar “Automatización”:

3. Crear nuevo Webhook
Luego debes ingresar a “Webhooks” y seleccionar el botón en verde “Nuevo Webhooks”:

Configuración del Webhook
Configura el webhook con los siguientes parámetros:
-
Nombre: BillMySales
-
Módulo: Factura
-
URL a notificar: La URL del webhook la encontrarás en la pasarela de facturación de BillMySales en la pestaña Webhook:

-
Método: POST
-
Tipo de autorización: Automatización propia
-
Incluir encabezados HTTP:
- Nombre del parámetro:
X-ZOHOBOOKS-BMS - Valor del parámetro:
a9b5d17ecd610018b2cad0fa0dc5b6e9
- Nombre del parámetro:
-
Parámetros de entidad: Anexar todos los parámetros

4. Crear regla del flujo de trabajo
Ahora te debes dirigir a “Reglas del flujo de trabajo” y seleccionar “Nueva regla del flujo de trabajo”:

Configuración de la Regla:
- Nombre de regla de flujo de trabajo: BillMySales Flujo
- Módulo: Factura
- Cuando una factura es: Creado o editado
- Filtrar los activadores:

- ¿Sólo una vez o cada vez?: Cada vez
Acciones:
- Tipo: Webhooks
- Nombre: Seleccionamos el Webhook anteriormente creado

5. Guardar configuración
Finalmente debes seleccionar guardar.
¿Cómo emitir boletas y facturas?
Boletas
1. Agregar campos personalizados
Debes agregar campos personalizados a la configuración del cliente, para esto hay que dirigirse a “Configuración”:

2. Acceder a Preferencias
Luego ingresar a “Preferencias”:

3. Personalización de campo
Seleccionar “Clientes y vendedores”, dentro de este campo seleccionar “Personalización de campo”:

4. Añadir campos requeridos
Dentro de esta página debes añadir los siguientes campos:
-
RUT:
- Tipo de dato: Cuadro de texto (línea única).
- Obligatorio (Siempre y cuando se requiera).
-
GIRO:
- Tipo de dato: Cuadro de texto (línea única).
- Obligatorio (Siempre y cuando se requiera).
-
RUT EMPRESA:
- Tipo de dato: Cuadro de texto (línea única).
- Obligatorio (Siempre y cuando se requiera).
-
TIPO DE DOCUMENTO:
- Tipo de dato: Selección múltiple.
- Obligatorio (Siempre y cuando se requiera).
5. Ejemplo de tipo de documento

Facturas
1. Seguir el mismo proceso
Siguiendo el mismo paso anterior con las boletas llegamos a la ruta de “Personalización de campo”.
2. Añadir campos requeridos
Dentro de esta página debes añadir los siguientes campos:
-
RUT:
- Tipo de dato: Cuadro de texto (línea única).
- Obligatorio (Siempre y cuando se requiera).
-
GIRO:
- Tipo de dato: Cuadro de texto (línea única).
- Obligatorio (Siempre y cuando se requiera).
-
RUT EMPRESA:
- Tipo de dato: Cuadro de texto (línea única).
- Obligatorio (Siempre y cuando se requiera).
-
TIPO DE DOCUMENTO:
- Tipo de dato: Selección múltiple.
- Obligatorio (Siempre y cuando se requiera).
3. Ejemplo de tipo de documento

¿Cómo configuro el tipo de precio en el facturador?
El tipo de precio lo debes configurar en la configuración de la pasarela en BillMySales en la pestaña “Facturador” campo “Configuración de precios en el origen de datos” de la pasarela de facturación.
