Gestion des flux inter-sociétés

Principe général

Le principe d’un flux inter compagnie est de mettre en œuvre un double flux d’échange de documents :

Dans la société émettrice, on paramètre un modèle d'échange de données sortant vers une table intermédiaire (table de "sas").
On paramètre dans le modèle d'échange de données sortant un post-traitement qui va transférer le contenu de la table intermédiaire de la société émettrice vers celle de la société de destination.
Dans la société destinatrice, on paramètre un modèle d'échange de données entrant.

Les mouvements inter-sociétés peuvent être paramétrés selon deux modes de fonctionnement :

Flux intersociétés "classiques" : deux sociétés indépendantes échanges des documents réciproques (exemple : une facture de vente devient une facture d'achat).
Société "opération" : les flux de gestion sont comptabilisés dans une société dite "opération", et les flux comptables sont répliqués dans des sociétés dites "financières".

Paramétrages

Définir les paramètres généraux

Pour accéder aux paramètres généraux IC :

Choisissez l'icône , saisissez Paramètres échanges document , puis sélectionnez le lien associé.
La page Paramètres échanges document s'affiche. Elle présente les champs suivants :

Champs	Description
Vérifier partenaire IC à la validation	Permet de vérifier que toutes les transactions sont bien saisies avec un partenaire IC. Ce paramétrage doit être activé dans le cas d'une société "opération", car tous les mouvements de la société "opération" doivent concerner une société financière.
Données base partenaire IC	Permet de définir l'origine du code partenaire IC dans les documents. Pour un paramétrage en flux inter-société, il faut paramétrer la valeur Client / Fournisseur. Pour un paramétrage en "société opération", il faut paramétrer la valeur Magasin.
Code du partenaire IC (Réplic.)	Permet de définir le code du partenaire IC de la société actuelle. C'est ce code qui sera transmis dans les documents échangés.
Appliquer immédiatement au partenaire IC	Permet de demander au système de tenter d'appliquer automatiquement le flux de données entrant dans la société de destination après chaque échange de données. Il n'est ainsi pas nécessaire de lancer l'intégration manuellement.
Activer N° souche par partenaire IC	Permet d'activer l'affectation de souche de numéro de validation aux documents selon le partenaire IC concerné par le document (voir plus bas).

Paramétrer les modèles d'échange de document

Le chapitre concernant le paramétrage des modèles d'échange de données précise de façon détaillée les paramètres à mettre en œuvre.

Dans le cadre de la mise en place de flux inter-sociétés, les points suivants sont à noter :

Les modèles d'échange de documents de la société émettrice doivent transférer les données vers la table intermédiaire (ou table de "sas") appelée Documents échangés (ID 8062715).
Les modèles d'échange de documents de la société destination doivent transférer les données à partir de la table intermédiaire (ou table de "sas") appelée Documents échangés (ID 8062715).
Dans le modèle d'échange de données de la société émettrice, on pourra paramétrer comme post traitement le codeunit 8062731 : il se chargera de réaliser automatiquement le transfert de données entre les deux sociétés.
Dans les modèles d'échange de données de la société émettrice, il est important de définir une condition exécution concernant le code partenaire IC (Réplication), afin de ne pas envoyer tous les enregistrements dans les flux inter-sociétés.

Paramétrer les partenaires IC (Réplication)

Les partenaires IC permettent de définir les partenaires auprès desquels des documents vont pouvoir être émis.

Note

Ne pas confondre les partenaires IC (standards) et les partenaires IC (Réplication).

Pour accéder aux partenaires IC (Réplication) :

Choisissez l'icône , saisissez Partenaires IC (Réplication) , puis sélectionnez le lien associé.
La page Partenaires IC (Réplication) s'ouvre. Elle présente les informations suivantes :

Champs	Description
Code	Code identifiant le partenaire IC.
Nom	Nom du partenaire IC.
Type de boîte de réception	Permet de déterminer le mode de communication avec le partenaire IC. Les valeurs suivantes sont disponibles : Base de donnée : le partenaire IC est une société située dans la même base de données. Aucun transfert IC : aucun transfert IC n'est réalisé avec ce partenaire IC. API : le partenaire IC est une société située dans un autre environnement Business Central. La communication doit donc se faire par API.
Détails sur la boîte de réception	Permet de détailler le mode de communication avec le partenaire IC. La valeur dépend du type de boîte de réception : Base de donnée : permet de sélectionner la société correspondante dans la base de données. Aucun transfert IC : non nécessaire. API : permet de saisir le endpoint de l'API à interroger. Pour plus d'information, consulter le chapitre suivant.
Bloqué	Permet de bloquer l'utilisation d'un partenaire IC.

Définir des souches de numéro pour les documents validés

Dans le cadre d'une "Société Opération", il peut être utile que les documents validés soient numérotés selon la société juridique concernée. Cela permet d'avoir des numéros chronologiques par entité juridique dans la société opération.

Ainsi, il est possible de paramétrer des souches de numéros différentes pour chaque partenaire IC. Ces souches de numéros s'appliqueront à la validation des documents (facture, expédition... par exemple). Pour définir des souches de numéros spécifiques :

Dans la page Partenaires IC (Réplication), sélectionnez le partenaire IC.
Dans le bandeau, sélectionnez l'action Souche de numéros.
Dans la page qui s'affiche, définissez les souches de numéros à appliquer, en vente ou en achat. Attention ! Pour qu'une souche puisse être sélectionnée dans cette page, celle-ci doit être liée à la souche principale qui est définie dans les paramètres de vente ou d'achat (Création des souches de numéros - Business Central | Microsoft Learn).

Un paramétrage supplémentaire est nécessaire afin d'activer la fonctionnalité :

Choisissez l'icône , saisissez Paramètres échanges document , puis sélectionnez le lien associé.
La page Paramètres échanges document s'affiche.
Afin d'activer la fonctionnalité, cochez le champ Activer N° souche par partenaire IC .

Note

Ce paramétrage concerne uniquement les documents validés. Les documents non validés (devis, commande, retour...) ne sont pas concernés.

Paramétrer la communication par API

Pour échanger des données entre société ne faisant pas partie du même environnement, il est nécessaire de passer par une API. Afin de mettre en place ce mode de communication, le Partenaire IC (Réplication) doit être paramétré avec un Type de boîte de réception à la valeur API.

Il est ensuite nécessaire de saisir l'URL du end-point API qui va recevoir les requêtes dans l'environnement Business Central distant. Pour un environnement SaaS, cette URL aura la structure suivante :

https://api.businesscentral.dynamics.com/v2.0/(tenantID)/(environmentname)/api/calliope/docExchange/v2.0/companies((companyID))/documentHeader

Les valeurs entre parenthèses doivent être remplacées par les valeurs suivantes :

(tenantID) : identifiant du tenant distant. On trouve cette information dans la partie Signaler un problème de la page Aide et support dans Business Central.
(environmentname) : nom de l'environnement distant. On trouve cette information dans la partie Signaler un problème de la page Aide et support dans Business Central.
(companyID) : ID unique de la société dans l'environnement distant. Cette information correspond à la valeur du champ Id dans la table Société de Business Central pour la société concernée.

Il est ensuite nécessaire de paramétrer les éléments d'authentification. Pour accéder aux éléments d'authentification, sélectionnez l'action Autorisation API dans le bandeau.

Il est possible de s'authentifier en Basic Auth ou en OAuth 2.0.

En mode Basic Auth, un utilisateur doit être créée et paramétré dans l'environnement distant. Dans la page Partenaire IC :autorisation API de l'environnement local, les informations suivantes doivent être paramétrées :

Nom d'utilisateur : correspond au Nom d'utilisateur de l'utilisateur à utiliser pour la connexion à l'environnement distant.
Mot de passe : correspond à la Clé d'accès service web de l'utilisateur à utiliser pour la connexion à l'environnement distant.

En mode OAuth 2.0, ce mode d'authentification doit préalablement être activé sur le tenant de l'environnement distant (Using Service to Service Authentication - Business Central | Microsoft Learn).

Dans la page Partenaire IC :autorisation API de l'environnement local, les informations suivantes doivent être paramétrées :

uri token : c'est l'uri permettant de récupérer un token d'accès. Typiquement, pour un environnement SaaS, ce sera :

https://login.microsoftonline.com/(tenantID)/oauth2/v2.0/token
ID application (client) : correspond à l’ID d’application (client) de l'application crée sur Microsoft Azure (disponible dans la Vue d'ensemble).
Clé secrète client: correspond à la clé secrète générée pour l'application dans Microsoft Azure (disponible dans les Certificats et secrets).
Header Prefix : mettre la valeur "Bearer".

