Eksporty księgowe

Moduł zamienia faktury wystawione już przez Polski PRO na pliki, które przeczyta księgowa lub sieć e-fakturowania. Dostępne są dwa eksporty: pobranie pojedynczej faktury jako UBL/PEPPOL XML oraz raport JPK_FA za zakres dat.

Wymagania

Polski PRO wymaga: Polski (free) v1.6.0+, WordPress 6.4+, WooCommerce 8.0+, PHP 8.1+. Oba eksporty czytają z już istniejących faktur, więc moduł faktur musi najpierw wystawiać dokumenty.

Wysyłka bezpośrednia nie jest włączona

Wysyłanie dokumentów wprost do wFirma, Fakturowni lub iFirma nie jest włączone w tej wersji, więc nic nie trafia do tych serwisów automatycznie. Pobierz poniższe pliki i zaimportuj je w swoim programie księgowym.

Co działa

Eksport	Gdzie	Wynik
UBL / PEPPOL XML	Ekran edycji zamówienia, boks PEPPOL / UBL (XML)	Jeden plik .xml na fakturę
Raport JPK_FA	Polski > Raport JPK_FA	Jeden plik .xml na zakres dat

Oba wymagają uprawnienia manage_woocommerce i są zabezpieczone nonce.

Eksport UBL / PEPPOL

Gdzie to znaleźć

Otwórz zamówienie w kokpicie. W bocznej kolumnie jest boks PEPPOL / UBL (XML) z jednym przyciskiem na każdą fakturę powiązaną z tym zamówieniem, opisanym UBL: <numer faktury>. Jeśli zamówienie nie ma jeszcze faktury, boks to komunikuje i nie ma czego pobierać.

Plik jest serwowany jako invoice-<numer>.xml z typem treści application/xml.

Co zawiera plik

UBL 2.1, zbudowany z identyfikatorem customizacji EN 16931 i identyfikatorem profilu PEPPOL BIS Billing 3.0:

Element	Źródło
cbc:ID	Numer faktury
cbc:IssueDate	Data wystawienia faktury
cbc:InvoiceTypeCode	380 dla faktury, 384 dla korekty
cbc:DocumentCurrencyCode	Waluta faktury
cac:AccountingSupplierParty	Nazwa witryny, NIP sprzedawcy, kraj bazowy WooCommerce
cac:AccountingCustomerParty	Firma z danych rozliczeniowych (albo imię i nazwisko), NIP nabywcy, kraj rozliczeniowy
cac:TaxTotal	Jeden cac:TaxSubtotal na stawkę VAT, kategoria S, albo Z przy 0%
cac:LegalMonetaryTotal	Kwoty netto, bez podatku, z podatkiem i do zapłaty
cac:InvoiceLine	Jedna na pozycję faktury, z ilością, kodem jednostki, nazwą towaru, kategorią VAT i ceną jednostkową

Kody jednostek są mapowane z jednostki pozycji faktury: szt, szt. i pcs dają C62, kg daje KGM, l daje LTR, m daje MTR, h daje HUR. Pozostałe wartości trafiają domyślnie na C62.

Przykład (skrócony)

<?xml version="1.0" encoding="UTF-8"?>
<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
         xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
         xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
  <cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>
  <cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
  <cbc:ID>FV/2026/07/12</cbc:ID>
  <cbc:IssueDate>2026-07-12</cbc:IssueDate>
  <cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
  <cbc:DocumentCurrencyCode>PLN</cbc:DocumentCurrencyCode>
  <cac:AccountingSupplierParty>
    <cac:Party>
      <cac:PartyName><cbc:Name>Moja Firma Sp. z o.o.</cbc:Name></cac:PartyName>
      <cac:PostalAddress>
        <cac:Country><cbc:IdentificationCode>PL</cbc:IdentificationCode></cac:Country>
      </cac:PostalAddress>
      <cac:PartyTaxScheme>
        <cbc:CompanyID>PL1234567890</cbc:CompanyID>
        <cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
      </cac:PartyTaxScheme>
      <cac:PartyLegalEntity><cbc:RegistrationName>Moja Firma Sp. z o.o.</cbc:RegistrationName></cac:PartyLegalEntity>
    </cac:Party>
  </cac:AccountingSupplierParty>
  <!-- AccountingCustomerParty ma taką samą strukturę, wypełnioną z adresu rozliczeniowego -->
  <cac:TaxTotal>
    <cbc:TaxAmount currencyID="PLN">46.00</cbc:TaxAmount>
    <cac:TaxSubtotal>
      <cbc:TaxableAmount currencyID="PLN">200.00</cbc:TaxableAmount>
      <cbc:TaxAmount currencyID="PLN">46.00</cbc:TaxAmount>
      <cac:TaxCategory>
        <cbc:ID>S</cbc:ID>
        <cbc:Percent>23.00</cbc:Percent>
        <cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
      </cac:TaxCategory>
    </cac:TaxSubtotal>
  </cac:TaxTotal>
  <cac:LegalMonetaryTotal>
    <cbc:LineExtensionAmount currencyID="PLN">200.00</cbc:LineExtensionAmount>
    <cbc:TaxExclusiveAmount currencyID="PLN">200.00</cbc:TaxExclusiveAmount>
    <cbc:TaxInclusiveAmount currencyID="PLN">246.00</cbc:TaxInclusiveAmount>
    <cbc:PayableAmount currencyID="PLN">246.00</cbc:PayableAmount>
  </cac:LegalMonetaryTotal>
  <cac:InvoiceLine>
    <cbc:ID>1</cbc:ID>
    <cbc:InvoicedQuantity unitCode="C62">2.00</cbc:InvoicedQuantity>
    <cbc:LineExtensionAmount currencyID="PLN">200.00</cbc:LineExtensionAmount>
    <cac:Item>
      <cbc:Name>Produkt testowy</cbc:Name>
      <cac:ClassifiedTaxCategory>
        <cbc:ID>S</cbc:ID>
        <cbc:Percent>23.00</cbc:Percent>
        <cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
      </cac:ClassifiedTaxCategory>
    </cac:Item>
    <cac:Price>
      <cbc:PriceAmount currencyID="PLN">100.00</cbc:PriceAmount>
    </cac:Price>
  </cac:InvoiceLine>
