Fonctionnement

Le connecteur de sortie Isacompta permet de récupérer régulièrement l'ensemble des écritures comptables validées. Le connecteur met également a disposition les fichiers images permettent d'accéder aux pieces jointes depuis Isacompta.

Les écritures au format .ECR ainsi que les pieces jointes sont regroupées dans un fichier zip. Un fichier zip est généré à chaque période (par exemple chaque heure) sauf si aucune nouvelle facture n'est validée. Ce fichier est accessible par un API permettant d'automatiser facilement la récupération de ce fichier et son intégration dans Isacompta. Il est également disponible pendant quelques jours dans l'interface graphique, au niveau de la configuration du connecteur.

Déclenchement de l'extraction

2 modes d'extraction sont possibles :

  • Manuellement : L'extraction est déclenchée à la demande (manuellement) directement par un bouton d'extraction sur le connecteur. Au moment du déclenchement, l'ensemble des factures au statut de connecteur "En cours" sont extraites.

  • Automatiquement : A intervalle régulier, l'ensemble des factures au statut de connecteur "En cours" sont extraites.

Configuration

Sécurité

Il est obligatoire d'utiliser la clé d'API afin d'authentifier les requêtes faites à Conciliator

Mise en oeuvre de l'API

Code de retour

  • 200 OK: le fichier est transféré et aucun autre fichier n'est disponible

  • 206 Partial Content: le fichier le plus ancien est transféré mais d'autres fichiers sont encore disponibles

  • 403 Forbidden: le token n'est pas valide

Le nom du fichier ZIP est donné dans le header HTTP

Récupération sur erreur : le fichier reste disponible pour récupération par l'API si le transfert est interrompu, avec la commande :

curl -OJH "Authorization: Bearer azerty123" <https://app.invoice.conciliator.ai/api/v0/isacompta>

Exemple complet de commande en Bash (Unix)

**#!/bin/bash**
BEARER=azerty123
URL=https://app.invoice.conciliator.ai/api/v0/isacompta
http_code=0
**until** [ $http_code -**eq** 200 ]; **do**
http_code=$(curl -w "%{http_code}" -OJH "Authorization: Bearer $BEARER" $URL 2> /dev/null)
**if** [ $http_code -**ge** 300 ]; **then**
echo "Authentication or Server issue: $http_code" 1>&2
exit 1
**fi
done**

Nommage des fichiers de sortie

Les noms des fichiers de sortie sont configurables. 

Fichier ZIP

Chaque extraction génère UN dossier compressé au format zip contenant UN ou PLUSIEURS fichiers d'écritures comptables et l'ensemble des factures de ce fichier au format PDF.

Le nom du dossier compressé est au format : conciliator-isacompta-aaaa-mm-dd-hh-mm-ss.zip. Exemple :

conciliator-isacompta-2019-05-20-16-09-59.zip

Fichier d'écriture comptable

Par défaut, les fichiers d'écriture comptable sont situé dans le sous-répertoire "ecr" qui contient toutes les fichiers d'écritures de l'export.

Le nom du fichier par défaut est au format :  ecr/${client_identifier}-Conciliator-${id}.ecr.

Exemple :

ecr/5721-Conciliator-00028b62-ed68-4d87-bfaa-a230a4e3790b.ecr

Le nom du fichier est paramétrable dans la configuration du connecteur. Les paternes utilisables pour le nommage du fichier sont les suivants:

${client_identifier}, ${id}, ${type_activity}, ${supplier_name}, ${inside_name}, ${pdf_name}, ${fisc_end}.

Fichier PDF

Par défaut, les facture au format PDF sont situées dans le sous-répertoire correspondant à la date de fin d'exercice de la facture du sous-répertoire correspondant à son code dossier du sous-répertoire pdf.

Les noms des factures PDF par défaut sont au format :

pdf/${client_identifier}/${fisc_end}/${inside_name}.pdf.

Exemple :

pdf/54053/201904/6bc-4a90-987c-8c3af62014dc.pdf

Les noms des factures PDF sont paramétrables dans la configuration du connecteur. Les paterns utilisables pour le nommage du fichier sont les suivants :

${client_identifier}, ${id}, ${type_activity}, ${supplier_name}, ${inside_name}, ${pdf_name}, ${fisc_end}.

Avez-vous trouvé votre réponse?