https://github.com/cityssm/node-avanti-time-data-parser

Parses the time data Excel report from Avanti into a JavaScript object.
https://github.com/cityssm/node-avanti-time-data-parser

avanti parser payroll timesheets

Last synced: 7 months ago
JSON representation

Parses the time data Excel report from Avanti into a JavaScript object.

• Host: GitHub
• URL: https://github.com/cityssm/node-avanti-time-data-parser
• Owner: cityssm
• License: mit
• Created: 2024-01-23T18:29:32.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-04-18T17:34:11.000Z (about 2 years ago)
• Last Synced: 2025-10-11T09:23:56.028Z (8 months ago)
• Topics: avanti, parser, payroll, timesheets
• Language: TypeScript
• Homepage: https://www.npmjs.com/package/@cityssm/avanti-time-data-parser
• Size: 4.57 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

          
# node-avanti-time-data-parser

[![npm (scoped)](https://img.shields.io/npm/v/%40cityssm/avanti-time-data-parser)](https://www.npmjs.com/package/@cityssm/avanti-time-data-parser)

[![DeepSource](https://app.deepsource.com/gh/cityssm/node-avanti-time-data-parser.svg/?label=active+issues&show_trend=true&token=wRt7Ndp1zquLCKeUyP1gDZLL)](https://app.deepsource.com/gh/cityssm/node-avanti-time-data-parser/)

[![Maintainability](https://api.codeclimate.com/v1/badges/5d5941f60f29d0d4d952/maintainability)](https://codeclimate.com/github/cityssm/node-avanti-time-data-parser/maintainability)

[![codecov](https://codecov.io/gh/cityssm/node-avanti-time-data-parser/graph/badge.svg?token=PR322WWMI9)](https://codecov.io/gh/cityssm/node-avanti-time-data-parser)

[![Coverage Testing](https://github.com/cityssm/node-avanti-time-data-parser/actions/workflows/coverage.yml/badge.svg)](https://github.com/cityssm/node-avanti-time-data-parser/actions/workflows/coverage.yml)

Parses the time data Excel report from Avanti into a JavaScript object.

Helpful when building an external process for supervisors to approve time entered

by time entry clerks.

![Time Data in Excel](docs/excel.png)

## Installation

```sh

npm install @cityssm/avanti-time-data-parser

```

## Usage

```javascript

import { parseTimeData } from '@cityssm/avanti-time-data-parser'

const timeData = parseTimeData('timesheet.xlsx')

console.log(timeData)

/*

{

  "dateMin": "2024/01/07",

  "dateMax": "2024/01/20",

  "timeData": {

    "12345": {

      "employeeNumber": "12345",

      "employeeName": "MARIO, MARIO",

      "payCodes": {

        "REG": {

          "payCode": "REG",

          "payCodeDescription": "Regular Earnings",

          "hours": {

            "2024/01/08": 7,

            "2024/01/09": 5,

            "2024/01/10": 4,

            "2024/01/11": 7,

            "2024/01/12": 7,

            "2024/01/15": 8.5,

            "2024/01/16": 7,

            "2024/01/17": 4,

            "2024/01/18": 7,

            "2024/01/19": 7

          }

        },

        "SK": {

          ...

        },

        "SB": {

          ...

        },

        "VAC": {

          ...

        }

      }

    },

    "12346": {

      ...

    }

  },

  "approvedTimeData": {

    "12345": {

      ...

    },

    "12346": {

      ...

    }

  }

}

*/

```