Magyar Posta API
Globe Pickup Points se integra con Magyar Posta (MPL), el transportista postal nacional húngaro, lo que permite una exportación de pedidos y una impresión de etiquetas de envío perfectas directamente desde Shopify. Con esta integración, puede:
- Exportar pedidos a Magyar Posta mediante la API MPL v2
- Imprimir etiquetas de envío dentro de Shopify, con el manifiesto EFJ obligatorio incluido en el mismo PDF
- Enviar a ubicaciones PostaPont, oficinas de correos, casilleros de paquetería o a la dirección del cliente
- Admitir pago contra reembolso (COD) y seguro del valor del paquete
- Entregar en Hungría y en otros 24 países europeos
Habilitar la integración con la API de Magyar Posta
Sección titulada «Habilitar la integración con la API de Magyar Posta»- 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 Magyar Posta.
- Introduzca su Clave API y su Secreto API: puede encontrar ambos en su cuenta de Magyar Posta. Use Probar conexión para verificarlos antes de guardar; Globe solicita un token OAuth2 e informa de inmediato de si las credenciales son válidas.
- Introduzca su Contrato: su número de contrato de Magyar Posta.
- Introduzca su Número de cuenta: su código contable de cliente de Magyar Posta. Las exportaciones se rechazan si falta el número de contrato o el número de cuenta.
- Introduzca su Número de cuenta bancaria: Magyar Posta lo utiliza para transferir los importes cobrados contra reembolso. Introduzca los 24 dígitos, sin guiones ni espacios; si su número de cuenta tiene 16 dígitos (2×8), añada
00000000al final (p. ej.,11733003-27329661pasa a ser117330032732966100000000). - Elija la Retención de paquete (días): el número de días que Magyar Posta guarda el paquete: 0, 5 o 10.
- Rellene el bloque del remitente: Nombre del remitente, Calle del remitente, Código postal del remitente, Ciudad del remitente, Teléfono del remitente (formato internacional, p. ej.,
+36123456789) y Email del remitente. - Configure Enviar pedidos automáticamente y Etiquetar pedidos con número de seguimiento según sea necesario.
- Asocie sus métodos de envío de Shopify con el producto de Magyar Posta correspondiente.
Exportar e imprimir etiquetas
Sección titulada «Exportar e imprimir etiquetas»Puede exportar pedidos a Magyar Posta 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 paquete exportado recibe un número de seguimiento, que se usa para el seguimiento del cumplimiento y que puede consultarse en la página de seguimiento de Magyar Posta. Si el pedido no tiene peso, Globe envía un valor predeterminado de 100 g.
Manifiesto (EFJ) y cierre diario
Sección titulada «Manifiesto (EFJ) y cierre diario»Los mensajeros de Magyar Posta exigen que se les entregue un manifiesto EFJ (Elektronikus Feladójegyzék) junto con los paquetes; sin él pueden negarse a aceptar el envío. Globe se encarga de esto por usted: al imprimir las etiquetas, cierra los envíos en Magyar Posta y añade el manifiesto al mismo PDF. El archivo impreso contiene, en este orden:
- Las etiquetas de envío
- La nota de entrega: el recibo en papel que firma el mensajero
- El resumen de la lista de envío (y una lista de envío de palés, si el lote contiene palés)
El PDF generado se almacena, por lo que las reimpresiones son instantáneas y nunca fallan con un error de «ya cerrado». Si el manifiesto no puede generarse, Globe devuelve igualmente las etiquetas y le advierte de que el manifiesto debe producirse por separado antes de que llegue el mensajero.
Productos
Sección titulada «Productos»Asocie cada método de envío de Shopify con el producto de Magyar Posta acordado en su contrato:
| Producto | Código de servicio MPL | Descripción |
|---|---|---|
| Business Parcel | A_175_UZL | Servicio contractual de paquetería para empresas |
| Postal Parcel | A_177_MPC | Servicio de paquetería postal estándar |
Puntos de recogida vs. entrega a domicilio
Sección titulada «Puntos de recogida vs. entrega a domicilio»El modo de entrega se deduce automáticamente del punto de recogida que el cliente seleccionó en el proceso de pago:
| Elección del cliente | Modo de entrega MPL |
|---|---|
| PostaPont | PP |
| Oficina de correos | PM |
| Casillero de paquetería (Csomagautomata) | CS |
| Sin punto de recogida — dirección de envío | HA (entrega a domicilio) |
Los envíos a casilleros de paquetería siempre se registran con el tamaño de paquete L, ya que Magyar Posta exige un tamaño para las entregas en casilleros.
Pago contra reembolso (COD)
Sección titulada «Pago contra reembolso (COD)»Magyar Posta admite COD. Cuando un pedido usa un método de pago contra reembolso, Globe añade el servicio adicional de COD y envía el importe del COD del pedido junto con el envío. Los importes cobrados se liquidan mediante transferencia bancaria al número de cuenta bancaria configurado en el transportista: asegúrese de introducirlo con 24 dígitos.
Los pedidos realizados en HUF se aseguran además por su valor de pedido (con el límite máximo de Magyar Posta de 2.000.000 HUF). Los pedidos en otras monedas se exportan sin seguro de valor.
Estado de entrega
Sección titulada «Estado de entrega»La sincronización de estados de entrega no está disponible para Magyar Posta: los estados de los paquetes no se escriben de vuelta en el pedido. Los cumplimientos de Shopify siguen llevando el número de seguimiento de MPL y el enlace a la página de seguimiento de Magyar Posta. Las etiquetas de devolución tampoco son compatibles.
Impresión de etiquetas
Sección titulada «Impresión de etiquetas»Magyar Posta ofrece la mayor variedad de formatos de etiqueta de todos los transportistas de Globe. Elija el que se ajuste a su impresora y a su papelería:
| Formato | Descripción |
|---|---|
A4 | Etiqueta de dirección A4 a tamaño completo, 210 × 297 mm |
A5 | Etiqueta A5 colocada en la parte superior de una hoja A4 |
A5inA4 | Dos etiquetas A5 horizontales en una hoja A4 |
A5E | Etiqueta A5 horizontal sin las dos pestañas adicionales |
A5E_EXTRA | Etiqueta A5 horizontal con las dos pestañas adicionales |
A5E_STAND | Etiqueta A5 vertical sin las dos pestañas adicionales |
A6 | Etiqueta A6, 148,5 × 105 mm |
A6inA4 | Cuatro etiquetas A6 en una hoja A4 |
A4ONE | Etiqueta y lista de envío de un solo paquete en una hoja A4 |
Las etiquetas siempre se generan en PDF y la impresión siempre empieza en la primera posición: en Magyar Posta no existe desplazamiento para hojas parcialmente usadas. El número de teléfono y la dirección de correo electrónico del destinatario se imprimen en la etiqueta.
Solución de problemas
Sección titulada «Solución de problemas»| Problema | Solución |
|---|---|
| Error de autenticación | La clave API o el secreto API son incorrectos. Vuelva a introducirlos y pulse Probar conexión: debe informar de una conexión correcta. |
| Error de configuración — falta el contrato o el número de cuenta | Tanto Contrato como Número de cuenta son obligatorios. Rellénelos y exporte de nuevo. |
| Faltan la ciudad, el código postal, la dirección o el nombre del destinatario | La dirección de envío de Shopify está incompleta. Complete la dirección en el pedido antes de exportar. |
| Error de validación con un parámetro y un código | Magyar Posta rechazó los datos del envío. El mensaje indica el campo problemático: corríjalo en el pedido o en la configuración del transportista y exporte de nuevo. |
| No se encontraron números de seguimiento — no se pueden imprimir las etiquetas | El pedido nunca se exportó correctamente. Expórtelo primero y luego imprima. |
| Advertencia: falló la generación del manifiesto | Las etiquetas se imprimieron pero falta el manifiesto EFJ. Imprima de nuevo o produzca el manifiesto antes de que llegue el mensajero: Magyar Posta puede rechazar los paquetes sin él. |
| El importe del COD no se liquida | Compruebe el Número de cuenta bancaria: debe tener exactamente 24 dígitos, sin guiones ni espacios. |