Anwendungsfallleitfaden für die Fulfillment-Inbound-API v2024-03-20

Was ist die Fulfillment Inbound API?

Mit der Vertriebspartner-API für eingehenden Versand können Sie Anwendungen entwickeln, mit denen Pläne für eingehende Lieferungen erstellt und aktualisiert werden, um Inventar an das Versandnetzwerk von Amazon zu versenden, wo Amazon die Bestellungen Ihrer Kunden abwickeln kann. Sie können auch Listen mit eingehenden Sendungen oder Artikeln für eingehende Sendungen anfordern, die auf von Ihnen angegebenen Kriterien basieren. Nachdem Ihr Inventar im Versandnetzwerk eingegangen ist, kann Amazon Ihre Bestellungen ausführen, unabhängig davon, ob Sie auf der Einzelhandels-Website von Amazon oder über andere Einzelhandelskanäle verkaufen. Einzelheiten zu API-Vorgängen und den zugehörigen Datentypen und Schemas finden Sie in der Referenz zur API für eingehenden Versand.

Die wichtigsten Funktionen

• Eine eingehende Sendung erstellen: Die Fulfillment Inbound API akzeptiert POST-Operationen zur Erstellung neuer Pläne für eingehende Sendungen und zur Auswahl der Versandarten und Transportoptionen, um die Sendungen festzulegen.
• Rufen Sie Details zu eingehenden Sendungen ab: Die Fulfillment Inbound API akzeptiert GET-Operationen, um detaillierte Informationen zu einer bestehenden Sendung zurückzugeben.
• Pläne für eingehende Lieferungen aktualisieren: Die Fulfillment-API für eingehende Lieferungen akzeptiert POST-Operationen zur Aktualisierung eines oder mehrerer individueller Attribute für einen bestehenden Plan für eingehende Lieferungen, wie z. B. die Aktualisierung des Namens oder der Tracking-ID für eingehende Sendungen.
• Eingehende Tarife löschen: Die Fulfillment Inbound API akzeptiert eine PUT-Operation zum Löschen eines vorhandenen Inbound-Plans.
• Interoperabilität: Mit der Fulfillment Inbound API erstellte Pläne können auf der Amazon-Benutzeroberfläche abgerufen und bearbeitet werden (genannt An Amazon senden (STA)) sobald die Platzierungs- und Transportoptionen bestätigt sind. Sie können die API auch verwenden, um auf Pläne zuzugreifen, die in erstellt wurden STA nachdem Sie die Platzierungs- und Transportoptionen bestätigt haben.

⭐

Tipp

Benutzen generatePlacementOptions um neue Platzierungsoptionen zu generieren und generateTransportationOptions um neue Transportmöglichkeiten zu generieren. Wenn Sie von der API zu STA wechseln, bevor Sie Ihre Optionen bestätigen (mit confirmPlacementOption und confirmTransportationOptions), neue Optionen werden in STA generiert und alle vorherigen Optionen werden verworfen.

Terminologie

• Mit Amazon verbundener Spediteur: Ein Transporteur, der mit Amazon zusammengearbeitet hat, um ermäßigte Versandkosten anzubieten.
• Transporteur, der nicht mit Amazon zusammenarbeitet: Ein Transporteur, der keine Partnerschaft mit Amazon eingegangen ist, um ermäßigte Versandtarife anzubieten.
• Kleine Paketsendung: Einheiten, die in einzelnen Kartons verpackt sind, die für den Versand einzeln etikettiert sind.
• Versand von weniger als LKW-Ladung/Komplettladung (LTL/FTL): Kombiniert einzelne Kartons auf Paletten für die Lieferung. Der LKW kann Lieferungen an andere Ziele enthalten.

Überlegungen

Das Erstellen von Sendungen für die folgenden Ziel-Marketplace-Sites wird nicht unterstützt, wird aber in Zukunft unterstützt:

• Brasilien
• Türkei
• Indien

In diesem Anwendungsfallleitfaden werden zwei v0-Operationen erwähnt, die für die vollständige Sendungserstellung erforderlich sind: getLabels und getBillOfLading. Diese Operationen sind nicht veraltet. Sie müssen diese Operationen weiterhin verwenden, um Ihr Kartonetikett, Ihr Palettenetikett oder Ihren Frachtbrief zu drucken.

Die folgenden v0-Operationen sind nicht veraltet:

• getLabels
• getBillOfLading
• getPrepInstructions
• getShipments
• getShipmentItemsByShipmentId
• getShipmentItems

Versand-Workflow für eingehende Sendungen

Das folgende Diagramm zeigt die Schritte zum Versand von Inventar an das Versandnetzwerk von Amazon. Dies ist ein anschauliches Beispiel und beinhaltet nicht alle optionalen Operationen.

Inventar an das Amazon-Versandnetzwerk versenden

Es gibt zwei Verfahren, die ein Verkäufer befolgen kann, um eine Sendung zu erstellen. Diese unterscheiden sich je nachdem, ob der Verkäufer zum Zeitpunkt der Sendungserstellung weiß, wie seine Kartons verpackt werden. In den meisten Fällen gehen wir davon aus, dass Verkäufer über diese Informationen verfügen, aber es gibt Situationen, in denen diese Informationen nicht ohne weiteres verfügbar sind.

Beachten Sie, dass das Verfahren zum Erstellen einer Sendung, wenn die Informationen auf Kartonebene nicht im Voraus bekannt sind, derzeit nur für LTL-Sendungen verfügbar ist. Dieses Dokument enthält die Schritte, die Sie befolgen können, um Inventar mithilfe eines dieser Verfahren an das Versandnetzwerk von Amazon zu versenden.

Tutorial: Eine Sendung erstellen, wenn der Verkäufer die Informationen auf Kartonebene im Voraus kennt

Voraussetzungen

Um dieses Tutorial abzuschließen, benötigen Sie:

• Autorisierung des Vertriebspartners, für den Sie telefonieren. Weitere Informationen finden Sie unter Autorisierung von API-Anwendungen für Vertriebspartner.
• Zulassung für die Rollen "Amazon Fulfillment" und "Product Listing" in Ihrem Entwicklerprofil.
• Die Rollen "Amazon Fulfillment" und "Product Listing" wurden auf der App-Registrierungsseite für Ihre Bewerbung ausgewählt.
• Um Ihre Angebote erstellt zu haben und zu erfahren, ob Ihre Artikel für den Versand an das Amazon-Versandnetzwerk in Frage kommen (Anweisungen finden Sie im Abschnitt „Optionale Schritte“)

Schritt 1. Erstellen Sie einen Plan für eingehende Lieferungen

Erstellen Sie einen Inbound-Plan, indem Sie den asynchronen Plan aufrufen createInboundPlan Betrieb. Ein Eingangstarif stellt eine Sammlung von Artikeln dar, die Sie in das Versandnetzwerk von Amazon einsenden möchten. Indem Sie den anrufen createInboundPlan Betrieb, ein Verkäufer muss Folgendes angeben:

• Die Adresse, von der die eingehenden Sendungen gesendet werden
• Der Marktplatz, auf den das Produkt versendet werden soll
• Eine Zusammenfassung der Artikel, die sie einsenden möchten.

Die Artikelübersicht muss MSKU, Menge und einen Hinweis darauf enthalten, wer den Artikel vorbereiten/etikettieren wird. Beachten Sie, dass AMAZON kann nur als Labelinhaber ausgewählt werden, wenn Sie beim FBA Label Service registriert sind. Weitere Informationen zum FBA Label Service finden Sie in der Seller Central-Hilfe für Ihre Marketplace-Site.

Stellen Sie sicher, dass jeder Artikel, den Sie versenden, den Produktverpackungsanforderungen von Amazon entspricht. Weitere Informationen finden Sie unter Verpackungs- und Vorbereitungsanforderungen in der Seller Central-Hilfe. Weitere Informationen zu den Anforderungen von Amazon an Produktverpackungen für Ihre Marketplace-Site finden Sie unter URLs von Seller Central. Beachten Sie, dass Verkäufer die Vorbereitungskategorie für SKUs unter An Amazon senden festlegen können. Dies kann einzeln oder bis zu 25 gleichzeitig erfolgen. Dies ist eine einmalige Aktivität pro SKU, die auf alle zukünftigen Inbound-Pläne übertragen wird.

📘

Hinweis

Mehrere Ablaufdaten pro SKU in einem einzigen Inbound-Tarif werden nicht unterstützt. Um eine SKU mit mehreren Ablaufdaten an das Versandnetzwerk zu senden, müssen Sie mehrere Pläne erstellen.

Optional kann ein Verkäufer das Verfallsdatum und den Herstellloscode jedes Artikels angeben. Eine erfolgreiche Antwort beinhaltet eine inboundPlanId Damit wird der Plan für eingehende Sendungen eindeutig identifiziert, was gleichbedeutend mit dem Konzept der „Workflow-ID“ ist. Diese wird auf Send to Amazon (dem Workflow zur Sendungserstellung in Seller Central) generiert.

Textparameter

Beispiel anfordern

POST /inbound/fba/2024-03-20/inboundPlans
{
  "destinationMarketplaces" : [ "ATVPDKIKX0DER" ],
  "items" : [ {
    "expiration" : "2024-01-01",
    "labelOwner" : "AMAZON",
    "manufacturingLotCode" : "manufacturingLotCode",
    "msku" : "Sunglasses",
    "prepOwner" : "AMAZON",
    "quantity" : 10
  } ],
  "name" : "My inbound plan",
  "sourceAddress" : {
    "addressLine1" : "123 example street",
    "addressLine2" : "Floor 19",
    "city" : "Toronto",
    "companyName" : "Acme",
    "countryCode" : "CA",
    "email" : "email@email.com",
    "name" : "name",
    "phoneNumber" : "1234567890",
    "postalCode" : "M1M1M1",
    "stateOrProvinceCode" : "ON"
  }
}

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operationId": "operationId1234",
  "inboundPlanId": "PlanID1234"
}

Überprüfen Sie den Status eines Anrufs

Überprüfen Sie den Status einer eingehenden Anfrage mit dem getInboundOperationStatus Betrieb. Bei asynchronen Vorgängen liefert dieser Vorgang den Verarbeitungsstatus. Wir lassen diesen Schritt für andere asynchrone Operationen in diesem Tutorial aus. Indem du anrufst getInboundOperationStatus, ein Verkäufer übergibt die operationId, was ein Universal Unique Identifier (UUID) für den Vorgang ist.

Eine erfolgreiche Antwort beinhaltet den Anforderungsstatus und alle nicht blockierenden Fehler im Zusammenhang mit der Anfrage. Nicht blockierende Fehler sind Warnungen, die ignoriert werden können (z. B. wenn der Verdacht besteht, dass die Adresse falsch ist, eine Progression aber trotzdem zulässig ist).

Pfadparameter

Beispiel anfordern

GET /inbound/fba/2024-03-20/operations/{operationId}

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operation": "string",
  "operationId": "string",
  "operationProblems": [
    {
      "code": "Error code 1234",
      "message": "Box volume does not meet the expected minimum cubic cm 144,815",
      "details": "Additional error details",
      "severity": "WARNING"
    }
  ],
  "status": "SUCCESS",
}

Schritt 2. Ermitteln Sie, welche SKUs zusammengepackt werden können

❗

Warnung

Stand: 20. Februar 2025, Teillieferungen sind im Workflow „An Amazon senden“ für Produkte in Standardgröße nicht verfügbar. Teillieferungen für große, sperrige Produkte sind weiterhin möglich. Weitere Informationen finden Sie unter Servicegebühr für die Inbound-Platzierung per FBA 2025.

Dieser Schritt ist notwendig, um zu bestimmen, welche Artikel zusammen verpackt werden können. Einige Artikel können aufgrund unterschiedlicher Anforderungen an die Handhabung oder das Versandzentrum nicht zusammen verpackt werden. Für die weitere Trennung von Artikeln kann ein Rabatt gewährt werden.

📘

Hinweis

In der EU gibt es nur vergünstigte Optionen für Small Parcel Delivery (SPD) -Sendungen. Diese vergünstigten Optionen können zusätzliche Anforderungen beinhalten, einschließlich der Anforderung, dass jedes Paket weniger als 15 Kilogramm wiegen muss.

Gehen Sie wie folgt vor, um zu ermitteln, welche SKUs physisch zusammengepackt werden können:

• generatePackingOptions
• listPackingOptions
• listPackingGroupItems
• confirmPackingOption

EIN PackingGroup steht für eine Reihe von SKUs, die zusammengepackt werden können. SKUs, die nicht zusammengepackt werden können, werden in verschiedene Packgruppen aufgeteilt. Beispielsweise können SKUs, die als Gefahrgut eingestuft sind, nicht zusammen mit anderen SKUs verpackt werden, da Gefahrgut-SKUs an spezielle Versandzentren versendet werden, die sie sicher entgegennehmen können. Andere Faktoren, die bestimmen, welche SKUs zusammen verpackt werden können und welche nicht, sind das Gewicht und die Abmessungen der SKUs, die Anforderungen an die Vorbereitung und Kennzeichnung sowie die Barcode-Anforderungen.

