Informations commerciales SAQ

(1)

Informations commerciales SAQ

Téléchargement des données brutes

Spécifications techniques

2009-12-18

(2)

Table des matières

1 GÉNÉRALITÉS... 3

2 DESCRIPTION DES FICHIERS... 3

2.1 VENTES HEBDOMADAIRES...3

2.2 INVENTAIRES PAR SUCCURSALE...4

2.3 INVENTAIRES EN ENTREPÔT...4

2.4 SOUS-COMMANDES...4

2.5 CODES À BARRES...5

2.6 PRODUITS...6

2.7 SUCCURSALES...7

2.8 ENTREPÔTS...7

2.9 FOURNISSEURS...7

2.10 DISTRIBUTEURS AUTORISÉS...8

2.11 MES PRODUITS...8

2.12 DÉFINITION DES RÉFÉRENCES...9

2.13 RÉFÉRENCES...9

2.14 SOMMAIRE DES VENTES TOUS LES PRODUITS (CSV)...10

(3)

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 les portails Global Wine & Spirits, SAQ-B2B.

Les Informations commerciales de la SAQ sont rafraîchies une fois par semaine sur les portails (chaque lundi). 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 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.

(4)

2.2 Inventaires par succursale

Nom du fichier : Inventaires succursales.csv

QTÉ INVENTAIRE (généralement en bouteilles) Numérique 13 chiffres dont 4 décimales

ANNÉE Numérique 4

DATE DU JOUR Date (AAAA/MM/JJ)

2.3 Inventaires en entrepôt

Nom du fichier : Inventaires entrepots.csv

ENTREPÔT Caractère 8

QTÉ INVENTAIRE (en caisses) Numérique 13 chiffres dont 4 décimales

ANNÉE Numérique 4

DATE DU JOUR Date (AAAA/MM/JJ)

2.4 Sous-commandes

Nom du fichier : Sous-commandes.csv

NO COMMANDE Caractère 50

DATE COMMANDE Date

QTÉ COMMANDÉE Numérique 9

UNITÉ DE COMMANDE Caractère 10

DATE PRÉVUE LIVRAISON Date

PRIX ACHAT ORIGINE Numérique 9 chiffres dont 2 décimales CODE MONNAIE Caractère 3 (voir liste ci-après)

ANNÉE Numérique 4

(5)

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

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

CODE À BARRE Caractère 14

TYPE Caractère 2

DATE DÉBUT Date (AAAA/MM/JJ)

DATE FIN Date (AAAA/MM/JJ)

(6)

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.

Nom du fichier : Produits.csv

DESCRIPTION Caractère 60

NO FOURNISSEUR PUBLIÉ Numérique 8

UNITÉ DE VENTE Caractère 6

CODE PAYS ORIGINE Caractère 10 (voir référence PAYS) CODE PAYS DESTINATION Caractère 10 (voir référence PAYS) CODE COULEUR Caractère 2 (voir fichiers références) PRIX VENDANT PRODUIT Numérique 8 chiffres dont 2 décimales INDICATEUR LOCAL/IMPORTÉ Numérique 1 (0 local 1 importé)

% ALCOOL (numérique) Numérique 5 chiffres dont 2 décimales

MILLÉSIME COURANT Numérique 4

MILLÉSIME COMMANDE Numérique 4

FORMAT ARTICLE Caractère 7

CATEG ACHAT Caractère 3 (voir fichiers références) TYPE ARTICLE Caractère 1 (voir fichiers références) TYPE DE LISTING Caractère 3 (voir fichiers références) RÉSEAU DE DISTRIBUTION Caractère 8 (voir fichiers références) UNITÉ DE MESURE Caractère 2 (voir fichiers références) DÉSIGNATION RÈGLEMENTÉE Caractère 4 (voir fichiers références)

AROMATE Caractère 3 (voir fichiers références)

CÉPAGE Caractère 4 (voir fichiers références)

NATURE DU PRODUIT Caractère 5 (voir fichiers références) STATUS DU PRODUIT Caractère 2 (voir fichiers références) TAUX DE SUCRE Caractère 1 (voir fichiers références) CLASSE DE FORMAT Caractère 2 (voir fichiers références)

QUALITÉ Caractère 4 (voir fichiers références)

(7)

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

NOM SUCCURSALE Caractère 200

BANNIÈRE Caractère 3 (voir fichiers références)

ADRESSE Caractère 100

VILLE Caractère 100

PROVINCE Caractère 25

CODE POSTAL Caractère 7

NO TÉLÉPHONE Caractère 25

RÉGION DIR VENTES Caractère 3 (voir fichiers références)

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

NO ENTREPÔT Caractère 8

NOM ENTREPÔT Caractère 50

2.9 Fournisseurs

Nom du fichier : Fournisseurs.csv

NOM FOURNISSEUR Caractère 80

(8)

2.10 Distributeurs autorisés

Nom du fichier : Distributeurs autorises.csv

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

NO AGENT Numérique 8

(9)

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

SYSTÈME Caractère 2

TYPE Caractère 4

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

SYSTÈME Caractère 2

TYPE Caractère 4

CODE Caractère 8

Voici deux exemples :

• 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

(10)

• Le fichier Produits contient une colonne intitulée « CODE PAYS ORIGINE » Cette colonne contient, entre autres, les valeurs suivantes : FRBD, CH

• Le fichier « Définition des références » contient une entrée fournissant la clé applicable au code de type « Pays Origine ». La clé apparaît ci-après en gras :

SYSTÈME TYPE DESCRIPTION LONGUEUR CODE 41 06 Pays Origine 10

• Le fichier Références contient une entrée pour chaque valeur de la colonne référencée.

SYSTÈME TYPE CODE DESCRIPTION

41 06 FRBD Bordeaux

41 06 CH Suisse

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)

CUP Numérique 8

UNITÉ DE VENTE Caractère 6

QTÉ BOUTEILLE Numérique 12

ANNÉE Numérique 4