Zum Inhalt springen

Nova Post API

Globe Pickup Points lässt sich mit Nova Post verbinden. Für Pakete, die aus einem EU-Land verschickt werden, exportieren Sie Bestellungen und drucken Versandlabels direkt aus Shopify. Mit dieser Integration können Sie:

  • Bestellungen direkt aus Shopify an Nova Post exportieren
  • Versandlabels direkt in Shopify drucken
  • An eine im Checkout gewählte Filiale, einen Paketautomaten oder einen PUDO-Punkt von Nova Post oder an die Adresse des Kunden versenden
  • Pakete in die Ukraine, nach Moldau und ins Vereinigte Königreich mit einer aus der Bestellung erstellten Zollrechnung versenden
  • Nachnahme auf den Routen einziehen, auf denen Nova Post sie anbietet

  1. Öffnen Sie in Ihrer Shopify-Verwaltung Globe Pickup Points und gehen Sie zu Versandetiketten. Klicken Sie auf Spediteurintegration hinzufügen und wählen Sie Nova Post.
  2. Geben Sie Ihren API-Schlüssel ein. Sie erstellen ihn in my.novapost.com unter Integrations, API keys, angemeldet als der bevollmächtigte Vertreter, der in Ihrem Vertrag mit Nova Post genannt ist.
  3. Wählen Sie die Umgebung: Produktion für echte Sendungen, Entwicklung für die Testumgebung von Nova Post. Ein Produktionsschlüssel funktioniert nur mit Produktion, ein Testschlüssel nur mit Entwicklung.
  4. Geben Sie Ihre Vertragsnummer ein. Die Sendungen bezahlen Sie als Absender, und Nova Post stellt sie über diesen Vertrag in Rechnung. Wenn Sie einen eigenen Vertrag für den internationalen Versand haben, tragen Sie ihn in Nummer des internationalen Vertrags ein. Globe verwendet ihn dann für Pakete in ein anderes Land.
  5. Geben Sie unter Steuernummer der Firma die Steuernummer der Organisation aus Ihrem Vertrag mit Nova Post ein, zum Beispiel IČO, NIP oder Steuernummer. Es muss eine Organisation sein, für die Ihr API-Schlüssel erstellt wurde.
  6. Füllen Sie Firmenname des Absenders, Name des Absenders (die auf dem Label angezeigte Kontaktperson), Telefon des Absenders (eine vollständige internationale Nummer, zum Beispiel +420777123456), E-Mail des Absenders und Land des Absenders aus. Das Land des Absenders muss in der EU liegen.
  7. Legen Sie fest, wie Ihre Pakete zu Nova Post gelangen:
    • An einer Filiale: Tragen Sie unter Nova-Post-Filiale für die Paketabgabe entweder die Filialnummer ein, wie Nova Post sie anzeigt (zum Beispiel 14/1), oder die Division-ID.
    • Per Kurier ab Ihrer Adresse: Lassen Sie die Filiale leer und füllen Sie Straße des Absenders, Hausnummer des Absenders, PLZ des Absenders und Stadt des Absenders aus. Die Hausnummer können Sie auch unter Straße des Absenders eintragen.
  8. Geben Sie Standardlänge des Pakets in Millimetern, Standardbreite des Pakets in Millimetern und Standardhöhe des Pakets in Millimetern ein. Nova Post verlangt Länge, Breite und Höhe für jedes Paket und berechnet daraus das Volumengewicht. Globe übermittelt diese Werte für alle Pakete.
  9. Wenn Sie Nachnahme anbieten, füllen Sie die Nachnahme-Einstellungen aus, die unter Nachnahme (COD) beschrieben sind.
  10. Unter Erweiterte Einstellungen anzeigen können Sie Zollbedingungen (Incoterms), EORI-Nummer des Absenders, Standardbeschreibung des Sendungsinhalts, Standard-HS-Code und Standardgewicht (kg) festlegen. Die Zolleinstellungen sind unter Zoll und internationale Sendungen beschrieben.
  11. Konfigurieren Sie nach Bedarf Bestellungen automatisch erfüllen, Bestellungen automatisch mit Sendungsverfolgungsnummer markieren und Benutzerdefiniertes Tag nach dem Export.
  12. Ordnen Sie unter Versandmethoden Ihre Shopify-Versandmethoden den Diensten von Nova Post zu, die unter Servicetypen beschrieben sind. Versandmethoden lassen sich für die 27 EU-Länder, die Ukraine, Moldau und das Vereinigte Königreich zuordnen.

