Dokumentation

Nachweise anfordern. Gültigkeit im Blick behalten.

LyveVendor sammelt Nachweise Ihrer Lieferanten an einem Ort: anfordern, per Link hochladen lassen, prüfen und Ablaufdaten überwachen. Diese Dokumentation erklärt die Anwendung — vom ersten Lieferanten bis zur Integration.

Das Dashboard: Kennzahlen und Handlungsbedarf auf einen Blick

Übersicht

Wer mit Subunternehmern und Lieferanten arbeitet, braucht aktuelle Nachweise: Versicherungen, Zertifikate, Freistellungsbescheinigungen. LyveVendor macht daraus einen nachvollziehbaren Prozess statt einer Excel-Liste mit Erinnerungen im Kalender.

Nachweise im Griff
Legen Sie fest, welche Nachweise Sie von Lieferanten brauchen — etwa Betriebshaftpflicht, ISO 9001 oder Freistellungsbescheinigung.
Upload ohne Konto
Lieferanten laden Dokumente über einen sicheren Link hoch. Ein eigenes Konto ist nicht nötig.
Ablauf im Blick
Gültigkeiten werden überwacht: 30 Tage vor Ablauf „Läuft bald ab“, danach „Abgelaufen“. Bei PDFs wird das Ablaufdatum nach Möglichkeit automatisch erkannt.
Prüfen & freigeben
Neue Uploads warten auf Ihre Prüfung. Genehmigen Sie mit Gültigkeitsdatum oder lehnen Sie mit Begründung ab.
Anfragen & Erinnerungen
Nachweise per E-Mail anfordern und erinnern — über den SMTP-Server und die Absenderadresse Ihres Unternehmens.
Nachvollziehbar
Ein Aktivitätenverlauf protokolliert Anforderungen, Uploads, Prüfungen und Änderungen.
Rollen & Rechte
Vier Rollen — Betrachter, Mitglied, Admin, Owner — steuern, wer was darf. Die Prüfung erfolgt serverseitig.
Mandantenfähig
Jede Organisation hat getrennte Daten, ein eigenes Team und eigene Einstellungen.

Schnellstart

In fünf Schritten vom neuen Konto zum ersten geprüften Nachweis.

Registrieren oder anmelden
Unter „Konto erstellen“ Unternehmen, Namen, E-Mail und Passwort (mind. 8 Zeichen) angeben. Neue Konten starten im Ansichtsmodus, bis ein Paket freigeschaltet ist.
SMTP hinterlegen
Unter „E-Mail (SMTP)“ Server, Zugangsdaten und Absenderadresse eintragen und die Test-E-Mail senden. Ohne SMTP werden keine Mails an Lieferanten verschickt.
Anforderungen definieren
Unter „Anforderungen“ die benötigten Nachweise anlegen, z. B. „Betriebshaftpflicht“ mit 12 Monaten Standardgültigkeit.
Lieferanten anlegen & zuweisen
Unter „Lieferanten“ einen Lieferanten mit E-Mail-Adresse anlegen und ihm Anforderungen zuweisen.
Anfordern und prüfen
Nachweise anfordern. Sobald der Lieferant hochgeladen hat, erscheint der Upload im Dashboard unter „Zur Prüfung“.
Step -1 of 0
Tipp
Beginnen Sie mit zwei bis drei Anforderungen und einem Lieferanten. Erweitern Sie den Katalog, sobald der Ablauf sitzt.

Die wichtigsten Begriffe

Lieferant
Ein Geschäftspartner mit Firmendaten, Kategorie und Status (Onboarding, Aktiv, Handlungsbedarf, Inaktiv, Archiviert).
Anforderung (Typ)
Die Vorlage für einen Nachweis: Name, Kategorie, Standardgültigkeit in Monaten, „Ablaufdatum erforderlich“ und „Pflichtanforderung“.
Zugewiesene Anforderung
Ein Anforderungstyp, der einem konkreten Lieferanten zugewiesen wurde. Sie trägt den Status und das „Gültig bis“-Datum.
Dokument
Eine hochgeladene Datei (PDF, PNG oder JPG) mit Status: Zur Prüfung, Gültig, Abgelehnt oder Ersetzt.
Portal-Link
Ein geheimer Link, über den ein Lieferant ohne Konto seine Nachweise sieht und hochlädt. Er kann widerrufen werden.
Erfüllungsgrad
Anteil der Pflichtanforderungen eines Lieferanten, die gültig oder bald ablaufend sind — in Prozent.

So funktioniert es

Jeder Nachweis durchläuft denselben Kreislauf — vom Zuweisen bis zur Überwachung der Gültigkeit.

