Integracje / Harvest

Komunikacja, projekty i biuro

Integracja AI: Harvest

Podłączamy wpisy czasu, budżety projektów i moduł Invoices przez REST API Harvest. Asystent czyta zużycie budget_spent_hours, wykrywa luki w timesheetach i składa zestawienia godzin billable gotowe pod fakturę.

Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.

Narzędzie „Budżety projektów z Harvest” w portalu redAi, ekran z danymi z programu Harvest
Narzędzie „Budżety projektów z Harvest” w Waszym portalu. Dane przykładowe.

W skrócie

Jak asystent AI łączy się z systemem Harvest?

Łączymy się z Harvest przez REST API v2 pod adresem api.harvestapp.com/v2. W każdym zapytaniu wysyłamy nagłówek Authorization: Bearer z Personal Access Token z sekcji Developers oraz nagłówek Harvest-Account-Id z identyfikatorem konta.

Na start potrzebujemy
Personal Access Token wygenerowany w sekcji Developers w ustawieniach konta Harvest
Czego asystent nie robi
Asystent nie wysyła faktur do klientów bez zatwierdzenia przez człowieka: tworzy szkic w Invoices, decyzja o wysyłce należy do kierownika lub właściciela.
Gdzie są dane
Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.

Dane z Harvest w czacie i we własnym module

Pracujecie na dwa sposoby. W czacie pytacie o cokolwiek z programu i dostajecie odpowiedź na Waszych danych. Do rzeczy, które wracają co dzień, budujemy w portalu osobne narzędzie: Budżety projektów z Harvest. Moduł pobiera z Harvest budżet godzinowy każdego aktywnego projektu i pokazuje go w jednym miejscu: procent zużycia, liczbę wpisów billable i flagę over_budget. Wasz kierownik widzi od razu, które projekty wymagają uwagi, bez szukania po raportach w Harvest. Alerty przy 80% i 95% dają Wam czas na rozmowę z klientem, zanim projekt przekroczy plan.

  • Pobiera budget_spent_hours i budget_remaining_hours z każdego aktywnego projektu
  • Sygnalizuje przekroczenie progu 80% i 95% odznaką warn lub err
  • Zlicza wpisy billable bez przypisanej faktury per projekt, gotowe do sprawdzenia
  • Wykrywa projekty, gdzie pracownik Waszego zespołu ma wyższą stawkę niż przy wycenie
  • Łączy dane z modułu Invoices i wskazuje Wam wpisy pominięte przy fakturowaniu
Rozmowa z asystentem AI w portalu redAi o danych z programu Harvest: Luki w timeshetach: bieżący tydzień

Pytanie w czacie

Asystent pobiera dane z /v2/users i /v2/time_entries, porównuje z oczekiwanym minimum i od razu wskazuje Wam, gdzie są braki w timeshetach.

Kto z zespołu nie uzupełnił czasu pracy w Harvest w tym tygodniu? Sprawdź wszystkich aktywnych użytkowników.
Karta Redesign aplikacji w narzędziu Budżety projektów z Harvest w portalu redAi

Karta w narzędziu

Karta projektu łączy dane budżetowe, wpisy billable i historię zmian z Harvest w jednym miejscu, z podpowiedzią asystenta dla Waszego kierownika, zanim projekt wejdzie w over budget.

Jeden ekran zamiast kilku raportów w Harvest: stan budżetu, wpisy billable i alerty w miejscu, gdzie pracuje cały Wasz zespół.

Ekrany na danych przykładowych. Narzędzie dla Waszej firmy układamy pod Wasz sposób pracy: inne kolumny, inne progi, inne powiadomienia.

Co podłączamy

Zaczynamy od odczytu danych. Zapis i akcje w systemie Harvest włączamy dopiero wtedy, gdy sami tego chcecie.

Wpisy czasu

Czytamydata, użytkownik, projekt, zadanie, liczba godzin, flaga billable, pole notatek

AsystentGrupuje godziny billable i non-billable per osoba i projekt w wybranym zakresie dat, gotowe pod zestawienie dla klienta

Budżet godzinowy projektu

Czytamybudget_spent_hours, budget_remaining_hours, over_budget, tryb liczenia budget_by

AsystentLiczy procent zużycia i sygnalizuje kierownikowi, gdy projekt przekracza ustawiony próg alarmowy, np. 80% lub 95%

Stawki godzinowe per pracownik

