• Dernière modification le: 08 April 2020

Utilisation du format du fichier plat

Découvrez notre format de fichier plat et les conventions que nous utilisons.

Aperçu

Les modèles Common Flat File de Coupa sont conçus pour importer de nombreux enregistrements à partir d'un seul fichier envoyé à Coupa, et non pour traiter un volume élevé de fichiers contenant chacun un seul enregistrement. Pour les intégrations où un seul enregistrement doit être traité à la fois, l'API Coupa fournit une interface RESTful pour faciliter ce type de flux de travail.

Coupa nécessite des fichiers deltas ou des fichiers contenant uniquement des enregistrements qui ont été créés, modifiés ou doivent être mis à jour depuis la dernière fois que l'intégration a été exécutée. Un volume plus élevé, des charges de données non delta peuvent nécessiter un traitement en tant qu'intégration personnalisée. Veuillez discuter de cette exigence avec votre responsable de la mise en œuvre de Coupa pour déterminer si un délai ou un coût supplémentaire peut être nécessaire.

Avec les versions Coupa, lorsque nous introduisons de nouveaux objets ou de nouveaux attributs, il est possible que nous ajoutions de nouveaux champs à nos formats de fichiers plats. Par conséquent, il est recommandé que vous en teniez compte lors de la conception des routines d'intégration de votre côté pour consommer les Coupa Flat Files.

Conventions CSV

Nos fichiers CSV d'intégration utilisent les conventions suivantes tirées de la RFC 4180.

  • Le délimiteur est une virgule :,
  • Tous les champs sont toujours du texte qualifié (inclus) avec le caractère de guillemet double : "
  • Les caractères de guillemets doubles dans un champ sont échappés par un autre caractère de guillemets doubles.  Si un utilisateur entre : Le statut est "Vert" dans un champ de commentaire, cela serait représenté par "Le statut est""Vert"""
  • Les caractères de nouvelle ligne peuvent être autorisés dans les valeurs de champ qualifiées.
  • Évitez d'utiliser des virgules, des deux-points (:) et des tirets (- tirets) dans les noms des groupes d'approbation, les noms des approbateurs et les noms d'invite des champs personnalisés. 

Text-Encoding : UTF-8 (sans marqueur d'ordre des octets (BOM))

Articles associés


API Coupa Core

Notre API RESTful fournit un accès fiable pour lire, modifier ou intégrer vos données à la plateforme Coupa.

Démarrez avec l'API

Informations générales sur l'utilisation de l'API Coupa et quand vous devez envisager d'utiliser CSV.

Transition vers OAuth 2.0 et OIDC

Coupa désapprouve les API Keys héritées et nécessite l'utilisation d'OAuth 2.0 / OIDC. À partir de R34, aucune nouvelle clé API ne sera émise et les clés API ne seront plus prises en charge avec R35.

Ressources

Nous avons organisé nos points de terminaison API par type d'objet : données de référence, données transactionnelles et ressources partagées.