Das PackingOptions object steht für eine Reihe von Optionen für die Zuordnung von Artikeln zu Verpackungsgruppen. Jeder PackingOption beinhaltet eine Reihe von PackingGroups, die jeweils eine Liste von SKUs enthalten. Mit jeder dieser Optionen können Rabatte oder Gebühren verbunden sein. Außerdem kann jede Option auf eine Teilmenge aller möglichen Versandarten beschränkt werden. Diese Verpackungsvorgänge ermöglichen es dem Verkäufer, eine Option zu überprüfen und auszuwählen.

Schritt 2a. Generieren Sie Verpackungsoptionen

Generieren Sie zunächst die Verpackungsoptionen mit dem generatePackingOptions Betrieb.

Pfadparameter

Beispiel anfordern

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/packingOptions

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operationId": "string",
  "inboundPlanId": "string"
}

Schritt 2b. Packoptionen auflisten

Überprüfen Sie als Nächstes eine Liste der Verpackungsoptionen mit dem listPackingOptions Betrieb. Die Verpackungsoptionen enthalten Gruppen von Paketgruppen, die ein Verkäufer auswählen kann, sowie zusätzliche Informationen, die dem Verkäufer bei der Auswahl zwischen diesen Optionen helfen können. Zu den zusätzlichen Informationen gehören die mit jeder Option verbundenen Gebühren/Rabatte, die von jeder Option unterstützten Versandarten, die von jeder Option unterstützten Verpackungsarten, die von jeder Option unterstützten Paketgewichte und das Ablaufdatum jeder Option.

Pfadparameter

Parameter abfragen

Beispiel anfordern

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/packingOptions

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "pagination": {
    "nextToken": "string"
  },
  "packingOptions": [
    {
      "inboundPlanId": "string",
      "packingOptionId": "string",
      "packingGroups": [
        "string"
      ],
      "fees": [
        {
          "currency": {
            "code": "string",
            "amount": 0
          },
          "type": "FEE",
          "target": "OUTBOUND_PER_SHIPMENT",
          "description": "string"
        }
      ],
      "discounts": [
        {
          "currency": {
            "code": "string",
            "amount": 0
          },
          "type": "FEE",
          "target": "OUTBOUND_PER_SHIPMENT",
          "description": "string"
        }
      ],
      "expiration": "2019-08-24T14:15:22Z",
      "status": "OFFERED",
      "supportedShippingModes": [
        {
          "shippingSolution": "AMAZON_PARTNERED_CARRIER",
          "shippingMode": "GROUND_SMALL_PARCEL"
        }
      ]
    }
  ]
}

Schritt 2c. Listet Artikel in jeder Verpackungsoption auf

Um die Artikel in jeder Verpackungsgruppe anzuzeigen, verwenden Sie die listPackingGroupItems Betrieb.

Pfadparameter

Parameter abfragen

Beispiel anfordern

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/packingGroups/{packingGroupId}/items

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "pagination": {
    "nextToken": "string"
  },
  "items": [
    {
      "msku": "string",
      "asin": "string",
      "fnsku": "string",
      "labelOwner": "AMAZON",
      "quantity": 1,
      "prepOwner": "AMAZON"
    }
  ]
}

Schritt 2d. Wählen Sie eine Verpackungsoption

Wählen Sie eine Verpackungsoption mit dem confirmPackingOption Betrieb.

Pfadparameter

Beispiel anfordern

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/packingOptions/{packingOptionId}/confirmation

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operationId": "string"
}

Schritt 3. Geben Sie Informationen zum Kartoninhalt an

Um Informationen zu den Artikeln bereitzustellen, die in die einzelnen Kartons verpackt werden, verwenden Sie das setPackingInformation Betrieb. Durch die Bereitstellung dieser Informationen wird sichergestellt, dass die im nachfolgenden Schritt generierten Sendungsaufteilungen generiert werden (generatePlacementOptions) sind korrekt. Wenn in diesem Schritt keine Kartoninformationen bereitgestellt werden, basieren die im nächsten Schritt generierten Versandaufteilungen nur auf den Angaben zur Einheit, die Amazon im Rahmen von createInboundPlan. Indem du anrufst setPackingInformation, muss ein Verkäufer die folgenden Informationen für jede Box angeben, die er einsenden möchte:

• ID der Verpackungsgruppe
• Informationsquelle für den Kartoninhalt
• Lieferumfang (Artikel, Artikelmengen, Besitzer der Vorbereitung/des Etiketts für jeden Artikel)
• Kartoninformationen (Abmessungen, Gewicht und Anzahl der Kartons)

📘

Hinweis

Wenn ein Verkäufer Informationen zur Kartonverpackung bereitstellt unter setPackingInformation, generiert Platzierungsoptionen und bearbeitet dann ihre Kartonverpackungsinformationen mit setPackingInformation, dann muss der Verkäufer anrufen generatePlacementOptions nochmal vor dem Anruf confirmPlacementOption. Wenn ein Verkäufer seine Informationen zur Kartonverpackung eingibt mit setPackingInformation und entscheidet dann, dass sie diese Informationen vollständig verwerfen wollen. Sie müssen einen neuen Inbound-Tarif starten mit createInboundPlan. Das Verwerfen von Verpackungsinformationen wird derzeit nicht unterstützt.

Die Informationsquelle zum Kartoninhalt gibt an, wie der Verkäufer beabsichtigt, Informationen zum Kartoninhalt bereitzustellen. Dabei kann es sich um eine von drei Optionen handeln:

• Füllen des Felds Inhalt (BOX_CONTENT_PROVIDED)
• Zahlung einer Gebühr an Amazon für die Eingabe dieser Informationen während des Empfangsvorgangs (MANUAL_PROCESS)
• Anbringen von 2D-Barcodes an den Boxen (BARCODE_2D)

Der Verkäufer muss auch die Kartonabmessungen, das Kartongewicht und die Menge der einzelnen Kartons angeben. Wann boxAttribute ist eingestellt aufBARCODE_2D oder MANUAL_PROCESS:

• Sie müssen keine SKUs und Mengen angeben.
• Du musst gehen items leer (bitte geben Sie ein null Wert).

Eine erfolgreiche Antwort beinhaltet die operationId das kann verwendet werden, um den Status der Operation zu ermitteln mit getInboundOperationStatus.

📘

Hinweis

Übergeben Sie in diesem Fluss die PackingGroupId aber lass das weg ShipmentId.

Pfadparameter

Textparameter

Beispiel anfordern

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/packingInformation
{
  "packageGroupings": [
    {
      "packingGroupId": "string",
      "boxes": [
        {
          "weight": {
            "unit": "LB",
            "value": 0
          },
          "dimensions": {
            "unitOfMeasurement": "IN",
            "length": 0,
            "width": 0,
            "height": 0
          },
          "quantity": 1,
          "boxId": "string",
          "items": [
            {
              "msku": "string",
              "quantity": 1,
              "expiration": "string",
              "prepOwner": "AMAZON",
              "labelOwner": "AMAZON",
              "manufacturingLotCode": "string"
            }
          ],
          "contentInformationSource": "BOX_CONTENT_PROVIDED"
        }
      ]
    }
  ]
}

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operationId": "string"
}

Schritt 4. Generieren Sie Optionen für Ziel-Versandzentren und zeigen Sie sie an

❗

Warnung

Stand: 20. Februar 2025, Teillieferungen sind im Workflow „An Amazon senden“ für Produkte in Standardgröße nicht verfügbar. Teillieferungen für große, sperrige Produkte sind weiterhin möglich. Weitere Informationen finden Sie unter Servicegebühr für die Inbound-Platzierung per FBA 2025.

Generieren Sie Platzierungsoptionen für einen Inbound-Tarif, indem Sie den generatePlacementOptions Betrieb. Das PlacementOptions object steht für die verfügbaren Platzierungsoptionen für einen Tarif für eingehende Lieferungen, wobei jede Platzierungsoption die Ziel-FCs und Versandoptionen für jeden Artikel in Ihrem Eingangstarif beschreibt. Diese Optionen tragen dazu bei, die Zeit zu reduzieren, die benötigt wird, um die Artikel eines Verkäufers zu erhalten und zum Verkauf anzubieten. Beziehen Sie sich auf Hilfe in Seller Central für weitere Informationen.

📘

Hinweis

Dieser Vorgang generiert erste Sendungsnummern für die Sendungen innerhalb jedes Eingangsplans. Diese IDs unterscheiden sich von den shipmentConfirmationIDs Das confirmPlacementOption generiert. Das shipmentConfirmationID ist die ID, die auf den Etiketten vorhanden ist (zum Beispiel FBA1234ABCD). Sie können diese beiden Arten von Sendungsnummern mit dem getShipment Betrieb.

Einige Ihrer Optionen können mehrere Ziele beinhalten (siehe Hilfe in Seller Central für Details). Jede Option kann Gebühren oder Rabatte beinhalten, die bei der Erstellung Ihrer Sendung festgelegt werden und nicht anhand eines festen Tarifs berechnet werden. Der Rabattwert und die Lieferadresse hängen von mehreren Faktoren ab, einschließlich des erwarteten Volumens, der Verfügbarkeit von Transporteurterminen und der Versandgeschwindigkeit. Der Rabatt, für den Ihre Sendung in Frage kommt, wird bei der Sendungserstellung gewährt.

Die Allgemeinen Geschäftsbedingungen können sich ändern. Lesen Sie die aktuellen Allgemeinen Geschäftsbedingungen von Seller Central, einschließlich der Vereinbarung über Amazon Services Business Solutions.

Pfadparameter

Textparameter

Beispiel anfordern

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/placementOptions
{
}

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operationId": "string"
}

Um die Optionen für Versandaufteilungen einzusehen, rufen Sie die listPlacementOptions Betrieb. Dieser Vorgang liefert die Liste der verfügbaren Platzierungsoptionen, darunter:

• Eine Platzierungsoptions-ID
• Der Optionsstatus („angeboten“ oder „akzeptiert“)
• Alle mit dieser Option verbundenen Gebühren/Rabatte
• Das Ablaufdatum der Option
• Die Sendungsnummern, die jeder Option zugeordnet sind

Wenn eine Platzierungsoption abläuft, müssen Sie die Platzierungsoptionen neu generieren, indem Sie generatePlacementOption. Die ID der Platzierungsoption ist erforderlich, um Transportoptionen mit zu generieren generateTransportationOptions, während Sendungsnummern verwendet werden, um den Inhalt jeder Sendung zu verstehen, indem getShipment.

Pfadparameter

Parameter abfragen

Beispiel anfordern

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/placementOptions

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "pagination": {
    "nextToken": "string"
  },
  "placementOptions": [
    {
      "inboundPlanId": "string",
      "placementOptionId": "string",
      "status": "OFFERED",
      "fees": [
        {
          "currency": {
            "code": "string",
            "amount": 0
          },
          "type": "FEE",
          "target": "OUTBOUND_PER_SHIPMENT",
          "description": "string"
        }
      ],
      "discounts": [
        {
          "currency": {
            "code": "string",
            "amount": 0
          },
          "type": "FEE",
          "target": "OUTBOUND_PER_SHIPMENT",
          "description": "string"
        }
      ],
      "expiration": "2019-08-24T14:15:22Z",
      "shipmentIds": [
        "string"
      ]
    }
  ]
}

Schritt 5. Geben Sie Transportdaten ein und generieren Sie Transportoptionen

Generieren Sie Transportmöglichkeiten mit dem generateTransportationOptions Betrieb. Eine Transportoption stellt die Liste der Versandarten und Transporteuroptionen dar, die für jede Sendung innerhalb der einzelnen Platzierungsoptionen verfügbar sind. Indem Sie anrufen generateTransportationOptions, ein Verkäufer muss die folgenden Informationen weitergeben:

• ID der Platzierungsoption
• Sendungsnummer
• Datum der Versandbereitschaft
• Absenderadresse

Pfadparameter

Textparameter

Beispiel anfordern

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/transportationOptions
{
  "placementOptionId": "string",
  "shipmentTransportationConfigurations": [
    {
      "shipmentId": "string",
      "readyToShipWindow": {
        "start": "2019-08-24T14:15:22Z"
      },
      "contactInformation": {
        "phoneNumber": "string",
        "email": "string",
        "name": "string"
      },
      "palletInformation": {
        "pallets": [
          {
            "weight": {
              "unit": "LB",
              "value": 0
            },
            "dimensions": {
              "unitOfMeasurement": "IN",
              "length": 0,
              "width": 0,
              "height": 0
            },
            "quantity": 1,
            "stackability": "STACKABLE"
          }
        ],
        "freightClass": "string",
        "declaredValue": {
          "code": "str",
          "amount": 0
        }
      }
    }
  ]
}

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operationId": "string"
}

