Que pouvons-nous faire pour vous ? Produits Plateforme Guides et ressources d'intégration Articles de connaissance Intégration Checklist Integration Design

Checklist Integration Design

Revised: 12 November 2021

Introduction

Ce document fournit une checklist standard qui doit être consultée par tout client ou partenaire procédant à des intégrations entre Coupa et tout autre système afin d'atteindre les objectifs suivants :

Assurez-vous que les intégrations sont conçues pour s'adapter à tous les scénarios de données possibles pouvant survenir lors de l'intégration des données saisies par l'utilisateur entre les systèmes
Veillez à ce que les intégrations soient conçues de manière flexible afin d’éviter que les changements de format dans tout système ne viennent perturber les intégrations

Intégrations CSV

Étape	Détails	Nécessite une approbation*
	Analyse par nom de colonne et non par position	Oui
	Uniquement les données incrémentielles/delta à envoyer à Coupa/objet et envoyer uniquement les données qui seront utilisées dans Coupa	Oui
	Seules les données incrémentielles/delta seront envoyées par Coupa et seront uniquement pour le statut final (Ex : Facture OKOTOPAY : Statut Approuvé ou Annulé)	Oui
	Aucun rapport planifié (vues personnalisées sur l'objet) ne doit être utilisé pour l'intégration automatisée, car Coupa ne les prend pas en charge en tant qu'intégration standard. Le rapport planifié, le cas échéant, doit avoir la condition de limiter la sortie des données (ex : exécution quotidienne pour la dernière mise à jour dans les 24 heures seulement)	Oui
	Les noms et les formats des champs sont configurables plutôt que codés en dur	Non
	Les fichiers CSV utilisent les conventions suivantes, extraites de la RFC 4180. Le délimiteur est une virgule : , All fields are always text qualified (enclosed) with the double quote character : " Les guillemets doubles d'un champ sont échappés par un autre guillemet double. If a user enters : Status is "Green" in a comment field, this would be represented as "Status is ""Green""" Les nouveaux caractères de ligne peuvent être autorisés dans les valeurs de champs qualifiés Encodage de texte : UTF-8 (sans marque d'ordre des octets (BOM))	Non
	Compatible avec tous les scénarios de texte saisis par l'utilisateur retours chariot et autres caractères spéciaux dans les champs de texte longueur de texte illimitée dans les champs de blocs de texte tronquer les valeurs de texte longues à la longueur du système cible Caractères multi-octets et considérations de longueur (si nécessaire)	Oui
	Le client doit supprimer les fichiers du répertoire sortant dans le sftp hébergé par Coupa	Oui
	Les flux delta réguliers entrants vers Coupa doivent être combinés dans un seul fichier et chaque mise à jour d'enregistrement delta dans le système source NE doit PAS être envoyée en tant que fichier unique. Exemple : Scénario 1 : Le fournisseur entrant vers coupa s'exécute une fois par jour 5 fournisseurs mis à jour en un jour Un fichier fournisseur doit être envoyé à Coupa à la fin de la journée et non 5 fichiers Scénario 2 : Le fournisseur entrant dans Coupa fonctionne 3 fois par jour (10 h / 16 h / 20 h) 10 Fournisseurs mis à jour en une journée (3 avant 10 h, 4 entre 10 h et 16 h et 3 entre 16 h et 20 h) 3 fichiers fournisseurs doivent être envoyés à Coupa et chaque fichier contiendra 3 ou 4 ou 3 enregistrements à 10h, 16h et 20h respectivement	Oui
	Pour les données d'intégration CSV entrantes et sortantes, mappez uniquement les champs requis par Coupa et requis pour le processus métier Coupa.	Non
	Validez toujours la présence d'éléments dans le fichier XML/JSON avant de récupérer la valeur car la structure de la charge utile Coupa peut changer à l'avenir pour ne pas afficher certains champs qui n'ont pas de valeurs ou qui ont des valeurs nulles.	Oui

* L'approbation du client/partenaire est requise avant le développement et doit faire partie du ticket MTP

Intégrations API

Étape	Détails	Nécessite une approbation*
	Ne pas exporter ou importer des données en vrac	Oui
	Sans validation XSD stricte	Oui
	Uniquement les données incrémentielles/delta à envoyer à Coupa/objet et envoyer uniquement les données qui seraient utilisées dans Coupa	Oui
	Tous les appels API DOIVENT faire partie de l'IRD et doivent être partagés avec Coupa Integration Architect et approuvés par lui	Oui
	Validez la présence d'éléments dans le fichier XML/JSON avant de récupérer la valeur car la structure de la charge utile Coupa peut changer à l'avenir pour ne pas afficher certains champs qui n'ont pas de valeurs ou qui ont des valeurs nulles.	Oui
	Échapper/débloquer les caractères xml spéciaux	Non
	Pagination en place pour les appels GET qui peuvent dépasser 50 enregistrements	Non
	Traitement des erreurs en place pour les appels PUT/POST	Non
	Pour les données d'intégration API entrantes et sortantes, mappez uniquement les champs requis par Coupa et requis pour le processus métier Coupa	Non
	Utiliser les filtres API/ options peu profondes/ limitées pour des performances API optimales	Non

Veuillez noter que certaines parties de ce contenu peuvent avoir été générées par traduction automatique.