Automatisk import af dine data → via vores web-API

Online hjælp

Automatic import »
How to import your data automatically?

Translate this page to

Indlæsning...

For at benytte denne interface skal du bruge et script, der hver nat (for eksempel) eller flere gange om dagen sender dine dokumenter, kunder, brugere (valgfrit) og kontakter (valgfrit) til vores server.

Dette program skal sende CSV- eller TXT-filer (filer adskilt med semikoloner i POST-dataene) ved hjælp af nedenstående identifikatorer, adresser og syntakser:

Log ind på din konto via vores API

Brug dette brugernavn og denne adgangskode til at logge ind:

Adresse / URL:

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

Du skal være logget ind for at se disse oplysninger

Eksempel « Headers »

POST ...
...
Authorization: Du skal være logget ind for at se disse oplysninger
...

Importindstillinger

Brug kun disse indstillinger, hvis du har brug for dem:

Indstillinger	API	Beskrivelse
encoding	all	Filformat Mulige værdier: UTF-8 (standard), ISO-8859-1, ...
clear_items_not_modified	items	Afregn automatisk dokumenterne? Mulige værdier: true:« STOCK » mode → Jeg importerer systematisk alle ikke-afviklede bilag (fakturaer, kreditnotaer, diverse transaktioner osv. som endnu ikke er betalt og afviklede). Hvis et dokument i så fald er til stede ved en import og ikke længere er det ved den næste, vil MY DSO MANAGER automatisk afvikle det. false:« DELTA » mode → Jeg importerer alle nye bilag (fakturaer, kreditnotaer, diverse transaktioner osv. som endnu ikke er betalt og afviklede) udstedt siden sidste import samt alle bilag, der er afviklede. For sidstnævnte er feltet 'item_date_payment' udfyldt med den dato, hvor hvert dokument er afviklet i regnskabssystemet. Dette gør det muligt for MY DSO MANAGER også at afvikle dem. Standard: false
replace_users_association	users	Erstatte kunde-/brugerforbindelser eller tilføj kun nye kunde-/brugerforbindelser? Mulige værdier: 0 eller 1 Standard: 0

Eksempel « Headers » og « Data »

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

data...

Tilføj og ændr dine bilag (fakturaer, tilgodehavender osv)

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

Brug SSL til at sikre dine forbindelser

Syntaks for kolonnerne i CSV-filen:

Kolonner	Beskrivelse
client_code *	Kundekode
item_amount_initial	Fakturabeløb ekskl. moms
item_amount_initial_inc_tax *	Fakturabeløb inkl. moms Eksempel / Mulige værdier: 1200 1 200,00 1200.00123 ...
item_amount_remaining	Udestående beløb ekskl. moms
item_amount_remaining_inc_tax	Udestående beløb inkl. moms
item_business_case	Sagsnr.
item_currency	Valuta Eksempel: EUR, USD, ...
item_date_due *	Forfaldsdato Datoformat: YYYY-MM-DD
item_date_issue *	Fakturadato Datoformat: YYYY-MM-DD
item_date_order	Ordredato Datoformat: YYYY-MM-DD
item_date_payment	Betalingsdato Datoformat: YYYY-MM-DD
item_erp_type	ERP bilagtype
item_file_number	Filnr.
item_number *	Bilag nr.
item_order_number	Ordrenummer
item_sales_administrative	Salgsadministrator
item_sales_manager	Sælger
item_type *	Bilagsnummer Mulige værdier: AVO, DPA, FAC, ODI, RGL, TRT
item_unique_key	Unik bilag-id

Eksempel « Headers » og « Data »

POST /api/items HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Du skal være logget ind for at se disse oplysninger
...

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

Obligatoriske kolonner : client_code + item_type + item_number + item_date_issue + item_date_due + item_amount_initial_inc_tax

Tilføj eller ændr dine kunder

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

Brug SSL til at sikre dine forbindelser

Syntaks for kolonnerne i CSV-filen:

Kolonner	Beskrivelse
client_address_city	Adresse (By)
client_address_country	Adresse (Land)
client_address_postbox	Adresse (Postboks)
client_address_state	Adresse (Stat/Provins)
client_address_street	Adresse (Gade)
client_address_street_line2	Adresse (Gade Linje 2)
client_address_street_line3	Adresse (Gade Linje 3)
client_address_street_number	Adresse (n° Gade)
client_address_zip	Adresse (Postnummer)
client_blocked	Blokeret konto (Ja / Nej) Mulige værdier: 0, 1 (standard: 0 <=> Nej)
client_blocked_date	Blokeret konto / Dato Datoformat: YYYY-MM-DD
client_business_line	Marked
client_business_name *	Selskabsnavn
client_code *	Kundekode
client_comments	Kommentarer
client_commercial_email	Sælger tilknyttet kunden / E-mail
client_commercial_fax	Sælger tilknyttet kunden / Fax
client_commercial_firstname	Sælger tilknyttet kunden / Fornavn
client_commercial_lastname	Sælger tilknyttet kunden / Efternavn
client_commercial_matricule	Sælger tilknyttet kunden / ID-nummer
client_commercial_phone	Sælger tilknyttet kunden / Telefon
client_commercial_phone_cell	Sælger tilknyttet kunden / Mobiltelefon
client_credit_limit	Risiko / Kreditgrænse
client_email	E-mail
client_fax	Fax
client_group	Koncerner Liste over kundegrupper adskilt med kommaer
client_guarantee_insurer	Risiko / Forsikringsgaranti
client_guarantee_insurer_reference	Risiko / Forsikringsselskabs reference
client_guarantee_score	Risiko / Score
client_guarantee_temporary	Risiko / Midlertidig garanti
client_guarantee_temporary_date_end	Risiko / Midlertidig garanti / Slutdato
client_guarantee_temporary_date_start	Risiko / Midlertidig garanti / Startdato
client_guarantee_type	Risiko / Garantitype
client_guarantees_currency	Risiko / Garantivaluta
client_id	Juridisk id
client_order_backlog	Ordrebeholdning
client_others_guarantees	Risiko / Andre garantier
client_payment_mean	Betalingsmåde
client_payment_term	Betalingsfrist
client_phone	Telefon
client_phone_cell	Mobiltelefon
client_siret	Siret (for franske virksomheder)
client_trading_name	Handelsnavn
client_unique_key	Unik kunde-id
client_url	Websted
client_vat	Momsnummer

