Baza wiedzy Kiero OMS.

Nova Poshta łączy się z Kiero OMS za pomocą Twojego klucza API. Obecna integracja obejmuje krajową dostawę oddział–oddział w Ukrainie oraz wybór oddziału w Kiero Store.

Zanim zaczniesz

Przygotuj konto biznesowe Nova Poshta z poprawnymi danymi nadawcy i kontaktu. W OMS potrzebujesz uprawnień do zmiany ustawień. Organizacja demonstracyjna nie może podłączyć konta przewoźnika. W Store przygotuj profil rynku ukraińskiego i ceny katalogu w UAH.

Skąd wziąć klucz API

1. Otwórz panel biznesowy Nova Poshta i zaloguj się na konto używane do nadawania przesyłek.
2. Przejdź do Налаштування → Безпека (Ustawienia → Bezpieczeństwo).
3. Wybierz Створити ключ, a następnie Отримати API Key. Generowanie klucza jest bezpłatne zgodnie z oficjalną instrukcją integracji.
4. Wklej klucz w formularzu połączenia OMS. Nie udostępniaj go w wiadomościach ani na zrzutach ekranu.

To połączenie z ukraińskim API Nova Poshta, a nie konto międzynarodowego API Nova Post. Opłaty za przesyłki i warunki konta są niezależne od generowania klucza.

Podłącz konto w Kiero OMS

1. Otwórz Ustawienia → Integracje, dodaj Nova Poshta i nadaj połączeniu rozpoznawalną nazwę.
2. Wklej klucz API i pobierz listę nadawców. Wybierz nadawcę należącego do tego konta.
3. Wyszukaj i wybierz miasto nadania, a następnie pobierz i wybierz oddział według numeru lub adresu.
4. Pobierz kontakty nadawcy, wybierz kontakt i sprawdź numer telefonu.
5. Wybierz płatnika dostawy, sposób płatności i format etykiety: PDF A6 lub PDF A4.
6. Zapisz połączenie. Serwer sprawdza powiązania nadawcy, kontaktu i oddziału. Przy edycji pozostaw puste pole klucza, aby zachować zapisany klucz.

Zmiana miasta usuwa wybór oddziału. Do nadania nie można wybrać automatu paczkowego, zamkniętego oddziału ani punktu obsługującego tylko odbiór.

Użyj konta w Kiero Store

W administracji Store otwórz Dostawę (/admin/shipping) i wybierz konto Nova Poshta z OMS. Sprawdź zapisanego nadawcę; opcjonalnie wybierz innego dla tego sklepu. Potwierdź powiązanie, ustaw cenę dostawy dla klienta w UAH i opublikuj metodę. Zapisane powiązanie jest odtwarzane przy ponownym otwarciu konfiguracji.

Klucz API pozostaje w OMS. Nadawca wybrany dla Store nie zmienia wspólnego konta przewoźnika. Cena dostawy opublikowana w Store to Twój taryfikator dla klientów; wycena przewoźnika nie zastępuje jej automatycznie.

Sprawdź połączenie

Sprawdź pobieranie nadawców, kontaktów, miast i oddziałów. W Store upewnij się, że podczas zakupu można wybrać miasto i oddział oraz że widoczna jest ustawiona cena dostawy. Te kroki nie wymagają tworzenia zamówienia ani listu przewozowego.

OMS ma również formularz przesyłki z danymi odbiorcy, wagą w kg, wymiarami w cm i zadeklarowaną wartością w pełnych UAH. Kwoty PLN nie są automatycznie przeliczane. Przed utworzeniem wymagana jest wycena. Pobranie ustawia się oddzielnie od płatnika dostawy; wymaga wcześniej skonfigurowanego sposobu wypłaty w NovaPay.

Stan weryfikacji na 19 października 2026: sprawdzono odczyt słowników i wycenę bez tworzenia przesyłki. Rzeczywiste tworzenie listów przewozowych, etykiety, tracking, anulowanie i pobranie wymagają jeszcze weryfikacji u przewoźnika. Działający słownik nie potwierdza tych operacji. Dostawa pod adres, automaty paczkowe, przesyłki międzynarodowe, wiele paczek i etykiety zwrotne są poza zakresem obecnego interfejsu.

Problemy i bezpieczeństwo klucza

• Brak nadawców lub kontaktów: sprawdź konto i jego dane w panelu przewoźnika. Kontakt musi należeć do wybranego nadawcy.
• Brak oddziału: sprawdź miasto, numer oddziału i możliwość nadawania paczek.
• Chwilowy limit API: odczekaj przed kolejnym pobraniem. Limit nie oznacza utraty zapisanego klucza.
• Niepewny wynik utworzenia przesyłki: sprawdź panel przewoźnika i skontaktuj się z pomocą przed ponowieniem; kolejne nadanie może utworzyć duplikat.
• Ujawniony klucz: wymień go w panelu przewoźnika i zaktualizuj połączenie OMS. Nie umieszczaj klucza na zrzutach dla pomocy technicznej.

Zobacz też dostawę i etykiety, integracje oraz oficjalny portal API.