Sie können Bestellungen direkt aus Shopify an Nova Post exportieren und Versandlabels drucken, einzeln oder im Stapel. Den allgemeinen Ablauf finden Sie unter Versandlabels erstellen.

Bevor die erste Bestellung übermittelt wird, prüft Globe die Einstellungen und meldet sich mit Ihrem API-Schlüssel bei Nova Post an. Fehlt eine Einstellung oder wird der Schlüssel abgelehnt, wird keine Bestellung übermittelt. Globe prüft außerdem jede Bestellung auf Daten, die Nova Post ablehnen würde, etwa eine fehlende Telefonnummer oder Hausnummer. Eine Bestellung, die diese Prüfungen nicht besteht, wird nicht übermittelt, sodass Sie sie korrigieren und erneut exportieren können.

Jede Bestellung wird als eine Sendung mit einem Paket übermittelt:

  • Gewicht: das Bestellgewicht, auf 10 g gerundet (mindestens 10 g)
  • Maße: Standardlänge, -breite und -höhe aus den Einstellungen
  • Versicherungswert: der Wert aus Deklarierter Wert, standardmäßig die Bestellsumme, in der Bestellwährung
  • Inhalt: die Inhaltsbeschreibung oder, wenn sie leer ist, die Produkttitel der Bestellung

Gewicht, deklarierten Wert, Nachnahmebetrag, HS-Code und Inhaltsbeschreibung einer Sendung können Sie beim Erstellen des Labels unter Erweitert ändern.

Nova Post gibt eine Sendungsnummer wie SHCZ0123456789 zurück. Globe speichert sie als Sendungsverfolgungsnummer und lädt das Label bei jedem Druck von Nova Post herunter. Der Tracking-Link öffnet https://novapost.com/en-<country>/tracking/<shipment number>/ für das Land aus der Sendungsnummer (zum Beispiel en-pl für SHPL…), oder en-cz, wenn dieses Land keine Sendungsverfolgungsseite hat. Ist Bestellungen automatisch erfüllen aktiviert, wird das Fulfillment mit der Sendungsnummer, dem Spediteurnamen Nova Post und diesem Link erstellt.

Antwortet Nova Post nicht rechtzeitig oder bricht die Verbindung ab, existiert die Sendung möglicherweise bei Nova Post, obwohl Globe keine Nummer dafür hat. Globe versieht die Bestellung dann mit dem Hinweis, my.novapost.com zu prüfen, bevor Sie das Label erneut erstellen, und hält den Stapel vor der nächsten Bestellung an. Die Bestellungen, die nicht übermittelt wurden, können Sie gefahrlos erneut exportieren.

Globe storniert keine Sendungen bei Nova Post. Um eine Sendung zu stornieren, löschen Sie sie in my.novapost.com.


Wählen Sie beim Zuordnen der Versandmethoden oder beim Erstellen eines Labels einen dieser Dienste:

DienstZustellung
Nova Post (branch or parcel locker if selected, otherwise address)An die Filiale, den Paketautomaten oder den PUDO-Punkt von Nova Post, den der Kunde im Checkout gewählt hat. Eine Bestellung ohne Abholpunkt geht an die Adresse des Kunden.
Nova Post courier (address)Immer an die Lieferadresse des Kunden, auch wenn die Bestellung einen Abholpunkt hat.
Nova Post branch or parcel lockerAn die Filiale, den Paketautomaten oder den PUDO-Punkt von Nova Post aus der Bestellung. Eine Bestellung ohne Punkt wird abgelehnt.

Bei beiden Diensten, die an einen Punkt liefern, wird ein Abholpunkt aus dem Netz eines anderen Spediteurs abgelehnt. Das Paket wird nicht ersatzweise an die Adresse des Kunden geschickt. Wählen Sie mit der Aktion Abholpunkt ändern einen Punkt von Nova Post, oder erstellen Sie das Label mit Nova Post courier (address).


