Amazon Seller Indien – SP-API Agent Skill

Amazon Seller Indien — SP-API Agent Skill

Wann dieses Skill verwenden

Verwenden Sie dieses Skill, wenn der Benutzer Sie bittet, Folgendes zu tun:

• Einrichtung oder Fehlerbehebung der Amazon SP-API-Authentifizierung (LWA OAuth, Refresh-Token, Access-Token)
• Registrierung als privater Entwickler auf Amazon Seller Central Indien
• Selbstautorisierung einer privaten SP-API-Anwendung
• Durchführung eines beliebigen Amazon Selling Partner API-Aufrufs für den indischen Marktplatz
• Verwaltung von Bestellungen, Inventar, Angeboten, Preisen oder Fulfillment über die SP-API
• Abrufen von Berichten (Abrechnung, GST/Steuer, Bestand, Bestellungen, FBA, Performance)
• Einreichen von Feeds (Angebote, Preise, Auftragsabwicklung, FBA-Eingang)
• Arbeiten mit Amazon-Finanzen, Zahlungen oder Abrechnungsabgleich
• Umgang mit Restricted Data Tokens (RDT) für PII-sensible Operationen
• Verwaltung von FBA-Eingangssendungen, Easy Ship oder externem Fulfillment
• Abrufen von Katalogartikeln, Produkttypen oder Markenanalysen
• Einrichten von SP-API-Benachrichtigungen oder -Abonnements
• Integration von Amazon Seller Indien-Daten mit Zoho Books/Inventory oder anderen Buchhaltungssystemen

Indien-Marktplatz-Konstanten

Parameter	Wert
Marktplatz-ID	A21TJRUUN4KGV
Ländercode	IN
SP-API-Endpunkt	https://sellingpartnerapi-eu.amazon.com
AWS-Region	eu-west-1
Seller Central URL	https://sellercentral.amazon.in
LWA-Token-Endpunkt	https://api.amazon.com/auth/o2/token

Indien ist Teil der Europa-Verkaufsregion in der SP-API. Alle API-Aufrufe erfolgen über sellingpartnerapi-eu.amazon.com.

Schnellreferenz

• Für Authentifizierungseinrichtung (Erstregistrierung, Entwicklerprofil, Selbstautorisierung, Erfassung von Anmeldeinformationen): Laden Sie references/auth-setup-guide.md
• Für vollständigen API-Operationskatalog (alle APIs, Endpunkte, Berichtstypen, Feed-Typen, Rollen): Laden Sie references/api-operations-catalog.md
• Für sofort einsetzbare Skripte (Token-Austausch, API-Aufrufe): Siehe scripts/-Verzeichnis

Anleitung

Schritt 1: Erfassung von Anmeldeinformationen

Bevor Sie einen API-Aufruf durchführen, erfassen Sie folgende Anmeldeinformationen vom Benutzer:

1. LWA-Client-ID — amzn1.application-oa2-client.xxxxx (von Seller Central → Apps & Services → Develop Apps → LWA Credentials)
2. LWA-Client-Secret — das zugehörige Secret zur Client-ID
3. LWA-Refresh-Token — während der Selbstautorisierung erhalten (langlebiges Credential)

Wenn der Benutzer sein Entwicklerprofil oder seine Anwendung noch nicht eingerichtet hat, führen Sie ihn durch die vollständige Authentifizierungseinrichtung. Laden Sie references/auth-setup-guide.md für die Schritt-für-Schritt-Anleitung.

Schritt 2: Refresh-Token gegen Access-Token austauschen

Jeder SP-API-Aufruf erfordert ein kurzlebiges Access-Token (gültig für 3600 Sekunden / 1 Stunde).

curl -X POST "https://api.amazon.com/auth/o2/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=refresh_token" \
  -d "refresh_token=${REFRESH_TOKEN}" \
  -d "client_id=${CLIENT_ID}" \
  -d "client_secret=${CLIENT_SECRET}"

Antwort:

{
  "access_token": "Atza|IQEBLjAs...",
  "token_type": "bearer",
  "expires_in": 3600
}

Verwenden Sie scripts/get_access_token.py für eine wiederverwendbare Python-Implementierung.

Schritt 3: SP-API-Aufrufe durchführen

Alle Aufrufe für den indischen Marktplatz verwenden:

• Endpunkt: https://sellingpartnerapi-eu.amazon.com
• Marktplatz-ID-Abfrageparameter: marketplaceIds=A21TJRUUN4KGV
• Header:
  • x-amz-access-token: {access_token}
  • user-agent: {AppName}/{Version} (Language=Python/3.x; Platform=Linux)

Beispiel – Bestellungen abrufen:

curl -X GET "https://sellingpartnerapi-eu.amazon.com/orders/v0/orders?MarketplaceIds=A21TJRUUN4KGV&CreatedAfter=2026-01-01T00:00:00Z" \
  -H "x-amz-access-token: ${ACCESS_TOKEN}" \
  -H "user-agent: MyApp/1.0 (Language=Python/3.10)"

Schritt 4: Umgang mit geschützten Daten (PII)

Einige Operationen geben personenbezogene Daten zurück (Käufername, Adresse, Telefon). Diese erfordern ein Restricted Data Token (RDT) anstelle des normalen Access-Tokens.

Ein RDT abrufen:

curl -X POST "https://sellingpartnerapi-eu.amazon.com/tokens/2021-03-01/restrictedDataToken" \
  -H "x-amz-access-token: ${ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "restrictedResources": [
      {
        "method": "GET",
        "path": "/orders/v0/orders/{orderId}",
        "dataElements": ["buyerInfo", "shippingAddress"]
      }
    ]
  }'

