Skip to content

simplyspoke/node-harvest

Repository files navigation

Node Harvest

Build Status Coverage Status npm version Dev Dependencies Greenkeeper badge styled with prettier semantic-release

Version 1.x - Will be depreciated in the days to come, once enough testing of Version 2.x has been completed.

Version 2.x - This is a substantial update to the prior versions adding functionality compatible with the Harvest API v2. This version is not backwards compatible

Harvest is a tool that enables businesses to track time, track projects, manage clients, and invoice. This is a full client API built using node.js and the Harvest API. This node module provides an easy to use wrapper for the API returning promises.

Install

npm install harvest

Usage

Basic Authentication

import Harvest from 'harvest';

const harvest = new Harvest({
  subdomain: 'SUBDOMAIN',
  userAgent: 'MyApp (yourname@example.com)',
  concurrency: 1,
  auth: {
    accessToken: process.env.ACCESS_TOKEN,
    accountId: process.env.ACCOUNT_ID
  }
});

harvest.company
  .get()
  .then((response) => {
    const company = response;
    // Do some things with the company data
  });

OAuth Authentication

NOTE: This feature has not yet been coded. To track its progress or provide feedback, use the following issue: #85

Resources

Every resource is accessed via your harvest instance:

// harvest.<resouce_name>.<method_name>

Each method returns to a promise that resolves the results:

harvest.projects.list().then((projects) =>{
  // Do something with the projects list.
})

Available resources and methods (Method documentation not complete.)

  • clients
  • company
  • contacts
  • estimateItemCategories
  • estimateMessages
  • estimates
  • expenseCategories
  • expenses
  • invoiceItemCategories
  • invoiceMessages
  • invoicePayments
  • invoices
  • projectAssignments
  • projects
  • roles
  • taskAssignments
  • tasks
  • timeEntries
  • userAssignments
  • users

For all methods, the last variable is expected to be a callback function. The possible options available for the params object can be found in the Harvest API Documentation.

Testing

In order to run the tests, you will need to have the following environmental variables defined:

SUBDOMAIN=''
ACCESS_TOKEN=''
ACCOUNT_ID=''

For additional information about setting up harvest access tokens, visit the following page: https://help.getharvest.com/api-v2/authentication-api/authentication/authentication/

Running the tests

npm test
npm run test:watch
npm run test:integration
npm run test:integration:watch

Projects using this library

  • impleri/sow: Command line time tracking utility
  • pingsrl/revenue: Revenue is a dashboard that gives you a quick summary of your revenue from Harvest