Septembre Kit Intégration Commercium. Introduction. Version 1.0

Dimension: px

Commencer à balayer dès la page:

Download "Septembre 2011. Kit Intégration Commercium. Introduction. Version 1.0"

Fabienne Plamondon
il y a 8 ans
Total affichages :

1 Version 1.0 Septembre 2011 Introduction Kit Intégration Commercium

2 Historique de changements Par: Document version: Changes Date : Fatima FIKRI 1.0 Rédaction du document Table des matières Présentation... 3 Kit Intégration Commercium... 4 Format Commercium Import Export... 4 Améliorations apportées... 5 Guide générique... 5 Guide compagnon par partenaire d affaires... 6 Portail des intégrateurs... 6 Validateur en ligne... 6 Scénarios de tests... 6 Exemples de documents... 6 Exemples... 7 Bon de commande (850)... 7 Facture (810)... 8 CONFIDENTIAL 2

.. 4 Format Commercium Import Export... 4 Améliorations apportées... 5 Guide générique.

3 Présentation L'intégration des données échangées par EDI est la raison d'être d une infrastructure EDI. Et pour s assurer du bon déroulement de cette intégration ainsi que la validation des données intégrées, il faut bien maitriser, entre autres, les normes et standards EDI, connaître la structure de chaque document échangé, les segments et les champs définis pour cette structure ainsi que toutes les valeurs possibles pour chaque champ identificateur. De ce fait, le développement et la maintenance des solutions d intégration peuvent s'avérer être un processus complexe, et le dégrée de complexité accroît avec la multiplicité des documents échangés ainsi que le nombre des partenaires d affaires impliqués. Dans le but de faciliter ce processus, Negotium Technologies propose aux intégrateurs de ses clients un kit complet avec tous les outils nécessaires pour mener à bien leur projet d intégration. Ce kit se base sur un format convivial, simple et ouvert, nommé Commercium Import Export. Commercium Import Export permet l intégration des données entre Commercium, la solution de connectivité d affaires de Negotium Technologies, et les systèmes intégrés de gestion. Afin d assister les intégrateurs tout au long du processus d intégration, le kit offert comprend : Les spécifications du format Commercium Import Export Un portail dédié aux intégrateurs Un validateur en ligne Des scénarios de tests Des exemples de documents en format Commercium Import Export par partenaire Une assistance technique Ces éléments vont être détaillés dans les sections suivantes. CONFIDENTIAL 3

chaque document échangé, les segments et les champs définis pour cette structure ainsi que toutes les valeurs possibles pour chaque champ identificateur.

4 Kit Intégration Commercium Format Commercium Import Export Commercium Import Export est un format ouvert basé sur un simple fichier texte ou XML, c est une version améliorée et simplifiée de son prédécesseur le format DynEC, il a été conçu de façon à alléger le travail des développeurs des solutions d intégration pour Commercium. C est un format unifié pour tous les types des transactions (Bon de commande, Facture, etc ), il définit les segments les plus échangés entre les partenaires d affaires. Un fichier du format Commercium Import Export est basé sur une série de «segments», ou sections, chacune séparée par une fin de ligne (carriage return/line feed -ASCII 013 et ASCII 010). Un segment débute par un label suivi de la barre verticale (, ASCII 124). Par exemple, le premier segment, nommé segment d identification, commence par «ID». Tous les labels sont en anglais. Certains segments sont obligatoires; d autres optionnels ou conditionnels. Si un segment est optionnel, il est complètement omis; un segment conditionnel, tel le segment TOTAL_TAX, n apparaît que si et seulement si une autre information à précédemment été inscrite, dans ce cas, le segment TAX. Un segment est composé de un ou plusieurs champs, chacun séparé par la barre verticale () à l exception du dernier champ d un segment qui se termine par une fin de ligne. Les champs ne sont pas libellés; leurs valeurs sont déterminées simplement par l ordre dans lequel ils doivent apparaitre. Les champs peuvent être soit requis («R»), optionnels («O») ou conditionnels («C»); leurs valeurs peuvent être de type alphanumériques («AN»), de type date («DT»), d une liste d identification («ID»), de type entier («N») ou encore, il peut s agir d un nombre réel («Rx» où «x» représente le nombre de décimales requises). Les spécifications du format sont détaillées dans un guide générique, ainsi que des guides compagnons par partenaire d affaire. CONFIDENTIAL 4

C est un format unifié pour tous les types des transactions (Bon de commande, Facture, etc ), il définit les segments les plus échangés entre les partenaires d affaires.

5 Le diagramme suivant illustre la chaîne des segments : ID HEAD CUR REF MSG PER ADDR_TYPE TERMS_GEN ADDR LOCATIO N DATE FOB ITEM BO PRICE TAX_ITE M DESC PHYS ALLOW_ITEM REF_ITEM TOTAL TOTAL_TAX ALLOW_GEN CARRIER PACK Légende Requis Optionnel Conditionnel Améliorations apportées La plus importante amélioration du nouveau format par rapport à son prédécesseur le format DynEC est que pour chaque champ identificateur, il spécifie une liste exhaustive de valeurs acceptées par le partenaire destinataire, ce qui permet de limiter l ampleur des intégrations en intégrant seulement les identificateurs nécessaires et en éliminant l ambiguïté sur les identificateurs à utiliser. En outre, c est une prévention des erreurs éventuelles qui peuvent se produire en cas d envoi d une valeur non acceptée, ce qui représente un gain de temps considérable. Parmi les améliorations aussi, certains segments ont changé de classe, ils y en a quelquesuns qui sont passés de «obligatoire» à «optionnel», et ceci dans le but d assouplir le format. Guide générique Les spécifications du format Commercium Import Export sont détaillées dans un guide générique qui énumère : Les segments constituant la structure du format Les champs définis pour chaque segment Le type et la longueur maximale de chaque champ La classe de chaque champ (obligatoire, optionnel ou conditionnel) Liste des valeurs par défaut pour les champs identificateurs (qui peut être personnalisée pour certains partenaires) CONFIDENTIAL 5

