FAQ und Fehlerbehebung | CPP Hilfe Center

Hier findest Du die häufigsten Fragen die während der Einrichtung der CAPI aufkommen. Sollte eine Frage hier nicht beantwortet werden, wende Dich bitte an Deinen Account Manager oder an support@channelpilot.com

Um was für eine API handelt es sich?

Die CAPI (kurz für Channel Pilot Pro API) ist eine REST-API, die grundlegende Funktionen für den Import bereitstellt. Darüber können Daten direkt an Channel Pilot Pro gepusht und müssen nicht über URL oder (s)FTP bereitgestellt werden.

Sind alle Funktionen der CAPI sofort nutzbar?

Nein!

Aus Sicherheitsgründen sind folgende Funktionen standardmäßig deaktiviert und müssen erst speziell von Channel Pilot Pro aktiviert werden:

Anlage neuer Artikel
Anlage neuer Attribute am Artikel
Löschung von Artikeln

Können beliebig viele Daten auf einmal übermittelt werden?

Nein!

Das Limit liegt bei 10.000 SKU (Artikel) pro Request und wiederum bei 60 Requests pro Minute (1 pro Sekunde). Größere Requests werden auch nicht teilweise verarbeitet sondern von der CAPI direkt abgelehnt.

Ist die CAPI mit anderen Importen kompatibel?

Ja!

Das CAPI kann allein oder in Kombination mit anderen Importen verwendet werden. Insbesondere wenn z.B. die Artikelstammdaten nur sehr selten aktualisiert werden, ist es möglich, diese über einen Standardimport (via URL oder FTP) zu versenden und neue Daten über die CAPI hinzuzufügen.

Ebenso bietet es sich an Bestands- und Preisdaten sowieso andere Daten die sich häufig ändern über die CAPI zu pushen, um eine schnelle Aktualisierung zu gewährleisten,

Einige Requests führen zu keiner Änderung oder laufen auf Fehler, was tun?

Es kann vorkommen das ausgeführte Requests keine Wirkung auf den Datenbestand haben oder direkt auf einen Fehler laufen. Die Fehlermeldung könnte dann wie folgt aussehen:

{

    "type": "feedDataJob",

    "result": {

        "globalFeedId": "test-feed-id",

        "status": "FAILED",

        "received": "2023-05-31T17:04:55+0200",

        "articles": 0,

        "successful": 0,

        "invalidatedArticles": [

            {

                "articleError": "UNKNOWN_SKU",

                "sku": "any-test-product",

                "definedSkuDataField": "product-id"

            }

        ],

        "operationMethod": "PATCH"

    },

    "success": false

}

Das deutet in den meisten Fällen darauf hin, dass die CAPI-Anbindung noch nicht vollständig konfiguriert ist. Einer der beiden folgenden Schritte ist daher notwendig:

die CAPI für den Feed/Shop generell freigeben
bei aktiver CAPI-Anbindung fehlt die Freigabe einer Berechtigungen

In diesem Fall wende Dich bitte an Deinen Accountmanager oder an support@channelpilot.com

Die CAPI-Schnittstelle ist aktiviert, aber ein PUT/PATCH/DELETE-Request wird abgelehnt. Woran liegt das?

Das kann unterschiedliche Ursachen haben und hängt von der Fehlermeldung ab.

Typische Fehlerquellen können sein:

eine IP-Freigabe ist notwendig auf Kundenseite oder bei CPP
der gesendete Request beinhaltet zu viele SKUs
der gesendete Request beinhaltet unbekannte SKUs

Sollte es sich um ein Problem mit einer IP-Adresse handeln, kann dies in manchen Fällen im Logbuch eingesehen werden (im Account einloggen und unter https://go.channelpilot.com/tools/logbook die Logeinträge prüfen).

Falls ein Request die erlaubte maximal SKU-Anzahl übersteigt, wird dieser automatisch abgelehnt. Prüfe daher bitte, ob das vorgegebene Limit von 10.000 SKU pro Request / 1 Request pro Sekunde eingehalten wird.

Sollte der Request unbekannte SKUs beinhalten, sollten diese automatisch angelegt werden, falls die CAPI-Anbindung korrekt konfiguriert wurde. Ist das nicht der Fall, wende Dich bitte an Deinen Accountmanager oder support@channelpilot.com, um die fehlenden Funktionen der CAPI aktivieren zu lassen.

Verwandte Artikel