Aide en ligne

Si vous avez des questions, contactez-nous

Comment importer vos données automatiquement ?

Chargement en cours

Pour utiliser cette interface, créez un script qui enverra chaque nuit (par exemple) vos fichiers de pièces, de clients et de contacts (optionnel).

Ce programme devra envoyer un fichier CSV (fichier séparé par des points virgules dans les données du POST) en utilisant les identifiants, adresses et syntaxes ci-dessous :

Connexion à votre compte via notre API

Pour vous connecter, utilisez cet identifiant et ce mot de passe :

Vous devez être connecté pour accéder à cette page

Exemple « Headers »

POST ...
...
Authorization: Basic xxxxxxxxxxxxxxxxxxx
...

Options de l'importation

Utilisez ces options uniquement si vous en avez besoin :

Paramètre	API	Description
encoding	all	Format du fichier Valeurs possibles: UTF-8 (par défaut), ISO-8859-1, ...
clear_items_not_modified	items	Solder automatiquement les pièces ? Valeurs possibles: true : Mode « STOCK » → J'importe systématiquement toutes les pièces non soldées (factures, avoirs, opérations diverses...non encore lettrés et soldés). Dans ce cas, si une pièce est présente lors d'un import et qu'elle ne l'est plus dans le suivant, MY DSO MANAGER la soldera automatiquement. false : Mode « DELTA » → J'importe toutes les nouvelles pièces (factures, avoirs, opérations diverses...non encore lettrés et soldés) émises depuis le dernier import ainsi que toutes celles qui ont été soldées. Ces dernières ont le champ 'item_date_payment' renseigné avec la date à laquelle chaque pièce a été soldée dans le système comptable Cela permettra à MY DSO MANAGER de les solder également. Par défaut: false
replace_users_association	users	Remplacer les associations clients/utilisateurs ou ajouter uniquement les nouvelles associations clients/utilisateurs ? Valeurs possibles: 0 ou 1 Par défaut: 0

Exemple « Headers » et « Data »

POST /api/items?encoding=UTF-8&clear_items_not_modified=true HTTP/1.1
...

data...

Ajoutez et modifiez vos pièces (factures, avoirs, ...)

Adresse / URL : https:///api/items

Utiliser le SSL pour sécuriser vos connexions

Syntaxe des colonnes du fichier CSV :

Colonnes	Description
client_code *	Code client
item_amount_initial	Montant initial HT
item_amount_initial_inc_tax *	Montant initial TTC Exemple / Valeurs possibles: 1200 1 200,00 1200.00123 ...
item_amount_remaining	Montant restant HT
item_amount_remaining_inc_tax	Montant restant TTC
item_business_case	Nom de l'affaire
item_currency	Devise Exemple: EUR, USD, ...
item_date_due *	Date échéance Format de la date: YYYY-MM-DD
item_date_issue *	Date émission Format de la date: YYYY-MM-DD
item_date_order	Date commande Format de la date: YYYY-MM-DD
item_date_payment	Date paiement Format de la date: YYYY-MM-DD
item_erp_type	Type de pièce ERP
item_file_number	N° de dossier
item_number *	N° pièce
item_order_number	N° commande
item_sales_administrative	Acteur ADV
item_sales_manager	Commercial
item_type *	Type de pièce Valeurs possibles: FAC, AVO, RGL, ODI, TRT, DPA
item_unique_key	Identifiant pièce unique

Exemple « Headers » et « Data »

POST /api/items HTTP/1.1
Host: 
...
Authorization: Basic xxxxxxxxxxxxxxxxxxx
...

"item_type";"item_number";"client_code";"item_date_issue";"item_date_due";"item_amount_initial_inc_tax";"item_currency"
"FAC";"00000123";"C0001";"2021-07-27";"2021-08-03";"6 580,10";"USD"
...

Colonnes obligatoires : client_code + item_type + item_number + item_date_issue + item_date_due + item_amount_initial_inc_tax

Ajoutez et modifiez vos clients

Adresse / URL : https:///api/clients

Utiliser le SSL pour sécuriser vos connexions

Syntaxe des colonnes du fichier CSV :

