Praktyka

Jak AI może czytać czas pracy, budżety i faktury z Harvest i Everhour i co zyska Wasz zespół?

Harvest i Everhour podłączone do AI wyłapują brakujące wpisy, ostrzegają o przekroczeniu budżetu i składają zestawienie godzin pod fakturę. Bez ręcznego przerzucania raportów.

⏱ 10 min czytania · 📅 19.11.2026 · 👁 84 wyświetleń

Tak, obie platformy mają dobrze udokumentowane REST API, z którego AI może wyciągnąć wpisy czasu, stany budżetów i stawki dla każdego projektu i pracownika. W praktyce oznacza to, że automat może co tydzień sprawdzić, kto nie uzupełnił timesheet'u, ostrzec kierownika gdy projekt zbliża się do granicy budżetu godzinowego, i złożyć gotowe zestawienie godzin billable pod fakturę, zanim ktokolwiek otworzy arkusz Excela.

Co siedzi w Harvest i Everhour i co z tego wyciągamy

Obie platformy budują dane wokół tego samego modelu: wpis czasu (time entry) należy do konkretnego użytkownika, przypisany jest do projektu i zadania (task), ma wartość w godzinach, flagę billable (tak/nie) oraz opcjonalne pole notatek. Różnią się tym, jak głęboko budżetowanie jest wbudowane w produkt.

W Harvest projekt ma pole budget (liczba godzin lub kwota pieniężna) oraz budget_by, które mówi, jak budżet jest liczony: per projekt, per zadanie, albo per osoba. Raport zużycia budżetu dostępny jest przez endpoint /v2/reports/time/projects, który zwraca m.in. budget_spent_hours, budget_remaining_hours i over_budget jako wartości liczbowe dla każdego projektu z osobna. Do każdego projektu można przypisać różne stawki godzinowe per użytkownik, zapisane w obiekcie user_assignments z polem hourly_rate.

Everhour podchodzi do budżetowania przez obiekt budget w projekcie z polami type (time, money, points), value (limit budżetu) i progress (ile zużyto, jako ułamek dziesiętny). Everhour dobrze integruje się z narzędziami do zarządzania zadaniami: Asana, Trello, Linear, GitHub. Wpisy czasu widać bezpośrednio w tych narzędziach, co jest dużym plusem dla firm, które już pracują w jednym z tych środowisk. Własne API Everhour jest pod adresem https://api.everhour.com/ i zwraca dane w JSON-ie o podobnej strukturze do Harvest.

Co z tych danych jest naprawdę przydatne dla firmy? Trzy obszary. Pierwsze: zestawienie godzin per osoba i per projekt w konkretnym zakresie dat, z podziałem na billable i non-billable. Drugie: lista projektów, gdzie zużycie budżetu przekroczyło próg alarmowy albo zbliża się do niego. Trzecie: lista pracowników, którzy w danym tygodniu nie uzupełnili wpisów albo mają ich za mało jak na swój wymiar etatu. Te trzy zestawienia obejmują większość cotygodniowej pracy kierownika projektu przy przeglądaniu raportów.

Typowo wygląda to tak: kierownik projektu co poniedziałek rano przegląda ubiegły tydzień i szuka dziur. W agencji z dziesięcioosobowym zespołem i kilkunastoma projektami takie przejrzenie zajmuje pół godziny, a i tak coś umknie. AI może to zrobić w kilkadziesiąt sekund i wysłać gotową listę.

Jak fizycznie wygląda podłączenie: REST API, tokeny i co trzeba mieć

Harvest udostępnia REST API v2 pod adresem https://api.harvestapp.com/v2/. Autentykacja działa przez Personal Access Token, który generujecie w ustawieniach swojego konta w sekcji Developers. Token trafia do nagłówka każdego zapytania jako Authorization: Bearer wasz-token, razem z nagłówkiem Harvest-Account-Id zawierającym identyfikator konta Harvest. Do odczytu danych (raporty, wpisy, projekty, użytkownicy) wystarczy standardowe uprawnienia konta Manager. Do tworzenia faktur przez API potrzebujecie dostępu do modułu Invoices. Harvest wspiera też OAuth 2.0, jeśli budujecie integrację dla wielu kont naraz, ale do wewnętrznego automatu firmy Personal Access Token całkowicie wystarczy.

