guide utilisateur opensi connect prestashop · 2016. 12. 22. · liste des caractéristiques...

OpenSi Connect pour PrestashopGuide de lʼutilisateurJanvier 2011Version 1.0

Auteurs

Franck Jacob

Ludovic Garnier

Pierre Verger

Olivier Coeytaux

Guide de lʼutilisateur OpenSi Connect pour Prestashop " sur 28

Sommaire............................................................................Présentation générale! 4

.......................................................................Format dʼéchange des données! 6

......................................................................................Sécurité des échanges! 6

...........................................................................Installation du module! 7

.........................................................Installation du module dans Prestashop! 7

.........................................Interface de configuration du module web! 9

......Définitions des flux dʼinformation entre Prestashop et OpenSi! 10

...........................Création de nouvelles caractéristiques sous Prestashop! 12

.....................Création de nouveaux attributs et groupes sous Prestashop! 13

..Récapitulatif des champs synchronisables entre Prestashop et OpenSi! 15

......................................................Création dʼun produit sans déclinaisons! 17

......................................................................................................Onglet « Infos »! 17

.............................................................................Que se passe-t-il maintenant ?! 18

.........................................................Création dʼun article avec déclinaisons! 19

......................................................................................................Onglet « Infos »! 19

..................................................................................................Onglet « Caract. »! 20

........................................................................................Onglet « Déclinaisons »! 20

.............................................................................Que se passe-t-il maintenant ?! 21

...........................................................................Modification dʼarticle! 22

..........................Modification des informations de base dʼune fiche article! 23

.........................................................................................Modification de prix ! 23

..................................................................................Modification des stocks! 23

.........................................................................................Modification de TVA! 23

................................Gestion des comptes client (Site vers OpenSi)! 24

...................................Création dʼun compte client web (Site vers OpenSi)! 24Guide de lʼutilisateur OpenSi Connect pour Prestashop " sur 28

...............................Mise à jour dʼun compte client web (Site vers OpenSi) ! 24

...........................Création dʼune commande client web (Site vers OpenSi)! 24

.............................Création d'une transaction bancaire (Site vers OpenSi) ! 26

..........................Récupération des états de commande (OpenSi vers Site)! 27

.............................................................................Etats de commandes d'OpenSi! 27

.......................Etats de commandes d'OpenSi – Correspondance Prestashop! 27

...................................Etats logistique OpenSi – Correspondance Prestashop! 27

............................................Récupération du tracking colis (OpenSi vers Site)! 28


Présentation générale

Lʼobjectif de ce guide est de vous détailler les modalités de fonctionnement du module « OpenSi Connect » pour la plateforme « Prestashop ».

Ce module « OpenSi Connect » permettra à votre site e-commerce Prestashop de dialoguer avec OpenSi E-Commerce et de synchroniser automatiquement les commandes clients, le catalogue dʼarticles, les stocks et les tarifs.

Après lʼinstallation du module « OpenSi Connect » sur un site e-commerce Prestashop, une interface de configuration et de gestion des échanges est disponible dans le backoffice du site, onglet « Module » / « OpenSi Connect » / « Configurer ».

OpenSi et Speedinfo sont des marques déposées.


Conventions

Dans la suite du document, nous appellerons :

• Commerçant : le propriétaire du site e-commerce à connecter à OpenSi

• Site ou site-e-commerce : le site internet ou lʼapplication à connecter à OpenSi

• Module OpenSi Connect : le module développé par Speedinfo à installer sur la boutique Prestashop.

• OpenSi ou OpenSi E-Commerce : la suite logicielle de comptabilité et de gestion commerciale exposant

sur internet des services web pour se connecter à un site ou une application

• Service_id : lʼidentifiant unique du commerçant pour utiliser les services web OpenSi E-Commerce. Ce

champs est de type numérique (fourni par Speedinfo)

• Code_site_web : le code du site e-commerce dans OpenSi E-Commerce, champ de 5 caractères

alphanumériques (paramétré dans OpenSi E-Commerce par le commerçant)

• Produit parent : un produit qui contient dʼautres produits (par exemple un pack contentant 1 t-shirt + 1

pull)

