Hoppa till huvudinnehåll

Caspeco

Anslut Exopen till Caspeco för att hämta in data från Caspecos dynamiska rapporter (RMS) — till exempel lön, personalkostnader och annan rapportdata som finns i ert Caspeco-system.

Manuell uppsättning

Caspeco kopplas in manuellt av Exopens support. Det finns ingen självbetjäning i portalen idag — i stället samlar ni in uppgifterna från Caspeco och mejlar dem till oss enligt stegen nedan.

Förkrav​

För att vi ska kunna ansluta behöver Caspeco ha öppnat upp de rapporter ni vill ha in i Exopen via deras externa rapport-API och utfärdat åtkomstuppgifter för varje rapport. Vänd er till er kontakt hos Caspeco för att få dessa uppgifter.

Steg 1: Samla in uppgifter från Caspeco​

För varje rapport ni vill koppla in behöver vi följande fyra fält, så som ni får dem från Caspeco:

  • name — Caspecos identifierare för rapporten. Har formatet {GUID}_{Rapportnamn}.
  • token — Bearer-token som ger läsåtkomst till just den rapporten.
  • system — Systemidentifieraren för er Caspeco-instans (t.ex. se_exempel). Är samma för alla rapporter inom samma bolag.
  • parameters — JSON med dimensionsbegränsningar som beskriver hur rapporten ska filtreras per period. Den här strukturen är rapportspecifik och kommer från Caspeco — skicka den till oss exakt som ni får den.
info

Token och systemidentifierare ger åtkomst till bolagets data i Caspeco och bör behandlas som lösenord.

Exempel​

Skicka uppgifterna som en JSON-array — en post per rapport. Så här ser en post ut:

{
  "name": "00000000-0000-0000-0000-000000000000_PayrollFollowup",
  "token": "ABCDEF1234567890ABCDEF1234567890ABCDEF1234567890ABCDEF1234567890-1",
  "system": "se_exempel",
  "parameters": {
    "dimensionConstraints": {
      "Payroll": [
        {
          "id": "dimension.period",
          "values": ["<from>", "<to>"],
          "valueType": "DateTime",
          "constraintType": "Range"
        }
      ]
    }
  }
}

Behåll platshållarna <from> och <to> — de fylls i automatiskt av Exopen vid varje synkroniseringskörning.

Steg 2: Skicka uppgifterna till Exopens support​

Mejla support@exopen.se och inkludera:

  • Vilket bolag i Exopen datakällan ska kopplas till.
  • JSON-arrayen från Steg 1 med en post per rapport.
  • Eventuellt önskat startdatum för historisk hämtning per rapport, om ni vet det. Annars hämtar vi så långt tillbaka som Caspeco returnerar data.

Vi sätter upp kopplingen och startar en första körning så snart uppgifterna är på plats.

Synkronisering​

Exopen hämtar varje rapport månadsvis. Vid första körningen fylls historik på bakåt så långt Caspeco returnerar data. Därefter synkroniseras nya månader löpande, och de senaste månaderna körs om regelbundet så att korrigeringar i Caspeco hämtas in.

Sköt om kopplingen​

Behöver ni lägga till nya rapporter, byta ut en token (till exempel efter rotering hos Caspeco) eller ta bort en rapport — mejla support@exopen.se med den nya eller uppdaterade JSON-posten.