Everhour działa podobnie. Token generujecie w Profile Settings, zakładka API. W każdym zapytaniu do API podajecie go w nagłówku X-Api-Key: wasz-token. Everhour nie wymaga OAuth do podstawowej integracji, co upraszcza pierwsze uruchomienie. Jedno zastrzeżenie: żeby przez API widzieć wpisy czasu innych użytkowników, a nie tylko swoje, Wasze konto musi mieć rolę Admin lub Manager z dostępem do raportów całego zespołu.

Czego producenci nie udostępniają? Bezpośredniego dostępu do bazy danych: nie da się odpytać SQL ani pobierać pliku bazy. Webhooków w czasie rzeczywistym Harvest oferuje dopiero w droższych planach. Jeśli chcecie, żeby automat reagował od razu po zapisaniu wpisu przez pracownika, potrzebujecie odpowiedniego planu albo odpytywania API cyklicznie co godzinę przez cron. W praktyce drugie podejście jest prostsze. Dla tygodniowego raportu albo dziennego alertu budżetowego cykliczne odpytywanie całkowicie wystarczy.

Alternatywa bez API: obie platformy mają eksport raportów do CSV z panelu. Harvest eksportuje raporty przez zakładkę Reports za wybrany zakres dat. Everhour ma analogiczny eksport. Jeśli firma woli nie używać API albo tokeny są kwestią wrażliwą z powodów organizacyjnych, automat może pobierać eksportowane pliki z folderu i na tej podstawie generować raporty. Traci się wtedy działanie zbliżone do czasu rzeczywistego, ale dla tygodniowych podsumowań to wystarczy.

Brakujące wpisy: kto nie uzupełnił timesheet'u i co AI z tym robi

To codzienność w agencjach i firmach usługowych. Ktoś zapomniał, ktoś był na wyjeździe i odłożył na potem, ktoś uznał, że "i tak pamięta". Wynik: na koniec miesiąca zestawienie dla klienta kuleje albo godziny przepadają.

Automat działa tak: pobiera z API listę wszystkich aktywnych użytkowników przez endpoint /v2/users (Harvest) albo /api/team/members (Everhour). Następnie dla każdego sprawdza, ile wpisów czasu ma w danych dniach roboczych. Porównuje to z oczekiwanym minimum, zapisanym w konfiguracji automatu, np. 8h dziennie dla pełnego etatu albo inaczej dla niepełnego. Każdy, kto nie osiąga progu, trafia na listę.

U jednego klienta, agencji digitalowej z dziesięcioosobowym zespołem, automat działał co piątek o 14:00 i sprawdzał poprzednie 5 dni roboczych. Jeśli ktoś miał mniej niż 32 godziny (zakładali 40h tydzień, z buforem na spotkania nieprzypisane do projektu), dostawał maila: "Brakuje Twoich wpisów za środę i czwartek, projekt X albo Y czeka na uzupełnienie." Kierownik dostawał zbiorczą listę wszystkich takich przypadków. To zastąpiło cotygodniowe ręczne przeglądanie arkusza zbiorczego.

Dodatkowy detal: AI może sprawdzać nie tylko liczbę godzin, ale też to, do jakich projektów trafiają wpisy. W Harvest pole project.is_active i task.is_active zwraca, czy projekt i zadanie są nadal aktywne. Zdarza się, że pracownik loguje czas do projektu, który formalnie się skończył, albo loguje wszystko do worka "Internal" zamiast do właściwego klienta. Automat to wyłapuje i daje sygnał do korekty.

Jeden praktyczny wniosek: żeby automat działał dobrze, lista użytkowników musi być aktualna. Gdy ktoś odchodzi z firmy, konto w Harvest albo Everhour powinno być dezaktywowane. Nieaktywni użytkownicy (pole is_active: false w API) są łatwo filtrowani, więc to nie jest problem techniczny, tylko organizacyjny.

Przekroczenie budżetu: ostrzeżenie, zanim klient dostanie niespodziankę

