Aide en ligne

Importation automatique » Comment importer vos données automatiquement ?

Chargement en cours 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) 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 :
Identifiant :
xxxx
Mot de passe :
Exemple :
POST ...
...
Authorization: Basic xxxxxxxxxxxxxxxxxxx
...

Options de l'importation

Utilisez ces options uniquement si vous en avez besoin :
Paramètre Description
encoding Format du fichier
Valeurs possibles: UTF-8 (par défaut), ISO-8859-1, ...
clear_items_not_modified 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
Exemple :
POST /api/items?encoding=UTF-8&clear_items_not_modified=true HTTP/1.1
...

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_sense_writing Sens de l'écriture
item_type * Type de pièceLink
Valeurs possibles: FAC, AVO, RGL, ODI, TRT, DPA
item_unique_key Identifiant pièce unique
Exemple :
POST /api/items HTTP/1.1
Host: www.mydsomanager.com
...
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";"2019-08-21";"2019-08-28";"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 (Département / Région)
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_group_key Code groupement
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_url Site Internet
client_vat Numéro de TVA
Exemple :
POST /api/clients HTTP/1.1
Host: www.mydsomanager.com
...
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

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 ...)
Exemple :
POST /api/contacts HTTP/1.1
Host: www.mydsomanager.com
...
Authorization: Basic xxxxxxxxxxxxxxxxxxx
...

"contact_firstname";"contact_lastname";"contact_email";"contact_role";"client_code"
"Mike";"Jackson";"test@test.com";"other";"C0001"
...
    
Colonnes obligatoires : client_code + contact_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
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
Exemple :
{
	"success": "true",
	"error_code": "",
	"error_description": "",
	"nb_client_added": 0,
	"nb_client_modified": 0,
	"nb_contact_added": 0,
	"nb_item_added": 5,
	"nb_item_modified": 2
}

← Retour : Aide en ligne » Questions diverses