Importați automat datele dvs → prin conectoriI noștri

Ajutor online

Automatic import »
How to import your data automatically?

Translate this page to

Se încarcă...

Pentru a beneficia de această interfață, utilizați un script care va trimite în fiecare noapte (de exemplu) sau de mai multe ori pe zi fișierele dvs. cu documente, clienți, utilizatori (opțional) și contacte (opțional) pe serverul nostru.

Acest program va trebui să trimită fișiere CSV sau TXT (fișiere separate prin punct și virgulă în datele POST) utilizând identificatorii, adresele și sintaxele de mai jos:

Conectare la contul dvs. prin API-ul nostru

Pentru a vă conecta, utilizați acest ID și această parolă:

Adresă / URL:

https://account.mydsomanager.com/api/

Trebuie să fiți conectat pentru a vedea aceste informații

Exemplu « Headers »

POST ...
...
Authorization: Trebuie să fiți conectat pentru a vedea aceste informații
...

Opțiuni de import

Utilizați aceste opțiuni numai dacă aveți nevoie de ele:

Parametru	API	Descriere
encoding	all	Formatul fișierului Possible values: UTF-8 (în mod implicit), ISO-8859-1, ...
clear_items_not_modified	items	Stingerea automată a documentelor? Possible values: true:Modul « STOCK » → Import în mod sistematic toate documentele nesoldate (facturi, note de credit și alte operațiuni restante, nesoldate și nestinse). Dacă un document este prezent în importul din ziua "D", dar lipsește în cel din "D+1", MY DSO MANAGER îl va marca automat ca stins. false:Modul « DELTA » → Import toate documentele nesoldate (facturi, note de credit, operațiuni diverse... care nu sunt încă soldate și stinse) emise de la ultimul import, precum și toate cele care au fost stinse. Acestea din urmă au câmpul "item_date_payment" completat cu data la care fiecare document a fost stins în sistemul contabil. Acest lucru va permite MY DSO MANAGER să le marcheze de asemenea ca fiind stinse. în mod implicit: false
replace_users_association	users	Înlocuiți asocierile clienți/utilizatori Sau adăugați numai asocierile noi clienți/utilizatori? Possible values: 0 Sau 1 în mod implicit: 0

Exemplu « Headers » Și « Data »

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

data...

Adăugați și modificați documentele dvs. (facturi, note de credit, ...)

Adresă / URL: https://account.mydsomanager.com/api/items

Utilizați SSL pentru a securiza conexiunile

Sintaxa coloanelor fișierului CSV:

Coloane	Descriere
client_code *	Cod client
item_amount_initial	Sumă inițială Fără taxe
item_amount_initial_inc_tax *	Sumă inițială TVA inclus Exemplu / Possible values: 1200 1 200,00 1200.00123 ...
item_amount_remaining	Sumă restantă Fără taxe
item_amount_remaining_inc_tax	Sumă restantă TVA inclus
item_business_case	Numele cazului
item_currency	Valută Exemplu: EUR, USD, ...
item_date_due *	Data scadenței Formatul datei: YYYY-MM-DD
item_date_issue *	Data emiterii Formatul datei: YYYY-MM-DD
item_date_order	Data comenzii Formatul datei: YYYY-MM-DD
item_date_payment	Data plății Formatul datei: YYYY-MM-DD
item_erp_type	Tip de document ERP
item_file_number	Numărul dosarului
item_number *	Numărul documentului
item_order_number	Numarul comenzii de achiziție
item_sales_administrative	Asistant ADV
item_sales_manager	Manager de vânzări
item_type *	Tip de document Possible values: AVO, DPA, FAC, ODI, RGL, TRT
item_unique_key	Identificator de document unic

Exemplu « Headers » Și « Data »

POST /api/items HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Trebuie să fiți conectat pentru a vedea aceste informații
...

"item_type";"item_number";"client_code";"item_date_issue";"item_date_issue";"item_amount_initial_inc_tax";"item_currency"
"FAC";"00000123";"C0001";"2026-04-29";"2026-05-06";"6 580,10";"USD"
...