Die Dienste, die an einen Punkt liefern, schicken das Paket an die Filiale, den Paketautomaten oder den PUDO-Punkt von Nova Post, den der Kunde im Checkout gewählt hat. Globe übermittelt die Nova-Post-ID dieses Punkts, daher muss der Punkt aus dem Nova-Post-Netz in der Abholpunktauswahl von Globe stammen. Um Punkte von Nova Post im Checkout anzubieten, fügen Sie Nova Post als Abholpunkt-Spediteur hinzu, siehe Abholpunkt-Spediteure hinzufügen. Filialen von Nova Post, die ein anderer Spediteur in seinem eigenen Netz führt, zum Beispiel Packeta oder Boxpi, tragen die IDs dieses Spediteurs und werden abgelehnt.

Nova Post hat keine Filialen, Paketautomaten oder PUDO-Punkte in Bulgarien, Kroatien, Zypern, Griechenland, Malta und Slowenien. Pakete in diese Länder können nur an die Adresse des Kunden gehen.

Für die Zustellung an eine Adresse benötigt Nova Post Straße und Hausnummer in getrennten Feldern. Globe übernimmt die Hausnummer aus der ersten Adresszeile (Vinohradská 12/34, 12 rue de la Paix) oder vom Anfang der zweiten Zeile und übermittelt eine nach der Hausnummer geschriebene Wohnungsnummer (byt 4, m. 5, Apt 2B) als Wohnung. Eine Adresse ohne Hausnummer, Straße, Stadt oder Postleitzahl wird abgelehnt.

Nova Post verlangt die Telefonnummer des Empfängers bei jeder Sendung, auch bei Filialen und Paketautomaten. Eine Nummer ohne Ländervorwahl wird als Nummer des Ziellandes gelesen. Nova Post lehnt einen Empfänger in Polen ohne polnische Nummer (+48) und einen Empfänger in der Ukraine ohne ukrainische Nummer (+380) ab.


Pakete, die die EU verlassen (in die Ukraine, nach Moldau oder ins Vereinigte Königreich), benötigen eine Zollrechnung. Globe füllt Nova Posts eigene Handelsrechnung mit den Daten aus der Bestellung aus. Sie können sie mit dem Label drucken (siehe Labeldruck).

Die Rechnung enthält den Gesamtwert der Waren, die Bestellwährung, den Exportgrund Selling und die Zollbedingungen (Incoterms) aus den Einstellungen: DAP (Kunde zahlt Einfuhrzoll), die Voreinstellung, oder DDP (Sie zahlen den Einfuhrzoll). Jede Produktposition, die versendet wird und einen Preis hat, wird zu einem Artikel mit:

  • dem Produkttitel aus Shopify als Artikelname und als englischer Name (Nova Post erwartet diesen Namen auf Englisch)
  • Menge und Stückpreis
  • dem HS-Code aus dem Produkt in Shopify, ersatzweise dem beim Erstellen des Labels gesetzten HS-Code oder dem Standard-HS-Code
  • dem Ursprungsland aus dem Produkt, sofern es hinterlegt ist
  • einem Anteil am Paketgewicht nach Produktgewicht, sodass die Artikelgewichte zusammen das Paketgewicht ergeben, wie Nova Post es verlangt

HS-Codes benötigen mindestens 6 Ziffern. Nova Post akzeptiert 8 bis 10 Ziffern, daher füllt Globe einen 6-stelligen Code mit Nullen auf (610910 wird zu 61091000). Pakete nach Moldau erhalten genau 10 Ziffern. Erfüllt keine Produktposition die Bedingungen, deklariert Globe das ganze Paket als einen Artikel mit der Inhaltsbeschreibung (oder Goods), dem Bestellwert und dem beim Erstellen des Labels gesetzten HS-Code oder dem Standard-HS-Code.

