Integracje / Deel
Kadry, płace i rekrutacja
Integracja AI: Deel
Podłączamy Deel API do kontraktów, faktur i dokumentów compliance. Asystent czyta pola end_date, invoice.status i expiry_date, flaguje faktury z kwotą wyższą niż compensation_amount z umowy i wysyła alerty o kończących się umowach.
Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.

W skrócie
Jak asystent AI łączy się z systemem Deel?
Łączymy się z Deel przez REST API (Deel API v2) za pomocą Bearer Tokena generowanego w sekcji Integrations > API Keys. Token dostaje zakres read-only: asystent czyta dane, nie zmienia rekordów.
- Na start potrzebujemy
- Konto Deel na planie płatnym (plan Free nie obsługuje dostępu do API)
- Czego asystent nie robi
- Asystent nie zatwierdza faktur w Deel: kliknięcie Approve zawsze należy do człowieka
- Gdzie są dane
- Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.
Dane z Deel 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: Kontrakty i compliance Deel. Moduł zbiera z Deel aktywne kontrakty kontraktorów i pracowników EOR wraz ze statusem dokumentów compliance. Dział HR widzi w jednym miejscu, kto ma wygasający dokument, kiedy kończy się umowa i które faktury czekają na przegląd, bez logowania do Deel i przełączania zakładek.
- Wyświetla wszystkie aktywne kontrakty z typem zatrudnienia i krajem kontraktora
- Oznacza dokumenty compliance wygasające w ciągu 30 dni według kraju i typu pozwolenia
- Flaguje faktury przekraczające próg wynagrodzenia z umowy przed akceptacją
- Wykrywa faktury obejmujące inny okres niż wynikający z cyklu płatności w umowie
- Pokazuje umowy na czas określony kończące się w tym i następnym miesiącu

Pytanie w czacie
Asystent wychwytuje rozbieżności między cyklem płatności z umowy a zakresem faktury, zanim trafią do zatwierdzenia, skracając czas weryfikacji z godzin do sekund.
Sprawdź w Deel, które faktury kontraktorów obejmują inny okres rozliczeniowy niż wynika z cyklu płatności zapisanego w ich umowie.