Coloane obligatorii : client_code + item_type + item_number + item_date_issue + item_date_due + item_amount_initial_inc_tax

Adăugați și modificați clienții dvs

Adresă / URL: https://account.mydsomanager.com/api/clients

Utilizați SSL pentru a securiza conexiunile

Sintaxa coloanelor fișierului CSV:

Coloane	Descriere
client_address_city	Adresă (Oraș)
client_address_country	Adresă (Țară)
client_address_postbox	Adresă (Căsuță poștală)
client_address_state	Adresă (Județ / Comună)
client_address_street	Adresă (Stradă)
client_address_street_line2	Adresă (Stradă Linia 2)
client_address_street_line3	Adresă (Stradă Linia 3)
client_address_street_number	Adresă (n° Stradă)
client_address_zip	Adresă (Cod poștal)
client_blocked	Cont blocat (Da / Nu) Possible values: 0, 1 (în mod implicit: 0 <=> Nu)
client_blocked_date	Cont blocat / Data Formatul datei: YYYY-MM-DD
client_business_line	Linie de activitate
client_business_name *	Denumirea societății
client_code *	Cod client
client_comments	Comentarii
client_commercial_email	Agent comercial asociat clientului / E-mail
client_commercial_fax	Agent comercial asociat clientului / Fax
client_commercial_firstname	Agent comercial asociat clientului / Prenume
client_commercial_lastname	Agent comercial asociat clientului / Nume de familie
client_commercial_matricule	Agent comercial asociat clientului / Număr de înregistrare
client_commercial_phone	Agent comercial asociat clientului / Telefon
client_commercial_phone_cell	Agent comercial asociat clientului / Telefon mobil
client_credit_limit	Risc / Limita de credit
client_email	E-mail
client_fax	Fax
client_group	Grupuri Lista grupurilor clientului separate prin virgule
client_guarantee_insurer	Risc / Garanția asigurătorului
client_guarantee_insurer_reference	Risc / Referința asigurătorului
client_guarantee_score	Risc / Scor
client_guarantee_temporary	Risc / Garanție temporară
client_guarantee_temporary_date_end	Risc / Garanție temporară / Data încheierii
client_guarantee_temporary_date_start	Risc / Garanție temporară / Data începerii
client_guarantee_type	Risc / Tip de garanţie
client_guarantees_currency	Risc / Valuta garanțiilor
client_id	Identificator al entității juridice (LEI)
client_order_backlog	Portofoliu de comenzi
client_others_guarantees	Risc / Alte garanții
client_payment_mean	Modalitate de plată
client_payment_term	Termen de plată
client_phone	Telefon
client_phone_cell	Telefon mobil
client_siret	Siret (pentru companii franceze)
client_trading_name	Denumire comercială
client_unique_key	Identificator de client unic
client_url	Site-ul web
client_vat	Număr de TVA

Exemplu « Headers » Și « Data »

POST /api/clients HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Trebuie să fiți conectat pentru a vedea aceste informații
...

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

Coloane obligatorii : client_code + client_business_name

Adăugați contacte la clienții dvs

Adresă / URL: https://account.mydsomanager.com/api/contacts

Utilizați SSL pentru a securiza conexiunile

Sintaxa coloanelor fișierului CSV:

Coloane	Descriere
client_code *	Cod client
contact_collection	Contact pentru recuperarea creanțelor (Da / Nu) Possible values: 0, 1 (în mod implicit: 0 <=> Nu)
contact_comments	Comentarii
contact_email	E-mail
contact_email_copy_collection_auto	Adăugare CC automată în timpul e-mailurilor automate (Da / Nu) Possible values: 0, 1 (în mod implicit: 0 <=> Nu)
contact_fax	Fax
contact_firstname	Prenume
contact_lastname *	Nume de familie
contact_phone	Telefon
contact_phone_cell	Telefon mobil
contact_role	Rol Possible values: accounting: Contabil buyer: Client company: Societate manager: Director other: Alte (în mod implicit)
contact_title	Titlu (Domnul, Doamna...)
contact_unique_key	Identificator de contact unic

Exemplu « Headers » Și « Data »

