Spezifische Daten der Verkaufsplattform Amazon

Navigation:  WebService Calls > Options for Growth > createShippingLabels > Plattformspezifische Daten >

Spezifische Daten der Verkaufsplattform Amazon

 Previous pageReturn to chapter overviewNext page

Texte ein-/ausblenden

Beschreibung

Mit folgendem Request können Sie Versandlabel von Amazon erzeugen lassen. Dies ist nötig, sofern Sie 'Seller Fulfilled Prime' verwenden.

Beispiel Request

Code

<amazon_shipping_label reference_id="123">

   <mandator_id>1</mandator_id>

   <order significant_key="order_id">

      <order_id>55000</order_id>

      <order_number>34561</order_number>

      <external_order_number_1>1111</external_order_number_1>

      <external_order_number_2>2222</external_order_number_2>

      <marketplace_order_id>54981</marketplace_order_id>

      <order_number_and_prefix>Amazon-1230</order_number_and_prefix>

      <mandator_id>1</mandator_id>

      <order_items>

         <order_item significant_key="item_id">

            <order_item_id>132</order_item_id>

            <item_id>123</item_id>

            <internal_item_number>123</internal_item_number>

            <quantity>1</quantity>

         </order_item>

         <order_item significant_key="item_id">

            <order_item_id>123</order_item_id>

            <item_id>123</item_id>

            <internal_item_number>123</internal_item_number>

            <quantity>3</quantity>

         </order_item>

      </order_items>

   </order>

   <delivery_experience>NoTracking</delivery_experience>

   <carrier_will_pick_up>true</carrier_will_pick_up>

   <shipping_date>2016-09-11T15:42:00.000+02:00</shipping_date>

   <height>15</height>

   <length>20</length>

   <width>30</width>

   <dimension_unit>110</dimension_unit>

   <weight>2500</weight>

   <weight_unit>400</weight_unit>

   <from_address>

      <salutation_id>1</salutation_id><!--Variant 1-->

      <!--<salutation_identifier>mr</salutation_identifier>--><!--Variant 2-->

      <firm>Speed4Trade GmbH</firm>

      <title>Dr.</title>

      <first_name>Max</first_name>

      <last_name>Mustermann</last_name>

      <street>An den Gärten</street>

      <house_number>8</house_number>

      <street_additional>1. Stock</street_additional>

      <postal_code>92665</postal_code>

      <city>Altenstadt</city>

      <country_code_iso>DE</country_code_iso>

      <phone_number>0960294440</phone_number>

   </from_address>

<email>info@speed4trade.com</email>

<require_format>ZPL203</require_format>

<must_arrive_date>2016-09-12T15:42:00.000+02:00</must_arrive_date>

<declared_value_amount>49.99</declared_value_amount>

<declared_value_currency_code>EUR</declared_value_currency_code>

</amazon_shipping_label>

Feldliste Request

Name

Beschreibung

Anz.

Typ

Sonstiges

amazon_shipping_label

Wrapper-Element, das die Information zu einem Versandlabel umfasst.

1..N

Element

mandator_id

ID des Mandanten.

1

integer

order

Wrapper-Element, das die Informationen zu einer Bestellung zusammenfasst.

1

Element

significant_key

Gibt an welches Feld zur Identifikation des Auftrags beim Update genutzt wird.

1

string

Feste Werte: „order_id“ | „order_number“ | „external_order_number_1“ | „external_order_number_2“ | „marketplace_order_id“ | „order_number_and_prefix“

order_id

ID der Bestellung

1

integer

order_number

Nummer der Bestellung

1

integer

external_order_number_1

Externe Auftragsnummer 1

0..1

integer

external_order_number_2

Externe Auftragsnummer 2

0..1

integer

marketplace_order_id

Auftragsnummer des Marktplatzes

1

string

order_number_and_prefix

Auftragsnummernpräfix und Auftragsnummer

1

string

mandator_id

ID des Mandanten dem dieser Auftrag zugeordnet ist.

0..1

integer

order_items

Wrapper-Element, das die Auftragspositionen des Auftrags zusammenfasst.

1

Element

order_item

Wrapper-Element, das die Daten einer Auftragsposition umfasst.

1..N

Element

order_item_id

Auftragspositions ID

1

integer

item_id

Artikel ID

1

integer

internal_item_number

Interne Artikelnummer

1

string

quantity

Menge

1

integer

delivery_experience

Gibt an ob der Empfang der Lieferung schriftlich bestätigt werden muss.

1

string

Feste Werte: "DeliveryConfirmationWithSignature" | "DeliveryConfirmationWithAdultSignature" | "NoTracking" | "DeliveryConfirmationWithoutSignature"

carrier_will_pick_up

Gibt an ob der Lieferant das Paket abholt.

1

boolean

shipping_date

Versanddatum

1

dateTime

height

Höhenmaß des Pakets

1

integer

length

Längenmaß des Pakets

