Verbinden Sie Ihr Unternehmen mit einem breiteren Produktkatalog und mehr Chancen

Die B2B-API von MediaMax ermöglicht es, einen Online-Shop, ein ERP-System oder ein internes System über authentifizierte HTTP-Anfragen mit unserem Katalog, unseren Preisen, Beständen, Bestellungen und Versendungen zu verbinden.

Der Katalog ermöglicht den Abruf einer seitenweise unterteilten Liste und danach die Abfrage der aktuellen Details einer SKU. Je nach Produkt können die Daten Name, Referenz, Kundenpreis, Verfügbarkeit, EAN, Bilder und Energieinformationen enthalten.

Katalog abrufen

                curl --request GET \
  --url 'https://www.mediamax.es/api/product/all?pag=1&max=25' \
  --header 'HTTP-API-KEY: IHR_TOKEN' \
  --header 'Accept-Language: de'
              

Ein Produkt abfragen

                curl --request GET \
  --url 'https://www.mediamax.es/api/product/BEISPIEL-SKU' \
  --header 'HTTP-API-KEY: IHR_TOKEN'
              

Vereinfachte Beispielantwort

                {
  "id": 12345,
  "attributes": {
    "name": "Beispielprodukt",
    "sku": "BEISPIEL-SKU",
    "price": 199.99,
    "qty_available": 8,
    "gallery": []
  }
}
              

Feeds stellen Dateien bereit, die regelmäßig in einen eCommerce, ein ERP-System oder in eine Integrationslösung importiert werden können. Sie sind eine Alternative oder Ergänzung zur API: Sie ermöglichen Stapelsynchronisierungen, ohne einzelne Produktabfragen durchführen zu müssen.

Schneller Feed für Preis und Verfügbarkeit

Empfohlene Aktualisierungsfrequenz alle 15–30 Minuten, je nach Integrationsprozess.

Dokumentiertes Format: Feldtrennzeichen |; Textbegrenzer '.

Exklusiver Erweiterter Katalog umfasst Artikel, die noch nicht auf unserer Website veröffentlicht sind, und ermöglicht Ihnen so den Zugang zu einem deutlich größeren Katalog.

Welche Vorteile bietet er?

Ziel ist es, das Matching mit den bestehenden Produktseiten auf Plattformen wie Amazon, Miravia und anderen Marktplätzen zu verbessern und so die Möglichkeiten zu erhöhen, unsere Produkte zu verkaufen.

Welche Vorteile bietet er?

Jede API-Integration wird einem Benutzer und einer E-Mail-Adresse von MediaMax zugeordnet, die mit der kaufmännischen und steuerlichen Konfiguration des Kunden verknüpft sind. Diese Zuordnung beeinflusst Tarif, Preise und die Behandlung der Rechnungsstellung.

Eine API-Bestellung umfasst die eigene Referenz des Kunden, die Rechnungsadresse, die Lieferadresse und die Positionen mit SKU und Menge. MediaMax gibt eine Kennung zurück, die zusammen mit der ursprünglichen Referenz aufbewahrt werden muss.

Bestellung erstellen

                curl --request POST \
  --url 'https://www.mediamax.es/api/order' \
  --header 'HTTP-API-KEY: IHR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data @bestellung.json
              

Beispiel für bestellung.json

                {
  "b2b_reference": "BESTELLUNG-KUNDE-2026-0001",
  "order_billing_address": {
    "name": "Laura",
    "lastname": "García",
    "company": "Beispiel GmbH",
    "email": "compras@example.com",
    "phone": "+34900000000",
    "street": "Beispielstraße 1",
    "postcode": "03001",
    "city": "Alicante",
    "region_id": "A",
    "country": "ES"
  },
  "order_shipping_address": {
    "name": "Laura",
    "lastname": "García",
    "company": "Beispiel GmbH",
    "email": "logistica@example.com",
    "phone": "+34900000000",
    "street": "Lieferstraße 10",
    "postcode": "03002",
    "city": "Alicante",
    "region_id": "A",
    "country": "ES",
    "express": 0
  },
  "order_lines": [
    {"sku": "BEISPIEL-SKU", "quantity": 1}
  ]
}
              

Mehrere Referenzen abfragen

                curl --request GET \
  --url 'https://www.mediamax.es/api/batch/reference?pag=1&max=25&references=PEDIDO-001&references=PEDIDO-002' \
  --header 'HTTP-API-KEY: IHR_TOKEN'
              

Bei Dropship bereiten MediaMax und versenden die Bestellungen im Namen des Kunden und verwenden dafür die Kontoeinstellungen für Dokumentation und Etikettierung. Laut dem beschriebenen Verfahren werden über die API aufgegebene Bestellungen in dieser Form abgewickelt.

Eine Bestellung kann eine oder mehrere Versendungen erzeugen. Jede kann eine eigene Pick-Referenz, einen Spediteur, eine Sendungsnummer und einen logistischen Status haben.

Versendung über Referenz abfragen

                curl --request GET \
  --url 'https://www.mediamax.es/api/packing/show/reference/WH%2FOUT%2F00000' \
  --header 'HTTP-API-KEY: IHR_TOKEN'
              

Vereinfachte Beispielantwort

                {
  "code": "200",
  "status": "success",
  "data": {
    "id": 4567,
    "attributes": {
      "reference": "WH/OUT/00000",
      "tracking": "TRACKING-BEISPIEL",
      "status": "done"
    }
  }
}
              

Alle Versendungen der Bestellung abfragen

                curl --request GET \
  --url 'https://www.mediamax.es/api/packing/show/order/odoo/S00000' \
  --header 'HTTP-API-KEY: IHR_TOKEN'
              

Der Übergang von DEMO zur Produktion erfordert die Überwachung der ersten Vorgänge, um zu bestätigen, dass die Integration mit Echtdaten funktioniert. Dabei wird eine Kontaktsperre verwendet, um die Übertragung des Picks bis zum Abschluss der Prüfung zu steuern.

Übersicht der Vorgänge