domoConnect, Konnektor für DOMUS und DocuWare

Voraussetzungen und Einrichtung

Ganz gleich, ob Sie DocuWare bereits einsetzen oder DocuWare zusätzlich für Ihre Prozesse nutzen möchten: Die Einrichtung folgt klaren Schritten. Bei bestehenden DocuWare-Installationen sind meist nur geringe Änderungen notwendig.

Voraussetzungen im DocuWare-Archiv

Im DocuWare-Archiv müssen bestimmte Felder vorhanden sein. Eine Mapping-Tabelle ordnet die Kopfdaten (Header) sowie die Tabellenfelder der Kontierungstabelle den passenden Feldern in DOMUS zu. Die konkrete Feldzuordnung stimmen wir im gemeinsamen Onboarding auf Ihr Archiv ab, da die Feldbezeichnungen je Installation abweichen können.

Einrichtung in 3 Schritten

01
Notwendige Felder im DocuWare-Archiv

Die erforderlichen Felder für Kopfdaten und für die Tabellenfelder der Kontierungstabelle werden im Archiv angelegt und gemäß Mapping-Tabelle zugeordnet.
02
DocuWare Webservice und Webhook registrieren

Webservice und Webhook in DocuWare registrieren. Der Webhook ist der Auslöser, der die Übergabe an DOMUS anstößt.
03
Anbindung an DOMUS

Die Übergabe an DOMUS konfigurieren. Die Detailschritte erhalten Sie im Onboarding-Leitfaden von domoforce.

Auslöser für die Übergabe an DOMUS

In DocuWare legen Sie fest, welches Feld welchen Wert erreichen muss, damit ein Dokument an DOMUS übergeben wird. Die Werte stimmen Sie flexibel auf Ihre fluks-Konfiguration ab. Ein typisches Beispiel:

Auslöser-Feld erreicht den vereinbarten Wert (z. B. Dokumententyp = „Rechnung (eingehend)")
Statusfeld erreicht den vereinbarten Wert (z. B. Status = „Export an DOMUS")
Aktivitäten- oder Objektnummer ist ausgefüllt

REST-API-Alternative

Systeme ohne DocuWare können Dokumente auch direkt über die generische REST-Schnittstelle an DOMUS übergeben. Alle Felder außer den als optional gekennzeichneten müssen aus der aufrufenden Applikation befüllt werden.

Methode: POST
Endpoint: https://domoforce-docuware.azure-api.net/document?api-key=<Ihr API-Key>&connector=generic
Auth: Basic Auth. Benutzer domoforce, Passwort = Ihr Lizenzschlüssel aus der Registrierungsemail.
Header: Content-Type: application/json

Hinweis: Der API-Key ist ein Zugangsschlüssel und wird Ihnen von domoforce bereitgestellt. Bitte nicht öffentlich teilen.

Pflichtfelder

DOC_URL: URL des Dokuments.
DOC_ID: Wird in DOMUS als „Dokument - [ID].url" angezeigt.
DOC_TYPE: Dokumententyp, passend zu den Einträgen in fluks.
DOMUS_AKTIVITAT_ID oder DOMUS_OBJEKT: Eines von beiden ist erforderlich.
RECHNUNGS_NR: Rechnungsnummer.
RECHNUNGS_DATUM: Rechnungsdatum.
BRUTTOBETRAG: Bruttobetrag der Rechnung.
KREDITOR: Kreditor.
KUNDENNUMMER: Kundennummer.

Optionale Felder

LIEFERDATUM: Lieferdatum.
VORGANGSNUMMER: Vorgangsnummer.
DOMUS_BUCHUNGSTEXT2: Zusätzlicher Buchungstext.
DOMUS_MANDANT: Mandant in DOMUS.
DOMUS_KREIS: Kreis in DOMUS.

POSITIONEN (Array, mindestens ein Eintrag)

Jede Position enthält die folgenden Pflichtfelder:

MENGE
POSITIONSTEXT1
KONTO
EINZELPREIS
GESAMTPREIS
BRUTTOBETRAG
NETTOBETRAG
UMSATZSTEUERBETRAG
UMSATZSTEUERSATZ
ARBEITSLEISTUNGSGRUPPE
ARBEITSLEISTUNGSBETRAG
STEUERSCHLÜSSEL

Beispiel-Request-Body

Illustratives Schema mit Platzhalterwerten.

{
  "DOC_URL": "https://.../rechnung.pdf",
  "DOC_ID": "12345",
  "DOC_TYPE": "Rechnung (eingehend)",
  "DOMUS_AKTIVITAT_ID": "987654",
  "RECHNUNGS_NR": "RE-2026-0001",
  "RECHNUNGS_DATUM": "2026-07-01",
  "BRUTTOBETRAG": "1190.00",
  "KREDITOR": "70001",
  "KUNDENNUMMER": "10001",
  "LIEFERDATUM": "2026-06-28",
  "VORGANGSNUMMER": "V-2026-0001",
  "POSITIONEN": [
    {
      "MENGE": "1",
      "POSITIONSTEXT1": "Wartung Heizungsanlage",
      "KONTO": "4260",
      "EINZELPREIS": "1000.00",
      "GESAMTPREIS": "1000.00",
      "BRUTTOBETRAG": "1190.00",
      "NETTOBETRAG": "1000.00",
      "UMSATZSTEUERBETRAG": "190.00",
      "UMSATZSTEUERSATZ": "19",
      "ARBEITSLEISTUNGSGRUPPE": "",
      "ARBEITSLEISTUNGSBETRAG": "",
      "STEUERSCHLÜSSEL": "9"
    }
  ]
}

Bereit für die Einrichtung?

Wir richten domoConnect gemeinsam mit Ihnen ein.

domoConnect bestellen Zur Produktseite

domopay