Fakturowanie — faktury do zamówień z Fakturowni

Cornvilla nie wystawia faktur sama — robi to Twój program do faktur, z Twoją numeracją, danymi sprzedawcy i KSeF. Cornvilla przekazuje mu dane zamówienia we właściwym momencie, odbiera numer i PDF, pokazuje je przy zamówieniu i pozwala wysłać fakturę klientowi. Na start obsługujemy Fakturownię; kolejne programy (inFakt, iFirma, wFirma) dojdą.

Jak to działa

1. Zamówienie przychodzi ze sklepu razem z danymi do faktury (firma, NIP, adres, „chcę fakturę”), jeśli sklep je ma.
2. W wybranym przez Ciebie momencie (np. po opłaceniu; na start — tylko ręcznie) Cornvilla zleca wystawienie faktury w Fakturowni. Dzieje się to w tle — kompletacja i pakowanie na nic nie czekają.
3. Przy zamówieniu pojawia się numer faktury i link do PDF. Fakturę możesz wysłać klientowi e-mailem z Twojego konta w Fakturowni.
4. Jeśli coś się nie uda (np. zły kod API), zamówienie dostaje status Błąd faktury z opisem — poprawiasz i klikasz Ponów.

inFakt zamiast Fakturowni

Cornvilla działa też z inFaktem — wszystko poniżej (kiedy, komu, druk, dostarczenie) jest takie samo. Różni się tylko podłączenie:

1. W inFakcie: Ustawienia → API → Dodaj klucz, z uprawnieniami do odczytu i zapisu faktur.
2. W Cornvilla: Ustawienia → Fakturowanie → wybierz inFakt, wklej klucz, w polu „Konto” zostaw Moje konto inFakt i kliknij Testuj połączenie.

Chcesz najpierw spróbować bez prawdziwych faktur? Załóż darmowe konto testowe na konto.sandbox-infakt.pl, wygeneruj tam klucz i wybierz „Konto testowe (sandbox)” — faktury z niego nie trafiają do księgowości. Darmowe konto inFakt wysyła do 20 e-maili z fakturą dziennie.

iFirma zamiast Fakturowni

Z iFirma jest tak samo — różni się tylko podłączenie:

1. W iFirma: Rozszerzenia i integracje → API — wygeneruj klucz „faktura” (iFirma pozwala na to na opłaconym koncie albo połączonym z KSeF). Użytkownik, którego login podasz, musi mieć uprawnienia „super konta” i zaakceptować regulamin API.
2. W Cornvilla: Ustawienia → Fakturowanie → wybierz iFirma, wpisz login (e-mail) i klucz „faktura”, kliknij Testuj połączenie.

Gdy iFirma odrzuci fakturę z powodu daty spoza bieżącego miesiąca księgowego, ustaw w iFirma bieżący miesiąc i kliknij Ponów przy zamówieniu.

Krok 1. Konto w Fakturowni

Jeśli nie masz jeszcze konta:

1. Wejdź na app.fakturownia.pl/signup. Podajesz e-mail, hasło i nazwę konta — ona staje się adresem twojanazwa.fakturownia.pl (ten prefiks wpiszesz w Cornvilla).
2. Przez 30 dni masz pełny plan za darmo, potem konto przechodzi na darmowy plan Micro (3 faktury sprzedażowe miesięcznie) albo wybierasz płatny. Dostęp do API jest w każdym planie.
3. Ustawienia → Dane firmy — uzupełnij sprzedawcę (nazwa, NIP, adres, konto bankowe). Faktury z Cornvilla biorą sprzedawcę z tych ustawień.
4. Ustawienia → Ustawienia konta → Integracja → Kod autoryzacyjny API — skopiuj kod. Działa jak hasło: nie wysyłaj go mailem, wpisz tylko w Cornvilla.

Jeśli nazwy w panelu Fakturowni różnią się od tej instrukcji, napisz do nas — podpowiemy.

Krok 2. Ustawienia w Cornvilla

Ustawienia → Fakturowanie:

1. Dostawca: Fakturownia. Wpisz prefiks adresu konta (sam początek, np. mojafirma) i kod autoryzacyjny API → Testuj połączenie → Zapisz. Po zapisaniu kod widać jako gwiazdki — to maska, nic nie zostało ucięte.
2. Kiedy wystawiać — po podłączeniu dostawcy nic nie dzieje się samo, dopóki tego nie wybierzesz:
   • tylko ręcznie (domyślnie) — przyciskiem Wystaw fakturę w zamówieniu;
   • po opłaceniu zamówienia — zamówienia za pobraniem dostają fakturę przy spakowaniu;
   • przy spakowaniu — gdy faktura ma trafić do paczki;
   • przy wydaniu kurierowi.
3. Komu: każdemu klientowi albo tylko gdy klient podał NIP lub poprosił o fakturę (reszta bez dokumentu — np. gdy paragony robi sklep).
4. Druk i Dostarczenie — patrz niżej.
5. KSeF (tylko Fakturownia): zaznacz „Wysyłaj faktury do KSeF od razu po wystawieniu”, jeśli masz połączony KSeF w Fakturowni. Faktura liczy się wtedy jako gotowa dopiero z numerem KSeF — druk i e-mail czekają na niego.

Krok 3. Włącz fakturowanie dla źródła zamówień

Fakturowanie włączasz osobno dla każdego sklepu / marketplace'u: Import danych → źródło zamówień → Opcje → Fakturowanie → „Fakturuj zamówienia z tego źródła”. Dzięki temu możesz fakturować np. sklep, a Allegro zostawić (jeśli fakturujesz je gdzie indziej).

Włączenie działa też wstecz: zamówienia tego źródła, które już spełniają warunek (np. są opłacone), dostaną fakturę przy najbliższym przebiegu.

Dane nabywcy

Faktura idzie na dane, które klient podał w sklepie przy zamówieniu: firma, NIP, adres do faktury, e-mail. Cornvilla pobiera je ze sklepu razem z zamówieniem (BaseLinker, Shoper, WooCommerce, PrestaShop, IdoSell, Shopify, Allegro, Erli, Ecwid, Sky-Shop, SOTE, shopGold, DeluxeCart, eBay, Empik — tam, gdzie sklep takie dane ma). Gdy sklep nie podaje osobnych danych do faktury, faktura idzie na odbiorcę przesyłki.

Przy ustawieniu „tylko gdy klient podał NIP lub poprosił o fakturę” sam NIP wystarczy, żeby faktura powstała.

Gdzie są faktury i dane osobowe. Archiwum faktur prowadzi Twój program do faktur (Fakturownia) — tam masz je przez wymagane prawem lata i stamtąd eksportujesz dla księgowości. Cornvilla trzyma przy zamówieniu numer faktury oraz, przez czas realizacji, kopię PDF do druku i podglądu, żeby chwilowa awaria programu do faktur nie zatrzymała pakowania. Kopia znika po liczbie dni od wysyłki, którą ustawisz w Ustawienia → Fakturowanie → Kopia PDF w Cornvilla (domyślnie 3); potem PDF w panelu otwiera się prosto z programu do faktur. Dane do faktury (firma, NIP, adres) znikają razem z danymi odbiorcy po terminie przechowywania (Ustawienia → Dane firmy → Ochrona danych osobowych); numer faktury zostaje. PDF w panelu otwiera się tylko po zalogowaniu.

shopGold: dane do faktury przychodzą z łącznika pobranego po 27.10.2026. Jeśli wgrałeś plik wcześniej, pobierz go ponownie (Import danych → połączenie shopGold → Pobierz plik łącznika) i podmień na serwerze.

Faktura przy zamówieniu

Zamówienia → kolumna Faktura: numer (gdy gotowa), „Wystawianie…”, „Ponawiamy…” (ostatnia próba się nie udała, Cornvilla spróbuje znowu za kilkanaście minut — po najechaniu zobaczysz dlaczego), „Błąd faktury” albo „Nie wystawiono” (przerwane). Po najechaniu — link do PDF albo opis błędu. W karcie zamówienia (wiersz Faktura):