chaque champ identificateur, il spécifie une liste exhaustive de valeurs acceptées par le partenaire destinataire, ce qui permet de limiter l ampleur des intégrations en intégrant seulement les

6 Guide compagnon par partenaire d affaires Des guides compagnons sont livrés aussi avec le kit, un guide par partenaire d affaires, ce guide recense les spécifications particulières au partenaire ainsi que les listes exhaustives pour les identificateurs. Portail des intégrateurs Un portail est en cours de développement par Negotium Technologies, dédié aux intégrateurs de son système Commercium; ce portail va permettre aux développeurs des solutions d intégration de trouver toute l information et l assistance dont ils auront besoin tout au long du cycle de développement de leurs solution d intégration. Validateur en ligne Parmi les outils à valeur ajoutée compris dans le kit offert, le validateur en ligne qui va permettre de valider la conformité des documents selon le format Commercium Import Export. Scénarios de tests Afin de guider les développeurs dans la validation en ligne, des scénarios de tests vont être rédigés pour simuler le cycle transactionnel de chaque document. Exemples de documents Des exemples de documents au format Commercium Import Export seront aussi fournis dans le kit. Ces exemples typiques regroupés par partenaire d affaires, vont donner une idée sur la structure des documents acceptés par le partenaire ainsi que les valeurs possibles pour chaque champ. CONFIDENTIAL 6

Portail des intégrateurs Un portail est en cours de développement par Negotium Technologies, dédié aux intégrateurs de son système Commercium; ce portail va permettre aux développeurs des solutions d

7 Exemples Voici des exemples des documents 850 et 810 selon le format Commercium Import Export. Bon de commande (850) ID 850 Sender ID Receiver ID 2.00 HEAD PO Number 00 CUR CAD REF IA Your supplier Number MSG Please make an apointment before delivery MSG Receiving hours are between 8:30 and 16:30 MSG LEASE MARK ALL SHIPPING DOCUMENTS WITH OUR MSG PURCHASE ORDER NUMBER PER BY Your partner s buyer name Telephone number ADDR_TYPE BT Your partner name Partner ID ADDR 123 Main Door 88 LOCATION City QC Postal code CA ADDR_TYPE ST Your partner store name Store number ADDRESS 567 Main LOCATION City ON Postal code CA TERMS_GEN DATE FOB PP DE Shipping Instructions ITEM EA Vendor part number Item bar code Buyer Part Number PRICE UPC ITEM EA Vendor part number Item bar code Buyer Part Number PRICE UPC PHYS ML ITEM EA Vendor part number Item bar code Buyer Part Number PRICE UPC PHYS ML ALLOW_ITEM C A TOTAL ALLOW_GEN A D CARRIER M Fast Freight CONFIDENTIAL 7

WITH OUR MSG PURCHASE ORDER NUMBER PER BY Your partner s buyer name Telephone number Email ADDR_TYPE BT Your partner name Partner ID ADDR 123 Main Door 88 LOCATION City QC Postal code CA ADDR_TYPE ST

8 Facture (810) ID 810 Sender ID Receiver ID 2.00 HEAD Invoice Number PO Number DI CUR CAD REF IA Your vendor number REF CD Authorization number MSG Order shipped complete PER SR Your sales rep name Telephone number ADDR_TYPE BT Your partner name Partner ID ADDR 123 Main Door 88 LOCATION City QC Postal code CA ADDR_TYPE ST Your partner store name Store number ADDR 567 Main LOCATION City ON Postal code CA ADDR_TYPE RE Your Remit to name Remit ID ADDR 9567 Main LOCATION City ON Postal code CA TERMS_GEN DATE FOB PP DE Instructions ITEM EA Vendor part number Item bar code Buyer Part Number BO 60 PRICE UPC PHYS ML ITEM EA Vendor part number Item bar code Buyer Part Number PRICE UPC PHYS ML ITEM EA Vendor part number Item bar code Buyer Part Number BO 60 PRICE UPC PHYS ML ALLOW_ITEM C A TOTAL TOTAL_TAX GST TOTAL_TAX PST ALLOW_GEN A D CARRIER M Fast Freight PRO Number PACK CONFIDENTIAL 8

ADDR_TYPE BT Your partner name Partner ID ADDR 123 Main Door 88 LOCATION City QC Postal code CA ADDR_TYPE ST Your partner store name Store number ADDR 567 Main LOCATION City ON Postal code CA

Documents pareils

Ultramar Ltée GUIDE D IMPLANTATION

Ultramar Ltée GUIDE D IMPLANTATION GUIDE D IMPLANTATION pour l échange de documents informatisés Mai 2004 TABLE DES MATIÈRES INTRODUCTION... 1 PERSONNES-RESSOURCES... 1 STANDARDS EDI UTILISÉS... 1 FRÉQUENCE DES COMMUNICATIONS... 1 RESPONSABILITÉ