Rest API - export av kontosaldon

Syftet med funktionen är att flytta informationen till business intelligence-system som kan sammanställa data från olika verktyg och på så sätt få en bra överblick för bättre beslut.

OBS! Vid manuellt anrop krävs det att användaren är inloggad i Timeplan.

Förberedelser - detta görs av Timeplan support
Innan ett anrop kan göras till Timeplan behöver man ställa in "Externt id, andra system" under det konton ni önskar hämta information från. 

När kontot är valt, anges fältet "Externt id, andra system", det ID som anropet ska använda för att välja vilken information som ska exporteras.

Förberedelser av er som kund: Ni behöver lägga in ett externt id på arbetsuppgiften i Timeplan

Gå till - Administration - Organisation - Arbetsuppgift - välj arbetsuppgift för att lägga in ID på raden "D20/PMI Costcenter"

Ni behöver också lägga in ett "Export-id" på företaget.
Ni finner det via fliken Administration - Organisation/Företag

Anrop

Om man är inloggad i Timeplan kan man anropa API:t via webläsaren genom att gå in på dess URL, se exempel nedan, "exempelföretag" byts ut mot er url.

https://exempelföretag.timeplan.se/api/integration/accountbalance/department?fromDate=2020-08-01

För att ändra perioden i exporten ändrar man helt enkelt datumet i URL:en.

Resultatet blir en csv-fil som går att öppna i Excel eller direkt importeras i andra system som har stöd för .csv.

Automatiska anrop

För automatiska anrop krävs en API-nyckel som ni aktiverar på administratören.
Vi på support kan guida er i hur ni aktiverar detta.

När ni fått en API-nyckel använder ni den som en Bearer token i era anrop till API:t, dvs sätter Authorization-headern till ”Bearer <api-nyckel>”. Exempel för anrop med cURL:

Teknisk dokumentation

Teknisk information finner ni genom att använda nedan länk. 
Byt ut exempelföretag mot er egna url: 
https://exempelföretag.timeplan.se/api/docs

Du är varmt välkommen att kontakta oss på supporten för frågor om konfiguration samt en offert med priser.