Définir les correspondances IC de modèle d'échange de document

Quand un document échangé est transféré vers une autre société, il est important de définir le modèle d'échange de document qui devra être appliqué dans cette société. Pour cela, il est nécessaire de paramétrer une table de correspondance.

Si plusieurs modèles sont paramétrés dans la correspondance, plusieurs documents pourront être générés dans la société de destination.

Pour accéder aux correspondances IC de modèles d'échange de document :

Choisissez l'icône , saisissez Corresp. IC modèle échange doc. , puis sélectionnez le lien associé.
La page Corresp. IC modèle échange doc. s'ouvre. Elle présente les informations suivantes :

Champs	Description
Code modèle échange donnée	Correspond au modèle d'échange de données d'origine
Code du partenaire IC	Permet de définir le code du partenaire IC pour lequel la correspondance est définie. Si le code du partenaire IC est laissée vide, la correspondance est valable pour tous les partenaires IC.
Code modèle échange donnée partenaire IC	Correspond au modèle d'échange de données qui sera appliqué dans la société de destination.

Définir les paramètres spécifiques par partenaire IC dans une société "Opération".

Lorsque des flux sont comptabilisés dans une société dite "opération", il peut être souhaitable que la comptabilisation suive un schéma comptable différent selon le partenaire pour le compte duquel la facture est émise. Par exemple, les comptes de charges ou de produits peuvent être différents selon que le partenaire fasse de la production ou du négoce.

