Panorama de la integración
La integración de Hive con WooCommerce es nativa, y ofrece actualizaciones en tiempo real a través de webhooks. Cualquier actualización en tu tienda se reflejará en la Hive App unos segundos después.
Cómo integrar WooCommerce en Hive
Para conectar tu tienda WooCommerce a la Hive App, tendrás que crear una nueva clave "REST API" en tu tienda WooCommerce y compartir la "URL", la "Clave de cliente" y el "Secreto de cliente "con Hive creando un ticket en la Hive App en tu página de "soporte".
Para crear una clave "REST API" en tu WooCommerce, sigue los pasos que se indican a continuación:
- En Woocommerce, ve a la pestaña WooCommerce, busca el icono Woo y selecciona "Configuración".
- Navega y haz clic en la pestaña "Avanzado".
- En "Configurar página", busca la pestaña "API REST".
- Haz clic en "Añadir clave".
- Añade "Hive Technologies" como descripción y dale permisos de "Lectura/Escritura", después haz clic en "Generar clave API"
- Por favor, copia y envía tu "URL", "clave de consumidor" y "secreto de consumidor" a Hive creando un ticket en la Hive App en tu página de "soporte".
⚠️ Si vas a integrar otra tienda WooCommerce después de que hayamos empezado a tramitar tus pedidos, informa a Hive a través del Servicio de Atención al Cliente para acordar cuándo debe iniciarse la tramitación de pedidos para esta tienda adicional.
Cómo importar tu catálogo a Hive
Para que Hive sepa qué SKUs debe surtir de una tienda, es necesario mapearlas a SKUs de Hive.
Tras integrar tu WooCommerce, tus productos se importarán mediante webhooks unos segundos después en la Hive App. Por favor, empieza a mapear tus productos en la Hive App tan pronto como los productos de tu tienda hayan sido importados para que Hive sepa qué productos físicos enviar desde los pedidos que se sincronicen desde esta nueva tienda.
Para más información sobre cómo asignar productos de la tienda a SKUs de Hive, haz clic aquí.
Cómo configurar la sincronización del Inventario
Hive puede sincronizar las cantidades de inventario con tu WooCommerce. De esta forma, tendrás una visión precisa de tu inventario en WooCommerce, y podrás evitar la sobreventa. Los números de inventario se sincronizan con WooCommerce cada hora. La sincronización del inventario sólo se activará cuando Hive haya empezado a procesar tus pedidos. Si no quieres que se active esta función, ponte en contacto con el Servicio de Atención al Cliente.
-
Nota: la sincronización del inventario y la sincronización de los pedidos no están relacionadas. Sin la sincronización de inventario, los pedidos seguirán entrando en Hive. La sincronización de inventario se dedica a enviar recuentos de inventario a WooCommerce.
¿Cómo se transmite la información de seguimiento a WooCommerce?
La información de seguimiento de los envíos se transmitirá a WooCommerce en cuanto el pedido se marque como "enviado" en Hive. Cuando Hive procesa un pedido en el centro logístico, marcamos el pedido como "completado" y enviamos el transportista, la URL de seguimiento y el número de seguimiento del envío a tu WooCommerce.
Detalles de la integración
- Datos SKU importados de WooCommerce
Los siguientes campos SKU se importan de WooCommerce a Hive:
- Peso
- Coste/Coste de producción
- SKU Status
El coste de producción, el código HS y el país de rigen, son campos necesarios a relenar en WooCommerce ya que los mismos son utilizados para pasar a las autoridades aduaneras al momento de realizar envios fuera de la UE o a destinos aduaneros como las Islas Canarias. Sin uno de estos campos, el pedido quedará bloqueado en el centro logístico hasta que se actualice la información del SKU.
- Nota: Los campos SKU "País de origen" y "Código HS" aún no se importan desde WooCommerce. Si estás pensando en realizar envíos fuera de la UE, rellénalos directamente en la Hive App.
- Nota: Actualmente, no importamos el campo "Código de barras" (EAN) de WooCommerce. Para ayudarnos a identificar mejor tus SKU, rellena estos campos en la Hive App.
- Detalles de sincronización de pedidos y productos
Los pedidos y las actualizaciones de productos con la integración de WooCommerce se realizan en tiempo real, ya que la conexión se realiza mediante webhooks.
Estos son los puntos finales de la API que utilizamos actualmente:
GET /wp-json/wc/v3/settings/productos/<id>
- Para importar la configuración del producto
GET /wp-json/wc/v3
- Para comprobar que la URL y la clave API funcionan correctamente
GET /wp-json/wc/v3/productos
- Para importar productos
GET /wp-json/wc/v3/productos/<producto_id>/variaciones
- Para importar variaciones de un producto
POST /wp-json/wc/v3/productos/<producto_id>/variaciones/lote
- Para actualizar el recuento de inventario
GET /wp-json/wc/v3/pedidos
- Para importar pedidos
GET /wp-json/wc/v3/pedidos/<id>
- Para importar un pedido concreto
PUT /wp-json/wc/v3/pedidos/<id>
- Para actualizar el estado del pedido
GET /wp-json/wc/v3/pedidos/<id>/notas
- Para recuperar las notas de pedido
POST /wp-json/wc/v3/pedidos/<id>/notas
- Para crear una nueva nota de pedido con el número/URL de seguimiento
GET /wp-json/wc-seguimiento-de-envío/v3
- Para detectar la presencia del plugin de seguimiento de envíos de pago
GET /wp-json/wc-shipment-tracking/v3/orders/<order_id>/shipment-trackings/
- Para obtener todos los envíos
POST /wp-json/wc-shipment-tracking/v3/orders/<order_id>/shipment-trackings/
- Para crear un nuevo envío
GET /wp-json/wc/v3/webhooks
- Para comprobar si nuestras URL de webhooks están registradas
POST /wp-json/wc/v3/webhooks/batch
- Para registrar las URL de nuestros webhooks, si faltan
En esta página de WooCommerce, puedes encontrar más información sobre los puntos finales de la API que utilizamos.
- ¿Podemos activar el FIFO?
Recibimos marcas de fecha y hora de WooCommerce, lo que nos permite seguir una lógica FIFO (primero en entrar, primero en salir) para los pedidos importados de WooCommerce.
Funciones no admitidas
Actualmente, la integración no admite las siguientes funciones:
- Transferencia de información de seguimiento por lotes de Hive a WooCommerce
- Transferencia de información de seguimiento del número de serie de Hive a WooCommerce
- Carga de documentos de WooCommerce a Hive para pedidos B2B. Como alternativa, puedes añadir documentos manualmente en la Hive App. Todos los pasos se explican en esta FAQ.
- Anunciar envíos de reabastecimiento
-
Marcar artículos "on hold" en WooCommerce
- También puedes utilizar las "acciones de pedido" de la Hive App para marcar los pedidos "on hold".
Guía de desinstalación
Puedes revocar nuestra clave API desde tu WooCommerce para poner fin a nuestra colaboración. Para ello, sigue los siguientes pasos:
- En Woocommerce, ve a la pestaña WooCommerce, busca el icono Woo y selecciona "Configuración".
- Navega y haz clic en la pestaña "Avanzado".
- En "Configurar página", busca la pestaña "API REST".
- Busca la clave "HIve Technologies”
- Haz clic en "Revocar".