---
title: "Import klientów"
description: "Zaimportuj hurtowo istniejącą listę klientów z arkusza Excel lub CSV przy przejściu do Requiply z innego systemu."
canonical_url: "https://requiply.com/docs/pl/guides/clients/import"
---
# Import klientów

> Zaimportuj hurtowo istniejącą listę klientów z arkusza Excel lub CSV przy przejściu do Requiply z innego systemu.

Na stronie **Hurtowy import klientów** wczytujesz do Requiply listę klientów z arkusza kalkulacyjnego. Służy do szybkiego przeniesienia istniejących danych klientów zamiast tworzenia każdego klienta ręcznie i zasila bezpośrednio tę samą listę klientów, z której korzystają rezerwacje, faktury i rabaty.

Stronę znajdziesz w **Klienci → Import** (można też na nią przejść przyciskiem **Importuj klientów** na stronie [Zarządzaj klientami](https://requiply.com/docs/pl/guides/clients/manage)).

![Strona Hurtowy import klientów](https://requiply.com/docs/assets/clients/import/image.png)

## Dlaczego ta strona jest ważna

Większość organizacji ma już listę klientów w innym systemie: w CRM, w arkuszu kalkulacyjnym lub w wyeksportowanym pliku kontaktów. Ta strona pozwala wczytać te dane do Requiply w jednym kroku, bez przepisywania każdego kontaktu.

Po imporcie ci klienci stają się takimi samymi kartami jak wszystkie inne:

- **Rezerwacje**: zaimportowanych klientów można od razu wybierać przy tworzeniu rezerwacji.
- **Faktury i płatności**: rozliczenia korzystają z zaimportowanego imienia i nazwiska, telefonu i e-maila.
- **Rabaty**: rabaty można przypisać zaimportowanym klientom pojedynczo lub hurtowo na stronie [Zarządzaj klientami](https://requiply.com/docs/pl/guides/clients/manage).
- **Pola dodatkowe**: zaimportowani klienci mają tę samą strukturę pól dodatkowych co klienci utworzeni ręcznie (wartości pól dodatkowych nie są częścią pliku importu).

Czysty import pierwszego dnia oszczędza dużo porządków później.

## Co widać na stronie

Strona jest podzielona na dwie kolumny.

**Lewa kolumna (przesyłanie i przyciski):**

- Tytuł strony **Hurtowy import klientów**.
- Przycisk tekstowy **Pobierz szablon**, który otwiera okno z opisem szablonu (zobacz [Pobieranie szablonu](#pobieranie-szablonu) poniżej).
- Rozbudowane pole przesyłania pliku z napisem **Prześlij plik .xlsx** i podpowiedzią w pustym stanie **Przeciągnij i upuść lub kliknij, aby wybrać plik (.xlsx)**.

  - Akceptuje tylko pliki `.xlsx` i `.xls`.
  - Maksymalny rozmiar pliku to **5 MB**.
  - Jeden plik naraz. Po wybraniu pliku przycisk wyboru jest nieaktywny, dopóki plik nie zostanie usunięty.
- Wybrany plik jest widoczny jako wiersz z ikoną Excela, nazwą pliku, sformatowanym rozmiarem i czerwonym przyciskiem usuwania.
- Jeśli plik ma problemy, pod polem przesyłania pojawia się lista błędów walidacji. Przy wielu błędach lista się przewija.
- Przycisk **Rozpocznij import** na dole. Jest nieaktywny, dopóki nie zostanie odczytany co najmniej jeden poprawny wiersz, i nie działa w trakcie trwającego importu.

**Prawa kolumna (podgląd):**

- Nagłówek **Podgląd**.
- Gdy poprawne wiersze zostały odczytane: karta ze znacznikiem **Wyświetlane wiersze: {shown} z {total}** i małą tabelą z kolumnami **Imię**, **Nazwisko**, **Telefon** i **E-mail**. Podgląd pokazuje najwyżej 10 pierwszych wierszy.
- Gdy żaden plik nie został jeszcze odczytany: wyśrodkowany tekst zastępczy z ikoną tabeli i komunikatem **Prześlij plik, aby zobaczyć podgląd**.

**Okno potwierdzenia:**

Po kliknięciu **Rozpocznij import** otwiera się okno z:

- tytułem **Potwierdź import**,
- komunikatem **Gotowe do importu: {count} klientów** i podpowiedzią **Import przebiega partiami i może chwilę potrwać.**,
- w trakcie importu: paskiem postępu z wartością procentową i napisem **Importujemy klientów**,
- przyciskami w stopce: **Anuluj** (nieaktywny w trakcie importu) i **Rozpocznij import**.

<warning>

**Uwaga:** W trakcie importu okna nie można zamknąć: zamknięcie, klawisz Escape i kliknięcie poza oknem są zablokowane do zakończenia importu.

</warning>

## Pusty stan

Ta strona nie ma pustego stanu w zwykłym sensie: sama jest punktem wejścia do wczytania danych. Dopóki plik nie zostanie przesłany:

- Lista błędów walidacji jest ukryta.
- Obszar podglądu pokazuje opisany wyżej tekst zastępczy.
- Przycisk **Rozpocznij import** jest nieaktywny.

## Główne działania

### Pobieranie szablonu

Kliknij **Pobierz szablon**, aby otworzyć okno **Pobierz szablon importu**. Okno wyjaśnia, że:

- szablon zawiera przykładowy wiersz klienta, na którym można się wzorować,
- zawiera arkusz pomocniczy z ograniczeniami i dozwolonymi wartościami dla każdej kolumny,
- do wypełnienia szablonu lub przekształcenia istniejących danych do jego formatu można użyć narzędzi AI.

Powiadomienie o powodzeniu potwierdza pobranie; jeśli pobranie się nie uda, pojawia się powiadomienie o błędzie.

<note>

**Wskazówka:** Zalecamy zacząć od szablonu, ponieważ zawarte w nim nagłówki kolumn są dokładnie tym, czego oczekuje importer.

</note>

### Przesyłanie pliku

Przeciągnij plik do obszaru przesyłania lub kliknij, aby go wybrać. Strona akceptuje pliki `.xlsx` i `.xls` do 5 MB. Zaraz po wybraniu plik jest odczytywany w przeglądarce i:

- Poprawne wiersze trafiają do podglądu po prawej.
- Niepoprawne wiersze są zgłaszane na liście błędów walidacji po lewej.
- Przycisk **Rozpocznij import** staje się aktywny, gdy jest co najmniej jeden poprawny wiersz.

Aby zmienić plik, kliknij czerwony **×** obok wybranego pliku (lub użyj przycisku usuwania w polu przesyłania). Usuwa to plik, odczytane wiersze i wszystkie błędy walidacji.

### Uruchamianie importu

Kliknij **Rozpocznij import**. Otworzy się okno potwierdzenia z liczbą wierszy. Kliknij w nim **Rozpocznij import**, aby zacząć.

Import wysyła wiersze na serwer **partiami**:

- Pierwsze trzy partie są celowo małe (10, 15 i 25 wierszy), żeby wczesne błędy szybko wyszły na jaw.
- Potem wiersze są wysyłane w partiach po **50**, aż do końca pliku.
- Pasek postępu aktualizuje się po każdej partii na podstawie liczby przetworzonych wierszy.

Po zakończeniu importu:

- Jeśli co najmniej jeden wiersz się powiódł: pojawia się powiadomienie **Gotowe** (lub **Uwaga**, gdy część wierszy się nie powiodła), lista klientów w pamięci zostaje odświeżona, okno się zamyka i następuje przejście na stronę [Zarządzaj klientami](https://requiply.com/docs/pl/guides/clients/manage).
- Jeśli nie powiódł się żaden wiersz: pojawia się powiadomienie **Błąd** z komunikatem **Import nie powiódł się**, a okno się zamyka.

## Formularze i pola

Każdy wiersz arkusza odpowiada nowemu klientowi. Nagłówki są dopasowywane bez względu na wielkość liter, z pominięciem podkreśleń i myślników. Każda kolumna akceptuje kilka wariantów nagłówka.

<table>
<thead>
  <tr>
    <th>
      Kolumna
    </th>
    
    <th>
      Wymagana
    </th>
    
    <th>
      Akceptowane nagłówki
    </th>
    
    <th>
      Walidacja
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Imię
      </strong>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      <code>
        first name
      </code>
      
      , <code>
        firstname
      </code>
      
      , <code>
        first_name
      </code>
      
      , <code>
        name
      </code>
    </td>
    
    <td>
      Musi być wypełnione; maks. <strong>
        25
      </strong>
      
       znaków.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Nazwisko
      </strong>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      <code>
        last name
      </code>
      
      , <code>
        lastname
      </code>
      
      , <code>
        last_name
      </code>
    </td>
    
    <td>
      Musi być wypełnione; maks. <strong>
        25
      </strong>
      
       znaków.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Telefon
      </strong>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      <code>
        phone
      </code>
      
      , <code>
        phone number
      </code>
      
      , <code>
        phone_number
      </code>
    </td>
    
    <td>
      Musi być pełnym numerem międzynarodowym: <code>
        +
      </code>
      
      , a po nim kod kraju i łącznie 7–15 cyfr, np. <code>
        +380951234567
      </code>
      
      . Musi być unikalny w pliku i nie może być już używany przez istniejącego klienta.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        E-mail
      </strong>
    </td>
    
    <td>
      Nie
    </td>
    
    <td>
      <code>
        email
      </code>
      
      , <code>
        e-mail
      </code>
    </td>
    
    <td>
      Jeśli jest podany, musi wyglądać jak poprawny adres e-mail, być unikalny w pliku i nie może już należeć do istniejącego klienta.
    </td>
  </tr>
</tbody>
</table>

Dodatkowe reguły sprawdzane przed uruchomieniem importu:

- Plik musi zawierać arkusz z co najmniej jednym wierszem danych.
- Plik może zawierać najwyżej **1000 wierszy**. Większe pliki są odrzucane z błędem **Dozwolone jest maksymalnie 1000 wierszy**.
- Powtarzające się numery telefonów w tym samym pliku są oznaczane przy każdym wierszu, tak samo jak powtarzające się e-maile.
- Wiersze, których telefon lub e-mail należy już do klienta w Twojej organizacji, są odrzucane z błędem **Telefon już istnieje** lub **E-mail już istnieje**.

Każdy niepoprawny wiersz jest zgłaszany jako **Wiersz {n}: {reason}** (numery wierszy zaczynają się od 2, ponieważ pierwszy wiersz to nagłówek). Niepoprawne wiersze są pomijane: import jest kontynuowany z wierszami, które przeszły walidację.

## Jak ta strona łączy się z resztą Requiply

<table>
<thead>
  <tr>
    <th>
      Funkcja
    </th>
    
    <th>
      Jak ta strona na nią wpływa
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Zarządzaj klientami
      </strong>
    </td>
    
    <td>
      Po udanym imporcie następuje automatyczne przejście na tę stronę, a nowi klienci pojawiają się w tabeli.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Rezerwacje
      </strong>
    </td>
    
    <td>
      Zaimportowanych klientów można od razu wybierać przy tworzeniu rezerwacji.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Faktury i płatności
      </strong>
    </td>
    
    <td>
      Dokumenty rozliczeniowe będą zawierać zaimportowane imię i nazwisko, telefon i e-mail.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Rabaty
      </strong>
    </td>
    
    <td>
      Zaimportowanych klientów można hurtowo zaznaczyć na stronie <a href="https://requiply.com/docs/pl/guides/clients/manage">
        Zarządzaj klientami
      </a>
      
      , aby przypisać im rabat.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Pola dodatkowe
      </strong>
    </td>
    
    <td>
      Wartości pól dodatkowych nie są częścią pliku importu; można je uzupełnić później na stronie <a href="https://requiply.com/docs/pl/guides/clients/add-or-edit">
        Dodawanie i edycja klienta
      </a>
      
      .
    </td>
  </tr>
</tbody>
</table>

## Typowe sytuacje

### Przejście z poprzedniego systemu

Użytkownik pobiera szablon, kopiuje do niego istniejącą listę klientów, usuwa wiersze przekraczające limity i przesyła plik. Pasek postępu pokazuje kolejne partie importu; po zakończeniu użytkownik trafia na stronę [Zarządzaj klientami](https://requiply.com/docs/pl/guides/clients/manage), gdzie widać nowe wiersze.

### Import częściowo uporządkowanej listy

Użytkownik przesyła plik, w którym w części wierszy brakuje numerów telefonów lub e-maile są nieprawidłowe. Lista walidacji po lewej oznacza te konkretne wiersze numerami; podgląd po prawej pokazuje tylko wiersze, które przeszły walidację. Użytkownik od razu importuje poprawne wiersze, poprawia odrzucone w pliku źródłowym i importuje je ponownie.

### Dzielenie dużej listy

Organizacja ma do zaimportowania ponad 1000 klientów. Użytkownik widzi błąd **Dozwolone jest maksymalnie 1000 wierszy**, dzieli plik na części po mniej niż 1000 wierszy i uruchamia kolejne importy.

## Wskazówki i ostrzeżenia

<note>

**Wskazówka:** Zawsze zaczynaj od pobranego szablonu: jego nagłówki odpowiadają wariantom, których oczekuje parser, więc unikniesz błędów „Brak imienia” lub „Brak telefonu” wynikających z niedopasowanych nagłówków.

</note>

<note>

**Wskazówka:** Imię i nazwisko mogą mieć najwyżej po 25 znaków. Skróć długie imiona i nazwiska w pliku źródłowym przed przesłaniem.

</note>

<warning>

**Uwaga:** Numery telefonów muszą zawierać kod kraju i zaczynać się od `+`, np. `+380951234567`. Numer w formacie krajowym jest odrzucany z komunikatem *„Telefon musi zawierać kod kraju, np. +48512345678”*, a spacje, myślniki i nawiasy też nie przechodzą walidacji. Przed importem przeformatuj kolumnę w arkuszu.

</warning>

<warning>

**Uwaga:** Numery telefonów i e-maile muszą być unikalne zarówno w pliku, jak i wśród istniejących klientów. Jeśli ten sam klient występuje dwa razy, drugi wiersz zostanie odrzucony.

</warning>

<warning>

**Uwaga:** Po kliknięciu **Rozpocznij import** w oknie potwierdzenia nie można go zamknąć, dopóki import się nie zakończy. Nie przechodź na inne strony w trakcie importu.

</warning>


## Sitemap

See the full [sitemap](https://requiply.com/docs/sitemap.md) for all pages.
