Aide en ligne
Importation automatique »
Comment importer vos données automatiquement ?
Chargement en coursPour 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 :
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:
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://account.mydsomanager.com/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:
|
| 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: 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-04-25";"2024-05-02";"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://account.mydsomanager.com/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_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 | |
| 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
Adresse / URL : https://account.mydsomanager.com/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 | |
| 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:
|
| 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
Adresse / URL : https://account.mydsomanager.com/api/users
Utiliser le SSL pour sécuriser vos connexions
Syntaxe des colonnes du fichier CSV :
| Colonnes | Description |
|---|---|
| client_code * | Code client |
| user_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)",
},
}
Importez en automatique vos données par FTPs ou SFTP !
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 :
Compatible avec une multitude de logiciels: 
...
...Connexion à votre compte via FTP sécurisé ou contactez-nous pour utiliser SFTP
Pour vous connecter, utilisez cet identifiant et ce mot de passe :
Vous devez souscrire à la Version PRO pour avoir les codes d'accès
Mise en place :
- Utilisez les mêmes fichiers CSV que vous utilisez lors de l'importation manuelle « Smart Upload »
- Nommez-les de telle manière que MY DSO MANAGER sache quel type de fichier est envoyé
(les fichiers Clients doivent commencer par "clients", les fichiers Pièces par "pieces" et les fichiers Contacts par "contacts") - Envoyez ces fichiers
- Les données sont instantanément traitées et mises à jour dans votre compte. Le fichier que vous venez d'envoyer est remplacé par un fichier rapport qui vous indique si tout s'est bien passé et combien il y a eu de modifications.
Aperçu en utilisant le logiciel FileZilla pour transférer vos fichiers :
Cet aperçu montre une importation manuelle mais vous pouvez tout à fait la rendre automatique en créant un script qui envoie les fichiers CSV.
Comment automatiser l'envoi via FTP sécurisé :
Envoi via curl (Windows, Linux) :
curl -u login:password ftp://ftp.mydsomanager.com:21 --ftp-ssl --ftp-pasv -T clients.csv
Envoi via LFTP (Linux, Windows via cygwin) :
lftp -e "set ftp:prefer-epsv no; put clients.csv; quit" -u login,password ftp.mydsomanager.com
Envoi via WinSCP (Windows) :
winscp.com /ini=nul /command "open ftpes://login:password@ftp.mydsomanager.com/" "put clients.csv" "exit"
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).
Liste des logiciels connectés en automatique avec My DSO Manager :
Synchronisez vos données Salesforce dans My DSO Manager
Données qui peuvent être synchronisées : Clients + Contacts
Fonctionne seulement avec la version Enterprise et Unlimited de Salesforce
Synchronisez vos données Pennylane dans My DSO Manager
Données qui peuvent être synchronisées : Clients + Pièces (Factures, ...)
Synchronisez vos données QuickBooks dans My DSO Manager
Données qui peuvent être synchronisées : Clients / Contacts + Pièces (Factures, ...)
Synchronisez vos données Odoo dans My DSO Manager
Données qui peuvent être synchronisées : Clients + Pièces (Factures, ...) + Contacts
Synchronisez vos données Creditsafe dans My DSO Manager
Retrouvez les notes et les recommandations de limite de crédit de Creditsafe dans My DSO Manager
Synchronisez vos données Chorus Pro dans My DSO Manager
Données qui peuvent être synchronisées : Pièces (Factures, ...)
Synchronisez vos données Allianz Trade dans My DSO Manager
Retrouvez les données des garanties assureurs de Allianz Trade dans My DSO Manager
Synchronisez vos données BVD dans My DSO Manager
Retrouvez les notes et les recommandations de limite de crédit de Bureau van Dijk dans My DSO Manager
Synchronisez vos données Groupama dans My DSO Manager
Retrouvez les données des garanties assureurs de Groupama Assurance-crédit dans My DSO Manager
Synchronisez vos données DNB dans My DSO Manager
Retrouvez les notes et les recommandations de limite de crédit de Dun & Bradstreet dans My DSO Manager
Synchronisez vos données Ellisphere dans My DSO Manager
Retrouvez les notes et les recommandations de limite de crédit de Ellisphere dans My DSO Manager
Synchronisez vos données Infolegale dans My DSO Manager
Retrouvez les notes et les recommandations de limite de crédit de Infolegale dans My DSO Manager
Synchronisez vos données Intuiz dans My DSO Manager
Retrouvez les notes et les recommandations de limite de crédit de Intuiz+ by Altares dans My DSO Manager
Synchronisez vos données ScoresDecisions dans My DSO Manager
Retrouvez les notes et les recommandations de limite de crédit de Scores & Decisions dans My DSO Manager
Synchronisez vos données itool dans My DSO Manager
Données qui peuvent être synchronisées : Clients / Contacts + Pièces (Factures, ...)
Synchronisez vos données Secib dans My DSO Manager
Données qui peuvent être synchronisées : Clients + Pièces (Factures, ...)
Synchronisez vos données Sellsy dans My DSO Manager
Données qui peuvent être synchronisées : Clients + Pièces (Factures, ...)
Synchroniser
Bientôt disponible ...
Entrez votre email pour savoir quand cette fonctionnalité sera mise en place :
← Retour : Aide en ligne » Questions diverses