Budżet projektu przekracza się zwykle nie z dnia na dzień. Dwa dodatkowe spotkania tu, kilka emaili tam, poprawki, których nie było w briefie. Zanim ktokolwiek sprawdzi raporty, projekt jest na 115% budżetu i za późno na rozmowę z klientem o zmianie zakresu.

AI czyta stan budżetu z endpointu /v2/reports/time/projects w Harvest, gdzie pole over_budget przyjmuje wartość true, gdy projekt przekroczył budżet. Możecie też sami wyliczyć stosunek budget_spent_hours do budget i ustawić własne progi alertu. W Everhour pole budget.progress zwraca ułamek zużycia, np. wartość 0.82 oznacza 82% zużytego budżetu.

Możecie ustawić dwa progi. Przy 80% zużycia budżetu automat wysyła spokojne ostrzeżenie do kierownika projektu: "Projekt Redesign Sklepu XYZ zużył 80% budżetu godzinowego, 64 z 80 godzin. Termin końca projektu za 3 tygodnie." Przy 95% albo przy przekroczeniu alarm trafia też do właściciela firmy. Co z tym zrobić, decyduje człowiek: może wrócić do klienta z rozmową o zmianie zakresu, przyspieszyć koniec projektu albo zaplanować rozliczenie nadgodzin.

Coś, czego ręczne przeglądanie zwykle nie łapie: projekty, gdzie różni pracownicy mają różne stawki w obiekcie user_assignments. Jeśli do projektu dołączyła osoba z wyższą stawką niż zakładano przy wycenie, budżet pieniężny wypalał się szybciej niż godzinowy. AI może to wyliczyć i pokazać kierownikowi, gdzie jest różnica, zanim problem stanie się widoczny dopiero na fakturze.

Zestawienie godzin do faktury: co AI przygotowuje i jak to wygląda

Harvest ma wbudowany moduł faktur (Invoices), który można zasilać wpisami czasu przez API. Endpoint /v2/invoices pozwala zarówno pobierać istniejące faktury, jak i tworzyć nowe z list unbilled time entries dla danego klienta. W praktyce: AI pobiera wszystkie billable time entries niewystawione jeszcze na fakturę, grupuje je według zadania albo według pracownika i tworzy szkic faktury z gotowymi pozycjami. Kierownik dostaje gotowy szkic do sprawdzenia, zamiast ręcznie przepisywać godziny.

Everhour nie ma własnego modułu faktur. Dane godzinowe można jednak pobrać przez API i wysłać do zewnętrznego systemu fakturowego. Jeśli firma używa np. iFirmy, Fakturowarni albo własnego ERP, automat pobiera zestawienie godzin billable z Everhour, przelicza wartość (godziny razy stawka z konfiguracji projektu) i przesyła pozycje do systemu fakturowego przez jego API. Możliwa jest też wersja prostsza: automat generuje plik CSV, który ktoś importuje do systemu fakturowego ręcznie.

Typowy raport godzinowy dla klienta wygląda tak:

  • data wpisu (w formacie DD.MM.RRRR)
  • imię i nazwisko osoby
  • opis zadania (pole notes z wpisu czasu)
  • liczba godzin
  • stawka godzinowa
  • wartość pozycji netto

Na dole suma godzin i suma wartości z dopiskiem "netto". AI składa to w kilkadziesiąt sekund. Ręczne złożenie tego samego z eksportu CSV w Excelu, szczególnie gdy projekt miał kilka osób o różnych stawkach i kilkadziesiąt wpisów, zajmuje od kwadransa do godziny.

Pułapka, o której warto wiedzieć: pole notes we wpisach czasu bywa puste albo lakoniczne, bo pracownicy nie mają nawyku opisywania każdego wpisu. Jeśli chcecie wysyłać klientowi zestawienie z opisami, trzeba albo wyrobić ten nawyk w zespole (na przykład flagując puste notatki w tygodniowym raporcie), albo grupować wpisy na poziomie zadania (task), gdzie opisy są zazwyczaj lepsze. Warto sprawdzić jakość pola notes w Waszym systemie przed uruchomieniem automatycznych zestawień.

Od czego zaczynamy