Schritt 6. Generieren Sie die Optionen für das Lieferfenster mit dem generateDeliveryWindowOptions Betrieb

🚧

Wichtig

Verkäufer müssen die Transportoptionen für alle Versandarten bestätigen. Bei Lieferungen ohne Partner müssen Verkäufer außerdem ein Lieferfenster angeben.

Lieferfenster sind Zeiträume, in denen ein Verkäufer seine Sendung an das Ziel-Versandzentrum liefern kann. Wenn der Verkäufer einen Transporteur verwendet, der keinen Transportpartner hat, muss er ein Lieferfenster von sieben Tagen für Inlandssendungen oder ein 14-tägiges Zeitfenster für internationale Sendungen angeben. Das Zeitfenster wird verwendet, um Datum und Uhrzeit der voraussichtlichen Ankunft einer Sendung in einem Amazon-Versandzentrum anzugeben. Für Sendungen, für die kein Termin mit einem Versandzentrum vereinbart wurde, ist eine Option mit einem verfügbaren Lieferfenster erforderlich. Beispielsweise benötigen Lieferungen, die nicht mit Transporteuren zusammenarbeiten, ein bestätigtes Lieferfenster.

generateDeliveryWindowOptions verlangt vom Verkäufer, dass er die shipmentID für die Sendung, für die sie Lieferfenster generieren wollen.

Pfadparameter

Beispiel anfordern

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/deliveryWindowOptions

Antwort

Beispiel für eine Antwort

{
  "operationId": "string"
}

Schritt 7. Überprüfen Sie die Versandaufteilungen und die Transportoptionen

Überprüfen Sie die Versand- und Transportoptionen, indem Sie die listPlacementOptions, listTransportationOptions, und getShipment Operationen.

listPlacementOptions stellt die Liste der verfügbaren Platzierungsoptionen bereit, die eine Platzierungsoptions-ID, den Status der Option (d. h. angeboten oder akzeptiert), alle mit dieser Option verbundenen Gebühren/Rabatte, das Ablaufdatum der Option und die jeder Option zugewiesenen Sendungsnummern enthält.

Um anzurufen listTransportationOptions, ein Verkäufer muss die ID der Platzierungsoption und die Sendungsnummer angeben, für die er die Transportoptionen anzeigen möchte. Wenn für eine Platzierungsoption keine Transportoptionen verfügbar sind, rufen Sie an listTransportationOptions nochmal für eine alternative Platzierungsoption. Eine erfolgreiche Antwort beinhaltet alle verfügbaren Transportangebote für alle verfügbaren Schiffsarten und Beförderungsoptionen. Zu den Versandarten gehören:

• Gemahlenes kleines Paket
• Fracht mit weniger als LKW-Ladungen
• Volle LKW-Ladungsfracht (palettiert)
• Volle LKW-Ladungsfracht (nicht palettiert)
• Weniger als eine Containerladung auf dem Meer
• Volle Containerladung Meer
• Kleines Paket in der Luft
• Air Small Parcel Express

Zu den Transporteuroptionen gehören mit Amazon zusammenarbeitende und nicht mit Amazon zusammenarbeitende Transporteure. Zu den Angeboten gehören:

• Kosten
• Ein ungültiges Zeitfenster (der Zeitraum, in dem ein Verkäufer eine Sendung stornieren und eine Rückerstattung für sein Transportangebot erhalten kann)
• Ablauf

In Regionen, in denen Termine im Versandzentrum verpflichtend sind (z. B. Indien), stellen wir verfügbare Termine zur Verfügung.

Wo das Transportpartnerprogramm (PCP) verfügbar ist, können Verkäufer von ermäßigten Tarifen profitieren, indem sie für ihre eingehenden Sendungen einen Amazon-Transporteur beauftragen. Um einen Amazon-Versandpartner für eine eingehende Sendung zu verwenden, wählen Sie die Transportoption aus shippingSolution ist AMAZON_PARTNERED_CARRIER.

📘

Hinweis

Bevor Sie einen Amazon-Transportpartner für eine eingehende Sendung verwenden, müssen Sie die Seller Central-Hilfe zum Transporteurpartnerprogramm von Amazon lesen, um sicherzustellen, dass Sie die Anweisungen und Richtlinien des Programms erfolgreich befolgen (Europa) (UNS).

In der EU-Region müssen Sie zunächst die Allgemeinen Geschäftsbedingungen des Transporteurs und die Allgemeinen Geschäftsbedingungen von Amazon PCP überprüfen und akzeptieren. Sie können dies tun auf Seller Central. Wenn Sie versuchen, mithilfe der Amazon-Vertriebspartner-APIs eine eingehende Sendung mithilfe eines Amazon-Transportpartners zu erstellen, bevor Sie diese Allgemeinen Geschäftsbedingungen akzeptiert haben, gibt der Service einen Fehler zurück.

Wenn ein Verkäufer nicht am PCP teilnehmen möchte, kann er Folgendes einsehen Choose your own carrier Transportoptionen und verfügbare Versandarten.

Amazon filtert in bestimmten Situationen Transportoptionen von Transportpartnern heraus. Wenn es beispielsweise eine Transportoption mit identischen Versandaufteilungen zu einem niedrigeren Preis für eine Vermittlungsoption mit identischen Versandaufteilungen gibt, filtert Amazon die teurere Transportoption heraus. Wenn Sie vorhaben, einen Transportpartner zu nutzen, rufen Sie an listTransportationOptions für jede Platzierungsoption, um die verfügbaren Carrier-Partneroptionen zu sehen.

📘

Hinweis

Sie können eine Mischung aus Small Parcel Delivery (SPD) und LTL-Sendungen in einem Eingangstarif zusammenfassen. Sie können auch eine Mischung aus PCP- und Nicht-PCP-Sendungen in einen eingehenden Tarif aufnehmen, wenn:

• Die verschiedenen Transporteure sind verschiedenen Versandarten zugeordnet (z. B. SPD und LTL).
• Alle Sendungen im Paket für eingehende Sendungen kommen für PCP in Frage.

Sie können beispielsweise einen Eingangsplan mit einer PCP-SPD-Sendung und einer Nicht-PCP-LTL-Sendung erstellen, wobei davon ausgegangen wird, dass alle Sendungen innerhalb des Eingangsplans für PCP in Frage kommen.

Weitere Informationen zur PCP-Eignung finden Sie in der PCP-Hilfeseite.

Pfadparameter

Parameter abfragen

Beispiel anfordern

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/transportationOptions

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "pagination": {
    "nextToken": "string"
  },
  "transportationOptions": [
    {
      "inboundPlanId": "string",
      "placementOptionId": "string",
      "shipmentId": "string",
      "transportationOptionId": "string",
      "shippingSolution": "AMAZON_PARTNERED_CARRIER",
      "carrier": {
        "name": "string",
        "alphaCode": "string"
      },
      "shippingMode": "GROUND_SMALL_PARCEL",
      "quote": {
        "cost": {
          "code": "string",
          "amount": 0
        },
        "voidableUntil": "2019-08-24T14:15:22Z",
        "expiration": "2019-08-24T14:15:22Z"
      },
      "appointmentSlot": {
        "startDate": "2019-08-24T14:15:22Z",
        "endDate": "2019-08-24T14:15:22Z",
        "startTime": "2019-08-24T14:15:22Z",
        "endTime": "2019-08-24T14:15:22Z"
      }
    }
  ]
}

Prüfen Sie die verfügbaren Lieferfensteroptionen für jede Sendung innerhalb eines Eingangsplans mithilfe der listDeliveryWindowOptions Betrieb. Um diesen Anruf zu tätigen, leitet ein Verkäufer die shipmentID. Eine erfolgreiche Antwort liefert die startDate und endDate für jedes verfügbare Lieferfenster und den Grad der Überlastung (availabilityType) für jede Option.

🚧

Wichtig

Verkäufer müssen die Transportoptionen für bestätigen alles Arten der Lieferung. Für Sendungen, die nicht von Amazon als Partner stammen, müssen sie außerdem ein Lieferfenster angeben.

Jede Option hat ein Ablaufdatum (validUntil). Sie müssen die Lieferung vor diesem Datum bestätigen. Wenn Sie das Fenster nicht bestätigen, indem Sie validUntil Datum, Sie müssen ein neues Fenster generieren mit listDeliveryWindowOptions.

Pfadparameter

Parameter abfragen

Beispiel anfordern

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/deliveryWindowOptions

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "pagination": {
    "nextToken": "string"
  },
  "deliveryWindowOptions": [
    {
      "inboundPlanId": "string",
      "placementOptionId": "string",
      "shipmentId": "string",
      "deliveryWindowOptionId": "string",
      "startDate": "2019-08-24T14:15:22Z",
      "endDate": "2019-08-24T14:15:22Z",
      "availabilityType": "string",
      "validUntil": "2019-08-24T14:15:22Z"
    }
  ]
}

Überprüfen Sie die Details zum Inhalt einer Sendung innerhalb eines Eingangsplans mithilfe der getShipment Betrieb. Um anzurufen getShipment, ein Verkäufer muss die ID für den eingehenden Tarif und die Sendungsnummer weitergeben. Eine erfolgreiche Antwort beinhaltet Folgendes:

• ID der Platzierungsoption
• Versandbestätigte ID (die ID, die auf den Etiketten erscheint)
• Sendungsnummer (die Kennung für eine Sendung vor dem confirmPlacementOption Betrieb)
• Amazon-Referenz-ID (Kennung für die Planung von Terminen im Versandzentrum für Lkw-Lieferungen)
• ID der ausgewählten Transportoption
• Name
• Quelle
• Reiseziel FC
• Datum des Versands
• Voraussichtlicher Liefertermin
• Status
• Einzelheiten zur Nachverfolgung
• Informationen zur Palette
• Kontaktinformationen
• Zielregion
• Einzelheiten zum FC-Termin

📘

Hinweis

Wenn der Verkäufer einen Transportpartner auswählt, bedeutet das destinationType ist AMAZON_OPTIMIZED, dann kann die Adresse des Ziel-Versandzentrums von der tatsächlichen Adresse abweichen, oder dieses Feld ist möglicherweise leer. Die richtige Adresse finden Sie auf dem Kartonetikett.

Pfadparameter

Beispiel anfordern

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "inboundPlanId": "string",
  "placementOptionId": "string",
  "shipmentId": "string",
  "shipmentConfirmationId": "string",
  "amazonReferenceId": "string",
  "selectedTransportationOptionId": "string",
  "name": "string",
  "source": {
    "sourceType": "SELLER_FACILITY",
    "address": {
      "name": "string",
      "companyName": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "countryCode": "st",
      "stateOrProvinceCode": "string",
      "postalCode": "string"
    }
  },
  "destination": {
    "destinationType": "AMAZON_OPTIMIZED",
    "address": {
      "name": "string",
      "companyName": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "countryCode": "st",
      "stateOrProvinceCode": "string",
      "postalCode": "string"
    },
    "warehouseId": "string"
  },
  "dates": {
    "readyToShipWindow": {
      "start": "2019-08-24T14:15:22Z",
      "end": "2019-08-24T14:15:22Z",
      "editableUntil": "2019-08-24T14:15:22Z"
    },
    "deliveryWindow": {
      "start": "2019-08-24T14:15:22Z",
      "end": "2019-08-24T14:15:22Z",
      "editableUntil": "2019-08-24T14:15:22Z"
    }
  },
  "status": "ABANDONED",
  "trackingDetails": {
    "ltlTrackingDetail": {
      "freightBillNumber": [
        "string"
      ],
      "billOfLadingNumber": "string"
    },
    "spdTrackingDetail": {
      "spdTrackingItems": [
        {
          "boxId": "string",
          "trackingId": "string",
          "trackingNumberValidationStatus": "VALIDATED"
        }
      ]
    }
  },
  "palletInformation": {
    "pallets": [
      {
        "weight": {
          "unit": "LB",
          "value": 0
        },
        "dimensions": {
          "unitOfMeasurement": "IN",
          "length": 0,
          "width": 0,
          "height": 0
        },
        "quantity": 1,
        "stackable": true
      }
    ],
    "freightClass": "NONE",
    "declaredValue": {
      "code": "string",
      "amount": 0
    }
  },
  "contactInformation": {
    "phoneNumber": "string",
    "email": "string",
    "name": "string"
  },
  "selfShipAppointmentDetails": [
    {
      "appointmentId": 0,
      "appointmentSlotTime": {
        "startTime": "2019-08-24T14:15:22Z",
        "endTime": "2019-08-24T14:15:22Z"
      },
      "appointmentStatus": "string"
    }
  ]
}

Schritt 8. Wählen Sie die Versandoption

