ShippyPro API

Globe Pickup Points se integra con ShippyPro, una plataforma de envíos multitransportista que le permite enviar con los contratos de transportista que ya tenga conectados dentro de su propia cuenta de ShippyPro. Con esta integración, puede:

• Exportar pedidos a ShippyPro directamente desde Shopify
• Imprimir etiquetas de envío dentro de Shopify
• Enviar a puntos de recogida o a la dirección del cliente, según el servicio de transportista que elija
• Admitir pago contra reembolso (COD) y declaraciones aduaneras (CN22) para envíos transfronterizos

Los pedidos pueden exportarse a 33 países de destino: la UE, el Reino Unido, Suiza, Noruega, EE. UU., Canadá y Australia.

---

Habilitar la integración con la API de ShippyPro

1. En su panel de administración de Shopify, abra Globe Pickup Points y vaya a Etiquetas de envío. Añada un nuevo transportista y seleccione ShippyPro.
2. Introduzca su Clave API: puede encontrarla en su cuenta de ShippyPro. Es la única credencial obligatoria.
3. Haga clic en Fetch carriers. Globe verifica la clave y descarga todos los transportistas y servicios conectados a su cuenta de ShippyPro, para que pueda asociarlos a los métodos de envío de Shopify.
4. Rellene los datos del remitente que se imprimen en la etiqueta: Nombre del remitente, Nombre de la empresa remitente, Calle del remitente, Ciudad del remitente, Código postal del remitente, País del remitente (un código de dos letras como CZ, SK, HU), Teléfono del remitente y Email del remitente.
5. Configure las opciones de cumplimiento y etiquetado según sea necesario: Enviar pedidos automáticamente, Etiquetar pedidos con número de seguimiento y Etiqueta personalizada después del export.
6. Asocie sus métodos de envío de Shopify con los servicios de transportista descargados.

En Globe no existe un sandbox de ShippyPro aparte: la clave API que introduzca crea envíos reales en su cuenta.

---

Exportar e imprimir etiquetas

Puede exportar pedidos a ShippyPro e imprimir etiquetas de envío directamente desde Shopify, ya sea en lote o de forma individual. Consulte Creación de etiquetas de envío para conocer el flujo de trabajo completo.

Cada exportación crea el envío y devuelve un número de seguimiento y una etiqueta en una sola llamada, por lo que las etiquetas están listas para imprimir de inmediato. El nombre de su pedido de Shopify se envía como referencia y nota del envío. Una vez exportado, el número de seguimiento se usa para el seguimiento del cumplimiento y el transportista informado por ShippyPro se escribe en Shopify como empresa de seguimiento.

---

Transportistas y servicios

ShippyPro no tiene red propia. Los transportistas, los servicios y las tarifas proceden de su cuenta de ShippyPro, por lo que la lista que ve al exportar es exactamente la que tenga conectada allí. Si añade un nuevo transportista en ShippyPro, haga clic de nuevo en Fetch carriers en la configuración del transportista de Globe para incorporarlo.

Si su cuenta no devuelve ninguna lista de transportistas (por ejemplo, cuando la API de ShippyPro no está disponible temporalmente), Globe recurre a la introducción manual y le permite pegar la definición del transportista en formato JSON. Use Copy sample para obtener el formato esperado.

---

Puntos de recogida vs. entrega a domicilio

• Si el pedido lleva un punto de recogida seleccionado en el proceso de pago y lo exporta con un servicio de punto de recogida, Globe envía el ID del punto a ShippyPro como opción del transportista, de modo que el paquete se dirige a ese punto.
• Los servicios cuyo nombre los identifica como entrega a domicilio siempre envían a la dirección de envío del cliente, incluso cuando hay un punto asociado al pedido.

Los propios puntos de recogida pueden proceder de cualquier proveedor que use en el proceso de pago, o del proveedor ShippyPro PUDO, que consulta en tiempo real los puntos de recogida de los transportistas de su cuenta de ShippyPro. Consulte Añadir transportistas de puntos de recogida.

Al exportar, Globe le avisa con un banner Type selection mismatch si el transportista de ShippyPro seleccionado no parece ser el transportista propietario del punto de recogida del pedido, por ejemplo un punto de Packeta exportado con un servicio de GLS. La exportación no se bloquea, así que revise el aviso antes de continuar.

---

Peso y dimensiones del paquete

ShippyPro exige un peso real. Globe nunca se lo inventa: si el pedido no tiene peso establecido en Shopify, la exportación se rechaza. Añada los pesos de los productos en Shopify y exporte de nuevo.

