Nova Post API
Globe Pickup Points se integra con Nova Post y permite exportar pedidos e imprimir etiquetas de envío directamente desde Shopify para paquetes enviados desde un país de la UE. Con esta integración, puede:
- Exportar pedidos a Nova Post directamente desde Shopify
- Imprimir etiquetas de envío dentro de Shopify
- Enviar a una sucursal, un locker o un punto PUDO de Nova Post elegido en el checkout, o a la dirección del cliente
- Enviar paquetes a Ucrania, Moldavia y el Reino Unido con una factura aduanera generada a partir del pedido
- Cobrar contra reembolso en las rutas en las que Nova Post lo ofrece
Habilitar la integración con la API de Nova Post
Sección titulada «Habilitar la integración con la API de Nova Post»- 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 Nova Post.
- Introduzca su Clave API. Créela en my.novapost.com, en Integrations, API keys, con la sesión iniciada como el representante autorizado que figura en su contrato con Nova Post.
- Seleccione el Entorno: Producción para envíos reales, Desarrollo para el entorno de pruebas de Nova Post. Una clave de producción solo funciona con Producción, y una clave de prueba solo con Desarrollo.
- Introduzca su Número de contrato. Usted paga los envíos como remitente, y Nova Post los factura a este contrato. Si tiene un contrato aparte para envíos internacionales, introdúzcalo en Número de contrato internacional. Globe lo usará entonces para los paquetes a otro país.
- Introduzca su Identificación fiscal de la empresa: el número de identificación fiscal de la organización que figura en su contrato con Nova Post, por ejemplo IČO, NIP o Steuernummer. Debe ser una organización para la que se creó su clave API.
- Rellene Nombre de la empresa remitente, Nombre del remitente (la persona de contacto que aparece en la etiqueta), Teléfono del remitente (un número internacional completo, por ejemplo
+420777123456), Email del remitente y País del remitente. El país del remitente debe estar en la UE. - Indique cómo llegan sus paquetes a Nova Post:
- En una sucursal: introduzca la Sucursal de Nova Post para entregar paquetes, ya sea el número de sucursal tal como lo muestra Nova Post (por ejemplo
14/1) o el ID de división. - Por mensajero desde su dirección: deje la sucursal vacía y rellene Calle del remitente, Número de casa del remitente, Código postal del remitente y Ciudad del remitente. El número de casa también puede escribirse en Calle del remitente.
- En una sucursal: introduzca la Sucursal de Nova Post para entregar paquetes, ya sea el número de sucursal tal como lo muestra Nova Post (por ejemplo
- Introduzca Longitud por defecto en mm, Ancho por defecto en mm y Altura por defecto en mm. Nova Post exige longitud, anchura y altura en cada paquete y las usa para el peso volumétrico. Globe envía estos valores para todos los paquetes.
- Si ofrece pago contra reembolso, rellene los ajustes de contra reembolso descritos en Pago contra reembolso (COD).
- En Mostrar configuración avanzada puede establecer Condiciones aduaneras (Incoterms), Número EORI del remitente, Descripción por defecto del contenido, Código HS por defecto y Peso predeterminado (kg). Los ajustes aduaneros se describen en Aduanas y envíos internacionales.
- Configure Preparar pedidos automáticamente, Etiquetar pedidos con número de seguimiento y Etiqueta personalizada después de la exportación según sea necesario.
- En Métodos de envío, asigne sus métodos de envío de Shopify a los servicios de Nova Post descritos en Tipos de servicio. Pueden asignarse métodos de envío para los 27 países de la UE, Ucrania, Moldavia y el Reino Unido.
Exportar e imprimir etiquetas
Sección titulada «Exportar e imprimir etiquetas»Puede exportar pedidos a Nova Post 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 para el flujo de trabajo general.
Antes de enviar el primer pedido, Globe comprueba los ajustes e inicia sesión en Nova Post con su clave API. Si falta un ajuste o la clave se rechaza, no se envía ningún pedido. Globe también comprueba en cada pedido los datos que Nova Post rechazaría, como un número de teléfono o un número de casa que falte. Un pedido que no supera estas comprobaciones no se envía, así que puede corregirlo y volver a exportarlo.
Cada pedido se transmite como un envío con un paquete:
- Peso: el peso del pedido, redondeado a 10 g (como mínimo 10 g)
- Dimensiones: la longitud, la anchura y la altura predeterminadas de los ajustes
- Valor asegurado: el Valor declarado, por defecto el total del pedido, en la moneda del pedido
- Contenido: la Descripción del contenido, o los títulos de los productos del pedido si está vacía
Puede cambiar el peso, el valor declarado, el importe contra reembolso, el código HS y la descripción del contenido de un envío en Avanzado al crear la etiqueta.
Nova Post devuelve un número de envío como SHCZ0123456789. Globe lo guarda como número de seguimiento y descarga la etiqueta de Nova Post cada vez que imprime. El enlace de seguimiento abre https://novapost.com/en-<country>/tracking/<shipment number>/ para el país del número de envío (por ejemplo en-pl para SHPL…), o en-cz cuando ese país no tiene página de seguimiento. Si activa Preparar pedidos automáticamente, la preparación del pedido se crea con el número de envío, el nombre de transportista Nova Post y este enlace.
Si Nova Post no responde a tiempo o la conexión se interrumpe, puede que el envío exista en Nova Post aunque Globe no tenga número para él. Globe marca entonces el pedido con una nota para que compruebe my.novapost.com antes de volver a crear la etiqueta, y detiene el lote antes del siguiente pedido. Los pedidos que no se enviaron pueden volver a exportarse sin riesgo.
Globe no cancela envíos en Nova Post. Para cancelar un envío, elimínelo en my.novapost.com.
Tipos de servicio
Sección titulada «Tipos de servicio»Al asignar métodos de envío o al crear una etiqueta, elija uno de estos servicios:
| Servicio | Entrega |
|---|---|
| Nova Post (branch or parcel locker if selected, otherwise address) | En la sucursal, el locker o el punto PUDO de Nova Post que el cliente eligió en el checkout. Un pedido sin punto de recogida va a la dirección del cliente. |
| Nova Post courier (address) | Siempre a la dirección de envío del cliente, también cuando el pedido tiene un punto de recogida. |
| Nova Post branch or parcel locker | En la sucursal, el locker o el punto PUDO de Nova Post del pedido. Un pedido sin punto se rechaza. |
Con los dos servicios que entregan en un punto, un punto de recogida de la red de otro transportista se rechaza en lugar de enviarse a la dirección del cliente. Elija un punto de Nova Post con la acción Modificar punto de recogida, o cree la etiqueta con Nova Post courier (address).
Puntos de recogida o entrega a domicilio
Sección titulada «Puntos de recogida o entrega a domicilio»Los servicios que entregan en un punto envían el paquete a la sucursal, el locker o el punto PUDO de Nova Post que el cliente eligió en el checkout. Globe envía el ID de Nova Post de ese punto, así que el punto tiene que proceder de la red de Nova Post en el selector de puntos de recogida de Globe. Para ofrecer puntos de Nova Post en el checkout, añada Nova Post como transportista de puntos de recogida: consulte Añadir transportistas de puntos de recogida. Las sucursales de Nova Post que otro transportista incluye en su propia red, por ejemplo Packeta o Boxpi, llevan los ID de ese transportista y se rechazan.
Nova Post no tiene sucursales, lockers ni puntos PUDO en Bulgaria, Croacia, Chipre, Grecia, Malta y Eslovenia. Los paquetes a estos países solo pueden ir a la dirección del cliente.
Para la entrega a domicilio, Nova Post necesita la calle y el número de casa en campos separados. Globe toma el número de casa de la primera línea de dirección (Vinohradská 12/34, 12 rue de la Paix) o del principio de la segunda línea, y envía como piso un número de piso escrito después del número de casa (byt 4, m. 5, Apt 2B). Una dirección sin número de casa, calle, ciudad o código postal se rechaza.
Nova Post exige el teléfono del destinatario en todos los envíos, también en sucursales y lockers. Un número sin prefijo de país se interpreta como un número del país de destino. Nova Post rechaza a un destinatario en Polonia sin número polaco (+48) y a un destinatario en Ucrania sin número ucraniano (+380).
Aduanas y envíos internacionales
Sección titulada «Aduanas y envíos internacionales»Los paquetes que salen de la UE (a Ucrania, Moldavia o el Reino Unido) necesitan una factura aduanera. Globe rellena la propia factura comercial de Nova Post a partir del pedido. Puede imprimirla con la etiqueta (consulte Impresión de etiquetas).
La factura incluye el valor total de la mercancía, la moneda del pedido, el motivo de exportación Selling y las Condiciones aduaneras (Incoterms) de los ajustes: DAP (el cliente paga los aranceles), la opción predeterminada, o DDP (usted paga los aranceles). Cada línea de producto que se envía y tiene precio se convierte en un artículo con:
- el título del producto en Shopify, como nombre del artículo y como su nombre en inglés (Nova Post espera ese nombre en inglés)
- la cantidad y el precio unitario
- el código HS del producto en Shopify o, si no lo tiene, el Código HS establecido al crear la etiqueta o el Código HS por defecto
- el país de origen del producto, cuando está configurado
- una parte del peso del paquete proporcional al peso del producto, de modo que los pesos de los artículos sumen el peso del paquete, como exige Nova Post
Los códigos HS necesitan al menos 6 dígitos. Nova Post acepta de 8 a 10 dígitos, así que Globe completa con ceros un código de 6 dígitos (610910 pasa a ser 61091000). Los paquetes a Moldavia llevan exactamente 10 dígitos. Cuando ninguna línea de producto cumple los requisitos, Globe declara todo el paquete como un único artículo con la descripción del contenido (o Goods), el valor del pedido y el Código HS establecido al crear la etiqueta o el Código HS por defecto.
Nova Post declara en kilogramos la mercancía de los códigos HS 210690 (preparaciones alimenticias, como los complementos dietéticos) y HS 630900 (ropa usada). Globe convierte estos artículos a kilogramos a partir del peso del producto. Un paquete solo puede contener uno de estos artículos, y como máximo 10 kg de él.
Los paquetes que salen de la UE también necesitan el email del cliente en el pedido. Los paquetes a Ucrania necesitan un Nombre del remitente en caracteres latinos: los acentos están permitidos, los caracteres cirílicos o griegos no. El Número EORI del remitente es opcional y se recomienda para los paquetes que salen de la UE.
Pago contra reembolso (COD)
Sección titulada «Pago contra reembolso (COD)»Nova Post cobra contra reembolso dentro de Chequia, Polonia y Alemania, y desde Chequia, Polonia, Alemania y Eslovaquia hacia Ucrania. Nova Post tiene que activar el contra reembolso en su contrato (un acuerdo de contra reembolso).
Cuando el método de pago del pedido es contra reembolso, Globe añade el servicio de contra reembolso de Nova Post con el importe pendiente del pedido. Puede cambiar el importe en Importe contra reembolso al crear la etiqueta.
Rellene estos ajustes:
- IBAN para contra reembolso: la cuenta a la que Nova Post abona el dinero cobrado. El abono va a la empresa indicada en Identificación fiscal de la empresa.
- Número del acuerdo de contra reembolso: el número de su acuerdo de contra reembolso. Déjelo vacío si solo tiene un contrato.
- Quién paga la comisión de contra reembolso: Remitente (usted), la opción predeterminada, o Destinatario. Debe coincidir con su acuerdo de contra reembolso.
Globe solo envía el contrarreembolso cuando el pedido está en la moneda de su país de remitente: CZK desde Chequia, PLN desde Polonia, EUR desde Alemania y Eslovaquia. Un pedido contra reembolso en una ruta en la que Nova Post no cobra, en otra moneda o sin un IBAN válido se rechaza antes de crear nada.
Impresión de etiquetas
Sección titulada «Impresión de etiquetas»Globe descarga las etiquetas de Nova Post en PDF cuando imprime. Hay dos opciones de impresión:
| Opción de impresión | Qué se imprime |
|---|---|
| 10x15 or 10x10 cm (size set by Nova Post) | La etiqueta del envío. Nova Post fija el tamaño de cada envío: 100 × 150 mm o 100 × 100 mm. |
| Label + commercial invoice A4 (parcels leaving the EU) | La etiqueta, seguida de la factura comercial de Nova Post en A4 para cada paquete que sale de la UE. Los paquetes dentro de la UE solo llevan la etiqueta. |
Cuando imprime varios envíos, Globe une sus documentos en un solo PDF en el orden de los envíos. La Posición en papel siempre es 1.
Solución de problemas
Sección titulada «Solución de problemas»| Problema | Solución |
|---|---|
| «Nova Post settings are incomplete» | El mensaje indica los ajustes que faltan. Rellénelos en la cuenta del transportista y guarde. |
| «Globe creates Nova Post labels for senders in the EU» | Seleccione como País del remitente el país de la UE desde el que envía. |
| «The sender phone must be a full international number» | Introduzca el Teléfono del remitente con el prefijo de país, por ejemplo +420777123456. |
| «The sender address needs a house number» | Introduzca el Número de casa del remitente, o configure la Sucursal de Nova Post para entregar paquetes. |
| «Nova Post did not accept the API key» o «Nova Post says the API key is not active» | Compruebe la Clave API y el Entorno: una clave de producción solo funciona con Producción, y una clave de prueba solo con Desarrollo. Una clave inactiva debe activarse en my.novapost.com o a través de su gestor de Nova Post. |
| «Access to the company is forbidden by API key» o «Nova Post refused the request for this API key» | La Identificación fiscal de la empresa debe ser de una organización para la que se creó su clave API. Compruebe la clave en my.novapost.com. |
| «Recipient phone number is missing», «Nova Post needs a Polish phone number (+48)» o «…a Ukrainian phone number (+380)» | Añada el teléfono del cliente con el prefijo de país a la dirección de envío del pedido. Los destinatarios en Polonia necesitan un número polaco, y los de Ucrania, uno ucraniano. |
| «Nova Post needs the house number in its own field» o «the shipping address needs a street, city and postcode» | Complete la dirección de envío del pedido, incluido el número de casa. |
| «Nova Post does not know the recipient’s city» | Compruebe el nombre de la ciudad en la dirección de envío. |
| «Order … has no weight» | Indique el peso de los productos en Shopify, introduzca el peso al crear la etiqueta o establezca el Peso predeterminado (kg) en los ajustes avanzados. |
| «has no Nova Post branch or parcel locker», «is not a Nova Post branch or parcel locker» o «is not a Nova Post division id» | Elija una sucursal o un locker de Nova Post con la acción Modificar punto de recogida, o cree la etiqueta con Nova Post courier (address) para enviar a la dirección del cliente. |
| «parcels to Ukraine need the sender name in Latin letters» | Cambie el Nombre del remitente a caracteres latinos. |
| «Nova Post needs the customer’s e-mail for parcels leaving the EU» | Añada el email del cliente al pedido. |
| «parcels leaving the EU need an HS code» | Añada el código HS al producto en Shopify, o configure un Código HS por defecto en los ajustes avanzados. |
| Mercancía de los códigos HS 210690 o 630900 rechazada | Nova Post acepta uno de estos artículos por paquete, como máximo 10 kg, y necesita su peso. Añada el peso del producto en Shopify, o reparta la mercancía en varios paquetes en my.novapost.com. |
| Contra reembolso rechazado por la ruta o la moneda | Nova Post solo cobra contra reembolso en las rutas y las monedas indicadas en Pago contra reembolso (COD). Use otro transportista para el pedido, o ponga el Importe contra reembolso a 0 al crear la etiqueta. |
| «no valid IBAN for the collected money» o «Nova Post refused the cash on delivery bank account» | Compruebe el IBAN para contra reembolso y el Número del acuerdo de contra reembolso en los ajustes. |
| «Nova Post did not answer in time», «did not confirm the shipment» o «The connection to Nova Post broke off» | Puede que el envío exista. Compruebe my.novapost.com antes de volver a crear la etiqueta. |
| «Globe could not connect to Nova Post», «the Nova Post login did not answer» o «Nova Post is limiting requests right now» | No se creó nada. Vuelva a intentarlo en un minuto. |
| «Do not create the label again» | Nova Post creó el envío, pero Globe no pudo guardarlo. Imprima la etiqueta en my.novapost.com, o elimine allí el envío antes de crear uno nuevo. |
| «Globe stopped before sending order …» | Un pedido anterior del lote no obtuvo una respuesta utilizable o no pudo guardarse. No se creó nada para este pedido, así que su etiqueta puede volver a crearse. |
| Otros mensajes que empiezan por «Nova Post:» | El texto procede de la validación de Nova Post e indica el campo que rechazó. Corrija el pedido o los ajustes y vuelva a exportar. |
| «Error printing Nova Post labels» | Los detalles muestran el número de envío y el motivo de Nova Post, por ejemplo Shipment not found. Compruebe el envío en my.novapost.com. |