Wählen Sie die Versandoption (d. h. Versandaufteilung) mit dem confirmPlacementOption Betrieb. Bei diesem Vorgang werden die Platzierungsaufteilungen für einen Eingangsplan ausgewählt und bestätigte Sendungsnummern für Sendungen innerhalb des Eingangsplans erstellt. Der shipmentConfirmationID ist die Sendungskennzeichnung, die auf den Etiketten erscheint (zum Beispiel FBA1234ABCD). Diese ID unterscheidet sich von der Sendungsnummer, die mit generiert wird createInboundPlan, das als Eingabe für andere Operationen verwendet wird, wie getShipment. Diese Option kann nicht rückgängig gemacht werden, nachdem sie ausgewählt wurde. Um anzurufen confirmPlacementOption, ein Verkäufer muss die ID für den eingehenden Tarif und die ID der ausgewählten Platzierungsoption weitergeben.

📘

Hinweis

createInboundPlan generiert die ersten Sendungsnummern für die Sendungen in jedem Eingangsplan. Diese IDs unterscheiden sich von den shipmentConfirmationIDs Das confirmPlacementOption generiert. Das shipmentConfirmationID ist der Bezeichner, der auf Etiketten vorhanden ist (zum Beispiel FBA1234ABCD). Sie können beide Arten von Sendungsnummern mit dem getShipment Betrieb.

Pfadparameter

Beispiel anfordern

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/placementOptions/{placementOptionId}/confirmation

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operationId": "string"
}

Schritt 9. Wählen Sie die Transportoptionen

Wählen Sie Lieferfenster für jede Sendung innerhalb eines Plans mithilfe der confirmDeliveryWindowOptions Betrieb. Um diese Operation aufzurufen, übergeben Sie den shipmentID und deliveryWindowOptionId (bereitgestellt von listDeliveryWindowOptions).

Sie müssen eine Platzierungsoption für die Sendung bestätigen, bevor Sie diesen Vorgang aufrufen. Nachdem Sie das Lieferfenster bestätigt haben, können keine neuen Lieferfensteroptionen generiert werden. Sie können die gewählte Lieferfensteroption jedoch vor Abschluss der Lieferung aktualisieren. Für alle Transportoptionen, für die das Programm verfügbar ist DELIVERY_WINDOW_REQUIRED, Sie müssen ein Lieferfenster bestätigen, bevor Sie die Transportoption bestätigen. Wenn Sie Ihr Lieferfenster aktualisieren müssen, nachdem Sie die Transportoption bestätigt haben, können Sie anrufen confirmDeliveryWindow.

Pfadparameter

Beispiel anfordern

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/deliveryWindowOptions/confirmation
{
  "transportationSelections": [
    {
      "shipmentId": "string",
      "transportationOptionId": "string",
      "contactInformation": {
        "phoneNumber": "string",
        "email": "string",
        "name": "string"
      }
    }
  ]
}

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operationId": "string"
}

❗️

Warnung

Bei Lieferungen ohne Transportpartner müssen Verkäufer ihr voraussichtliches Lieferfenster telefonisch bestätigen confirmTransportationOptions bevor sie ihren Termin im Versandzentrum (FC) buchen.

Verkäufer sollten ihren Transporteur, der keinen Transportpartner hat, bitten, einen FC-Termin zu vereinbaren, der innerhalb des voraussichtlichen Lieferfensters liegt. Wenn der FC-Termin nicht innerhalb des Lieferfensters liegt, kann der Verkäufer anrufen confirmDeliveryWindow um ein anderes Lieferfenster auszuwählen, das ihren FC-Termin enthält.

In diesem obligatorischen Schritt können Sie die Transportoptionen für jede Sendung innerhalb eines Eingangsplans mithilfe der confirmTransportationOptions Betrieb. Bei Transportoptionen mit einem Amazon-Partner bestätigt dieser Vorgang, dass der Verkäufer den Kostenvoranschlag des Amazon-Versandpartners akzeptiert, sich damit einverstanden erklärt, dass Amazon sein Konto mit den Versandkosten belastet, und verlangt, dass der Amazon-Versandpartner die eingehende Sendung versendet. Vor diesem Anruf muss ein Verkäufer eine Platzierungsoption für seinen Tarif für eingehende Lieferungen bestätigen. Um anzurufen confirmTransportationOptions, muss ein Verkäufer die Sendungsnummer, die ID der ausgewählten Transportoption und die Kontaktinformationen (erforderlich für Transportpartner für LTL-Sendungen) weitergeben. Wenn eine Transportoption bestätigt wurde, können keine neuen Transportoptionen für einen Tarif für eingehende Sendungen generiert oder bestätigt werden. Sie müssen eine Transportoption bestätigen, bevor Sie die Etiketten drucken können.

📘

Hinweis

Wenn ein Verkäufer die Transportanfrage bestätigt und dann entscheidet, dass er nicht möchte, dass der Amazon-Transporteur die eingehende Sendung versendet, kann er cancelInboundPlan um die Transportanfrage zu stornieren. Bei Small Parcel-Sendungen hat der Verkäufer nach Bestätigung einer Transportanfrage 24 Stunden Zeit, um die Anfrage zu stornieren. Bei Sendungen mit weniger als Truckload/Full Truckload (LTL/FTL) hat der Verkäufer nach Bestätigung einer Transportanfrage eine Stunde Zeit, um die Anfrage zu stornieren. Nach Ablauf der entsprechenden Frist werden die Versandkosten dem Konto des Verkäufers in Rechnung gestellt.

Pfadparameter

Textparameter

Beispiel anfordern

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/transportationOptions/confirmation
{
  "transportationSelections" : [ {
    "contactInformation" : {
      "email" : "email@email.com",
      "name" : "John Smithy",
      "phoneNumber" : "1234567890"
    },
    "deliveryWindow" : {
      "start" : "2024-01-01T00:00Z"
    },
    "shipmentId" : "sh1234abcd-1234-abcd-5678-1234abcd5678",
    "transportationOptionId" : "to1234abcd-1234-abcd-5678-1234abcd5678"
  } ]
}

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operationId": "string"
}

Schritt 10. Etiketten drucken

Rufen Sie den getLabels Vorgang, um individuelle Versandetiketten für Ihre eingehenden Sendungen anzufordern. Jedes von der zurückgesandte Versandetikett getLabels Das entsprechende Etikett sollte auf dem Paket in der Sendung angebracht werden, sodass auf den Etiketten der Inhalt des Pakets angegeben ist. Auf diese Weise können Sie sicherstellen, dass Ihre Sendung im Amazon-Versandzentrum schnell und korrekt bearbeitet wird.

❗️

Warnung

Der Wert von shipmentId in der getLabels Anfrage muss die sein shipmentId (ab v0) oder shipmentConfirmationId (von v2024-03-20). Benutze nicht den shipmentId von v2024-03-20.

Um Etiketten für einen bestimmten Karton zu drucken, geben Sie die boxID (aus dem listShipmentBoxes Antwort) als PackageLabelsToPrint Wert.

Beachten Sie, dass der Versandstatus nicht ready_to_ship wenn Sie Kartonetiketten abrufen mit getLabels. Damit ein Sendungsstatus wie folgt ready_to_ship, Sie müssen Labels auf Send to Amazon generieren.

Informationen auf Versandetiketten

In jedem Fall gibt der getLabels-Vorgang Versandetiketten zurück, die einen eindeutigen Barcode und eine Paket-ID enthalten (die Zeichenkette direkt unterhalb des Barcodes). Abhängig vom Inhalt der Pakete in Ihren Sendungen können die Etiketten auch eine ASIN und ein Ablaufdatum enthalten.

Versandetiketten enthalten bei folgenden Situationen eine ASIN und ein Verfallsdatum:

• Jeder Artikel in der Lieferung hat dieselbe ASIN und dasselbe Verfallsdatum.
• Die Sendung enthält mehrere ASINs, aber jedes Paket in der Sendung enthält Artikel, die dieselbe ASIN und dasselbe Verfallsdatum haben.

Versandetiketten enthalten bei folgenden Situationen eine ASIN und kein Verfallsdatum:

• Jeder Artikel in der Lieferung hat dieselbe ASIN. Die ASIN hat kein Verfallsdatum.
• Die Sendung enthält mehrere ASINs, aber jedes Paket in der Sendung enthält Artikel, die dieselbe ASIN haben. Die ASINs haben kein Verfallsdatum.

Versandetiketten enthalten keine ASIN oder kein Verfallsdatum, wenn die Sendung mindestens ein Paket mit Artikeln enthält, die nicht dieselbe ASIN und dasselbe Verfallsdatum haben.

📘

Konstruieren Sie einen einzigartigen Barcode für kleine Paketsendungen

Bei Sendungen mit kleinen Paketen sollte das Versandetikett für jedes Paket einen eindeutigen Barcode haben. Dadurch wird sichergestellt, dass Ihre Sendung zeitnah bearbeitet wird, wenn sie das Amazon-Versandnetzwerk erreicht. Gehen Sie wie folgt vor, um eindeutige Barcode-Werte für jedes Paket in einer Sendung zu erstellen:

1. Beginnen Sie mit dem Wert der Versandnummer und fügen Sie ihn an U und 000001 um den Barcode-Wert für das erste Paket in der Sendung zu erhalten.

2. Um die Barcode-Werte für jedes nachfolgende Paket in der Sendung abzurufen, erhöhen Sie den nachfolgenden numerischen Wert des vorherigen Pakets um eins. Zum Beispiel, wenn Sie drei Pakete in einer Sendung mit einem Sendungsnummer-Wert von haben FBA1MMD8D0, deine drei Barcode-Werte wären FBA1MMD8D0U000001, FBA1MMD8D0U000002, und FBA1MMD8D0U000003. Ein Kartonetikett, das mit einer eigenen eindeutigen numerischen Kennzeichnung gekennzeichnet ist, muss dem sechsstelligen Zahlenformat nach U folgen. Es muss ausgedruckt und an jedem Karton angebracht werden, den Sie an ein Versandzentrum senden (z. B. U000001, U000002, U000003).

Pfadparameter

Parameter abfragen

Beispiel anfordern

PUT https://sellingpartnerapi-na.amazon.com/fba/inbound/v0/shipments/345453/labels?PageType=PackageLabel_Letter_2&LabelType=DEFAULT

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "payload": {
    "DownloadURL": "http://bill-of.lading.url.com"
  }
}

Schritt 11: Sendungen an das Amazon-Versandnetzwerk senden

Senden Sie Ihre Sendungen mithilfe eines Amazon-Versandpartners oder eines bei Amazon registrierten Transporteurs, der nicht zu Amazon-Versandpartnern gehört, an das Versandnetzwerk von Amazon. Weitere Informationen zum Senden von Sendungen an das Amazon-Versandnetzwerk finden Sie in der Hilfe in Seller Central für deinen Marktplatz.

Während Sie Ihre Sendung vorbereiten, können Sie alle Informationen auf Kartonebene abrufen, die Sie für einen Wareneingangsplan eingegeben haben, mithilfe der listInboundPlanBoxes Betrieb.

Pfadparameter

Parameter abfragen

Beispiel anfordern

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/boxes

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "pagination": {
    "nextToken": "string"
  },
  "boxes": [
    {
      "packageId": "string",
      "weight": {
        "unit": "LB",
        "value": 0
      },
      "dimensions": {
        "unitOfMeasurement": "IN",
        "length": 0,
        "width": 0,
        "height": 0
      },
      "quantity": 0,
      "boxId": "string",
      "templateName": "string",
      "items": [
        {
          "msku": "string",
          "asin": "string",
          "fnsku": "string",
          "labelOwner": "AMAZON",
          "quantity": 1,
          "expiration": "string",
          "manufacturingLotCode": "string",
          "prepInstructions": [
            {
              "prepType": "string",
              "prepOwner": "AMAZON",
              "fee": {
                "code": "string",
                "amount": 0
              }
            }
          ]
        }
      ],
      "shipmentId": "string",
    }
  ]
}

Schritt 12. Bereitstellung von Tracking-Informationen

Nach dem Versand einer Sendung an das Amazon-Versandnetzwerk mithilfe eines Transporteurs, der keinen Transportpartner hat, muss ein Verkäufer die Sendungsverfolgungsnummer unter Verwendung der updateShipmentTrackingDetails Betrieb. Um diesen Vorgang aufzurufen, muss ein Verkäufer die Sendungsnummer und die Sendungsverfolgungsdetails für seine Sendung mit weniger als einem LKW oder einem kleinen Paket angeben. Für Sendungen, die weniger als LKW-Ladungen umfassen, muss der Verkäufer eine PRO-Nummer (auch als Frachtbriefnummer bezeichnet) angeben und kann optional eine BOL-Nummer angeben. Bei Sendungen mit kleinen Paketen muss der Verkäufer eine Reihe von Karton-IDs und zugehörigen Sendungsverfolgungsnummern angeben.

Pfadparameter

Textparameter

Beispiel anfordern

