Ir al contenido

Hrvatska pošta API

Globe Pickup Points se integra con Hrvatska pošta, el operador postal croata, a través de su API HP Shipping Service. Con esta integración, puede:

  • Exportar pedidos a Hrvatska pošta directamente desde Shopify
  • Imprimir etiquetas de envío dentro de Shopify en formato A6 o A6 en A4
  • Enviar paquetes Paket 24 a oficinas de correos, lockers (paketomati) o a la dirección del cliente
  • Cobrar contra reembolso en EUR
  • Seguir los paquetes en la página de seguimiento de Hrvatska pošta

La integración solo cubre envíos dentro de Croacia.


Habilitar la integración con la API de Hrvatska pošta

Sección titulada «Habilitar la integración con la API de Hrvatska pošta»
  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 Hrvatska pošta.
  2. Introduzca su Usuario y su Contraseña. Son las credenciales de la API que Hrvatska pošta entrega a los clientes con contrato. Solicítelas a su gestor comercial de Hrvatska pošta o escriba a npa-3pdx@posta.hr.
  3. Deje el Entorno en Producción. Desarrollo se conecta al sistema de pruebas de Hrvatska pošta.
  4. Elija el Servicio: Paket 24 D+1, Paket 24 D+2 o Paket 24 D+3. Se aplica a todos los paquetes. D+1 entrega el siguiente día laborable.
  5. Elija Cómo entrega los paquetes a HP:
    • Un mensajero de HP los recoge en mi dirección (preseleccionada): un mensajero de Hrvatska pošta recoge los paquetes en la dirección del remitente. Si nadie le entrega los paquetes, Hrvatska pošta cierra el envío. No mantenga esta opción si lleva usted mismo los paquetes a Hrvatska pošta.
    • Los llevo a una oficina de correos: introduzca el código postal de la oficina de correos en Oficina de correos o taquilla de entrega.
    • Los deposito en una taquilla: introduzca el código de 5 dígitos del locker en Oficina de correos o taquilla de entrega. Los paquetes depositados en un locker solo pueden ir a una oficina de correos o a un locker, no a una dirección, y pueden pesar como máximo 30 kg.
  6. Rellene los datos del remitente. Nombre de la empresa remitente (se imprime como remitente en cada etiqueta), Calle del remitente, Ciudad del remitente, Código postal del remitente (5 dígitos) y Teléfono del remitente son obligatorios. Número de casa del remitente y Email del remitente son opcionales. El número de casa también puede escribirse en Calle del remitente.
  7. Haga clic en Mostrar configuración avanzada para establecer:
    • Tamaño del compartimento en la taquilla: el tamaño de compartimento declarado para los paquetes que van a un locker o que usted deposita en uno, a elegir entre XS (9 x 16 x 64 cm), S (9 x 38 x 64 cm), M (19 x 38 x 64 cm) y L (39 x 38 x 64 cm). M está preseleccionado.
    • Peso predeterminado (kg): se usa cuando un pedido no tiene peso.
  8. Configure la preparación de pedidos y las etiquetas de pedido: 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, Etiqueta personalizada después de la exportación y Etiqueta personalizada después de imprimir.
  9. En Métodos de envío, asigne sus métodos de envío de Shopify a los tipos de Hrvatska pošta descritos en Tipos de servicio.

Puede exportar pedidos a Hrvatska pošta e imprimir etiquetas de envío directamente desde Shopify, de forma masiva o uno a uno. Consulte Creación e impresión de etiquetas de envío.

  • Cada etiqueta corresponde a un envío con un solo bulto.
  • El peso del envío es el peso del pedido en Shopify, convertido de gramos a kilogramos. Si el pedido no tiene peso, Globe usa el Peso predeterminado (kg). También puede introducir el peso en el panel de creación de etiquetas, en Avanzado → Peso del envío (kg).
  • Hrvatska pošta no tiene segunda línea de dirección, así que Globe añade la línea 2 de la dirección a la calle.
  • El número de pedido de Shopify se imprime en la etiqueta.

