Ir al contenido

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»
  1. 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.
  2. 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.
  3. Introduzca su Contrato: su número de contrato de Magyar Posta.
  4. 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.
  5. 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 00000000 al final (p. ej., 11733003-27329661 pasa a ser 117330032732966100000000).
  6. Elija la Retención de paquete (días): el número de días que Magyar Posta guarda el paquete: 0, 5 o 10.
  7. 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.
  8. Configure Enviar pedidos automáticamente y Etiquetar pedidos con número de seguimiento según sea necesario.
  9. Asocie sus métodos de envío de Shopify con el producto de Magyar Posta correspondiente.

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.

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:

  1. Las etiquetas de envío
  2. La nota de entrega: el recibo en papel que firma el mensajero
  3. 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.


Asocie cada método de envío de Shopify con el producto de Magyar Posta acordado en su contrato:

ProductoCódigo de servicio MPLDescripción
Business ParcelA_175_UZLServicio contractual de paquetería para empresas
Postal ParcelA_177_MPCServicio de paquetería postal estándar

El modo de entrega se deduce automáticamente del punto de recogida que el cliente seleccionó en el proceso de pago:

Elección del clienteModo de entrega MPL
PostaPontPP
Oficina de correosPM
Casillero de paquetería (Csomagautomata)CS
Sin punto de recogida — dirección de envíoHA (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.


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.


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.


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:

FormatoDescripción
A4Etiqueta de dirección A4 a tamaño completo, 210 × 297 mm
A5Etiqueta A5 colocada en la parte superior de una hoja A4
A5inA4Dos etiquetas A5 horizontales en una hoja A4
A5EEtiqueta A5 horizontal sin las dos pestañas adicionales
A5E_EXTRAEtiqueta A5 horizontal con las dos pestañas adicionales
A5E_STANDEtiqueta A5 vertical sin las dos pestañas adicionales
A6Etiqueta A6, 148,5 × 105 mm
A6inA4Cuatro etiquetas A6 en una hoja A4
A4ONEEtiqueta 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.


ProblemaSolución
Error de autenticaciónLa 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 cuentaTanto 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 destinatarioLa 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ódigoMagyar 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 etiquetasEl pedido nunca se exportó correctamente. Expórtelo primero y luego imprima.
Advertencia: falló la generación del manifiestoLas 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 liquidaCompruebe el Número de cuenta bancaria: debe tener exactamente 24 dígitos, sin guiones ni espacios.