PUT /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/trackingDetails
{
  "trackingDetails": {
    "ltlTrackingDetail": {
      "freightBillNumber": [
        "string"
      ],
      "billOfLadingNumber": "string"
    },
    "spdTrackingDetail": {
      "spdTrackingItems": [
        {
          "boxId": "string",
          "trackingId": "string"
        }
      ]
    }
  }
}

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operationId": "string"
}

Tutorial: Eine Sendung erstellen, wenn der Verkäufer die Informationen zum Kartonfüllstand nicht im Voraus kennt

Schritt 1. Erstellen Sie einen Plan für eingehende Lieferungen

📘

Hinweis

Das Verfahren zum Erstellen einer Sendung, wenn die Informationen auf Kartonebene nicht im Voraus bekannt sind, ist nur für LTL-Sendungen verfügbar.

Erstellen Sie einen Inbound-Plan, indem Sie den asynchronen Plan aufrufen createInboundPlan Betrieb. Ein Eingangstarif stellt eine Sammlung eingehender Sendungen dar, die Artikel enthalten, die Sie in das Amazon-Versandnetzwerk einsenden möchten. Indem Sie den anrufen createInboundPlan Betrieb, ein Verkäufer muss angeben:

• Die Adresse, von der die eingehenden Sendungen gesendet werden
• Der Marktplatz, auf den das Produkt versendet werden soll
• Kontaktinformationen (erforderlich für Transportpartner für LTL-Sendungen)
• Eine Zusammenfassung der Artikel, die sie einsenden möchten

Die Artikelübersicht muss MSKU, Menge und einen Hinweis darauf enthalten, wer den Artikel vorbereitet/etikettiert. Beachten Sie, dass AMAZON_LABEL ist nur verfügbar, wenn Sie beim FBA Label Service registriert sind. Weitere Informationen zum FBA Label Service finden Sie in der Seller Central-Hilfe für Ihre Marketplace-Site.

Stellen Sie sicher, dass jeder Artikel, den Sie versenden, den Produktverpackungsanforderungen von Amazon entspricht. Weitere Informationen finden Sie unter Anforderungen an Verpackung und Vorbereitung in der Seller Central-Hilfe. Weitere Informationen zu den Anforderungen von Amazon an Produktverpackungen für Ihre Marketplace-Site finden Sie unter URLs von Seller Central. Sie können die Vorbereitungskategorie für SKUs einrichten An Amazon senden Schritt 1. Sie können dies einzeln oder bis zu 25 gleichzeitig tun. Dies ist eine einmalige Aktivität pro SKU, die auf alle zukünftigen Inbound-Pläne übertragen wird.

📘

Hinweis

Mehrere Ablaufdaten pro SKU in einem einzigen Inbound-Tarif werden nicht unterstützt. Um eine SKU mit mehreren Ablaufdaten an das Versandnetzwerk zu senden, müssen Sie mehrere Pläne erstellen.

Optional kann ein Verkäufer das Verfallsdatum und den Herstellloscode jedes Artikels angeben. Eine erfolgreiche Antwort beinhaltet eine inboundPlanId, das ist eine eindeutige Kennung für den Tarif für eingehende Lieferungen, ein Synonym für das Konzept der „Workflow-ID“, die auf Send to Amazon (dem Workflow zur Sendungserstellung in Seller Central) generiert wird.

📘

Hinweis

createInboundPlan generiert die ersten Sendungsnummern für die Sendungen innerhalb jedes Eingangsplans. Diese IDs unterscheiden sich von den shipmentConfirmationIDs die mit dem generiert werden confirmPlacementOption Betrieb. Das shipmentConfirmationID ist der Bezeichner, der auf Beschriftungen erscheint (zum Beispiel FBA1234ABCD). Beide Arten von Sendungsnummern können mit dem abgerufen werden getShipment Betrieb.

Textparameter

Beispiel anfordern

POST /inbound/fba/2024-03-20/inboundPlans
{
  "contactInformation" : {
    "email" : "email@email.com",
    "name" : "name",
    "phoneNumber" : "1234567890"
  },
  "destinationMarketplaces" : [ "ATVPDKIKX0DER" ],
  "items" : [ {
    "expiration" : "2024-01-01",
    "labelOwner" : "AMAZON",
    "manufacturingLotCode" : "manufacturingLotCode",
    "msku" : "Sunglasses",
    "prepOwner" : "AMAZON",
    "quantity" : 10
  } ],
  "name" : "My inbound plan",
  "sourceAddress" : {
    "addressLine1" : "123 example street",
    "addressLine2" : "Floor 19",
    "city" : "Toronto",
    "companyName" : "Acme",
    "countryCode" : "CA",
    "email" : "email@email.com",
    "name" : "name",
    "phoneNumber" : "1234567890",
    "postalCode" : "M1M1M1",
    "stateOrProvinceCode" : "ON"
  }
}

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operationId": "operationID1234",
  "inboundPlanId": "PlanID1234"
}

Überprüfen Sie den Status eines Anrufs

Überprüfen Sie den Status einer eingehenden Anfrage mit dem getInboundOperationStatus Betrieb. Bei asynchronen Vorgängen liefert dieser Vorgang den Verarbeitungsstatus. Wir lassen diesen Schritt für andere asynchrone Operationen in diesem Tutorial aus. Indem du anrufst getInboundOperationStatus, ein Verkäufer übergibt die operationId, was ein Universal Unique Identifier (UUID) für den Vorgang ist. Eine erfolgreiche Antwort umfasst den Anforderungsstatus und kann eine Liste der mit der Anfrage verbundenen Fehler enthalten.

Pfadparameter

Beispiel anfordern

GET /inbound/fba/2024-03-20/operations/{operationId}

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operation": "string",
  "operationId": "string",
  "operationProblems": [
    {
      "code": "Error code 1234",
      "message": "Box volume does not meet the expected minimum cubic cm 144,815",
      "details": "Additional error details",
      "severity": "WARNING"
    }
  ],
  "status": "SUCCESS",
}

Schritt 2. Generieren Sie Optionen für Ziel-Versandzentren und zeigen Sie sie an

Generieren Sie Platzierungsoptionen für einen Inbound-Tarif und lassen Sie sich diese anzeigen, indem Sie den generatePlacementOptions, listPlacementOptions, und getShipment Operationen.

❗

Warnung

Verkäufer können keine Verpackungsinformationen über „An Amazon senden“ bereitstellen, nachdem sie die Platzierungsoptionen bestätigt haben. In diesem Schritt können sie auf Send to Amazon nicht auf von der API erstellte Sendungen zugreifen.

Das placementOptions object steht für die verfügbaren Platzierungsoptionen für einen Tarif für eingehende Lieferungen, wobei jede Platzierungsoption die Ziel-FCs und Versandoptionen für jeden Artikel in Ihrem Eingangstarif beschreibt. Diese Optionen sollen dazu beitragen, die Zeit zu verkürzen, die benötigt wird, um die Artikel eines Verkäufers zu erhalten und zum Verkauf anzubieten (siehe Hilfe in Seller Central für weitere Details).

Einige Ihrer Optionen können mehrere Ziele beinhalten (siehe Hilfe in Seller Central für Details). Jede Option kann Gebühren oder Rabatte beinhalten, die bei der Erstellung Ihrer Sendung mithilfe eines Algorithmus festgelegt werden und nicht anhand eines festgelegten Tarifs berechnet werden. Der Algorithmus für den Rabattwert und die Lieferadresse verwendet mehrere Faktoren, um Ihre Sendungen zu optimieren, darunter das erwartete Volumen, die Verfügbarkeit von Transporteurterminen und die Versandgeschwindigkeit. Der Rabatt, für den Ihre Sendung in Frage kommt, wird bei der Sendungserstellung gewährt.

Die Allgemeinen Geschäftsbedingungen können sich ändern. Lesen Sie die aktuellen Allgemeinen Geschäftsbedingungen von Seller Central, einschließlich der Vereinbarung über Amazon Services Business Solutions.

📘

Hinweis

Wenn ein Verkäufer anruft generatePlacementOptions Ohne Eingabe von Informationen zum Kartoninhalt bietet Amazon Platzierungsoptionen, die für Daten auf Einheitenebene optimiert sind (da Amazon noch keine Kartondaten hat). Diese Optionen können sich von den Platzierungsoptionen unterscheiden, die generiert werden, nachdem ein Verkäufer Informationen zum Kartoninhalt bereitgestellt hat (mithilfe setPackingInformation).

Pfadparameter

Textparameter

Beispiel anfordern

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/placementOptions
{
}

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operationId": "string"
}

Sehen Sie sich die Optionen für Sendungsaufteilungen an, indem Sie den listPlacementOptions Betrieb. Dieser Vorgang liefert die Liste der verfügbaren Platzierungsoptionen, darunter:

• Eine Platzierungsoptions-ID
• Der Optionsstatus („angeboten“ oder „akzeptiert“)
• Alle mit dieser Option verbundenen Gebühren/Rabatte
• Das Ablaufdatum der Option
• Die Sendungsnummern, die jeder Option zugeordnet sind

Wenn eine Platzierungsoption abläuft, müssen Sie die Platzierungsoptionen neu generieren, indem Sie generatePlacementOption. Die ID der Platzierungsoption ist erforderlich, um Transportoptionen mit zu generieren generateTransportationOptions, während Sendungsnummern verwendet werden, um den Inhalt jeder Sendung zu verstehen, indem getShipment (siehe das Folgende).

Pfadparameter

Parameter abfragen

Beispiel anfordern

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/placementOptions

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "pagination": {
    "nextToken": "string"
  },
  "placementOptions": [
    {
      "inboundPlanId": "string",
      "placementOptionId": "string",
      "status": "OFFERED",
      "fees": [
        {
          "currency": {
            "code": "string",
            "amount": 0
          },
          "type": "FEE",
          "target": "OUTBOUND_PER_SHIPMENT",
          "description": "string"
        }
      ],
      "discounts": [
        {
          "currency": {
            "code": "string",
            "amount": 0
          },
          "type": "FEE",
          "target": "OUTBOUND_PER_SHIPMENT",
          "description": "string"
        }
      ],
      "expiration": "2019-08-24T14:15:22Z",
      "shipmentIds": [
        "string"
      ]
    }
  ]
}

Überprüfen Sie die Details zum Inhalt einer Sendung innerhalb eines Eingangsplans mithilfe der getShipment Betrieb. Um anzurufen getShipment, ein Verkäufer muss die ID für den eingehenden Tarif und die Sendungsnummer weitergeben. Eine erfolgreiche Antwort umfasst die ID der Platzierungsoption, die Nummer der bestätigten Sendung (d. h. die ID, die auf den Etiketten angezeigt wird und im Anschluss erstellt wurde) confirmPlacementOption), Sendungsnummer (das ist die Kennung für eine Sendung vor dem confirmPlacementOption Betrieb), Amazon-Referenz-ID (Kennung für die Terminvereinbarung im Versandzentrum für Lkw-Lieferungen), ID der ausgewählten Transportoption, Name, Quelle, Bestimmungsort, Versanddatum, voraussichtliches Lieferdatum, Status, Sendungsverfolgungsdetails, Paletteninformationen, Kontaktinformationen, Zielregion und FC-Termindetails.

Pfadparameter

Beispiel anfordern

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "inboundPlanId": "string",
  "placementOptionId": "string",
  "shipmentId": "string",
  "shipmentConfirmationId": "string",
  "amazonReferenceId": "string",
  "selectedTransportationOptionId": "string",
  "name": "string",
  "source": {
    "sourceType": "SELLER_FACILITY",
    "address": {
      "name": "string",
      "companyName": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "countryCode": "st",
      "stateOrProvinceCode": "string",
      "postalCode": "string"
    }
  },
  "destination": {
    "destinationType": "AMAZON_OPTIMIZED",
    "address": {
      "name": "string",
      "companyName": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "countryCode": "st",
      "stateOrProvinceCode": "string",
      "postalCode": "string"
    },
    "warehouseId": "string"
  },
  "dates": {
    "readyToShipWindow": {
      "start": "2019-08-24T14:15:22Z",
      "end": "2019-08-24T14:15:22Z",
      "editableUntil": "2019-08-24T14:15:22Z"
    },
    "deliveryWindow": {
      "start": "2019-08-24T14:15:22Z",
      "end": "2019-08-24T14:15:22Z",
      "editableUntil": "2019-08-24T14:15:22Z"
    }
  },
  "status": "ABANDONED",
  "trackingDetails": {
    "ltlTrackingDetail": {
      "freightBillNumber": [
        "string"
      ],
      "billOfLadingNumber": "string"
    }
  },
  "palletInformation": {
    "pallets": [
      {
        "weight": {
          "unit": "LB",
          "value": 0
        },
        "dimensions": {
          "unitOfMeasurement": "IN",
          "length": 0,
          "width": 0,
          "height": 0
        },
        "quantity": 1,
        "stackable": true
      }
    ],
    "freightClass": "NONE",
    "declaredValue": {
      "code": "string",
      "amount": 0
    }
  },
  "contactInformation": {
    "phoneNumber": "string",
    "email": "string",
    "name": "string"
  },
  "selfShipAppointmentDetails": [
    {
      "appointmentId": 0,
      "appointmentSlotTime": {
        "startTime": "2019-08-24T14:15:22Z",
        "endTime": "2019-08-24T14:15:22Z"
      },
      "appointmentStatus": "string"
    }
  ]
}

