Automatyczny import Twoich danych → z serwerami FTP (bezpieczny serwer FTP)

Pomoc online

Automatic import »
How to import your data automatically?

Translate this page to

Trwa ładowanie...

Aby skorzystać z tego interfejsu, należy użyć skryptu, który będzie wysyłał co noc (przykładowo) lub kilka razy dziennie pliki z otwartymi pozycjami, klientami, użytkownikami (opcjonalnie) i kontaktami (opcjonalnie) na nasz serwer.

Program ten musi wysyłać pliki CSV lub TXT (pliki rozdzielone średnikami w danych POST) przy użyciu poniższych identyfikatorów, adresów i składni:

Zaloguj się na swoje konto za pomocą interfejsu API

Aby się zalogować, użyj tego loginu i hasła:

Adres/URL:

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

Aby wyświetlić te informacje, musisz być zalogowany

Przykład « Headers »

POST ...
...
Authorization: Aby wyświetlić te informacje, musisz być zalogowany
...

Opcje importowania danych

Korzystaj z tych opcji tylko wtedy, gdy ich potrzebujesz:

Parametr	API	Opis
encoding	all	Format pliku Możliwe wartości: UTF-8 (domyślnie), ISO-8859-1, ...
clear_items_not_modified	items	Automatycznie wyczyść pozycje? Możliwe wartości: true:Tryb « STOCK » → Systematycznie importuję wszystkie otwarte pozycje (faktury, noty uznaniowe, inne operacje, zaległości nieopłacone i nierozliczone). W takim przypadku, jeśli pozycja jest obecna w importcie w dniu "D", ale nie ma jej już w następnym dniu "D 1", MY DSO MANAGER automatycznie ją rozliczy. false:Tryb « DELTA » → Wolę dokonywać częściowego importu (niekoniecznie wszystkich otwartych pozycji) i wskazuję stronie MY DSO MANAGER pozycje, które zostały opłacone i rozliczone, albo poprzez ręczne rozliczenie w wyciągu z konta w karcie klienta, albo poprzez import pozycji rozliczonych w których pole "Data płatności" jest wypełnione datą rozliczenia pozycji. Domyślnie: false
replace_users_association	users	Zastąp powiązania klient/użytkownik lub dodaj tylko nowe powiązania klient/użytkownik? Możliwe wartości: 0 lub 1 Domyślnie: 0

Przykład « Headers » i « Data »

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

data...

Dodaj i modyfikuj swoje pozycje (faktury, noty uznaniowe itp.)

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

Użyj protokołu SSL, aby zabezpieczyć swoje logowania

Format kolumn pliku CSV:

Kolumny	Opis
client_code *	Kod firmy
item_amount_initial	Kwota początkowa netto
item_amount_initial_inc_tax *	Kwota początkowa brutto Przykład / Możliwe wartości: 1200 1 200,00 1200.00123 ...
item_amount_remaining	Kwota pozostała netto
item_amount_remaining_inc_tax	Kwota pozostała brutto
item_business_case	Nazwa sprawy
item_currency	Waluta Przykład: EUR, USD, ...
item_date_due *	Termin wykonania Format daty: YYYY-MM-DD
item_date_issue *	Data wystawienia Format daty: YYYY-MM-DD
item_date_order	Data zamówienia Format daty: YYYY-MM-DD
item_date_payment	Data płatności Format daty: YYYY-MM-DD
item_erp_type	Typ pozycji w ERP
item_file_number	Nr sprawy
item_number *	Nr transakcji
item_order_number	Numer zamówienia
item_sales_administrative	Kierownik działu sprzedaży
item_sales_manager	Przedstawiciel handlowy
item_type *	Typ pozycji Możliwe wartości: AVO, DPA, FAC, ODI, RGL, TRT
item_unique_key	Unikalny identyfikator pozycji

Przykład « Headers » i « Data »

POST /api/items HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Aby wyświetlić te informacje, musisz być zalogowany
...

"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"
...

Obowiązkowe kolumny : client_code + item_type + item_number + item_date_issue + item_date_due + item_amount_initial_inc_tax

