Udostępniliśmy właśnie nową funkcjonalność dla użytkowników Konfeo – import/eksport kodów rabatowych z/do pliku CSV. Zakładamy, że nie trzeba szczegółowo opisywać jej zasady działania, natomiast warto przybliżyć kwestię prawidłowego przygotowania samego pliku (pobierz przykładowy plik).
Struktura pliku
Plik składa się z następujących parametrów:
- code – kod rabatowy *
- value – wartość kodu *
- kind – rodzaj kodu *
- amount – limit użycia kodu
- taken – liczba wykorzystanych kodów
- valid_from – data początku obowiązywania kodu
- valid_until – data końca obowiązywania kodu
- groups – bilety/grupy, w których kod obowiązuje
Pierwsze trzy parametry (wyboldowane i oznaczone gwiazdką) muszą być uzupełnione, natomiast pozostałe – według potrzeby.
Wartości parametrów
| Parametr | Opis |
|---|---|
| code | Kod rabatowy, który stosujesz w danym wydarzeniu (ciąg znaków) |
| value | W zależności od parametru kind: prc – liczba całkowita, sum i fix – liczba może mieć wartości po przecinku |
| kind | Pole przyjmuje tylko jedną z trzech wartości: prc – rabat procentowy, sum – rabat kwotowy, fix – stała cena |
| amount | Limit wykorzystania kodów przez uczestników (liczba całkowita) |
| taken | Liczba wykorzystanych kodów (liczba całkowita, przy imporcie jest ignorowana i zawsze ustawiana na “0”) |
| valid_from | Data początku obowiązywania kodu w formacie YYYY-MM-DD HH:MM:SS ZONE, np. 2034-05-03 07:40:00 UTC (w przypadku braku określenia strefy czasowej przyjmowana jest strefa ustawiona w wydarzeniu) |
| valid_until | Data końca obowiązywania kodu, format jak wyżej. Data musi mieć wartość przyszłą |
| groups | Nazwy biletów/grup, w których kod obowiązuje. W przypadku kilku biletów nazwy należy oddzielić pionową kreską “|” , np. Wczesna rejestracja|Póżna rejestracja |
Reguły importu
Podczas importu program stara się dopasować wskazane bilety/grupy do tych istniejących w wydarzeniu. Jeśli jakaś jest niedostępna, pominie ją. Jeśli nie potrafi znaleźć odpowiednika – kod będzie działał dla wszystkich. Import sprawdza i informuje o następujących błędach:
- plik nie jest w formacie CSV
- brak wymaganej kolumny
- brak kodów do zaimportowania (tylko nagłówki w pliku)
- standardowe walidacje dla kodów rabatowych – sprawdzanie unikalności kodu, poprawnego formatu pól i wartości dat
Jeśli wystąpi którykolwiek z powyższych błędów, to żaden kod nie będzie zaimportowany. W przypadku błędów walidacji program wskaże numer wiersza gdzie znaleziono problem i informację o polu, które zawiera błąd.