Bestellungen als Kunde via API erstellen
Fragestellungen:
- Wie kann ich Bestellungen automatisiert erstellen?
- Wie kann ich Dropshipping nutzen?
- Wie übergebe ich meine Lieferschein-Daten?
Beschreibung:
TYRIOS erlaubt es dir als Kunden, Bestellungen automatisiert über eine Schnittstelle bereitzustellen. Dafür muss diese Funktion vom Shop-Betreiber für dich freigeschaltet worden sein. Ist dies der Fall, so steht dir eine REST-Schnittstelle zur Verfügung, die bei Bedarf auch Dropshipping unterstützt.
URL-Struktur:
Wurde dir vom Shop-Betreiber die Funktion zur Nutzung der API freigeschaltet, so steht dir unter folgender URL eine Bestell-API zur Verfügung:
https://[shop-url]/service/OrderManagement/UserOrderManagement
Die Schnittstelle unterstützt ausschließlich POST-Anfragen zur Erzeugung der Bestellung
Authentifizierung
Zur Erstellung einer Bestellung oder eines Auftrags über die Kundenschnittstelle musst du gegenüber dem System authentifiziert sein. Hierzu benötigst du neben deinem Benutzernamen ein API-Secret, welches dir vom Shopbetreiber mitgeteilt werden muss. Beides zusammen muss in Form einer Basic-Authentication an TYRIOS übergeben werden.
Datenstruktur
Zur Erzeugung einer Bestellung musst du ein JSON-Objekt im Body deiner Anfrage übertragen:
{ "billingAddress": { "company": "Firmenbezeichnung", "name": "Name", "preName": "Vorname", "street": "Straße", "streetNo": "Hausnummer", "postCode": "PLZ", "city": "Stadt", "country": "Landeskürzel (z.B. 'de')" }, "deliveryAddress": { /* gleicher Aufbau zu billingAddress */ }, "positions": [ { "productID": 1, "amount": 2 }], "dropShipping": true/false }
Rückgabe
Bei einer erfolgreichen Bestellung werden dir sämtliche Bestellinformationen - inkl. anfallenden Versandkosten - automatisch als Antwort im JSON-Format geliefert. Dabei erhälst du auch für jede Position alle notwendigen Detail-Informationen.
Vorgehen:
Tips und Tricks:
Du kannst beim Shopbetreiber eine eigene PDF-Vorlage hinterlegen lassen. Dann wird auf Basis deiner Bestellung vollautomatisch ein Lieferschein mit deinem Briefpapier erstellt und die Bestellung kann in deinem Namen an deinen Kunden verschickt werden. Voraussetzung ist hierfür, dass "dropShipping" mit "true" markiert ist.