La conexión con Holded viene con los planes Pro Nacional y Enterprise, como los orígenes de importación (página de planes). La configura en «Conectores» quien administra la cuenta, con su segundo factor confirmado.
Qué Holded hace falta
Cualquier plan de pago de Holded, o su prueba gratuita: el plan Free no da acceso a la API. No escribes ninguna dirección: MercaMap usa api.holded.com.
Las llamadas de cada mes
Holded da a cada cuenta un límite de llamadas al mes según su plan (500 en Starter, 2.000 en Growth o Basic, 7.500 en Standard, 30.000 en Advanced y 100.000 en Premium), que comparten todas tus integraciones; tu consumo está en «Desarrolladores › Uso de la API». En «Conecta» eliges tu plan y el techo de MercaMap: proponemos el 40 % del límite, y puedes poner desde 100 hasta el límite entero. El mes es el natural, en UTC.
Los pedidos van primero. Con el 80 % del techo gastado, las importaciones y la lectura de albaranes esperan al mes siguiente; los pedidos siguen hasta el techo y, al llegar a él, esperan sin entregarse por archivo hasta que empieza el mes o subes el techo. En ambos casos avisamos por correo a los administradores. Si Holded dice cuánto le queda a tu cuenta, paramos antes (las importaciones por debajo del 20 % y los pedidos por debajo del 5 %) y no pasamos de su límite si es menor que el techo. Si pide esperar, solo una prueba de la conexión le pregunta algo hasta la hora que da: si has ampliado tu plan, pruébala; si Holded responde, dejamos de esperar.
Como referencia: una importación de productos gasta una llamada por cada 100 productos; un pedido, unas 4; los albaranes, unas 4 al día mientras haya pedidos esperándolos. Por eso los orígenes de Holded no se programan cada hora.
Conecta
Ponle a la conexión el nombre de tu empresa, pega la clave de API y elige tu plan y el techo. La conexión se guarda desactivada: no trae nada ni recibe pedidos hasta que la pruebes y la actives. Una clave nueva, cualquier cambio en «Elige los datos» o una prueba en la que Holded rechaza la clave o sus permisos la pausan de nuevo; con una clave nueva releemos el catálogo. La clave se guarda cifrada y no se vuelve a mostrar.
Da acceso
Prepara esto en tu Holded; «Comprobar», junto a cada punto, prueba la conexión hasta ese paso, sin escribir en Holded:
- Una clave de API para MercaMap. Con un usuario con acceso a «Desarrolladores», en «Configuración › Desarrolladores › Credenciales» pulsa «Agregar API Token», llámala «MercaMap» y elige los permisos del punto siguiente. Pulsa «Crear Token» y cópiala: Holded la enseña una sola vez. Pégala en «Conecta».
- Sus permisos. «Por áreas», no «Global» (con él, Holded lo rechaza todo): «Leer» en «Contactos › Contactos», «Inventario › Productos» e «Inventario › Tarifas»; para recibir los pedidos, «Escribir» en «Inventario › Pedidos de venta» y «Leer» en «Inventario › Envíos» (los albaranes). Ningún otro. La prueba comprueba las lecturas; la escritura, el primer pedido.
Elige los datos
Cada parte que marcas es un origen de importación propio, con «Traer ahora», programación opcional e historial; se importa como un archivo subido, y en Holded no cambia nada.
- Productos, en tus referencias: su referencia en Holded como código (sin ella,
holded-y su identificador), el nombre y el código de barras; cada variante de un producto es una referencia. Se quedan fuera los archivados, los que no están a la venta, los packs y una referencia que llevan dos productos; puedes traer solo los de una etiqueta. El tamaño de caja sale del atributo que nombras o, si no, del pack de Holded que contiene ese producto solo, cuando todos coinciden; sin ninguno, la referencia conserva el suyo y una nueva sin él se rechaza. - Clientes y sus direcciones de envío, en tus códigos de tienda. Escribe cada cliente que es de una cadena, uno por línea, con su «Referencia» de Holded, en «Preferencias» (
C0001 = Masymas; sin ella,holded-y su identificador). Cada dirección de envío del contacto es una tienda de esa cadena, con el código cliente/dirección (C0001/T01), donde la dirección es su nombre en Holded: ponle a cada una el código de la tienda; si dos se llaman igual, van con su identificador. Si escribes «GLN» y sus cifras en las notas de la dirección, viene con ella. Un cliente sin direcciones de envío es él mismo una tienda. Del contacto no leemos su NIF, correos, teléfonos ni datos bancarios. - Una tarifa, en una de tus listas de precios: el precio sin impuestos que esa tarifa da a cada producto (son de la gema «Inventario»; la principal no se trae). Si Holded no tiene la tarifa que nombras, el origen falla y lo dice.
Los pedidos
Marca «Entregar a Holded, como pedidos de venta, los pedidos que se entregan al confirmarse»; la entrega tiene que ser «Al confirmarse cada pedido» (Archivos del ERP y entrega de pedidos), y solo una conexión de la cuenta recibe los pedidos. Cada uno llega como pedido de venta con la fecha en que se confirmó, el contacto y la dirección de envío del código de la tienda, una línea por referencia con sus unidades y el identificador de nuestro pedido, sin guiones, en la descripción. Antes de crearlo lo buscamos entre los del contacto, así que nunca se crea dos veces: no borres esa línea de la descripción.
No enviamos precios: Holded los pone como en cualquier pedido de venta y tu oficina lo revisa y lo aprueba, nunca MercaMap. Su número vuelve como la respuesta (mientras Holded no le da uno, su identificador). Cuando Holded hace un albarán de ese pedido de venta, el pedido muestra su número y su fecha; los buscamos durante 30 días. Como Holded da los productos solo por su identificador, guardamos el de cada referencia y los releemos solo si hace falta: por un pedido con una referencia que no tenemos (como mucho cada 60 minutos), por una línea que Holded rechaza o tras 7 días sin leerlos.
En «Prueba y activa» ves los pedidos que esperan y los que no se han podido entregar, con el motivo: corrígelo y pulsa «Volver a intentarlo», o entrégalo por archivo. Si Holded tarda o responde con un error, lo intentamos más tarde y paramos tras varios fallos seguidos. Con la conexión en pausa, los pedidos se entregan por archivo.
Qué guardamos
El nombre de la conexión, lo que lee cada parte, las cadenas de los clientes, tu plan y el techo, hasta que borras la conexión o se cierra la cuenta; la clave, cifrada, con cuándo la pegaste, solo para hablar con Holded y nunca en un registro; las llamadas gastadas este mes, lo último que Holded dijo de su límite y hasta cuándo pidió esperar; y, para gastar menos llamadas, el identificador en Holded de cada referencia y cuándo leímos los albaranes. Cada pedido que Holded recibe guarda su número, el identificador de su pedido de venta y su albarán con su fecha. «Borrar la conexión», tras confirmarlo, borra la clave y los orígenes (las importaciones que abrieron se quedan). Para retirar el acceso en Holded, borra la clave en «Desarrolladores › Credenciales».