Colonnes	Description
client_address_city	Adresse (Ville)
client_address_country	Adresse (Pays)
client_address_postbox	Adresse (Boîte postale)
client_address_state	Adresse (Etat / Province)
client_address_street	Adresse (Rue)
client_address_street_number	Adresse (n° Rue)
client_address_zip	Adresse (Code postal)
client_blocked	Compte bloqué (Oui / Non) Valeurs possibles: 0, 1 (par défaut: 0 <=> Non)
client_blocked_date	Compte bloqué / Date Format de la date: YYYY-MM-DD
client_business_line	Marché
client_business_name *	Société / Raison sociale
client_code *	Code client
client_comments	Commentaires
client_commercial_email	Commercial associé au client / Email
client_commercial_fax	Commercial associé au client / Fax
client_commercial_firstname	Commercial associé au client / Prénom
client_commercial_lastname	Commercial associé au client / Nom
client_commercial_phone	Commercial associé au client / Téléphone
client_commercial_phone_cell	Commercial associé au client / Téléphone portable
client_credit_limit	Risque / Limite de crédit
client_email	Email
client_fax	Fax
client_group	Groupes Liste des groupes du client séparé par des virgules
client_guarantee_insurer	Risque / Garantie assureur
client_guarantee_insurer_reference	Risque / Référence assureur
client_guarantee_score	Risque / Score
client_guarantee_temporary	Risque / Garantie temporaire
client_guarantee_temporary_date_end	Risque / Garantie temporaire / Date de fin
client_guarantee_temporary_date_start	Risque / Garantie temporaire / Date de début
client_guarantee_type	Risque / Type de garantie
client_guarantees_currency	Risque / Devise des garanties
client_id	Identifiant légal (Siren)
client_order_backlog	Portefeuille de commandes
client_others_guarantees	Risque / Autres garanties
client_payment_mean	Moyen de paiement
client_payment_term	Délai de paiement
client_phone	Téléphone
client_phone_cell	Téléphone portable
client_siret	Siret (pour les entreprises françaises)
client_trading_name	Enseigne
client_unique_key	Identifiant client unique
client_url	Site Internet
client_vat	Numéro de TVA

Exemple « Headers » et « Data »

POST /api/clients HTTP/1.1
Host: 
...
Authorization: Basic xxxxxxxxxxxxxxxxxxx
...

"client_business_name";"client_code";"client_id";"client_address_country"
"My company";"C0001";"FR12345678";"France"
...

Colonnes obligatoires : client_code + client_business_name

Ajoutez des contacts à vos clients

Adresse / URL : https:///api/contacts

Utiliser le SSL pour sécuriser vos connexions

Syntaxe des colonnes du fichier CSV :

Colonnes	Description
client_code *	Code client
contact_collection	Contact pour le recouvrement (Oui / Non) Valeurs possibles: 0, 1 (par défaut: 0 <=> Non)
contact_comments	Commentaires
contact_email	Email
contact_fax	Fax
contact_firstname	Prénom
contact_lastname *	Nom
contact_phone	Téléphone
contact_phone_cell	Téléphone portable
contact_role	Rôle Valeurs possibles: accounting : Comptable buyer : Acheteur company : Société manager : Dirigeant other : Autre (par défaut)
contact_title	Titre (Mr, Mme ...)
contact_unique_key	Identifiant contact unique

Exemple « Headers » et « Data »

POST /api/contacts HTTP/1.1
Host: 
...
Authorization: Basic xxxxxxxxxxxxxxxxxxx
...

"contact_firstname";"contact_lastname";"contact_role";"client_code"
"Mike";"Jackson";"other";"C0001"
...

Colonnes obligatoires : client_code + contact_lastname

Associer les utilisateurs à vos clients

Adresse / URL : https:///api/users

Utiliser le SSL pour sécuriser vos connexions

Syntaxe des colonnes du fichier CSV :

Colonnes	Description
client_code *	Code client
user_email	Email
user_firstname	Prénom
user_lastname *	Nom

Exemple « Headers » et « Data »

POST /api/users HTTP/1.1
Host: 
...
Authorization: Basic xxxxxxxxxxxxxxxxxxx
...

"user_firstname";"user_lastname";"client_code"
"John";"Roy";"C0001"
...

Colonnes obligatoires : client_code + user_lastname

Données en retour

Après avoir effectuer le POST de ces données, MY DSO MANAGER va les traiter immédiatement, et va répondre si il y a eu une erreur ou combien de données ont été ajoutées et modifiées.

Cette réponse sera au format JSON et retournera les informations suivantes :

Champ	Description
success	Indique si l'importation s'est bien effectuée Valeurs possibles: true, false
error_code	Code d'erreur (si il y a eu une erreur) Valeurs possibles: ACCESS_DENIED, CSV_EMPTY, CSV_BAD_SYNTAX, ...
error_description	Message d'erreur (si il y a eu une erreur)
exception_lines	Lignes qui ont été ignorées (pas défini si aucune ligne ignorée)
nb_client_added	Clients ajoutés
nb_client_modified	Clients modifiés
nb_contact_added	Contacts ajoutés
nb_item_added	Pièces ajoutées
nb_item_modified	Pièces modifiées
nb_user_added	Utilisateurs ajoutés
nb_user_modified	Utilisateurs modifiés

Exemple « Response »

{
	"success": "true",
	"nb_client_added": 0,
	"nb_client_modified": 0,
	"nb_contact_added": 0,
	"nb_item_added": 5,
	"nb_item_modified": 2,
	"nb_user_added": 0,
	"nb_user_modified": 0,
	"exception_lines": {
		"line 3": "Column count doesn't match (defined=8, found=10)",
	},
}

Grâce à nos connecteurs, vous pouvez importer vos données clients et comptables (factures, avoirs, ...) de manière simple et automatisée !

Pour cela, sélectionnez votre logiciel de gestion et suivez les instructions ci-dessous pour synchroniser vos données avec My DSO Manager à la fréquence que vous souhaitez (tous les jours, toutes les semaines ou manuellement).