/nmbrs-hibob

Export salary slip PDFs from Visma Nmbrs to Hibob

Primary LanguagePythonMIT LicenseMIT

Nmbrs to Hibob ./resources/nmbrs_hibob.png

Salary slip PDF export

At the time of writing there is no integration between Nmbrs and Hibob in the app store. This command line application allows you to export the salary slip and annual statement PDFs for a run to a zip file that can be imported in bulk to Hibob. Nmbrs' EmployeeNumber is use as the key to link to Hibob's Employee ID

Nmbrs Hibob usage

usage: nmbrs_hibob [-h] [--user USER] --token TOKEN [--run RUN] --year YEAR [--company COMPANY] [--description DESCRIPTION] [--email]

Export salary slip PDFs from Visma Nmbrs into Hibob

optional arguments:
  -h, --help            show this help message and exit
  --user USER, -u USER  API user
  --token TOKEN, -t TOKEN
                        The API token https://support.nmbrs.com/hc/en-us/articles/360013384371-Nmbrs-API
  --run RUN, -r RUN     The run to download. Prints all runs for the year if not set.
  --year YEAR, -y YEAR  The year in which the run took place
  --annual, -a          Fetch annual statements for the employees in a run
  --company COMPANY, -c COMPANY
                        Select specific company number
  --description DESCRIPTION, -d DESCRIPTION
                        Will be appended to the PDFs instead of the run description
  --email, -e           Indicates whether to use company email as folder name. Otherwise employee Id will be used

The resulting zip file will contain folders with the customer's email addresses. Within these folders the salary slips are named <year>_<run>_Salary.pdf.

Installation instructions

Directly from sourcecode

Clone the repository and run:

> pip install pipenv
> pipenv shell
> python nmbrs_hibob.py -t <api_token> -y 2021

From binaries

  1. Download the latest release for your operating system.
  2. On mac:
    1. > xattr -d com.apple.quarantine nmbrs_hibob
    2. > chmod u+x nmbrs_hibob
    3. > ./nmbrs_hibob

Hint 👉 exporting salary slips can take a long time. Run > caffeinate in separate terminal-tab to avoid the export from failing due to your machine going into sleep mode.

  1. On Windows:
    1. run nmbrs_hibob.exe from the command line

Bob import instruction

  1. In the menu 'People' go to 'Import'
  2. Select 'Employee Documents Import`
  3. Upload export from Nmbrs (.zip file)
  4. Import configruations with Matching Method:
    1. 'Folder name'
    2. 'exactly matches'
    3. 'Employee ID in Company'