Antes de enviar un pedido, Globe comprueba el país de destino, el punto de recogida, el nombre, la calle, la ciudad, el código postal y el teléfono del destinatario, el peso y el importe del contrarreembolso. Un pedido que no supera una comprobación no se envía, y el panel de creación de etiquetas muestra el motivo. Si faltan las credenciales, los datos del remitente están incompletos o falta el código del punto de depósito, se detiene toda la exportación.

Cada paquete recibe un número de paquete de Hrvatska pošta. Si activa Preparar pedidos automáticamente, el pedido se marca como preparado con este número y un enlace a la página de seguimiento de Hrvatska pošta: https://posiljka.posta.hr/hr/tracking/trackingdata?barcode=<parcel number>.

Globe no vuelve a intentar una exportación por su cuenta. Cuando una exportación termina sin una respuesta clara de Hrvatska pošta, puede que el paquete ya exista. Compruebe su cuenta de Hrvatska pošta antes de volver a crear la etiqueta.


Elija el Tipo de cada pedido en el panel de creación de etiquetas, o asigne un tipo a cada método de envío en la configuración del transportista. Todos los tipos usan el plazo de entrega de Paket 24 establecido en Servicio.

TipoEntrega en
Hrvatska pošta (post office or parcel locker if selected, otherwise address)La oficina de correos o el locker que el cliente seleccionó en el checkout. Los pedidos sin punto de recogida van a la dirección de envío.
Hrvatska pošta Paket 24 (address)La dirección de envío del cliente. Se ignora el punto de recogida del pedido.
Hrvatska pošta Paket 24 (post office or parcel locker)La oficina de correos o el locker del pedido. Un pedido sin punto se rechaza.

Puede asignar el primer tipo tanto a métodos de envío con punto de recogida como a métodos de entrega a domicilio.

Los tipos primero y tercero rechazan un pedido cuyo punto de recogida pertenece a otro transportista. Globe no envía ese paquete a la dirección del cliente en su lugar. Elija un punto de Hrvatska pošta con la acción Modificar punto de recogida, o seleccione Hrvatska pošta Paket 24 (address) para enviar a la dirección.

Los servicios EasyReturn y de palés de Hrvatska pošta no están disponibles.


Para ofrecer puntos de Hrvatska pošta en el checkout, añada Hrvatska pošta como transportista de puntos de recogida en Globe: consulte Añadir transportistas de puntos de recogida. Globe carga los puntos a partir de los datos públicos de posta.hr:

  • Oficinas de correos: oficinas de correos ordinarias y de horario reducido. No se incluyen las oficinas de temporada ni las de aduanas, ni las oficinas sin horario de apertura publicado, como las que están cerradas temporalmente.
  • Lockers: los paketomati de Hrvatska pošta.

Globe envía con el paquete el código de 5 dígitos del punto de Hrvatska pošta: el código postal de una oficina de correos o el código de un locker, que empieza por 6. También se aceptan los puntos de Hrvatska pošta que llegan a través del transportista de puntos de recogida Packeta.

Las entregas en locker tienen requisitos adicionales:

  • El teléfono del destinatario debe ser un número móvil croata (091, 092, 095, 097, 098 o 099). Hrvatska pošta le envía el PIN por SMS.
  • El paquete puede pesar como máximo 30 kg.
  • El tamaño del compartimento se toma de Tamaño del compartimento en la taquilla.

Las entregas en oficina de correos y a domicilio también necesitan un número de teléfono, pero se acepta cualquier número.


Hrvatska pošta cobra contra reembolso solo en EUR, hasta 13.300 EUR por paquete. Un pedido contra reembolso en otra moneda, o con un importe superior, se rechaza y no se crea ningún paquete. El pago contra reembolso funciona en entregas a domicilio, en oficina de correos y en locker.

  • Globe rellena el importe del contrarreembolso con el importe pendiente del pedido cuando reconoce el método de pago como contra reembolso, por ejemplo el Pago contra reembolso (COD) de Shopify.
  • Si Globe no reconoce su método de pago contra reembolso, por ejemplo uno con nombre en croata, no se rellena ningún importe y el panel de creación de etiquetas avisa de que el pedido no está pagado. Introduzca el importe usted mismo.
  • Puede cambiar el importe en el panel de creación de etiquetas, en Avanzado → Importe contra reembolso.

