Boxpi API

Globe Pickup Points se integra con Boxpi, un agregador logístico transfronterizo. Una sola conexión API le da acceso a más de 60 servicios de transportistas en 16 mercados europeos, sin necesidad de un contrato aparte con cada transportista nacional. Con esta integración, puede:

Exportar pedidos a Boxpi directamente desde Shopify
Imprimir etiquetas de envío dentro de Shopify
Enviar a casilleros de paquetería, sucursales y oficinas de correos, o a la dirección del cliente
Admitir pago contra reembolso (COD)
Sincronizar los estados de entrega de vuelta a Shopify

Habilitar la integración con la API de Boxpi

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 Boxpi.
Introduzca su Clave API: contacte con el servicio de atención al cliente de Boxpi para obtenerla. Los entornos de producción y de prueba usan claves API diferentes.
Seleccione el Entorno: Producción para envíos reales, Desarrollo para hacer pruebas contra la API de prueba de Boxpi. La clave API debe pertenecer al entorno que seleccione.
Configure las opciones de cumplimiento y etiquetado según sea necesario (Enviar pedidos automáticamente, Etiquetar pedidos con número de seguimiento, Etiqueta personalizada después del export, Peso predeterminado (kg)).
Asocie sus métodos de envío de Shopify con los servicios de Boxpi que desee usar.

Exportar e imprimir etiquetas

Puede exportar pedidos a Boxpi 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 general.

Cada pedido se registra como un paquete de Boxpi. El registro con el transportista final es asíncrono: Globe espera unos segundos a que se asigne el código de seguimiento. Si todavía no ha llegado, la exportación se realiza igualmente y mientras tanto se usa el ID de paquete de Boxpi; la comprobación del estado de entrega lo sustituye por el número de seguimiento real del transportista final en cuanto aparece.

Boxpi exige un número de teléfono del destinatario en todos los envíos. Los pedidos que no lo tengan se rechazan antes de enviarse.

Servicios de transportistas

Boxpi es un agregador: el transportista final se elige por pedido según el servicio al que asocie el método de envío. Los IDs de servicio siguen el patrón CARRIER-SERVICE-COUNTRY, por ejemplo GLS-COURIER-SK, PACKETA-POINT-CZ o SPS-POSTOFFICE-SK. La parte central indica cómo se entrega el paquete:

Servicio	Entrega
COURIER	En la dirección del cliente
POINT	En una sucursal o casillero de paquetería
POSTOFFICE	En una oficina de correos

Hay 62 servicios disponibles en Austria, Bélgica, Bulgaria, Croacia, República Checa, Francia, Alemania, Grecia, Hungría, Italia, Luxemburgo, Países Bajos, Polonia, Rumanía, Eslovaquia y Eslovenia, incluidos GLS, DPD, DHL, InPost, Packeta, PPL, SPS, Speedy, Sameday, Cargus, FAN Courier, BoxNow, Express One, BRT y los correos austriacos y eslovacos.

Puntos de recogida vs. entrega a domicilio

Servicios POINT / POSTOFFICE: el destino se define únicamente por el punto de recogida que el cliente seleccionó en el proceso de pago; los campos de dirección postal se ignoran. Si el pedido no lleva ningún punto de recogida, la exportación se rechaza.
Servicios COURIER: la calle, la ciudad y el código postal son obligatorios. La segunda línea de dirección se envía como número de casa cuando tiene 10 caracteres o menos; en caso contrario, se añade a la calle. La provincia o región del pedido se transmite como área del país, dato que exigen los mensajeros rumanos y búlgaros.

Boxpi valida el punto de recogida contra sus propias listas de puntos. Los IDs de punto de una integración directa con un transportista no coinciden de forma fiable con los IDs de Boxpi, por lo que los métodos de envío que se exporten a través de Boxpi deben usar los puntos de recogida de Boxpi en el selector del proceso de pago — consulte Añadir transportistas de puntos de recogida.