• Produit enfant : les produits contenus dans un produit (par exemple, le t-shirt et le pull sont des produits

enfant du pack)


Fonctionnement du module

Attention

Il est impératif de renseigner la référence dans Prestashop. Si un article est créé sans référence, celui-ci ne sera pas créé dans OpenSi.

Format dʼéchange des données

Le module « OpenSi Connect » fonctionne via des services web (ou WebServices) REST. Ces services web permettent dʼéchanger des données au travers de messages au format XML via le protocole HTTP.

Pour plus d'informations concernant les services web : http://fr.wikipedia.org/wiki/Service_Web

Sécurité des échanges

Afin d'assurer la sécurité et la confidentialité des données échangées, les connexions au serveur de services web s'effectuent selon le protocole standard HTTPS.

Lʼaccès aux services web est protégé par une authentification HTTP BASIC par login et mot de passe.


http://fr.wikipedia.org/wiki/Service_Web

http://fr.wikipedia.org/wiki/Service_Web

Installation du module

Attention

Le module OpenSi Connect est uniquement compatible avec la version 1.3.2 (et supérieure) de Prestashop.

Lʼinstallation du module sous la plateforme e-commerce Prestashop est simple. Nous allons détailler la procédure à suivre ci-dessous.

Installation du module dans Prestashop

Dans lʼinterface dʼadministration de Prestashop, cliquez sur lʼonglet « Modules ».

Cliquez sur le bouton « Ajouter un nouveau module »

Sélectionnez le module et chargez le module.


Maintenant que le module est téléchargé, vous devez lʼinstaller.

Recherchez donc le module « OpenSi Connect » dans la liste des modules et cliquez sur le bouton « Installer ».

Une fois le module installé, vous devez maintenant le configurer. Pour cela, recherchez à nouveau le module dans la liste et cliquez sur « Configurer ».

Attention

Pour terminer, il vous faut maintenant ajouter la ligne suivante dans la crontab de votre serveur :

*/30 * * * * your_user php /path_to_your_website/modules/opensi/index.php


Interface de configuration du module web

Les codes dʼaccès vous sont fournis par Speedinfo.La configuration permet de gérer les éléments suivants :

• Paramétrage du Service_id, identifiant commerçant dʼaccès aux services OpenSi

• Paramétrage du login HTTP, l'identifiant de l'utilisateur des services web

• Paramétrage du mot de passe http de l'utilisateur des services web

• Paramétrage du Code_site_web (identifiant du site dans OpenSi)

• Paramétrage du code dépôt de stock (identifiant du dépôt dans OpenSi)

• Configuration des fréquences dʼappel de chaque service web


Définitions des flux dʼinformation entre Prestashop et OpenSi

Ci-dessous l'ensemble des services web disponibles, qui permettent d'échanger des informations entre votre site et OpenSi E-Commerce, sont décrits ainsi que le sens du flux.

• Les champs obligatoires en création sont notés en caractères gras

• Les champs obligatoires en modification sont notés en caractères gras et soulignés

• En modification, seuls les champs présents sont modifiés

Figure 1 : Définition des flux OpenSi – site e-commerceLe bloc ERP correspond à OpenSi.


Création dʼarticles

Basé sur la version 1.3.5.0 de Prestashop.

Dans ce chapitre, nous allons voir comment créer de nouveaux articles sur le site web (Prestashop).La création de nouveaux articles sʼeffectue uniquement sur le site web (Prestashop).Les informations sont ensuite remontées par le module OpenSi Connect dans OpenSi E-Commerce.Nous partons du principe que seuls les champs obligatoires sont remplis.

Attention, si un stock est renseigné dans Prestashop, il est vivement conseillé de renseigner un prix d'achat. Sinon la valorisation du stock sera fausse dans OpenSi et il ne sera plus possible de la modifier par la suite.

Attention : La création de la caractéristique famille et de son renseignement nʼest pas obligatoire dans Prestashop. Si la famille nʼest pas renseignée, la mention NC sera ajoutée dans la fiche article OpenSi.

Afin dʼillustrer au mieux le guide dʼutilisation, nous fournissons tout au long de ce guide des exemples de pratiques liées à une activité e-commerce de vêtements (par exemple des produits avec une gestion de taille, couleur…) Il est bien entendu que OpenSi peut aussi sʼadapter à des activités e-commerce différentes.

