> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.winesitting.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Configurer les notifications automatiques — webhooks

Un webhook permet à votre outil de recevoir une notification lorsqu’une opération évolue chez WineSitting. Votre prestataire prépare l’adresse de réception et le traitement des messages.

Nous recommandons de vérifier régulièrement les données via l’API, même si vous utilisez des webhooks. Ceux-ci complètent ce suivi ; ils ne doivent pas être votre seul moyen de synchronisation.

## Préparer l’URL de réception

L’URL doit être accessible depuis WineSitting et accepter les notifications envoyées en JSON par requête HTTP POST. Faites préparer cette adresse par la personne qui gère votre intégration.

## Enregistrer la notification

1. Cliquez sur votre nom, puis sur **API REST**.
2. Ouvrez l’action de création d’un webhook.
3. Renseignez l’URL de réception et un commentaire permettant d’identifier l’usage.
4. Enregistrez, puis vérifiez l’URL dans la liste.

Les webhooks sont indépendants des clés API. Si vous supprimez une clé, vérifiez aussi les URL de webhook enregistrées.

## Informations transmises

Les événements concernent notamment la création d’une entrée en stock ainsi que la création et les mises à jour d’une demande de sortie. Le message précise le type de ressource, l’opération, la ressource concernée et la date.

Votre outil doit répondre rapidement et reconnaître les notifications déjà traitées pour éviter les doublons. Le détail technique et les valeurs attendues figurent dans la [documentation API](https://app.winesitting.com/api/documentation).

## Vérifier le fonctionnement

Avec votre prestataire, contrôlez la réception d’un événement prévu et les journaux du serveur destinataire. Si la réception échoue, transmettez-nous la date, l’opération et l’erreur observée, sans joindre de secret.