</Invoice>

Mapper pokrywa podstawowe elementy obowiązkowe. Zwaliduj wynik oficjalnym walidatorem EN 16931 / PEPPOL, zanim oprzesz na nim produkcyjną wymianę B2B.

Raport JPK_FA

Gdzie to znaleźć

Przejdź do Polski > Raport JPK_FA. Formularz ma dwa pola dat, Od i Do, wypełnione pierwszym i ostatnim dniem bieżącego miesiąca, oraz przycisk Pobierz JPK_FA XML. Plik jest serwowany jako JPK_FA_<od>_<do>.xml.

Co zawiera raport

JPK_FA(3), o strukturze wymaganej przez Ministerstwo Finansów:

Sekcja	Zawartość
Naglowek	KodFormularza JPK_FA, WariantFormularza 3, CelZlozenia 1, znacznik czasu wygenerowania, DataOd i DataDo z formularza
Podmiot1	NIP, nazwa i ulica sprzedawcy z ustawień ogólnych Polski
Faktura	Jedna na dokument: data wystawienia, numer, nazwa i adres nabywcy, NIP sprzedawcy i nabywcy, netto i VAT w podziale na stawki, kwota brutto, rodzaj dokumentu
FakturaCtrl	Liczba faktur i ich łączna wartość brutto
FakturaWiersz	Jeden na pozycję faktury: numer faktury, nazwa towaru, jednostka, ilość, cena jednostkowa netto, wartość netto pozycji, stawka VAT
FakturaWierszCtrl	Liczba wierszy i ich łączna wartość netto

Pola w podziale na stawki zapisywane są tylko wtedy, gdy faktura ma pozycje w danej stawce: P_13_1 i P_14_1 dla 23%, P_13_2 i P_14_2 dla 8%, P_13_3 i P_14_3 dla 5%, P_13_6 dla 0%. RodzajFaktury to VAT, albo KOREKTA dla korekty.

Co wchodzi, a co jest pomijane

Eksportowane są wyłącznie dokumenty księgowe: faktury VAT i korekty. Proformy, paragony i dokumenty WZ są celowo pomijane i nie są liczone w FakturaCtrl.

Zanim wyślesz

• Najpierw uzupełnij nazwę firmy, NIP i adres w ustawieniach Polski. Puste wartości trafiają do pliku jako wypełniacze.
• Blok adresowy przenosi wyłącznie ulicę z ustawień. Wojewodztwo, Powiat i Gmina wychodzą puste, a Miejscowosc, KodPocztowy i Poczta jako -.
• KodUrzedu (kod urzędu skarbowego) jest zapisywany pusty. Uzupełnij go w pliku przed wysyłką.
• Raport wczytuje do 10 000 faktur i dopiero potem filtruje je do wybranego zakresu. W sklepie o dużym wolumenie generuj miesiąc po miesiącu.
• Zwaliduj plik oficjalnym schematem XSD Ministerstwa Finansów, zanim wyślesz go do urzędu.

Rozwiązywanie problemów

Boks UBL pokazuje “Nie ma jeszcze faktury.” Do zamówienia nie jest przypięta żadna faktura. Wystaw ją najpierw, potem odśwież ekran zamówienia.

JPK_FA wychodzi z LiczbaFaktur 0 W wybranym zakresie nie ma faktur VAT ani korekt. Proformy i paragony nie liczą się do raportu.

Dane sprzedawcy w raporcie to wypełniacze Nazwa firmy, NIP i adres są puste w ustawieniach ogólnych Polski. Uzupełnij je i wygeneruj plik ponownie.

“Nie masz uprawnień.” albo “Weryfikacja zabezpieczeń nie powiodła się.” Oba pobrania wymagają uprawnienia manage_woocommerce, a link i formularz niosą nonce. Odśwież stronę i spróbuj ponownie.

Dalsze kroki

• Zgłaszaj problemy: GitHub Issues
• Powiązane: PRO REST API

Ta strona ma wyłącznie charakter informacyjny i nie stanowi porady prawnej. Przed wdrożeniem skonsultuj się z prawnikiem. Polski for WooCommerce jest oprogramowaniem open source (GPLv2) dostarczanym bez gwarancji.