POST /api/contacts HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Trebuie să fiți conectat pentru a vedea aceste informații
...

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

Coloane obligatorii : client_code + contact_lastname

Asociați utilizatorii cu clienții dvs

Adresă / URL: https://account.mydsomanager.com/api/users

Utilizați SSL pentru a securiza conexiunile

Sintaxa coloanelor fișierului CSV:

Coloane	Descriere
client_code *	Cod client
user_email	E-mail
user_firstname	Prenume
user_lastname *	Nume de familie
user_matricule	Număr de înregistrare

Exemplu « Headers » Și « Data »

POST /api/users HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Trebuie să fiți conectat pentru a vedea aceste informații
...

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

Coloane obligatorii : client_code + user_lastname

If you want, you can use the path "apiPutFiles" to import the files asynchronously.

Date returnate

După trimiterea acestor date prin POST, MY DSO MANAGER le va procesa imediat și va răspunde dacă a apărut o eroare sau câte date au fost adăugate și modificate.

Acest răspuns va fi în format JSON și va returna următoarele informații:

Câmp	Descriere
success	Indică dacă importul a fost efectuat cu succes Possible values: true, false
error_code	Cod de eroare (dacă a apărut o eroare) Possible values: ACCESS_DENIED, CSV_EMPTY, CSV_BAD_SYNTAX, ...
error_description	Mesaj de eroare (dacă a apărut o eroare)
exception_lines	Linii ignorate (nedefinit dacă nu există)
nb_client_added	Clienți adăugați
nb_client_modified	Clienți modificați
nb_contact_added	Contacte adăugate
nb_item_added	Documente adăugate
nb_item_modified	Documente modificate
nb_user_added	Utilizatori adăugați
nb_user_modified	Utilizatori modificați

Exemplu « 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)",
	},
}

Importați automat datele dvs. prin FTPs sau SFTP!

Acest program va trebui să trimită fișiere CSV sau TXT (fișiere separate prin punct și virgulă în datele POST) utilizând identificatorii, adresele și sintaxele de mai jos:

How FTPs and SFTP works with My DSO Manager

Compatibil cu o multitudine de software: SAP

...

Conectare la contul dvs. prin FTP securizat Sau contactați-ne pentru a utiliza SFTP

Pentru a vă conecta, utilizați acest ID și această parolă:

Configurare:

Utilizați aceleași fișiere CSV pe care le utilizați în timpul importului manual « Smart Upload »
Denumiți-le astfel încât MY DSO MANAGER să știe ce tip de fișier este trimis
(fișierele Clienți trebuie să înceapă cu "clienți", fișierele Documente cu "documente" și fișierele Contacte cu "contacte")
Trimiteți aceste fișiere
Datele sunt procesate instantaneu și actualizate în contul dvs. Fișierul pe care tocmai l-ați trimis este înlocuit cu un fișier de raport care indică dacă procesarea a fost realizată cu succes și câte modificări au fost efectuate.

Previzualizare utilizând software-ul FileZilla pentru a transfera fișierele:

Această previzualizare arată o importare manuală, dar o puteți automatiza complet prin crearea unui script care trimite fișierele CSV.

Cum să automatizați trimiterea prin FTP securizat:

Trimitere prin curl (Windows, Linux):

curl -u login:password ftp://ftp.mydsomanager.com:21 --ftp-ssl --ftp-pasv -T clients.csv

Trimitere prin LFTP (Linux, Windows via cygwin):

lftp -e "set ftp:prefer-epsv no; put clients.csv; quit" -u login,password ftp.mydsomanager.com

Trimitere prin WinSCP (Windows):

winscp.com /ini=nul /command "open ftpes://login:password@ftp.mydsomanager.com/" "put clients.csv" "exit"

Prin intermediul conectorilor noștri, puteți importa datele clienților și datele contabile (facturi, note de credit etc.) într-un mod simplu și automatizat!

Pentru aceasta, selectați software-ul dvs. de gestionare și urmați instrucțiunile de mai jos pentru a sincroniza datele dvs. cu My DSO Manager la frecvența dorită (zilnic, săptămânal sau manual).