Réserver une démo Documentation DataCollect 1.0
À propos de ce document – Cliquez ici
Informations de contact – Cliquez ici
Gestion des erreurs – Cliquez ici
Historique des modifications – Cliquez ici
À propos de ce document
Ce document fournit une vue d’ensemble complète de l’API DataCollect et de la manière dont les données peuvent être intégrées dans Verarca.
Il offre des lignes directrices pour commencer à importer des données et comment suivre ce processus.
Il est essentiel de lire l’intégralité du document et d’envoyer vos éventuelles questions à l’avance à rene@verarca.com avant de commencer l’intégration.
Informations de contact
Contactez les adresses suivantes si vous avez des questions :
Support technique : rene@verarca.com
Autres questions : contact@verarca.com
Introduction
La première intégration avec notre API se fait via un compte sur Verarca.com. Pour obtenir un compte de test, veuillez contacter rene@verarca.com.
L’API DataCollect se compose de deux environnements : staging et production, accessibles via les endpoints suivants :
Staging : https://staging.datacollect.verarca.com/swagger
Production : https://datacollect.verarca.com/swagger
Les deux environnements appliquent différents contrôles de sécurité pour garantir la stabilité. L’un d’eux est la limitation du débit (rate limiting). En cas de problème, contactez le support technique.
L’API utilise la gestion des versions. Il est fortement recommandé d’utiliser les versions des endpoints pour minimiser les perturbations. La version est visible dans la documentation Swagger.
Les chapitres suivants décrivent le flux de travail pour importer des données dans DataCollect dans des régions de données spécifiques.
Comptabilité
Les données de base de Verarca proviennent des systèmes ERP/comptables pour calculer le CO2 à partir de différents achats/factures.
Le flux de travail suivant doit toujours être respecté :
1. Le client reçoit un jeton de Verarca.com.
2. Le client saisit ce jeton ou le transmet à l’application cliente (partenaire d’intégration).
3. Lors de la saisie du jeton dans l’application cliente, celle-ci doit transmettre une vue d’ensemble complète du plan comptable.
4. Après l’envoi du plan comptable à DataCollect, le client doit cocher les comptes pertinents dans Verarca.com.
– Cela permet de ne traiter que les données liées au CO2.
5. Quotidiennement, l’application cliente doit soumettre les données suivantes à DataCollect :
-
- Récupérer les comptes cochés dans Verarca.com. Endpoint : /api/Accounts/Enabled
- Créer/mettre à jour le plan comptable : /api/Accounts
- Créer/mettre à jour les écritures comptables : /api/AccountEntries
- Lier/téléverser des documents aux écritures : /api/Documents
Lors de la première synchronisation, les données de l’année en cours + l’année précédente doivent toujours être fournies. Chaque jour, toutes les mises à jour/nouvelles données doivent être soumises.
Lors de la soumission des écritures, le type d’écriture doit être indiqué via le paramètre “type”. DataCollect prend en charge les formats suivants :
Supplier = Facture fournisseur
Payment = Paiement à un fournisseur
Credit = Note de crédit fournisseur
Gestion des erreurs
En cas de problème avec l’API DataCollect, celle-ci renvoie un résultat JSON comme ci-dessous :
En cas de question, contactez le support technique et mentionnez l’errorId pour un traitement plus rapide.
Historique des modifications
| Date | Modifications | Type |
