> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# a3innuva Nómina HRIS Integration

> a3innuva Nómina connector for Kombo's HRIS API

<Note>This connector is in open beta. You can freely enable it in your account.</Note>

The a3innuva Nómina HRIS integration allows you to sync HRIS data between a3innuva Nómina and your application through Kombo's unified API. The tool slug for this connector is `a3innuvanomina`.

## Guides and Resources

<CardGroup cols={2}>
  <Card title="Connection Setup Guide" icon="link" href="https://help.kombo.dev/hc/en-us/articles/40857776238225-a3innuva-N%C3%B3mina-How-do-I-link-my-account">
    Step-by-step instructions to connect your a3innuva Nómina account to Kombo.
  </Card>
</CardGroup>

## Supported Features & Coverage

<Tabs>
  <Tab title="Models">
    <Accordion title="Legal Entities">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Work Locations">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Employees">
      | Field                 | Notes |
      | --------------------- | ----- |
      | id                    |       |
      | remote\_id            |       |
      | changed\_at           |       |
      | remote\_deleted\_at   |       |
      | employee\_number      |       |
      | first\_name           |       |
      | last\_name            |       |
      | display\_full\_name   |       |
      | job\_title            |       |
      | work\_email           |       |
      | personal\_email       |       |
      | mobile\_phone\_number |       |
      | ssn                   |       |
      | tax\_id               |       |
      | employment\_status    |       |
      | employment\_type      |       |
      | weekly\_hours         |       |
      | work\_location\_id    |       |
      | legal\_entity\_id     |       |
      | home\_address         |       |
      | bank\_accounts        |       |
      | start\_date           |       |
      | termination\_date     |       |
      | custom\_fields        |       |
      | integration\_fields   |       |
      | remote\_data          |       |
    </Accordion>

    <Accordion title="Absence Types">
      | Field                   | Notes |
      | ----------------------- | ----- |
      | id                      |       |
      | remote\_id              |       |
      | changed\_at             |       |
      | remote\_deleted\_at     |       |
      | name                    |       |
      | unit                    |       |
      | half\_days\_supported   |       |
      | exact\_times\_supported |       |
    </Accordion>

    <Accordion title="Absences">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | employee\_id        |       |
      | start\_date         |       |
      | end\_date           |       |
      | amount              |       |
      | unit                |       |
      | status              |       |
      | type\_id            |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Employments">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | employee\_id        |       |
      | pay\_rate           |       |
      | pay\_period         |       |
      | employment\_type    |       |
      | pay\_currency       |       |
      | effective\_date     |       |
      | remote\_data        |       |
      | custom\_fields      |       |
      | integration\_fields |       |
    </Accordion>
  </Tab>

  <Tab title="Actions">
    <Accordion title="Create absence">
      <Note>
        Supported absenteeism types: holidays (vacaciones), retributed permissions (permisos-retribuidos). Supported temporary disability types: illnesses (enfermedad-comun) Illness absences require remote\_fields.a3innuvanomina.benefit\_type\_id (Delegated Payment, No Right to Benefit, or Direct payment).
      </Note>

      | Input Field       | Notes |
      | ----------------- | ----- |
      | employee\_id      |       |
      | absence\_type\_id |       |
      | start\_date       |       |
      | end\_date         |       |
    </Accordion>

    <Accordion title="Create employee (v2)">
      <Info>For detailed information about [creating employees with form](/hris/implementation-guide/create-employee), please see the [**Create Employee with Form** tab](#create-employee-with-form) above.</Info>

      | Input Field          | Notes |
      | -------------------- | ----- |
      | staffing\_entity\_id |       |
      | properties           |       |
    </Accordion>
  </Tab>

  <Tab title="Features">
    | Feature          | Notes |
    | ---------------- | ----- |
    | Connection Guide |       |
    | OAuth            |       |
    | API Passthrough  |       |
  </Tab>

  <Tab title="Create Employee with Form">
    <Info>
      Some **required** form fields are referencing the following data models:

      * Legal Entities
      * Locations

      Consider enabling these in your [scope configuration](/hris/features/scopes).
    </Info>

    <ResponseField name="workplaceCode" type="single_select" required>**Workplace**<br />
    A3 workplace code to assign the employee to.<br />
    References `/v1/hris/locations?remote_model=location`</ResponseField>
    <ResponseField name="companyCode" type="single_select" required>**Company**<br />
    A3 company to assign the employee to.<br />
    References `/v1/hris/legal-entities?remote_model=legal_entity`</ResponseField>

    <ResponseField name="identification" type="object" required>
      **Identification**

      <Expandable title="properties">
        <ResponseField name="identificationType" type="single_select" required>**Identification Type**</ResponseField>
        <ResponseField name="identifierNumber" type="text" required>**Identifier Number**</ResponseField>
        <ResponseField name="legalName" type="text" required>**Legal Name**</ResponseField>
        <ResponseField name="secondName1" type="text" required>**Second Name 1**</ResponseField>
        <ResponseField name="secondName2" type="text" required>**Second Name 2**</ResponseField>
        <ResponseField name="sex" type="single_select" required>**Sex**</ResponseField>
        <ResponseField name="ssAffiliationNumberPrefix" type="text" required>**SS Affiliation Prefix**</ResponseField>
        <ResponseField name="ssAffiliationNumber" type="text" required>**SS Affiliation Number**</ResponseField>
        <ResponseField name="ssAffiliationNumberSuffix" type="text" required>**SS Affiliation Suffix**</ResponseField>
        <ResponseField name="enrollmentDate" type="date" required>**Enrollment Date**</ResponseField>
        <ResponseField name="personType" type="single_select" required>**Person Type**</ResponseField>
        <ResponseField name="birthRegion" type="text" required>**Birth Region**</ResponseField>
        <ResponseField name="birthCountry" type="single_select" required>**Birth Country**</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="agreement" type="object" required>
      **Agreement**

      <Expandable title="properties">
        <ResponseField name="nonRenumerated" type="checkbox" required>**Non Remunerated**</ResponseField>
        <ResponseField name="companyAgreementCode" type="text">**Company Agreement Code**</ResponseField>
        <ResponseField name="classificationCode" type="number" required>**Classification Code**</ResponseField>
        <ResponseField name="jobPositionCode" type="text" required>**Job Position Code**</ResponseField>
        <ResponseField name="subClassificationCode" type="number" required>**Sub Classification Code**</ResponseField>
        <ResponseField name="cnoOccupationID" type="single_select" required>**CNO Occupation**</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="contribution" type="object" required>
      **Contribution**

      <Expandable title="properties">
        <ResponseField name="contributionTypeID" type="single_select" required>**Contribution Type ID**</ResponseField>
        <ResponseField name="regime" type="single_select" required>**Regime**</ResponseField>
        <ResponseField name="tariffGroupID" type="number" required>**Tariff Group ID**</ResponseField>
        <ResponseField name="occupationCodeTGSS" type="text" required>**Occupation Code TGSS**</ResponseField>
        <ResponseField name="ims" type="number" required>**IMS**</ResponseField>
        <ResponseField name="it" type="number" required>**IT**</ResponseField>
        <ResponseField name="paymentFrequency" type="number" required>**Payment Frequency**</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="address" type="object" required>
      **Address**

      <Expandable title="properties">
        <ResponseField name="acronymID" type="text" required>**Acronym ID**</ResponseField>
        <ResponseField name="streetName" type="text" required>**Street Name**</ResponseField>
        <ResponseField name="buildingNumber" type="text" required>**Building Number**</ResponseField>
        <ResponseField name="stairwell" type="text" required>**Stairwell**</ResponseField>
        <ResponseField name="floor" type="text" required>**Floor**</ResponseField>
        <ResponseField name="gate" type="text" required>**Gate**</ResponseField>
        <ResponseField name="town" type="text" required>**Town**</ResponseField>
        <ResponseField name="postalCode" type="text" required>**Postal Code**</ResponseField>
        <ResponseField name="countryID" type="single_select" required>**Country ID**</ResponseField>
        <ResponseField name="poBox" type="text" required>**PO Box**</ResponseField>
      </Expandable>
    </ResponseField>
  </Tab>
</Tabs>
