Configurez et utilisez l'intégration Morning.co (Green Invoice) avec Guesty. Cette intégration automatise la création de factures provisoires en synchronisant les données de réservation Guesty directement avec un compte Morning.co.
Avant de commencer
Vous devez vous abonner à l'extension Guesty Connect avant de pouvoir connecter l'intégration :
- Connectez-vous à votre compte Guesty.
- Dans le menu de navigation latéral, cliquez sur
Intégrations pour ouvrir le menu déroulant. - Sélectionnez les modules complémentaires Guesty.
- Cliquez sur Guesty Connect.
- Cliquez sur « S'abonner ».
Connectez Guesty à Morning.co
Suivez les étapes ci-dessous pour connecter Morning.co à Guesty. Ce processus nécessite les informations d'authentification API de votre compte Morning.co pour établir une connexion sécurisée.
Pas à pas :
Dans Morning.co
Connectez-vous à votre compte Morning.co.
Créez une Application API dans Morning.co pour générer un « ID » et un « Secret ».
Copiez l'« ID » et le « Secret » depuis Morning.co.
À Guesty
- Connectez-vous à votre compte Guesty.
- Dans le menu de navigation latéral, cliquez sur
Intégrations pour ouvrir le menu déroulant. - Sélectionnez Marketplace.
- Dans la barre de recherche à gauche, saisissez « Morning.co », puis cliquez sur la vignette Morning.co.
- Dans le coin supérieur droit, cliquez sur Connecter.
- Retournez à la fenêtre contextuelle Guesty, collez l'« ID » et le « Secret » dans les champs correspondants, puis cliquez sur Connecter.
Gérer les champs personnalisés
Une fois l'intégration activée, Guesty crée automatiquement des champs personnalisés au niveau de la réservation. Ces champs contrôlent la logique d'automatisation et stockent les informations synchronisées depuis Morning.co.
morning_issue_invoice_ready: Définissez cette valeur sur TRUE pour déclencher le transfert des données vers Morning.co.
morning_guest_name_on_invoice: Veuillez saisir le nom du voyageur ou de l'entreprise exactement tel qu'il doit apparaître sur la facture. Ce champ est obligatoire.
morning_add_vat: Activez cette option pour les citoyens israéliens. Morning.co considère alors le total Guesty comme incluant la TVA et calcule le montant de la TVA à partir de ce total. Si vous désactivez cette option, le total est envoyé sans calcul de TVA.
morning_invoice_generated: L'intégration attribue la valeur VRAI à cette valeur une fois le brouillon créé. Ne modifiez pas ce champ manuellement.
morning_invoice_id: Ce champ se remplit automatiquement avec l'identifiant Morning.co après une synchronisation réussie.
morning_invoice_link_en / morning_invoice_link_he: Ces champs contiennent des liens directs vers les projets de factures en anglais ou en hébreu.
morning_invoice_generation_error : Si une synchronisation échoue, la raison spécifique de l'erreur apparaît ici pour la résolution de problèmes.
morning_invoice_date : Indiquez la date de génération de la facture. Morning.co ne permet pas de créer une facture antérieure à la date du dernier document du même type. Par exemple, si la dernière facture de taxe générée date du 3 mars, il s’agit de la date la plus proche pour laquelle vous pourrez générer une nouvelle facture de taxe via l’API.
Comprendre les fonctionnalités d'intégration
L'intégration de Morning.co simplifie le processus de facturation en garantissant l'exactitude des données entre les deux plateformes.
Création d'un brouillon : L'intégration crée systématiquement un « brouillon de facture » dans Morning.co pour un dernier avis avant émission.
Modes de Paiement : Morning.co reçoit automatiquement le mode de paiement utilisé pour la réservation Guesty.
Logique TVA : L'outil gère les exigences fiscales israéliennes, en extrayant la TVA des totaux tout compris lorsque cela est demandé.
Choisissez un flux de travail
Important:
N'activez qu'un seul flux de travail. L'activation simultanée des deux entraîne des problèmes de remplacement de données et des erreurs de doublons.
Sélectionnez l'un des deux flux de travail ci-dessous pour gérer la manière dont les données parviennent à Morning.co.
Utilisez le flux de travail non détaillé
Sélectionnez cette option si les règles de taxe sont déjà configurées dans Guesty. Ce processus envoie le total de la réservation sur une seule ligne à Morning.co et applique la TVA à ce total.
Utilisez le flux de travail détaillé
Sélectionnez cette option si les taxes ne sont pas gérées dans Guesty. Ce processus envoie les éléments de facturation individuels, tels que les tarifs d'hébergement et les frais de ménage, à Morning.co. L'intégration applique ensuite la taxe calculée à chaque élément.
Utilisez l'intégration
Après avoir activé votre stratégie de flux de travail préférée, l'automatisation se déclenche chaque fois que vous mettez à jour une réservation Guesty.
Pour générer la facture provisoire, assurez-vous que vos réservations sur Guesty répondent aux exigences suivantes :
Le statut de la réservation sur Guesty est
confirmed.morning_issue_invoice_readyest défini sur TRUE dans la réservation.morning_guest_name_on_invoicecontient du texte et n'est pas vide.morning_invoice_generatedest soit vide, soit défini sur FALSE afin d'éviter les factures en double.
Cartographie des paiements
L'intégration traite automatiquement les paiements de réservation ayant le statut SUCCEEDED et associe les identifiants de mode de paiement Guesty aux types de paiement correspondants de Morning.co, tels que carte de crédit, virement bancaire, espèces ou chèque.
Synchronisation post-génération
Une fois le projet de facture généré, l'intégration met automatiquement à jour les champs personnalisés de votre réservation Guesty :
morning_invoice_generatedpasse à TRUE.morning_invoice_idse remplit avec l'identifiant de facture officiel de Morning.co.morning_invoice_link_enetmorning_invoice_link_hese remplissent avec les URL des factures en anglais et en hébreu.morning_invoice_generation_errorse met à jour avec des alertes détaillées si une erreur se produit lors de la génération de la facture.