Czym jest płatność w Deel
Ten poradnik patrzy na płatności dla kontraktorów od strony firmy, która płaci. W zakładce Pay w sekcji Finance Deel domyślnie zaznacza wszystkie oczekujące faktury, żeby zapłacić je naraz, a firma może odznaczyć te, których jeszcze nie chce płacić, choć według Deel w niektórych przypadkach pewne faktury mogą być obowiązkowe do zapłaty, na przykład przeterminowane. Jeśli płaci przelewem, musi podać referencję Deel płatności. Dopóki pieniądze nie dotrą, płatność ma status w trakcie przetwarzania, a gdy Deel potwierdzi ich otrzymanie, zmienia się na Paid. Tak jedna płatność na rzecz Deel reguluje naraz faktury kilku kontraktorów.
API Deel rozdziela te dwie rzeczy. GET /payments zwraca płatności na rzecz Deel z ich statusem, czyli paid albo processing, sumami, walutą i metodą płatności, ale nie zawiera już faktur, które obejmują. Do tego służy GET /payments/{payment_id}/breakdown, który według Deel podaje każdą fakturę i opłatę Deel jako osobne wiersze. Każdy wiersz zawiera między innymi identyfikator faktury (invoice_id), umowę i jej typ, imię i nazwisko osoby, kwotę z jej walutą, kwotę w walucie płatności i konto księgi głównej ustawione w Deel (general_ledger_account).
Jak konektor ją dzieli
| Co wysyła Deel | Co robi konektor w Odoo |
|---|---|
Płatności z GET /payments | Czyta je od poprzedniego przebiegu minus 7 dni; za pierwszym razem od Importuj faktury wystawione od |
Status processing | Płatność czeka w Oczekuje na Deel, a konektor nie pobiera jej rozbicia |
Status paid | Płatność przechodzi do Do zarejestrowania, a konektor czyta jej rozbicie, jeśli Deel uzna ją za zapłaconą w ciągu 7 dni od jej utworzenia |
invoice_id każdego wiersza | Faktura od dostawcy dla tej faktury Deel, która dostaje swoją płatność |
paid_at | Data płatności w Odoo |
deel_reference | Tytuł płatności; jeśli go brak, etykieta płatności |
general_ledger_account | Zapisywane w Konto księgowe Deel, ale nie decyduje, dokąd idzie płatność |
Każda faktura jest opłacana kreatorem rejestracji płatności w Odoo, w Dziennik płatności swojego podmiotu prawnego, więc płatność na rzecz Deel, która obejmuje kilka faktur, daje w Odoo jedną płatność na fakturę. Każda płatność opiewa na kwotę, która pozostaje do zapłaty na jej fakturze od dostawcy, a nie na kwotę wiersza z rozbicia: jeśli ktoś poprawił fakturę w Odoo, płaci się tyle, ile wynika z faktury. Jeśli faktura jest już w Odoo oznaczona jako opłacona, konektor nie tworzy kolejnej płatności, a wiersz już opłacony nie jest opłacany ponownie w kolejnych przebiegach. Gdy żadna faktura nie musi czekać, płatność Deel kończy w Zarejestrowany.
Warunki, wszystkie
Żeby faktura dostała swoją płatność, wszystkie te warunki muszą być spełnione jednocześnie:
- W połączeniu jest zaznaczone pole
Płatności do Deel, tak jak domyślnie. - Deel uznaje płatność za zapłaconą (
paid) w ciągu 7 dni od jej utworzenia. - Faktura Deel ma już w Odoo swoją fakturę od dostawcy.
- Ta faktura od dostawcy jest zaksięgowana. Przy
Faktury dostawcyustawionym naWstępne, do sprawdzenia, czyli ustawieniu domyślnym, ktoś musi ją zaksięgować; przyZapisane, gdy wszystko pasujeksięguje się sama, gdy wszystko pasuje. - Jej podmiot prawny ma
Dziennik płatności, dziennik bankowy lub kasowy. To pole jest puste w każdym nowym podmiocie, a bez niego faktury zostają w Odoo nieopłacone.
Jeśli fakturze brakuje któregoś z trzech ostatnich warunków, płatność zostaje w Niektóre faktury nie są gotowe z ostrzeżeniem, które to wyjaśnia, a faktury spełniające warunki i tak zostają opłacone. Synchronizacja wraca do niej co 30 minut i gdy tylko faktura zostanie zaksięgowana, a podmiot ma dziennik, jej płatność zostaje zarejestrowana. Jeśli połączenie odbiera webhooki, zdarzenia payment.statement.initiated i payment.statement.mark-paid z Deel uruchamiają wcześniej część płatności, a dane są czytane ponownie przez API.

