Trwa ładowanie...
Pomoc online
W razie pytań prosimy o kontakt

Automatic import »

How to import your data automatically?

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

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

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

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

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

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)",
	},
}
← Powrót : Pomoc online » Pytania