# Odoo verbinden

Odoo wird direkt über die **XML-RPC-Schnittstelle** angebunden. SendDrop installiert dabei automatisch die benötigten Odoo-Module (z. B. `base_automation`) und legt die nötigen Server-Aktionen für Webhooks und Label-Erstellung an.

{% hint style="success" %}
**Automatische Einrichtung inkl. Label-Button direkt in Odoo:** Nach der Verbindung erscheint in Ihrer Odoo-Bedienung ein **„SendDrop Label erstellen"**-Button direkt am Lagerauftrag (Stock-Picking).
{% endhint %}

***

### Voraussetzungen

* **Odoo 14** oder neuer (Community oder Enterprise).
* Admin-Zugang zu Ihrer Odoo-Instanz, um API-Keys anzulegen.
* Die **URL Ihrer Odoo-Instanz**, z. B. `https://meinefirma.odoo.com`.
* Name der **Datenbank** – zu finden in Odoo unter **Einstellungen → Allgemeine Einstellungen** oder im Login-Screen.

***

### Schritt 1: API-Key in Odoo anlegen

{% stepper %}
{% step %}

#### Profil öffnen

Oben rechts in Odoo auf Ihren Benutzernamen klicken → **„Meine Einstellungen"** (oder **My Profile**).
{% endstep %}

{% step %}

#### Zu „Konto-Sicherheit" wechseln

Im Reiter **„Konto-Sicherheit"** finden Sie den Abschnitt **„Entwickler-API-Schlüssel"**.
{% endstep %}

{% step %}

#### Neuen API-Key erzeugen

* **Beschreibung:** z. B. `SendDrop`
* **Ablauf:** nach Bedarf, z. B. 1 Jahr

Klicken Sie auf **„API-Schlüssel generieren"**.

{% hint style="danger" %}
Der API-Key wird Ihnen **nur einmalig** angezeigt. Kopieren Sie ihn sofort und bewahren Sie ihn sicher auf.
{% endhint %}
{% endstep %}
{% endstepper %}

***

### Schritt 2: Shop in SendDrop anlegen

{% stepper %}
{% step %}

#### „Neuer Shop" öffnen

Im Onboarding oder unter **Einstellungen → Shops → „Neuer Shop"**.
{% endstep %}

{% step %}

#### Odoo auswählen

Wählen Sie **Odoo** in der Systemauswahl.
{% endstep %}

{% step %}

#### Zugangsdaten eingeben

| Feld              | Wert                                         |
| ----------------- | -------------------------------------------- |
| **Odoo URL**      | `https://meinefirma.odoo.com`                |
| **Datenbank**     | Datenbankname aus Odoo                       |
| **Benutzername**  | Ihr Odoo-Benutzer (meist die E-Mail-Adresse) |
| **API-Schlüssel** | Der Key aus Schritt 1                        |
| {% endstep %}     |                                              |

{% step %}

#### Verbindung prüfen

SendDrop testet die Verbindung per XML-RPC-Authentifizierung.
{% endstep %}

{% step %}

#### Automatische Einrichtung

Nach erfolgreicher Authentifizierung führt SendDrop automatisch folgende Schritte in Ihrer Odoo-Instanz aus:

* Installiert das Odoo-Modul **`base_automation`** (falls nicht vorhanden).
* Legt **Server-Aktionen** an:
  * eine Aktion für **Webhook-Ausgehend**, um Status-Änderungen an Lageraufträgen an SendDrop zu schicken.
  * eine Aktion **„SendDrop Label erstellen"**, die als Button am Stock-Picking erscheint.
* Registriert eine **Automation** auf Statuswechsel des Lagerauftrags, die den Webhook auslöst.
  {% endstep %}

{% step %}

#### Standards wählen

**Standard-Marke** und **Standard-Carrier** für diesen Shop festlegen.
{% endstep %}
{% endstepper %}

***

### Arbeiten in Odoo: Der neue Label-Button

Nach erfolgreicher Einrichtung finden Sie in Odoo am **Stock-Picking** (Lagerauftrag) den zusätzlichen Button **„SendDrop Label erstellen"**.

