Ihr Marktplatz für antiquarische und neue Bücher | Login | Neu registrieren Registrieren
Buchfreund als App
Versand nach:
🇩🇪 Deutschland 🇦🇹 Österreich 🇨🇭 Schweiz

API für Verkäufer

Mit der Buchfreund REST-API stellen wir den Verkäufern unseres Marktplatzes eine einfache und sichere Kommunikation mit verschiedenen Schnittstellen zur Verfügung. Die derzeit unterstützten API-Operationen haben wir Ihnen auf dieser Seite aufgelistet. Klicken Sie auf die gewünschte Operation um weiterführende Informationen zu erhalten.

Jede API-Operation benötigt einen persönlichen API-Schlüssel zur Authentifizierung. Dieser API-Schlüssel ist in jedem Aufruf enthalten. Sie erhalten diesen API-Schlüssel in unserem Händlerbereich .

Request-URL: 
https://www.buchfreund.de/verkaeufer/api/{Ihr-persönlicher-API-Schlüssel}/bestand
 Request-Method: 
POST
 Request-Content (JSON) 
{
   "produkte":[
      {
         "bestellnr": string,
         "bestand":integer
      }
   ]
}
Wichtige Hinweise: Es können maximal 20 Produkte pro Request gemeldet werden. Wenn eine Bestellnummer in einem Request mehrfach vorkommen sollte, "gewinnt" jeweils die zuletzt Übermittelte. Die Verarbeitung der übermittelten Daten erfolgt asynchron nach dem FiFo-Prinzip.
Request-URL: 
https://www.buchfreund.de/verkaeufer/api/{Ihr-persönlicher-API-Schlüssel}/bild
 Request-Method: 
POST
 Request-Content (JSON) 
{
  "bestellnr": string,
  "bildnummer": integer,
  "content": base64-encoded-string
}
Wichtige Hinweise: Die übermittelten Bilder werden im Dateisystem des Servers abgespeichert. Die Verarbeitung dieser übermittelten Bilder erfolgt im üblichen Rahmen der Bildaktualisierung. Die Verarbeitung der übermittelten Daten erfolgt asynchron nach dem FiFo-Prinzip.
Request-URL: 
https://www.buchfreund.de/verkaeufer/api/{Ihr-persönlicher-API-Schlüssel}/bestellungen
 Request-Method: 
POST
 Request-Content (JSON) 
{
"datum_von": string (Format: YYYY-mm-dd HH:ii:ss),
"datum_bis": string (Format: YYYY-mm-dd HH:ii:ss)
}
Beispiel-Anfrage: 
{
   "datum_von":"2019-09-01 00:00:00",
   "datum_bis":"2019-09-02 23:59:59"
}
Beispiel-Antwort (JSON): 
{
   "error":false,
   "response":[
      {
         "id":"BF-2013249",
         "datum":"2019-09-10 15:40:21"
      }
   ]
}
Wichtige Hinweise: Der "datum_von"-Wert muss kleiner als der "datum_bis" Wert sein. Es müssen immer beide Werte angegeben werden. Der Abstand der beiden Datumswerte darf maximal 14 Tage sein.
Request-URL: 
https://www.buchfreund.de/verkaeufer/api/{Ihr-persönlicher-API-Schlüssel}/bestellung
 Request-Method: 
