foire aux questions

Obligatoire

Une balise <NEW> peut être ajoutée après (ou à la place) du document Nb.

a) Si le champ ne contient qu'un numéro et qu'il n'existe pas de document dans WinBIZ pour ce type et ce numéro, un nouveau document sera créé. Son numéro sera celui spécifié dans ce champ.

b) Si le champ ne contient qu'un numéro et qu'un document existe dans WinBIZ pour ce type et ce numéro, les lignes seront ignorées et une erreur sera enregistrée.

c) Si le champ ne contient que le Tag <NEW>, un nouveau document sera créé avec un numéro attribué automatiquement par WinBIZ. Le document contiendra toutes les lignes du fichier.

d) Si le champ contient un numéro et le Tag <NEW>, un nouveau document sera créé avec un numéro attribué par Winbiz.

Obligatoire

Vente - Débiteurs
10 Offre
12 Confirmation de commande
14 Fiche de travaux
16 Bulletins de livraison
17 Soldes initiaux débiteurs
18 Vente au comptant
20 Facture débiteurs
22 Note de crédit du débiteur
24 Paiements de débiteurs (voir ici)

Achats - Créanciers
40 Commandes aux fournisseurs
41 Appels d'offres
42 Réception des marchandises
43 Soldes initiaux créanciers
44 Facture de créanciers
46 Paiements aux créanciers (voir ici)
47 Notes de crédits créanciers
50 Retours de marchandises

Stocks
60 Mouvements de stock

AAAAMMJJ
ou JJ.MM.AAAA

Obligatoire

Remarque : pour les mouvements de stock (valeur 60 dans le champ 2), il peut y avoir des lignes avec une valeur négative dans les champs 53 et 57. Dans ce cas, le montant total en monnaie locale doit refléter ces montants.

Facultatif

Facultatif, si non spécifié : monnaie locale

Obligatoire

Vous pouvez utiliser la balise <AUTO> au lieu de remplir le champ avec un numéro de compte.

Si vous utilisez la balise <AUTO>, WinBIZ va :

a) en premier lieu le compte collectif de l'onglet Créancier de l'adresse ;

b) deuxièmement le compte choisi dans Outils->Options->Comptabilité->Enregistrement -> Onglet Débiteur ou Créancier

c) si aucun compte n'est spécifié à cet endroit, WinBIZ demandera à l'utilisateur de choisir un compte qui sera utilisé par défaut à partir de ce moment.

Facultatif

Vous pouvez utiliser la balise <AUTO> au lieu de remplir le champ avec un numéro de compte.

Si vous utilisez la balise <AUTO> WinBIZ va :

a) utilisera d'abord le compte choisi dans Outils->Options->Comptabilité->Enregistrement -> Onglet Débiteur ou Créancier

b) si aucun compte n'est spécifié à cet endroit, WinBIZ demandera à l'utilisateur de choisir un compte qui sera utilisé par défaut à partir de ce moment.

Facultatif

Les valeurs admises sont :

F - Français

E - anglais

A, D, G - Allemand

I - italien

Facultatif

Les valeurs admises sont les suivantes

1 - Détaillé

2 - Résumée

Si elle est laissée vide, la valeur par défaut est 1 - Détaillé

Facultatif

Ce champ peut contenir l'identifiant du document dans le système externe qui envoie le fichier à WinBIZ.

<UPDATE>

La balise <UPDATE> permet de mettre à jour le contenu du document existant avec le contenu du nouveau fichier wdx. L'identifiant externe du document doit accompagner la balise.

Exemple pour modifier le document existant qui a l'identifiant externe ABC10001 : <UPDATE>ABC10001

<LINEADD>

La balise <LINEADD> permet d'ajouter au contenu du document existant le contenu de l'enregistrement contenant la balise dans le nouveau fichier wdx. L'identifiant externe du document doit accompagner la balise.

