Passer au contenu
Français
  • Il n'y a aucune suggestion car le champ de recherche est vide.

Comment envoyer automatiquement les fichiers de MyCompanyFiles vers AmiCompta grâce à l'API PushDoc ?

Ce guide vous accompagne pas à pas dans la configuration de l'envoi automatique de fichiers vers AmiCompta via l'API PushDoc

Prérequis

Avant de commencer, assurez-vous d'avoir :

  • Un compte administrateur sur MyCompanyFiles

  • Un compte administrateur sur Amicompta

  • Les dossiers que vous souhaitez sélectionner pour le paramétrage de ce connecteur

Configuration initiale du connecteur Agiris dans MyCompanyFiles (MCF)

Pour commencer la configuration de l’API Pushdoc, accédez à la partie Connecteurs qui se situe dans l’administration MyCompanyFiles (MCF) (symbolisée par la roue dentée).

Dans la liste des connecteurs disponibles, recherchez celui d’Agiris.

Cliquez sur le bouton "Activer" du connecteur "Pushdoc Amicompta en API" pour activer le connecteur Agiris, puis cliquez sur l’icône du crayon pour le modifier.

ami2

Choisissez ensuite les clients à connecter en utilisant des filtres ou une recherche simple puis cliquer sur "Valider".

ami3


Gestion du jeton API AmiCompta

Cette section détaille comment récupérer le TOKEN d’AmiCompta nécessaire au paramétrage du connecteur MyCompanyFiles.

Récupération du TOKEN AmiCompta

La première étape dans AmiCompta consiste à vous rendre dans la partie administration, puis dans l’onglet Gérez vos connexions APIs.

Cliquez ensuite sur Ajouter une connexion API.

ami5
Choisissez le nom de la plateforme : MyCompanyFiles.

Cliquez sur Transfert de documents

Ajoutez une description, ce champ est libre. 

Cliquez sur Confirmer.


amicompta3

Copiez le jeton (le TOKEN) correspondant à MyCompanyFiles sur votre plateforme AmiCompta.


ami7

Sélection et activation des dossiers clients AmiCompta

La dernière étape de configuration dans AmiCompta consiste à choisir les dossiers clients auxquels vous souhaitez lier la connexion API Pushdoc.

Cliquez sur le bouton AMI COMPTA pour accéder à la sélection des dossiers clients.

Cochez tous les dossiers pour lesquels vous souhaitez mettre en place la connexion.

Puis cliquez sur Enregistrer.

ami8

Dépannage : Le bouton ‘Enregistrer’ AmiCompta n’apparaît pas

Si le bouton Enregistrer n’apparaît pas sur la page de sélection des dossiers clients AmiCompta, dézoomez la page.

Pour dézoomer, maintenez le bouton CTRL enfoncé et faites défiler la molette de votre souris.

Liaison des dossiers clients MyCompanyFiles (MCF) et AmiCompta par Attribut

Vos clients possèdent un code dossier AmiCompta qui correspond généralement à leur code client dans AGIRIS. Vous devez choisir l’attribut présent sur la fiche client MyCompanyFiles (MCF) qui correspond à ce code client AmiCompta.

Pour ce faire, suivez les étapes de sélection d’attribut :

  1. Cliquez sur le bouton "choisir un attribut".
  2. Sélectionnez le modèle de données dans lequel se trouve l’attribut souhaité (dans l’exemple fourni, le modèle est nommé client).
  3. Sélectionnez l’attribut commun entre Agiris et MCF (en général, il s’agit du code client). Dans l’exemple fourni, l’attribut choisi est Client_Id.
  4. Cliquez sur Valider.

ami9

 

Configuration des chemins de dépôt et d’archive AmiCompta

Configurez ensuite les chemins de dépôts et d’archive des documents. Il est préconisé d’utiliser l’arborescence de dépôt par défaut dans MyCompanyFiles


Chemin de dépôt dans MCF : ZONE DE DEPOT/Factures Fournisseurs
Chemin d'archive : DOSSIER COMPTABLE/{millésime}/PIECES COMPTABLES SCANNEES/Factures fournisseurs
 
ami10
Une fois que vous avez fini vous pouvez cliquer sur le bouton "Suivant". Votre paramétrage est effectué. Tous les documents qui seront déposés à partir de ce moment seront publiés via l’API Pushdoc.
 

Notez que les documents déposés antérieurement au paramétrage du connecteur Agiris ne seront pas traités.

Checklist de dépannage en cas d'erreur

Si l'envoi d'un fichier échoue, vérifiez les points suivants :

Taille maximale des fichiers

La taille maximale d'un fichier pouvant être envoyé via le PushDoc AmiCompta est de 4 Go.

Formats de fichiers

MyCompanyFiles supporte l'envoi de plus de 500 types de fichiers différents. Cependant, l'API d'AmiCompta peut refuser certains formats.

Formats généralement acceptés par AmiCompta :

  • Documents : PDF, DOC, DOCX, XLS, XLSX, ODT, ODS, RTF, TXT

  • Images : JPG, JPEG, PNG, GIF, BMP, TIFF, TIF

  • Archives : ZIP

Formats susceptibles d'être refusés par AmiCompta :

  • Fichiers exécutables : EXE, BAT, CMD, MSI, COM

  • Scripts : JS, VBS, PS1, SH

  • Fichiers système : DLL, SYS, INF

  • Formats multimédia volumineux : AVI, MOV, MP4, MKV, MP3, WAV

  • Formats propriétaires non standards

  • Fichiers sans extension ou avec extension inconnue

Erreurs liées au fichier

  • Erreur due à un doublon : Le fichier existe déjà dans AmiCompta - vérifiez sur AmiCompta si le fichier a déjà été envoyé

  • Vérifiez que le fichier n'est pas corrompu ou vide
  • Vérifiez que le fichier existe physiquement sur le disque 

  • Vérifiez que la taille du fichier ne dépasse pas 4 Go

Note importante : La liste exacte des formats acceptés par AmiCompta est définie par leur API. En cas de doute sur un format spécifique, contactez le support MyCompanyFiles.