Učitavanje...
Online pomoć
Ako imate pitanja, kontaktirajte nas

Automatic import »

How to import your data automatically?

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

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

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

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

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

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)",
	},
}
← Nazad : Online pomoć » Razni upiti