Nahrává se...
Online nápověda
V případě dotazů nás kontaktujte

Automatic import »

How to import your data automatically?

Translate this page to CzechCzech ?
Nahrává se...
Abyste mohli využívat toto rozhraní, použijte scénář, který pošle každý večer (například) nebo několikrát denně vaše neuzavřené záznamy, klienty, uživatele (nepovinné) a kontakty (nepovinné) na náš server.
Tento program musí posílat soubory CSV nebo TXT (soubor s oddělujícími středníky v datech POST) a používat níže uvedené identifikátory, adresy a syntax:
how api works

Přihlášení do vašeho účtu přes API

Chcete-li se přihlásit, použijte toto přihlašovací jméno a heslo:
Adresa / URL:
https://account.mydsomanager.com/api/
Chcete-li zobrazit tyto informace, musíte se přihlásit
Příklad « Headers » 
POST ...
...
Authorization: Chcete-li zobrazit tyto informace, musíte se přihlásit
...

Možnosti importů

Použijte tyto možnosti jen v případě potřeby:
Parametr API Popis
encoding all Formát souboru
Možné hodnoty: UTF-8 (automaticky), ISO-8859-1, ...
clear_items_not_modified items Automaticky uzavřít záznamy?
Možné hodnoty:
  • true:Režim « STOCK » → Systematicky importuji všechny neuzavřené záznamy (faktury, dopropisy, různé operace... ještě nezplacené a neuzavřené). V takovém případě, pokud se záznam nachází v jednom importu a už se nenachází v dalším, MY DSO MANAGER ho automaticky uzavře.
  • false:Režim « DELTA » → Importuji všechny nové záznamy (faktury, dobropisy, různé operace... ještě nezaplacené či neuzavřené) vytvořené od posledního importu, včetně uzavřených záznamů. Uzavřené záznamy obsahuji pole 'item_date_payment' s datem uzavření v účetním systému. To umožní MY DSO MANAGER záznam také uzavřít.
Automaticky: false
replace_users_association users Nahradit přidělení klientů/uživatelů nebo přidat jen nová přidělení klientů/uživatelů?
Možné hodnoty: 0 nebo 1
Automaticky: 0
Příklad « Headers » a « Data » 
POST /api/items?encoding=UTF-8&clear_items_not_modified=true HTTP/1.1
...

data...

Přidejte a upravte vaše záznamy (faktury, dobropis, ...)

Použijte SSL pro zabezpečení vašich připojení
Syntax sloupců souboru CSV:
Sloupce Popis
client_code * Kód klienta
item_amount_initial Původní částka bez daní
item_amount_initial_inc_tax * Původní částka Včetně všech daní
Příklad / Možné hodnoty:
  • 1200
  • 1 200,00
  • 1200.00123
  • ...
item_amount_remaining Zůstatek bez daní
item_amount_remaining_inc_tax Zůstatek Včetně všech daní
item_business_case Obchodní případ
item_currency Měna
Příklad: EUR, USD, ...
item_date_due * Datum splatnosti
Formát data: YYYY-MM-DD
item_date_issue * Datum vystavení
Formát data: YYYY-MM-DD
item_date_order Datum objednávky
Formát data: YYYY-MM-DD
item_date_payment Datum platby
Formát data: YYYY-MM-DD
item_erp_type Typ ERP záznamů
item_file_number Číslo souboru
item_number * Číslo transakce
item_order_number Číslo objednávky
item_sales_administrative Pracovník oddělení prodeje
item_sales_manager Obchodní manažer
item_type * Typ položkyLink
Možné hodnoty: AVO, DPA, FAC, ODI, RGL, TRT
item_unique_key Jedinečný identifikátor záznamu
Příklad « Headers » a « Data » 
POST /api/items HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Chcete-li zobrazit tyto informace, musíte se přihlásit
...

"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"
...
Povinné sloupce : client_code + item_type + item_number + item_date_issue + item_date_due + item_amount_initial_inc_tax

Přidejte a upravte vaše klienty