Gdy płatność przychodzi przed swoją fakturą
Rozbicie może wskazać fakturę Deel, której Odoo jeszcze nie ma: wystawioną przed datą, od której importujesz, albo fakturę pracownika COR, o którą konektor nie pyta, gdy pobiera listę faktur. Wtedy czyta ją z Deel po jej identyfikatorze, przez GET /invoices/{id}, i od razu tworzy jej fakturę od dostawcy, według tych samych reguł co pozostałe. Jeśli ta faktura zostaje w wersji roboczej, co jest ustawieniem domyślnym, płatność czeka w Niektóre faktury nie są gotowe, aż ktoś ją zaksięguje, i zostaje zarejestrowana w następnym przebiegu.
Kontraktorzy z własnym dostawcą
W Deel pieniądze idą do Deel, ale w Odoo każda faktura jest wystawiona na dostawcę, a podmiot prawny Deel wyznacza firmę, dziennik zakupów i tego dostawcę. Kontraktor jest swoim własnym dostawcą: konektor szuka go po adresie e-mail, ale tylko wśród kontaktów w Odoo, które już są dostawcami i nie mają użytkownika; jeśli go nie znajdzie, tworzy nowego. Dopóki Deel nie ma tej osoby, na przykład dlatego, że nie przyjęła zaproszenia, jej faktury trafiają do dostawcy Deel. Faktury EOR i COR trafiają zawsze do Deel, do Dostawca Deel podmiotu prawnego lub, jeśli to pole jest puste, do dostawcy z połączenia. Ponieważ płatność jest rejestrowana na fakturze, reguluje dług wobec tego samego dostawcy, którego ma faktura.

Czego nie robi
Konektor nie używa konta księgi głównej z rozbicia: zapisuje je w Konto księgowe Deel, a płatność idzie do dziennika płatności podmiotu. Nie czyta też korekt, które API Deel podaje w innym wywołaniu (GET /billing/invoices), ani nie wraca do płatności, która ponad 7 dni po utworzeniu nadal jest w trakcie przetwarzania, bo Deel, według dokumentacji swojego API, filtruje listę płatności po dacie ich utworzenia. Jeśli Deel uzna płatność za zapłaconą później, pozostaje ona bez żadnego ostrzeżenia w stanie Oczekuje na Deel, a jej faktury zostają w Odoo nieopłacone. Webhooki uruchamiają ten sam odczyt, więc też jej nie odzyskują, a dziś nie ma żadnego przycisku, który by to zrobił. Poza tym żadna płatność nie została przetestowana na prawdziwym API Deel. Demonstracyjna organizacja Deel, na której przetestowano konektor za pośrednictwem FlexigoTech Cloud, nie miała płatności, więc tę część przetestowano na odpowiedziach przygotowanych na podstawie dokumentacji API Deel, i nikt jeszcze nie widział, jak w prawdziwym rozbiciu przychodzi wiersz opłaty Deel. Na tej organizacji przetestowano połączenie, podmioty prawne, umowę z jej osobą i dostawcą, webhooki oraz powtórne przejście bez duplikatów.
Konektor działa w Odoo 17, 18, 19 i 20 na własnym serwerze albo w Odoo.sh, nie w Odoo Online. Jak trafia każda faktura, opisuje Deel invoice w Odoo, płace Global Payroll Deel gross to net w Odoo, a porównanie z Bill Sync, synchronizacją faktur Deel, jego integracje księgowe. Konektor jest w pełni opisany na jego stronie i opublikowany w Odoo Apps.
Czytaj dalej
Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach
Źródła
- help.letsdeel.com/hc/en-gb/articles/4407737772689-Making-Invoice-Payments-With-Deel
- developer.deel.com/api/reference/endpoints/accounting/retrieve-payment-receipts-v-2027-01-
- developer.deel.com/api/reference/endpoints/accounting/retrieve-a-payment-breakdown-v-2026-
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/deel_payment.py
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/deel_account.py
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/deel_legal_entity.py
- Kod modułu: flexigo_deel_connector 20.0 (18442307): data/deel_cron.xml
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/deel_invoice.py
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/deel_contract.py
- help.letsdeel.com/hc/en-gb/articles/46057955155217-Accounting-Integrations-Overview
- apps.odoo.com/apps/modules/20.0/flexigo_deel_connector
