image

Informations commerciales SAQ (Infocom)

Téléchargement des données brutes

Spécifications techniques

Table des matières

1.    Généralités
Le présent document a pour objectif de fournir des spécifications techniques détaillées pour les fichiers d’Informations commerciales de la Société des Alcools du Québec (SAQ). Ces derniers peuvent être téléchargés, lorsque souscrits au moment de l’abonnement, à partir de la fonction « Informations commerciales SAQ disponible sur le portail SAQ-B2B.

Les Informations commerciales de la SAQ sont rafraîchies une fois par semaine sur le portail. La date de la plus récente mise à jour des informations est affichée sur la page principale de cette fonction sur les portails.

2.    Description des fichiers

Les fichiers produits sont en format CSV, et le séparateur utilisé est le point-virgule ( ;).
Tous les fichiers générés sont ensuite compressés (ZIP). On retrouve parfois plus d’un fichier dans le même fichier compressé.

2.1  Ventes hebdomadaires
Nom du fichier : Ventes_AAAAPPS.csv (où AAAA=année, PP=période, et S=semaine)
Élément Type Longueur
CODE SAQ (CIP) Caractère 8
NO FOURNISSEUR Numérique 8
NO SUCCURSALE Caractère 8
TYPE CLIENT Caractère 3 (voir fichiers références)
NO DA (Distributeur autorisé) Numérique 8
ANNÉE Numérique 4
PÉRIODE Numérique 2
SEMAINE Numérique 1
QTÉ BOUTEILLE Numérique 12
MONTANT Numérique 15 chiffres dont 2 décimales
MONTANT = le prix de vente régulier multiplié par la quantité de bouteilles (ou unités) vendues.

2.2  Inventaires par succursale
Nom du fichier : Inventaires succursales.csv
Élément Type> Longueur
NO SUCCURSALE Caractère 8
CODE SAQ (CIP) Caractère 8
QTÉ INVENTAIRE (bouteilles) Numérique 13 (4 décimales)
ANNÉE Numérique 4
PÉRIODE Numérique 2
SEMAINE Numérique 1
DATE DU JOUR Date (AAAA/MM/JJ)

2.3  Inventaires en entrepôt
Nom du fichier : Inventaires entrepots.csv
Élément Type Longueur
NO ENTREPÔT Caractère 8
CODE SAQ (CIP) Caractère 8
QTÉ INVENTAIRE (caisses) Numérique 13 (4 décimales)
ANNÉE Numérique 4
PÉRIODE Numérique 2
SEMAINE Numérique 1
DATE DU JOUR Date (AAAA/MM/JJ)

2.4  Sous-commandes
Nom du fichier : Sous-commandes.csv
Élément Type Longueur
CODE SAQ (CIP) Caractère 8
NO COMMANDE Caractère 50
DATE COMMANDE Date AAAA/MM/JJ
QTÉ COMMANDÉE Numérique 9
UNITÉ DE COMMANDE Caractère 10
DATE PRÉVUE LIVRAISON Date AAAA/MM/JJ
PRIX ACHAT ORIGINE Numérique 9 (2 décimales)
CODE MONNAIE Caractère 3 (voir liste ci-après)
ANNÉE Numérique 4
PÉRIODE Numérique 2
SEMAINE Numérique 1
CODES MONNAIE