Dodaj i modyfikuj dane swoich klientów

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

Użyj protokołu SSL, aby zabezpieczyć swoje logowania

Format kolumn pliku CSV:

Kolumny	Opis
client_address_city	Adres (Miasto)
client_address_country	Adres (Kraj)
client_address_postbox	Adres (Skrytka pocztowa)
client_address_state	Adres (Województwo/region)
client_address_street	Adres (Ulica)
client_address_street_line2	Adres (Ulica Linia 2)
client_address_street_line3	Adres (Ulica Linia 3)
client_address_street_number	Adres (n° Ulica)
client_address_zip	Adres (Kod pocztowy)
client_blocked	Konto zablokowane (Tak / Nie) Możliwe wartości: 0, 1 (domyślnie: 0 <=> Nie)
client_blocked_date	Konto zablokowane / Data Format daty: YYYY-MM-DD
client_business_line	Rynek
client_business_name *	Nazwa firmy
client_code *	Kod firmy
client_comments	Komentarze
client_commercial_email	Dyrektor sprzedaży powiązany z klientem / E-mail
client_commercial_fax	Dyrektor sprzedaży powiązany z klientem / Fax
client_commercial_firstname	Dyrektor sprzedaży powiązany z klientem / Imię
client_commercial_lastname	Dyrektor sprzedaży powiązany z klientem / Nazwisko
client_commercial_matricule	Dyrektor sprzedaży powiązany z klientem / Numer ID
client_commercial_phone	Dyrektor sprzedaży powiązany z klientem / Telefon
client_commercial_phone_cell	Dyrektor sprzedaży powiązany z klientem / Telefon komórkowy
client_credit_limit	Ryzyko / Limit kredytowy
client_email	E-mail
client_fax	Fax
client_group	Grupy Lista grup klientów oddzielonych przecinkami
client_guarantee_insurer	Ryzyko / Gwarancja ubezpieczeniowa
client_guarantee_insurer_reference	Ryzyko / Numer referencyjne ubezpieczyciela
client_guarantee_score	Ryzyko / Scoring
client_guarantee_temporary	Ryzyko / Gwarancja tymczasowa
client_guarantee_temporary_date_end	Ryzyko / Gwarancja tymczasowa / Termin zakończenia
client_guarantee_temporary_date_start	Ryzyko / Gwarancja tymczasowa / Termin rozpoczęcia
client_guarantee_type	Ryzyko / Typ gwarancji
client_guarantees_currency	Ryzyko / Waluta gwarancji
client_id	Identyfikator prawny
client_order_backlog	Portfel zamówień
client_others_guarantees	Ryzyko / Inne gwarancje
client_payment_mean	Środek płatniczy
client_payment_term	Termin płatności
client_phone	Telefon
client_phone_cell	Telefon komórkowy
client_siret	Siret (dla przedsiębiorstw francuskich)
client_trading_name	Nazwa handlowa
client_unique_key	Unikalny identyfikator klienta
client_url	Strona internetowa
client_vat	Numer VAT

Przykład « Headers » i « Data »

POST /api/clients HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Aby wyświetlić te informacje, musisz być zalogowany
...

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

Obowiązkowe kolumny : client_code + client_business_name

Dodaj kontakty do swoich klientów

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

Użyj protokołu SSL, aby zabezpieczyć swoje logowania

Format kolumn pliku CSV:

Kolumny	Opis
client_code *	Kod firmy
contact_collection	Kontakt ds. windykacji (Tak / Nie) Możliwe wartości: 0, 1 (domyślnie: 0 <=> Nie)
contact_comments	Komentarze
contact_email	E-mail
contact_email_copy_collection_auto	Kopia e-maila znajduje się w automatycznych wiadomościach e-mail (Tak / Nie) Możliwe wartości: 0, 1 (domyślnie: 0 <=> Nie)
contact_fax	Fax
contact_firstname	Imię
contact_lastname *	Nazwisko
contact_phone	Telefon
contact_phone_cell	Telefon komórkowy
contact_role	Funkcja Możliwe wartości: accounting: Księgowy buyer: Klient company: Firma manager: Dyrektor other: Inny (domyślnie)
contact_title	Tytuł (Pan, Pani ...)
contact_unique_key	Unikalny identyfikator kontaktu