Exemple pour ajouter une ligne au document existant qui a l'identifiant externe ABC10001 : <LINEADD>ABC10001

Obligatoire

Lors de l'importation, WinBIZ fait correspondre l'adresse avec :

a) l'adresse existante ayant la même valeur dans le champ Code d'adresse ;

b) si elle n'est pas trouvée, l'adresse existante ayant cette même valeur dans le champ Code d'adresse complémentaire ;

c) si elle n'est pas trouvée, l'adresse existante ayant la même valeur dans le champ Numéro de localisation globale ;

d) si elle n'a pas été trouvée, veuillez vous référer au champ numéro 47.

Remarque : ne pas utiliser les codes des modèles d'adresses.

Facultatif

Les valeurs admises sont les suivantes :

F, 1 - Français

E, 4 - anglais

A, D, G, 2 - allemand

I, 3 - Italien

5 - Autre

AAAAMMJJ
ou JJ.MM.AAAA

Dupont & Dupond SA

Av. de la Gare 123

Optionnel

Les valeurs acceptées sont les suivantes :

2 = ajoute l'adresse si elle n'existe pas. Si l'adresse existe dans WinBIZ, elle sera mise à jour et complétée.

0 = ajoute l'adresse si elle n'existe pas. Si l'adresse existe, ses données sont remplacées par celles du fichier.

1 = ajoute l'adresse si elle n'existe pas, mais ne la met pas à jour si elle existe.

Si le champ est vide, il prend la valeur 0 par défaut.

Facultatif

Les valeurs acceptées vont de 1 à 9999.

Optionnel

Les valeurs acceptées sont les suivantes :

0-1 = élément
2 = Texte
3 = Sous-total, total (voir champ 105)
4 = Titre
7 = Réduction (voir champ 105)

Si le champ n'est pas renseigné, la valeur par défaut est 0 (élément).

Facultatif

(sauf si vous souhaitez ajouter ou mettre à jour se référer à la ligne 74)

Obligatoire

La quantité peut être négative si la valeur du champ n° 2 est 60. Dans ce cas, le mouvement de stock sera une entrée en stock. Dans ce cas, les champs 57 et 6 doivent être ajustés en conséquence.

Facultatif

Les valeurs acceptées vont de 1 à 100.

Obligatoire

Vous pouvez utiliser la balise <AUTO> au lieu de remplir le champ avec un numéro de compte.

Si vous utilisez la balise <AUTO> WinBIZ va :

a) dans un premier temps, utiliser les informations renseignées dans la méthode de comptabilisation utilisée par le poste

b) dans un deuxième temps (uniquement pour les documents du créancier) utiliser les informations renseignées dans la méthode de comptabilisation utilisée par l'adresse

c) deuxièmement utilise le compte choisi dans Outils->Options->Comptabilité-> Comptabilisation -> Onglet Débiteur ou Créancier

d) si aucun compte n'est spécifié à cet endroit, WinBIZ demandera à l'utilisateur de choisir un compte qui sera utilisé par défaut à partir de ce moment.

Optionnel

Les valeurs acceptées sont :

0, 1 = Inclus

2 = Exclu

Si le champ est vide, la valeur par défaut est 0 = Inclus.

Optionnel

Les valeurs acceptées sont :
0, 1 = Brut
2 = Net

Si elle n'est pas renseignée, la valeur par défaut est 0 = Brut.

Facultatif

Si cette valeur est omise, le chiffre de TVA spécifié dans le plan comptable sera utilisé pour le compte du chiffre d'affaires.

1ère méthode : recommandée

Utiliser une balise reprenant le code unique de type TVA introduit dans WinBIZ.

Ex : <VAT_CODE=ABC123> : toutes les informations TVA correspondront au type de TVA ayant

TVA dont le code est égal à ABC123.