Schritt 3. Wählen Sie die Versandoption

Wählen Sie Versandoptionen mit dem confirmPlacementOption Betrieb. Bei diesem Vorgang wird die Platzierungsoption für einen Eingangsplan ausgewählt und bestätigte Sendungsnummern für Sendungen innerhalb des Eingangsplans erstellt. Der shipmentConfirmationID ist die Sendungskennzeichnung, die auf den Etiketten erscheint (z. B. FBA1234ABCD). Diese ID unterscheidet sich von der ursprünglichen Sendungsnummer, die von generiert wurde createInboundPlan. Diese Option kann nicht rückgängig gemacht werden, nachdem sie ausgewählt wurde. Um anzurufen confirmPlacementOption, ein Verkäufer muss die ID für den eingehenden Tarif und die ID der ausgewählten Platzierungsoption weitergeben.

📘

Hinweis

Angebote werden nur für Transportoptionen zurückgegeben, die mit PCP-Sendungen verbunden sind. Verfallsdatum und Gültigkeitszeitraum werden nur für Transportoptionen zurückgegeben, die bestätigt wurden mit confirmTransportationOptions.

Pfadparameter

Beispiel anfordern

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/placementOptions/{placementOptionId}/confirmation

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operationId": "string"
}

Schritt 4. Geben Sie Informationen zum Kartoninhalt an

❗️

Warnung

Dies ist ein obligatorischer Schritt. Wenn du nicht anrufst setPackingInformation, es kann zu Fehlern im Empfangsprozess und zu Gebühren für die manuelle Bearbeitung kommen. Weitere Informationen finden Sie unter Gebühr für die manuelle FBA-Bearbeitung.

📘

Hinweis

Sie müssen wissen, welche Artikel zu jeder Sendung gehören, bevor Sie anrufen setPackingInformation. Sie können diese Informationen auf STA und über die API abrufen. Wenn Sie falsche Informationen angeben, erhalten Sie eine Fehlermeldung mit den erwarteten Mengen. Sie können diese Informationen für Ihre Sendung auch auf An Amazon senden abrufen.

Geben Sie Informationen darüber an, welche Artikel in die einzelnen Kartons verpackt werden, indem Sie das setPackingInformation Betrieb. Indem du anrufst setPackingInformation, muss ein Verkäufer die folgenden Informationen für Kartons angeben, die er versenden möchte:

• Die Paketgruppierungs-ID (d. h. die Sendungsnummer der bestätigten Platzierungsoption) jeder Sendung
• Informationsquelle für den Kartoninhalt
• Lieferumfang (Artikel, Artikelmengen, Besitzer der Vorbereitung/des Etiketts für jeden Artikel)
• Kartoninformationen (Abmessungen, Gewicht und Anzahl der Kartons)

Eine erfolgreiche Antwort beinhaltet die operationId das kann verwendet werden, um den Status der Operation zu ermitteln mit getInboundOperationStatus.

⭐

Tipp

Schließen Sie in diesem Ablauf Folgendes ein ShipmentId und weglassen PackingGroupId.

Pfadparameter

Textparameter

Beispiel anfordern

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/packingInformation
{
  "packageGroupings": [
    {
      "shipmentId": "string",
      "boxes": [
        {
          "weight": {
            "unit": "LB",
            "value": 0
          },
          "dimensions": {
            "unitOfMeasurement": "IN",
            "length": 0,
            "width": 0,
            "height": 0
          },
          "quantity": 1,
          "boxId": "string",
          "items": [
            {
              "msku": "string",
              "quantity": 1,
              "expiration": "string",
              "prepOwner": "AMAZON",
              "labelOwner": "AMAZON",
              "manufacturingLotCode": "string"
            }
          ],
          "contentInformationSource": "BOX_CONTENT_PROVIDED"
        }
      ]
    }
  ]
}

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operationId": "string",
}

Versandartikel auflisten

Rufen Sie die Seite an, um eine paginierte Liste der Artikel in einer Sendung anzuzeigen listShipmentItems Betrieb. Verkäufer müssen diese Informationen abrufen, um zu verstehen, welche Artikel in jeder Versandaufteilung enthalten sind, wenn sie die Informationen zum Kartonfüllstand nicht im Voraus eingegeben haben. Um diese API aufrufen zu können, muss ein Verkäufer die Sendungsnummer weitergeben. Eine erfolgreiche Antwort enthält eine paginierte Liste der Produkte, die der Benutzer zuvor mit der createInboundPlan Betrieb. Die Antwort enthält die Vorbereitungsanweisungen für ihre ASINs, z. B. den Vorbereitungstyp und den Besitzer. Auf diese Weise können Benutzer bequem überprüfen, welche Artikel und Vorbereitungsanforderungen in einer bestimmten Sendung enthalten sind. In der Antwort sind MSKU, ASIN, FNSKU, Herstellercode, Menge und bei Bedarf das Verfallsdatum des Produkts aufgeführt. Dies kann verwendet werden, um eine Auswahlliste zu erstellen, mit der sie bestimmte Artikel aus ihrem Inventar entnehmen und zu einer Sendung zusammenfassen können. Der Verkäufer verwendet dann die listShipmentBoxes Vorgang zum Erstellen einer Packliste, die angibt, welche Artikel in welche Boxen passen.

Pfadparameter

Parameter abfragen

Beispiel anfordern

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/items

Antwort

Beispiel für eine Antwort

{
  "pagination": {
    "nextToken": "string"
  },
  "items": [
    {
      "msku": "string",
      "asin": "string",
      "fnsku": "string",
      "labelOwner": "string",
      "quantity": 1,
      "expiration": "string",
      "manufacturingLotCode": "string",
      "prepInstructions": [
        {
          "prepType": "string",
          "prepOwner": "string",
          "fee": {
            "code": "str",
            "amount": 0
          }
        }
      ]
    }
  ]
}

Schritt 5. Geben Sie Transportdaten ein, generieren Sie Transportoptionen und zeigen Sie Optionen an

Generieren Sie Transportmöglichkeiten mit dem generateTransportationOptions Betrieb. Eine Transportoption stellt die Liste der verfügbaren Versandarten und Transporteuroptionen dar, die für jede Sendung innerhalb der einzelnen Platzierungsoptionen verfügbar sind. Indem Sie anrufen generateTransportationOptions, ein Verkäufer muss die folgenden Informationen weitergeben:

• ID der Platzierungsoption
• Sendungsnummer
• Voraussichtlicher Liefertermin
• Absenderadresse und optional
• Informationen zur Palette. Wenn keine Paletteninformationen enthalten sind, werden LTL-Transportoptionen nicht generiert.

Pfadparameter

Textparameter

Beispiel anfordern

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/transportationOptions
{
  "body": {
    "placementOptionId": "pl1234abcd-1234-abcd-5678-1234abcd5678",
    "shipmentTransportationConfigurations": [
      {
        "contactInformation": {
          "email": "email@email.com",
          "name": "John Smithy",
          "phoneNumber": "1234567890"
        },
        "freightInformation": {
          "declaredValue": {
            "amount": 5.5,
            "code": "CAD"
          },
          "freightClass": "FC_50"
        },
        "pallets": [
          {
            "dimensions": {
              "height": 5,
              "length": 3,
              "unitOfMeasurement": "CM",
              "width": 4
            },
            "quantity": 2,
            "stackability": "STACKABLE",
            "weight": {
              "unit": "KG",
              "value": 5.5
            }
          }
        ],
        "readyToShipWindow": {
          "start": "2024-01-01T00:00Z"
        },
        "shipmentId": "sh1234abcd-1234-abcd-5678-1234abcd5678"
      }
    ]
  }
}

Antwort

Beispiel für eine Antwort

{
  "operationId": "string"
}

Überprüfen Sie die Versand- und Transportoptionen, indem Sie die listTransportationOptions, listDeliveryWindowOptions, und getShipment Operationen.

Um anzurufen listTransportationOptions, ein Verkäufer muss die ID der Platzierungsoption und die Sendungsnummer angeben, für die er die Transportoptionen anzeigen möchte. Eine erfolgreiche Antwort beinhaltet alle verfügbaren Transportangebote für alle verfügbaren Versandarten und Transporteuroptionen. Zu den Versandarten gehören:

• Gemahlenes kleines Paket
• Fracht mit weniger als LKW-Ladungen
• Volle LKW-Ladungsfracht (palettiert)
• Volle LKW-Ladungsfracht (nicht palettiert)
• Weniger als eine Containerladung auf dem Meer
• Volle Containerladung Meer
• Kleines Paket in der Luft
• Air Small Parcel Express

Zu den Transporteuroptionen gehören mit Amazon zusammenarbeitende und nicht mit Amazon zusammenarbeitende Transporteure. Angebote beinhalten die Kosten, ein Zeitfenster für die Nichtigkeit (z. B. die Dauer, in der ein Verkäufer eine Sendung stornieren und eine Rückerstattung für sein Transportangebot erhalten kann) und das Ablaufdatum für jedes Angebot. In Regionen, in denen Termine im Versandzentrum verpflichtend sind (z. B. Indien), stellen wir verfügbare Termine zur Verfügung.

Wo das Transportpartnerprogramm (PCP) verfügbar ist, können Verkäufer von ermäßigten Tarifen profitieren, indem sie für ihre eingehenden Sendungen einen Amazon-Transporteur beauftragen.

Um einen Amazon-Versandpartner für eine eingehende Sendung zu verwenden, wählen Sie die Transportoption aus shippingSolution ist AMAZON_PARTNERED_CARRIER.

📘

Hinweis

Bevor Sie einen Amazon-Transportpartner für eine eingehende Sendung verwenden, müssen Sie die Seller Central-Hilfe zum Transporteurpartnerprogramm von Amazon lesen, um sicherzustellen, dass Sie die Anweisungen und Richtlinien des Programms erfolgreich befolgen (Europa) (UNS).

Bevor Sie in der EU-Region einen Amazon-Transportpartner für eine eingehende Sendung verwenden, müssen Sie zunächst die Allgemeinen Geschäftsbedingungen des Transporteurs und die Allgemeinen Geschäftsbedingungen des Transportpartnerprogramms von Amazon überprüfen und akzeptieren. Sie können dies in Seller Central tun. Wenn Sie versuchen, mithilfe der Amazon-Verkaufspartner-APIs eine eingehende Sendung mit einem Amazon-Transportpartner zu erstellen, bevor Sie diese Allgemeinen Geschäftsbedingungen akzeptieren, gibt der Dienst einen Fehler zurück.

Wenn ein Verkäufer nicht am PCP teilnehmen möchte, kann er Folgendes einsehen Choose your own carrier Transportoptionen und verfügbare Versandarten.

Pfadparameter

Parameter abfragen

Beispiel anfordern

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/transportationOptions

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "pagination": {
    "nextToken": "string"
  },
  "transportationOptions": [
    {
      "inboundPlanId": "string",
      "placementOptionId": "string",
      "shipmentId": "string",
      "transportationOptionId": "string",
      "shippingSolution": "string",
      "carrier": {
        "name": "string",
        "alphaCode": "string"
      },
      "shippingMode": "string",
      "quote": {
        "cost": {
          "code": "str",
          "amount": 0
        },
        "voidableUntil": "2019-08-24T14:15:22Z",
        "expiration": "2019-08-24T14:15:22Z"
      },
      "carrierAppointment": {
        "startTime": "2019-08-24T14:15:22Z",
        "endTime": "2019-08-24T14:15:22Z"
      },
      "programs": [
        "string"
      ]
    }
  ]
}

Prüfen Sie die verfügbaren Lieferfensteroptionen für jede Sendung innerhalb eines Eingangsplans mithilfe der listDeliveryWindowOptions Betrieb. Um diesen Anruf zu tätigen, muss ein Verkäufer die shipmentID. Eine erfolgreiche Antwort liefert die startDate und endDate für jedes verfügbare Lieferfenster und den Grad der Überlastung (availabilityType) für jede Option. Beachten Sie, dass jede Option ein Ablaufdatum hat (validUntil). Sie müssen die Lieferung vor diesem Datum bestätigen. Wenn Sie das Fenster nicht bestätigen, indem Sie validUntil Datum, Sie müssen ein neues Fenster generieren mit listDeliveryWindowOptions.

Pfadparameter

Parameter abfragen

