Von Ihrer Software zum Kunden

Ein einfacher zweiseitiger Datenfluss

Ihr System bleibt die Quelle Ihrer Geschäftsdaten. Es füttert den SellViaApp-Shop, während kundenbestätigte Bestellungen an Ihre ERP- oder Geschäftssoftware zurückfließen.

1

Ihr ERP

Produkte, Kategorien, Preise und Inhalte.

2

API SellViaApp

Sicherer JSON-Austausch über HTTPS.

3

Mobile App App

Kunden durchsuchen und platzieren Bestellungen.

4

Ihre Bestellungen

Ihr System ruft sie automatisch ab.

Keine Doppeleintragung

Externe Identifikatoren bewahren die Zuordnung zu Ihren ERP-Referenzen bei, während die Paginierung große Synchronisationen zuverlässig hält.

Schnellstart

Verbinden Sie Ihr System in drei Schritten

1

Holen Sie sich Ihre Anmeldeinformationen

Der API-Schlüssel identifiziert Ihren Shop. Der Administrator-Token schützt den Serverbetrieb.

2

Füllen Sie den Katalog ein

Erstellen Sie Kategorien und senden oder aktualisieren Sie dann Produkte aus Ihrem ERP.

3

Abrufaufträge

Wählen Sie die fortlaufende Lieferantenroute und speichern Sie jede verarbeitete GUID.

Erstellen eines Produkts · cURL

curl -X POST "https://api.sellviaapp.com/product/add" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_SUPPLIER_KEY" \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN" \
  -d '{
    "external_key": "ERP-ARTICLE-1042",
    "code": "ART-1042",
    "name": "Premium product",
    "description": "Complete product description",
    "base_price": 24.90,
    "vat_rate": 21,
    "category_id": 12,
    "active": true
  }'

Abrufaufträge · cURL

curl "https://api.sellviaapp.com/admin/order/list?page=1&per_page=25&from_date=2026-08-01" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_SUPPLIER_KEY" \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN"

Jede Bestellung enthältGUID, Anzahl, Kunde, Linien, Mengen, Preise, Mehrwertsteuer, Gesamtwert, Währung, Erfüllungsmodus, Adresse und Datum.

Sicherheit

Für jede Verwendung getrennte Zugangsdaten

KEY

X-API-Key

Erforderlich zur Identifizierung des Lieferanten. Legen Sie den Schlüssel niemals in öffentlichem JavaScript frei.

JWT

Genehmigung: Inhaber

Erforderlich für angemeldete Kundendaten. Erneuern Sie es durch auth/refresh.

ADM

X-Admin-Token

Reserviert für genehmigte Serverintegrationen, die Kataloge und Kategorien ändern.

Nur serverseitige Integration

Bewahren Sie X-API-Key und X-Admin-Token in Ihrem Server oder ERP auf. Platzieren Sie sie niemals auf einer öffentlichen Website, einer mobilen App oder einem Quellarchiv.

Endpunkte

Authentifizierung

Erstellen, Aktualisieren und Schließen von sicheren Sitzungen.

POST /auth/login API-Schlüssel

Melden Sie einen Kunden mit seinem Login und Passwort an.

POST /auth/refresh API-Schlüssel

Erneuern Sie ein Zugriffstoken mit einem Refresh-Token.

POST /auth/logout Schlüssel + Träger

Schließen Sie die aktive Sitzung.

POST /auth/guest API-Schlüssel

Erstellen Sie eine Gästesitzung, wenn diese vom Lieferanten aktiviert wird.

POST /auth/forgot-password API-Schlüssel

Starten Sie die Wiederherstellung des Kontos, ohne anzugeben, ob ein Konto existiert.

Endpunkte

Lieferanten und Branding

Finden Sie einen Shop und rufen Sie seine öffentliche Konfiguration ab.

GET /admin/supplier/list öffentlich

Suchen Sie Lieferanten, die im Verzeichnis sichtbar sind.

GET /admin/supplier/logo öffentlich

Holen Sie sich ein optimiertes Lieferantenlogo.

GET /admin/supplier/contact API-Schlüssel

Suchen Sie konfigurierte öffentliche Kontaktdaten ab.

GET /admin/supplier/legal API-Schlüssel

Retrieve Bedingungen, Privatsphäre, rechtliche Hinweise und über Inhalte.

