Le partenaire qui souhaite exporter des pièces commerciales vers notre module de Gestion commerciale doit générer un fichier de type texte (par exemple, TXT, CSV, etc.).
Lors de la création effective des pièces commerciales à partir du fichier, les éléments des fichiers liés (clients, articles, etc.) pourront également être créés s'ils n'existent pas dans la base. C'est pourquoi le fichier "modèle" à importer comporte un grand nombre de champs.
Les champs de ce fichier doivent être séparés par des ";" (points virgules). Le séparateur de décimales c'est la "," (virgule).
Les champs peuvent être de trois formats :
Date : toujours sous la forme "JJ/MM/AAAA".
Numérique : ils ne peuvent alors contenir que des nombres.
Alphanumérique : ils peuvent alors contenir des lettres et des chiffres.
Le fichier d'import des pièces commerciales ne peut contenir que 5000 lignes au maximum par import.
Notre API permet aussi d'importer des pièces en insérant les données des champs ci-dessous dans la table FA_GrilleImport.Fichiers liés aux pièces.
Clients.
Contacts clients : ce sont tous les contacts chez les clients.
Origines clients : ce sont les provenances des clients.
Dossiers : ce sont les différents dossiers clients auxquels sont éventuellement affectées les pièces commerciales.
Vendeurs : ce sont les commerciaux auxquels sont affectées les commandes / factures.
Articles.
Codes TVA : le fichier des codes doit être créé avant le transfert des premières pièces car le programme n'autorise pas la création automatique de codes TVA.
Codes analytiques : ce sont les codes analytiques affectés aux articles et repris également dans notre module de Comptabilité.
Le libellé du champ n'a aucune importance. En revanche, l'ordre doit être respecté.
Si vous avez créé des champs personnalisés dans le logiciel, vous pouvez importer les informations correspondantes grâce à l'import partenaires.
Dans le fichier, les champs seront placés à la suite des champs listés ci-dessus.
Il faut préfixer le nom des champs afin que le programme reconnaisse le fichier principal auquel le champ est lié :
A_ pour les articles
C_ pour les clients
D_ pour les dossiers
FC_ pour les factures
CC_ pour les commandes
BL_ pour les bons de livraison
Exemple :
Si vous avez créé un champ personnalisé "Nomenclature douane" pour le fichier articles, pour l'import le champ sera nommé "A_Nomenclature douane".
N°
Libellé du champ
Type / Précisions
Lg maxi
Obligatoire
1
Numéro de pièce
Champ de type alphanumérique. Le n° de pièce est déterminant car c'est lui qui indique dans le fichier quand une pièce commerciale débute et quand elle se termine. En effet, lors du traitement du fichier, tant qu'il n'y a pas de nouveau numéro, on considère que les lignes appartiennent à la même pièce. Pour les utilisateurs qui exportent des documents commerciaux mais qui en créent également directement dans le logiciel de gestion commerciale, lors du traitement du fichier, il existe une option permettant la renumérotation automatique à partir de la dernière pièce créée. De ce fait, le numéro qui est attribué dans le fichier brut peut n'être indiqué qu'à la seule fin de différencier les pièces entre elles durant l'import.
20
Oui
2
Date de pièce
Champ de type date
10
Oui
3
Code client
Champ de type alphanumérique. Si le code client est vide, le client sera créé automatiquement (si cette option a été choisie) lors du traitement. Il faut donc qu'au minimum la raison sociale soit renseignée. Si le code client est renseigné, il est inutile de renseigner les autres données relatives au client, sauf si ces données doivent être mises à jour dans la fiche client. En effet, le logiciel modifiera dans la fiche client tous les champs renseignés. Pour gérer une codification client avec une fiche unique "Divers" ou par numérotation automatique, voir le champ 77.
15
Non
4
Raison sociale
Champ de type alphanumérique.
*Facultatif si le code client est renseigné.
*Obligatoire si le code client est vide.
60
Oui
5
Adresse 1 facturation
Champ de type alphanumérique.
50
6
Adresse 2 facturation
Champ de type alphanumérique.
50
7
Adresse 3 facturation
Champ de type alphanumérique.
50
8
Code postal facturation
Champ de type alphanumérique. Aucune vérification n'est effectuée sur l'existence du code postal dans le fichier des codes postaux.
10
9
Ville facturation
Champ de type alphanumérique. Aucune vérification n'est effectuée sur l'existence de la ville dans le fichier des codes postaux.
50
10
Pays facturation
Champ de type alphanumérique. Aucune vérification n'est effectuée sur l'existence du pays dans la table des pays.
50
11
Nom contact facturation
Champ de type alphanumérique. Le contact du client est créé si au moins le nom du contact est renseigné. Un test d'unicité est fait dans la fiche client sur nom + prénom. Ainsi, si le logiciel trouve, pour ce client, un contact avec le même nom et prénom, le contact ne sera pas créé.
50
12
Prénom contact facturation
Champ de type alphanumérique.
50
13
Civilité contact facturation
Champ de type alphanumérique. Aucun test d'existence n'est fait dans le fichier "Civilités".
50
14
Code origine (contact)
Champ de type alphanumérique.
12
15
Libellé origine (contact)
Champ de type alphanumérique. Si la fiche origine doit être créée et que le libellé n'est pas renseigné dans le fichier d'import, c'est le code origine qui sera dupliqué dans le libellé.
38
16
N° de compte comptable du client
Champ de type alphanumérique. Si le champ n'est pas renseigné et qu'il est vide dans la fiche client, il sera affecté par le logiciel selon les paramétrages par défaut présents dans le logiciel de gestion commerciale.
21
17
N° de TVA intracommunautaire
Champ de type alphanumérique.
20
18
Code dossier
Champ de type alphanumérique.
12
19
Nom du dossier
Champ de type alphanumérique. Si la fiche dossier doit être créée et que le libellé du dossier n'est pas renseigné dans le fichier d'import, c'est le code dossier qui sera dupliqué dans le libellé.
60
20
Date d'ouverture du dossier
Champ de type date. *Obligatoire si le code dossier est renseigné.
10
*Oui
21
Code vendeur
Champ de type alphanumérique.
12
22
Nom du vendeur
Champ de type alphanumérique. Si la fiche du vendeur doit être créée et que le nom du vendeur n'est pas renseigné dans le fichier d'import, c'est le code vendeur qui sera dupliqué dans le nom du vendeur.
50
23
Prénom du vendeur
Champ de type alphanumérique.
50
24
Objet (de la pièce)
Champ de type alphanumérique.
255
25
Échéance
Champ de type date.
10
26
Code article
Champ de type alphanumérique. Si le code article est absent, la ligne sera considérée comme une ligne de commentaire et seul le libellé de l'article sera considéré comme une donnée valide. Le fait de renseigner le code article rend obligatoire la saisie des champs "Quantité", "Prix unitaire ou TTC", "Code TVA".
20
27
Libellé de l'article
Champ de type alphanumérique. Si la fiche article doit être créée et que le libellé article n'est pas renseigné dans le fichier d'import, c'est le code article qui sera dupliqué dans le libellé.
255
28
Quantité (de l'article)
Champ de type numérique.
*Obligatoire si le code article a été
renseigné.
12
*Oui
29
Prix unitaire HT
Champ de type numérique.
*Obligatoire si le code article a été
renseigné et le champ "Prix unitaire TTC"
est vide.
12
*Oui
30
Prix unitaire TTC
Champ de type numérique.
*Obligatoire si le code article a été
renseigné et le champ "Prix unitaire HT"
est vide.
12
*Oui
31
Remise montant
Champ de type numérique. Ce champ doit être vide si le champ "Remise pourcentage" est renseigné.
12
32
Remise pourcentage
Champ de type numérique. Ce champ doit être vide si le champ "Remise montant" est renseigné.
5 dont 2 décimales
33
Code TVA
Champ de type alphanumérique.
*Obligatoire si le code article a été
renseigné.
2
*Oui
34
Code analytique
Champ de type alphanumérique.
12
35
Libellé du code analytique
Champ de type alphanumérique. Si la fiche du code analytique doit être créée et que le libellé du code analytique n'est pas renseigné dans le fichier d'import, c'est le code analytique qui sera dupliqué dans le libellé.
255
36
N° de compte de l'article quand soumis à TVA
Champ de type alphanumérique. Si ce champ n'est pas renseigné et qu'il est vide dans la fiche article, il sera affecté par le logiciel selon les paramétrages par défaut présents dans le logiciel de gestion commerciale.
21
37
N° de compte de l'article quand non soumis à TVA
Champ de type alphanumérique. Si ce champ n'est pas renseigné et qu'il est vide dans la fiche article, il sera affecté par le logiciel selon les paramétrages par défaut présents dans le logiciel de gestion commerciale.
21
38
Code barre article
Champ de type alphanumérique.
20
39
Valeur ligne
Champ de type alphanumérique. Lorsque l'article est géré en grilles (variantes de taille / coloris, format / matière, etc.), il s'agit de la valeur de la ligne de la grille, par exemple, la couleur.
50
40
Valeur colonne
Champ de type alphanumérique. Lorsque l'article est géré en grilles (variantes de taille / coloris, format / matière, etc.), il s'agit de la valeur de la colonne de la grille, par exemple, la taille.
50
41
Code dépôt
Champ de type alphanumérique.
Si vous avez activé la gestion de stock et que vous gérez plusieurs dépôts, vous avez deux possibilités :
Renseigner le code dépôt adéquat dans le fichier d'import.
Indiquer un code dépôt par défaut dans les options d'importation s'il s'agit du même dépôt pour toutes les pièces.
12
42
Champ de type alphanumérique.
64
43
Téléphone
Champ de type alphanumérique.
20
44
Fax
Champ de type alphanumérique.
20
45
NOM du contact livraison
Champ de type alphanumérique.
50
46
PRENOM du contact livraison
Champ de type alphanumérique.
50
47
Raison sociale livraison
Champ de type alphanumérique.
60
48
Adresse 1 livraison
Champ de type alphanumérique.
50
49
Ville de livraison
Champ de type alphanumérique.
50
50
Code postal de livraison
Champ de type alphanumérique.
10
51
Pays de livraison
Champ de type alphanumérique.
50
52
Réservé Oxatis
Champ de type alphanumérique.
53
Réservé Oxatis pour libellé article « PORT »
Champ de type alphanumérique.
54
Réservé Oxatis pour le prix article « PORT »
Champ de type alphanumérique.
55
Réservé Oxatis pour Code TVA article PORT
Champ de type alphanumérique.
56
Réservé Oxatis pour article « ECOTAXE »
Champ de type alphanumérique.
57
Type de paiement
Champ de type alphanumérique.
35
58
Remise globale
Champ de type numérique. Doit correspondre à un taux.
59
Indicatif type de TVA
Champ de type numérique.
0 = Non soumis exportations
1 = Non soumis TVA autre cas 3 = Non soumis intracommunautaire
4 = Soumis à TVA en France
5 = Soumis TVA France DOM
6 = Soumis TVA UE
1
60
Réservé Oxatis remise sur PORT
Champ de type numérique.
61
Réservé Oxatis
Champ de type alphanumérique.
62
Mode de transport
Champ de type alphanumérique.
100
63
Montant HT Port
Champ de type numérique.
64
Montant TTC Port
Champ de type numérique.
65
Code TVA sur port
Champ de type alphanumérique.
66
Total TVA sur port
Champ de type numérique.
67
Taux de TVA sur port
Champ de type numérique.
68
Référence pièce origine
Champ de type alphanumérique. Permet de sauvegarder le numéro de pièce après renumérotation
20
69
Date archivage article
Champ de type date.
70
Adresse WEB fiche client
Champ de type alphanumérique.
50
71
Code APE client
Champ de type alphanumérique.
5
72
Numéro SIRET client
Champ de type alphanumérique.
50
73
Mobile contact
Champ de type alphanumérique.
50
74
Référence client
Champ de type alphanumérique.
35
75
Code famille client
Champ de type alphanumérique.
12
76
Code devise
Champ de type alphanumérique. Le code devise doit préexister dans Dailybiz avec un taux de conversion.
12
77
Gestion codification client (réservé synchronisation)
Champ de type numérique - 1 : Préfixe - 2 : Divers - 3 : Numérotation automatique
1
78
Date de livraison
Champ de type date
79
Numéro de lot
Champ de type alphanumérique
*Obligatoire si c'est un import du type bon de livraison ou facture, le code article a été renseigné et l'article en question gère bien les lots.
50
80
Réservé pour identifiant unique ligne d'article
Champ de type UUID
81
Code regroupement
Champ de type alphanumérique
50
82
Prix d'achat
Champ de type numérique
83
IsClient
Utilisé dans l'import du type de pièce devis pour faire la distinction entre un devis client et un devis prospect.
Par défaut si pas renseigné.
Champ de type numérique 1=Client, 0=Prospect
1
84
Date d'accord
Utilisé dans l'import du type de pièce devis.
Champ de type date
85
Civilité du contact livraison
Champ de type alphanumérique
50
86
Adresse 2 du contact livraison
Champ de type alphanumérique
50
87
Adresse 3 du contact livraison
Champ de type alphanumérique
50