Automatický import vašich dat → přes FTPs (zabezpečené FTP)

Online nápověda

Automatic import »
How to import your data automatically?

Translate this page to

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:

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

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

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žky 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

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

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

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

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

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

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

Importujte automaticky vaše data pomocí FTPs nebo SFTP!

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 FTPs and SFTP works with My DSO Manager

Kompatibilní s velkým množstvím softwarů: SAP

...

Přihlášení do vašeho účtu přes zabezpečené FTP nebo chcete-li používat SFTP, kontaktujte nás

Chcete-li se přihlásit, použijte toto přihlašovací jméno a heslo:

Nastavení:

Použijte stejné CSV soubory jako při manuálním importu « Smart Upload »
Pojmenujte je, aby MY DSO MANAGER věděl, který typ souboru je zasílán
(soubory s klienty musí začínat "klienti", soubory se záznamy "záznamy" a soubory kontaktů "kontakty")
Poslat tyto soubory
Data ve vašem účtu jsou okamžitě aktualizována. Soubor, který jste právě zaslal/a, je nahrazen souborem s reportem s informací, zda vše proběhlo v pořádku a kolik proběhlo změn.

Náhled použití softwaru FileZilla pro posílání vašich souborů:

Uvedený přehled zobrazuje manuální import. Můžete jej zautomatizovat vytvořením scénáře, který posílá soubory CSV.

Jak automatizovat odesílání přes zabezpečené FTP:

Pošli prostřednictvím curl (Windows, Linux):

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

Pošli prostřednictvím LFTP (Linux, Windows via cygwin):

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

Pošli prostřednictvím WinSCP (Windows):

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

S našimi konektory můžete importovat klientská a účetní data (faktury, dopropisy, ...) snadno a automaticky!

Potřebujete k tomu vybrat váš řídící software a sledovat instrukce níže, abyste synchronizoval/a vaše data s My DSO Manager v libovolné frekvenci (denně, týdně nebo manuálně).