Attention

Il est impératif de renseigner la référence dans Prestashop. Si un article est créé sans référence, celui-ci ne sera pas créé dans OpenSi.


Création de nouvelles caractéristiques sous Prestashop

Pour optimiser pleinement le fonctionnement entre OpenSi et Prestashop, vous devez créer des caractéristiques personnalisées (7 caractéristiques différentes) qui nʼexistent pas par défaut dans Prestashop (valable pour tous les types de produits).

Liste des caractéristiques personnalisées à créer :Sur la base de notre exemple (boutique de vêtements), les caractéristiques à créer seraient :

Liste des caractéristiques personnaliséesListe des caractéristiques personnaliséesListe des caractéristiques personnaliséesListe des caractéristiques personnalisées

N° Type de caractéristique Nom possible Exemple

1 Famille1 Famille T-Shirt

2 Famille2 Sous famille T-Shirts manches courtes

3 Famille3 Sous sous famille

4 Longueur (en mètre) Longueur

5 Largeur (en mètre) Largeur

6 Hauteur (en mètre) Hauteur

7 Volume (en mètre cube - m3) Volume

Exemple de création dʼune nouvelle caractéristique :Pour cela, il faut aller dans « Catalogue » / « Caractéristiques » et « Ajouter une nouvelle caractéristique ».


Recommencez lʼopération de manière à avoir :

Création de nouveaux attributs et groupes sous Prestashop

Pour optimiser pleinement le fonctionnement entre OpenSi et Prestashop, vous devez également créer des groupes dʼattributs personnalisés (6 groupes différents) qui nʼexistent pas par défaut dans Prestashop (valable pour tous les types de produits).

Liste des attributs et groupes personnalisés à créer :Sur la base de notre exemple (boutique de vêtements), les groupes dʼattributs à créer seraient :

Liste des attributs personnalisésListe des attributs personnalisésListe des attributs personnalisésListe des attributs personnalisés

N° Type dʼattribut Nom possible du groupe dʼattribut Exemple de déclinaison

1 Attribut1 Couleur Jaune, vert, bleu, rayé

2 Attribut2 Taille S, M, L, XL

3 Attribut3 ...

4 Attribut4 ...

5 Attribut5 ...

6 Attribut6 ...


Exemple de création dʼun nouveau groupe dʼattribut :Pour cela, il faut aller dans « Catalogue » / « Attributs et groupes » et « Ajouter un groupe dʼattributs ».

Recommencez lʼopération de manière à avoir par exemple :


Récapitulatif des champs synchronisables entre Prestashop et OpenSi

Tous les champs nommés ci-dessous sont envoyés de Prestashop vers OpenSi lors de la création dʼun nouvel article.

ArticleArticleArticleArticle

N° Description Prestashop Description OpenSi Type

1 Nom Désignation Chaine de 100 caractères au maximum

2 Statut de publication Publication web Valeurs possibles : « activé » ou « désactivé »

3 Fabricant Marque Chaine de 40 caractères au maximum

4 Référence Référence Chaine de 40 caractères au maximum

5 EAN13 Code barre Entier de 13 chiffres

6 Poids brut en Kg(poids total avec lʼemballage) Poids brut Nombre décimal de10 chiffres au total

dont 3 chiffres après la virgule

7 Prix dʼachat HT Prix dʼachat Nombre décimal de 14 chiffres au total dont 4 chiffres après la virgule

8 Prix de vente HT Prix de vente HT Nombre décimal de14 chiffres au total dont 4 chiffres après la virgule

9 Taxe Taux de TVA Nombre décimal de 4 chiffres au total dont 2 chiffres après la virgule

10 Prix de vente TTC Prix de vente TTC Nombre décimal de14 chiffres au total dont 4 chiffres après la virgule

11 Quantité Stock Nombre décimal de 10 chiffres au total dont 3 chiffres après la virgule

12 Résumé Description 1 Chaine de 40 caractères au maximum

13 Description Description 2 Chaine de 40 caractères au maximum

14 Famille 1 Famille 1 Chaine de 40 caractères au maximum



