Aide en ligne
Importation automatique »

Comment importer vos données automatiquement ?

Chargement en cours Chargement en cours
Pour bénéficier de cette interface, utilisez un script qui enverra chaque nuit (par exemple), ou plusieurs fois par jour vos fichiers pièces, clients, utilisateurs (optionnel) et contacts (optionnel) sur notre serveur.
Ce programme devra envoyer des fichiers CSV ou TXT (fichier séparé par des points virgules dans les données du POST) en utilisant les identifiants, adresses et syntaxes ci-dessous :
how api works

Connexion à votre compte via notre API

Pour vous connecter, utilisez cet identifiant et ce mot de passe :
Adresse / URL :
https://account.mydsomanager.com/api/
Vous devez être connecté pour voir ces informations
Exemple « Headers »
POST ...
...
Authorization: Vous devez être connecté pour voir ces informations
...
			

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, ...)

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èceLink
Valeurs possibles: AVO, DPA, FAC, ODI, RGL, TRT
item_unique_key Identifiant pièce unique
Exemple « Headers » et « Data »
POST /api/items HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Vous devez être connecté pour voir ces informations
...

"item_type";"item_number";"client_code";"item_date_issue";"item_date_issue";"item_amount_initial_inc_tax";"item_currency"
"FAC";"00000123";"C0001";"2024-12-15";"2024-12-22";"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

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_line2 Adresse (Rue Ligne 2)
client_address_street_line3 Adresse (Rue Ligne 3)
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 * 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_matricule Commercial associé au client / Matricule
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
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: account.mydsomanager.com
...
Authorization: Vous devez être connecté pour voir ces informations
...

"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

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: account.mydsomanager.com
...
Authorization: Vous devez être connecté pour voir ces informations
...

"contact_firstname";"contact_lastname";"contact_role";"client_code"
"Mike";"Jackson";"other";"C0001"
...
   			
Colonnes obligatoires : client_code + contact_lastname

Associer les utilisateurs à vos clients

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
user_matricule Matricule
Exemple « Headers » et « Data »
POST /api/users HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Vous devez être connecté pour voir ces informations
...

"user_firstname";"user_lastname";"client_code"
"John";"Roy";"C0001"
...
			
Colonnes obligatoires : client_code + user_lastname
If you want, you can use the path "/apiPutFiles/" to import the files asynchronously.

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)",
	},
}
			
← Retour : Aide en ligne » Questions diverses