Dodatkowe dane KSeF przez metadane Stripe

S2K automatycznie pobiera dane z Twoich faktur Stripe i wysyła je do KSeF. Część pól KSeF, takich jak kod GTU, PKWiU czy dane kontaktowe nabywcy nie ma bezpośredniego odpowiednika w Stripe, ale możesz je ustawiać przez metadane (metadata) w objektach customer i product.

Jak działają metadane Stripe

Metadane to pary klucz-wartość, które możesz dodawać do niemal każdego obiektu w Stripe: klienta, produktu, faktury. S2K odczytuje wybrane klucze i przekazuje je do odpowiednich pól w strukturze KSeF. Klucze mają format s2k_{pole}, np. s2k_gtu lub s2k_contact_email. Jeśli klucz nie istnieje w metadanych, s2k po prostu pomija to pole.

---

Dane nabywcy (Customer metadata)

Poniższe pola ustawiasz na obiekcie Customer w Stripe (Customers → wybrany klient → Metadata).

Klucz metadanych	Pole w KSeF	Opis
s2k_custom_client_id	Podmiot2/NrKlienta	Twój własny numer klienta używany w umowie lub zamówieniu
s2k_gv	Podmiot2/GV	true jeśli nabywca jest grupą VAT
s2k_jst	Podmiot2/JST	true jeśli nabywca jest jednostką samorządu terytorialnego
s2k_contact_email	Podmiot2/DaneKontaktowe/Email	E-mail nabywcy na fakturze
s2k_contact_phone	Podmiot2/DaneKontaktowe/Telefon	Telefon nabywcy na fakturze

Przykład

1. Wejdź w Stripe Dashboard → Customers → wybierz klienta
2. Przewiń do sekcji Metadata
3. Dodaj klucze:
   • s2k_custom_client_id → KL-2024-001
   • s2k_contact_email → [email protected]

---

Dane produktu (Product metadata)

Poniższe pola ustawiasz na obiekcie Product w Stripe (Product catalog → wybrany produkt → Metadata).

Klucz metadanych	Pole w KSeF	Opis
s2k_gtu	FaWiersz/GTU	Kod GTU (np. GTU_01, GTU_12)
s2k_pkwiu	FaWiersz/PKWiU	Symbol Polskiej Klasyfikacji Wyrobów i Usług
s2k_gtin	FaWiersz/GTIN	Globalny numer jednostki handlowej (EAN/barcode)
s2k_cn	FaWiersz/CN	Symbol Nomenklatury Scalonej (handel zagraniczny)
s2k_pkob	FaWiersz/PKOB	Symbol Polskiej Klasyfikacji Obiektów Budowlanych

Przykład — ustawienie kodu GTU

1. Wejdź w Stripe Dashboard → Product catalog → wybierz produkt
2. Kliknij Edit
3. Przewiń do sekcji Metadata
4. Dodaj klucz s2k_gtu z wartością np. GTU_12
5. Zapisz

Od tej chwili każda faktura zawierająca ten produkt będzie miała uzupełniony kod GTU w KSeF.

---

Kody GTU — lista wartości

Kod	Kategoria
GTU_01	Napoje alkoholowe
GTU_02	Towary z akcyzą (paliwa, oleje itp.)
GTU_03	Olej opałowy
GTU_04	Wyroby tytoniowe, susz tytoniowy
GTU_05	Odpady — tylko wymienione w przepisach
GTU_06	Urządzenia elektroniczne, części do nich
GTU_07	Pojazdy samochodowe
GTU_08	Metale szlachetne, nieszlachetne
GTU_09	Leki, wyroby medyczne
GTU_10	Budynki, budowle, grunty
GTU_11	Usługi gazowe, energetyczne
GTU_12	Usługi niematerialne (IT, doradztwo, finanse, itp.)
GTU_13	Usługi transportowe i spedycyjne