Exemple : Exporter les factures à l'aide de Process Automator

Dans cet exemple, vous allez : 

• Créez un processus pour envoyer des factures à un système tiers à l'aide d'un appel d'API une fois approuvé. Pour plus d'informations, voir Call Outs. 
• Définissez et appliquez un mappage de données pour vous assurer que les données envoyées peuvent être traitées par le tiers. Les mappages de données transforment la charge utile de l'appel API du format standard de Coupa au format attendu par le système cible, réduisant ainsi le besoin d'intergiciels tiers.
• Traiter la réponse de l'appel API à l'aide des variables de réponse d'appel API. Les variables de réponse vous permettent de traiter la réponse d'un appel API et d'utiliser les valeurs dans les étapes ultérieures. 
• Définissez les champs de l'enregistrement de facture une fois l'appel API terminé avec succès. 
• Gérez les erreurs en réessayant les appels infructueux et en surveillant les progrès à l'aide du Centre de contrôle de l'intégration.

Procédure

1. Créer un processus selon Créer un processus à l'aide de Process Automator.
2. Définir le processus de lancement sur l'événement Document et définir le document sur Facture. 
3. Définissez le processus de déclenchement sur Approbation. Cela déclenche le processus chaque fois qu'une facture est approuvée.
4. Ajoutez l'étape 1 pour envoyer un appel d'API à un système tiers et traiter la réponse. 

   Champ	Valeur
   Objet	Sélectionnez Trigger.Invoice pour appliquer l'action au document de déclenchement.
   Action	Sélectionnez Appel API pour envoyer un appel API à un système tiers chaque fois qu'une facture est approuvée.
   Appel	Sélectionnez un appel qui comprend des informations sur le point de terminaison tiers auquel vous souhaitez envoyer les informations de facture. Voir les appels téléphoniques.
   Mappage de données	Facultatif. Sélectionnez un mappage de données qui mappe les données de Coupa Invoice au modèle de données dans votre système tiers. Voir Mappage des données.
   Filtre API	Facultatif. Appliquez un filtre pour déterminer les champs de facture à inclure dans votre appel. Voir Filtres de réponse API.
   Variables de réponse d'appel d'API	Facultatif. Créer une variable pour contenir la valeur d'un élément de la réponse d'appel de l'API système tierce. Dans cet exemple, vous pouvez définir une variable ID pour contenir un élément ID. Vous devez inspecter la réponse de l'appel API pour déterminer le chemin exact. Par exemple, l'ID de facture peut être configuré en tant que/invoice/record_id.
   Conditions	Facultatif. Ajoutez des conditions pour restreindre davantage les factures approuvées qui devraient déclencher le processus.

5. Ajoutez l'étape 2 pour définir un champ dans l'enregistrement de la facture qui inclut l'ID du système tiers. Cet ID est contenu dans la variable créée à l'étape 1 Variables de réponse d'appel d'API.

   Champ	Valeur
   Objet	Sélectionnez Trigger.Invoice pour appliquer l'action au document de déclenchement.
   Action	Sélectionnez Définir le champ pour définir une valeur de champ sur l'objet Invoice.
   Type de champ	Sélectionnez Standard ou Personnalisé en fonction du champ à définir. Dans cet exemple, vous pouvez ajouter un champ personnalisé à l'objet Invoice appelé ID d'enregistrement ERP.
   Nom de champ	Sélectionnez le champ standard ou personnalisé à définir.
   Utilisez les variables de réponse	Sélectionnez Oui.
   Valeur du champ	Sélectionnez la variable de réponse que vous avez créée à l'étape 1. Par exemple, si vous avez nommé la variable de réponse ID de facture, vous devez sélectionner Étape 1.ID de facture.

6. Ajoutez l'étape 3 pour définir un champ dans l'enregistrement de facture indiquant que l'objet a été exporté afin de vous assurer que vous n'exportez pas les données de manière redondante dans vos autres systèmes.

   Champ	Valeur
   Objet	Sélectionnez Trigger.Invoice pour appliquer l'action au document de déclenchement.
   Action	Sélectionnez Définir le champ pour définir une valeur de champ sur l'objet Invoice.
   Type de champ	Sélectionnez Standard ou Personnalisé en fonction du champ à définir. Dans cet exemple, vous pouvez ajouter un champ personnalisé à l'objet Invoice appelé Exported.
   Nom de champ	Sélectionnez le champ standard ou personnalisé à définir.
   Utilisez les variables de réponse	Sélectionnez Non.
   Valeur du champ	Sélectionner une valeur de champ appropriée. Par exemple, si vous avez ajouté un champ personnalisé booléen appelé Exporté, vous pouvez définir le champ sur vrai.

7. Consultez le Centre de contrôle de l'intégration pour gérer vos appels API et résoudre les problèmes. 
   1. Accédez au Centre de contrôle d'intégration pour voir l'état de votre appel d'API.