# Einbindungen (Integrations) # Webhook ## Einleitung Webhooks in ERPNext "...ermöglichen es, einer [Server](https://de.wikipedia.org/wiki/Server "Server")-Software mitzuteilen, dass ein bestimmtes [Ereignis](https://de.wikipedia.org/wiki/Ereignis_(Programmierung) "Ereignis (Programmierung)") eingetreten ist und eine Reaktion auf das Ereignis auszulösen. Wenn eine Anwendung über ein eingetretenes Ereignis mittels WebHook informiert, müssen an dem Ereignis interessierte andere Anwendungen kein [Polling](https://de.wikipedia.org/wiki/Polling_(Informatik) "Polling (Informatik)") betreiben, um von dem Ereignis Kenntnis zu erlangen. Das reduziert das Nachrichtenaufkommen zwischen den Anwendungen. " (quelle: [https://de.wikipedia.org/wiki/Webhooks](https://de.wikipedia.org/wiki/Webhooks)) ## Übersicht
## Felder ### Dokumentenereignise
**Bezeichnung** **Feldname** **Erklärung**
Nummernkreis naming\_series
DocType webhook\_doctype Verknüpfung zum DocType auf welchem der Webhook geschaltet werden soll.
Dokumentenereignis webhook\_docevent Folgende Auswahl steht uns zur Verfügung - nach\_einfügen - on
Aktiviert enabled Haken setzen um den Webhook scharf zu schalten.
### Webhook-Auslöser
**Bezeichnung** **Feldname** **Erklärung**
Zustand condition
### Webhook Anfrage
**Bezeichnung** **Feldname** **Erklärung**
URL anfordern request\_url Hier tragen wir die URL ein an welche die Aktion (request Method) des Webhooks gesendet werden soll. [Weitere Erklärungen](https://doku.phamos.eu/link/1918#bkmrk-url-anfordern)
Request Method request\_method Zur Auswahl stehen: - POST - PUT - DELETE
Struktur anfordern request\_structure Zur Auswahl stehen: - Formular URL-verschlüsselt - JSON
### Webhook-Sicherheit
**Bezeichnung** **Feldname** **Erklärung**
Sicherheit aktivieren enable\_security Häkchen um einzustellen, dass die URL eine Authentifizierung erfordert.
Webhook-Geheimnis webhook\_secret Dieses Pflichtfeld ist nur dann sichtbar, wenn enable\_security aktiviert ist. Hier tragen wir das erforderliche Kenntwort für die Authentifizierung an request\_url notwendig ist.
### Webhook Header ##### Headers
**Bezeichnung** **Feldname** **Erklärung**
Schlüssel key
Wert value
### Webhook Daten ##### Daten
**Bezeichnung** **Feldname** **Erklärung**
Feldname fieldname
Schlüssel key
## Erklärungen ### Webhook Anfrage ##### URL anfordern Zum testen kann z.B. die Seite [https://webhook.site](https://webhook.site) verwendet werden. Nutzt man diese Seite muss man ggf. eine Zeile aus der Datei `frappe/frappe/integrations/doctype/webhook/webhook.py` auskommentieren, damit wir ein Feedback in [Webhook Request Log](https://doku.phamos.eu/books/erpnext-benutzerhandbuch/page/webhook-request-log "Webhook Request Log") finden. Andernfalls sehen wir nur eine Meldung im [Error Log](https://doku.phamos.eu/books/erpnext-benutzerhandbuch/page/fehlerprotokoll-error-log "Fehlerprotokoll (Error Log)"). [![image-1683659890373.png](https://doku.phamos.eu/uploads/images/gallery/2023-05/scaled-1680-/image-1683659890373.png)](https://doku.phamos.eu/uploads/images/gallery/2023-05/image-1683659890373.png) ## Logging und Debugging ### Webhook Request Log Hier können wir die Ergebnisse der Webhook-Aufrufe einsehen. ### Fehlerprotokoll Nicht alles wird im Webhook Request Log angezeigt. Weiteres logging passiert im [Fehlerprotokoll](https://doku.phamos.eu/books/erpnext-benutzerhandbuch/page/fehlerprotokoll-error-log "Fehlerprotokoll (Error Log)") des Systems. # Webhook Request Log ## Einleitung [![image-1682189877820.png](https://doku.phamos.eu/uploads/images/gallery/2023-04/scaled-1680-/image-1682189877820.png)](https://doku.phamos.eu/uploads/images/gallery/2023-04/image-1682189877820.png) ## Felder
**Bezeichnung** **Feldname** **Erklärung**
User
Header
Data
URL
Response
## Erweitertes Logging Im Webhook Request Log sehen wir nicht alle Informationen. Weitere Logs werden im [Fehlerprotokoll](https://doku.phamos.eu/books/erpnext-benutzerhandbuch/page/fehlerprotokoll-error-log "Fehlerprotokoll (Error Log)") geschrieben.