GET /admin/megawinappcheck/check_supplier_to_use öffentlich

Lösen Sie einen Lieferanten von einem Suffix oder einer Kennung.

Endpunkte

Kunden

Erstellen und Verwalten von Kundenkonten für jeden Shop.

POST /customer/add API-Schlüssel

Erstellen Sie einen Kunden und generieren Sie den Lieferanten-Login.

GET /customer/list Schlüssel + Träger

Liste oder Filter autorisierter Kundeninformationen.

GET /customer/me Schlüssel + Träger

Holen Sie sich das angemeldete Kundenprofil ab.

PATCH /customer/update Schlüssel + Träger

Aktualisierungsprofil, Sprache, Typ, E-Mail oder Passwort.

DELETE /customer/deleteaccount Schlüssel + Träger

Deaktivieren Sie das Kundenkonto im aktiven Shop.

Endpunkte

Katalog

Kategorien, Produkte, Bilder, Preise, Lager, Promotionen und Favoriten.

GET /fam1/list Schlüssel + Träger

Primäre Kategorien auflisten.

POST /fam1/add Administrator

Erstellen Sie eine primäre Kategorie.

PATCH /fam1/update Administrator

Aktualisieren Sie eine primäre Kategorie.

DELETE /fam1/delete Administrator

Verstecken Sie eine primäre Kategorie.

GET /fam2/list Schlüssel + Träger

Unterkategorien auflisten.

POST /fam2/add Administrator

Erstellen Sie eine Unterkategorie.

PATCH /fam2/update Administrator

Aktualisieren Sie eine Unterkategorie.

DELETE /fam2/delete Administrator

Verstecken Sie eine Unterkategorie.

GET /product/list Schlüssel + Träger

Liste und Suche nach Produkten mit Paginierung.

GET /product/image Signierte URL

Servieren Sie ein signiertes, cachefähiges Produktbild.

POST /product/add Administrator

Erstellen Sie ein Produkt.

PATCH /product/update Administrator

Aktualisieren Sie ein Produkt.

DELETE /product/delete Administrator

Verstecken Sie ein Produkt.

POST /product/favoris Schlüssel + Träger

Hinzufügen oder Entfernen eines Produkts von Favoriten.

GET /price/list Schlüssel + Träger

Listenpreise für die Kundengruppe.

GET /mark/list Schlüssel + Träger

Verfügbare Marken auflisten.

GET /size/list Schlüssel + Träger

Liste der verfügbaren Größen auf.

GET /libweb/list Schlüssel + Träger

Liste Web-Referenzetiketten.

Endpunkte

Warenkorb und Bestellungen

Verwalten Sie den Warenkorb und bestätigen Sie eine Bestellung atomar.

GET /admin/order/list Administrator

Abrufen aller bestätigten Lieferantenaufträge mit Kunden, Linien und Paginierung.

GET /order/add Schlüssel + Träger

Den aktuellen Warenkorb abrufen oder initialisieren.

GET /order/list Schlüssel + Träger

Listen Sie den Warenkorb und die Bestellhistorie auf.

DELETE /order/delete Schlüssel + Träger

Löschen und löschen Sie den aktuellen Warenkorb.

GET /order/total Schlüssel + Träger

Berechnen Sie den Warenkorb Zwischensumme, Mehrwertsteuer und Gesamtwert.

GET /order/count/line Schlüssel + Träger

Zählen Sie Linien im Wagen.

POST /order/sendtomegawin Schlüssel + Träger

Bestätigen Sie die Bestellung, den Erfüllungsmodus und die Adresse.

POST /orderline/add Schlüssel + Träger

Fügen Sie ein Produkt und eine Menge in den Warenkorb.

GET /orderline/list Schlüssel + Träger

Abrufen von aktuellen Wagenleitungen.

PATCH /orderline/update Schlüssel + Träger

Aktualisieren Sie eine Zeilenmenge.

DELETE /orderline/delete Schlüssel + Träger

Entfernen Sie eine Linie aus dem Warenkorb.

Endpunkte

Dokumente

Rechnungen, Schätzungen, Bestellungen und deren Linien.

POST /document/add Schlüssel + Träger

Erstellen Sie ein Dokument, das mit dem Kunden verknüpft ist.

GET /document/list Schlüssel + Träger

Listen oder filtern Sie Dokumente.

