Ustawienia konta
W ustawieniach konta możesz zarządzać swoimi danymi osobowymi i preferencjami:
Dostępne ustawienia
- Zaktualizuj imię i numer telefonu kontaktowego
- Wybierz kraj i zaktualizuj dane specyficzne dla tego kraju
- Zmień preferowany język interfejsu
- Zmień hasło (dla kont zarejestrowanych przez email)
- Usuń konto na stałe
Profil użytkownika
Podstawowe informacje o użytkowniku przechowywane w tabeli users. Te dane są uniwersalne dla wszystkich krajów.
| Pole | Typ | Opis |
|---|---|---|
name | string(255) | Pełne imię i nazwisko |
email | string(180) | Adres email (unikalny, używany do logowania) |
phone | string(20) | Numer telefonu w formacie międzynarodowym (E.164) |
country | relation | Kraj użytkownika (określa formularz danych) |
currency | relation | Preferowana waluta do wyświetlania cen |
locale | string(5) | Język interfejsu (en, uk, ru, pl) |
notify_by_telegram | boolean | Otrzymuj powiadomienia Telegram (domyślnie włączone) |
notify_by_email | boolean | Otrzymuj powiadomienia Email (domyślnie włączone) |
API profilu
GET /api/v1/user/profile # Get current user profile PUT /api/v1/user/profile # Update profile
Przykładowa odpowiedź
{
"id": 1,
"name": "John Smith",
"email": "[email protected]",
"phone": "+48501234567",
"locale": "en",
"country": {
"code": "PL",
"name": {"en": "Poland", "uk": "Польща"},
"phone_code": "+48"
},
"currency": {
"code": "EUR",
"symbol": "€",
"name": {"en": "Euro"}
},
"roles": ["ROLE_USER"],
"is_active": true,
"notify_by_telegram": true,
"notify_by_email": true,
"created_at": "2026-01-10T09:00:00+00:00",
"updated_at": "2026-01-10T09:00:00+00:00"
}
Dane według krajów
System obsługuje różne dane dla różnych krajów. Jeśli wybierzesz kraj, dla którego dostępne są specyficzne dane, pojawi się dodatkowa sekcja do ich wypełnienia.
Architektura:
Dane są przechowywane w oddzielnych tabelach dla każdego kraju. Po wybraniu kraju w ustawieniach pojawia się odpowiedni formularz danych. Dane są całkowicie oddzielone od danych profilu użytkownika.
Ukraina (UA)
Ukraina — NIP, dane bankowe (IBAN/karta), dane FOP (jednoosobowa działalność)
| Pole | Typ | Opis |
|---|---|---|
tax_id | string(10) | NIP — 8 cyfr dla osób prawnych, 10 dla osób fizycznych |
passport | text | Dane paszportowe (seria, numer, wydany przez) |
iban | string(34) | Konto IBAN (format zależny od kraju) |
card_number | string(19) | Numer karty bankowej (16 cyfr) |
card_holder_name | string(100) | Imię posiadacza karty (jak na karcie, litery łacińskie) |
preferred_payment_method | enum | Preferowana metoda płatności: iban / card |
is_fop | boolean | Czy jest jednoosobową działalnością — ważne dla umów |
fop_registry_number | string(30) | Numer wpisu do rejestru przedsiębiorców |
fop_registration_date | date | Data rejestracji działalności |
fop_group | smallint | Grupa podatkowa (1, 2 lub 3) |
address | text | Adres rejestracji |
API danych
# Country-specific requisites endpoints (separate from profile) GET /api/v1/user/requisites/ukraine # Get requisites for Ukraine PUT /api/v1/user/requisites/ukraine # Update requisites for Ukraine
Przykładowa odpowiedź
{
"id": 1,
"tax_id": "1234567890",
"passport": "AB 123456, issued by...",
"iban": "UA213223130000026007233566001",
"card_number": "**** **** **** 1234",
"card_holder_name": "JOHN SMITH",
"preferred_payment_method": "iban",
"is_fop": true,
"fop_registry_number": "20000000000000000000",
"fop_registration_date": "2020-01-15",
"fop_group": 3,
"address": "123 Main Street, City",
"created_at": "2026-01-10T09:00:00+00:00",
"updated_at": "2026-01-10T09:00:00+00:00"
}
Swagger / OpenAPI:
Pełna dokumentacja API z przykładami zapytań i odpowiedzi:
/api/v1/doc
Inne kraje
System obsługuje dodawanie danych dla innych krajów. Każdy kraj ma własną tabelę i punkty końcowe API. Obecnie obsługiwane:
- UA — Ukraina: NIP, dane bankowe, dane jednoosobowej działalności
Więcej krajów zostanie dodanych w zależności od zapotrzebowania użytkowników.
Usunięcie konta
Możesz trwale usunąć swoje konto na stronie ustawień. W celach bezpieczeństwa na Twój adres e-mail zostanie wysłany kod potwierdzający. Ta czynność jest nieodwracalna.