Se încarcă...
Ajutor online
Dacă aveți întrebări, contactați-ne

Automatic import »

How to import your data automatically?

Translate this page to RomanianRomanian ?
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:
how api works

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

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 documentLink
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

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

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

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)",
	},
}
← Înapoi : Ajutor online » Diverse întrebări