> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Porterbuddy verbinden

> Verbinde Porterbuddy unter Versanddienstleister mit deinem Instabee-API-Schlüssel und nutze das Kontrollkästchen Testmodus, um das Testsystem von Instabee auszuprobieren.

**Porterbuddy** liefert Pakete an die Haustür deiner Kunden in Norwegen, Schweden und Dänemark. Es gehört zu Instabee, derselben Gruppe wie Instabox und Budbee. Porterbuddy hat keine Paketautomaten. Die Felder, die jeder Versanddienstleister gemeinsam hat, stehen unter [Zugangsdaten für Versanddienstleister](/docs/de/how-to/carrier-credentials).

<Info>
  In diesem Formular wählst du keine Absenderadresse aus. Füge deine Adressen über das Organisationsmenü → **Verwalten** → **Adressen** hinzu. Die Absenderadresse wählst du bei jeder Sendung oder in einer [Versandregel](/docs/de/how-to/shipping-rule-fields) aus.
</Info>

## Bevor du startest

* Du brauchst einen **API-Schlüssel** von Instabee für deinen Porterbuddy-Vertrag. Zippendo kann diesen Schlüssel nicht für dich erstellen.
* **Mehr erfahren** auf der Karte öffnet [porterbuddy.com](https://porterbuddy.com). Das ist die öffentliche Website von Porterbuddy, nicht der Ort, an dem du einen Schlüssel bekommst.
* Budbee nutzt die gleiche Art von Schlüssel. Siehe [Budbee verbinden](/docs/de/how-to/connect-budbee).

Du kannst Porterbuddy mehrmals verbinden. Gib jeder Verbindung einen eigenen **Name des Versanddienstleisters**.

## Porterbuddy verbinden

<Steps>
  <Step title="Alle Versanddienstleister öffnen">
    Klicke in der Seitenleiste auf **Versanddienstleister** und öffne dann den Tab **Alle Versanddienstleister**.
  </Step>

  <Step title="Porterbuddy finden">
    Klicke auf der Karte **Porterbuddy** auf **Verbinden**.
  </Step>

  <Step title="Formular ausfüllen">
    Das Fenster **Versanddienstleister verbinden** öffnet sich. Gib einen **Name des Versanddienstleisters** und deinen **API-Schlüssel** ein. **Testmodus** findest du unter **Optionale Felder**.
  </Step>

  <Step title="Versanddienstleister verbinden">
    Klicke auf **Verbinden**. Du siehst „Versanddienstleister verbunden“, und der Versanddienstleister erscheint im Tab **Meine Versanddienstleister**.
  </Step>
</Steps>

<Frame caption="Die Karte Porterbuddy im Tab Alle Versanddienstleister">
  <img src="https://mintcdn.com/zippendo/b0bMFxf67flFt-IC/images/de/how-to/connect-porterbuddy/01-all-carriers-card-light.png?fit=max&auto=format&n=b0bMFxf67flFt-IC&q=85&s=d4178b3eacd6edfc00102be0ede40016" alt="Tab Alle Versanddienstleister mit der Karte Porterbuddy und ihren Schaltflächen Verbinden und Mehr erfahren" className="block dark:hidden" width="2880" height="1800" data-path="images/de/how-to/connect-porterbuddy/01-all-carriers-card-light.png" />

  <img src="https://mintcdn.com/zippendo/b0bMFxf67flFt-IC/images/de/how-to/connect-porterbuddy/01-all-carriers-card-dark.png?fit=max&auto=format&n=b0bMFxf67flFt-IC&q=85&s=2cff88922b8956b64e2a4dd2dd310ebf" alt="Tab Alle Versanddienstleister mit der Karte Porterbuddy und ihren Schaltflächen Verbinden und Mehr erfahren" className="hidden dark:block" width="2880" height="1800" data-path="images/de/how-to/connect-porterbuddy/01-all-carriers-card-dark.png" />
</Frame>

<Frame caption="Gib deinen API-Schlüssel ein. Der Testmodus ist optional.">
  <img src="https://mintcdn.com/zippendo/b0bMFxf67flFt-IC/images/de/how-to/connect-porterbuddy/02-connect-modal-light.png?fit=max&auto=format&n=b0bMFxf67flFt-IC&q=85&s=8d9b168d62b64e63c9e3b9813cffeca2" alt="Fenster Versanddienstleister verbinden für Porterbuddy mit dem Feld API-Schlüssel und dem Kontrollkästchen Testmodus" className="block dark:hidden" width="2880" height="1800" data-path="images/de/how-to/connect-porterbuddy/02-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/b0bMFxf67flFt-IC/images/de/how-to/connect-porterbuddy/02-connect-modal-dark.png?fit=max&auto=format&n=b0bMFxf67flFt-IC&q=85&s=024277e4c973294aec63b5f49cc4f1fb" alt="Fenster Versanddienstleister verbinden für Porterbuddy mit dem Feld API-Schlüssel und dem Kontrollkästchen Testmodus" className="hidden dark:block" width="2880" height="1800" data-path="images/de/how-to/connect-porterbuddy/02-connect-modal-dark.png" />
</Frame>

## Felder im Formular

| Feld | Erforderlich | Was du eingibst |
| - | - | - |
| **Name des Versanddienstleisters** | Ja | Der Name, den du unter **Meine Versanddienstleister** siehst und wenn du bei einer Sendung einen Versanddienstleister auswählst. Er beginnt als **Porterbuddy**. |
| **Marke** | Nein | Wird nur angezeigt, wenn deine Organisation [Marken](/docs/de/how-to/create-a-brand) hat. Das Formular sagt: „Nur diese Marke kann diesen Versanddienstleister nutzen.“ Lass das Feld leer, damit jede Marke ihn nutzen kann. |
| **API-Schlüssel** | Ja | Der Schlüssel von Instabee. Das Formular sagt: „Dein API-Schlüssel für die Instabee Integration API (wird als 'Authorization: ApiKey \<key>' gesendet)“. Füge nur den Schlüssel selbst ein. |
| **Testmodus** | Nein | Ein Kontrollkästchen, standardmäßig aus. Das Formular sagt: „Testumgebung von Instabee verwenden“. |

**Verbinden** tut nichts, solange **Name des Versanddienstleisters** und **API-Schlüssel** keinen Wert haben.

Der **Testmodus** sendet deine Sendungen an das Testsystem von Instabee, sodass keine echten Sendungen erstellt werden. Das Testsystem braucht einen Testschlüssel von Instabee: Ein Live-Schlüssel funktioniert dort nicht, und ein Testschlüssel funktioniert nicht für echte Sendungen. Lass den **Testmodus** für echte Sendungen aus. Siehe [Testmodus](/docs/de/how-to/sandbox-mode).

## Nach dem Verbinden

Der Versanddienstleister erscheint unter **Meine Versanddienstleister** mit dem Abzeichen **Verbunden**. Das Versandprodukt wählst du bei jeder Sendung oder in einer Versandregel aus, nicht in diesem Formular. Siehe [Versandprodukte und Zusatzleistungen](/docs/de/how-to/carrier-products-and-services).

| Versandprodukt | Sendungstyp | Was es tut |
| - | - | - |
| **Hauszustellung** | Ausgehend | Liefert an die Privatadresse des Empfängers. |
| **Retoure ab Haustür** | Eingehend (Retoure) | Porterbuddy holt die Retoure bei deinem Kunden zu Hause ab. |

Beide Versandprodukte versenden innerhalb von und zwischen Norwegen, Schweden und Dänemark, von 0,1 bis 20 kg. Porterbuddy liefert nie an einen Paketshop, daher wählst du keinen aus.

* Porterbuddy ist unter **Abholungen** nicht verfügbar. Welche Versanddienstleister es sind, siehe [Abholung planen](/docs/de/how-to/schedule-a-pickup).
* Instabee sendet Updates zur Sendungsverfolgung selbstständig an Zippendo. Du musst nichts einrichten. Siehe [Webhooks zur Sendungsverfolgung der Versanddienstleister](/docs/de/how-to/tracking-webhooks).
* Porterbuddy erstellt keine Zolldokumente. Wenn in der Versandregel **Proformarechnung erstellen** oder **Handelsrechnung erstellen** eingeschaltet ist, erstellt Zippendo dieses Dokument. Siehe [Zoll und Dokumente](/docs/de/how-to/customs-and-documents).

## Verbindung ändern oder entfernen

Um sie zu ändern, öffne **Versanddienstleister** → **Meine Versanddienstleister** und klicke auf der Karte auf **Versanddienstleister bearbeiten**. Die Seite **Versanddienstleister bearbeiten** hat zwei Abschnitte:

* **Allgemein**: **Name des Versanddienstleisters** und **Marke**, wenn deine Organisation Marken hat.
* **Einstellungen des Versanddienstleisters**: **API-Schlüssel** und **Testmodus**.

Klicke auf **Speichern**. Du siehst „Versanddienstleister aktualisiert“.

Um sie zu entfernen, klicke auf derselben Seite auf **Löschen**, gib den Namen des Versanddienstleisters in Großbuchstaben ein und klicke auf **Löschen**. Versandregeln, die diesen Versanddienstleister nutzen, werden mit gelöscht. Sendungen, die du bereits versendet hast, behalten ihre Versandetiketten und Sendungsnummern.

## Häufige Probleme

| Was du siehst | Was du tun kannst |
| - | - |
| „Der Versanddienstleister konnte nicht verbunden werden. Versuch es noch einmal.“ | Prüfe, ob **Name des Versanddienstleisters** und **API-Schlüssel** ausgefüllt sind, und versuche es dann erneut. |
| „Du hast das Limit deines Tarifs erreicht. Upgrade deinen Tarif oder entferne etwas, das du nicht mehr brauchst.“ | Das Limit für Versanddienstleister deines Tarifs ist erreicht. Siehe [Abrechnung und Nutzung](/docs/de/how-to/billing-and-usage). |
| „Der Versanddienstleister hat deine Anmeldedaten abgelehnt. Aktualisiere die Zugangsdaten unter „Versanddienstleister“.“ beim Versenden | Prüfe den **API-Schlüssel** unter **Versanddienstleister bearbeiten** und ob der **Testmodus** zur Art des Schlüssels passt (Test oder Live). Siehe [Authentifizierungsfehler beim Versanddienstleister](/docs/de/knowledge-base/carrier-authentication-failures). |
| „Das gewählte Versandprodukt versendet nicht zwischen diesen Ländern. Wähle ein anderes Versandprodukt.“ | Absender oder Empfänger befindet sich außerhalb von Norwegen, Schweden und Dänemark. Wähle einen anderen Versanddienstleister. |
| „Der Versanddienstleister hat nicht geantwortet. Versuch es gleich noch einmal.“ | Instabee hat nicht rechtzeitig geantwortet. Warte einen Moment und versende erneut. |

## Verwandte Themen

* [Budbee verbinden](/docs/de/how-to/connect-budbee)
* [Instabox verbinden](/docs/de/how-to/connect-instabox)
* [Versanddienstleister oder Integration verbinden](/docs/de/how-to/connect-index)
* [Zugangsdaten für Versanddienstleister](/docs/de/how-to/carrier-credentials)
* [Testmodus](/docs/de/how-to/sandbox-mode)
* [Versanddienstleister](/docs/de/tutorials/carriers)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.