Pago contra reembolso (COD)

Boxpi admite COD. El importe se toma del pedido y se envía en la moneda del pedido: CZK y HUF se redondean a unidades enteras y el resto de monedas, a dos decimales. La parte numérica del nombre del pedido se usa como símbolo variable del COD.

Boxpi valida la moneda contra el servicio seleccionado. Si el COD en esa moneda no está permitido para el transportista que ha asociado, la exportación se rechaza y el propio mensaje de error de Boxpi se muestra en el pedido.

Active Actualizar estado de entrega en Shopify automáticamente y, a continuación, Marcar pedidos contra reembolso como pagados automáticamente para que los pedidos con COD se marquen como pagados en Shopify una vez entregado el paquete.

Estado de entrega

Boxpi es uno de los transportistas en los que la sincronización de estados de entrega está disponible. Con Actualizar estado de entrega en Shopify automáticamente activado, Globe consulta a Boxpi y mantiene sincronizado el estado del cumplimiento en Shopify, de modo que puede filtrar pedidos por estado en su panel de administración de Shopify:

Estado en Shopify	Descripción
Seguimiento añadido	Registrado en Boxpi o en el transportista, todavía no entregado físicamente.
En tránsito	Recibido en el almacén de Boxpi o por el transportista, en camino.
En reparto	En reparto a domicilio o listo para su recogida en el punto.
Entrega fallida	Rechazado por el transportista, cancelado, perdido, en devolución o devuelto.
Entregado	Entregado, o entregado con el pago contra reembolso cobrado.

La opción Completar solo cuando el transportista reciba el paquete aplaza el cumplimiento en Shopify hasta que Boxpi confirme que el paquete ha llegado físicamente al transportista, en lugar de crearlo en el momento de la exportación.

Impresión de etiquetas

Las etiquetas de Boxpi se generan como PDF y pueden imprimirse en los siguientes formatos:

Formato	Posiciones por hoja
A6	1
A4	4 (2×2 en una sola hoja A4)

Al imprimir en A4, puede seleccionar una posición de inicio (posiciones 1–4) para reutilizar hojas de etiquetas parcialmente usadas.

Las etiquetas se crean de forma asíncrona en el lado de Boxpi, por lo que una etiqueta solo existe una vez que el paquete está registrado en el transportista. Globe reintenta automáticamente durante unos segundos cuando imprime inmediatamente después de la exportación.

Las etiquetas de devolución no son compatibles con esta integración: las devoluciones deben gestionarse en el portal de Boxpi.

Solución de problemas

Problema	Solución
Error de autenticación de Boxpi	Compruebe la clave API y asegúrese de que coincide con el entorno seleccionado: las claves de producción y de prueba son distintas.
`Invalid Boxpi carrier ID`	El método de envío está asociado a un valor que no es un servicio de Boxpi. Vuelva a asociarlo a un servicio `CARRIER-SERVICE-COUNTRY`.
`Pickup point must be selected for pickup point delivery`	El pedido usa un servicio POINT o POSTOFFICE pero no tiene ningún punto de recogida. Compruebe que el cliente seleccionó uno en el proceso de pago.
`Recipient phone number is missing`	Boxpi exige un número de teléfono en todos los envíos. Añádalo al pedido antes de exportar.
`Missing required address fields`	Los servicios de mensajería necesitan calle, ciudad y código postal. Complete la dirección de envío y exporte de nuevo.
Paquete rechazado por el transportista	El transportista final rechazó el envío: Globe muestra el error propio del transportista. Corrija los datos y exporte el pedido de nuevo.
La etiqueta no está lista a tiempo	El registro en el transportista todavía está en curso. Espere un momento e imprima de nuevo.
Punto de recogida no aceptado	El ID del punto no existe en la lista de Boxpi para ese transportista. Asegúrese de que el proceso de pago ofrezca puntos de recogida de Boxpi para este método de envío.

Add Boxpi pickup points to your Shopify store — pricing, demo & setup →