Med API integrationen til tamigo, kan du importere og opdatere medarbejderdata fra Emply til tamigo.
Du kan også specificere et job til at køre dagligt, på et bestemt tidspunkt.
Opsætning af integrationen
Integrationen mellem Emply og tamigo skal sættes op i tamigo.
1. Gå til plugin siden i tamigo
Plugin siden ser sådan ud:
2. Specificer følgende:
- Emply API key
- Emply API kundenavn
- Emply API eksport ID
- Opret dagligt importjob
Emply API key
For at lave din API key i Emply, gå til Indstillinger > Integrationer > API > '+Ny API key'. Eller åben en eksisterende API key, og kopier den.
Emply API kundenavn: Dit virksomhedsnavn, som du bruger i Emply.
Emply API eksport ID
Gå til Indstillinger > Integrationer > Eksport > '+Ny eksport' > vælg 'JSON Package'.
Giv eksporten en intern beskrivelse, aktiver 'Medarbejder' og vælg den data der skal indgå i din JSON package. Du kan klikke på 'Flettefelter', for at indsætte flettefelterne direkte.
Nedenstående er et eksempel på eksportfilen. Den første sektion 'Employee' er obligatorisk data som skal indsættes i din JSON package. 'CustomFields' er brugerdefineret flettefelter som du selv vælger. Mapping af flettefelter vil blive forklaret senere i artiklen.
{
"Employees": [
{
"Fornavn": "[form.stamdata.fornavn]",
"Efternavn": "[form.stamdata.efternavn]",
"Lønnummer": "[element.medarbejdernummer]",
"CPR": "[form.stamdata.cpr_nummer]",
"Fødselsdato": "[form.stamdata.fødselsdato]",
"Køn": "[form.stamdata.køn]",
"Email": "[form.stamdata.e_mail]",
"Afdeling": "[payroll.primary.department]",
"Stillingsbetegnelse": "[payroll.primary.stilling]",
"Ansættelsesdato": "[payroll.primary.employment_date]",
"Lønmodel": "[element.lønmodel]",
"KontrakttimerUge": "[form.stamdata.kontrakttimer/uge]",
"TimelønMånedsløn": "[form.stamdata.løngruppe]",
"Tlf": "[form.stamdata.telefon_(mobil)]",
"Adresse": "[form.stamdata.adresse]",
"By": "[form.stamdata.by]",
"KontoNr": "[form.stamdata.konto_nr.]",
"RegNr": "[form.stamdata.reg._nr.]",
"CustomFields":
[ {
"Name": "example_1",
"Value": "[form.stamdata.example.1]"
},
{
"Name": "example_2",
"Value": "[form.stamdata.example.2]"
}
}
Når du har sat din JSON ekport op, skal du kopiere GUID i bunden af opsætningen, som er det eksport ID du skal bruge i opsætningen i tamigo.
Opret dagligt importjob
Her kan du vælge 'No' (standard) eller 'Yes'.
Hvis 'Yes', bliver det daglige importjob sat op, hvor du kan specificere et tidspunkt for tamigo jobbet til at køre.
Mapping af Emply data til tamigo felter
Den importerede data fra Emply er mappet til tamigo felter, som vist her:
| Emply | tamigo (interface) | tamigo (API) | Data type | Comment |
| Fornavn | Name | |||
| Efternavn | Name | |||
| Lønnumer | Employee ID (wage system key) | WageSystemKey | string | |
| CPR nummer | NI number | SocialSecurityNumber | string | |
| Fødselsdato | Date of birth | DateOfBirth | Microsoft date | |
| Køn | Gender | Gender | integer | 0 = male, 1 = female |
| string | ||||
| Afdeling | Home department | DepartmentKey | string | |
| SetAsHomeDepartment | SetAsHomeDepartment | boolean | Must be true to apply new home department (otherwise only role is applied) | |
| Stillingsbetegnelse | Position | Position | string | |
| Ansættelsesdato | Start date | StartDate | Microsoft date | |
| Lønmodel | Contract type ID Contract type name | WageModelID WageModel | string string | |
| Kontrakttimer/uge | Contract hours | ContractHours | decimal | |
| Timeløn/månedsløn | Wage | WageRate | decimal | |
| Tlf | Mobile | MobilePhoneNumber | string | |
| Adresse | Address line 1 | AddressLine1 | string | |
| Postnr. | Postcode | PostCode | string | |
| By | City | City | string | |
| Konto nr. | Account no. | BankAccountNumber | string | |
| Reg. nr. | Sort code | BankRegistrationNumber | string | |
| Feriedage startsaldo | Opening balance (absence) | Not available |
Brugerdefineret felter
Nedenfor har du et overblik over alle brugerdefineret felter som kan bruges i den JSON package du har sat op i Emply.
Alle brugerdefineret felter har det samme navn i API som i UI. De sendes ind som et objekt med navnet CustomColumns.
| Emply | tamigo (interface) |
| Brug nemkoto | Nemkonto |
| Hvilket skattekort | Skattekort |
| Pension | Pension |
| Bemærkninger | Bemærkninger |
| Minimalløn | Minimalløn |
| Fagtillæg | Fagtillæg |
| Anciennitetstillæg | Anciennitetstillæg |
| Personligt tillæg | Personligt tillæg |
| Medlem af 3F | Medlem af 3F |
| Kronisk påvirkning af arbejsdygtighed | Kronisk påvirkning af arbejdsdygtighed |
| Tilknyttet kommune | Tilknyttet kommune |
| Dato for fleksjobbevilling | Dato for fleksjobbevilling |
| Arbejdsevne revurderes efter antal måneder | Arbejdsevne revurderes efter antal måneder |
| Anciennitetsdato | Anciennitetsdato |
| Leder | Leder |
| Arbejdsplads | Arbejdsplads |