POST
 Request-Content (JSON) 
{
   "id": string
}
Beispiel-Anfrage: 
{
   "id":"BF-2013249"
}
Beispiel-Antwort (JSON): 
{
   "error":false,
   "response":{
      "id":"BF-2013249",
      "datum":"2019-09-10 15:40:21",
      "email":"[email protected]",
      "bestellzeichen":null,
      "bezahlart":"Rechnung (Vorauszahlung vorbehalten)",
      "bestellwert":"2.00",
      "versandkosten":"2.00",
      "waehrung":"EUR",
      "versandart":"Deutsche Post B\u00fccher\/Warensendung",
      "kundenkommentar":null,
      "versand":{
         "versender" : "DHL",
         "sendungsart" : "Paket",
         "sendungsnummer" : "32002348230409824",
         "einlieferungsdatum" : "2019-09-11 11:52:47"
      },
      "rechnungsadresse":{
         "anrede":"Herr",
         "vorname":"Stefan",
         "name":"Gl\u00e4\u00dfer",
         "adresse":"Emy-Roeder-Str. 10",
         "zusatz":null,
         "plz":"97074",
         "ort":"W\u00fcrzburg",
         "land":"Deutschland",
         "land_iso2":"DE"
      },
      "lieferadresse": {
          "anrede": "Herr",
          "vorname": "Stefan",
          "name": "Gl\u00e4\u00dfer",
          "adresse": "Musterstraße 12",
          "zusatz": null,
          "plz": "12345",
          "ort": "Musterstadt\/Sachsen",
          "land": "Deutschland",
          "land_iso2": "DE"
      },
      "positionen":[
         {
            "bestellnr":"10002",
            "titel":"Hallo, Mister Gott, hier spricht Anna ",
            "lagerfach": "A50295",
            "menge_bestellt":1,
            "menge_storniert":0,
            "preis_pro_einheit":"2.00",
            "storniert_am":null,
            "stornogrund":null
         }
      ]
   }
}
Wichtige Hinweise: Die Bestellung kann maximal 45 Tage nach Bestellaufgabe über die API abgerufen werden.
Request-URL: 
https://www.buchfreund.de/verkaeufer/api/{Ihr-persönlicher-API-Schlüssel}/versandbestaetigung
 Request-Method: 
POST
 Request-Content (JSON) 
{
   "id": string,
   "versender" : string (32),
   "sendungsart" : string (255),
   "sendungsnummer" : string (255)|null,
   "einlieferungsdatum" : string (Format: YYYY-mm-dd HH:ii:ss)
}
Beispiel-Anfrage: 
{
   "id":"BF-2013249",
   "versender" : "DHL",
   "sendungsart" : "Paket",
   "sendungsnummer" : "32002348230409824",
   "einlieferungsdatum" : "2019-09-11 11:52:47"
}
Beispiel-Antwort (JSON): 
{
   "error":false,
   "response":{
     "id": "BF-2013249",
     "versand": {
        "versender": "DHL",
        "sendungsart": "Paket",
        "sendungsnummer": "32002348230409824",
        "einlieferungsdatum": "2019-09-11 11:52:47"
     }
   }
}
Wichtige Hinweise: Die Sendungsnummer ist optional anzugeben, wenn der gewählte Versender ein Tracking ermöglicht. Der Versand kann innerhalb von 90 Tagen nach der Bestellung bestätigt werden.
Request-URL: 
https://www.buchfreund.de/verkaeufer/api/{Ihr-persönlicher-API-Schlüssel}/upload-daten
 Request-Method: 
POST
 Request-Content (form/multipart) 
POST https://www.buchfreund.de/verkaeufer/api/{Ihr-persönlicher-API-Schlüssel}/upload-daten
Accept: */*
Cache-Control: no-cache
Content-Type: multipart/form-data; boundary="upload"

--upload
Content-Disposition: form-data; name="file"; filename="katalog.zip"

< /home/stefan/katalog.zip
--upload--
Beispiel-Antwort (JSON): 
{
  "error": false,
  "response": "ok"
}
Wichtige Hinweise: Es dürfen nur Katalog in folgenden Formaten hochgeladen werden: "zip", "tab", "txt", "csv", "asc". Die Maximale Dateigröße beträgt aktuell 50 MB.
Request-URL: 
https://www.buchfreund.de/verkaeufer/api/{Ihr-persönlicher-API-Schlüssel}/upload-bilder
 Request-Method: 
POST
 Request-Content (form/multipart) 
POST https://www.buchfreund.de/verkaeufer/api/{Ihr-persönlicher-API-Schlüssel}/upload-bilder
Accept: */*
Cache-Control: no-cache
Content-Type: multipart/form-data; boundary="upload"

--upload
Content-Disposition: form-data; name="file"; filename="bilder.zip"

< /home/stefan/bilder.zip
--upload--
Beispiel-Antwort (JSON): 
{
  "error": false,
  "response": "ok"
}
Wichtige Hinweise: Es dürfen nur Bildarchive im ZIP-Format hochgeladen werden. Die Archive dürfen keine Ordnerstrukturen beinhalten. Die Maximale Dateigröße beträgt aktuell 50 MB.