Beispiel anfordern

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/deliveryWindowOptions

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "pagination": {
    "nextToken": "string"
  },
  "deliveryWindowOptions": [
    {
      "inboundPlanId": "string",
      "placementOptionId": "string",
      "shipmentId": "string",
      "deliveryWindowOptionId": "string",
      "startDate": "2019-08-24T14:15:22Z",
      "endDate": "2019-08-24T14:15:22Z",
      "availabilityType": "string",
      "validUntil": "2019-08-24T14:15:22Z"
    }
  ]
}

Prüfen Sie die Details zum Inhalt einer Sendung innerhalb eines Eingangsplans mithilfe der getShipment Betrieb. Um anzurufen getShipment, ein Verkäufer muss die ID für den eingehenden Tarif und die Sendungsnummer weitergeben. Eine erfolgreiche Antwort beinhaltet:

• ID der Platzierungsoption
• Versandbestätigte ID (d. h. die ID, die auf den Etiketten angezeigt wird)
• Sendungsnummer (d. h. Kennung für eine Sendung vor dem confirmPlacementOption Betrieb)
• Amazon-Referenz-ID (Kennung für die Planung von Terminen im Versandzentrum für Lkw-Lieferungen)
• ID der ausgewählten Transportoption
• Name
• Quelle
• Reiseziel FC
• Datum des Versands
• Voraussichtlicher Liefertermin
• Status
• Einzelheiten zur Nachverfolgung
• Informationen zur Palette
• Kontaktinformationen
• Zielregion
• Einzelheiten zum FC-Termin

Pfadparameter

Beispiel anfordern

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "inboundPlanId": "string",
  "placementOptionId": "string",
  "shipmentId": "string",
  "shipmentConfirmationId": "string",
  "amazonReferenceId": "string",
  "selectedTransportationOptionId": "string",
  "name": "string",
  "source": {
    "sourceType": "SELLER_FACILITY",
    "address": {
      "name": "string",
      "companyName": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "countryCode": "st",
      "stateOrProvinceCode": "string",
      "postalCode": "string"
    }
  },
  "destination": {
    "destinationType": "AMAZON_OPTIMIZED",
    "address": {
      "name": "string",
      "companyName": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "countryCode": "st",
      "stateOrProvinceCode": "string",
      "postalCode": "string"
    },
    "warehouseId": "string"
  },
  "dates": {
    "readyToShipWindow": {
      "start": "2019-08-24T14:15:22Z",
      "end": "2019-08-24T14:15:22Z",
      "editableUntil": "2019-08-24T14:15:22Z"
    },
    "deliveryWindow": {
      "start": "2019-08-24T14:15:22Z",
      "end": "2019-08-24T14:15:22Z",
      "editableUntil": "2019-08-24T14:15:22Z"
    }
  },
  "status": "ABANDONED",
  "trackingDetails": {
    "ltlTrackingDetail": {
      "freightBillNumber": [
        "string"
      ],
      "billOfLadingNumber": "string"
    }
  },
  "palletInformation": {
    "pallets": [
      {
        "weight": {
          "unit": "LB",
          "value": 0
        },
        "dimensions": {
          "unitOfMeasurement": "IN",
          "length": 0,
          "width": 0,
          "height": 0
        },
        "quantity": 1,
        "stackable": true
      }
    ],
    "freightClass": "NONE",
    "declaredValue": {
      "code": "string",
      "amount": 0
    }
  },
  "contactInformation": {
    "phoneNumber": "string",
    "email": "string",
    "name": "string"
  },
  "selfShipAppointmentDetails": [
    {
      "appointmentId": 0,
      "appointmentSlotTime": {
        "startTime": "2019-08-24T14:15:22Z",
        "endTime": "2019-08-24T14:15:22Z"
      },
      "appointmentStatus": "string"
    }
  ]
}

Schritt 6. Wählen Sie die Transportoptionen

❗️

Warnung

Bei Lieferungen ohne Transportpartner müssen Verkäufer ihr voraussichtliches Lieferfenster telefonisch bestätigen confirmTransportationOptions bevor sie ihren Termin im Versandzentrum (FC) buchen.

Verkäufer sollten ihren Transporteur, der keinen Transportpartner hat, bitten, einen FC-Termin zu vereinbaren, der innerhalb des voraussichtlichen Lieferfensters liegt. Wenn der FC-Termin nicht innerhalb des Lieferfensters liegt, kann der Verkäufer anrufen confirmDeliveryWindow um ein anderes Lieferfenster auszuwählen, das ihren FC-Termin enthält.

Wählen Sie die Transportoptionen für jede Sendung innerhalb eines Eingangsplans mithilfe der confirmTransportationOptions Betrieb. Bei Transportoptionen mit einem Amazon-Partner bestätigt dieser Vorgang, dass der Verkäufer den Kostenvoranschlag des Amazon-Versandpartners akzeptiert, sich damit einverstanden erklärt, dass Amazon die Versandkosten von seinem Konto abbucht, und verlangt, dass der Amazon-Versandpartner die eingehende Sendung versendet. Vor diesem Anruf muss ein Verkäufer eine Platzierungsoption für seinen Tarif für eingehende Lieferungen bestätigt haben. Um anzurufen confirmTransportationOptions, muss ein Verkäufer die Sendungsnummer, die ID der ausgewählten Transportoption, die Kontaktinformationen (für Transportpartner für LTL-Sendungen erforderlich) und den voraussichtlichen Liefertermin angeben. Das voraussichtliche Lieferdatum (Lieferfenster) ist eine Voraussetzung für Optionen ohne Transportpartner und sollte für Optionen mit Transportpartnern nicht angegeben werden. Nachdem eine Transportoption bestätigt wurde, können keine neuen Transportoptionen für einen Paket für eingehende Lieferungen generiert oder bestätigt werden.

📘

Hinweis

Wenn ein Verkäufer die Transportanfrage bestätigt und dann entscheidet, dass er nicht möchte, dass der Amazon-Transporteur die eingehende Sendung versendet, kann er cancelInboundPlan um die Transportanfrage zu stornieren. Bei Small Parcel-Sendungen hat der Verkäufer nach Bestätigung einer Transportanfrage 24 Stunden Zeit, um die Anfrage zu stornieren. Bei Sendungen mit weniger als Truckload/Full Truckload (LTL/FTL) hat der Verkäufer nach Bestätigung einer Transportanfrage eine Stunde Zeit, um die Anfrage zu stornieren. Nach Ablauf der entsprechenden Frist werden die Versandkosten dem Konto des Verkäufers in Rechnung gestellt.

Pfadparameter

Textparameter

Beispiel anfordern

POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/transportationOptions/confirmation
{
  "transportationSelections" : [ {
    "contactInformation" : {
      "email" : "email@email.com",
      "name" : "John Smithy",
      "phoneNumber" : "1234567890"
    },
    "deliveryWindow" : {
      "start" : "2024-01-01T00:00Z"
    },
    "shipmentId" : "sh1234abcd-1234-abcd-5678-1234abcd5678",
    "transportationOptionId" : "to1234abcd-1234-abcd-5678-1234abcd5678"
  } ]
}

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operationId": "string"
}

Schritt 7. Etiketten drucken

Rufen Sie den getLabels Vorgang, um individuelle Versandetiketten für Ihre eingehenden Sendungen anzufordern. Jedes von der zurückgesandte Versandetikett getLabels Das entsprechende Etikett sollte auf dem Paket in der Sendung angebracht werden, sodass auf den Etiketten der Inhalt des Pakets angegeben ist. Auf diese Weise können Sie sicherstellen, dass Ihre Sendung im Amazon-Versandzentrum schnell und korrekt bearbeitet wird.

❗️

Warnung

Der Wert von shipmentId in der getLabels Anfrage muss die sein shipmentId (ab v0) oder shipmentConfirmationId (von v2024-03-20). Benutze nicht den shipmentId von v2024-03-20.

Um Etiketten für einen bestimmten Karton zu drucken, geben Sie die boxID (aus dem listShipmentBoxes Antwort) als PackageLabelsToPrint Wert.

Beachten Sie, dass der Versandstatus nicht ready_to_ship wenn Sie Kartonetiketten abrufen mit getLabels. Damit ein Sendungsstatus wie folgt ready_to_ship, Sie müssen Labels auf Send to Amazon generieren.

Informationen auf Versandetiketten

In jedem Fall gibt der getLabels-Vorgang Versandetiketten zurück, die einen eindeutigen Barcode und eine Paket-ID enthalten (die Zeichenkette direkt unterhalb des Barcodes). Abhängig vom Inhalt der Pakete in Ihren Sendungen können die Etiketten auch eine ASIN und ein Ablaufdatum enthalten.

Versandetiketten enthalten bei folgenden Situationen eine ASIN und ein Verfallsdatum:

• Jeder Artikel in der Lieferung hat dieselbe ASIN und dasselbe Verfallsdatum.
• Die Sendung enthält mehrere ASINs, aber jedes Paket in der Sendung enthält Artikel, die dieselbe ASIN und dasselbe Verfallsdatum haben.

Versandetiketten enthalten bei folgenden Situationen eine ASIN und kein Verfallsdatum:

• Jeder Artikel in der Lieferung hat dieselbe ASIN. Die ASIN hat kein Verfallsdatum.
• Die Sendung enthält mehrere ASINs, aber jedes Paket in der Sendung enthält Artikel, die dieselbe ASIN haben. Die ASINs haben kein Verfallsdatum.

Versandetiketten enthalten keine ASIN oder kein Verfallsdatum, wenn die Sendung mindestens ein Paket mit Artikeln enthält, die nicht dieselbe ASIN und dasselbe Verfallsdatum haben.

📘

Konstruieren Sie einen einzigartigen Barcode für kleine Paketsendungen

Bei Sendungen mit kleinen Paketen sollte das Versandetikett für jedes Paket einen eindeutigen Barcode haben. Dadurch wird sichergestellt, dass Ihre Sendung zeitnah bearbeitet wird, wenn sie das Amazon-Versandnetzwerk erreicht. Gehen Sie wie folgt vor, um eindeutige Barcode-Werte für jedes Paket in einer Sendung zu erstellen:

1. Beginnen Sie mit dem Wert der Versandnummer und fügen Sie ihn an U und 000001 um den Barcode-Wert für das erste Paket in der Sendung zu erhalten.

2. Um die Barcode-Werte für jedes nachfolgende Paket in der Sendung abzurufen, erhöhen Sie den nachfolgenden numerischen Wert des vorherigen Pakets um eins. Zum Beispiel, wenn Sie drei Pakete in einer Sendung mit einem Sendungsnummer-Wert von haben FBA1MMD8D0, deine drei Barcode-Werte wären FBA1MMD8D0U000001, FBA1MMD8D0U000002, und FBA1MMD8D0U000003. Ein Kartonetikett, das mit einer eigenen eindeutigen numerischen Kennzeichnung gekennzeichnet ist, muss dem sechsstelligen Zahlenformat nach U folgen. Es muss ausgedruckt und an jedem Karton angebracht werden, den Sie an ein Versandzentrum senden (z. B. U000001, U000002, U000003).

Pfadparameter

Parameter abfragen

Beispiel anfordern

PUT https://sellingpartnerapi-na.amazon.com/fba/inbound/v0/shipments/345453/labels?PageType=PackageLabel_Letter_2&LabelType=DEFAULT

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "payload": {
    "DownloadURL": "http://bill-of.lading.url.com"
  }
}

Schritt 11: Sendungen an das Amazon-Versandnetzwerk senden

Senden Sie Ihre Sendungen mithilfe eines Amazon-Versandpartners oder eines bei Amazon registrierten Transporteurs, der nicht zu Amazon-Versandpartnern gehört, an das Versandnetzwerk von Amazon. Weitere Informationen zum Senden von Sendungen an das Amazon-Versandnetzwerk finden Sie in der Hilfe in Seller Central für deinen Marktplatz.

Während Sie Ihre Sendung vorbereiten, können Sie alle Informationen auf Kartonebene abrufen, die Sie für einen Wareneingangsplan eingegeben haben, mithilfe der listInboundPlanBoxes Betrieb.

Pfadparameter

Parameter abfragen

Beispiel anfordern

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/boxes

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "pagination": {
    "nextToken": "string"
  },
  "boxes": [
    {
      "packageId": "string",
      "weight": {
        "unit": "LB",
        "value": 0
      },
      "dimensions": {
        "unitOfMeasurement": "IN",
        "length": 0,
        "width": 0,
        "height": 0
      },
      "quantity": 0,
      "boxId": "string",
      "templateName": "string",
      "items": [
        {
          "msku": "string",
          "asin": "string",
          "fnsku": "string",
          "labelOwner": "AMAZON",
          "quantity": 1,
          "expiration": "string",
          "manufacturingLotCode": "string",
          "prepInstructions": [
            {
              "prepType": "string",
              "prepOwner": "AMAZON",
              "fee": {
                "code": "string",
                "amount": 0
              }
            }
          ]
        }
      ],
      "shipmentId": "string",
    }
  ]
}

