CalMate

El complemento CalMate calcula automáticamente el valor del campo «Parámetro opcional 2» (OP2) del envío a partir del importe del pago contra reembolso. El cálculo se realiza tras la creación del envío. Se puede especificar una fórmula predeterminada para el complemento, así como una fórmula específica para cada cliente.

Requisitos previos

• una conexión a la API de Deliveo con suscripción;
• suscripción al servicio de webhooks de Deliveo;
• autorización para instalar, configurar y utilizar el complemento.

Instalación y acceso

El complemento se puede instalar en el Portal del Dispachador, en el apartado «Complementos». Tras la instalación, estará disponible en el apartado «Complementos / CalMate». Solo los usuarios con los permisos adecuados pueden instalar y utilizar el complemento.

Principio de funcionamiento

En la fórmula, x representa el importe del pago contra reembolso.

Ejemplo:

(x * 0.1) + 100

Si el importe del pago contra reembolso es 1000, entonces:

• x = 1000
• el valor calculado de OP2 es 200

Operaciones matemáticas que se pueden utilizar en la fórmula:

• +
• -
• *
• /
• ()

Reglas importantes

• El cálculo se realiza tras la creación del envío.
• Si el campo OP2 ya contiene un valor, el complemento lo sobrescribe.
• El resultado del cálculo no puede ser negativo.
• La longitud del resultado no puede superar la longitud máxima del campo OP2.
• Si la fórmula es incorrecta, no se realizará el cálculo.

Configuración del webhook

Para que el complemento funcione, es necesario crear un webhook.

1. Abre el menú «Configuración / Webhook».
2. Crea un webhook sencillo.
3. Como evento, selecciona «Creación de envío».
4. Copia la URL del webhook que aparece en la página de CalMate.
5. Guarda el webhook.

La URL del webhook es única para cada instalación, por lo que debes utilizar siempre la dirección que aparece en la propia interfaz de CalMate.

Fórmula OP2 predeterminada

La fórmula OP2 predeterminada se aplica a todos los envíos de los clientes para los que no se haya especificado una fórmula específica. Para configurarla:

1. Introduce la fórmula en el campo «Fórmula OP2 predeterminada».
2. Comprueba la fórmula con el botón «Probar la fórmula».
3. Haz clic en el botón «Guardar».

Ejemplo:

10+(x*2)/10

Fórmulas específicas para cada cliente

En la sección «Fórmulas del cliente» se pueden especificar cálculos diferentes para cada cliente. Para ello se necesitan dos datos:

• ID de cliente
• Fórmula

El ID de cliente es el identificador numérico interno que aparece en la columna «ID» de la lista «Datos maestros / Clientes» del Portal del despachador. Para añadir una fórmula específica para cada cliente:

1. Busca el ID del cliente en el menú «Datos maestros / Clientes».
2. Introduce el ID en el campo «ID de cliente».
3. Introduce la fórmula correspondiente al cliente.
4. Si es necesario, prueba la fórmula.
5. Haz clic en el botón «Añadir».

Las fórmulas de cliente existentes se pueden eliminar con el botón «Eliminar» situado al final de la fila.

Orden de aplicación de las fórmulas

Al crear un envío, el sistema:

1. comprueba si existe una fórmula específica para ese cliente;
2. si es así, utiliza la fórmula específica del cliente;
3. si no hay ninguna fórmula específica, aplica la fórmula predeterminada.

Prueba de la fórmula

La fórmula se puede probar antes de guardarla.

1. Introduce en el campo de prueba el x valor, es decir, el importe del pago contra reembolso que desee probar.
2. Haga clic en el botón «Probar la fórmula».
3. El sistema ejecutará la fórmula.
4. Si la prueba tiene éxito, mostrará el resultado calculado.

La prueba no modifica ningún envío, solo comprueba el funcionamiento de la fórmula.

Fórmula errónea

Si la fórmula introducida no se puede interpretar:

• el cálculo no se ejecuta;
• el campo de la fórmula aparecerá enmarcado en rojo durante unos instantes.

En ese caso, comprueba:

• que los paréntesis sean correctos;
• los signos de operación que se pueden utilizar;
• que solo x variante;
• que no haya errores ortográficos ni operadores que falten.

Ejemplos

Añadir una cantidad fija

x+100

Se suma 100 al importe del pago contra reembolso.

Cálculo de un valor porcentual

x*0.1

El valor de OP2 es el 10 % del importe del pago contra reembolso.

Porcentaje y cantidad fija juntos

(x*0.1)+100

El valor de OP2 es el 10 % del pago contra reembolso, más 100.

Deducción de una cantidad fija

x-100

El sistema deduce 100 del importe del pago contra reembolso. El resultado no puede ser negativo.

Errores frecuentes

El valor de OP2 no se actualiza

Comprueba:

• que el webhook esté creado;
• que el evento del webhook sea «Creación de envío»;
• que la URL correcta figure en el webhook;
• si el envío incluye un importe de contra reembolso;
• que la fórmula se haya guardado.

No se ejecuta la fórmula esperada

Comprueba:

• si hay una fórmula específica para el cliente;
• si se ha introducido el ID de cliente correcto;
• si se ha guardado la fórmula predeterminada deseada.

La fórmula específica del cliente tiene prioridad sobre la fórmula predeterminada.

El resultado es negativo

El complemento no puede utilizar un valor OP2 negativo. Modifica la fórmula de modo que el resultado sea al menos cero para cualquier importe de pago a la entrega previsto.

La comprobación de la fórmula ha fallado

Comprueba:

• la sintaxis de la fórmula;
• los paréntesis;
• los signos de operación;
• el x uso de las variables.

El valor anterior de OP2 ha desaparecido

El complemento sobrescribe el valor anterior del campo OP2 al crear el envío. Esto forma parte de su funcionamiento.