Jak uzupełnić fakturę o dodatkowe dane używając metadanych 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.

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 |
|---|---|---|
|
| Twój własny numer klienta używany w umowie lub zamówieniu |
|
|
|
|
|
|
|
| E-mail nabywcy na fakturze |
|
| Telefon nabywcy na fakturze |
Przykład
Wejdź w Stripe Dashboard → Customers → wybierz klienta
Przewiń do sekcji Metadata
Dodaj klucze:
s2k_custom_client_id→KL-2024-001s2k_contact_email→jan.kowalski@firma.pl
Dane produktu (Product metadata)
Poniższe pola ustawiasz na obiekcie Product w Stripe (Product catalog → wybrany produkt → Metadata).
Klucz metadanych | Pole w KSeF | Opis |
|---|---|---|
|
| Kod GTU (np. |
|
| Symbol Polskiej Klasyfikacji Wyrobów i Usług |
|
| Globalny numer jednostki handlowej (EAN/barcode) |
|
| Symbol Nomenklatury Scalonej (handel zagraniczny) |
|
| Symbol Polskiej Klasyfikacji Obiektów Budowlanych |
Przykład — ustawienie kodu GTU
Wejdź w Stripe Dashboard → Product catalog → wybierz produkt
Kliknij Edit
Przewiń do sekcji Metadata
Dodaj klucz
s2k_gtuz wartością np.GTU_12Zapisz
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 |
|---|---|
| Napoje alkoholowe |
| Towary z akcyzą (paliwa, oleje itp.) |
| Olej opałowy |
| Wyroby tytoniowe, susz tytoniowy |
| Odpady — tylko wymienione w przepisach |
| Urządzenia elektroniczne, części do nich |
| Pojazdy samochodowe |
| Metale szlachetne, nieszlachetne |
| Leki, wyroby medyczne |
| Budynki, budowle, grunty |
| Usługi gazowe, energetyczne |
| Usługi niematerialne (IT, doradztwo, finanse, itp.) |
| Usługi transportowe i spedycyjne |