JSON E-Mail Bestellimport

Bei Billbee hast du die Möglichkeit, Bestellungen per E-Mail einzulesen. Diese E-Mail muss in einem bestimmten Format formatiert sein, damit sie weiterverarbeitet werden kann. Wie der Aufbau so einer E-Mail ist und wie der Import einer solchen Bestellung läuft, findest du in diesem Artikel.

In diesem Artikel

Allgemeiner Aufbau des Bestellimport

Die Felder in der folgenden Tabelle können Teil der E-Mail für den Bestellimport sein. Nicht alle Felder sind zwingend notwendig für den Bestellimport, ein Teil aber schon. Ob ein Feld optional ist oder nicht kannst du in der rechten Spalte der nachfolgenden Tabelle sehen.

JSON-Feld Beschreibung Beispiel Optional
order_id Order-ID und Bestellnummer
Nein
currency_code Währung EUR Nein
payment_method Zahlart Mögliche Werte:
- paypal
- vorkasse
- überweisung
- banküberweisung
- kreditkarte
- nachnahme
- sofortüberweisung
- barzahlung
- rechnung
Ja
order_date Bestelldatum 2017-09-07T12:12:40 Nein
ust_id USt.Id.
Ja
email E-Mail-Adresse
Ja
telephone Telefonnummer
Ja
invoice. Rechnungsadresse
Nein
invoice.salutation Anrede Mögliche Werte:
0 (=Undefined)
1 (=Sir)
2 (=Madam)
3 (=Married Couple)
4 (=Company)
Nein
invoice.firstname Vorname
Nein
invoice.lastname Nachname
Nein
invoice.housenumber Hausnummer
Ja
invoice.address_1 Straße
Nein
invoice.address_2 Adresszusatz
Ja
invoice.zip PLZ
Nein
invoice.state Bundesland/Bundesstaat
Ja
invoice.city Ort
Nein
invoice.country Land DE Nein
invoice.company Firmenname
Ja
shipping. Lieferadresse
Nein
shipping.firstname Vorname
Nein
shipping.lastname Nachname
Nein
shipping.address_1 Straße
Nein
shipping.address_2 Adresszusatz
Ja
shipping.zip PLZ
Nein
shipping.state Bundesland/Bundesstaat
Ja
shipping.city Ort
Nein
shipping.country Land DE Nein
shipping.company

Ja
order_status_id Bestellstatus-ID Status:
2 = Bestätigt
3 = Bezahlt
4 = Versendet
5 = Reklamation
6 = Gelöscht
7 = Abgeschlossen
8 = Storniert
9 = Archiviert
10 = Bewertet
11 = Angemahnt
12 = 2. Mahnung
13 = Gepackt
14 = Angeboten
15 = Zahlungserinnerung
Ja, Standardwert: Bestätigt
internal_note Interne Notiz
Ja
comment Bemerkung
Nein
shipcost Versandkosten 4.99 Ja, Standardwert: 0
shipping_date Versanddatum yyyy-mm-dd  Ja
order_items Bestellpositionen
Nein
order_items[n].quantity Menge 0.25 Ja, Standardwert: 1
order_items[n].totalprice Gesamtsumme 9.25 Nein
order_items[n].product_id Produkt-ID 123 Ja
order_items[n].name Bezeichnung
Nein
order_items[n].sku SKU
Ja
order_items[n].imageurl URL zum Bild
Ja
order_items[n].taxrate Steuersatz in Prozent 19 Ja
tags Auflistung von Bestelltags (string-array)
Ja

wie funktioniert der Import?

Um Bestellungen mithilfe des JSON E-Mail Imports in Billbee einzulesen, musst du deine im JSON-Format formatierte E-Mail an  SHOP_ID-json-orderimport@inbound.billbee.de senden. SHOP_ID musst du noch durch deine individuelle Shop-ID ersetzen. 

Beispiel JSON

{
    "order_id": "JSON-123",
    "currency_code": "EUR",
    "payment_method": "paypal",
    "order_date": "2020-09-10T15:12:40",
    "ust_id": "DE-123456789",
    "email": "someone@domain.tld",
    "telephone": "01234-56789",
    "invoice": {
        "salutation": 1,
        "firstname": "Max",
        "lastname": "Mustermann",
        "housenumber": "42",
        "address_1": "Rechnungsstra\u00dfe 12",
        "address_2": "Rechnungszusatz 1",
        "zip": "12345",
        "state": "Bundesland/Bundesstaat",
        "city": "Rechnungshausen",
        "country": "DE",
        "company": "Rechnungsschreiber"
    },
    "shipping": {
        "salutation": 0,
        "firstname": "Lars",
        "lastname": "Liefer",
        "housenumber": "1337",
        "address_1": "Lieferstra\u00dfe 3",
        "address_2": "Lieferzusatz 2",
        "zip": "67890",
        "state": "Bundesland/Bundesstaat",
        "city": "Lieferhausen",
        "country": "FR",
        "company": "Liefermeister"
    },
    "order_status_id": 3,
    "internal_note": "Eine JSON Email Bestellung",
    "comment": "Bitte schnell bearbeiten",
    "shipcost": 4.99,
    "shipping_date": "2020-12-31",
    "order_items": [
        {
            "quantity": 2.33,
            "totalprice": 4.66,
            "product_id": null,
            "name": "Mein neuer Artikel",
            "sku": "1234-ddd",
            "imageurl": "https:\/\/some.url.tld\/image.jpeg",
            "taxrate": 19
        },
        {
            "quantity": 2.33,
            "totalprice": 4.66,
            "product_id": null,
            "name": "Mein neuer Artikel 2",
            "sku": "5789-ddd",
            "imageurl": "https:\/\/some.url.tld\/image.jpeg",
            "taxrate": 7
        }
    ],
    "tags": [
        "Stammkunde",
        "PRIO"
    ]
}
War dieser Artikel hilfreich? Vielen Dank für dein Feedback Bei der Übermittlung deines Feedback gab es Probleme, bitte probiere es erneut.