Akcja "Create Client" pozwala dodawać nowych klientów do bazy kontrahentów w inFakt. Obsługuje firmy, osoby samozatrudnione i osoby prywatne, a także zagranicznych kontrahentów. Posiada wbudowaną ochronę przed duplikatami.
Przed rozpoczęciem: Upewnij się, że masz połączone konto inFakt z Zapier. Jeśli nie, przeczytaj artykuł Jak połączyć inFakt z Zapier?
Obsługa duplikatów
Przed utworzeniem klienta możesz określić, jak integracja ma się zachować gdy klient już istnieje w bazie. To kluczowa funkcja przy importach z CRM, arkuszy czy formularzy.
| Pole | Opis | Domyślnie |
|---|---|---|
| How to handle duplicates? | create_always — zawsze twórz nowego (domyślne)skip_if_exists — pomiń jeśli istnieje (zwróci istniejącego klienta)update_if_exists — zaktualizuj dane istniejącego klienta | create_always |
| Identify duplicates by | auto — automatycznie: NIP → email → nazwa firmynip — szukaj po NIPemail — szukaj po emailucompany_name — szukaj po nazwie firmy (dokładne dopasowanie) | auto |
Przykład: Import klientów z Google Sheets → "skip_if_exists" + "nip" = nie utworzysz duplikatów, a istniejący klienci zostaną pominięci.
Obsługa nieprawidłowego NIP
| Pole | Opis | Domyślnie |
|---|---|---|
| What to do if Polish NIP is invalid? | create_without_nip — utwórz klienta bez NIP (zalecane)skip_client — pomiń tego klienta (przejdź do następnego) | create_without_nip |
Uwaga: Walidacja NIP dotyczy tylko polskich NIP-ów (10 cyfr z sumą kontrolną). Zagraniczne numery VAT (np.
DE123456789, HU8977521853) są przepuszczane bez walidacji sumy kontrolnej.Typ działalności klienta
| Pole | Wymagane | Opis |
|---|---|---|
| Business Activity Kind | Nie | private_person — osoba prywatna (wymaga imienia i nazwiska)self_employed — samozatrudniony (firma + opcjonalnie imię/nazwisko)other_business — firma/spółka (wymaga nazwy firmy)Jeśli puste — auto-detekcja: tylko nazwa firmy → other_business, tylko imię+nazwisko → private_person, oba → self_employed |
Dane klienta
| Pole | Wymagane | Opis | Przykład |
|---|---|---|---|
| First Name | Warunkowo | Wymagane dla osób prywatnych | Jan |
| Last Name | Warunkowo | Wymagane dla osób prywatnych | Kowalski |
| Company Name | Warunkowo | Wymagane dla firm | ABC Sp. z o.o. |
| NIP / VAT ID | Nie | NIP (10 cyfr) lub zagraniczny VAT ID (np. DE123456789) | 5213609120 |
| Nie | Email klienta (do wysyłki faktur) | klient@firma.pl | |
| Phone Number | Nie | Numer telefonu | +48123456789 |
| Website | Nie | Strona internetowa | https://example.com |
| Street | Nie | Ulica | Marszałkowska |
| Street Number | Nie | Numer budynku | 100 |
| Flat Number | Nie | Numer lokalu | 5 |
| City | Nie | Miasto | Warszawa |
| Postal Code | Nie | Kod pocztowy (format XX-XXX). Zagraniczne kody pocztowe w innym formacie zostaną pominięte. | 00-001 |
| Country Code | Nie | Kod kraju (2 litery). Domyślnie: PL. | PL |
| Internal Note | Nie | Notatka wewnętrzna (niewidoczna na fakturach) | Klient VIP |
| Receiver Name | Nie | Osoba odbierająca faktury | Jan Kowalski |
| Default Days to Payment | Nie | Domyślny termin płatności w dniach | 14 |
| Default Payment Method | Nie | Metoda płatności: transfer, cash, card, paypal, barter, cod | transfer |
| Default Invoice Note | Nie | Domyślna notatka na fakturach dla tego klienta | Płatność w 14 dni |
Dane zwracane po utworzeniu klienta
| Pole | Opis |
|---|---|
id | Identyfikator klienta w inFakt |
was_created | Czy klient został utworzony (true) czy znaleziony (false) |
action_taken | Podjęta akcja: created, updated, used_existing lub skipped |
business_activity_kind | Typ działalności (private_person / self_employed / other_business) |
company_name, first_name, last_name | Dane identyfikacyjne klienta |
nip, email, phone_number | Dane kontaktowe |
street, street_number, flat_number, city, postal_code, country | Adres klienta |
postal_code_skipped | Czy kod pocztowy został pominięty (zagraniczny format) |
skipped, skip_reason | Czy klient został pominięty i dlaczego (np. nieprawidłowy NIP + skip_client) |
Komentarze
Komentarze: 0
Zaloguj się, aby dodać komentarz.