Czytamyuser_assignments z polem hourly_rate dla każdego pracownika przypisanego do projektu

AsystentWykrywa projekty, gdzie dołączyła osoba z wyższą stawką niż zakładano przy wycenie, i pokazuje różnicę między budżetem godzinowym a pieniężnym

Lista aktywnych użytkowników

Czytamyendpoint /v2/users: imię, nazwisko, mail, flaga is_active i informacja o wymiarze etatu

AsystentPorównuje sumę wpisów z oczekiwanym minimum godzin i układa listę osób z brakami w timeshecie za dany tydzień

Status projektu i zadania

Czytamyproject.is_active i task.is_active zwracane przy każdym wpisie czasu w API

AsystentWyłapuje wpisy zalogowane do zamkniętych projektów lub nieaktywnych zadań i zgłasza je kierownikowi do korekty

Nierozliczone wpisy billable

Czytamytime entries z flagą billable bez przypisanej faktury, pogrupowane per klient

AsystentSkłada szkic faktury w module Invoices z gotowymi pozycjami; kierownik dostaje dokument do sprawdzenia przed wysyłką

Istniejące faktury (Invoices)

Czytamynumer, klient, kwota, status, lista pozycji z godzinami i stawkami

AsystentKontroluje, czy wszystkie billable wpisy za dany okres zostały ujęte na fakturze, i wskazuje ewentualne pominięcia

O co pytają w praktyce

Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.

  • „Kto z zespołu nie uzupełnił czasu pracy w tym tygodniu?”
  • „Które projekty przekroczyły 80% budżetu godzinowego?”
  • „Ile godzin billable zebrało się dla klienta Nowak w tym miesiącu?”
  • „Na którym projekcie wyższe stawki pracowników zjadają budżet szybciej niż planowaliśmy?”

Co się zmienia

Kierownik projektu zamiast pół godziny ręcznego przeglądania raportów dostaje gotową listę luk w timesheetach i alertów budżetowych w kilka sekund.

Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.

O programie

Harvest to platforma do rejestrowania czasu pracy i rozliczania projektów, używana głównie przez agencje, firmy konsultingowe i studia usługowe. Pracownicy logują czas bezpośrednio w przeglądarce lub aplikacji mobilnej, przypisując każdy wpis do projektu i zadania. Dane trzymane są w chmurze producenta, dostępne przez panel webowy oraz REST API v2.

Harvest łączy w jednym narzędziu cztery obszary: rejestr czasu pracy, budżetowanie projektów z progami godzinowymi i kwotowymi, zarządzanie stawkami per pracownik i projekt oraz moduł faktur Invoices do wystawiania należności z nierozliczonych wpisów. Budżet każdego projektu można liczyć inaczej: per cały projekt, per zadanie albo per osobę, co steruje polem budget_by w API.

Gdzie to działa najlepiej

Kierownik projektu

W poniedziałek rano chce przejrzeć poprzedni tydzień: kto nie uzupełnił timeshetu, które projekty zbliżają się do granicy budżetu godzinowego i czy są nierozliczone wpisy billable czekające na fakturę.

Z asystentem: Asystent pobiera dane z API, porównuje wpisy z oczekiwanym minimum i stanem budżetów, a kierownik dostaje gotową listę luk i alertów zamiast pół godziny w raportach Harvest.

Właściciel agencji

Projekt przekroczył 90% budżetu godzinowego trzy tygodnie przed terminem. Właściciel nie wiedział, bo nikt nie zaglądał do raportów w Harvest od ponad tygodnia, a klient niczego się nie spodziewa.

Z asystentem: Automat codziennie czyta budget_spent_hours i wysyła alert przy 80% oraz 95%, dając czas na rozmowę z klientem o zmianie zakresu, zanim projekt wejdzie na straty.

Osoba rozliczająca faktury

Na koniec miesiąca ręcznie przegląda wpisy billable w Harvest, przepisuje godziny do szablonu faktury i sprawdza po kolei każdego klienta, czy żaden wpis nie umknął.

Z asystentem: Asystent grupuje nierozliczone wpisy billable per klient i tworzy szkic w module Invoices. Osoba rozliczająca sprawdza pozycje i zatwierdza, zamiast składać fakturę od zera.

Jak się łączymy