Las dimensiones del paquete son opcionales. Largo del paquete (cm), Ancho del paquete (cm) y Alto del paquete (cm) son opciones avanzadas y no ajustes del transportista, y cuando no se establece ningún valor se envía 1 cm para cada dimensión. Si el servicio de transportista seleccionado ofrece una opción de seguro, el envío se asegura por el total del pedido.

---

Aduanas

Para los envíos transfronterizos, Globe construye una declaración CN22 a partir de las líneas de artículo del pedido: descripción, cantidad, valor unitario, peso, código HS y país de origen tomados del artículo de inventario del producto. Cuando los datos del producto están incompletos, estos ajustes del transportista cubren las lagunas:

Ajuste	Se usa para
País del remitente	País de origen cuando un producto no tiene ninguno
Contents type	Tipo de mercancía declarada en el formulario CN22 (Merchandise, Gift, Documents, Commercial Sample, Returned Goods)
Países DDP	Países de destino enviados como DDP (aranceles pagados por usted); el resto de destinos se envían como DDU

La Descripción del contenido (la descripción del contenido del envío, Goods por defecto) y el Código HS (el código arancelario que se usa cuando un producto no tiene ninguno) no son ajustes del transportista: son opciones avanzadas que se rellenan por envío en el diálogo de exportación.

---

Pago contra reembolso (COD)

ShippyPro admite COD. Cuando el pedido tiene un importe pendiente de cobro, Globe envía el importe del COD junto con la moneda del pedido, y ShippyPro lo transmite al transportista final. Los pedidos sin nada que cobrar se exportan como envíos normales. Que el COD esté realmente disponible —y en qué monedas— depende del contrato de transportista que haya detrás del servicio seleccionado en su cuenta de ShippyPro.

---

Estado de entrega

La sincronización de estados de entrega no está disponible para ShippyPro: los estados de los paquetes no se escriben de vuelta en Shopify, por lo que el progreso debe seguirse en ShippyPro o en la página de seguimiento del transportista final. El número de seguimiento y el enlace de seguimiento siguen adjuntándose al cumplimiento. Las etiquetas de devolución tampoco son compatibles; créelas directamente en ShippyPro.

---

Impresión de etiquetas

Las etiquetas se solicitan a ShippyPro en el momento de la impresión en el tamaño elegido, y todas las etiquetas de un lote se combinan en un único PDF de varias páginas:

Formato	Descripción
A6	Etiqueta generada a 10,5 × 14,8 cm
A4 (4 por hoja)	Etiqueta generada a 21 × 29,7 cm

Como es ShippyPro quien genera la etiqueta, la disposición exacta en la página procede de la propia plantilla de etiqueta del transportista final. Las etiquetas pueden reimprimirse en cualquier momento: Globe obtiene una URL de descarga nueva para cada envío y, si falla, recurre a la URL de la etiqueta almacenada en el momento de la exportación.

---

Solución de problemas

Problema	Solución
«Invalid API key — please check your ShippyPro credentials»	ShippyPro rechazó la clave. Cópiela de nuevo desde su cuenta de ShippyPro y guarde el transportista.
«ShippyPro API key is not configured»	El campo de la clave API está vacío en la cuenta del transportista. Rellénelo y guarde.
«No carriers configured. Use the ‘Fetch carriers’ button»	La lista de transportistas nunca se ha descargado. Abra la configuración del transportista y haga clic en Fetch carriers.
«Please select a carrier before exporting.»	El servicio elegido para el pedido no está en la lista descargada, normalmente porque la lista ha cambiado. Vuelva a descargar los transportistas y asocie de nuevo el método de envío.
«Order has no weight set.»	ShippyPro exige un peso distinto de cero. Añada los pesos de los productos en Shopify y exporte de nuevo.
Exportación rechazada con un mensaje de error del transportista	ShippyPro transmite el error de validación del transportista final junto con la solución sugerida: normalmente una dirección incompleta, un destino no admitido o un servicio no habilitado en su cuenta.
Paquete enviado a la dirección en lugar de al punto de recogida	El servicio de transportista no tiene guardada ninguna opción de punto de recogida. Haga clic de nuevo en Fetch carriers para actualizar las opciones del transportista y vuelva a exportar.
«Could not retrieve label for order …»	No se pudo descargar ni la URL de etiqueta nueva ni la almacenada. Espere un momento e imprima el lote de nuevo; si sigue fallando, vuelva a exportar el pedido.