Las etiquetas se descargan de Hrvatska pošta en PDF cuando las imprime. Están disponibles los siguientes formatos:

FormatoEtiquetas por página
A61
A6 on A44 (2×2)

En las hojas A4, la impresión siempre empieza en la primera posición: no se puede elegir una posición de inicio. El formato predeterminado se establece con Opción de impresión por defecto en la configuración del transportista.

Cuando se devuelven todas las etiquetas, las etiquetas A6 se imprimen en el orden en que las seleccionó. En las hojas A4, Hrvatska pošta ordena las etiquetas por número de paquete. Las etiquetas de paquetes cancelados, y de paquetes que no están en esta cuenta de Hrvatska pošta, se omiten sin error.


ProblemaSolución
El usuario y la contraseña no están configurados, o Hrvatska pošta los rechazóCompruebe el Usuario y la Contraseña en la configuración del transportista. No se creó ningún paquete.
El inicio de sesión en Hrvatska pošta falló, o Globe no pudo conectarse con Hrvatska poštaNo se creó ningún paquete. Vuelva a intentarlo en un minuto.
La dirección del remitente está incompletaRellene los campos del remitente que indica el mensaje. El Código postal del remitente debe tener 5 dígitos.
La configuración está incompleta: falta el código postal de la oficina de correos o el código del locker donde deposita los paquetesIntroduzca el código de 5 dígitos en Oficina de correos o taquilla de entrega.
Hrvatska pošta solo entrega dentro de CroaciaEl pedido va a otro país. Use otro transportista para ese pedido.
El punto de recogida no es una oficina de correos ni un locker de Hrvatska poštaEl cliente eligió un punto de otro transportista. Elija un punto de Hrvatska pošta con la acción Modificar punto de recogida, o seleccione Hrvatska pošta Paket 24 (address).
El pedido no tiene oficina de correos ni locker de Hrvatska pošta, o su punto no tiene código de 5 dígitosElija el punto con la acción Modificar punto de recogida, o seleccione un tipo que envíe a la dirección.
Los paquetes depositados en un locker no pueden ir a una direcciónPara enviar a una dirección, configure Cómo entrega los paquetes a HP con la opción de oficina de correos o de mensajero.
El pedido no tiene pesoEstablezca el peso de los productos en Shopify, introduzca el peso en el panel de creación de etiquetas o configure el Peso predeterminado (kg).
Los lockers admiten como máximo 30 kgEl límite se aplica a la entrega en locker y al depósito en locker. Envíe un paquete más pesado a una oficina de correos o a una dirección, y configure Cómo entrega los paquetes a HP con la opción de oficina de correos o de mensajero.
Los lockers necesitan un número móvil croata, o falta el número de teléfonoCorrija el número de teléfono del pedido. Para un locker debe ser un número móvil croata (091, 092, 095, 097, 098 o 099).
El código postal no es croata, o falta el nombre, la calle o la ciudad del destinatarioComplete la dirección de envío del pedido. El código postal debe tener 5 dígitos.
Contra reembolso en una moneda distinta del EUR, o por encima de 13.300 EURConsulte Pago contra reembolso (COD).
Un mensaje que empieza por «Hrvatska pošta:»Hrvatska pošta rechazó el paquete. Su texto, a menudo en croata, indica el campo rechazado. Corrija el valor y vuelva a exportar.
Hrvatska pošta no respondió a tiempo, la conexión se interrumpió o el paquete no se confirmóPuede que el paquete ya exista. Compruebe su cuenta de Hrvatska pošta antes de volver a crear la etiqueta.
Hrvatska pošta creó el paquete, pero Globe no pudo guardarloNo vuelva a crear la etiqueta: Hrvatska pošta crearía un segundo paquete. Escriba a help@appfleece.com con el número de paquete.
El transportista no devolvió la etiquetaVuelva a imprimir en unos momentos. Hrvatska pošta no devuelve etiqueta para un paquete cancelado ni para un paquete que no está en esta cuenta. Si la impresión sigue fallando, compruebe el Usuario y la Contraseña.
Faltan algunas etiquetas en el PDFHrvatska pošta omite las etiquetas de los paquetes cancelados y de los paquetes que no están en esta cuenta.