Zuweisen
Sie weisen einem Lieferanten Anforderungen zu. Ohne Dokument steht die Anforderung auf „Fehlt“.
Anfordern
„Anfordern“ verschickt eine E-Mail mit frischem Portal-Link; der Status wechselt auf „Angefordert“.
Hochladen
Der Lieferant lädt die Datei im Portal hoch. Bei PDFs wird das Ablaufdatum gesucht. Der Status ist „Zur Prüfung“, Ihr Standard-Ansprechpartner wird benachrichtigt.
Prüfen
Sie genehmigen (mit „Gültig bis“) oder lehnen ab (mit Begründung). Ein früheres Dokument wird dabei als „Ersetzt“ markiert.
Überwachen
Ab 30 Tagen vor Ablauf gilt „Läuft bald ab“, danach „Abgelaufen“ — dann fordern Sie erneut an.

Status einer Anforderung

FehltAngefordertZur PrüfungGültigLäuft bald abAbgelaufenAbgelehntNicht erforderlich
Zeitbasierte Status
„Läuft bald ab“ und „Abgelaufen“ werden aus dem Gültig-bis-Datum berechnet: bis 30 Tage vor Ablauf gilt „Läuft bald ab“, danach „Abgelaufen“.

Anmelden & Registrieren

Bestehende Nutzer melden sich mit E-Mail-Adresse und Passwort an; über „Passwort vergessen?“ lässt sich ein Zurücksetzen per E-Mail anstoßen. Neue Unternehmen legen sich über „Jetzt registrieren“ selbst an.

Anmeldung
Selbstregistrierung: Unternehmen, Name, E-Mail und Passwort (mindestens 8 Zeichen)
Ansichtsmodus nach der Registrierung
Neue Konten haben zunächst kein Paket. Sie können alles ansehen, aber noch nichts ändern, bis Ihr Paket freigeschaltet wurde.

Dashboard

Vier Kennzahlen — Lieferanten gesamt, Vollständig, Handlungsbedarf und Zur Prüfung — und darunter die Liste „Handlungsbedarf“. Sie nennt fehlende, bald ablaufende und abgelaufene Nachweise sowie neue Uploads, die auf Ihre Prüfung warten. „Ansehen“ öffnet den betroffenen Lieferanten.

Dashboard: Kennzahlen und Handlungsbedarf

Lieferanten

Die Liste zeigt Firma, Kategorie, Status und Ort. Sie lässt sich per Suche und über den Statusfilter (Aktiv, Alle, Handlungsbedarf, Archiviert) eingrenzen. Ein Klick auf eine Zeile öffnet den Lieferanten.

Lieferantenliste mit Suche und Statusfilter
OnboardingAktivHandlungsbedarfInaktivArchiviert

Lieferant anlegen

Über „Lieferant anlegen“ genügen Firmenname, optional E-Mail-Adresse und Stadt. Die E-Mail-Adresse wird für Anfragen und Erinnerungen benötigt. Weitere Angaben — Rechtsform, Lieferantennummer, Telefon, Website, Adresse, Kategorie, Risikostufe und Notizen — pflegen Sie über „Bearbeiten“.

Dialog „Lieferant anlegen“

Die Lieferantenseite

Oben stehen Name und der Erfüllungsgrad. Darunter finden Sie drei Bereiche:

  • Anforderungen — zuweisen, bearbeiten (Gültig bis, „Für diesen Lieferanten nicht erforderlich“), löschen. Je nach Status erscheinen „Anfordern“, „Erinnerung senden“ oder „Über Prüfung benachrichtigen“.
  • Dokumente — Vorschau, Download, Löschen und „Prüfen“ für neue Uploads.
  • Lieferantenportal — sicheren Upload-Link erstellen und kopieren.

Über das Menü neben „Bearbeiten“ lässt sich der Lieferant archivieren, reaktivieren oder löschen.

Lieferantenseite: Anforderungen, Dokumente und Portal
Dokument prüfen
Beim Genehmigen tragen Sie das Ablaufdatum ein; beim Ablehnen ist ein Grund vorgesehen. Wurde das Datum beim Upload automatisch erkannt, sehen Sie den Hinweis „auto.“ bzw. „automatisch erkannt“.

Anforderungen

Der Katalog Ihrer Nachweistypen. Jeder Typ hat einen Namen, eine Kategorie und eine Standardgültigkeit; über den Schalter aktivieren oder deaktivieren Sie ihn. Beim Anlegen legen Sie außerdem fest, ob ein Ablaufdatum erforderlich und die Anforderung Pflicht ist. Für die Pflege ist die Rolle Admin nötig.

