SPS API
Globe Pickup Points se integra con SPS (Slovak Parcel Service) a través de la API SOAP WebShip, lo que permite la exportación de pedidos y la impresión de etiquetas de envío directamente desde Shopify. Con esta integración, puede:
- Exportar pedidos a SPS WebShip directamente desde Shopify
- Imprimir etiquetas de envío dentro de Shopify
- Enviar a puntos de recogida Balíkovo, terminales de paquetería de SPS o a la dirección del cliente
- Admitir pago contra reembolso (COD) con abono en su cuenta bancaria
Habilitar la integración con la API de SPS
Sección titulada «Habilitar la integración con la API de SPS»- 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 SPS.
- Introduzca su Usuario y su Contraseña: son sus credenciales de WebShip. Contacte con su representante comercial de SPS para obtener acceso al servicio web.
- Si usa pago contra reembolso, introduzca el IBAN para contra reembolso y el SWIFT/BIC contra reembolso de la cuenta bancaria en la que SPS debe ingresar el dinero cobrado.
- Opcionalmente, establezca un Valor de seguro predeterminado que se aplique a todos los envíos. Si lo deja en blanco, se usa el total del pedido.
- 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.
- Asocie sus métodos de envío de Shopify con los servicios de SPS que haya acordado con el transportista.
No existe un entorno de pruebas de SPS: WebShip tiene un único endpoint de producción, por lo que las credenciales que introduzca crean envíos reales.
Exportar e imprimir etiquetas
Sección titulada «Exportar e imprimir etiquetas»Puede exportar pedidos a SPS 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 envío se crea y su etiqueta se genera en una sola llamada a la API, por lo que las etiquetas están listas para imprimir inmediatamente después de la exportación. La referencia del paquete que se envía a SPS es el nombre de su pedido de Shopify sin el # inicial, acortado a 35 caracteres si es necesario.
Una vez exportado, el paquete recibe un número de envío de SPS que se usa para el seguimiento del cumplimiento y que puede consultarse en la página de seguimiento de SPS. Si el pedido incluye una dirección de correo electrónico del cliente, Globe también pide a SPS que notifique al destinatario por email.
Tipos de servicio
Sección titulada «Tipos de servicio»Al asociar métodos de envío o exportar un pedido, seleccione el servicio de SPS que corresponda a su acuerdo:
| Servicio | Descripción |
|---|---|
| SPS Standard | Entrega estándar a domicilio o a empresa |
| SPS Express | Entrega urgente |
| SPS 9:00 | Entrega garantizada antes de las 9:00 |
| SPS 12:00 | Entrega garantizada antes de las 12:00 |
| SPS Saturday Delivery | Entrega en sábado |
| SPS Balíkovo | Entrega en un punto de recogida Balíkovo |
| SPS Parcel Terminal | Entrega en un terminal de paquetería de SPS (casillero) |
Los pedidos pueden exportarse a 11 países de destino: Eslovaquia, República Checa, Austria, Hungría, Alemania, Polonia, Rumanía, Croacia, Eslovenia, Bulgaria y Serbia.
Puntos de recogida vs. entrega a domicilio
Sección titulada «Puntos de recogida vs. entrega a domicilio»- SPS Balíkovo y SPS Parcel Terminal envían el paquete al punto de recogida que el cliente seleccionó en el proceso de pago. Globe transmite el ID del punto a SPS y pone el nombre del cliente en la etiqueta como persona de contacto.
- Todos los demás servicios entregan en la dirección de envío del cliente.
Si se usa un servicio Balíkovo o Parcel Terminal pero el pedido no lleva ningún punto de recogida, el envío se crea a la dirección postal del cliente en lugar de a un punto de recogida. Asegúrese de que sus métodos de envío de puntos de recogida estén asociados al servicio Balíkovo o Parcel Terminal y de que el selector esté activo en el proceso de pago — consulte Añadir transportistas de puntos de recogida.
Valor de seguro
Sección titulada «Valor de seguro»SPS exige un valor de seguro en todos los envíos. Globe lo resuelve en este orden:
- Valor de seguro establecido en el envío concreto en el momento de la exportación
- Valor de seguro predeterminado de la configuración del transportista
- El total del pedido, si no se ha establecido ninguno de los anteriores
Pago contra reembolso (COD)
Sección titulada «Pago contra reembolso (COD)»SPS admite COD. Cuando un pedido tiene un importe pendiente de cobro, Globe envía el importe del COD junto con la moneda del pedido y el IBAN para contra reembolso y el SWIFT/BIC contra reembolso de su configuración del transportista, para que SPS sepa dónde ingresar el dinero. Los pedidos sin nada pendiente de cobro se exportan como envíos normales.
Estado de entrega
Sección titulada «Estado de entrega»La sincronización de estados de entrega no está disponible para SPS: los estados de los paquetes no se escriben de vuelta en Shopify, por lo que el progreso debe consultarse en la página de seguimiento de SPS o en su portal de SPS. El número de envío y el enlace de seguimiento siguen adjuntándose al cumplimiento. Las etiquetas de devolución tampoco son compatibles; gestione las devoluciones directamente con SPS.
Impresión de etiquetas
Sección titulada «Impresión de etiquetas»Las etiquetas de SPS se generan como PDF en el momento de la exportación y pueden imprimirse en los siguientes formatos:
| Formato | Etiquetas por hoja |
|---|---|
| A6 | 1 |
| A6 en A4 | 4 (cuadrícula 2×2) |
Al imprimir A6 en A4, puede seleccionar una posición de inicio en la hoja (posiciones 1–4) para reutilizar hojas de etiquetas parcialmente usadas.
Solución de problemas
Sección titulada «Solución de problemas»| Problema | Solución |
|---|---|
| «Username or password is not configured» | Tanto el usuario como la contraseña de WebShip son obligatorios. Rellénelos en la cuenta del transportista y guarde. |
| Error de autenticación de WebShip | Verifique sus credenciales de WebShip y confirme con su representante comercial de SPS que el acceso al servicio web está habilitado para la cuenta. |
| Exportación rechazada con un mensaje de error de SPS | WebShip valida el envío y devuelve el motivo: normalmente una dirección incompleta, un código postal de destino no admitido o un servicio que no está habilitado en su cuenta. Corrija el pedido y expórtelo de nuevo. |
| «SPS did not return a tracking number» | SPS aceptó la solicitud pero no envió ningún número de envío. Revise el portal de SPS por si hay un envío duplicado antes de volver a exportar. |
| Paquete enviado a la dirección particular en lugar de a un punto de recogida | El pedido se exportó con un servicio Balíkovo o Parcel Terminal sin un punto de recogida asociado. Compruebe que el cliente seleccionó un punto en el proceso de pago y que la asociación del método de envío es correcta. |
| «No label URLs found for these SPS orders» | Las etiquetas ya no están disponibles para ese lote. Vuelva a exportar los pedidos para generar etiquetas nuevas. |
| No se pueden recuperar las etiquetas de SPS WebShip | No se pudieron descargar los PDF de las etiquetas desde SPS. Espere un momento e imprima el lote de nuevo. |