Karta w narzędziu
Karta rekordu łączy dane z Deel z podpowiedzią asystenta: zamiast szukać przepisów dla Niemiec, HR dostaje konkretną sugestię z następnym krokiem i może zlecić działanie jednym kliknięciem.
Moduł zastępuje ręczne przeglądanie dziesiątek kart w Deel: HR dostaje gotową listę priorytetów, a każde kliknięcie otwiera pełny rekord z historią i sugestią asystenta.
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 Deel włączamy dopiero wtedy, gdy sami tego chcecie.
Czytamyemployment_type (contractor lub EOR employee) i contract_duration_type (fixed albo indefinite) per rekord
AsystentRozróżnia reguły alertów dla kontraktorów i pracowników EOR; dla EOR włącza sprawdzanie dodatkowych typów dokumentów wymaganych w danym kraju
Czytamyservice_period_start i service_period_end z faktury kontraktora oraz payment_cycle z jego umowy
AsystentWykrywa faktury obejmujące inny okres niż wynika z cyklu umowy, np. sześć tygodni przy umowie miesięcznej, i zgłasza to przed akceptacją
Czytamycontract.status (active, completed, cancelled) w chwili wystawienia faktury przez kontraktora
AsystentFlaguje każdą fakturę wystawioną po zakończeniu współpracy; brak aktywnej umowy to automatyczna adnotacja w raporcie dla osoby zatwierdzającej
Czytamyright_to_work_expiry, work_permit i visa z expiry_date i statusem, osobno dla pracowników EOR per kraj
AsystentPriorytetyzuje alerty o wygasających pozwoleniach na pracę, bo ich wygaśnięcie niesie poważniejsze konsekwencje prawne niż u zwykłego kontraktora
Czytamyaktywne kontrakty, niezłożone faktury za bieżący okres, umowy wygasające do końca wskazanego miesiąca
AsystentOdpowiada na pytania menedżera w kilka sekund bez angażowania finansów: kto nie złożył faktury, ile aktywnych kontraktorów, które umowy kończą się wkrótce
Czytamycompensation_currency per umowa, waluta faktury i country_code kontraktora
AsystentPorównuje kwoty w walucie danej umowy bez przeliczania między walutami; różnicuje wymagane dokumenty compliance dla każdego kraju osobno
O co pytają w praktyce
Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.
- „Które umowy kontraktorów kończą się w ciągu najbliższych 60 dni?”
- „Kto nie złożył jeszcze faktury za ubiegły miesiąc?”
- „Która faktura ma kwotę wyższą niż stawka z umowy?”
- „Jaki jest status płatności dla kontraktora z Niemiec za ten miesiąc?”
Co się zmienia
Faktury kontraktorów trafiają do zatwierdzenia z gotową listą rozbieżności, a HR dostaje alerty o wygasających umowach i dokumentach, zanim problem pojawi się na skrzynce.
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
Deel to platforma do zarządzania współpracą z kontraktorami i pracownikami zdalnymi w wielu krajach jednocześnie. Firmy używają jej, gdy mają kilka lub kilkadziesiąt osób rozsianych po Europie, Ameryce czy Azji. Platforma generuje umowy zgodne z lokalnymi przepisami, zbiera dokumenty wymagane przez dany kraj i obsługuje płatności w walucie kontraktora.
Na co dzień praca w Deel toczy się przez panel webowy: kontraktorzy wystawiają faktury, HR przegląda dokumenty compliance, a dział finansowy zatwierdza płatności. Dane siedzą w chmurze Deel i są dostępne przez REST API (Deel API v2) oraz eksporty CSV z sekcji Reports. Cztery moduły, z których asystent czyta dane, to umowy (contracts), faktury (invoices), dokumenty zgodności i płatności.
Gdzie to działa najlepiej
Specjalista HR
Co miesiąc ręcznie przegląda rekordy kilkudziesięciu kontraktorów z kilku krajów, żeby wychwycić wygasające dokumenty compliance i umowy na czas określony. Przy każdej osobie inny zestaw wymaganych dokumentów i inne daty.
Z asystentem: Asystent co noc przegląda aktywne kontrakty i dokumenty compliance, wysyła alert z listą: imię, kraj, typ dokumentu, data wygaśnięcia i link do rekordu w Deel. HR reaguje zamiast szukać.
Dyrektor Finansowy
Pod koniec miesiąca trafia do niego kilkanaście faktur kontraktorów do zatwierdzenia. Nie ma czasu porównywać każdej kwoty z umową, więc akceptuje na podstawie przybliżonej sumy. Rozbieżność wychodzi dopiero przy rozliczeniu kwartalnym.
Z asystentem: Asystent przygotowuje raport do każdej faktury: zgodna z umową albo rozbieżność z podaniem konkretnego pola i różnicy kwotowej. Faktury z wyjątkami trafiają do osobnej listy z adnotacją.
Menedżer projektu
Chce wiedzieć, które umowy kończą się do końca kwartału i kto nie złożył jeszcze faktury za ubiegły miesiąc. Bez asystenta musi logować się do Deel, filtrować ręcznie i zestawiać dane z dwóch różnych zakładek.
Z asystentem: Asystent pobiera aktualne dane z API i odpowiada w kilka sekund: lista umów z datą wygaśnięcia i lista kontraktorów bez faktury za wskazany okres. Żadnej prośby do finansów ani HR.
Jak się łączymy
Łączymy się z Deel przez REST API (Deel API v2) za pomocą Bearer Tokena generowanego w sekcji Integrations > API Keys. Token dostaje zakres read-only: asystent czyta dane, nie zmienia rekordów. Do wygenerowania klucza potrzebna jest rola Organization Owner albo Admin. Synchronizację ustawiamy raz na godzinę przy kilkudziesięciu kontraktorach, bo Deel ma limity wywołań API.
Portal z rozmowami i plikami firmy stoi na serwerze klienta. Do modelu AI trafia polecenie i tylko te fragmenty danych, które są potrzebne do konkretnego alertu albo odpowiedzi. Klucz API z zakresem read-only oznacza, że asystent pobiera dane z Deel i nie modyfikuje żadnych rekordów bez osobnego tokenu z uprawnieniami zapisu.
Czego potrzebujemy od Was
- Konto Deel na planie płatnym (plan Free nie obsługuje dostępu do API)
- Rola Organization Owner lub Admin w Deel do wygenerowania klucza API
- Mapowanie struktury konta: kto zatwierdza faktury, jakie waluty i kraje macie w grze
- Wskazanie osoby lub adresu e-mail do odbierania alertów o wygasających umowach i dokumentach
- Lista priorytetowych monitorów do uruchomienia w pierwszym kroku wdrożenia
Czego asystent nie robi
- Asystent nie zatwierdza faktur w Deel: kliknięcie Approve zawsze należy do człowieka
- Asystent nie przedłuża ani nie podpisuje umów: generuje alert, decyzja zostaje po stronie HR lub menedżera
- Asystent nie widzi historii zmian wynagrodzenia: pobiera aktualną wartość compensation_amount, nie log wcześniejszych stawek
- Asystent nie czyta wiadomości z czatu Deel ani danych z integracji third-party podpiętych przez marketplace
Częste pytania
Czy integracja z Deel cokolwiek zmienia w samej platformie Deel?
Nie. Asystent łączy się przez klucz API z zakresem read-only i nie modyfikuje żadnych rekordów. Kontraktorzy, faktury, umowy i dokumenty zostają dokładnie takie, jak je zostawiliście. Jedyna aktywność widoczna w Deel to logi wywołań API w historii klucza.
Co jeśli kontraktor poprawi fakturę po tym, jak asystent ją już sprawdził?
Asystent sprawdza faktury ze statusem pending przy każdym uruchomieniu przeglądu. Gdy kontraktor wycofa fakturę i wystawi poprawioną, nowa trafi do kolejnego sprawdzenia z aktualną kwotą i bieżącym stanem umowy. Nie ma ryzyka zatwierdzenia poprzedniej wersji.
Jak długo trwa uruchomienie pierwszego monitora w Deel?
Punkt startowy to jednorazowy audyt konta: pobieramy aktywne kontrakty, sprawdzamy pola dat i dokumenty compliance. Zajmuje to godziny, nie tygodnie. Uruchomienie pierwszego monitora, np. alertów o wygasających umowach, wymaga wskazania osoby odbierającej alerty i krótkiego mapowania struktury waszego konta w Deel.
Czy monitory działają tylko wtedy, gdy ktoś jest zalogowany w portalu?
Nie. Sprawdzenia i alerty pracują na serwerze według harmonogramu, niezależnie od tego, czy macie otwartą przeglądarkę. Asystent co noc pobiera dane z Deel API i wysyła powiadomienia do właściwych osób bez żadnego ręcznego uruchamiania z waszej strony.
Jak zaczynamy
- 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.
- Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
- Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Pokażemy to na Waszych danych z Deel
Jedno zdanie wystarczy: czego szukacie w Deel albo co ma się dziać samo. Odpiszemy, co podłączymy i od czego zacząć.
Inne programy: kadry, płace i rekrutacja
Deel 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.