Automatski uvoz vaših podataka → putem FTP-a (Sigurni FTP)

Online pomoć

Automatic import »
How to import your data automatically?

Translate this page to

Učitavanje...

Da biste koristili ovo sučelje, upotrijebite skriptu koja će svake noći (na primjer), ili nekoliko puta dnevno, slati vaše datoteke stavki, klijenata, korisnika (neobavezno) i kontakata (neobavezno) na naš server.

Ovaj program mora slati CSV ili TXT datoteke (datoteka odvojena točkom-zarezom u POST podacima) koristeći identifikatore, adrese i sintakse navedene u nastavku:

Prijava na vaš račun putem našeg API-ja

Za prijavu koristite ovaj identifikator i ovu lozinku:

Adresa / URL:

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

Morate biti prijavljeni da biste vidjeli ove informacije

Primjer « Headers »

POST ...
...
Authorization: Morate biti prijavljeni da biste vidjeli ove informacije
...

Opcije uvoza

Koristite ove opcije samo ako su vam potrebne:

Parametar	API	Opis
encoding	all	Format datoteke Moguće vrijednosti: UTF-8 (prema zadanim postavkama), ISO-8859-1, ...
clear_items_not_modified	items	Automatsko podmirenje stavki? Moguće vrijednosti: true:Način rada « STOCK » → Uvozno preuzimam sve neizmirene stavke (fakture, odobrenja, razne operacije… koje još nisu proknjižene i zatvorene). U tom slučaju, ako je neka stavka prisutna tijekom jednog uvoza, a više nije u sljedećem, MY DSO MANAGER će je automatski zatvoriti. false:Način rada « DELTA » → Uvozim sve nove stavke (fakture, odobrenja, razne operacije… koje još nisu proknjižene i zatvorene) izdane od posljednjeg uvoza, kao i sve one koje su u međuvremenu zatvorene. Za potonje je polje ‘item_date_payment' popunjeno datumom na koji je svaka stavka zatvorena u računovodstvenom sustavu. To će omogućiti MY DSO MANAGER-u da ih također zatvori. Prema zadanim postavkama: false
replace_users_association	users	Zamijeniti poveznice klijenti/ korisnici ili dodajte samo nove asocijacije klijenata/korisnika? Moguće vrijednosti: 0 ili 1 Prema zadanim postavkama: 0

Primjer « Headers » i « Data »

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

data...

Dodajte i uređujte svoje stavke (fakture, knjižna odobrenja, ...)

Adresa / URL: https://account.mydsomanager.com/api/items

Koristite SSL za zaštitu vaših veza

Sintaksa stupaca CSV datoteke:

Stupci	Opis
client_code *	šifra klijenta
item_amount_initial	Početni iznos računa bez PDV-a
item_amount_initial_inc_tax *	Početni iznos računa uključujući PDV Primjer / Moguće vrijednosti: 1200 1 200,00 1200.00123 ...
item_amount_remaining	Preostali iznos računa bez PDV-a
item_amount_remaining_inc_tax	Preostali iznos računa uključujući PDV
item_business_case	Naziv predmeta
item_currency	Valuta Primjer: EUR, USD, ...
item_date_due *	Datum dospijeća Format datuma: YYYY-MM-DD
item_date_issue *	Datum izdavanja računa Format datuma: YYYY-MM-DD
item_date_order	Datum narudžbe Format datuma: YYYY-MM-DD
item_date_payment	Datum plaćanja Format datuma: YYYY-MM-DD
item_erp_type	klasifikacija stavke u ERP-u
item_file_number	Broj predmeta
item_number *	Br. računa
item_order_number	PO br.
item_sales_administrative	Prodajna administracija
item_sales_manager	Voditelj prodaje
item_type *	Vrsta stavke Moguće vrijednosti: AVO, DPA, FAC, ODI, RGL, TRT
item_unique_key	Jedinstveni identifikator stavke

Primjer « Headers » i « Data »

POST /api/items HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Morate biti prijavljeni da biste vidjeli ove informacije
...

"item_type";"item_number";"client_code";"item_date_issue";"item_date_issue";"item_amount_initial_inc_tax";"item_currency"
"FAC";"00000123";"C0001";"2026-03-14";"2026-03-21";"6 580,10";"USD"
...