Verwenden Sie dann den zurückgegebenen restrictedDataToken-Wert im x-amz-access-token-Header für den eingeschränkten Aufruf.

Eingeschränkte Operationen umfassen:

• Orders API: getOrders, getOrder, getOrderItems, getOrderAddress, getOrderBuyerInfo, confirmShipment
• Merchant Fulfillment API: getShipment, createShipment
• Easy Ship API: createScheduledPackageBulk
• Berichte mit PII (Versandberichte, Steuerberichte)

Schritt 5: Häufige Arbeitsabläufe

Abrechnungsbericht abrufen (für Zoho Books-Abgleich)

POST /reports/2021-06-30/reports
{
  "reportType": "GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE_V2",
  "marketplaceIds": ["A21TJRUUN4KGV"]
}

Dann abfragen GET /reports/2021-06-30/reports/{reportId}, bis der Status DONE ist, dann über reportDocumentId herunterladen.

GST-Berichte abrufen (Indien-spezifisch)

Bericht	reportType-Wert	Erforderliche Rolle
GST MTR B2B	GST_MTR_B2B	Steuerabführung (Eingeschränkt)
GST MTR B2C	GST_MTR_B2C	Steuerabführung (Eingeschränkt)
GST Lagerübertrag	GST_MTR_STOCK_TRANSFER_REPORT	Steuerabführung (Eingeschränkt)
Auf Anfrage GST B2B	GET_GST_MTR_B2B_CUSTOM	Steuerabführung (Eingeschränkt)
Auf Anfrage GST B2C	GET_GST_MTR_B2C_CUSTOM	Steuerabführung (Eingeschränkt)
Auf Anfrage Lagerübertrag	GET_GST_STR_ADHOC	Amazon Fulfillment

Inventar aktualisieren

Verwenden Sie die Listings Items API oder reichen Sie einen Feed ein:

POST /feeds/2021-06-30/feeds
{
  "feedType": "JSON_LISTINGS_FEED",
  "marketplaceIds": ["A21TJRUUN4KGV"],
  "inputFeedDocumentId": "{feedDocumentId}"
}

Preise aktualisieren

POST /feeds/2021-06-30/feeds
{
  "feedType": "JSON_LISTINGS_FEED",
  "marketplaceIds": ["A21TJRUUN4KGV"],
  "inputFeedDocumentId": "{feedDocumentId}"
}

Verwenden Sie die Listings Items API patchListingsItem für einzelne Preisaktualisierungen.

Fehlerbehandlung

HTTP-Code	Bedeutung	Maßnahme
400	Ungültige Anfrage / ungültige Parameter	Abfrageparameter, Marktplatz-ID, Datumsformate prüfen
401	Ungültiges oder abgelaufenes Access-Token	Refresh-Token erneut gegen ein neues Access-Token austauschen
403	Fehlende Rolle oder nicht autorisiert	Entwicklerprofil-Rollen prüfen; ggf. zusätzliche Rollen anfordern
404	Ressource nicht gefunden	Bestell-ID, ASIN, SKU auf Existenz prüfen
429	Ratenbegrenzung überschritten	Backoff und erneuter Versuch mit exponentiellem Backoff
500/503	Amazon-Serverfehler	Erneuter Versuch mit exponentiellem Backoff (max. 3 Versuche)

Ratenbegrenzungen

Die SP-API erzwingt pro-Operation Ratenbegrenzungen. Wichtige Grenzen für stark frequentierte Operationen:

• getOrders: 0,0167 Anfragen/s (1 pro Minute, Burst von 20)
• getOrder: 0,5 Anfragen/s (Burst von 30)
• getOrderItems: 0,5 Anfragen/s (Burst von 30)
• createReport: 0,0167 Anfragen/s (1 pro Minute, Burst von 15)
• getReport: 2 Anfragen/s (Burst von 15)
• Catalog Items searchCatalogItems: 2 Anfragen/s (Burst von 2)
• Listings patchListingsItem: 5 Anfragen/s (Burst von 10)
• Feeds createFeed: 0,0083 Anfragen/s (1 pro 2 Minuten, Burst von 15)

Implementieren Sie immer exponentiellen Backoff bei 429-Antworten.

Wichtige Hinweise

• Kein AWS IAM/STS erforderlich: Seit 2023 benötigt die SP-API keine AWS Signature V4-Signierung oder IAM-Rollenübernahme mehr. Es werden nur LWA OAuth-Tokens benötigt.
• Grantless-Operationen: Einige Operationen (z. B. Notifications API-Abonnements) verwenden den client_credentials-Grant anstelle von refresh_token. Verwenden Sie scope=sellingpartnerapi::notifications mit grant_type=client_credentials.
• Sandbox-Tests: Die SP-API bietet statische und dynamische Sandbox-Umgebungen zum Testen. Verwenden Sie den Header x-amzn-sandbox: true (statische Sandbox) oder Sandbox-Endpunktmuster.
• Indien-Zeitzone: Amazon Indien arbeitet in IST (UTC+5:30). Bestelldaten und Berichtsdaten sind in UTC; konvertieren Sie bei Bedarf.
• Abrechnungszyklus: Amazon Indien führt die Abrechnung in der Regel alle 7 Tage durch. Abrechnungsberichte enthalten alle Transaktionsdetails einschließlich Gebühren, Rückerstattungen und Nettoguthaben.