Łączymy się z Harvest przez REST API v2 pod adresem api.harvestapp.com/v2. W każdym zapytaniu wysyłamy nagłówek Authorization: Bearer z Personal Access Token z sekcji Developers oraz nagłówek Harvest-Account-Id z identyfikatorem konta. Do odczytu raportów, wpisów, projektów i użytkowników wystarczy konto z rolą Manager. Tworzenie szkiców faktur przez API wymaga dostępu do modułu Invoices. Harvest wspiera też OAuth 2.0, ale do wewnętrznego automatu firmy Personal Access Token całkowicie wystarczy.

Asystent pracuje na cyklicznym odpytywaniu API: harmonogram uruchamia skrypt co godzinę, codziennie lub co tydzień, zależnie od potrzeby. Harvest nie udostępnia bezpośredniego dostępu do bazy SQL: integracja działa wyłącznie przez API. Portal z plikami i historią rozmów stoi na serwerze klienta. Do modelu AI trafia polecenie i fragmenty potrzebne do odpowiedzi, bez trenowania cudzych modeli na danych klienta.

Czego potrzebujemy od Was

  • Personal Access Token wygenerowany w sekcji Developers w ustawieniach konta Harvest
  • Identyfikator konta Harvest (Harvest-Account-Id) widoczny w tym samym panelu Developers
  • Konto z rolą Manager lub Admin, żeby API zwracało dane całego zespołu, nie tylko jednej osoby
  • Dostęp do modułu Invoices w Harvest, jeśli asystent ma składać szkice faktur przez API
  • Ustalone minimum godzin tygodniowo per pracownik, żeby automat wiedział, kiedy brakuje wpisów

Czego asystent nie robi

  • Asystent nie wysyła faktur do klientów bez zatwierdzenia przez człowieka: tworzy szkic w Invoices, decyzja o wysyłce należy do kierownika lub właściciela.
  • Asystent nie zmienia ani nie usuwa wpisów czasu, projektów ani użytkowników w Harvest bez wyraźnego polecenia i potwierdzenia osoby, która o to prosi.
  • Asystent nie ocenia, czy projekt wymaga zmiany zakresu lub rozmowy z klientem: dostarcza liczby z API, decyzję podejmuje człowiek.
  • Asystent nie monitoruje Harvest w czasie rzeczywistym: działa na cyklicznym odpytywaniu API, więc między kolejnymi uruchomieniami mogą minąć godziny.

Częste pytania

Czy integracja zadziała, gdy mamy kilka kont Harvest dla różnych spółek?

Każde konto Harvest ma oddzielny Harvest-Account-Id i token. Automat może obsługiwać kilka kont naraz, wysyłając zapytania z odpowiednim nagłówkiem dla każdego z nich. Raporty i alerty można scalać w jedno zestawienie albo trzymać osobno dla każdej spółki.

Co się stanie z automatem, gdy pracownik odejdzie i jego konto zostanie usunięte?

Gdy konto pracownika w Harvest zostanie dezaktywowane (is_active: false w API), automat automatycznie pomija tę osobę przy sprawdzaniu luk w timeshecie i obliczaniu budżetów. Warunek jest jeden: konto musi być faktycznie dezaktywowane w Harvest, a nie tylko zapomniane przez administratora.

Czy możemy ustawić różne progi alertu budżetowego dla różnych projektów?

Tak. Progi alarmowe, np. 80% dla ostrzeżenia i 95% dla alarmu, zapisujemy w konfiguracji automatu i możemy je różnicować per projekt albo per klient. Automat porównuje je z wartością budget_spent_hours zwracaną przez Harvest API dla każdego projektu osobno.

Czy asystent poradzi sobie, gdy pracownicy logują czas przez aplikację mobilną Harvest?

Tak. Niezależnie od tego, czy wpisy trafiają do Harvest z przeglądarki, aplikacji mobilnej czy integracji z narzędziem zewnętrznym, API Harvest zwraca je w jednolitym formacie. Asystent widzi każdy wpis z przypisanym projektem, zadaniem i flagą billable, bez względu na to, skąd wpis pochodzi.

Pełny opis integracji w bazie wiedzy →

Jak zaczynamy

  1. Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
  2. Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
  3. Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Wybierzcie termin → Wolicie napisać?
Wolicie napisać

Pokażemy to na Waszych danych z Harvest

Jedno zdanie wystarczy: czego szukacie w Harvest albo co ma się dziać samo. Odpiszemy, co podłączymy i od czego zacząć.

Harvest jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.