Nova Post deklariert Waren unter HS 210690 (Lebensmittelzubereitungen wie Nahrungsergänzungsmittel) und HS 630900 (getragene Kleidung) in Kilogramm. Globe rechnet diese Artikel aus dem Produktgewicht in Kilogramm um. Ein Paket darf nur einen solchen Artikel enthalten, mit höchstens 10 kg.

Pakete, die die EU verlassen, benötigen außerdem die E-Mail-Adresse des Kunden in der Bestellung. Für Pakete in die Ukraine muss Name des Absenders in lateinischen Buchstaben geschrieben sein: Akzente sind in Ordnung, kyrillische oder griechische Buchstaben nicht. Die EORI-Nummer des Absenders ist optional und für Pakete, die die EU verlassen, empfohlen.


Nova Post zieht Nachnahme innerhalb von Tschechien, Polen und Deutschland ein sowie von Tschechien, Polen, Deutschland und der Slowakei in die Ukraine. Nova Post muss Nachnahme für Ihren Vertrag freischalten (Nachnahmevereinbarung).

Ist die Zahlungsart der Bestellung Nachnahme, fügt Globe den Nachnahmedienst von Nova Post mit dem offenen Betrag der Bestellung hinzu. Den Betrag können Sie beim Erstellen des Labels unter Nachnahmebetrag ändern.

Füllen Sie diese Einstellungen aus:

  • IBAN für Nachnahme: das Konto, auf das Nova Post das eingezogene Geld auszahlt. Die Auszahlung geht an die Firma aus Steuernummer der Firma.
  • Nummer der Nachnahmevereinbarung: die Nummer Ihrer Nachnahmevereinbarung. Lassen Sie das Feld leer, wenn Sie nur einen Vertrag haben.
  • Wer zahlt die Nachnahmegebühr: Absender (Sie), die Voreinstellung, oder Empfänger. Die Angabe muss Ihrer Nachnahmevereinbarung entsprechen.

Globe übermittelt Nachnahme nur, wenn die Bestellung in der Währung Ihres Absenderlandes aufgegeben wurde: CZK aus Tschechien, PLN aus Polen, EUR aus Deutschland und der Slowakei. Eine Nachnahmebestellung auf einer Route, auf der Nova Post keine Nachnahme einzieht, in einer anderen Währung oder ohne gültige IBAN wird abgelehnt, bevor etwas erstellt wird.


Globe lädt die Labels beim Drucken als PDF von Nova Post herunter. Zwei Druckoptionen stehen zur Verfügung:

DruckoptionWas gedruckt wird
10x15 or 10x10 cm (size set by Nova Post)Das Sendungslabel. Nova Post legt die Größe für jede Sendung fest: 100 × 150 mm oder 100 × 100 mm.
Label + commercial invoice A4 (parcels leaving the EU)Das Label, gefolgt von der Handelsrechnung von Nova Post auf A4 für jedes Paket, das die EU verlassen hat. Pakete innerhalb der EU erhalten nur das Label.

Wenn Sie mehrere Sendungen drucken, fügt Globe ihre Dokumente in der Reihenfolge der Sendungen zu einem PDF zusammen. Position auf Papier ist immer 1.