Obavezni stupci : client_code + item_type + item_number + item_date_issue + item_date_due + item_amount_initial_inc_tax

Dodajte i uređujte svoje klijente

Adresa / URL: https://account.mydsomanager.com/api/clients

Koristite SSL za zaštitu vaših veza

Sintaksa stupaca CSV datoteke:

Stupci	Opis
client_address_city	Adresa (Grad)
client_address_country	Adresa (Zemlja)
client_address_postbox	Adresa (Poštanski pretinac)
client_address_state	Adresa (Država/pokrajina)
client_address_street	Adresa (Ulica)
client_address_street_line2	Adresa (Ulica Linija 2)
client_address_street_line3	Adresa (Ulica Linija 3)
client_address_street_number	Adresa (n° Ulica)
client_address_zip	Adresa (Poštanski broj)
client_blocked	Račun blokiran (Da / Ne) Moguće vrijednosti: 0, 1 (prema zadanim postavkama: 0 <=> Ne)
client_blocked_date	Račun blokiran / Datum Format datuma: YYYY-MM-DD
client_business_line	Poslovna linija
client_business_name *	Naziv tvrtke
client_code *	šifra klijenta
client_comments	Komentari
client_commercial_email	Voditelj prodaje povezan s klijentom / E-pošta
client_commercial_fax	Voditelj prodaje povezan s klijentom / Fax
client_commercial_firstname	Voditelj prodaje povezan s klijentom / Ime
client_commercial_lastname	Voditelj prodaje povezan s klijentom / Prezime
client_commercial_matricule	Voditelj prodaje povezan s klijentom / Identifikacijski broj
client_commercial_phone	Voditelj prodaje povezan s klijentom / Telefon
client_commercial_phone_cell	Voditelj prodaje povezan s klijentom / Mobilni telefon
client_credit_limit	Rizik / Kreditno ograničenje
client_email	E-pošta
client_fax	Fax
client_group	Grupe Popis grupa klijenta odvojenih zarezima
client_guarantee_insurer	Rizik / Jamstvo osiguravatelja
client_guarantee_insurer_reference	Rizik / Referenca osiguravatelja
client_guarantee_score	Rizik / Rezultat
client_guarantee_temporary	Rizik / Privremeno jamstvo
client_guarantee_temporary_date_end	Rizik / Privremeno jamstvo / Datum završetka
client_guarantee_temporary_date_start	Rizik / Privremeno jamstvo / Početni datum
client_guarantee_type	Rizik / Vrsta jamstva
client_guarantees_currency	Rizik / Valuta jamstava
client_id	Pravni identifikacijski broj
client_order_backlog	Katalog narudžbi
client_others_guarantees	Rizik / Ostala jamstva
client_payment_mean	Naćin plaćanja
client_payment_term	Rok plaćanja
client_phone	Telefon
client_phone_cell	Mobilni telefon
client_siret	Siret (za francuske tvrtke)
client_trading_name	Trgovačko ime
client_unique_key	Jedinstveni identifikator klijenta
client_url	Web stranica
client_vat	PDV broj

Primjer « Headers » i « Data »

POST /api/clients HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Morate biti prijavljeni da biste vidjeli ove informacije
...

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

Obavezni stupci : client_code + client_business_name

Dodajte kontakte svojim klijentima

Adresa / URL: https://account.mydsomanager.com/api/contacts

Koristite SSL za zaštitu vaših veza

Sintaksa stupaca CSV datoteke:

Stupci	Opis
client_code *	šifra klijenta
contact_collection	Kontakt za naplatu potraživanja (Da / Ne) Moguće vrijednosti: 0, 1 (prema zadanim postavkama: 0 <=> Ne)
contact_comments	Komentari
contact_email	E-pošta
contact_email_copy_collection_auto	E-pošta u kopiji u automatskim e-porukama (Da / Ne) Moguće vrijednosti: 0, 1 (prema zadanim postavkama: 0 <=> Ne)
contact_fax	Fax
contact_firstname	Ime
contact_lastname *	Prezime
contact_phone	Telefon
contact_phone_cell	Mobilni telefon
contact_role	Uloga Moguće vrijednosti: accounting: Računovođa buyer: Klijent company: Društvo manager: Izvršni djelatnik other: Ostali (prema zadanim postavkama)
contact_title	Naziv (Gosp, gđa ...)
contact_unique_key	Jedinstveni identifikator kontakta

