Ir al contenido

Speedy API

Globe Pickup Points se integra con Speedy, el transportista de paquetería búlgaro que gestiona la red de DPD en Bulgaria. Con esta integración, puede:

  • Exportar pedidos a Speedy directamente desde Shopify
  • Imprimir etiquetas de envío dentro de Shopify
  • Enviar dentro de Bulgaria a la dirección del cliente, a una oficina de Speedy o a un locker de Speedy
  • Enviar paquetes contra reembolso en EUR, también a oficinas y lockers

Habilitar la integración con la API de Speedy

Sección titulada «Habilitar la integración con la API de Speedy»
  1. En su panel de control de Shopify, abra Globe Pickup Points y vaya a Etiquetas de envío. Haga clic en Añadir integración de transportista y seleccione Speedy.
  2. Introduzca su Usuario y su Contraseña de la API de Speedy. Speedy los entrega a los clientes con contrato; solicíteselos a su gestor comercial de Speedy.
  3. En Servicio de Speedy, seleccione el servicio de su contrato con Speedy: Estándar 24 horas (505) o Estándar 24 horas paquete (515). Ambos son servicios para paquetes dentro de Bulgaria, y ambos entregan en direcciones, oficinas y lockers.
  4. En Envío pagado por, seleccione quién paga a Speedy la entrega: Remitente (mi contrato con Speedy) o Destinatario (paga en la entrega).
  5. Si lleva los paquetes a una oficina o a un locker de Speedy, introduzca su ID en Oficina de Speedy donde entrega los paquetes (por ejemplo 77). Si un mensajero los recoge en su dirección, déjelo vacío.
  6. Si lo desea, haga clic en Mostrar configuración avanzada:
    • ID de cliente del remitente: si su contrato con Speedy tiene más de una dirección de envío, introduzca el ID de cliente de la dirección desde la que quiere enviar. Déjelo vacío para enviar desde la dirección predeterminada de su cuenta de Speedy.
    • Client system ID: déjelo vacío salvo que Speedy le haya dado un client system ID.
    • Peso predeterminado (kg): el peso predeterminado del envío en kilogramos. Si se deja vacío, no se tiene en cuenta.
  7. Configure las opciones de preparación de pedidos y de etiquetas de pedido según sea necesario:
    • Preparar pedidos automáticamente: Nunca, Sí, enviar email de envío con el número de seguimiento o Sí, no enviar email de envío.
    • Etiquetar pedidos con número de seguimiento: añade el número de envío de Speedy al pedido como etiqueta de pedido.
    • Etiqueta personalizada después de la exportación: una etiqueta de pedido que se añade tras cada exportación correcta.
  8. Asigne sus métodos de envío de Shopify a los tipos de servicio de Speedy descritos en Tipos de servicio. Para un método de envío a punto de recogida, use Speedy (office or locker if selected, otherwise address) o Speedy to office or locker. No use Speedy to address para estos métodos: el paquete iría a la dirección del cliente.

Oficina de Speedy donde entrega los paquetes, ID de cliente del remitente y Client system ID solo admiten cifras. Globe no envía ninguna dirección de remitente a Speedy. El remitente es la dirección predeterminada de su cuenta de Speedy, o la dirección de envío que configure con ID de cliente del remitente.


Puede exportar pedidos a Speedy e imprimir etiquetas de envío directamente desde Shopify, de forma masiva o uno a uno. Para el flujo de trabajo de las etiquetas en sí, consulte Creación e impresión de etiquetas de envío.

Globe crea un envío de Speedy con un paquete para cada pedido. El número de envío de Speedy es el número de seguimiento. Globe lo guarda y descarga la etiqueta de Speedy cada vez que imprime, así que puede volver a imprimir una etiqueta más tarde. El número de pedido de Shopify se imprime en la etiqueta.

Cuando la preparación automática está activada, la preparación del pedido recibe el número de envío, Speedy como transportista y el enlace de seguimiento https://www.speedy.bg/en/track-shipment?shipmentNumber=<shipment number>.

Las etiquetas de Speedy en Globe son para entregas dentro de Bulgaria. Antes de enviar un pedido, Globe comprueba los datos que exige Speedy:

  • El teléfono del destinatario, para cualquier entrega: dirección, oficina o locker. Speedy lo acepta como +359… o empezando por 0. Los números extranjeros se aceptan con +.
  • El nombre del destinatario, con al menos 3 caracteres. Un nombre de empresa de 3 o más caracteres convierte a la empresa en destinataria, con el cliente como persona de contacto.
  • Para la entrega a domicilio: la calle, y una ciudad o un código postal de cuatro dígitos. La ciudad puede escribirse en caracteres latinos o cirílicos. La calle y la línea 2 de la dirección juntas pueden tener como máximo 200 caracteres.

Un pedido que no supera una comprobación no se envía a Speedy. Los demás pedidos del lote se siguen enviando.

La integración con Speedy no sincroniza los estados de entrega con Shopify. Globe no cancela envíos de Speedy; cancélelos en su cuenta de Speedy.


Seleccione el tipo de servicio al exportar un pedido, o asígnelo a un método de envío en la configuración del transportista:

Tipo de servicioAdónde va el paquete
Speedy (office or locker if selected, otherwise address)A la oficina o al locker de Speedy que el cliente eligió en el checkout. Un pedido sin punto de recogida va a la dirección del cliente.
Speedy to addressSiempre a la dirección del cliente, también cuando el pedido tiene un punto de recogida.
Speedy to office or lockerA la oficina o al locker de Speedy del pedido. Un pedido sin punto se rechaza.