17 Volume (en m3) Volume (en m3) Nombre décimal de 6 chiffres au total dont 2 chiffres après la virgule

18 Hauteur (en m) Hauteur (en m) Nombre décimal de 6 chiffres au total dont 2 chiffres après la virgule

19 Longueur (en m) Longueur (en m) Nombre décimal de 6 chiffres au total dont 2 chiffres après la virgule

20 Largeur (en m) Largeur (en m) Nombre décimal de 6 chiffres au total dont 2 chiffres après la virgule

21 Attribut 1 Attribut 1 Chaine de 40 caractères au maximum






Création dʼun produit sans déclinaisonsCatalogue › Produits dans cette catégorie › Ajouter un nouveau produit

La création dʼun nouvel article (sans déclinaisons) sʼeffectue directement sur le site web (Prestashop).Nous partons du principe que si votre produit contient des attributs, ces derniers auront déjà été créés auparavant.

Onglet « Infos »

Prérequis

Prenez le temps de bien renseigner votre article lors de la création. En effet, cette étape permet la synchronisation avec OpenSi des champs stipulés dans le tableau ci-dessus.

Dans Prestashop, la référence nʼest pas un champ obligatoire mais est requis par OpenSi. Aussi, la référence doit être unique et non vide lors de la création dʼun nouvel article.A noter que si un article est créé sans référence, ce dernier ne sera pas créé dans OpenSi.

Les prix doivent être exprimés en euro (€).

Dans lʼonglet « Infos », remplissez les champs obligatoires sans oublier de renseigner une référence (obligatoire et unique).

Enregistrer votre article.


Que se passe-t-il maintenant ?

Une fois votre produit sauvegardé, le module OpenSi Connect va créer votre produit dans OpenSi (sous condition que celui-ci nʼexiste pas encore).Attention, veuillez prendre note que lors de la création dʼun article, tous les champs sont envoyés à OpenSi.Cela signifie que les prix (prix de vente, prix dʼachat, TVA) ainsi que les stocks doivent être bien renseignés.Si vous devez modifier ces derniers, vous ne pourrez plus le faire directement sur le site web (Prestashop) mais directement dans OpenSi. Comme évoqué précédemment, si la famille nʼest pas renseignée, la mention NC sera ajoutée dans la fiche article OpenSi.

Fig 1 : Produit créé dans OpenSi (lors de la création, tous les champs sont remontés dans OpenSI)


Création dʼun article avec déclinaisonsCatalogue › Produits dans cette catégorie › Ajouter un nouveau produit

La création dʼun nouvel article (avec déclinaisons) sʼeffectue directement sur le site web (Prestashop).Nous partons du principe que vous avez déjà créé les attributs que vous utiliserez pour créer votre produit.

La procédure à suivre est presque identique à la création dʼun article sans déclinaisons. Il faudra juste ajouter des déclinaisons au produit « parent ».

Onglet « Infos »

Prérequis

Prenez le temps de bien renseigner votre article lors de la création. En effet, cette étape permet la synchronisation avec OpenSi des champs stipulés dans le tableau ci-dessus.

Dans Prestashop, la référence nʼest pas un champ obligatoire mais est requis par OpenSi. Aussi, la référence doit être unique et non vide lors de la création dʼun nouvel article.A noter que si un article est créé sans référence, ce dernier ne sera pas créé dans OpenSi.

Les prix doivent être exprimés en euro (€).

Dans lʼonglet « Infos », remplissez les champs obligatoires sans oublier de renseigner une référence (obligatoire et unique).

Enregistrer votre article.


Onglet « Caract. »Dans lʼonglet « Caract. », remplissez les familles ainsi que les attributs « Volume », « Longueur », « Largeur », « Hauteur »

Enregistrez les caractéristiques en cliquant sur « Mettre à jour les caractéristiques ».

Onglet « Déclinaisons »

Prérequis

De la même manière que pour les produits « parents », vous devez renseigner la référence dans les déclinaisons (la référence doit être unique et non vide lors de la création dʼune déclinaison).A noter que si une déclinaison est créé sans référence, celle-ci ne sera pas créé dans OpenSi.

Dans lʼonglet « Déclinaisons. », choisissez les groupes / attributs, renseignez la référence (obligatoire et unique).