Primjer « Headers » i « Data »

POST /api/contacts HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Morate biti prijavljeni da biste vidjeli ove informacije
...

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

Obavezni stupci : client_code + contact_lastname

Povežite korisnike s vašim klijentima

Adresa / URL: https://account.mydsomanager.com/api/users

Koristite SSL za zaštitu vaših veza

Sintaksa stupaca CSV datoteke:

Stupci	Opis
client_code *	šifra klijenta
user_email	E-pošta
user_firstname	Ime
user_lastname *	Prezime
user_matricule	Identifikacijski broj

Primjer « Headers » i « Data »

POST /api/users HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Morate biti prijavljeni da biste vidjeli ove informacije
...

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

Obavezni stupci : client_code + user_lastname

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

Povratni podaci

Nakon što se izvrši POST ovih podataka, MY DSO MANAGER će ih odmah obraditi te će odgovoriti je li došlo do pogreške ili koliko je podataka dodano i izmijenjeno.

Ovaj će odgovor biti u JSON formatu i sadržavat će sljedeće informacije:

Polje	Opis
success	Označava je li uvoz uspješno izvršen Moguće vrijednosti: true, false
error_code	Kod greške (ako je došlo do greške) Moguće vrijednosti: ACCESS_DENIED, CSV_EMPTY, CSV_BAD_SYNTAX, ...
error_description	Poruka o grešci (ako je došlo do greške)
exception_lines	Redovi koji su preskočeni (nije definirano ako nije preskočen nijedan redak)
nb_client_added	Dodanih klijenata
nb_client_modified	Ažuriranih klijenata
nb_contact_added	Dodanih kontakta
nb_item_added	Dodanih stavki
nb_item_modified	Ažuriranih stavki
nb_user_added	Dodanih korisnika
nb_user_modified	Ažuriranih korisnika

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

Automatski uvezite svoje podatke putem FTP-a ili SFTP-a!

Ovaj program mora slati CSV ili TXT datoteke (datoteka odvojena točkom-zarezom u POST podacima) koristeći identifikatore, adrese i sintakse navedene u nastavku:

How FTPs and SFTP works with My DSO Manager

Kompatibilan s velikim brojem softvera: SAP

...

Prijava na vaš račun putem Sigurni FTP ili kontaktirajte nas za korištenje SFTP

Za prijavu koristite ovaj identifikator i ovu lozinku:

Postaviti:

Koristite iste CSV datoteke koje koristite pri ručnom uvozu « Smart Upload »
Imenujte ih na način da MY DSO MANAGER može prepoznati o kojoj se vrsti datoteke radi
(datoteke Klijenata moraju započinjati s \ »klijenti", datoteke Stavki s \ »stavke", a datoteke Kontakata s \ »kontakti")
Pošaljite ove datoteke
Podaci se obrađuju i ažuriraju u vašem računu trenutačno. Datoteka koju ste upravo poslali zamjenjuje se izvještajnom datotekom koja vam pokazuje je li sve prošlo u redu i koliko je izmjena napravljeno.

Pregled korištenjem softvera FileZilla za prijenos vaših datoteka:

Ovaj pregled prikazuje ručni uvoz, ali možete ga u potpunosti automatizirati izradom skripte koja šalje CSV datoteke.

Kako automatizirati slanje putem sigurnog FTP-a:

Slanje putem curl (Windows, Linux):

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

Slanje putem LFTP (Linux, Windows via cygwin):

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

Slanje putem WinSCP (Windows):

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

Zahvaljujući našim poveznicama možete jednostavno i automatizirano uvoziti svoje podatke o klijentima i računovodstvu (fakture, odobrenja, …)!

U tu svrhu odaberite svoj upravljački softver i slijedite upute u nastavku kako biste sinkronizirali svoje podatke s My DSO Manager u željenoj učestalosti (svakodnevno, tjedno ili ručno).