Schritt 9. Bereitstellung von Tracking-Informationen

Nach dem Versand einer Sendung an das Amazon-Versandnetzwerk mithilfe eines Transporteurs, der keinen Transportpartner hat, muss ein Verkäufer die Sendungsverfolgungsnummer unter Verwendung der updateShipmentTrackingDetails Betrieb. Um diesen Vorgang aufzurufen, muss ein Verkäufer die Sendungsnummer und die Sendungsverfolgungsdetails für seine Sendung mit weniger als einem LKW oder einem kleinen Paket angeben. Für Sendungen, die weniger als LKW-Ladungen umfassen, muss der Verkäufer eine PRO-Nummer (auch als Frachtbriefnummer bezeichnet) angeben und kann optional eine BOL-Nummer angeben. Bei Sendungen mit kleinen Paketen muss der Verkäufer eine Reihe von Karton-IDs und zugehörigen Sendungsverfolgungsnummern angeben.

Pfadparameter

Textparameter

Beispiel anfordern

PUT /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/trackingDetails
{
  "trackingDetails": {
    "ltlTrackingDetail": {
      "freightBillNumber": [
        "string"
      ],
      "billOfLadingNumber": "string"
    }
  }
}

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operationId": "string"
}

Zusätzliche Funktionen

Die Fulfillment Inbound API v2024-03-20 umfasst auch mehrere Vorgänge, die nicht für jede Sendungserstellung erforderlich sind. In diesem Abschnitt werden diese Vorgänge beschrieben.

Rufen Sie eine Liste der vorhandenen Inbound-Pläne ab

Rufen Sie eine Liste der vorhandenen Pläne für eingehende Lieferungen ab, indem Sie den listInboundPlans Betrieb. Dies kann verwendet werden, um Informationen über eingehende Tarife für mehrere Pakete für eingehende Lieferungen auf der Grundlage der vom Verkäufer angegebenen Kriterien abzurufen. Indem Sie den anrufen listInboundPlans Operation, ein Verkäufer kann nach Bundesland filtern (z. B. ob InboundPlans sind ACTIVE, SHIPPED, oder VOIDED) und bis zum Datum, an dem der Plan für eingehende Lieferungen erstellt oder zuletzt aktualisiert wurde. Der Verkäufer kann auch eine Seitengröße angeben, um die Anzahl der Antworten pro Anfrage zu begrenzen, und bei Bedarf ein Paginierungstoken angeben.

🚧

Wichtig

listInboundPlans ist ein paginierter Anruf. Wenn Sie Folgeanrufe tätigen, um mehr Datenseiten abzurufen, müssen Sie dieselben Filter wie beim ursprünglichen Anruf verwenden, um die richtige Antwort zu erhalten.

Parameter abfragen

Beispiel anfordern

GET /inbound/fba/2024-03-20/inboundPlans

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "pagination": {
    "nextToken": "string"
  },
  "inboundPlans": [
    {
      "inboundPlanId": "string",
      "name": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "lastUpdatedAt": "2019-08-24T14:15:22Z",
      "marketplaceIds": [
        "string"
      ],
      "sourceAddress": {
        "name": "string",
        "companyName": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "city": "string",
        "countryCode": "st",
        "stateOrProvinceCode": "string",
        "postalCode": "string"
      },
      "contactInformation": {
        "phoneNumber": "string",
        "email": "string"
      },
      "status": "ACTIVE",
      "placementOptions": [
        {
          "placementOptionId": "string",
          "status": "OFFERED"
        }
      ],
      "shipments": [
        {
          "shipmentId": "string",
          "status": "ABANDONED"
        }
      ],
      "packingOptions": [
        {
          "packingOptionId": "string",
          "status": "OFFERED"
        }
      ]
    }
  ]
}

Ruft eine Liste von Artikeln in einem Inbound-Tarif ab

Rufen Sie eine Liste der Artikel in einem Inbound-Tarif mit dem listInboundPlanItems Betrieb. Dies kann verwendet werden, um Artikelinformationen für einen eingehenden Versand abzurufen, und kann nach der Gruppierungs-ID des Pakets gefiltert werden (d. h. ShipmentID oder die PackingGroupId, je nachdem ob confirmPlacementOption wurde angerufen). Eine erfolgreiche Antwort umfasst Artikelinformationen wie MSKU, ASIN, FNSKU, Inhaber des Etiketts, Menge, Verfallsdatum, Chargencode, Anweisungen zur Vorbereitung und Verpackungsgruppe.

Pfadparameter

Parameter abfragen

Beispiel anfordern

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/items

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "pagination": {
    "nextToken": "string"
  },
  "items": [
    {
      "msku": "string",
      "asin": "string",
      "fnsku": "string",
      "labelOwner": "AMAZON",
      "quantity": 1,
      "expiration": "string",
      "manufacturingLotCode": "string",
      "prepInstructions": [
        {
          "prepType": "string",
          "prepOwner": "AMAZON",
          "fee": {
            "code": "string",
            "amount": 0
          }
        }
      ],
      "shipmentId": "string",
      "packingOptionId": "string",
      "packingGroupId": "string"
    }
  ]
}

Ruft eine Liste von Paletten ab, die eingehenden Paketen zugeordnet sind

Rufen Sie eine Liste der Paletten innerhalb eines Eingangsplans mit dem listInboundPlanPallets Betrieb. Dies kann verwendet werden, um Paletteninformationen für einen Wareneingangsplan abzurufen, und kann nach der Gruppierungs-ID des Pakets gefiltert werden (d. h. ShipmentID oder die PackingGroupId, je nachdem ob confirmPlacementOption wurde angerufen). Eine erfolgreiche Antwort umfasst die Abmessungen der Palette, das Gewicht, ob die Paletten gestapelt werden können, die Paket-ID, die Palettenmengen und die zugehörigen Sendungsnummern.

Pfadparameter

Parameter abfragen

Beispiel anfordern

GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/pallets

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "pagination": {
    "nextToken": "string"
  },
  "pallets": [
    {
      "packageId": "string",
      "weight": {
        "unit": "LB",
        "value": 0
      },
      "dimensions": {
        "unitOfMeasurement": "IN",
        "length": 0,
        "width": 0,
        "height": 0
      },
      "quantity": 0,
      "stackable": true,
      "shipmentId": "string"
    }
  ]
}

Einen Plan für eingehende Lieferungen stornieren

Stornieren Sie einen Plan für eingehende Sendungen und alle damit verbundenen Sendungen mithilfe der cancelInboundPlan Betrieb. Dadurch werden auch die Gebühren für die vom Verkäufer ausgewählten Transportoptionen storniert, wenn dieser Vorgang innerhalb des Gültigkeitsfensters aufgerufen wird. Das Zeitfenster für die Stornierung ist 24 Stunden, nachdem Sie eine Transportanfrage für eine Sendung mit einem kleinen Paket bestätigt haben, oder eine Stunde, nachdem Sie eine Transportanfrage für eine Sendung mit weniger als LKW/Komplettladung (LTL/FTL) bestätigt haben. Nach Ablauf dieser Frist werden die Versandkosten dem Konto des Verkäufers in Rechnung gestellt. Indem Sie anrufen cancelInboundPlan, ein Verkäufer muss das bestehen inboundPlanId im Zusammenhang mit dem Tarif für eingehende Lieferungen, den sie kündigen möchten. Eine erfolgreiche Antwort beinhaltet die operationId das kann verwendet werden, um den Status der Operation zu ermitteln mit getInboundOperationStatus. Alternativ kann ein Verkäufer bestätigen, dass sein Tarif für eingehende Bestellungen storniert wurde, indem er den Status des Tarifs telefonisch abruft getInboundPlan.

Pfadparameter

Beispiel anfordern

PUT /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/cancellation

Antwort

Eine erfolgreiche Antwort umfasst die folgenden Elemente:

Beispiel für eine Antwort

{
  "operationId": "operationId1234"
}

Sendungsname aktualisieren

Aktualisieren Sie den Namen einer Sendung mit dem updateShipmentName Betrieb. Der Benutzer möchte dies möglicherweise verwenden, um die Sendungsnummer aus der angegebenen Kennung mit einer vom Benutzer bereitgestellten Zeichenfolge zu verknüpfen. Die Sendungsnummer bleibt nach der Aktualisierung dieses Namens erhalten und wird verwendet, um die Sendung mithilfe anderer Operationen zu identifizieren. Um einen Sendungsnamen zu aktualisieren, übergeben Sie den neuen Namen als Zeichenfolge gemäß dem Anfragetextschema. Bei erfolgreicher Antwort erhalten Sie eine Vorgangs-ID, mit der Sie den Status des entsprechenden Vorgangs überprüfen können getInboundOperationStatus. Der Name kann verwendet werden, um Sendungen zu finden und darin zu navigieren.

Pfadparameter

Textparameter

Beispiel anfordern

POST /inbound/fba/version-tbd/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/name
{
  "name": "string"
}

Antwort

updateShipmentName gibt nichts zurück.

Namen des eingehenden Tarifs aktualisieren

Aktualisieren Sie den Namen eines vorhandenen Inbound-Tarifs mit dem updateInboundPlanName Betrieb. Der Benutzer möchte dies möglicherweise verwenden, um die Sendungsnummer aus der angegebenen Kennung mit einer vom Benutzer bereitgestellten Zeichenfolge zu verknüpfen. Um den Namen eines eingehenden Tarifs zu aktualisieren, geben Sie den neuen Namen als Zeichenfolge gemäß dem Anfragetextschema ein. Bei erfolgreicher Antwort erhalten Sie eine Vorgangs-ID, mit der Sie den Status des entsprechenden Vorgangs überprüfen können getInboundOperationStatus. Der Name kann verwendet werden, um Pläne für eingehende Lieferungen zu finden und darin zu navigieren.

Pfadparameter

Textparameter

Beispiel anfordern

POST inbound/fba/version-tbd/inboundPlans/{inboundPlanId}/name
{
  "name": "string"
}

Antwort

updateInboundPlanName gibt nichts zurück.

Versandpaletten auflisten

Rufen Sie eine paginierte Liste der Paletten an, die einer Sendung zugeordnet sind, indem Sie die listShipmentPallets Betrieb. Ein Wareneingangsplan enthält Paletteninformationen, nachdem der Benutzer die Palettendetails beim Generieren von Transporteursendungen mit weniger als einem LKW (LTL) mithilfe der generateTransportationOptions Betrieb. Eine erfolgreiche Antwort enthält eine paginierte Liste der zuvor eingegebenen Paletten mit ihren Gewichten, Abmessungen und Stapelbarkeit. Die Antwort enthält auch eine Kennung für die Palette, anhand derer eine Palette ihren Etiketten zugeordnet werden kann.

Pfadparameter

Parameter abfragen

Beispiel anfordern

GET inboundPlans/{inboundPlanId}/shipments/{shipmentId}/pallets

Antwort

Beispiel für eine Antwort

{
  "pagination": {
    "nextToken": "string"
  },
  "pallets": [
    {
      "packageId": "string",
      "weight": {
        "unit": "LB",
        "value": 0
      },
      "dimensions": {
        "unitOfMeasurement": "IN",
        "length": 0,
        "width": 0,
        "height": 0
      },
      "quantity": 1,
      "stackability": "STACKABLE"
    }
  ]
}

Versandkartons auflisten

Rufen Sie die Seite an, um eine paginierte Liste der Kartonpakete in einer Sendung einzusehen listShipmentBoxes Betrieb. Versandkartons müssen zuerst mit dem generiert werden setPackingInformation Betrieb, bevor es verfügbar ist. Um anzurufen listShipmentBoxes, ein Verkäufer muss die Sendungsnummer weitergeben. Eine erfolgreiche Antwort beinhaltet Informationen über die Kartons in der Sendung und die Artikel in den Kartons. Jeder Karton hat eine entsprechende Paket-ID, anhand derer Kartonetiketten den Kartons zugeordnet werden können. Die Antwort enthält auch Details zu jedem Karton, z. B. sein Gewicht/seine Abmessungen und die Artikel, die sich in den einzelnen Kartons befinden. Die Antwort beinhaltet für jeden Artikel Folgendes:

• MSKU
• ASIN
• FNSKU
• Chargencode des Herstellers
• Inhaber des Labels
• Anleitung zur Vorbereitung
• Art der Vorbereitung
• Besitzer von Prep

Wenn die Artikel ein Mindesthaltbarkeitsdatum haben, sind diese in der Antwort enthalten. Diese API enthält eine detaillierte Liste mit Informationen, die Benutzer benötigen, um eine Packliste zu erstellen, anhand derer sichergestellt werden kann, dass die Sendung vollständig ist, bevor sie an die Versandzentren gesendet wird.

Pfadparameter

Parameter abfragen