Attention

Afin quʼOpenSi puisse prendre en compte les déclinaisons (ou modification de déclinaisons), il est impératif de revenir sur le premier onglet « Infos » et de re-enregistrer le produit !

Que se passe-t-il maintenant ?

Une fois votre produit avec déclinaisons sauvegardé, le module OpenSi Connect va créer uniquement les produits « enfants » dans OpenSi. En effet, le produit « parent » étant un produit « virtuel » dépendant du stock des produits enfants, celui-ci nʼest pas créé dans OpenSi.

De la même manière que les produits simples, lors de la création dʼun article, tous les champs sont envoyés à OpenSi.


Modification dʼarticle

La mise à jour dʼun article en fonction des champs à modifier sʼeffectue soit sur dans le back office de Prestashop soit sur OpenSi E-Commerce. Dans OpenSi, l’article est mis à jour sous condition que la référence de l’article existe dans OpenSi.

ArticleArticleArticleArticle

N° Description Prestashop Description OpenSi Type Sens de synchronisation

1 Nom Désignation Chaine de 100 caractères au maximum Prestashop => OpenSi

2 Statut de publication Publication web Valeurs possibles : « activé »

ou « désactivé » Prestashop => OpenSi

3 Fabricant Marque Chaine de 40 caractères au maximum Prestashop => OpenSi

4 Référence Référence Chaine de 40 caractères au maximum Prestashop => OpenSi

5 EAN13 Code barre Entier de 13 chiffres Prestashop => OpenSi

6Poids brut en Kg(poids total avec lʼemballage)

Poids brutNombre décimal de10 chiffres au total dont 3 chiffres après la virgule

Prestashop => OpenSi

7 Prix dʼachat HT Prix dʼachatNombre décimal de 14 chiffres au total dont 4 chiffres après la virgule

OpenSi => Prestashop

8 Prix de vente HT Prix de vente HTNombre décimal de14 chiffres au total dont 4 chiffres après la virgule


9 Taxe Taux de TVANombre décimal de 4 chiffres au total dont 2 chiffres après la virgule


10 Prix de vente TTC Prix de vente TTCNombre décimal de14 chiffres au total dont 4 chiffres après la virgule


11 Quantité StockNombre décimal de 10 chiffres au total dont 3 chiffres après la virgule


12 Résumé Description 1 Chaine de 40 caractères au maximum Prestashop => OpenSi

13 Description Description 2 Chaine de 40 caractères au maximum Prestashop => OpenSi

14 Famille 1 Famille 1 Chaine de 40 caractères au maximum Prestashop => OpenSi



17 Volume (en m3) Volume (en m3)Nombre décimal de 6 chiffres au total dont 2 chiffres après la virgule



18 Hauteur (en m) Hauteur (en m)Nombre décimal de 6 chiffres au total dont 2 chiffres après la virgule


19 Longueur (en m) Longueur (en m)Nombre décimal de 6 chiffres au total dont 2 chiffres après la virgule


20 Largeur (en m) Largeur (en m)Nombre décimal de 6 chiffres au total dont 2 chiffres après la virgule


21 Attribut 1 Attribut 1 Chaine de 40 caractères au maximum Prestashop => OpenSi






Modification des informations de base dʼune fiche article

La modification dʼarticle sʼeffectue sur le site web (Prestashop).Sous OpenSi, toutes les informations sont mises à jour SAUF les prix de vente, prix dʼachat ainsi que les stocks et la TVA.

Modification de prixLa modification de prix (tarifs de vente de base et tarifs dʼachats) doit nécessairement sʼeffectuer sous OpenSi (OpenSi est considéré comme «le maître » à ce niveau). OpenSi mettra à jour ces informations sur le site web. En cas de modification de ces informations sous Prestashop, celles-ci ne seront donc pas reprises dans OpenSi. Ces modifications seront automatiquement remplacées par celles contenues dans Opensi.

Modification des stocks

La modification des stocks doit nécessairement sʼeffectuer sous OpenSi (OpenSi est considéré comme « le maître » à ce niveau). OpenSi mettra à jour ces informations sur le site web. En cas de modification de ces informations sous Prestashop, celles-ci ne seront donc pas reprises dans OpenSi. Ces modifications seront automatiquement remplacées par celles contenues dans Opensi.