PATCH /document/update Schlüssel + Träger

Aktualisieren Sie ein Dokument, das von GUID identifiziert wurde.

DELETE /document/delete Schlüssel + Träger

Löschen Sie ein Dokument und seine Zeilen.

POST /documentline/add Schlüssel + Träger

Fügen Sie eine Zeile hinzu und berechnen Sie das Dokument neu.

GET /documentline/list Schlüssel + Träger

Holen Sie ein Dokument mit allen seinen Zeilen ab.

PATCH /documentline/update Schlüssel + Träger

Aktualisieren Sie eine Zeile, die von GUID identifiziert wurde.

DELETE /documentline/delete Schlüssel + Träger

Löschen Sie eine Zeile und berechnen Sie die Gesamtsumme neu.

Endpunkte

Support, Benachrichtigungen und Integrationen

Kundenkommunikation, Support und externe Synchronisation.

GET /support/ticket/list Schlüssel + Träger

Listentickets, die dem Kunden zur Verfügung stehen.

POST /support/ticket/create Schlüssel + Träger

Erstellen Sie eine Support-Anfrage.

GET /support/ticket/list/log_reply Schlüssel + Träger

Holen Sie sich ein Ticket und seine Antworten.

GET /support/ticket/list/waiting_reply_by_support Schlüssel + Träger

Listenanfragen warten auf Support.

POST /support/ticket/reply/send Schlüssel + Träger

Antworte auf ein Ticket.

POST /admin/supplier/sendfeedbackfromapp Schlüssel + Träger

Senden Sie Feedback an den Lieferanten.

POST /admin/supplier/sendemailtosalesupport Schlüssel + Träger

Kontaktieren Sie den Verkaufssupport.

GET /admin/notification/sendtomobile Schlüssel + Träger

Mobile Benachrichtigungen abrufen.

POST /admin/notification/setdelivery Schlüssel + Träger

Markieren Sie eine Benachrichtigung als geliefert.

POST /woocommerce/menu/synchronisation Administrator

Synchronisieren Sie WooCommerce-Kategorien.

POST /woocommerce/product/synchronisation Administrator

Synchronisieren Sie WooCommerce-Produkte.

Kerngeschäfte

Detaillierte Parameter

Parameter können als JSON oder, für GET-Routen, in der Abfragezeichenfolge gesendet werden.

/auth/login+

NameArt der ArtErforderlichBeschreibung

loginStringJa

E-Mail, Kunden-Login oder Login einschließlich Lieferanten-Suffix.

passwordStringJa

Kundenpasswort.

supplierStringNein

Lieferanten-Suffix oder Schlüssel, wenn nicht im Login enthalten.

/customer/add+

NameArt der ArtErforderlichBeschreibung

nomStringJa

Nachname des Kunden.

prenomStringJa

Vorname des Kunden.

emailE-Mail-E-Mail-AdresseJa

E-Mail einzigartig innerhalb des Lieferanten.

denominationStringNein

Name des Unternehmens, fakultativ.

passwordStringJa

Mindestens acht Zeichen.

langueStringNein

Bevorzugte Sprache.

/product/list+

NameArt der ArtErforderlichBeschreibung

pageGanzzahlNein

Seitenzahl, beginnend bei 1.

per_pageGanzzahlNein

Produkte pro Seite.

searchStringNein

Suche nach Code, Name oder Beschreibung.

category_idGanzzahlNein

Filter für die Hauptkategorie.

subcategory_idGanzzahlNein

Filter der Unterkategorie.

/product/add+

NameArt der ArtErforderlichBeschreibung

codeStringJa

Produktcode einzigartig im Shop.

nameStringJa

Name in der App angezeigt.

descriptionStringNein

Ausführliche Produktbeschreibung.

base_priceDezimalzahlJa

Verkaufspreis ohne Steuern gemäß Ihrer Konfiguration.

vat_rateDezimalzahlNein

MwSt.-Satz, z. B. 21.

category_idGanzzahlNein

SellViaApp Kategorie-Identifikator.

external_keyStringNein

Stabile Identifikator aus Ihrem ERP.

image_urlurlNein

HTTPS URL des Hauptbildes.

activeBoolestanNein

Kontrolliert die Produktsichtbarkeit.

/admin/order/list+

NameArt der ArtErforderlichBeschreibung