Un punto de recogida de otra red, o un punto DPD fuera de Bulgaria, detiene la exportación con Speedy (office or locker if selected, otherwise address) y con Speedy to office or locker. Globe nunca envía un pedido así a la dirección del cliente en su lugar. Para enviarlo a la dirección, cree la etiqueta con Speedy to address.

El servicio seleccionado en Servicio de Speedy se aplica a los tres tipos de servicio.


Tanto las oficinas como los lockers de Speedy se identifican por su ID de oficina de Speedy. La integración con Speedy acepta puntos de Speedy de dos listas de puntos de recogida:

  • Puntos de recogida DPD en Bulgaria. Todos los puntos DPD de Bulgaria son oficinas o lockers de Speedy. El ID del punto es BG seguido del ID de oficina de Speedy completado con ceros hasta cinco dígitos: BG08009 es la oficina de Speedy 8009.
  • Oficinas de Speedy de Packeta (transportista de Packeta BG Speedy PP). Son solo oficinas de Speedy, sin lockers. El ID del punto es el ID de oficina de Speedy.

Los puntos DPD de otros países no son puntos de Speedy y se rechazan.

Los lockers de Speedy aceptan paquetes de hasta 20 kg. El límite de una oficina está entre 32 y 1200 kg, según la oficina. Speedy rechaza los paquetes más pesados.


Speedy cobra contra reembolso en Bulgaria solo en EUR. El importe del contrarreembolso se toma del pedido cuando este usa un método de pago contra reembolso. El contrarreembolso funciona en entregas a direcciones, oficinas y lockers.

Un pedido contra reembolso en otra moneda, incluido el BGN, se detiene antes de enviarse a Speedy.


Las etiquetas de Speedy son archivos PDF. Están disponibles los siguientes formatos:

FormatoPosiciones por hoja
10x15 cm1
A6 on A44 (en una sola hoja A4)
A41 (la etiqueta en la mitad superior de una página A4)

No se puede elegir una posición de inicio en la hoja A4. Con 10x15 cm y A4, las etiquetas siguen el orden de su selección. Con A6 on A4, Speedy las ordena por número de envío.


Cuando Speedy rechaza un envío, no se crea nada en Speedy, y Globe muestra el mensaje de Speedy con una indicación para los casos habituales.

ProblemaSolución
La configuración de Speedy está incompletaRellene Usuario y Contraseña. Oficina de Speedy donde entrega los paquetes, ID de cliente del remitente y Client system ID solo admiten cifras.
Speedy rechazó el usuario o la contraseñaCompruebe el Usuario y la Contraseña en la configuración de la integración. Tras este error, Globe no envía los pedidos restantes del lote.
Falta el número de teléfono o tiene un formato que Speedy no aceptaAñada o corrija el número de teléfono en Shopify (+359…, un número que empiece por 0 o un número extranjero con +) y vuelva a crear la etiqueta.
Speedy necesita el nombre del destinatario con al menos 3 caracteresCorrija el nombre en la dirección de envío en Shopify.
La dirección de envío está fuera de Bulgaria, incompleta o es demasiado largaLas etiquetas de Speedy en Globe son para direcciones en Bulgaria. La dirección necesita la calle, y una ciudad o un código postal de cuatro dígitos. La calle y la línea 2 de la dirección juntas pueden tener como máximo 200 caracteres, y la ciudad como máximo 50.
Invalid siteSpeedy no pudo relacionar la ciudad con el código postal, por ejemplo porque el código postal pertenece a otra ciudad. Compruebe la ciudad y el código postal de la dirección de envío.
El punto de recogida no es una oficina ni un locker de SpeedyEl punto pertenece a otra red, o es un punto DPD fuera de Bulgaria. Elija una oficina o un locker de Speedy con la acción Modificar punto de recogida, o cree la etiqueta con Speedy to address para enviar a la dirección del cliente.
El pedido no tiene oficina ni locker de Speedy, o no tiene ID de oficina de SpeedyElija la oficina o el locker con la acción Modificar punto de recogida, o cree la etiqueta con Speedy to address.
La oficina o el locker está cerrado o Speedy no lo conoceElija otra oficina u otro locker de Speedy con la acción Modificar punto de recogida.
Speedy solo cobra contra reembolso en EUREl pedido está en otra moneda. Consulte Pago contra reembolso (COD). Si es Speedy quien rechaza el contrarreembolso, compruebe el importe y su contrato con Speedy.
«The price cannot be determined for provided shipment parameters»Su contrato con Speedy no tiene precio para este servicio y este pagador. Cambie Servicio de Speedy o Envío pagado por en la configuración de la integración.
El pedido no tiene pesoIndique el peso del producto en Shopify, introduzca el peso al crear la etiqueta o rellene el Peso predeterminado (kg).
Speedy está limitando las solicitudes, o Globe no pudo conectarse con SpeedyNo se creó nada. Vuelva a intentarlo en un minuto.
Speedy no respondió a tiempo, la conexión se interrumpió o Speedy no confirmó el envíoPuede que el envío ya exista. Compruebe su cuenta de Speedy antes de volver a crear la etiqueta.
Globe se detuvo antes de enviar un pedido a SpeedyUn pedido anterior del lote no tuvo un resultado claro, o Globe no pudo guardar su envío. No se creó nada para este pedido, así que puede volver a crear su etiqueta.
Speedy creó el envío, pero Globe no pudo guardarloNo vuelva a crear la etiqueta: Speedy crearía un segundo envío. Imprima o cancele en su cuenta de Speedy el envío que indica el mensaje.
«Printed X of Y Speedy labels» o «Error printing Speedy labels»El mensaje indica los números de envío que faltan y el motivo, por ejemplo un número de envío que Speedy no conoce. Si el motivo es un problema de conexión, vuelva a imprimir.