Przykład « Headers » i « Data »

POST /api/contacts HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Aby wyświetlić te informacje, musisz być zalogowany
...

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

Obowiązkowe kolumny : client_code + contact_lastname

Powiąż użytkowników z klientami

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

Użyj protokołu SSL, aby zabezpieczyć swoje logowania

Format kolumn pliku CSV:

Kolumny	Opis
client_code *	Kod firmy
user_email	E-mail
user_firstname	Imię
user_lastname *	Nazwisko
user_matricule	Numer ID

Przykład « Headers » i « Data »

POST /api/users HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Aby wyświetlić te informacje, musisz być zalogowany
...

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

Obowiązkowe kolumny : client_code + user_lastname

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

Dane zwrotne

Po wykonaniu operacji POST na tych danych MY DSO MANAGER natychmiast przetworzy je i odpowie, czy wystąpił błąd lub ile danych zostało dodanych i zaktualizowanych.

Odpowiedź będzie w formacie JSON i będzie zawierała następujące informacje:

Pole	Opis
success	Wskazuje, czy import zakończył się pomyślnie Możliwe wartości: true, false
error_code	Kod błędu (jeśli wystąpił błąd) Możliwe wartości: ACCESS_DENIED, CSV_EMPTY, CSV_BAD_SYNTAX, ...
error_description	Komunikat o błędzie (jeśli wystąpił błąd)
exception_lines	Linie pominięte (nie dotyczy, jeśli nie pominięto żadnych linii)
nb_client_added	Dodanych klientów
nb_client_modified	Zaktualizowanych klientów
nb_contact_added	Dodanych kontaktów
nb_item_added	Dodanych pozycji
nb_item_modified	Zaktualizowanych pozycji
nb_user_added	Dodanych użytkowników
nb_user_modified	Zaktualizowanych użytkowników

Przykład « 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)",
	},
}

Automatycznie importuj swoje dane za pomocą serwera FTP lub SFTP!

Program ten musi wysyłać pliki CSV lub TXT (pliki rozdzielone średnikami w danych POST) przy użyciu poniższych identyfikatorów, adresów i składni:

How FTPs and SFTP works with My DSO Manager

Kompatybilność z wieloma oprogramowaniami: SAP

...

Zaloguj się na swoje konto za pomocą bezpieczny serwer FTP lub skontaktuj się z nami, aby skorzystać z SFTP

Aby się zalogować, użyj tego loginu i hasła:

Konfiguracja:

Użyj tych samych plików CSV, których użyłeś podczas ręcznego importu « Smart Upload »
Nazwij je tak, aby MY DSO MANAGER wiedział, jaki typ pliku jest wysyłany
(pliki klientów muszą zaczynać się od "klienci", pliki pozycji od "pozycje", a pliki kontaktów od "kontakty")
Wyślij te pliki
Dane są natychmiast przetwarzane i aktualizowane na Twoim koncie. Przesłany plik zostaje zastąpiony plikiem z raportem, który informuje, czy wszystko przebiegło pomyślnie i ile zmian zostało wprowadzonych.

Przegląd oprogramowania FileZilla do przesyłania plików:

Ten podgląd pokazuje import ręczny, ale należy go wykonywać automatycznie, tworząc skrypt wysyłający pliki CSV.

Jak zautomatyzować transfer za pomocą bezpiecznego serwera FTP:

Wyślij z curl (Windows, Linux):

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

Wyślij z LFTP (Linux, Windows via cygwin):

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

Wyślij z WinSCP (Windows):

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

Dzięki naszym wtyczkom możesz w prosty i zautomatyzowany sposób importować dane klientów oraz dane dotyczące należności (niezapłacone faktury, noty uznaniowe itp.)!

W tym celu wybierz poniżej swoje oprogramowanie ERP/CRM i postępuj zgodnie z instrukcjami, aby zsynchronizować swoje dane z My DSO Manager z wybraną częstotliwością (codziennie, co tydzień lub ręcznie).