Global-e es una plataforma de comercio electrónico transfronterizo que ayuda a las marcas en línea a vender directamente a consumidores en más de 200 mercados a nivel mundial. Proporciona a los compradores internacionales una experiencia local fluida al calcular aranceles garantizados por adelantado y admitir idiomas locales, monedas y métodos de pago regionales. Para usted, como comerciante, gestiona la logística de envíos internacionales, el cumplimiento normativo local, la prevención de fraudes y las devoluciones internacionales.

Antes de configurar la integración, inicie sesión en su entorno de prueba de PULPO WMS y asegúrese de que el administrador de integraciones esté activado en sus ajustes.

Crear credenciales de integración

Credenciales de PULPO WMS

Nombre: Puede usar cualquier nombre, pero se recomienda "PULPO" para diferenciarlo claramente.
Tipo: Seleccione PULPO.
URL:
- https://eu-show.pulpo.co para la instancia de prueba.
- https://eu.pulpo.co para la cuenta activa (Live) en Europa o África.
- https://am.pulpo.co para la cuenta activa (Live) en América.
Regla general: La URL debe coincidir exactamente con la instancia en la que ha iniciado sesión.
Ingrese el nombre de usuario y la contraseña de la API de PULPO WMS (proporcionados por PULPO).

Credenciales de Global-e

Nombre: Puede elegir cualquiera, pero se recomienda "Credenciales de Global-e".
Tipo: Seleccione Global-e.
URL: Ingrese [https://api.global-e.com/](https://api.global-e.com/) (por defecto).
Agregue su Merchant GUID.
Haga clic en Crear.

Configurar la integración de Global-e

Una vez creadas las credenciales, siga estos pasos para configurar la integración:

Ingrese un Nombre para la integración (ej. "Labels - GlobalE").
Elija el Tipo Generate shipping labels.
Seleccione las Credenciales de origen (Origin credentials) correspondientes a los datos de origen (Pulpo API).
Seleccione las Credenciales de destino (Destination credentials) correspondientes al destino de datos (Global-e API).

Ajustes adicionales:

Seleccione los eventos bajo Events to process:
- packing_order_finished
- sales_order_finished
- turbo_label_draft_packing_created
Configure el modo del filtro de países (Country filter):
- Include (Incluir)
- Exclude (Excluir)
Elija los países específicos (por ejemplo, Alemania, España) que Global-e procesará o ignorará. Esta lista se basa en los países estándar permitidos en la dirección de envío de un pedido de venta.

Importante: Solo se procesan los pedidos correspondientes a los países configurados en el filtro. Cualquier destino fuera de estos países devolverá inmediatamente una respuesta no procesable por el integrador.

Cómo funciona la integración

Cuando se activa un evento de empaque seleccionado (packing hook), el integrador genera una solicitud hacia la API de Global-e. Se creará un envío por cada caja relacionada con la orden de empaque en proceso.

Generación de etiquetas: La etiqueta de envío recibida desde Global-e se adjunta automáticamente a la caja de empaque como una etiqueta del transportista (carrier label).
Documentos de exportación: Todos los documentos de exportación se combinan en un único archivo PDF y se adjuntan a la caja.
Actualizaciones de seguimiento: Los campos ParcelTrackingNumber y ParcelTrackingUrl recibidos en la respuesta se agregan a la información de seguimiento de la caja dentro de PULPO WMS.
Confirmación de despacho: Una vez que un pedido de venta (Sales Order) se finaliza en PULPO, el integrador envía una solicitud a Global-e para confirmar que el envío se ha realizado correctamente.

Esta integración puede funcionar en paralelo con otras plataformas de generación de etiquetas, siempre y cuando los filtros por país de destino estén configurados correctamente en ambas herramientas para evitar conflictos.

Configuración de la integración de Global-e