> ## Documentation Index
> Fetch the complete documentation index at: https://docs.procuros.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Wie verbindet man Weclapp mit Procuros

> Schritt-für-Schritt-Anleitung zur Einrichtung der technischen Verbindung zwischen Ihrem Weclapp und Procuros

## Einrichtung

Der *Procuros Weclapp Connector* muss Zugriff auf Ihr Weclapp-System erhalten, damit Procuros Ihre Geschäftsdokumente automatisch verarbeiten kann. Die folgenden Anweisungen helfen Ihnen, die korrekten Zugangsdaten zu erstellen und die notwendigen Konfigurationen vorzunehmen.

<Steps>
  <Step title="Weclapp-Einstellungen aufrufen">
    Klicken Sie auf Ihre Initialen in der oberen rechten Ecke, um auf die Weclapp-Einstellungen zuzugreifen.

    <img src="https://mintcdn.com/procuros-c35f505c/B4duGMjGkBbihGWc/images/API.jpg?fit=max&auto=format&n=B4duGMjGkBbihGWc&q=85&s=cc1c8c2a53fd9fd4ad5c7fc51bc2a168" alt="API Jp" width="1920" height="1080" data-path="images/API.jpg" />
  </Step>

  <Step title="Neuen API-Token erstellen">
    Erstellen Sie einen neuen API-Token für die Procuros-Integration.

    <img src="https://mintcdn.com/procuros-c35f505c/4hFaPIEgH1RhdRjV/images/apide2.jpg?fit=max&auto=format&n=4hFaPIEgH1RhdRjV&q=85&s=580094a81f7d27405e952264bed1d49c" alt="Apide2 Jp" width="2560" height="1440" data-path="images/apide2.jpg" />
  </Step>

  <Step title="API-Namen vergeben">
    Erstellen Sie einen neuen API-Namen, z.B. "Procuros".

    <img src="https://mintcdn.com/procuros-c35f505c/4hFaPIEgH1RhdRjV/images/api3.jpg?fit=max&auto=format&n=4hFaPIEgH1RhdRjV&q=85&s=89234d115a033f4e8c567bd97e25f3d3" alt="Api3 Jp" width="1920" height="1080" data-path="images/api3.jpg" />
  </Step>

  <Step title="API-Token speichern">
    Speichern Sie den neuen API-Token.

    <img src="https://mintcdn.com/procuros-c35f505c/4hFaPIEgH1RhdRjV/images/api4.jpg?fit=max&auto=format&n=4hFaPIEgH1RhdRjV&q=85&s=8e296d9e96c577393f38ba2e5046edef" alt="Api4 Jp" width="1920" height="1080" data-path="images/api4.jpg" />
  </Step>

  <Step title="Informationen an Procuros übermitteln">
    Stellen Sie Procuros folgende Informationen zur Verfügung (idealerweise über das Portal, alternativ über das Onboarding-Formular):

    * *Weclapp API-URL* → aus der Browserzeile kopieren
    * *Weclapp API-Name*
    * *Weclapp API-Token*
  </Step>
</Steps>

## Procuros-Freifeld einrichten

Die Standardeinstellung von Procuros ist, dass alle korrekt erstellten Dokumente an einen Handelspartner gesendet werden, mit dem Sie verbunden sind. Wenn Sie nur bestimmte Dokumente für eine Geschäftsbeziehung mit einem Handelspartner filtern/senden möchten, müssen Sie ein Freifeld konfigurieren.

<Steps>
  <Step title="Zu den Zusatzfeldern navigieren">
    Gehen Sie zu den Einstellungen (Zahnradsymbol) und klicken Sie auf "Zusatzfelder", dann auf "Zusatzfelder verwalten". Dies erfordert in der Regel einen Benutzer mit Administratorrechten.
  </Step>

  <Step title="Neues Zusatzfeld erstellen">
    Klicken Sie auf "+ Neues Zusatzfeld".
  </Step>

  <Step title="Einstellungen vornehmen">
    Geben Sie folgende Einstellungswerte vollständig ein und speichern Sie diese:

    * Bezeichnung: PROCUROS
    * Verknüpfte Entitäten (über "+ Neue Verknüpfung"): Angebot, Auftrag, Auftragsposition, Einkaufsbestellung, Eingangsrechnung, Kunde/Interessent, Lieferant, Lieferung, Rechnung, Wareneingang
    * Datentyp: Liste (Einzelauswahl)
    * Aktiv: ja
    * Auf Übersichtsseiten anzeigen: ja
    * Bei Neuanlage anzeigen: ja
    * Werte verwalten (über "+ Hinzufügen"): CUSTOMER
      * Aktiv: ja
  </Step>

  <Step title="Entity-ID notieren">
    Notieren Sie sich in derselben Ansicht ("Zusatzfelder verwalten") aus der Adresszeile des Browsers den Wert "entityID". Bitte teilen Sie diesen Wert Procuros mit.
  </Step>

  <Step title="Freifeld bei Handelspartnern eintragen">
    Tragen Sie für jeden Handelspartner/Kunden den Wert "Customer" in das gerade erstellte Procuros-Freifeld ein.
  </Step>
</Steps>

<Warning>
  Nur Handelspartner/Dokumente, die mit diesem Freifeld gekennzeichnet sind, werden dann vom Procuros Weclapp Connector abgeholt.
</Warning>

## Verbindung testen

Nach der Konfiguration der API-Zugangsdaten und dem Procuros-Freifeld sollte ein Verbindungstest durchgeführt werden:

1. Procuros richtet den Connector mit Ihren Zugangsdaten ein
2. Ein Testdokument wird erstellt, um die korrekte Übermittlung zu verifizieren
3. Nach erfolgreicher Prüfung werden Sie über die betriebsbereite Verbindung informiert

<Note>
  Stellen Sie sicher, dass alle erforderlichen Informationen korrekt an Procuros übermittelt wurden, um eine erfolgreiche Verbindung zu gewährleisten.
</Note>

## Fehlerbehandlung

Falls Probleme bei der Einrichtung auftreten:

<Accordion title="Häufige Einrichtungsprobleme">
  1. **API-Zugriffsrechte**: Stellen Sie sicher, dass der erstellte Token ausreichende Rechte besitzt
  2. **Freifeld-Konfiguration**: Überprüfen Sie, ob das Procuros-Freifeld korrekt eingerichtet und den Handelspartnern zugewiesen wurde
  3. **Weclapp-Version**: Bestätigen Sie, dass Ihre Weclapp-Version mit dem Connector kompatibel ist
</Accordion>

Falls Probleme auftreten, wenden Sie sich an das Procuros-Support-Team unter [help@procuros.io](mailto:help@procuros.io) mit einer detaillierten Beschreibung des Problems.