Documentation
Protocole de distribution des numéros
de site et d’intervenant ATQ
Département informatique
AGRI-TRAÇABILITÉ QUÉBEC
15 avril 2010
INS-090(F)
2010-04-15
Table des matières
Introduction ......................................................................................................................................3
Objectif .........................................................................................................................................3
Présentation .................................................................................................................................3
Le fichier intrant ...............................................................................................................................4
Le fichier résultant ............................................................................................................................5
Contacts ............................................................................................................................................6
INS-090(F)
2010-04-15
Introduction
Objectif
Ce document présentera, en détails, les procédures afin de nous envoyer les informations de
sites ou d’intervenants pour que nous puissions, par la suite, déterminer les identifications
uniques ATQ de ceux-ci.
Présentation
Ce protocole de distribution d’identification ATQ permet aux intervenants d’envoyer chez ATQ
de l’information concernant leurs clients québécois et convertira, par la suite, cette information
en identification unique. Ces identifications seront ensuite utilisées dans les déclarations
d’évènements.
INS-090(F)
2010-04-15
Le fichier intrant
L’organisme désirant obtenir les sites ou numéros d’intervenants de ses clients devra fournir à
l’ATQ un fichier dans lequel figure les renseignements pertinents permettant au personnel de
l’ATQ de jumeler les clients de l’organisme en question avec les intervenants de la banque de
données de l’ATQ.
Ce fichier doit être envoyé par courriel à l’adresse [email protected] et sont
nom doit suivre le format suivant : CROISEMENT_NoIntervenant_AAAAMMJJ_HHMMSS.CLI où
NoIntervenant correspond au numéro d’intervenant de l’organisme émetteur du fichier (ex.
ABA99999). AAAAMMJJ_HHMMSS correspond à la date/heure d’extraction des données et
doit être en format 24 heures.
Le format du fichier est ASCII défini par des colonnes fixes.
La structure du fichier à transmettre à l’ATQ doit respecter les spécifications suivantes :
Champ
Début
Fin
Longueur
Description
Numéro de client
1
25
25
Raison sociale
Adresse 1
Adresse 2
26
66
106
65
105
145
40
40
40
Code postal
146
151
6
Téléphone
152
164
13
Prénom
Nom
Code de
transaction
Ancien numéro
de client
Inutilisé
NIM
165
195
225
194
224
225
30
30
1
Correspond au numéro du client dans l’organisme
émetteur du fichier. Ce numéro sera utilisé dans le
fichier de retour pour l’association des numéros
de site. Ce champ peut être alphanumérique.
Nom de l’entreprise correspondant au client
Adresse du client, ligne 1 (ex. 999 Germain)
Adresse du client, ligne 2 (ex. Longueuil Qc
J4N1M1)
Code postal de l’adresse du client (ex. J4N1M1) Il
ne doit pas contenir d’espace et être de format
A9A9A9
Numéro de téléphone du client (ex. (819)9999999) Le numéro de téléphone ne doit pas
contenir d’espace et être de format (999)999-9999
Prénom du client
Nom de famille du client
Code de la transaction (A, I = ajout, M, U = mise à
jour, S, D = destruction)
226
250
25
Correspond à l’ancien numéro de client si le code
de transaction est M ou U
251
330
329
338
79
9
Doit contenir des espaces
Numéro d’identification ministériel
(MAPAQ)
Seul le numéro du client est obligatoire, les autres champs servent uniquement à assurer un
croisement efficace avec les intervenants de la banque de données de l’ATQ.
INS-090(F)
2010-04-15
Le fichier résultant
Lorsque le personnel de l’ATQ aura jumelé les clients aux intervenants de la banque de données
de l’ATQ, un fichier résultant sera généré avec la liste des sites et numéro d’intervenant pour
chacun de ces clients. Il y aura une ligne dans le fichier pour chaque combinaison (Client / Site)
de sorte qu’un client avec plusieurs sites dans la banque de données aura plusieurs lignes dans
le fichier. Le nom du fichier résultant respectera la nomenclature suivante :
RCROISEMENT_NoIntervenant_AAAAMMJJ_HHMMSS.CLI où NoIntervenant
correspond au numéro d’intervenant de l’organisme ayant demandé l’extraction. La date et
l’heure seront celles du fichier intrant, ainsi, il sera facile de jumeler la demande au résultat.
À moins d’avis contraire, le fichier résultant sera expédié via courriel à l’adresse de
l’expéditeur du fichier intrant.
La structure du fichier transmis à l’organisme demandeur respectera les spécifications
suivantes:
Champ
Début
Fin
Longueur
Description
Numéro de client
1
25
25
Correspond au numéro du client dans
l’organisme émetteur du fichier
Numéro de site
26
35
10
Numéro de site associé au client
No. Intervenant
36
60
25
Correspond à l’intervenant propriétaire du
site
INS-090(F)
2010-04-15
Contacts
Pour toutes questions au sujet de ce protocole, veuillez communiquer avec nous à l’adresse
suivante : [email protected].
Agri-Traçabilité Québec conserve tous les droits de propriété. La reproduction intégrale ou partielle, la transmission électronique ou par tout autre moyen, la
modification et l’utilisation à des fins commerciales ou publiques sont interdites sans l’accord écrit préalable d’ATQ.
INS-090(F)
2010-04-15
">