ARS     Argentine Peso
AUD    Australian Dollar
CAD    Canadian Dollar
CHF     Swiss Franc
CLP     Chilean Peso
CSK     Czech Koruna (sera remplacé par = CZK)
DKK    Danish Krone
EUR     Europe Euro
GBP     United Kingdom Pound
HKD    Hong Kong Dollar
IEP       Irish Punt (avant 2002, remplacé par Euro

 ILS     Israeli New Shekel
JPY     Japanese Yen
LBP     Lebanese Pound
MXP    Mexican Peso
NOK    Norwegian Kroner
NZD    New Zealand Dollar
SEK     Swedish Krona
SKK    Slovak Koruna
USD    US Dollar
ZAR    South African Rand
Consulter la liste complète

2.5  Codes à barres
Ce fichier, ainsi que le fichier « Produits » (voir section suivante), sont regroupés dans un même fichier compressé, nommé
« Produits_et_UPC_AAAAMMDD999999.zip », où AAAAMMDD est la date de préparation du fichier, et 999999 un numéro séquentiel.

Il est important de noter qu’un même numéro de produit de la SAQ (CIP) peut avoir plusieurs codes à barre dans les fichiers de la SAQ. Par exemple, un fournisseur peut mettre à jour un code à barre sur un nouveau millésime alors que la SAQ peut décider de conserver le même numéro de produit d’une année à l’autre. Le cas échéant, le code à barre avec la date de début la plus récente représentera généralement le dernier code à barre qui aura été transmis à la SAQ par le fournisseur du produit.
Nom du fichier : Codes barres.csv
Élément Type Longueur
CODE SAQ (CIP) Caractère 8
CODE À BARRE Caractère 14
TYPE Caractère 2
DATE DÉBUT Date (AAAA/MM/JJ
DATE FIN Date (AAAA/MM/JJ)

2.6  Produits
Ce fichier, ainsi que le fichier « Codes barres », sont regroupés dans un même fichier compressé, nommé
« Produits_et_UPC_AAAAMMDD999999.zip », où AAAAMMDD est la date de préparation du fichier, et 999999 un numéro séquentiel. Vous référez au fichier References.csv pour détails du tableau.
Nom du fichier : Produits.csv
Élément Type Longueur
CODE SAQ (CIP) Caractère 8
DESCRIPTION Caractère 60
NO FOURNISSEUR Numérique 8
NO FOURNISSEUR PUBLIÉ Numérique 8
UNITÉ DE VENTE Caractère 6
CODE PAYS ORIGINE Caractère 7
CODE PAYS DESTINATION Caractère 7
CODE COULEUR Caractère 2
PRIX VENDANT PRODUIT Numérique 8 (dont 2 décimales)
INDICATEUR LOCAL/IMPORTÉ Numérique 1 (0 local 1 importé)
% ALCOOL (numérique) Numérique 5 (dont 2 décimales)
MILLÉSIME COURANT Numérique 4
MILLÉSIME COMMANDE Numérique 4
FORMAT ARTICLE Caractère 7
CATÉGORIE Caractère 3
TYPE ARTICLE Caractère 1
TYPE DE LISTING Caractère 3
RÉSEAU DE DISTRIBUTION Caractère 8
UNITÉ DE MESURE Caractère 2
DÉSIGNATION RÈGLEMENTÉE Caractère 4
AROMATE Caractère 3
CÉPAGE Caractère 4
NATURE ARTICLE Caractère 5
STATUT ARTICLE Caractère 2
TAUX SUCRE Caractère 1
CLASSE FORMAT Caractère 2
QUALITÉ Caractère 4

2.7  Succursales
Ce fichier, ainsi que tous les fichiers qui suivent, sont regroupés dans un même fichier compressé, nommé
« Autres_donnees_connexes_AAAAMMDD999999.zip », où AAAAMMDD est la date de préparation du fichier, et 999999 un numéro séquentiel.
Nom du fichier : Succursales.csv
Élément Type Longueur
NO SUCCURSALE Caractère 8
NOM SUCCURSALE Caractère 100
BANNIÈRE Caractère 3
>ADRESSE Caractère 40
VILLE Caractère 25
PROVINCE Caractère 25
CODE POSTAL Caractère 7
NO TÉLÉPHONE Caractère 25
RÉGION DIR VENTES Caractère 3
STATUT SUCCURSALE Caractère 10

2.8  Entrepôts
Ce fichier fournit simplement une liste des différents entrepôts de la SAQ.
Nom du fichier : Entrepots.csv
Élément Type Longueur
NO ENTREPÔT Caractère 8
NOM ENTREPÔT Caractère 40

2.9  Fournisseurs
Nom du fichier : Fournisseurs.csv
Élément Type Longueur
NO FOURNISSEUR Numérique 8
NOM FOURNISSEUR Caractère 80

2.10  Distributeurs autorisés
Nom du fichier : Distributeurs autorises.csv
Élément Type Longueur
NO DA Numérique 8
NOM DA Caractère 80
ADRESSE Caractère 40
VILLE Caractère 25
CODE POSTAL Caractère 7
NO TÉLÉPHONE Caractère 25

2.11  Mes Produits
Ce fichier permet d’identifier les produits qui, selon la SAQ, lui sont fournis par votre entreprise en tant que fournisseur ou que vous représentez en tant qu’agent pour ces fournisseurs. Prendre note que les données contenues dans les fichiers téléchargés d’inventaires ou de commandes ne contiendront des données que pour les produits inclus dans cette liste ci.
Nom du fichier : Mes produits.csv
Element Type Length
CODE SAQ (CIP) Caractère 8
DESCRIPTION Caractère 60
NO FOURNISSEUR Numérique 8
NO AGENT Numérique 8

2.12  Définition des références
Ce fichier décrit la valeur de la clé (SYSTÈME + TYPE) qui doit être utilisée pour identifier, dans le fichier « Références », la description de chaque valeur possible pour les différents types de codes utilisés dans les fichiers Produits, Ventes et Succursales.

La colonne « Description » contient le nom de l’entête de la colonne qui représente en fait le nom du type de code (ou type de champ) à convertir.
Nom du fichier : Definition des references.csv
Élément Type Longueur
SYSTÈME Caractère 2
TYPE Caractère 4
DESCRIPTION Caractère 30
LONGUEUR CODE Caractère 2

2.13  Références
Ce fichier contient les descriptions pour chaque valeur possible des différents types de codes utilisés dans les fichiers Produits, Ventes et Succursales. Bien que la colonne Description mentionne une longueur possible de 50 caractères, la longueur des descriptions varie pour chaque type de code.

S.v.p. voir aussi la description du fichier « Définition des références ».
Nom du fichier : References.csv
Élément Type Longueur
SYSTÈME Caractère 2
TYPE Caractère 4
CODE Caractère 8
DESCRIPTION Caractère 50
Voici un exemple :
Le fichier Produits contient une colonne intitulée « Unité de Mesure » Cette colonne contient, entre autres, les valeurs suivantes : BT, LT

Le fichier « Définition des références » contient une entrée fournissant la clé applicable au code de type « Unité de mesure ».

La clé apparaît ci-après en gras :
SYSTÈME TYPE DESCRIPTION LONGUEUR CODE
0 UM Unités de mesure 2

Le fichier Références contient une entrée pour chaque valeur de la colonne référencée.
SYSTÈME TYPE CODE DESCRIPTION
0 UM BT Bouteille
0 UM LT Litre

2.14  Sommaire des ventes tous les produits (CSV)
L’abonnement pour le téléchargement de ce type de fichier se retrouve sous une option d’abonnement qui porte le même nom et qui est sous l’entête « Rapports complémentaires » de la page d’abonnement à INFOCOM.
Nom du fichier : Ventes_Sommaires AAAAPPS.csv (où AAAA=année, PP=période, et S=semaine)
Élément Type Longueur
CODE SAQ (CIP) Caractère 8
CUP Numérique 8
DESCRIPTION Caractère 60
UNITÉ DE VENTE Caractère 6
QTÉ BOUTEILLE Numérique 12
ANNÉE Numérique 4
PÉRIODE Numérique 2
SEMAINE Numérique 1