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.

Allgemeiner Aufbau des Bestellimports

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"
    ]
}