Diese Methode erstellt ein neues DHL-Versand-Etikett.
Mit dieser URL rufen Sie die API-Methode auf:
http://webservice.rakuten.de/merchants/orders/addOrderDHLShippingLabel
Für diese Methode ist eine Authentifizierung mit Schreibrechten erforderlich.
Empfohlen wird der Aufruf über HTTP-POST.
Die mit * gekennzeichneten Parameter müssen übergeben werden.
Authentifizierungs-Schlüssel
Datentyp: | String |
Bestell-Nr.
Datentyp: | String |
Regeln: | Das Format der Bestell-Nr. ist XXX-XXX-XXX. |
Gewichtsstufe
Datentyp: | Integer | |||||||||||||||
Regeln: |
|
|||||||||||||||
Standard: | 0 |
Kennzeichen für einen Retouren-Identcode
Datentyp: | Boolean |
Standard: | 1 |
Beispiel im XML-Format.
<?xml version="1.0" encoding="utf-8"?>
<result>
<success>1</success>
<label>
<src>http://api.rakuten.de/webservice/docs/shipping_label?label_id=123456&key=123456789a123456789a123456789a12</src>
<created>2010-01-01 20:15:00</created>
<identcodes>
<shipping>
<identcode>123456789</identcode>
<tracking>URL zur Paketverfolgung</tracking>
</shipping>
<retoure>
<identcode>123456789</identcode>
<tracking>URL zur Paketverfolgung</tracking>
</retoure>
</identcodes>
</label>
</result>
Element | Datentyp | Bedeutung | ||||||
---|---|---|---|---|---|---|---|---|
result | Container | Container mit angeforderten Daten | ||||||
success | Boolean | Kennzeichen für einen erfolgreichen Aufruf
|
||||||
label | Container | Container mit Daten zum Versand-Etikett | ||||||
src | URL | URL zum DHL Versand-Etikett als PDF | ||||||
created | Date | Erstellungs-Datum | ||||||
identcodes | Container | Container mit Identcodes | ||||||
shipping | Container | Container mit Identcode-Daten zum Versand | ||||||
identcode | Integer | Identcode | ||||||
tracking | URL | URL zur Paketverfolgung | ||||||
retoure | Container | Container mit Identcode-Daten zur Retoure Beinhaltet keine Daten, wenn kein Retouren-Etikett angelegt wurde! |
||||||
identcode | Integer | Identcode | ||||||
tracking | URL | URL zur Paketverfolgung |
Code | Bedeutung |
---|---|
3102 | Es wurde kein aktiver DHL-Vertrag gefunden |
3105 | Die Bestellung konnte nicht gefunden werden |
3110 | Die Maximale Anzahl an Labels wurde erreicht |
3111 | Es konnte kein neues Label erzeugt werden |
3115 | Eine Gewichtsangabe ist nicht gültig, da ein Pauschal-Vertrag hinterlegt ist |
3116 | Das Hinterlegen einer Pauschale ist bei einen Vertrag nach Gewicht nicht zulässig |