Zum Inhalt springen
AchaduDevelopers
Developers/API/commission_import
Provisionen

Importieren Sie Provisionen in CSV

Normalisiert eine CSV-Datei, dedupliziert Transaktionen und erstellt eine überprüfbare Quittung.

POST/commissions/importscommissions:write
VERHALTEN

Die Anfrage validiert die Eingabe, behält den Befehl bei und gibt den Anfangszustand zurück. Die Ausführung kann in der dedizierten Warteschlange fortgesetzt werden.

WIRKUNG

Sie können asynchrone Arbeits- und Webhook-Ereignisse nach Bestätigung in der Datenbank erstellen.

WIEDERHOLUNG

Bestätigen Sie bei einem Netzwerkfehler den Ressourcenstatus, bevor Sie es erneut versuchen. Nur 429 und 5xx mit Backoff und Jitter automatisch wiederholen.

Anfrage

marketplacestring · bodyMarktplatz oder Standardnetzwerk.optional
filenamestring · bodyUrsprünglicher Dateiname.maxLength 240optional
contentstring · bodyUTF-8 Inhalt der CSV.minLength 2 · maxLength 120000obligatorisch
AuthorizationBearer ach_live_...
Acceptapplication/json
Umfangcommissions:write

Ausführbares Beispiel

curl
curl -X POST 'https://achadu.com/api/v1/commissions/imports' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "content": "I found a deal for you.",
  "marketplace": "string",
  "filename": "string"
}'

Reaktion und Fehler

Jede Antwort enthält request_id. Listen fügen Paginierung hinzu; Veränderbare Ressourcen geben nach der Operation den persistenten Zustand zurück.

201 application/json
{
  "data": {
    "id": "imp_01J...",
    "status": "processing",
    "source": "amazon",
    "rows_read": 0,
    "new_items": 0,
    "duplicates": 0,
    "errors": 0
  },
  "created": true,
  "request_id": "req_01J..."
}
201Ressource erstellt und beibehalten.
400Ungültiger Parameter, Körper oder Übergang.
401Fehlender, ungültiger, abgelaufener oder widerrufener Schlüssel.
402Der Account-Plan gibt diese Schnittstelle nicht frei.
403A chave precisa do escopo commissions:write.
404Die Funktion ist in diesem Konto nicht vorhanden.
409Der aktuelle Status verhindert diesen Vorgang.
413Der JSON-Körper ist größer als 128 KB.
429Das Zeitfenster von 120 Anfragen pro Minute wurde überschritten.