pageGanzzahlNein

Gefragte Seite, beginnend bei 1.

per_pageGanzzahlNein

Bestellungen pro Seite, maximal 100.

from_dateDatumNein

Nur Bestellungen ab diesem Datum zurückgeben.

guidStringNein

Holen Sie eine Bestellung von GUID ab.

statusStringNein

Filter verfügbar je nach Speichermodus: ausstehend, vorbereitend, bereit, geliefert oder storniert.

/order/sendtomegawin+

NameArt der ArtErforderlichBeschreibung

order_guidUuidNein

GUID des Warenkorbs zu bestätigen.

delivery_modeenumJa

pickup | delivery

delivery_addressStringNein

Für die Lieferung erforderlich.

delivery_dateDatumNein

JJJJ-MM-TT

delivery_commentStringNein

Anweisungen zur Erfüllung.

languageStringNein

Transaktionale E-Mail-Sprache.

/document/add+

NameArt der ArtErforderlichBeschreibung

doc_typeStringJa

invoice | estimate | purchase_order

customer_idGanzzahlNein

Legacy-Kompatibilität; der authentifizierte Kunde hat Vorrang.

doc_numberStringJa

Dokumentnummer.

doc_dateDatumJa

JJJJ-MM-TT

due_dateDatumNein

JJJJ-MM-TT

payment_methodStringNein

Zahlungsmethode.

remarkStringNein

Freiform Bemerkung.

/documentline/add+

NameArt der ArtErforderlichBeschreibung

document_guidUuidJa

Dokument GUID.

textStringJa

Streckenbeschreibung.

quantityDezimalzahlJa

Menge.

unit_priceDezimalzahlJa

Stückpreis ohne Mehrwertsteuer.

vat_rateDezimalzahlNein

MwSt.-Satz.

discount_percentageDezimalzahlNein

Prozentsatz des Rabatts.

JSON

Antwortumschlag

200 OK

{
  "success": true,
  "message": "OK",
  "data": {
    "items": []
  },
  "meta": {
    "page": 1,
    "per_page": 10,
    "total": 0
  }
}

Diagnose

Strukturierte Fehler

Jeder Fehler macht einen maschinenlesbaren Code, eine Kategorie, eine vom Menschen lesbare Nachricht und, wenn verfügbar, eine Anforderungskennung sichtbar.

400Antrag auf Ungültigkeit

401Authentifizierung erforderlich

403Zugang verweigert

404Ressource oder Route nicht gefunden

409Geschäftskonflikt

422Validierung fehlgeschlagen

429Zu viele Anfragen

5xxTechnische Störung

422 Unverarbeitbarer Inhalt

{
  "success": false,
  "message": "The delivery address is required.",
  "data": null,
  "error": {
    "code": "DELIVERY_ADDRESS_REQUIRED",
    "category": "validation",
    "message": "The delivery address is required.",
    "details": {}
  }
}

Legacy-Dokumentation

Legacy URLs bleiben anerkannt

Die neue API akzeptiert Varianten, die auf doc.sellviaapp.com veröffentlicht wurden, so dass bestehende Integrationen weiterhin funktionieren.

/api/document/*→/document/*

/user/add→/customer/add

/fam1/insert→/fam1/add

/product/insert→/product/add

/product/favorites→/product/favoris

/order/count→/order/count/line

/CUSTOMER/LIST→/customer/list

Prüfung vollständig

Jede in der Legacy-Dokumentation veröffentlichte Route hat nun eine native Route oder einen Kompatibilitätsalias.

Füttern Sie Ihre App und rufen Sie Bestellungen über die API ab.

Ein einfacher zweiseitiger Datenfluss

Ihr ERP

API SellViaApp

Mobile App App

Ihre Bestellungen

Verbinden Sie Ihr System in drei Schritten

Holen Sie sich Ihre Anmeldeinformationen

Füllen Sie den Katalog ein

Abrufaufträge

Für jede Verwendung getrennte Zugangsdaten

X-API-Key

Genehmigung: Inhaber

X-Admin-Token

Authentifizierung

Lieferanten und Branding

Kunden

Katalog

Warenkorb und Bestellungen

Dokumente

Support, Benachrichtigungen und Integrationen

Detaillierte Parameter

Antwortumschlag

Strukturierte Fehler

Legacy URLs bleiben anerkannt