Eksempel « Headers » og « Data »

POST /api/clients HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Du skal være logget ind for at se disse oplysninger
...

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

Obligatoriske kolonner : client_code + client_business_name

Tilføj kontakter til dine kunder

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

Brug SSL til at sikre dine forbindelser

Syntaks for kolonnerne i CSV-filen:

Kolonner	Beskrivelse
client_code *	Kundekode
contact_collection	Kontakt vedrørende inddrivelse (Ja / Nej) Mulige værdier: 0, 1 (standard: 0 <=> Nej)
contact_comments	Kommentarer
contact_email	E-mail
contact_email_copy_collection_auto	Send en kopi af automatiske e-mails (Ja / Nej) Mulige værdier: 0, 1 (standard: 0 <=> Nej)
contact_fax	Fax
contact_firstname	Fornavn
contact_lastname *	Efternavn
contact_phone	Telefon
contact_phone_cell	Mobiltelefon
contact_role	Stilling Mulige værdier: accounting: Regnskabsfører buyer: Køber company: Selskab manager: Leder other: Andet (standard)
contact_title	Titel (hr., fru ...)
contact_unique_key	Unik kontakt-id

Eksempel « Headers » og « Data »

POST /api/contacts HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Du skal være logget ind for at se disse oplysninger
...

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

Obligatoriske kolonner : client_code + contact_lastname

Tilknyt brugere til dine kunder

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

Brug SSL til at sikre dine forbindelser

Syntaks for kolonnerne i CSV-filen:

Kolonner	Beskrivelse
client_code *	Kundekode
user_email	E-mail
user_firstname	Fornavn
user_lastname *	Efternavn
user_matricule	ID-nummer

Eksempel « Headers » og « Data »

POST /api/users HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: Du skal være logget ind for at se disse oplysninger
...

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

Obligatoriske kolonner : client_code + user_lastname

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

returdata

Efter at have sendt disse data vil MY DSO MANAGER behandle dem med det samme og svare, om der er opstået en fejl, eller hvor mange data der er blevet tilføjet og ændret.

Dette svar vil være i JSON-format og returnere følgende oplysninger:

Felt	Beskrivelse
success	Angiver, om importen er gennemført korrekt Mulige værdier: true, false
error_code	Fejlkode (hvis der er sket en fejl) Mulige værdier: ACCESS_DENIED, CSV_EMPTY, CSV_BAD_SYNTAX, ...
error_description	Fejlbesked (hvis der er sket en fejl)
exception_lines	Linjer, der er blevet ignoreret (ikke defineret, hvis ingen linjer er blevet ignoreret)
nb_client_added	Kunder tilføjet
nb_client_modified	Kunder ændret
nb_contact_added	Kontakter tilføjet
nb_item_added	Dokumenter tilføjet
nb_item_modified	Dokumenter ændret
nb_user_added	Brugere tilføjet
nb_user_modified	Brugere ændret

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

Importer dine data automatisk via FTPs eller SFTP!

Dette program skal sende CSV- eller TXT-filer (filer adskilt med semikoloner i POST-dataene) ved hjælp af nedenstående identifikatorer, adresser og syntakser:

How FTPs and SFTP works with My DSO Manager

Kompatibel med en lang række software: SAP

...

Log ind på din konto via Sikker FTP eller kontakt os for at bruge SFTP

Brug dette brugernavn og denne adgangskode til at logge ind:

Oprettelse:

Brug de samme CSV-filer, som du bruger ved manuel import « Smart Upload »
Navngiv dem på en sådan måde, at MY DSO MANAGER ved, hvilken type fil der sendes
(Kundefiler skal begynde med "kunder", dokumentfiler med "dokumenter" og kontaktfiler med "kontakter")
Send filerne
Dataene behandles øjeblikkeligt og opdateres på din konto. Den fil, du lige har sendt, erstattes af en rapportfil, der fortæller dig, om alt er gået godt, og hvor mange ændringer der er foretaget.

Oversigt over brug af FileZilla-softwaren til overførsel af dine filer:

Dette eksempel viser en manuel import, men du kan sagtens gøre det automatisk ved at oprette et script, der sender CSV-filerne.

Sådan automatiseres afsendelse via sikker FTP:

Send via curl (Windows, Linux):

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

Send via LFTP (Linux, Windows via cygwin):

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

Send via WinSCP (Windows):

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

Takket være vores konnektorer kan du importere dine kunde- og regnskabsdata (fakturaer, kreditnotaer osv.) på en enkel og automatiseret måde!

Vælg din administrationssoftware og følg instruktionerne nedenfor for at synkronisere dine data med My DSO Manager, så ofte du ønsker (dagligt, ugentligt eller manuelt).