L'importation du document recherchera les informations TVA correspondant au Code spécifié dans le Tag. Ce code peut être facilement saisi dans le formulaire utilisé pour modifier les types de TVA. Si cette méthode est utilisée, il n'est pas nécessaire de transmettre les informations dans les champs 61, 63 à 65 et 72.

Cette méthode permet de forcer un chiffre de TVA différent de celui utilisé dans le type de TVA. Cela peut se faire en ajoutant une deuxième balise.

Ex : <VAT_CODE=ABC123><VAT_FIGURE=220>

Nous suggérons de ne pas utiliser ce type de transmission et de créer plutôt un type de TVA correspondant à ces données.

2ème méthode : supportée mais dépréciée

1 = Pas de TVA

2 = TVA due

3 = TVA en amont

4 = TVA exclue

Nous soutenons cette ancienne méthode. Elle est dépréciée car elle oblige à spécifier séparément tous les paramètres TVA dans les champs de 61 à 65 et dans le champ 72.

En utilisant cette méthode, vous pouvez toujours forcer un chiffre de TVA différent de celui utilisé dans le type de TVA. Ceci peut être fait en ajoutant le TAG du chiffre de TVA.

Ex : 4<VAT_FIGURE=220>

Cette méthode est fortement déconseillée.

Facultatif

Les valeurs acceptées sont

0, 1 = 1 ct

2 = 5 cts

4 = 0,1 ct

Si elle est laissée vide, la valeur par défaut est 0 = 1 ct.

Facultatif : à utiliser uniquement si un code est utilisé dans le champ 50.

Les valeurs acceptées sont

0 = ne jamais ajouter et ne jamais mettre à jour la rubrique WinBIZ

>=1 = si un article correspondant au code du champ 50 est trouvé dans WinBIZ, l'article est mis à jour. Sinon, l'article est ajouté.

Facultatif

Pour les types de lignes de réduction (voir zone 49), les valeurs acceptées sont les suivantes :

1 = Calculé sur le montant total du document

2 = Calculé depuis la dernière ligne de réduction

3 = Calculé depuis le dernier sous-total

4 = Calculé depuis le dernier titre

5 = Calculé sur le montant total du document, réductions exclues

6 = Calculé sur le dernier total

Si le type de ligne Réduction n'est pas renseigné, la valeur par défaut est 1.

Pour les types de ligne Sous-total/Total (voir champ 49), les valeurs acceptées sont les suivantes :

0 = Sous-total

1 = Total

Si le champ n'est pas renseigné pour un type de ligne Sous-total/Total, la valeur par défaut est 0.

Facultatif

Les codes pour la mise en page des factures possibles peuvent être renvoyés avec la méthode Messages.

Facultatif

Les codes pour la présentation possible des factures peuvent être renvoyés avec la méthode Invoice Layouts.

Optionnel

Les valeurs acceptées sont les suivantes

0 = Règlement normal

1 = Règlement volontaire

Si la case n'est pas cochée, la valeur par défaut est 0.

Optionnel

Les codes des conditions de paiement possibles peuvent être renvoyés à l'aide de la méthode PaymentTerms.

Optionnel

Il n'est actuellement pas possible d'importer un fichier pdf via l'API.

Facultatif

Ce montant est remboursé sur le total des documents.

Facultatif

Utilisé uniquement pour l'importation des paiements du débiteur et du créancier.

Les codes des méthodes de paiement possibles peuvent être renvoyés avec la méthode Payment Methods.

Optionnel

Les valeurs acceptées sont les suivantes :

0 = Envoyer des rappels

1 = Ne pas envoyer de rappels

Si elle est laissée vide, la valeur par défaut est 0.

Facultatif

BTW :

- Longueur maximale = 254

- L'IBAN sera obligatoire à partir de 2018 : il est fortement conseillé de toujours utiliser l'IBAN, même lorsqu'il n'est pas encore obligatoire.

Voici le lien pour plus de précisions : Instructions de la banque créancière dans le fichier DocumentImport pour les documents