\[BILD-009 – Bild einfügen, welches Folgendes darstellt: Odoo-Lagerauftrag mit dem zusätzlichen Button „SendDrop Label erstellen" am oberen Rand.]

Beim Klick auf den Button:

1. Odoo sendet einen Webhook an SendDrop.
2. SendDrop legt die Bestellung an (falls noch nicht importiert) und erzeugt ein Label mit den Standardeinstellungen des Shops.
3. Tracking-Nummer und Label-URL werden zurück an Odoo geschrieben.

{% hint style="info" %}
**Alternativ:** Bestellungen werden auch automatisch per Statuswechsel des Lagerauftrags an SendDrop übertragen. Der Button ist der manuelle Weg, wenn Sie ein Label für einen konkreten Pick sofort benötigen.
{% endhint %}

***

### Was wird synchronisiert?

| Datenpunkt                         | Richtung                            |
| ---------------------------------- | ----------------------------------- |
| **Lageraufträge / Stock-Pickings** | Odoo → SendDrop                     |
| **Empfängeradresse & Positionen**  | Odoo → SendDrop                     |
| **Tracking-Nummer & Label-URL**    | SendDrop → Odoo (ins Stock-Picking) |
| **Produkte / Bestand**             | nicht synchronisiert                |

***

### Fehlerbehebung

<details>

<summary><strong>„Authentifizierung fehlgeschlagen"</strong></summary>

Prüfen Sie:

1. **URL** ist ohne Slash am Ende und mit `https://`.
2. **Datenbank**-Name ist exakt wie in Odoo angegeben (Groß-/Kleinschreibung).
3. **Benutzername** ist Ihr Odoo-Login (meist die E-Mail-Adresse).
4. **API-Key** wurde vollständig kopiert (keine Leerzeichen).

</details>

<details>

<summary><strong>Label-Button erscheint nicht in Odoo</strong></summary>

Das Modul `base_automation` muss installiert sein. SendDrop installiert es automatisch; falls das fehlschlägt (z. B. wegen fehlender Rechte), installieren Sie es manuell über **Apps → base\_automation** und verbinden Sie den Shop neu.

</details>

<details>

<summary><strong>„Modul konnte nicht installiert werden"</strong></summary>

Der verwendete API-Benutzer benötigt Rechte, um Apps zu installieren. Nutzen Sie idealerweise einen **Administrator-Account** für die SendDrop-Integration oder vergeben Sie dem entsprechenden Benutzer die Rolle **„Einstellungen"**.

</details>

***

### Häufige Fragen

<details>

<summary>Welche Odoo-Editionen werden unterstützt?</summary>

Sowohl **Odoo Community** als auch **Odoo Enterprise**, jeweils ab Version 14.

</details>

<details>

<summary>Kann ich Odoo-on-Premise (Eigenhosting) anbinden?</summary>

Ja, solange Ihre Odoo-Instanz aus dem Internet erreichbar ist (inklusive gültigem SSL-Zertifikat). Für rein interne Instanzen ist die Anbindung nicht möglich.

</details>

<details>

<summary>Werden mehrere Lager / Warehouses unterstützt?</summary>

Ja. Bestellungen werden unabhängig vom Lager übernommen. Sie können in SendDrop über **Marken** unterschiedliche Absenderadressen pro Lager hinterlegen.

</details>

<details>

<summary>Werden die Odoo-Änderungen beim Löschen des Shops rückgängig gemacht?</summary>

SendDrop deregistriert beim Entfernen die Webhooks und Automations. Die installierten Module und Server-Aktionen bleiben bestehen und können über die Odoo-Verwaltung manuell entfernt werden.

</details>

***

{% hint style="info" %}
**Brauchen Sie Hilfe?** Unser Support-Team hilft Ihnen gerne weiter: <support@senddrop.com> oder über den Chat unten rechts in Ihrem Dashboard.
{% endhint %}

***

### Siehe auch

{% content-ref url="/pages/afzpYobkmkiQzWB9jB1n" %}
[Shop-Anbindung: Überblick](/2.-ihren-shop-verbinden/ueberblick.md)
{% endcontent-ref %}

{% content-ref url="/pages/34mLRZ7tylkvsQmfTkIU" %}
[Häufige Probleme bei der Shop-Anbindung](/2.-ihren-shop-verbinden/haeufige-probleme.md)
{% endcontent-ref %}

{% content-ref url="/pages/ZFJXurN97mu1mgXyHzat" %}
[SendDrop REST-API: Überblick](/10.-entwickler-and-integrationen/rest-api-ueberblick.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.senddrop.com/2.-ihren-shop-verbinden/odoo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.