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

Ce connecteur va vous permettre d'envoyer les fichiers de MyCompanyFiles à INGENEO en API.

Qu'est-ce que l'API Pushdoc ?

L'API Pushdoc est un moyen qui permet d'envoyer des documents numériques de manière automatique et sécurisée. Elle simplifie et sécurise la transmission de fichiers comme des factures de ventes ou des factures d'achats.

Comment paramétrer l'API Pushdoc INGENEO ?

Première étape : Paramétrage du Pushdoc en API

• Pour commencer, vous devez aller dans la partie connecteurs qui se situent dans l’administration (roue dentée).

• Ensuite, dans la liste des connecteurs vous devez chercher celui de INGENEO.

• Puis cliquez sur le bouton pour activer le connecteur puis sur le crayon pour le modifier.

• Il va maintenant vous falloir choisir vos clients grâce à des filtres ou une recherche simple. 
  
  
• Puis cliquez sur "Valider"

Deuxième étape : Connexion 

En deuxième étape, vous allez indiquer les informations utiles pour que l’on se connecte sur INGENEO.

Pour y accéder, il vous faut un compte administrateur ainsi qu'un accès à tous les dossiers qui seront concernés par l'envoi de documents.

Voici comment le récupérer : 

• Rendez-vous dans le menu "Paramètres", puis dans "Administration"

• Cliquez sur le menu "APIs" et "APIs externes"

• Sur cette page, vous allez pouvoir créer une clé d'API. Pour cela cliquez sur le bouton   "+ Ajouter"
• Puis saisissez un libellé pour cette clé et enregistrez

• La clé va être générée, celle-ci est à votre disposition. Notez la.
• A l'aide des 4 boutons à droite, vous pouvez copier la clé, en générer une nouvelle ou la supprimer.

Vous devez ensuite effectuer des paramétrages sur la nouvelle clé d'API afin d'autoriser au service tiers d'accéder ou non aux différentes méthodes. Pour cela :

• Cliquez sur le bouton de paramétrage.
• Puis sélectionnez les méthodes souhaitées.

• Vous pouvez également restreindre l'accès à certaines entreprises de la plateforme.

• Le nom des 3 droits est : 

"Liste des entreprises"

"Récupérer les informations d'une entreprise."

"Déposer des documents dans la bannette."

...

• Copiez / collez le lien de votre espace INGENEO en suivant le format indiqué

• Collez le “AuthorizationToken” récupéré dans les pré-requis

• Pour sauvegarder les informations vous devez cliquer sur le bouton Valider la connexion.  Si la connexion est valide vous passerez à l'étape suivante.

Troisième étape : Paramétrer les chemins de dépôt

• Il vous faut ensuite paramétrer les chemins de dépôts et d'archive et nous vous préconisons d'utiliser l'arborescence de dépôt par défaut :

• Sélectionnez ensuite le type de documents (Facture d'achat, facture de vente,...)

Quatrième étape : Créer le lien entre les clients sur MCF et les clients sur INGENEO

La dernière étape consiste à télécharger le fichier de configuration ou de choisir un attribut présent sur la fiche client.

Pour choisir un attribut, vous devez : 

• Cliquez sur "choisir un attribut".
• Puis sélectionné le modèle de données dans lequel se trouve l'attribut souhaité (ici dans notre exemple le modèle s'appelle client).
• Sélectionner l'attribut qui est l'attribut commun entre Agora et MCF (en général c'est le code client.
• Puis cliquez sur "Valider".