Menu

Samenvatting van de Harvest API

De Harvest API stelt bureaus en zakelijke dienstverleners in staat om hun urenregistratie-, project- en facturatieprocessen volledig te automatiseren. Hiermee voorkom je dubbele invoer en zorg je voor een betrouwbare stroom van tijd- en kostengegevens tussen Harvest en je CRM, boekhouding of projectmanagementsysteem.
  • Urenregistratie automatiseren: Lees, schrijf en actualiseer tijdregels per medewerker, project en taak, en start of stop timers vanuit je eigen applicatie.
  • Projecten en budgetten beheren: Maak projecten aan, wijs medewerkers en taken toe, en bewaak budgetten in uren of kosten via het Project Budget Report.
  • Facturatie uit uren en kosten: Genereer concept- en definitieve facturen op basis van geregistreerde uren en declaraties, registreer betalingen en verstuur reminders of bedankmails.
  • Klanten en contactpersonen synchroniseren: Houd CRM-relaties en facturatiegegevens in sync met een centraal klantenbestand in Harvest.
  • Declaraties en bonnen verwerken: Registreer declaraties met bijlagen, goedkeuringsstatus en koppelingen aan projecten en invoices.
  • Rapportages ontsluiten: Haal tijd-, declaratie-, onfacturabele- en budgetrapportages op voor dashboards en BI-tools.
API Quick Facts REST
  • Authenticatie OAuth2, Bearer Token
  • Methods GET (55)POST (20)PATCH (19)DELETE (19)
  • Rate limits 100 requests per 15 seconden (algemeen), 100 per 15 minuten voor Reports API
  • Webhooks Niet beschikbaar
  • Sandbox Niet beschikbaar
  • Response format JSON
  • Versionering URL-based

Laatste ontwikkelingen bij de Harvest API

Harvest bracht in 2017 de V2 REST API uit als opvolger van de eerdere V1-API met Basic Authentication. De V2 werkt volledig via OAuth 2.0 of Personal Access Tokens en biedt een consistent JSON-formaat met duidelijke paginatie. In de jaren daarna zijn endpoints voor Roles, Teammates, Billable Rates en Cost Rates toegevoegd, plus rapportage-endpoints voor tijd, declaraties, onfacturabele uren en projectbudgetten. Recentere uitbreidingen omvatten cursor-gebaseerde paginatie ter vervanging van page-parameters en optionele Forecast-integratie in de tijdrapportages voor geplande uren.

API versies

Cursor pagination

Invoering van cursor-gebaseerde paginatie voor lijst-endpoints; de page-parameter is gedeprecieerd en vervangen door next/previous links.

Forecast-integratie in Reports

De Projects- en Team-rapporten ondersteunen include_forecast=true om ingeplande uren uit Harvest Forecast mee te leveren.

Roles & Teammates endpoints Major release

Uitbreiding met endpoints voor rollen, teammates, billable rates en cost rates per gebruiker.

REST API v2 Major release
1 september 2017

Lancering van de V2 REST API met OAuth 2.0 en Personal Access Tokens, als opvolger van de V1 met Basic Authentication.