1. Declaree
  2. Geavanceerd
  3. Modules

Data uitwisseling met FTP

Avatar
Written by Anika Hermanns

Gegevens uitwisselen met je administratie in Declaree kan ook met gebruik van een eigen Declaree Exchange account, waar (periodiek) bestanden kunnen worden uitgewisseld voor bijvoorbeeld goedgekeurde declaraties of personeels-, kostenplaats- of koersgegevens.

Hoe zet ik een SFTP account op?

Wanneer de sFTP module voor uw account geactiveerd is door Declaree:

  1. Ga naar Instellingen> Import & Export> FTP account
  2. Hier zie je de gebruikersnaam voor het account (standaard de bedrijfsnaam).

Activeer je authenticatie sleutel

  1. Selecteer jouw private/ public key
  2. Open jouw public key in een tekstverwerker en kopieer de inhoud
  3. Klik op Screen_Shot_2017-03-28_at_14.30.13.png om het ppk bestand te uploaden
  4. Geef je key een naam en voeg dan de public key toe aan het klembord
  5. Klik op opslaan

Public/private key genereren Windows

  1. Je kunt PuttyGen downloaden en gebruiken om een keyset te genereren.
  2. Vervolgens kun je klikken op 'Generate' en je muis over het grijze vlak bewegen tot 100% van de code gegenereerd is.
  3. Klik 'Save private key' om de private key op te slaan. Je dient hetzelfde te doen voor de public key.
  4. Om de gegenereerde public key in Declaree op te slaan dien je het bestand eerst aan te passen: in het bestand verwijder je de 'begin' en 'end' statements en de comments. Vervolgens voeg je "ssh-rsa" voor de key toe, en zorg je dat de gehele key op 1 regel staat. Het ziet er dan als volgt uit: "ssh-rsa AAAAB3NzaC1yc2EAAA....GzSznbU9MrvTk="  (je kunt dit ook doen middels de site https://svnkeys.berkeley.edu/ )
  5. Tot slot dien je de public key toe voegen in Declaree.

Public/private key genereren Linux/Mac OS X

  1. Open een terminal
  2. Voer het commando: ssh-keygen -t rsa -b 4096 -C "[uw emailadres]" uit
  3. Je kunt nu een map kiezen waar je de keys wilt opslaan.
  4. Daarna kun je de passphrase leeg laten door tweemaal op [enter] te drukken.
  5. Tot slot voeg je de public key (id_rsa.pub) toe  in Declaree.

Verbinden

Hostname ftp.declaree.com
Poort 22
Gebruikersnaam Te vinden onder Import/Export: https://app.declaree.com/admin/exchange_account


Bestandsindeling

Een SFTP account kent standaard de volgende mappen indeling, waar u gebruik van kunt maken;

/in
   \-- /users
   \-- /tags
   \-- /exchange
   \-- /transactions
/out
   \-- /reports

In de /in/* mappen kunnen respectievelijk de personeels-, kostenplaats- of koersgegevens worden toegevoegd. Let er op dat de Excel- of csv-bestanden koptitels bevatten en tenminste de hieronder uitgeschreven kolommen bevatten.

In de /out map worden eventueel automatisch de periodieke export bestanden geplaatst, met bestandsnaam "Expenses_[Ymd].csv" waar [Ymd] gelijk staat aan het jaartal, maand en dag van de export, bijv. "Expenses_20030502.csv". Mocht bij de export ook de bewijslast in de vorm van een PDF-rapport worden geëxporteerd, zullen deze in de /out/reports map verschijnen met bestandsnaam "[ID].pdf", waar [ID] gelijk staat aan het unieke rapport-nummer in Declaree.

Frequentie migratie bestanden

Bestanden die in de /in mappen worden geplaatst worden automatisch binnen een minuut verwerkt. De status van de import kun je volgen in de 'Import geschiedenis' in het Beheer > Account > Data uitwisseling scherm.

Gegevensvalidatie

Nieuwe bestanden worden automatisch op inhoud gecontroleerd. Mochten er onregelmatigheden worden ontdekt, bijvoorbeeld omdat het aantal regels significant kleiner is dan reeds bekend in de administratie, wordt ter verificatie een link verzonden per email. Daarom dien je altijd onder 'Technisch contact' een geldig e-mailadres in te vullen, zodat je deze verificatie mails ontvangt. Na verificatie zal het bestand dan alsnog worden verwerkt.

Formaat personeelsgegevens

Type: Excel of CSV (UTF-8 encoded)
(Gebruik voor CSV de Unix line-endings en punt-komma als kolom scheidingsteken.)

Kolom Verplicht Restricties
Username Ja Tekst
Voorletters Nee Tekst
Voornaam Nee Tekst
Voorvoegsel Nee Tekst
Achternaam Ja Tekst
Email Ja, standaard setup Geldig email adres
Code Yes Tekst
Manager Ja, standaard setup Geldige username
Stuurt door aan No Geldige username
Groepen Nee, standaard setup Tekst, komma-gescheiden
Afdeling Nee, standaard setup Geldig eigen veld waarde


Formaat kostenplaatsgegevens (tags).

Type: Excel of CSV (UTF-8 encoded)
(Gebruik voor CSV de Unix line-endings en punt-komma als kolom scheidingsteken.)

Kolom Verplicht Ristricties
Project Naam Ja Tekst
Project Code Ja Tekst


Meerdere kostenplaats niveau's uploaden.

Als er meerdere niveaus gebruikt worden, kan hier naar gerefereerd worden in de kostenplaatsgegevens. Als er bijvoorbeeld sprake is van een niveau 'Activiteit' onder 'Project' en activiteit 1010 - Ontwerp en 1020 - Productie valt onder project 1000 - Intern, dan kan dat op twee manieren worden opgenomen in het Excel-bestand:

1. Projecten en activiteiten in één Excel of CSV-bestand

Projecten-en-Activiteiten.xlsx

Code Naam Project Code
1000 Intern  
1010 Ontwerp 1000
1020 Productie 1000
2000 Dubai  
2010 Ontwerp 2000
2020 Productie 2000

 

2. Projecten en activiteiten in twee losse Excel of CSV-bestanden;

Projecten.xlsx

Project Code Project Naam
1000 Intern
2000 Dubai

Activiteiten.xlsx

Activiteit Code Activiteit Naam Project Code
1010 Ontwerp 1000
1020 Productie 1000
2010 Ontwerp 2000
2020 Productie 2000


 

 

Verwante artikelen