Importeer je gegevens automatisch → via onze web-API

Online help

Neem contact met ons op als u vragen hebt

Automatic import »
How to import your data automatically?

Translate this page to

Bezig met laden...

Om gebruik te maken van deze interface, dient u een script te gebruiken dat bijvoorbeeld elke nacht of meerdere keren per dag uw documenten, klanten, gebruikers (optioneel) en contacten (optioneel) naar onze server verzendt.

Dit programma dient CSV- of TXT-bestanden (bestanden gescheiden door puntkomma's in de POST-gegevens) te verzenden met behulp van de onderstaande identificatiegegevens, adressen en syntaxis:

Aanmelden bij uw account via onze API

Gebruik deze gebruikersnaam en dit wachtwoord om in te loggen:

Adres / URL:

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

U dient ingelogd te zijn om deze informatie te kunnen bekijken

Voorbeeld « Headers »

POST ...
...
Authorization: U dient ingelogd te zijn om deze informatie te kunnen bekijken
...

Importopties

Gebruik deze opties alleen indien nodig:

Parameter	API	Beschrijving
encoding	all	Bestandsformaat Mogelijke waarden: UTF-8 (standaard), ISO-8859-1, ...
clear_items_not_modified	items	Automatisch onderdelen afrekenen? Mogelijke waarden: true:Modus « STOCK » → Ik importeer automatisch alle niet-gesaldeerde documenten (facturen, creditnota's, diverse transacties... die nog niet zijn geboekt en gesaldeerd). Indien een document bij een import aanwezig is en bij de volgende import niet meer, zal MY DSO MANAGER het automatisch salderen. false:Modus « DELTA » → Ik importeer alle nieuwe documenten (facturen, creditnota's, diverse transacties... die nog niet zijn geboekt en afgewikkeld) die sinds de laatste import zijn uitgegeven, evenals alle documenten die zijn afgewikkeld. In het veld ‘item_date_payment' van deze laatste documenten is de datum ingevuld waarop elk document in het boekhoudsysteem is afgewikkeld. Hierdoor kan MY DSO MANAGER ze ook afwikkelen. Standaard: false
replace_users_association	users	De koppeling van klanten en gebruikers wijzigen of voeg uitsluitend nieuwe klant-/gebruikerscombinaties toe? Mogelijke waarden: 0 of 1 Standaard: 0

Voorbeeld « Headers » en « Data »

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

data...

Voeg uw documenten toe en bewerk ze (facturen, creditnota's, enz.)

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

Gebruik SSL om uw verbindingen te beveiligen

Indeling van kolommen in het CSV-bestand:

Kolommen	Beschrijving
client_code *	Bedrijfscode
item_amount_initial	Initiel bedrag ex. BTW
item_amount_initial_inc_tax *	Initiel bedrag incl. BTW Voorbeeld / Mogelijke waarden: 1200 1 200,00 1200.00123 ...
item_amount_remaining	Restant bedrag ex. BTW
item_amount_remaining_inc_tax	Restant bedrag incl. BTW
item_business_case	Betreft
item_currency	Valuta Voorbeeld: EUR, USD, ...
item_date_due *	Vervaldatum Datum formaat: YYYY-MM-DD
item_date_issue *	Uitgiftedatum Datum formaat: YYYY-MM-DD
item_date_order	Datum opdracht Datum formaat: YYYY-MM-DD
item_date_payment	Betaaldatum Datum formaat: YYYY-MM-DD
item_erp_type	ERP-artikeltype
item_file_number	File nr
item_number *	Boeking nr.
item_order_number	PO nr
item_sales_administrative	Verkoopmedewerker
item_sales_manager	Verkoopmanager
item_type *	Artikel type Mogelijke waarden: AVO, DPA, FAC, ODI, RGL, TRT
item_unique_key	Uniek artikelnummer

Voorbeeld « Headers » en « Data »

POST /api/items HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: U dient ingelogd te zijn om deze informatie te kunnen bekijken
...

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

Verplichte kolommen : client_code + item_type + item_number + item_date_issue + item_date_due + item_amount_initial_inc_tax

Voeg klanten toe en bewerk ze

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

Gebruik SSL om uw verbindingen te beveiligen

Indeling van kolommen in het CSV-bestand:

Kolommen	Beschrijving
client_address_city	Adres (Plaats)
client_address_country	Adres (Land)
client_address_postbox	Adres (Postbus)
client_address_state	Adres (Staat / Provincie)
client_address_street	Adres (Straat)
client_address_street_line2	Adres (Straat Lijn 2)
client_address_street_line3	Adres (Straat Lijn 3)
client_address_street_number	Adres (n° Straat)
client_address_zip	Adres (Postcode)
client_blocked	Account geblokkeerd (Ja / Nee) Mogelijke waarden: 0, 1 (standaard: 0 <=> Nee)
client_blocked_date	Account geblokkeerd / Datum Datum formaat: YYYY-MM-DD
client_business_line	Markt
client_business_name *	Bedrijfsnaam
client_code *	Bedrijfscode
client_comments	Opmerkingen
client_commercial_email	Verkoopmedewerker / E-mail
client_commercial_fax	Verkoopmedewerker / Fax
client_commercial_firstname	Verkoopmedewerker / Voornaam
client_commercial_lastname	Verkoopmedewerker / Achternaam
client_commercial_matricule	Verkoopmedewerker / ID-nummer
client_commercial_phone	Verkoopmedewerker / Telefoon
client_commercial_phone_cell	Verkoopmedewerker / Mobiele telefoon
client_credit_limit	Risico / Kredietlimiet
client_email	E-mail
client_fax	Fax
client_group	Groepen Lijst met groepen van de klant, gescheiden door komma's
client_guarantee_insurer	Risico / Garantie van de verzekeraar
client_guarantee_insurer_reference	Risico / Referentie verzekeraar
client_guarantee_score	Risico / Score
client_guarantee_temporary	Risico / Tijdelijke garantie
client_guarantee_temporary_date_end	Risico / Tijdelijke garantie / Einddatum
client_guarantee_temporary_date_start	Risico / Tijdelijke garantie / Startdatum
client_guarantee_type	Risico / Type garantie
client_guarantees_currency	Risico / Valuta van garanties
client_id	Wettelijk identificatienummer
client_order_backlog	Orderportefeuille
client_others_guarantees	Risico / Andere garanties
client_payment_mean	Betalingsmiddel
client_payment_term	Betalingstermijn
client_phone	Telefoon
client_phone_cell	Mobiele telefoon
client_siret	Siret (voor Franse ondernemingen)
client_trading_name	Handelsnaam
client_unique_key	Uniek klantnummer
client_url	Website
client_vat	BTW-nummer

Voorbeeld « Headers » en « Data »

POST /api/clients HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: U dient ingelogd te zijn om deze informatie te kunnen bekijken
...

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

Verplichte kolommen : client_code + client_business_name

Voeg contactpersonen toe aan uw klantenbestand

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

Gebruik SSL om uw verbindingen te beveiligen

Indeling van kolommen in het CSV-bestand:

Kolommen	Beschrijving
client_code *	Bedrijfscode
contact_collection	Contactpersoon voor incasso (Ja / Nee) Mogelijke waarden: 0, 1 (standaard: 0 <=> Nee)
contact_comments	Opmerkingen
contact_email	E-mail
contact_email_copy_collection_auto	E-mail in kopie in de automatische e-mails (Ja / Nee) Mogelijke waarden: 0, 1 (standaard: 0 <=> Nee)
contact_fax	Fax
contact_firstname	Voornaam
contact_lastname *	Achternaam
contact_phone	Telefoon
contact_phone_cell	Mobiele telefoon
contact_role	Functie Mogelijke waarden: accounting: Accountant buyer: Inkoper company: Bedrijf manager: Leidinggevende other: Andere (standaard)
contact_title	Titel (Dhr, mevrouw ...)
contact_unique_key	Uniek contactpersoonnummer

Voorbeeld « Headers » en « Data »

POST /api/contacts HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: U dient ingelogd te zijn om deze informatie te kunnen bekijken
...

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

Verplichte kolommen : client_code + contact_lastname

Gebruikers aan uw klanten koppelen

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

Gebruik SSL om uw verbindingen te beveiligen

Indeling van kolommen in het CSV-bestand:

Kolommen	Beschrijving
client_code *	Bedrijfscode
user_email	E-mail
user_firstname	Voornaam
user_lastname *	Achternaam
user_matricule	ID-nummer

Voorbeeld « Headers » en « Data »

POST /api/users HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: U dient ingelogd te zijn om deze informatie te kunnen bekijken
...

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

Verplichte kolommen : client_code + user_lastname

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

Terugkoppeling van gegevens

Na het verzenden van deze gegevens zal MY DSO MANAGER ze onmiddellijk verwerken en aangeven of er een fout is opgetreden of hoeveel gegevens er zijn toegevoegd en gewijzigd.

Dit antwoord zal in JSON-formaat zijn en de volgende informatie bevatten:

Veld	Beschrijving
success	Geeft aan of het importeren succesvol is voltooid Mogelijke waarden: true, false
error_code	Foutcode (indien er een fout is opgetreden) Mogelijke waarden: ACCESS_DENIED, CSV_EMPTY, CSV_BAD_SYNTAX, ...
error_description	Foutmelding (indien er een fout is opgetreden)
exception_lines	Overgeslagen regels (niet gedefinieerd als er geen regels zijn overgeslagen)
nb_client_added	Klanten toegevoegd
nb_client_modified	Klanten bijgewerkt
nb_contact_added	Contactpersonen toegevoegd
nb_item_added	Artikelen toegevoegd
nb_item_modified	Artikelen bijgewerkt
nb_user_added	Gebruikers toegevoegd
nb_user_modified	Gebruikers bijgewerkt

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

Importeer uw gegevens automatisch via FTPs of SFTP!

Dit programma dient CSV- of TXT-bestanden (bestanden gescheiden door puntkomma's in de POST-gegevens) te verzenden met behulp van de onderstaande identificatiegegevens, adressen en syntaxis:

How FTPs and SFTP works with My DSO Manager

Compatibel met een breed scala aan software: SAP

...

Inloggen op uw account via secure FTP of neem contact met ons op om gebruik te maken van SFTP

Gebruik deze gebruikersnaam en dit wachtwoord om in te loggen:

Setup:

Gebruik dezelfde CSV-bestanden die u gebruikt bij het handmatig importeren. « Smart Upload »
Noem ze zodanig dat MY DSO MANAGER weet welk type bestand wordt verzonden
(klantbestanden moeten beginnen met "klanten", documentbestanden met "documenten" en contactbestanden met "contacten")
Stuur deze bestanden
De gegevens worden onmiddellijk verwerkt en bijgewerkt in uw account. Het bestand dat u zojuist hebt verzonden, wordt vervangen door een rapportbestand dat aangeeft of alles goed is verlopen en hoeveel wijzigingen er zijn aangebracht.

Overzicht van het gebruik van FileZilla-software voor het overzetten van uw bestanden:

Dit voorbeeldtoont een handmatige import, maar u kunt dit ook automatisch laten verlopen door een script te creëren dat de CSV-bestanden verstuurt.

Verzenden via beveiligde FTP automatiseren:

Verzenden door curl (Windows, Linux):

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

Verzenden door LFTP (Linux, Windows via cygwin):

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

Verzenden door WinSCP (Windows):

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

Dankzij onze connectoren kunt u uw klant- en boekhoudgegevens (facturen, creditnota's, enz.) eenvoudig en automatisch importeren!

Selecteer hiervoor uw beheersoftware en volg de onderstaande instructies om uw gegevens met My DSO Manager te synchroniseren met de door u gewenste frequentie (dagelijks, wekelijks of handmatig).