Modification de TVALa modification dela TVA doit nécessairement sʼeffectuer sous OpenSi (OpenSi est considéré comme «le maître » à ce niveau). OpenSi mettra à jour lʼinformation sur le site web. En cas de modification de la TVA sous Prestashop, celle-ci ne sera donc pas reprises dans OpenSi. La TVA sur le site web sera automatiquement remplacée par celle contenue dans Opensi.


Gestion des comptes client (Site vers OpenSi)

Création dʼun compte client web (Site vers OpenSi)

La création de clients a lieu sur le site web.Lorsquʼun client est créé sur le site web, il est envoyé à OpenSi pour création. Le client est créé dans OpenSi sous condition que ce client nʼexiste pas déjà pour ce site web.

Mise à jour dʼun compte client web (Site vers OpenSi)

Lorsquʼun client est mis à jour sur le site web, il est envoyé à OpenSi pour mise à jour. Le client est modifié dans OpenSi sous condition que ce client existe pour ce site web.

Clients WebClients WebClients WebClients Web

N° Disp Description Type

4 D Prénom Chaîne de 30 caractères au maximum

5 D Nom Chaîne de 30 caractères au maximum

6 D E-mail Chaîne de 60 caractères au maximum

Création dʼune commande client web (Site vers OpenSi)

Lorsquʼune commande est faite par un client sur le site web, elle est envoyée à OpenSi pour création. Dans OpenSi la commande est créée à lʼétat « non validée », sous condition que son numéro nʼexiste pas déjà pour ce site web.

Le compte client web, le mode dʼexpédition et le mode de règlement seront créés sʼils nʼexistent pas.

La commande envoyée à OpenSi contient les champs suivants :

CommandeCommandeCommandeCommande


1 D N° Commande sur le site web Chaîne de 20 caractères au maximum

2 D Code site web dans OpenSi Chaîne de 5 caractères au maximum

3 D Login Chaîne de 60 caractères au maximum

4 D Date commande Date

5 D Edition_TTC true ou false (TTC ou HT)

6 D Mode d'expédition Chaîne de 30 caractères au maximum


7 D Frais de port Nombre décimal de 10 chiffres au total dont 2 chiffres après la virgule

8 D Taux de TVA applicable sur les frais de port

Nombre décimal de 4 chiffres au total dont 2 chiffres après la virgule

9 D Remise en % sur la commande complète


10 D Mode de règlement Chaîne de 25 caractères au maximum

11 ND Civilité facturation

12 D Nom facturation** Chaîne de 30 caractères au maximum

13 D Prénom facturation Chaîne de 30 caractères au maximum

14 D Société facturation** Chaîne de 50 caractères au maximum

15 D Ligne adresse 1 facturation Chaîne de 80 caractères au maximum



18 D Code postal facturation Chaîne de 10 caractères au maximum

19 D Ville facturation Chaîne de 50 caractères au maximum

20 D Code pays facturation Chaîne de 2 caractères

21 D Téléphone facturation Chaîne de 20 caractères au maximum

22 D Fax facturation Chaîne de 20 caractères au maximum

23 D E-mail facturation Chaîne de 60 caractères au maximum

24 ND Civilité livraison

25 D Nom livraison** Chaîne de 30 caractères au maximum

26 D Prénom livraison Chaîne de 30 caractères au maximum

27 D Société livraison** Chaîne de 50 caractères au maximum

28 D Ligne adresse 1 livraison Chaîne de 80 caractères au maximum



31 D Code postal livraison Chaîne de 10 caractères au maximum

32 D Ville livraison Chaîne de 50 caractères au maximum

33 D Code pays livraison Chaîne de 2 caractères

34 D Téléphone livraison Chaîne de 20 caractères au maximum

35 D Fax livraison Chaîne de 20 caractères au maximum


36 D E-mail livraison Chaîne de60 caractères au maximum

37 DComplément d'information livraison(code porte, étage, bâtiment, consigne au livreur…)

Chaîne de 100 caractères au maximum

38 D Etat de la commande Voir statut des commandes

39 D Statut logistique Voir statut des commandes

