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

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_idKL-2024-001

    • s2k_contact_emailjan.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

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