Anforderungskatalog

Dokumente

Alle hochgeladenen Nachweise über alle Lieferanten, filterbar nach „Zur Prüfung“, „Gültig“ und „Abgelehnt“. Sie sehen Lieferant, Status, Gültigkeit („auto.“ = automatisch erkannt) und Uploaddatum; Vorschau und Download sind direkt erreichbar.

Dokumentenübersicht

Aktivitäten

Ein chronologischer Verlauf wichtiger Vorgänge: Lieferant angelegt oder geändert, Anforderung zugewiesen oder angefordert, Erinnerung gesendet, Dokument hochgeladen (auch über das Portal), genehmigt oder abgelehnt, Portal-Link erstellt oder widerrufen, Benutzer eingeladen. Angezeigt werden Aktion, Verursacher und Zeitpunkt.

Aktivitätenverlauf

Lieferantenportal

Das Portal ist die Seite, die Ihre Lieferanten sehen — ohne Login, nur über den geheimen Link. Es zeigt alle Anforderungen des Lieferanten mit Status und, wo nötig, dem Button „Dokument hochladen“.

Portal aus Sicht des Lieferanten

Der Lieferant wählt eine Datei (PDF, PNG oder JPG, bis 15 MB) oder zieht sie in das Feld. Die Anforderung wechselt auf „Zur Prüfung“ und der Standard-Ansprechpartner Ihrer Organisation erhält eine Benachrichtigung.

Einstellungen

Die Einstellungen finden Sie in der Seitenleiste unter „Unternehmen“, „Team“, „E-Mail (SMTP)“ und „Tarif“.

Unternehmen: Firmendaten und Standard-Ansprechpartner
E-Mail (SMTP): Server, Absender und Signatur
Tarif: Paket und Auslastung

Integration & API

LyveVendor stellt keine getrennte Programmier-Schnittstelle mit API-Keys bereit. Es gibt zwei Arten von Zugängen: das öffentliche Portal per Token — geeignet, um Uploads aus eigenen Systemen anzustoßen — und die Routen der Oberfläche, die eine Anmeldesitzung (Cookie) voraussetzen.

Portal: Anforderungen lesen

curl https://DEINE-INSTANZ/api/portal/<PORTAL_TOKEN>
{
  "organizationName": "Musterbau GmbH",
  "supplierName": "Hoffmann Trockenbau GmbH",
  "requirements": [
    {
      "id": "<ANFORDERUNGS_ID>",
      "status": "missing",
      "dueDate": null,
      "name": "Betriebshaftpflicht",
      "description": "",
      "requiresExpiryDate": true
    }
  ]
}

Portal: Dokument hochladen

multipart/form-data mit file, requirementId und optional validUntil (JJJJ-MM-TT). Ohne validUntil wird bei PDFs das Ablaufdatum automatisch gesucht.

curl -X POST https://DEINE-INSTANZ/api/portal/<PORTAL_TOKEN>/upload \
  -F "file=@haftpflicht.pdf;type=application/pdf" \
  -F "requirementId=<ANFORDERUNGS_ID>" \
  -F "validUntil=2027-04-09"
{
  "success": true,
  "detectedValidUntil": null
}

Mit Sitzung: eigene Daten abrufen

Die Anmeldung setzt ein Sitzungs-Cookie, das Sie bei weiteren Aufrufen mitsenden. Der Zugriff folgt den Rollen der Organisation.

# Anmelden und Sitzungs-Cookie speichern
curl -c cookies.txt -X POST https://DEINE-INSTANZ/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{ "email": "du@firma.de", "password": "<PASSWORT>" }'

# Eigene Organisationen und Rolle abrufen
curl -b cookies.txt https://DEINE-INSTANZ/api/me

# Lieferanten einer Organisation auflisten
curl -b cookies.txt "https://DEINE-INSTANZ/api/app/orgs/<ORG_ID>/suppliers?status=active"
{
  "userId": "<USER_ID>",
  "email": "du@firma.de",
  "platformRole": null,
  "organizations": [
    { "organizationId": "<ORG_ID>", "role": "owner", "name": "Musterbau GmbH", "slug": "musterbau", "status": "active" }
  ]
}

Fehlercodes

