Slovenská pošta API

Globe Pickup Points se integra con Slovenská pošta, el operador postal eslovaco, a través de su API WebEPH, 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 su cuenta de Slovenská pošta (Moje zásielky)
Imprimir etiquetas de envío dentro de Shopify en formato A6 o A4
Enviar a oficinas de correos, casilleros de paquetería BalíkoBOX o a la dirección del cliente
Admitir pago contra reembolso abonado a su IBAN

La integración se ofrece para Eslovaquia y la dirección del remitente siempre es una dirección eslovaca.

Habilitar la integración con la API de Slovenská pošta

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 Slovenská pošta.
Introduzca su ID de usuario y su Clave API: son las credenciales de la API WebEPH de su cuenta de Slovenská pošta. La API WebEPH debe estar activada en la cuenta antes de que la autenticación funcione.
Rellene el bloque del remitente: Nombre del remitente, Calle del remitente, Ciudad del remitente y Código postal del remitente son obligatorios. Organización del remitente, Teléfono del remitente y Email del remitente son opcionales.
Elija el Método de recepción — Enviar en oficina de correos o Entregar al mensajero — según cómo entregue los paquetes.
Elija el Tipo de pago del franqueo: Crédito de franqueo, Máquina de pago, Sellos, Pago por transferencia, Pago en efectivo, Artículo de servicio postal, Factura o En línea.
Marque Contrato si tiene un contrato con Slovenská pošta.
Si envía con pago contra reembolso, rellene el IBAN para contra reembolso.
Opcionalmente, configure Seguro de envío, Valor de seguro predeterminado, Peso predeterminado (kg), 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 productos de Slovenská pošta que haya acordado con el transportista.

Exportar e imprimir etiquetas

Puede exportar pedidos a Slovenská pošta 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.

Cada exportación crea un hárok (hoja de envío) por tipo de producto: los pedidos se agrupan según el producto seleccionado, se abre un hárok para cada grupo, se le añaden los paquetes y, a continuación, el hárok se registra automáticamente. Si el registro falla, los paquetes se crean igualmente y el hárok puede registrarse más tarde en Moje zásielky.

El peso del pedido se convierte de gramos a kilogramos, con un mínimo de 0,1 kg. Si sus pedidos no tienen peso, establezca un Peso predeterminado (kg) en la configuración del transportista.

Cada paquete recibe un número de paquete de Slovenská pošta (por ejemplo, EB534780848SK). Si Enviar pedidos automáticamente está activado, el pedido se cumplimenta con ese número y con un enlace a la página de seguimiento de Slovenská pošta.

Slovenská pošta dispone de un sistema de pruebas WebEPH, pero se activa a nivel de servidor y no por cuenta de transportista: las tiendas en producción siempre se comunican con la API real de Moje zásielky y no hay ningún interruptor de sandbox en la configuración del transportista.

Productos

Seleccione el producto que corresponda a su acuerdo con Slovenská pošta. Todos los pedidos exportados con el mismo producto van al mismo hárok.

Producto	Descripción
Doporučený list	Carta certificada
Poistený list	Carta asegurada
Úradná zásielka	Envío oficial (administrativo)
Balík	Paquete estándar
Expres kuriér	Mensajería exprés
EMS zásielka	Envío exprés EMS
EPG – obchodný balík	Paquete comercial EPG
Balík – zmluvní zákazníci	Paquete para clientes con contrato
Balík – zmluvní zákazníci – Consignment	Paquete para clientes con contrato, consignación
Balíček	Paquete pequeño
Easy Expres 1	Easy Expres, entrega en 1 día
Easy Expres 10	Easy Expres, entrega en 10 días
Prime zásielka	Envío Prime
List	Carta ordinaria

Puntos de recogida vs. entrega a domicilio

El tipo de entrega depende del método de envío elegido por el cliente:

Punto de recogida — cuando el cliente selecciona un punto de recogida de Slovenská pošta (una oficina de correos o un casillero BalíkoBOX) en el proceso de pago, la dirección del destinatario del paquete se sustituye por la dirección del punto de recogida y el paquete se envía con el servicio de recogida. El nombre del punto se añade a la ciudad para que quede visible en la etiqueta.
Entrega a domicilio — el paquete se dirige a la dirección de envío del cliente. Una segunda línea de dirección se añade a la calle.