1

integer

width

Breitenmaß des Pakets

1

integer

dimension_unit

ID für die Einheit der angegebenen Maße

1

integer

Feste Werte

weight

Gewicht

1

integer

weight_unit

ID für die Einheit des angegebenen Gewichts

1

integer

Feste Werte

from_address

Wrapper-Element, das die Absenderadressdaten beinhaltet.

1

Element

salutation_id

ID der Anrede

1

integer

Hinweis

salutation_identifier

Bezeichnung der Anrede

string

Hinweis

firm

Firma

0..1

string

Max. 30 Zeichen. Hinweis

title

Namenszusatz

0..1

string

first_name

Vorname

1

string

last_name

Nachname

1

string

street

Straße

1

string

house_number

Hausnummer

1

string

street_additional

Adresszusatz

0..1

string

postal_code

Postleitzahl

1

string

Max. 30 Zeichen. Hinweis

city

Stadt

1

string

Max. 30 Zeichen. Hinweis

country_code_iso

ISO-Ländercode

1

string

Z. B.: "DE" | "CH" | "AT" usw.

phone_number

Telefonnummer

1

string

Max. 30 Zeichen. Hinweis

email

E-Mailadresse des Versenders.

1

string

Max. 256 Zeichen. Hinweis

require_format

Gewünschtes Labelformat.

0..1

string

Amazon gibt hier aktuell die Möglichkeiten: "PDF", "PNG" und "ZPL203" vor.

Hinweis

must_arrive_date

Hiermit können die Versandoptionen auf ein Soll-Ankunftsdatum eingegrenzt werden. Amazon schlägt keine Versandarten vor die dieses Soll-Datum überschreiten.

0..1

dateTime

declared_value_amount

Maximale Versandkosten. Amazon schlägt keine Versandarten vor die diesen Betrag überschreiten.

0..1

decimal

declared_value_currency_code

Währungscode zu den maximalen Versandkosten.

0..1

string

ISO-Code z.B. "EUR"

Beispiel Response

Code

<mandator_id>1</mandator_id>

<order_id>2053944</order_id>

<shipping_date>2016-10-04T15:42:00.000+02:00</shipping_date>

Feldliste Response

Name

Beschreibung

Anz.

Typ

Sonstiges

mandator_id

ID des Mandanten

1

integer

order_id

ID der Bestellung

1

integer

shipping_date

Versanddatum

1

dateTime

Hinweise

•Stellen Sie sicher das die Adresskonfiguration des Mandanten in Speed4Trade CONNECT vollständig und korrekt ist. Es können Daten aus dem Mandanten für die Erstellung der ShippingLabels herangezogen werden.

•Dieser Request wird asynchron ausgeführt. D.h. auf eine Antwort von Amazon wird nicht gewartet. Sollte Amazon mit einer Fehlermeldung antworten (z.B.: Wenn keine Telefonnummer übergeben wurde) dann wird dieser Response in den Marktplatzmeldungen gespeichert. Um diesen Response aus Speed4Trade CONNECT auszulesen, verwenden Sie bitte den Request fetchUploadMessages.

•Es muss entweder das Element 'salutation_id' oder 'salutation_identifier' übergeben werden. Beide Elemente gleichzeitig sind nicht zulässig.

•WICHTIG: Wenn das Lieferland nicht mit der Amazonseite zusammenpasst (z.B.: Lieferland: Österreich, Seite: amazon.de), kann das ShippingLabel nicht über createShippingLabels erzeugt werden. Dies ist eine Limitierung seitens der Schnittstelle von Amazon. Für solche Aufträge erstellen Sie die ShippingLabels bitte über das Sellercentral (Amazonaccount Backend).

•Maximale Zeichen: Die Angabe bezieht sich auf Grenzen die seitens Amazon definiert werden. Diese Werte können sich ändern. Die Angaben sind in unserer Doku als Hilfestellung zu betrachten und ohne Gewähr.

•Nicht jeder Versender unterstützt jedes der Label Dateiformate. Die Einschränkung auf ein bestimmtes Labelformat kann also dazu führen, dass kein Label erstellt werden kann. Wird require_format nicht angegeben, dann kann das resultierende Label irgendeines der möglichen Dateiformate haben.

Wertetabelle(n)

Folgende Werte gelten für das Feld: dimension_unit

Wert

Beschreibung

105

mm

110

cm

115

dm

120

m

125

in.

130

ft.

135

yd

Folgende Werte gelten für das Feld: weight_unit

Value

Description

400

g

405

kg

407

t

409

oz.tr.

410

oz.

415

pd.

Änderungsübersicht

Version

Änderungsbeschreibung

3.6.36

Initiale Einführung des Request.

4.8.40

Information hinzugefügt, dass der Request nur verwendet werden kann, wenn Lieferland und Amazonseite auf das gleiche Land hindeuten.

4.10.4

Feld require_format hinzugefügt.