# 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)").
[](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
[](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.