El nombre, la calle, la ciudad y el código postal del destinatario son obligatorios. Los pedidos a los que les falte alguno de estos datos se rechazan durante la exportación.

Rangos de números de paquete (clientes con contrato)

Si Slovenská pošta le ha asignado su propio rango de números de paquete, rellene los campos avanzados Rango de números de paquete – desde y Rango de números de paquete – hasta (por ejemplo, EB534780848SK). Globe asignará entonces números de ese rango y guardará el siguiente en Siguiente número de paquete después de cada exportación, valor que también puede corregir manualmente.

Los números usan el formato PPNNNNNNNN[C]SS: un prefijo de dos letras, ocho dígitos, un dígito de control opcional y un sufijo de dos letras. Globe calcula el dígito de control por usted. Cuando el rango se agota, las exportaciones fallan hasta que introduzca un rango nuevo. Deje estos campos vacíos para que sea Slovenská pošta quien asigne los números.

Pago contra reembolso (COD)

El COD es compatible. El importe del COD se toma del importe pendiente del pedido en la moneda del pedido y se envía como ingreso bancario al IBAN para contra reembolso configurado en la cuenta del transportista, con el símbolo variable derivado de los dígitos del número de pedido. Sin un IBAN válido, la API rechaza el paquete.

Seguro

El seguro se añade cuando el valor del pedido es superior a cero y, además, el producto es Poistený list o Seguro de envío está activado en la configuración del transportista. El importe asegurado es el valor del pedido en la moneda del pedido, o el Valor de seguro predeterminado si ha establecido uno.

Estado de entrega

La sincronización de estados de entrega no está disponible para Slovenská pošta: los estados de los paquetes no se escriben de vuelta en Shopify y los pagos contra reembolso no se marcan como pagados automáticamente. El número de paquete y el enlace a la página de seguimiento de Slovenská pošta siguen adjuntándose al cumplimiento. Las etiquetas de devolución y la cancelación desde Globe de un paquete ya exportado tampoco son compatibles; cancele los paquetes en Moje zásielky.

Impresión de etiquetas

Las etiquetas de Slovenská pošta se devuelven en PDF y pueden imprimirse en los siguientes formatos:

Formato	Etiquetas por hoja	Posición de inicio
A6	1 (una etiqueta por página)	–
A4	4 (cuadrícula 2×2)	1–4

Al imprimir hojas A4, elija la posición de inicio para reutilizar hojas de etiquetas parcialmente usadas. El formato usado de forma predeterminada puede establecerse con Opción de impresión por defecto en la configuración del transportista.

Solución de problemas

Problema	Solución
Error de autenticación	Compruebe el ID de usuario y la Clave API, y asegúrese de que la API WebEPH esté activada en su cuenta de Slovenská pošta.
Faltan campos obligatorios del remitente	Nombre del remitente, Calle del remitente, Ciudad del remitente y Código postal del remitente deben estar todos rellenos.
Faltan el nombre, la dirección, la ciudad o el código postal del destinatario	La dirección de envío de Shopify está incompleta. En los pedidos con punto de recogida, compruebe que el cliente haya seleccionado realmente un punto en el proceso de pago.
Formato de número de paquete no válido	Use el formato `PPNNNNNNNN[C]SS`, por ejemplo `EB534780848SK`, en los campos del rango de números de paquete.
Rango de números de paquete agotado	Se han usado todos los números asignados. Solicite un nuevo rango a Slovenská pošta y actualice Rango de números de paquete – desde/hasta y Siguiente número de paquete.
Error de validación al exportar	La API rechazó un valor del paquete: lo más habitual es que falte el IBAN para contra reembolso, o que el importe del seguro o del COD no esté permitido por el producto.
No se encontraron IDs de paquete en los pedidos	El pedido no se exportó correctamente, por lo que no hay nada que imprimir. Vuelva a exportarlo antes de imprimir.
Tipo de etiqueta no disponible	La etiqueta todavía no está lista para ese paquete. Espere un momento e imprima de nuevo.
No se pudo conectar con la API de SK Posta	La API WebEPH está temporalmente inaccesible. Reintente la exportación o la impresión más tarde.

Add Slovenská pošta pickup points to your Shopify store — pricing, demo & setup →