Code Bedeutung
400Ungültige Eingabe, z. B. nicht erlaubter Dateityp oder Datei größer als 15 MB.
401E-Mail-Adresse oder Passwort falsch bzw. keine gültige Sitzung.
402Paketlimit erreicht, Funktion nicht im Paket enthalten oder Konto im Ansichtsmodus.
403Keine Berechtigung für diese Aktion oder kein Zugriff auf die Organisation.
404Portal-Link ungültig, abgelaufen oder widerrufen — bzw. Objekt nicht gefunden.
422Ablaufdatum konnte nicht erkannt werden (Antwort enthält den Code EXPIRY_DATE_REQUIRED) — validUntil mitsenden.
429Zu viele Uploads über das Portal (20 je 10 Minuten und IP-Adresse).

Ideen & Use Cases

Beispiele, wie sich typische Nachweise mit den vorhandenen Bausteinen abbilden lassen. Die Werte sind Vorschläge — passen Sie sie an Ihre Anforderungen an.

🛡️ Betriebshaftpflicht
Quelle: Kategorie „Versicherung“, Nachweis vom Lieferanten
Felder: Ablaufdatum erforderlich: ja · Standardgültigkeit: 12 Monate · Pflichtanforderung
Regel: 30 Tage vor Ablauf springt der Status auf „Läuft bald ab“ → „Erinnerung senden“
Kein Subunternehmer arbeitet mehr mit abgelaufenem Versicherungsschutz.
🏅 Zertifikate (ISO 9001)
Quelle: Kategorie „Zertifikat“
Felder: Ablaufdatum erforderlich: ja · Standardgültigkeit: 36 Monate
Regel: Nach Ablauf → „Anfordern“ verschickt die Bitte um das neue Zertifikat
Qualitätsnachweise bleiben aktuell, ohne Excel-Liste.
🧾 Freistellungsbescheinigung
Quelle: Kategorie „Steuer“
Felder: Ablaufdatum erforderlich: ja · Standardgültigkeit: 12 Monate
Regel: Upload prüfen → bei Mangel „Ablehnen“ mit Begründung, Lieferant lädt neu hoch
Nachvollziehbarer Prüfprozess mit Ablehnungsgrund.
📄 Gewerbeanmeldung
Quelle: Kategorie „Nachweis“
Felder: Ablaufdatum erforderlich: nein · Pflichtanforderung
Regel: Einmal prüfen und freigeben — kein Ablauf, der überwacht werden müsste
Einmalige Nachweise verstopfen den Handlungsbedarf nicht.
🚚 Logistik-Partner onboarden
Quelle: Lieferantenkategorie „Logistik“, Status „Onboarding“
Felder: Mehrere Anforderungen auf einmal zuweisen, Portal-Link an den Lieferanten
Regel: Sind alle Pflichtanforderungen gültig, steht der Erfüllungsgrad bei 100 %
Neue Partner sind schnell einsatzbereit, der Stand ist jederzeit sichtbar.
🔍 Wöchentlicher Blick aufs Dashboard
Quelle: Dashboard „Handlungsbedarf“
Felder: Fehlt · Läuft bald ab · Abgelaufen · Zur Prüfung
Regel: Jeden Eintrag über „Ansehen“ öffnen und direkt „Anfordern“ oder „Erinnerung senden“
Ein fester Rhythmus statt hektischer Suche vor dem Audit.

Rollen & Rechte

Jede Rolle enthält die Rechte der darunterliegenden. Der Server prüft die Berechtigung bei jeder Aktion; ausgeblendete Buttons sind nur eine Komfortfunktion.

Rolle Rechte
BetrachterDashboard, Lieferanten, Anforderungen und Dokumente ansehen; Dokumente in der Vorschau öffnen und herunterladen.
MitgliedZusätzlich: Lieferanten anlegen und bearbeiten, Anforderungen zuweisen und bearbeiten, anfordern und erinnern, Dokumente prüfen (genehmigen/ablehnen), Portal-Links erstellen und widerrufen, Aktivitäten einsehen.
AdminZusätzlich: Anforderungstypen anlegen und ändern, Lieferanten archivieren, reaktivieren und löschen, Dokumente und zugewiesene Anforderungen löschen, Firmendaten, Team und SMTP verwalten.
OwnerAlle Rechte der Admin-Rolle innerhalb der Organisation.

Pakete & Limits

Das Paket begrenzt die Zahl der aktiven Lieferanten und der Benutzer. Konten ohne Paket befinden sich im Ansichtsmodus: alles ansehen, nichts ändern. Für einzelne Organisationen können individuelle Limits vereinbart werden. Das Paket vergibt der Plattformbetreiber.

Paket Aktive Lieferanten Benutzer
Free52
Basic253
Pro1008
Business50020

FAQ & Fehlersuche

Bereit für Ihren ersten Lieferanten?

Melden Sie sich an und weisen Sie in wenigen Minuten die ersten Nachweise zu.