Zanim uruchomimy cokolwiek, sprawdzamy trzy warunki. Czy macie token API z konta o roli Administrator lub Manager, żeby widzieć dane całego zespołu. Czy projekty mają wpisane budżety i czy użytkownicy mają uzupełnione stawki hourly rate: bez budżetu alert o przekroczeniu nie zadziała, bez stawki nie przeliczymy wartości godzin. Czy firma ma ustalone, ile godzin dziennie powinien mieć każdy pracownik: bez tej liczby "brakujący wpis" to pojęcie, którego automat nie potrafi zdefiniować.

Dobry punkt startowy to jeden automat: tygodniowy raport brakujących wpisów. Proste zapytanie do API, efekt widać od pierwszego uruchomienia, żadnych zmian w samym Harvest ani Everhour. Przy okazji wychodzi, jak dobra jest jakość danych: czy projekty mają budżety, czy stawki są wpisane, czy pracownicy w ogóle regularnie logują czas.

Kolejny krok to alerty budżetowe, uruchamiane raz dziennie rano. Potem, na koniec miesiąca, zestawienie do faktury. W większości firm usługowych te trzy automaty razem pokrywają znaczną część pracy, którą kierownik projektu robi ręcznie w raportach, bez zmiany nawyków zespołu ani nowych narzędzi dla pracowników.

Chcecie zobaczyć, jak to wygląda na Waszych danych z Harvest lub Everhour? 15 minut rozmowy wystarczy, żeby ocenić, co ma sens w Waszym przypadku. Możecie też zajrzeć na realne wdrożenia, żeby zobaczyć, jak podobne integracje działają w innych firmach usługowych i agencjach.

Chcecie to u siebie?

Na osobnej stronie rozpisaliśmy, co dokładnie podłączamy w Harvest, o co możecie wtedy pytać asystenta i ile kosztuje wdrożenie.

Co podłączamy i ile to kosztuje →

Najczęstsze pytania

Czy AI może samo wysyłać faktury z Harvest do klientów bez udziału człowieka?

Harvest ma API do tworzenia i wysyłania faktur, ale rekomendujemy, żeby wysyłkę zatwierdzał człowiek. AI składa gotowy szkic z wpisów billable, kierownik sprawdza pozycje i stawki, dopiero po zatwierdzeniu faktura idzie do klienta. Pełna automatyzacja jest technicznie możliwa, ale przy rozliczeniach za godziny warto mieć jedno ludzkie oko przed wysyłką.

Czy muszę mieć drogi plan Harvest, żeby podłączyć API do automatu?

Podstawowe REST API jest dostępne w każdym płatnym planie Harvest. Webhooków w czasie rzeczywistym potrzebujecie dopiero wtedy, gdy chcecie reakcję od razu po zapisaniu wpisu. Większość automatów, tygodniowy raport i dzienny alert, działa na cyklicznym odpytywaniu API i nie wymaga droższego planu.

Co zrobić, gdy pracownicy nie wpisują czasu w Harvest regularnie?

AI może co tydzień pobierać listę wpisów z API, porównywać je z oczekiwanym minimum godzin dla każdej osoby i automatycznie wysyłać przypomnienia. Warunek jest jeden: musicie mieć ustalone, ile godzin tygodniowo powinien mieć każdy pracownik, żeby automat wiedział, kiedy brakuje.

Czy integracja Harvest z AI wymaga dostępu do bazy danych programu?

Nie, Harvest i Everhour nie udostępniają bezpośredniego dostępu do bazy danych, nie da się odpytać SQL ani pobrać pliku bazy. Integracja działa przez REST API, które oba programy mają dobrze opisane. Potrzebujecie tokenu API z konta Manager lub Administrator i miejsca, gdzie skrypt będzie uruchamiany cyklicznie.

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ąć.

Opracowanie: zespół redAi z wykorzystaniem narzędzi AI.

Następny krok

Podłączymy Harvest do AI u Was

15 minut rozmowy: mówicie, czego szukacie w danych, my mówimy, co wyciągniemy z Harvest, ile to potrwa i czego potrzebujemy po Waszej stronie.

  • Bezpłatna prezentacjaAI na Waszych zadaniach, nie na slajdach.
  • Dostęp tego samego dniaZespół od razu pracuje we własnym portalu.
  • Do 2 tygodni testówPłacicie dopiero po decyzji.

Może Was też zainteresować