• Wystaw fakturę — ręcznie, niezależnie od ustawień „kiedy” (także dla zamówień ręcznych, bez źródła).
• PDF — podgląd faktury.
• Wyślij e-mailem — otwiera okno z adresem; puste pole = e-mail nabywcy z zamówienia (albo odbiorcy, gdy nabywca nie podał). Fakturownia wysyła fakturę z Twojego konta.
• Anuluj wystawianie — przy „Wystawianie…” / „Ponawiamy…”: przerywa, dopóki program do faktur nic nie dostał (np. gdy chcesz najpierw poprawić dane). Zamówienie dostaje „Nie wystawiono”, a Wystaw fakturę wznawia. Faktury, która już powstała w programie do faktur, Cornvilla nie cofnie — usuń ją tam.
• Przy błędzie: opis błędu, Ponów (po poprawieniu ustawień) i Oznacz ręcznie (faktura wystawiona poza Cornvilla — wklej link do PDF i numer).

Cornvilla nie wystawi drugiej faktury do tego samego zamówienia: Fakturownia pilnuje numeru zamówienia (oid), a przy ponownej próbie Cornvilla odnajduje fakturę, która już jest.

Druk i dostarczenie

• Druk: przycisk Drukuj fakturę w zamówieniu (przez Cornvilla Agent albo przeglądarkę) jest zawsze. Automatycznie na stanowisku pakowania: w Ustawienia → Fakturowanie → Druk wybierz „Automatycznie na stanowisku pakowania” i zaznacz Faktura w druku automatycznym stanowiska (Konfiguracja magazynu → Stanowiska). Po dotknięciu Spakowane gotowa faktura wychodzi na drukarkę dokumentów stanowiska razem z etykietą; faktura wystawiana dopiero przy spakowaniu (albo czekająca na numer KSeF) drukuje się sama zaraz po wystawieniu. Ekran „Spakowane” mówi pakowaczowi, co się dzieje z fakturą; gdy druk nie poszedł (np. brak drukarki dokumentów dla stanowiska), pokazuje powód, a fakturę drukujesz z panelu. Gdy faktura jest gotowa już przed pakowaniem (np. wystawiana „po opłaceniu”), na terminalu pod etykietą i zamówieniem jest przycisk Drukuj fakturę, także do ponownego wydruku; działa niezależnie od ustawienia „Druk”.
• Dostarczenie: domyślnie nie wysyłaj automatycznie — fakturę wysyłasz przyciskiem Wyślij e-mailem w zamówieniu (z konta w Fakturowni). Po włączeniu wysyłaj automatycznie Cornvilla sama dostarcza fakturę, a kanał zależy od źródła zamówienia — opis niżej.

Dostarczenie klientowi

Marketplace'y oczekują faktury przez swoje API i same powiadamiają kupującego; zwykłe sklepy takiej funkcji nie mają. Dlatego kanał dostarczenia wynika ze źródła zamówienia, nie z jednego ustawienia:

Skąd zamówienie	Co się dzieje
Allegro	Faktura trafia do zamówienia na Allegro — kupujący widzi ją w „Moich zakupach”, Allegro wysyła mu powiadomienie.
BaseLinker	Faktura trafia do zamówienia w BaseLinkerze (w wybranej serii numeracji; numer i PDF z Fakturowni nadpisują wpis), a stamtąd tam, gdzie BaseLinker ją przekazuje.
Sklep bez takiej funkcji (Shoper, WooCommerce, PrestaShop, Shopify, IdoSell…) i zamówienia ręczne	E-mail z Twojego konta w Fakturowni na adres do faktury (a gdy go nie ma — adres odbiorcy).

Jak włączyć:

1. Ustawienia → Fakturowanie → Dostarczenie klientowi → „Wysyłaj automatycznie”. Wybierz kiedy: przy wydaniu kurierowi (zalecane — klient dostaje fakturę razem z wysyłką, a zamówienie anulowane wcześniej nie wymaga korekty) albo gdy faktura jest gotowa.
2. Pod spodem zobaczysz tabelę źródło → kanał. Zmienisz go w opcjach źródła (Import danych → źródło → Opcje → Fakturowanie → Dostarczenie faktury klientowi): automatycznie / odeślij do zamówienia / e-mail / nie wysyłaj z tego źródła. Przy odesłaniu możesz dodatkowo zaznaczyć kopię e-mailem (klient dostanie fakturę dwa razy — domyślnie wyłączone).
3. BaseLinker potrzebuje serii numeracji — wybierz ją z listy w opcjach źródła (pobiera się z Twojego konta BaseLinker).

Co widzisz przy zamówieniu (kolumna Faktura, pod numerem, i karta zamówienia):

• Odesłana — do zamówienia w sklepie / marketplace'u (w dymku: dokąd i kiedy),
• Wysłana — e-mailem z Fakturowni (adres w dymku, zamaskowany),
• Do wysłania — czeka na moment (np. wydanie kurierowi) albo na kolejną próbę,
• Błąd wysyłki — po wyczerpaniu prób; powód w dymku i przycisk Wyślij ponownie na karcie zamówienia,
• Ręcznie — nie ma kanału automatycznego (np. zamówienie bez adresu e-mail) — użyj Wyślij e-mailem.

Każda faktura jest dostarczana raz. Gdy odesłanie do marketplace'u się nie uda, a zamówienie ma e-mail, Cornvilla wysyła e-mail zamiast ponawiać w nieskończoność. Ręczne „Wyślij e-mailem” też zapisuje się jako „Wysłana”.

Zgoda na e-fakturę. Faktura elektroniczna wymaga akceptacji odbiorcy. W sklepie załatwia to regulamin zaakceptowany przy zakupie, na Allegro — regulamin Allegro. Sprawdź, czy Twój regulamin sklepu to przewiduje; Cornvilla nie zbiera osobnej zgody.

Co trafia na fakturę

• pozycje zamówienia: nazwa i SKU produktu, ilość, cena brutto ze sklepu, stawka VAT (ze sklepu, a gdy jej nie podaje — stawka produktu z Ustawienia → Ceny i VAT);
• dostawa jako osobna pozycja — różnica między wartością zamówienia a sumą pozycji;
• forma płatności ze sklepu; zamówienie opłacone = faktura opłacona (data dzisiejsza), pobranie = termin z ustawień Fakturowni w Cornvilla;
• data sprzedaży = data złożenia zamówienia, data wystawienia = dziś;
• w opisie: numer zamówienia w sklepie i nazwa źródła.

Najczęstsze problemy

„Fakturownia odrzuciła kod autoryzacyjny API”. Sprawdź prefiks konta (sam początek adresu, bez .fakturownia.pl) i skopiuj kod jeszcze raz — w całości.

„Zamówienie nie ma danych nabywcy”. Zamówienie nie ma ani danych do faktury, ani odbiorcy przesyłki (np. dane osobowe już usunięte po terminie). Wystaw fakturę w Fakturowni ręcznie i użyj Oznacz ręcznie.

Błąd „Nie ma stawki VAT”. Produkt ma stawkę spoza listy w Ustawienia → Ceny i VAT → Stawki VAT — dodaj ją.

„Ponawiamy…” z opisem „brakuje danych Twojej firmy jako sprzedawcy”. Nowe konto w Fakturowni nie ma jeszcze danych firmy — uzupełnij w Fakturowni Ustawienia → Dane firmy (nazwa, NIP, adres). Cornvilla sama ponowi próbę, albo kliknij Ponów.

„Ponawiamy…” z opisem o opłaceniu planu. Darmowy plan Fakturowni ma limit dokumentów w miesiącu, a nieopłacony plan blokuje wystawianie. Opłać plan w Fakturowni; faktury, które czekały, wystawią się same.

Faktura „Wystawianie…” przez długi czas przy włączonym KSeF. Cornvilla czeka na numer KSeF. Sprawdź w Fakturowni status wysyłki do KSeF (Ustawienia → KSeF) — gdy KSeF ma awarię, faktura dostanie numer później.