40 D N° Commande Chaîne de 11 caractères au maximum

** sont obligatoires soit Nom_Liv, soit Societe_Liv / soit Nom_Fact, soit Societe_Fact

Ligne dʼune commandeLigne dʼune commandeLigne dʼune commandeLigne dʼune commande


1 D Référence article Chaîne de 40 caractères au maximum

2 D Désignation Chaîne de 100 caractères au maximum

3 D Quantité Nombre décimal de 10 chiffres au total dont 3 chiffres après la virgule

4 DPrix unitaire HT ou TTC (selon le champs Edition_TTC de la commande qui est à true ou false)


5 D Remise en % sur lʼarticle Nombre décimal de 5 chiffres au total dont 2 chiffres après la virgule

6 D Taux de TVA Nombre décimal de 4 chiffres au total dont 2 chiffres après la virgule

Création d'une transaction bancaire (Site vers OpenSi)

Lorsque le site web reçoit la confirmation de paiement dʼune commande de la part de sa banque, la confirmation de paiement est envoyée à OpenSi pour création d'une transaction bancaire (règlement) sur la commande web spécifiée, sous condition que le numéro de pièce n'existe pas déjà pour cette commande. La commande concernée sera alors validée. Le mode de règlement sera créé s'il n'existe pas.

ATTENTION : Le numéro de transaction bancaire ne peut être envoyé à OpenSi (il est différent pour chaque module de paiement). Le numéro de commande est indiqué à la place pour faciliter le rapprochement.

Transactions bancaires/commandesTransactions bancaires/commandesTransactions bancaires/commandesTransactions bancaires/commandes

N° PP Description Type




4 D Mode de règlement Chaîne de 25 caractères au maximum

5 D Date de la transaction Date

6 D Montant de la transaction Nombre décimal de 14 chiffres au total dont 2 chiffres après la virgule

Récupération des états de commande (OpenSi vers Site)

Les états des commandes sur le site web sont mis à jour régulièrement avec ceux dʼOpenSi.

Etats de commandes d'OpenSi

Dans OpenSi, lʼétat dʼune commande peut changé. La commande est créée à lʼétat « non validé » et peut passer à lʼétat « validée », puis « clôturée » ou « annulée ». Afin d'établir les correspondances des états de commande dans OpenSi et sur votre site web, nous vous communiquons ci-dessous les valeurs des différent états (ou statuts) des commandes dans OpenSi qui vous seront données dans les réponses des services web.Lorsqu'un changement d'état de commande est remonté d'OpenSi sur le site, il est possible d'utiliser le système d'envoi de mail du site pour informer le client du changement de statut de sa commande.

Etats de commandes d'OpenSi – Correspondance Prestashop

Etats OpenSi Etats Prestashop

Non Validée En Attente du paiement

Validée Préparation en cours

Annulée Annulée

Clôturée En cours de livraison

Etats logistique OpenSi – Correspondance Prestashop

Un second état de la commande appelé "Statut Logistique" permet de savoir lorsque la commande est en cours, si celle-ci est expédiée :

Etats OpenSi Etats Prestashop

Expédiée En cours de livraison


Récupération du tracking colis (OpenSi vers Site)

Le logisticien qui travaille avec le site e-commerce fourni des numéros de colis qui peuvent être saisie dans OpenSi. OpenSi envoie régulièrement les numéros de tracking colis créés ou modifiés dans l'intervalle de dates spécifiées.

OpenSi envoi une liste de commande contenant les champs suivants :

Expédition des colisExpédition des colisExpédition des colisExpédition des colis


1 D N° Commande dans OpenSi Chaîne de 11 caractères au maximum



4 D N° colis du transporteur Chaîne de 20 caractères au maximum

5 D URL de tracking colis sur le site du transporteur Chaîne de 200 caractères au maximum

6 D Date d'expédition du colis Date

7 D Transporteur Chaîne de 30 caractères au maximum

8 D Mode d'expédition Chaîne de 30 caractères au maximum

9 D Numéro de livraison dans OpenSi Chaîne de 10 caractères au maximum


guide utilisateur opensi connect prestashop · 2016. 12. 22. · liste des caractéristiques...

Documents