Ir al contenido principal
Todas las coleccionesIntegraciones y API
Integración Woocommerce - Quipu mediante Make
Integración Woocommerce - Quipu mediante Make

Descubre como conectar tu WooCommerce con Quipu mediante Make

Roger Dobaño avatar
Escrito por Roger Dobaño
Actualizado hace más de una semana

En este artículo vamos a ver como generar tickets o facturas de los pedidos que se creen en WooCommerce. Para ello primero deberemos crear una cuenta en Make (Consta de un plan gratuito que permite realizar hasta 1000 operaciones al mes).

El primer paso será crear un nuevo escenario:

Buscar WooCommerce en el listado de Apps y dentro de WooCommerce daremos a Watch Orders para recibir la información de los nuevos pedidos en nuestro ecommerce.

En este paso, nos pedirá conectarnos a nuestro WooCommerce. Puedes ver cómo hacerlo paso por paso en este enlace.

Una vez conectado, nos aparecerá la siguiente pantalla donde podremos configurar el estado del pedido: completado, pagado... filtrar por la fecha: de pago, creación... y poner un límite de pedidos que se gestionen mediante Make.

Recomendamos poner la siguiente configuración para registrar los pedidos pagados en Quipu. Status: Completed, Sort by Date Paid y Limit: 10

Le damos al boton de OK y para validar que nos llega la información de forma correcta clicaremos con el botón derecho sobre el logo de WooCommerce para que aparezca el siguiente desplegable:

Si vamos a Choose where to start > Choose manually nos aparecerán todos los pedidos pasados que cumplen con los filtros que hemos puesto y si le damos al OK nos permitirá seguir la configuración con datos reales de nuestro WooCommerce y no los por defecto de la plataforma.

El siguiente paso, vamos a utilizar la función de Iteración para gestionar correctamente los pedidos que tengan más de un producto y que se plasme con el mismo detalle de campos en las facturas o tickets de Quipu.

Para ello deberemos hacer clic en el signo de + y buscar Iterator:

Aquí poner el campo Line Items []:

Si queremos añadir también los gastos de envío como concepto en las facturas tendremos que introducir la función merge.

Hacemos click en OK y buscamos Array aggregator:

En Source Module elegimos el Iterator [2]:

Seleccionamos todos y damos al OK ya que más adelante configuraremos este paso.

Siguiente paso será crear el contacto en Quipu:

En el siguiente paso deberemos hacer clic en Add para conectarnos a Quipu

Para conseguir el App ID y el App Secret de nuestra cuenta debemos ir a Configuración > Integraciones y activar la API de Quipu:

Completaremos los campos con la información de WooCommerce:

El campo Tax ID no es un campo por defecto en WooCommerce por lo que la información aparecerá dentro del campo Meta Data. Dentro de este, depende de como haya sido configurado. Veámoslo con un ejemplo

En este caso, en el campo Meta Data nos llegan 15 collection distintas. En la primera podemos ver que en el campo Value se recoge el CIF de la empresa que ha realizado el pedido. Para poder rellenar este campo en el Tax ID de contacto lo hemos hecho con la siguiente formula:

La Key puede variar según cada WooCommerce por lo que puede ser distinto al del ejemplo: _billing_nif

Una vez completados todos los campos de contacto podremos elegir si queremos crear un Ticket o una Factura (Necesitamos el NIF/CIF del comprador) en Quipu.

En este caso elegimos Invoice "Factura" y completamos los campos de la siguiente manera:

Por último para poder completar correctamente el campo Items deberemos volver al paso anterior - Array Aggregator.

Ya que nos aparecerá los campos a rellenar dentro de una factura:

Este paso puede variar según como hayas configurado tu tienda. Vamos a mostrarte los dos casos principales:

Caso 1: Configuración Standard (con gastos de envío y distintos casos de IVA).

Si en el punto anterior decidiste introducir el campo Shipping Lines para introducir los gastos de envío en la factura

La forma de completarlo va a ser la siguiente:

  • Concept:

En este campo hemos introducido la función IF ya que en la factura de Quipu queremos introducir la información de dos Arrays distintas la de Line Items (donde encontramos los pedidos) y la de los Shipping Lines (los envíos). En cada array aparecen campos distintos:

En el Bundle 4 aparecen los campos de Line Items mientras que en el Bundle 5 aparecen los campos de Shipping Lines. El campo a referenciar de los Line Items es Name mientras que este no aparece en el de Shipping Lines pero queremos poner el que nos aparece como methodTitle --> Envío gratuito.

Este campo si lo queremos referenciar veremos que no nos aparece en el listado:

Por lo que lo deberemos introducir manualmente de la siguiente forma:

{{2.methodTitle}}

El Nº 2 sale porque el campo lo recibimos del paso 2:

  • Unitary Amount:

En este campo para poder poner el importe de los Shipping Lines tendremos que realizar un cálculo entre el Total y la Quantity. En caso de no utilizar los Shipping lines el campo recomendado es Price.

En la fórmula si el campo Quantity nos llega vacío se pondrá el importe total (caso de los Shipping Lines) mientras que si tenemos un valor en la Quantity lo calcularemos de la siguiente forma Total/Quantity otra opción seria poner Price.

  • Quantity:

Referenciaremos el campo Quantity

  • VAT Percentage:

Este campo también lo completaremos con una fórmula para poder gestionar de forma correcta las ventas extracomunitarias en las que el importe de IVA es 0.

Si Total Tax es igual a 0, devolverá 0 en caso negativo redondearemos el cálculo del campo Total Tax entre su Total y lo multiplicaremos por 100.

Caso 2: Configuración Simple (WooCommerce asumiendo un 21% de IVA en todas las ventas)

Existen distintas opciones de configurar el IVA en WooCommerce por lo que este campo puede variar según la configuración del WooCommerce.

¿Ha quedado contestada tu pregunta?