Magazyn wFirma przy sprzedaży na Allegro: powiązania ofert z towarami
Dokument z zamówienia Allegro trafia do wFirma, a stanw magazynie wFirma się nie zmienia? Pokazujemy, jak powiązać oferty z towaramiz katalogu wFirma, jak opisać pakiety i zestawy oraz co zrobić, gdy NavyFlame zatrzyma dokument.
Według pomocy wFirma stan towaru w module MAGAZYN zmieniają sprzedaż i zakup z włączonym skutkiem magazynowym oraz dokumenty przyjęcia i wydania. Wydanie towaru, także na podstawie faktury albo paragonu, zmniejsza stan produktu wtedy, gdy towar był wybrany z katalogu.
NavyFlame domyślnie wystawia dokument w wFirma z pozycjami opisanymi danymi zamówienia: nazwą, ilością i ceną z Allegro, bez wskazania towaru z katalogu wFirma. Zgodnie z tą zasadą taki dokument nie zmienia stanu. Żeby pozycja wskazywała towar, każda sprzedawana oferta Allegro musi mieć przypisany towar z katalogu wFirma. Służą do tego zakładka Powiązania towarów i opcja „Zdejmuj stan z przypisanych towarów wFirma” w regułach fakturowania.
Opcja jest domyślnie wyłączona, więc istniejące automatyzacje działają jak wcześniej, dopóki jej nie włączysz. Nazwy ekranów, przycisków i komunikatów podajemy według panelu NavyFlame z 11 listopada 2026 r.
Zanim zaczniesz
W wFirma. Moduł MAGAZYN jest według pomocy wFirma dostępny w pakietach Fakturowanie + Magazyn oraz Księgowość online + Magazyn. Włączysz go w zakładce USTAWIENIA, w sekcji INNE » MAGAZYN » OGÓLNE, opcją WŁĄCZ MODUŁ MAGAZYN i przyciskiem ZAPISZ. Towary, które sprzedajesz na Allegro, muszą być w katalogu wFirma i mieć jednostkę miary.
W NavyFlame. Potrzebujesz podłączonego konta Allegro i konta wFirma oraz przepływu danych z tego konta Allegro do tego konta wFirma (Automatyzacje, zakładka Przepływy danych). Konfigurację samego fakturowania opisujemy w instrukcji automatycznych faktur z Allegro. Do zapisu powiązań potrzebujesz uprawnienia do zmiany integracji.
Kolejność. Najpierw powiąż wszystkie oferty, które mogą się sprzedać, a dopiero potem włącz zdejmowanie stanu. Po włączeniu dokument do zamówienia z choćby jedną niepowiązaną ofertą zostanie zatrzymany i nie trafi do wFirma, dopóki tego nie poprawisz.
Krok 1. Wybierz parę kont
Otwórz Fakturowanie → Powiązania towarów. W karcie „Automatyzacja Allegro do wFirma” wybierz pozycję w formacie „Allegro: nazwa konta do wFirma: nazwa konta”. Powiązania są osobne dla każdej pary kont, więc przy kilku kontach Allegro powtórz kroki dla każdego z nich.
Dwa komunikaty oznaczają, że najpierw trzeba poprawić przepływ:
„Brak aktywnej automatyzacji Allegro do wFirma”: połącz oba konta i dodaj aktywny przepływ.
„Automatyzacja wymaga ponownego zapisania”: panel wyjaśnia, że starszy przepływ nie wskazuje konkretnych kont Allegro i wFirma, i prosi, żeby go usunąć i utworzyć ponownie, wybierając oba konta. Reguły fakturowania są zapisane dla przepływu Allegro → wFirma, a powiązania dla pary kont, więc ponowne utworzenie przepływu z tymi samymi kontami ich nie usuwa.
Krok 2. Zatwierdź propozycje zgodne po SKU
Tabela „Oferty i towary” pokazuje oferty z wybranego konta Allegro: tytuł, ID oferty, SKU i link „Otwórz ofertę”. Oferta bez towaru ma oznaczenie „Niepowiązana”.
Kliknij „Zaproponuj po SKU”. Okno „Propozycje zgodne po SKU” pokaże pary, w których SKU oferty jest takie samo jak kod dokładnie jednego towaru w wFirma. Wielkość liter nie ma znaczenia. To tylko podgląd: zaznacz pary, które się zgadzają, i kliknij „Zatwierdź”; przycisk pokazuje liczbę zaznaczonych par. Brak SKU, ten sam kod przy kilku towarach albo podobna nazwa nie tworzą propozycji, więc takie oferty przypiszesz ręcznie.
Krok 3. Przypisz pozostałe oferty i ustal ilość w pakiecie
Ofertę wyszukasz w polu „Nazwa lub ID oferty Allegro”. Kliknij „Wybierz towar” i w oknie „Wybierz towar z wFirma” wyszukaj towar po nazwie. Kilka ofert może wskazywać ten sam towar, na przykład oferta pojedyncza i oferta z pakietem.
Kolumna „Jednostek w pakiecie” określa, ile jednostek towaru z wFirma oznacza sprzedaż jednej sztuki oferty. Domyślnie to 1. Wartość może być ułamkiem, na przykład 0,5 przy towarze prowadzonym w kilogramach. Zmianę zapisz przyciskiem „Zapisz ilość”.
NavyFlame przelicza ilość i cenę jednostkową tak, żeby wartość pozycji brutto się nie zmieniła. Przykład na fikcyjnych danych:
Oferta Allegro
Jednostek w pakiecie
Zamówienie
Pozycja dokumentu w wFirma
Kubek, pakiet 3 szt., 30,00 zł
3
2 szt. oferty
Kubek: 6 szt. po 10,00 zł, razem 60,00 zł
Kawa ziarnista 500 g, 40,00 zł
0,5 (towar w kg)
3 szt. oferty
Kawa ziarnista: 1,5 kg po 80,00 zł, razem 120,00 zł
Cena pakietu musi dzielić się co do grosza. Pakiet 3 szt. za 29,99 zł dałby cenę jednostkową z ułamkiem grosza, więc NavyFlame zatrzyma taki dokument, zamiast zaokrąglić kwotę albo zmienić stan o błędną ilość. Ceny 29,97 zł (3 × 9,99 zł) albo 30,00 zł przejdą.
Usunięcie powiązania przy włączonym zdejmowaniu stanu zatrzyma dokumenty z tą ofertą, dopóki nie przypiszesz towaru ponownie. Panel ostrzega o tym przed usunięciem.
Krok 4. Zestaw różnych towarów w jednej ofercie
Gdy oferta zawiera różne towary, kliknij „Powiąż zestaw”. W oknie „Składniki zestawu w wFirma” dodaj od 2 do 20 różnych towarów przyciskiem „Dodaj towar” i dla każdego podaj „Ilość w jednej ofercie” oraz „Udział w cenie brutto (%)”. Suma udziałów musi wynosić 100%. Zestaw zapisuje się dopiero po kliknięciu „Zapisz zestaw”.
Przykład na fikcyjnych danych: oferta „Zestaw prezentowy” za 100,00 zł, składnik Kubek 2 szt. z udziałem 50% i składnik Kawa ziarnista 0,5 kg z udziałem 50%. Zamówienie 3 sztuk tej oferty daje w wFirma dwie pozycje: Kubek 6 szt. po 25,00 zł i Kawa ziarnista 1,5 kg po 100,00 zł, razem 300,00 zł. Dostawa zostaje osobną pozycją ze swoją ceną.
Pozycje zestawu dostają nazwy towarów z wFirma i stawkę VAT pozycji oferty, ustaloną według reguł fakturowania. To powiązanie nie rozdziela różnych stawek VAT składników. Jeśli w regułach zaznaczysz „Rozbijaj zestawy na składniki z ich własnymi stawkami VAT”, dokument z takim zestawem zostanie zatrzymany. Sposób dokumentowania zestawów, których składniki mają różne stawki, ustal z księgową.
Zamiana zestawu na jeden towar wymaga potwierdzenia „Zastąp zestaw” i usuwa listę składników.
Krok 5. Włącz zdejmowanie stanu w regułach
Otwórz Fakturowanie → Reguły i w karcie „Automatyzacja” wybierz przepływ z Allegro do wFirma. Karta „Magazyn towarów wFirma” pojawia się tylko przy takim przepływie. Zaznacz „Zdejmuj stan z przypisanych towarów wFirma” i zapisz reguły przyciskiem „Zapisz”.
Od tej chwili każda pozycja produktu w dokumencie wskazuje przypisany towar z katalogu wFirma, z ilością przeliczoną na jednostki magazynowe i jednostką miary z kartoteki towaru, na przykład kg zamiast szt.
Pomoc wFirma opisuje opcję WYWOŁAJ SKUTEK MAGAZYNOWY przy fakturach i paragonach dodawanych w zakładce PRZYCHODY » SPRZEDAŻ. NavyFlame wystawia dokument przez API wFirma i nie ustawia osobno takiej opcji: przy pozycji przekazuje identyfikator towaru z katalogu, a zmianę stanu wykonuje wFirma. Dlatego przed włączeniem automatu dla całej sprzedaży sprawdź pierwszy dokument w zakładce MAGAZYN, jak w kroku 6.
W tej samej karcie pole „Nazwa pozycji dokumentu” ma dwie wartości: „Nazwa z kanału sprzedaży”, czyli tytuł oferty jak dotąd, oraz „Nazwa z przypisanej kartoteki wFirma”. Sam wybór nazwy nie włącza zdejmowania stanu i nie zmienia kwot. Gdy zdejmowanie stanu jest wyłączone, nazwa z kartoteki wymaga powiązania każdej sprzedawanej oferty z jednym towarem, bez zestawów.
Krok 6. Sprawdź pierwsze zamówienie
Po pierwszej sprzedaży porównaj trzy miejsca:
Kartę zamówienia w NavyFlame, sekcję Fakturowanie: status i numer dokumentu.
Dokument w wFirma: towar z katalogu przy każdej pozycji produktu, jednostkę, ilość po przeliczeniu pakietu i sumę brutto zgodną z zamówieniem.
Zakładkę MAGAZYN w wFirma: czy stan towaru spadł dokładnie o przeliczoną ilość.
Gdy wszystko się zgadza, sprawdź kolejne przypadki: pakiet, zestaw i zamówienie z kilkoma różnymi ofertami.
Gdy NavyFlame zatrzyma dokument
Zatrzymanie oznacza, że dokument nie trafia do wFirma. Stan się nie zmienia, ale dokument do tego zamówienia też nie powstaje, dopóki nie usuniesz przyczyny. Komunikat zobaczysz na karcie zamówienia, w sekcji Fakturowanie, oraz w Monitoringu, w kolejce błędów (DLQ). Po poprawce użyj przycisku „Ponów” na karcie zamówienia.
Komunikat
Przyczyna
Co zrobić
„Nie można wystawić dokumentu magazynowego wFirma” z liczbą pozycji bez zatwierdzonego powiązania
Oferta w zamówieniu nie ma powiązania, na przykład nowa oferta z nowym ID
Przypisz towar w Powiązaniach towarów i użyj „Ponów”
Komunikat zaczynający się od „Nie można bezpiecznie wystawić dokumentu magazynowego wFirma”, z kodem bundle_price_not_divisible_to_cents
Cena oferty nie dzieli się co do grosza przez liczbę jednostek w pakiecie
Zmień cenę oferty albo liczbę jednostek w pakiecie
Komunikat zaczynający się od „Nie można bezpiecznie wystawić dokumentu magazynowego wFirma”, z kodem component_price_not_divisible_to_cents
Część ceny przypadająca na składnik zestawu nie dzieli się co do grosza przez jego ilość
Zmień udziały, ilości składników albo cenę oferty
Komunikat zaczynający się od „Nie można bezpiecznie wystawić dokumentu magazynowego wFirma”, z kodem component_mapping_not_enabled_for_workflow
Zestaw towarów połączony z rozbijaniem zestawów według stawek VAT
Wyłącz rozbijanie zestawów w regułach albo powiąż ofertę z jednym towarem
„WFIRMA_GOOD_UNIT_UNRESOLVED: Nie udało się potwierdzić jednostki towaru w kartotece wFirma”
NavyFlame nie odczytał jednostki towaru z konta wFirma, które wystawia dokument
Sprawdź, czy towar istnieje na tym koncie i ma jednostkę miary. Żądanie wystawienia nie zostało wysłane
„Mapowanie magazynu wFirma jest włączone, ale nie można jednoznacznie ustalić pary kont Allegro i wFirma.”
Konto Allegro ma aktywne przepływy do więcej niż jednego konta wFirma
Zostaw jeden aktywny przepływ z tego konta Allegro do wFirma
Przed ponowieniem po błędzie, którego przyczyna nie jest oczywista, sprawdź w wFirma, czy dokument nie powstał. Szersze postępowanie opisujemy w tekście co zrobić, gdy faktura się nie wystawiła.
Czego ta funkcja nie robi
Nie przenosi stanów z wFirma na Allegro. Sprzedaż z Allegro zmniejsza stan w wFirma, ale NavyFlame nie odczytuje stanów z magazynu wFirma. Ilości na ofertach ustawiasz w Allegro albo w magazynie NavyFlame, co opisujemy w tekście o synchronizacji Allegro z magazynem.
Nie przywraca stanu przy zwrocie. Korekta, którą NavyFlame może przygotować po zwrocie, ma pozycje bez wskazania towarów z katalogu. Zwrócony towar przyjmij na stan w wFirma w sposób uzgodniony z księgową.
Nie dotyczy innych kanałów. Karta „Magazyn towarów wFirma” jest dostępna tylko dla przepływu z Allegro do wFirma.
Nie zmienia kwot dokumentu. Suma brutto pozycji odpowiada zamówieniu, a dostawa zostaje osobną pozycją. Gdy przeliczenie zmieniłoby kwotę choćby o grosz, dokument jest zatrzymywany.
Ogólny opis połączenia znajdziesz na stronie integracji Allegro z wFirma; powiązań magazynowych ta strona nie opisuje. W demo na danych przykładowych zakładka Powiązania towarów istnieje, ale nie ma tam przepływu z Allegro do wFirma, więc zobaczysz tylko komunikat o jego braku. Powiązania zapiszesz i sprawdzisz dopiero na własnych kontach.
Nie. Powiązania działają w jedną stronę: pozycja dokumentu z zamówienia Allegro wskazuje towar z katalogu wFirma, a stan zmienia wFirma. NavyFlame nie odczytuje stanów z magazynu wFirma, więc ilości na ofertach Allegro ustawiasz w Allegro albo w magazynie NavyFlame.
Przy włączonym zdejmowaniu stanu NavyFlame zatrzyma cały dokument tego zamówienia, żeby nie zmienić stanu tylko części pozycji. Komunikat zobaczysz na karcie zamówienia. Przypisz towar w zakładce Powiązania towarów i użyj przycisku „Ponów”. Nowa oferta na Allegro ma nowe ID, więc potrzebuje własnego powiązania.
Nie automatycznie. Korekta, którą NavyFlame może przygotować po zwrocie, ma pozycje bez wskazania towarów z katalogu wFirma. Przyjęcie zwróconego towaru na stan wykonaj w wFirma w sposób uzgodniony z księgową.
Tak. Przycisk „Powiąż zestaw” pozwala wskazać od 2 do 20 różnych towarów, dla każdego ilość w jednej ofercie i udział w cenie brutto. Udziały muszą sumować się do 100%. Jeśli w regułach zaznaczysz też „Rozbijaj zestawy na składniki z ich własnymi stawkami VAT”, dokument z takim zestawem zostanie zatrzymany.
Tak, na przykład oferta pojedyncza i oferta z pakietem 3 sztuk mogą wskazywać jeden towar z wFirma. Dla każdej oferty ustawiasz osobno, ile jednostek towaru oznacza jedna sprzedana sztuka oferty.
Konfiguracja krok po kroku
Dla zestawów opisanych w tym artykule mamy rozpisaną instrukcję połączenia.
Używamy plików cookies, aby zapewnić prawidłowe działanie strony, analizować ruch oraz personalizować treści. Dowiedz się więcej w naszej polityce prywatności.
Niezbędne cookies zapewniają działanie strony. Analityczne i marketingowe uruchomimy tylko za zgodą. Szczegóły.