Afin de gérer ce cas de figure, il est possible de définir une table de correspondance à appliquer à certaines données de paramétrage, selon le partenaire IC concerné.

Pour accéder à ce paramétrage :

Choisissez l'icône , saisissez Liste valeurs de paramètre IC , puis sélectionnez le lien associé.
La page Liste valeurs de paramètre IC s'ouvre. Elle présente les informations suivantes :

Champs	Description
Code partenaire IC	Code du partenaire IC concerné.
Type	Type de données
Valeur origine	Valeur d'origine
Valeur destination	Valeur de destination

Exemple :

Soit les deux partenaires IC TRADECO (Négoce) et PRODCO (Production), gérés dans une société "Opération"
On paramètre dans la société "Opération" des paramètres comptabilisation pour les deux cas de figure, avec des groupes comptabilisation produit distincts (exemple : NEGOCE et PRODUCTION).
On défini dans les articles l'un ou l'autre des groupes de comptabilisation produit (par exemple, NEGOCE).
On défini dans la table de paramétrage une correspondance indiquant que, quand on vend un produit ayant le groupe de comptabilisation NEGOCE pour le compte du partenaire PRODCO, il faut alors appliquer le groupe de comptabilisation PRODUCTION.
Ainsi, la comptabilisation s'effectuera sur le bon compte comptable dans la société "opération".

Transfert entre les sociétés

Selon les paramétrages réalisés dans les modèles d'échange de documents, les transferts inter-société pourront être réalisés de façon automatisées ou manuelle.

L'automatisation et le suivi de l'exécution des échanges est décrit dans la page Exécution des échanges de documents.

Le paramétrage des modèles d'échange de documents est détaillé dans la page Modèles d'échange de documents.

Le fonctionnement des documents échangés est décrit en détail dans la page Documents échangés.

Voir aussi

Aperçu du module d'échange de document
Gestion des flux inter-sociétés
Gestion des interfaces
Correspondances de données
Modèles d'échange de documents
Documents échangés
Exécution des échanges de documents
Utilisation de Business Central