Použijte SSL pro zabezpečení vašich připojení
Syntax sloupců souboru CSV:
Sloupce Popis
client_address_city Adresa (Město)
client_address_country Adresa (Země)
client_address_postbox Adresa (Poštovní schránka)
client_address_state Adresa (Kraj / Okres)
client_address_street Adresa (Ulice)
client_address_street_line2 Adresa (Ulice Doplněk adresy 2)
client_address_street_line3 Adresa (Ulice Doplněk adresy 3)
client_address_street_number Adresa (n° Ulice)
client_address_zip Adresa (PSČ)
client_blocked Účet zablokován (Ano / Ne)
Možné hodnoty: 0, 1 (automaticky: 0 <=> Ne)
client_blocked_date Účet zablokován / Datum
Formát data: YYYY-MM-DD
client_business_line Tržní segment
client_business_name * Název společnosti
client_code * Kód klienta
client_comments Komentáře
client_commercial_email Obchodní zástupce přidělený klientovi / E-mail
client_commercial_fax Obchodní zástupce přidělený klientovi / Fax
client_commercial_firstname Obchodní zástupce přidělený klientovi / Křestní jméno
client_commercial_lastname Obchodní zástupce přidělený klientovi / Příjmení
client_commercial_matricule Obchodní zástupce přidělený klientovi / Identifikační číslo
client_commercial_phone Obchodní zástupce přidělený klientovi / Telefon
client_commercial_phone_cell Obchodní zástupce přidělený klientovi / Mobilní telefon
client_credit_limit Riziko /
client_email E-mail
client_fax Fax
client_group Skupiny
Seznamy skupin klientů oddělené čárkami
client_guarantee_insurer Riziko / Pojistná záruka
client_guarantee_insurer_reference Riziko / Referenční číslo pojistitele
client_guarantee_score Riziko / Rating
client_guarantee_temporary Riziko / Dočasná záruka
client_guarantee_temporary_date_end Riziko / Dočasná záruka / Datum konce
client_guarantee_temporary_date_start Riziko / Dočasná záruka / Datum začátku
client_guarantee_type Riziko / Typ záruky
client_guarantees_currency Riziko / Měna záruk
client_id IČO
client_order_backlog Portfolio objednávek
client_others_guarantees Riziko /
client_payment_mean Způsob platby
client_payment_term Doba splatnosti
client_phone Telefon
client_phone_cell Mobilní telefon
client_siret Siret
(pro francouzské podniky)
client_trading_name Obchodní název
client_unique_key Jedinečný identifikátor klienta
client_url Internetová stránka
client_vat Číslo DIČ
Příklad « Headers » a « Data » 
POST /api/clients HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Chcete-li zobrazit tyto informace, musíte se přihlásit
...

"client_business_name";"client_code";"client_id";"client_address_country"
"My company";"C0001";"FR12345678";"France"
...
Povinné sloupce : client_code + client_business_name

Přidejte kontakty k vašim klientům

Použijte SSL pro zabezpečení vašich připojení
Syntax sloupců souboru CSV:
Sloupce Popis
client_code * Kód klienta
contact_collection Kontakt pro vymáhání (Ano / Ne)
Možné hodnoty: 0, 1 (automaticky: 0 <=> Ne)
contact_comments Komentáře
contact_email E-mail
contact_email_copy_collection_auto E-mail v kopii automatických e-mailů (Ano / Ne)
Možné hodnoty: 0, 1 (automaticky: 0 <=> Ne)
contact_fax Fax
contact_firstname Křestní jméno
contact_lastname * Příjmení
contact_phone Telefon
contact_phone_cell Mobilní telefon
contact_role Role
Možné hodnoty:
  • accounting: Účetní
  • buyer: Klient
  • company: Společnost
  • manager: Vedoucí
  • other: Ostatní (automaticky)
contact_title Titul (Pan, Paní ...)
contact_unique_key Jedinečný identifikátor kontaktu
Příklad « Headers » a « Data » 
POST /api/contacts HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Chcete-li zobrazit tyto informace, musíte se přihlásit
...

"contact_firstname";"contact_lastname";"contact_role";"client_code"
"Mike";"Jackson";"other";"C0001"
...
Povinné sloupce : client_code + contact_lastname

Přidělit vašim klientům uživatele

Použijte SSL pro zabezpečení vašich připojení
Syntax sloupců souboru CSV:
Sloupce Popis
client_code * Kód klienta
user_email E-mail
user_firstname Křestní jméno
user_lastname * Příjmení
user_matricule Identifikační číslo
Příklad « Headers » a « Data » 
POST /api/users HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Chcete-li zobrazit tyto informace, musíte se přihlásit
...

"user_firstname";"user_lastname";"client_code"
"John";"Roy";"C0001"
...
Povinné sloupce : client_code + user_lastname
If you want, you can use the path "/apiPutFiles/" to import the files asynchronously.

Vrácená data

Po odeslání těchto dat metodou POST je MY DSO MANAGER ihned zpracuje a řekne, zda se v nich nachází chyba nebo kolik dat bylo přidáno či upraveno.
Odpověď bude ve formátu JSON a předá zpět tyto informace:
Pole Popis
success Ukáže, zda import proběhl úspěšně
Možné hodnoty: true, false
error_code Chybový kód (pokud došlo k chybě)
Možné hodnoty: ACCESS_DENIED, CSV_EMPTY, CSV_BAD_SYNTAX, ...
error_description Zpráva o chybě (pokud došlo k chybě)
exception_lines Ignorované řádky (nedefinováno, pokud žádný řádek není ignorován)
nb_client_added Přidáno klientů
nb_client_modified Upraveno klientů
nb_contact_added Přidáno kontaktů
nb_item_added Přidáno záznamů
nb_item_modified Upraveno záznamů
nb_user_added Přidáno uživatelů
nb_user_modified Upraveno uživatelů
Příklad « 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)",
	},
}
← Zpět : Online nápověda » Různé otázky