One by Allegro API

Globe Pickup Points se integra con One by Allegro (antes WEDO), un transportista checo que entrega en casilleros de paquetería, puntos de recogida Intime y direcciones particulares a través de la API OneDelivery 3.0. Con esta integración, puede:

Exportar pedidos a One by Allegro directamente desde Shopify
Imprimir etiquetas de envío dentro de Shopify
Enviar a un casillero de paquetería, a un punto de recogida o a la dirección del cliente
Cobrar contra reembolso

Habilitar la integración con la API de One by Allegro

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 One by Allegro.
Introduzca su ID del token y su Contraseña API. Puede encontrar ambos en la zona de clientes de One by Allegro, en la configuración de API. Si no los tiene, contacte con el soporte de One by Allegro (eshop-onecz@allegro.com).
Haga clic en Probar conexión para confirmar que las credenciales se aceptan antes de guardar.
Rellene la dirección del remitente: Remitente — nombre de la empresa, Remitente — calle, Remitente — número, Remitente — ciudad y Remitente — código postal. La dirección del remitente se imprime en cada etiqueta, se utiliza para la recogida de los paquetes y se envía con cada envío (One by Allegro no recurre a ninguna dirección predeterminada guardada en su cuenta). La integración siempre envía la República Checa como país del remitente.
Rellene Longitud por defecto en mm, Ancho por defecto en mm y Altura por defecto en mm. Son obligatorios: One by Allegro rechaza los envíos sin dimensiones del paquete.
Opcionalmente, establezca un Peso predeterminado (kg) que se use cuando un producto no tenga peso en Shopify.
Configure las opciones de cumplimiento y etiquetado según sea necesario.
Asocie sus métodos de envío de Shopify con One by Allegro.

Exportar e imprimir etiquetas

Puede exportar pedidos a One by Allegro 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 pedido exportado se convierte en un envío con un solo paquete. El número de paquete devuelto se usa como número de seguimiento, y el enlace de seguimiento apunta a la página de seguimiento de One by Allegro. Si el cumplimiento automático está activado, Shopify marca el pedido como enviado con el número de seguimiento y el nombre del transportista One by Allegro.

La API solo acepta letras, dígitos, espacios, comas y puntos en los campos de descripción del paquete y de referencia. Globe los depura automáticamente: la descripción es Order <nombre del pedido> y el nombre del pedido se usa como número de referencia 1, acortado a 20 caracteres.

Métodos de entrega

One by Allegro resuelve el método de entrega en el momento de la exportación a partir del Tipo de producto que seleccione. El valor predeterminado es AUTO, que es el que deberían mantener la mayoría de los comerciantes.

Tipo de producto	Comportamiento
AUTO	Usa el punto de recogida de One by Allegro seleccionado en el proceso de pago: un casillero de paquetería pasa a ser BOX y una sucursal pasa a ser PUDO. Si el pedido no tiene ningún punto de One by Allegro, el paquete se envía a la dirección de entrega.
TO_DOOR	Entrega en la dirección del cliente. Se ignora cualquier punto de recogida seleccionado.
BOX	Entrega en un casillero de paquetería One Box. Requiere un punto de One by Allegro en el pedido.
PUDO	Entrega en un punto de recogida atendido (sucursal Intime). Requiere un punto de One by Allegro en el pedido.

Si elige BOX o PUDO de forma explícita y el pedido no tiene ningún punto de recogida de One by Allegro, la exportación se rechaza para ese pedido. Los códigos de punto proceden del punto de recogida que el cliente seleccionó en el selector de Globe — consulte Añadir transportistas de puntos de recogida.

Todos los envíos se exportan con el servicio Standard. Los números de teléfono de destinatarios checos y eslovacos se convierten automáticamente al formato internacional (+420 / +421) para que puedan enviarse las notificaciones SMS del transportista.

Peso y dimensiones del paquete

One by Allegro rechaza los envíos sin dimensiones del paquete, por lo que los valores predeterminados de la configuración del transportista son obligatorios, no opcionales.

Peso: se toma del pedido de Shopify. Si el pedido no tiene peso, se usa el Peso predeterminado (kg) de la configuración del transportista. Si no hay ninguno de los dos, la exportación falla para ese pedido.
Dimensiones: siempre se toman de los campos Longitud / Ancho / Altura por defecto en mm. Si alguno de ellos está vacío o es cero, la exportación falla con un mensaje que le indica que los rellene.

Pago contra reembolso (COD)

One by Allegro admite COD. Cuando un pedido usa un método de pago contra reembolso, el importe del COD se toma del pedido y se envía en la moneda del pedido junto con el envío. No existe un campo de cuenta bancaria aparte en la configuración del transportista: los abonos se gestionan a través de su contrato con One by Allegro.

Estado de entrega

La sincronización de estados de entrega no está disponible. One by Allegro no forma parte de la sincronización de estados de entrega de Globe, por lo que los estados de los paquetes no se escriben de vuelta en Shopify. El número de seguimiento y el enlace de seguimiento siguen adjuntándose al cumplimiento, de modo que los clientes pueden seguir el paquete en la página de seguimiento del transportista.

Impresión de etiquetas

One by Allegro devuelve las etiquetas como un único PDF que cubre todo el lote impreso, en uno de estos dos formatos:

Formato	Descripción
PDF_A6	Una etiqueta por página (predeterminado)
PDF_A4	Una etiqueta por página A4

La API de OneDelivery no admite la impresión desde una posición concreta de la hoja, por lo que con este transportista no pueden reutilizarse hojas de etiquetas parcialmente usadas.

Devoluciones y cancelación

Las etiquetas de devolución no son compatibles con esta integración.
Los envíos no pueden cancelarse. La API de OneDelivery no tiene ningún endpoint de cancelación o eliminación. Una vez exportado un pedido, el envío permanece en su cuenta de One by Allegro: simplemente no entregue el paquete o resuélvalo en el portal de One by Allegro.

Solución de problemas

Problema	Solución
`Failed to authenticate with One by Allegro`	Compruebe el ID del token y la contraseña API en la configuración del transportista y use Probar conexión. Una respuesta 401 significa que las credenciales no son válidas.
`Order requires a One by Allegro pickup point for BOX/PUDO delivery`	El tipo de producto está establecido en BOX o PUDO, pero el pedido no tiene ningún punto de recogida de One by Allegro. Use AUTO o TO_DOOR, o compruebe que el cliente seleccionó un punto de One by Allegro en el proceso de pago.
`Order … has no weight`	Establezca el peso del producto en Shopify, introduzca el peso manualmente durante la exportación o rellene el Peso predeterminado (kg).
`default package dimensions are not set`	Rellene la longitud, el ancho y la altura predeterminados (en milímetros) en la configuración de One by Allegro: la API los exige en cada envío.
El destinatario no recibe las notificaciones del transportista	Solo los números checos y eslovacos reciben un prefijo de país automático. Para otros países, guarde el número de teléfono en formato internacional completo en el pedido.
`One by Allegro did not return a PDF label`	La API respondió con algo que no era un PDF. Reintente la impresión; si sigue fallando, contacte con el soporte de One by Allegro indicando el número de envío.
Pedido exportado por error	Los envíos no pueden eliminarse mediante la API. No entregue el paquete y resuelva el envío en el portal de One by Allegro.

Add One by Allegro pickup points to your Shopify store — pricing, demo & setup →