Faktury

Integracja Fakturowni
z Medusą

Faktury VAT, proformy, paragony i korekty w Fakturowni do zamówień z Medusy, wystawiane dokładnie raz. Płatność, numer KSeF i PDF wracają do panelu, a klient pobiera dokumenty na koncie w sklepie.

Zobacz w panelu demo
Fakturownia: Strona integracji w panelu Medusy, tryb demo z danymi pokazowymi.
Strona integracji w panelu Medusy, tryb demo z danymi pokazowymi.

Co dokładnie
robi ta integracja

  • Dokument we właściwym momencie

    Faktura powstaje po pobraniu płatności albo po złożeniu zamówienia. Możesz też najpierw wystawić proformę, a fakturę VAT po wysyłce.

  • Paragony dla konsumentów

    Kupujący bez NIP dostaje paragon zamiast faktury, a firma fakturę na dane z NIP podanego przy zamówieniu.

  • Korekty z akceptacją

    Zwrot, refundacja, edycja albo anulowanie po wystawieniu dają plan korekty z pozycjami przed i po. Człowiek go zatwierdza, a korekta wystawia się raz.

  • KSeF w szczegółach

    Numer KSeF, status, błędy, UPO i XML przy każdym dokumencie, z historią i ponowną wysyłką.

  • E-maile i przypomnienia

    Dokument z PDF do kupującego, przypomnienia o nieopłaconych fakturach i miesięczne podsumowanie.

  • Dokumenty na koncie klienta

    Zalogowany klient pobiera faktury do swoich zamówień prosto w sklepie.

Jak pilnuje
Twoich danych

  • Zero duplikatów

    Jeden wiersz na zamówienie i rodzaj dokumentu, unikalny w bazie. Przed każdym wystawieniem szukamy dokumentu w Fakturowni po numerze zamówienia.

  • Jeden strzał, nigdy na ślepo

    Żądanie utworzenia faktury nie jest powtarzane. Zgubiona odpowiedź oznacza sprawdzenie w Fakturowni, a nie drugą fakturę.

  • Nic o kupującym w Medusie

    Wtyczka trzyma rodzaj, numer, kwoty i statusy dokumentu. Dane kupującego składa z zamówienia w chwili wysyłki, a adresy w historii maili są maskowane.

Instalacja
w trzech krokach

Pełna lista opcji, zdarzeń i tras API jest w README paczki na GitHubie.

Wklej do Claude Code, Cursora albo innego asystenta AI w swoim projekcie Medusy: zainstaluje i skonfiguruje integrację, z zapisami wyłączonymi.

  1. 1
    Zainstaluj paczkę z npm.
    npm install @koda-plus/medusa-plugin-fakturownia
  2. 2
    Dopisz wtyczkę do medusa-config.ts.
                            plugins: [
      {
        resolve: "@koda-plus/medusa-plugin-fakturownia",
        options: {
          apiToken: process.env.FAKTUROWNIA_API_TOKEN,
          account: process.env.FAKTUROWNIA_ACCOUNT, // "mojafirma"
          issuePlace: "Warszawa",
          // documentFlow: "proforma_then_vat",
          // corrections: "plan",
        },
      },
    ]
                          
  3. 3
    Uruchom migracje i otwórz integrację w panelu Medusy.
    npx medusa db:migrate

Pracuje u naszych klientów

Zobacz realizacje
  • biolcheckwkrótce
Bezpłatne, 15-minutowe spotkanie

Opowiedz nam o swoim projekcie,
resztę dopasujemy pod Ciebie

15 minut rozmowy wystarczy, abyśmy wiedzieli, czy pasujemy do Twojego projektu.
Zaczynamy od Twoich potrzeb, nie od gotowego rozwiązania.

Sprawdź nasze demo

Skontaktuj się z nami

Remigiusz w granatowej koszuli i okularach
Korzystam z iMessage Korzystam z WhatsApp
Adrian w szarym golfie i okularach
Korzystam z iMessage Korzystam z WhatsApp