ProblemLösung
„Nova Post settings are incomplete“Die Meldung nennt die fehlenden Einstellungen. Füllen Sie sie im Spediteurkonto aus und speichern Sie.
„Globe creates Nova Post labels for senders in the EU“Stellen Sie Land des Absenders auf das EU-Land, aus dem Sie versenden.
„The sender phone must be a full international number“Geben Sie Telefon des Absenders mit Ländervorwahl ein, zum Beispiel +420777123456.
„The sender address needs a house number“Geben Sie Hausnummer des Absenders ein, oder legen Sie Nova-Post-Filiale für die Paketabgabe fest.
„Nova Post did not accept the API key“ oder „Nova Post says the API key is not active“Prüfen Sie den API-Schlüssel und die Umgebung: Ein Produktionsschlüssel funktioniert nur mit Produktion, ein Testschlüssel nur mit Entwicklung. Ein inaktiver Schlüssel muss in my.novapost.com oder von Ihrem Betreuer bei Nova Post aktiviert werden.
„Access to the company is forbidden by API key“ oder „Nova Post refused the request for this API key“Steuernummer der Firma muss eine Organisation sein, für die Ihr API-Schlüssel erstellt wurde. Prüfen Sie den Schlüssel in my.novapost.com.
„Recipient phone number is missing“, „Nova Post needs a Polish phone number (+48)“ oder „…a Ukrainian phone number (+380)“Ergänzen Sie die Telefonnummer des Kunden mit Ländervorwahl in der Lieferadresse der Bestellung. Empfänger in Polen benötigen eine polnische Nummer, Empfänger in der Ukraine eine ukrainische.
„Nova Post needs the house number in its own field“ oder „the shipping address needs a street, city and postcode“Vervollständigen Sie die Lieferadresse der Bestellung, einschließlich der Hausnummer.
„Nova Post does not know the recipient’s city“Prüfen Sie den Ortsnamen in der Lieferadresse.
„Order … has no weight“Hinterlegen Sie die Produktgewichte in Shopify, geben Sie das Gewicht beim Erstellen des Labels ein, oder legen Sie in den erweiterten Einstellungen ein Standardgewicht (kg) fest.
„has no Nova Post branch or parcel locker“, „is not a Nova Post branch or parcel locker“ oder „is not a Nova Post division id“Wählen Sie mit der Aktion Abholpunkt ändern eine Filiale oder einen Paketautomaten von Nova Post, oder erstellen Sie das Label mit Nova Post courier (address), um an die Adresse des Kunden zu versenden.
„parcels to Ukraine need the sender name in Latin letters“Schreiben Sie den Wert unter Name des Absenders in lateinischen Buchstaben.
„Nova Post needs the customer’s e-mail for parcels leaving the EU“Ergänzen Sie die E-Mail-Adresse des Kunden in der Bestellung.
„parcels leaving the EU need an HS code“Ergänzen Sie den HS-Code beim Produkt in Shopify, oder legen Sie in den erweiterten Einstellungen einen Standard-HS-Code fest.
Waren unter HS 210690 oder 630900 abgelehntNova Post nimmt einen solchen Artikel pro Paket an, mit höchstens 10 kg, und benötigt sein Gewicht. Ergänzen Sie das Produktgewicht in Shopify, oder teilen Sie die Waren in my.novapost.com auf mehrere Pakete auf.
Nachnahme für die Route oder Währung abgelehntNova Post zieht Nachnahme nur auf den Routen und in den Währungen ein, die unter Nachnahme (COD) aufgeführt sind. Verwenden Sie für die Bestellung einen anderen Spediteur, oder setzen Sie beim Erstellen des Labels den Nachnahmebetrag auf 0.
„no valid IBAN for the collected money“ oder „Nova Post refused the cash on delivery bank account“Prüfen Sie IBAN für Nachnahme und Nummer der Nachnahmevereinbarung in den Einstellungen.
„Nova Post did not answer in time“, „did not confirm the shipment“ oder „The connection to Nova Post broke off“Die Sendung existiert möglicherweise. Prüfen Sie my.novapost.com, bevor Sie das Label erneut erstellen.
„Globe could not connect to Nova Post“, „the Nova Post login did not answer“ oder „Nova Post is limiting requests right now“Es wurde nichts erstellt. Versuchen Sie es in einer Minute erneut.
„Do not create the label again“Nova Post hat die Sendung erstellt, aber Globe konnte sie nicht speichern. Drucken Sie das Label in my.novapost.com, oder löschen Sie die Sendung dort, bevor Sie eine neue erstellen.
„Globe stopped before sending order …“Eine frühere Bestellung im Stapel hat keine verwertbare Antwort erhalten oder konnte nicht gespeichert werden. Für diese Bestellung wurde nichts erstellt, ihr Label kann also erneut erstellt werden.
Andere Meldungen, die mit „Nova Post:“ beginnenDer Text stammt aus der Validierung von Nova Post und nennt das abgelehnte Feld. Korrigieren Sie die Bestellung oder die Einstellungen und exportieren Sie erneut.
„Error printing Nova Post labels“Die Details zeigen die Sendungsnummer und den Grund von Nova Post, zum Beispiel Shipment not found. Prüfen Sie die Sendung in my.novapost.com.