Accounting exports

Das Modul wandelt bereits von Polski PRO ausgestellte Rechnungen in Dateien um, die eine Buchhaltung oder ein E-Invoicing-Netzwerk lesen kann. Zwei Exporte sind enthalten: der Download einer einzelnen Rechnung als UBL/PEPPOL-XML und ein JPK_FA-Bericht über einen Zeitraum.

Voraussetzungen

Polski PRO erfordert: Polski (kostenlos) v1.6.0+, WordPress 6.4+, WooCommerce 8.0+, PHP 8.1+. Beide Exporte lesen aus bereits vorhandenen Rechnungen, das Rechnungsmodul muss also zuerst Dokumente ausstellen.

Direkte Übertragung ist nicht aktiviert

Das direkte Senden von Dokumenten an wFirma, Fakturownia oder iFirma ist in dieser Version nicht aktiviert, es geht also nichts automatisch an diese Dienste. Laden Sie stattdessen die unten beschriebenen Dateien herunter und importieren Sie sie in Ihre Buchhaltungssoftware.

Was enthalten ist

Export	Wo	Ergebnis
UBL / PEPPOL XML	Bestellbearbeitung, Box PEPPOL / UBL (XML)	Eine .xml-Datei pro Rechnung
JPK_FA-Bericht	Polski > JPK_FA-Bericht	Eine .xml-Datei pro Zeitraum

Beide erfordern die Berechtigung manage_woocommerce und sind per Nonce abgesichert.

UBL / PEPPOL-Export

Wo Sie ihn finden

Öffnen Sie eine Bestellung im wp-admin. In der Seitenspalte gibt es die Box PEPPOL / UBL (XML) mit einer Schaltfläche je Rechnung, die zu dieser Bestellung gehört, beschriftet mit UBL: <Rechnungsnummer>. Hat die Bestellung noch keine Rechnung, weist die Box darauf hin und es gibt nichts herunterzuladen.

Die Datei wird als invoice-<Nummer>.xml mit dem Content-Type application/xml ausgeliefert.

Was die Datei enthält

UBL 2.1, erzeugt mit der EN-16931-Customization-ID und der Profil-ID von PEPPOL BIS Billing 3.0:

Element	Quelle
cbc:ID	Rechnungsnummer
cbc:IssueDate	Rechnungsdatum
cbc:InvoiceTypeCode	380 für eine Rechnung, 384 für eine Korrektur
cbc:DocumentCurrencyCode	Rechnungswährung
cac:AccountingSupplierParty	Website-Name, NIP des Verkäufers, WooCommerce-Basisland
cac:AccountingCustomerParty	Firma aus der Rechnungsadresse (oder Vor- und Nachname), NIP des Käufers, Rechnungsland
cac:TaxTotal	Ein cac:TaxSubtotal je Umsatzsteuersatz, Kategorie S, bei 0% Z
cac:LegalMonetaryTotal	Positionssumme, Nettobetrag, Bruttobetrag und Zahlbetrag
cac:InvoiceLine	Eine je Rechnungsposition, mit Menge, Einheitencode, Artikelname, Steuerkategorie und Einzelpreis

Die Einheitencodes werden aus der Einheit der Rechnungsposition abgeleitet: szt, szt. und pcs werden zu C62, kg zu KGM, l zu LTR, m zu MTR, h zu HUR. Alles andere fällt auf C62 zurück.

Beispiel (gekürzt)

<?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 hat dieselbe Struktur, gefüllt aus der Rechnungsadresse -->
  <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>

Der Mapper deckt die verpflichtenden Kernelemente ab. Prüfen Sie die Ausgabe mit dem offiziellen EN-16931/PEPPOL-Validator, bevor Sie sie für den produktiven B2B-Austausch nutzen.

JPK_FA-Bericht

Wo Sie ihn finden

Gehen Sie zu Polski > JPK_FA-Bericht. Das Formular hat zwei Datumsfelder, Von und Zu, vorbelegt mit dem ersten und letzten Tag des laufenden Monats, sowie die Schaltfläche Lade JPK_FA XML herunter. Die Datei wird als JPK_FA_<von>_<bis>.xml ausgeliefert.

Was der Bericht enthält

JPK_FA(3), mit der vom polnischen Finanzministerium erwarteten Struktur:

Abschnitt	Inhalt
Naglowek	KodFormularza JPK_FA, WariantFormularza 3, CelZlozenia 1, Erzeugungszeitpunkt, DataOd und DataDo aus dem Formular
Podmiot1	NIP, Name und Straße des Verkäufers aus den allgemeinen Polski-Einstellungen
Faktura	Eine je Dokument: Ausstellungsdatum, Nummer, Name und Adresse des Käufers, NIP von Verkäufer und Käufer, Netto und Umsatzsteuer je Satz, Bruttosumme, Dokumentart
FakturaCtrl	Anzahl der Rechnungen und deren Bruttogesamtwert
FakturaWiersz	Eine je Rechnungsposition: Rechnungsnummer, Artikelname, Einheit, Menge, Netto-Einzelpreis, Nettowert der Position, Umsatzsteuersatz
FakturaWierszCtrl	Anzahl der Positionen und deren Nettogesamtwert

Die Felder je Steuersatz werden nur geschrieben, wenn die Rechnung Positionen mit diesem Satz hat: P_13_1 und P_14_1 für 23%, P_13_2 und P_14_2 für 8%, P_13_3 und P_14_3 für 5%, P_13_6 für 0%. RodzajFaktury ist VAT, bei einer Korrektur KOREKTA.

Was aufgenommen und was übersprungen wird

Exportiert werden ausschließlich Buchhaltungsdokumente: Umsatzsteuerrechnungen und Korrekturen. Proformarechnungen, Quittungen (Paragon) und Lieferscheine werden bewusst übersprungen und zählen nicht in FakturaCtrl.

Vor dem Einreichen

• Tragen Sie zuerst Firmenname, NIP und Adresse in den Polski-Einstellungen ein. Leere Werte werden als Platzhalter geschrieben.
• Der Adressblock übernimmt nur die Straße aus den Einstellungen. Wojewodztwo, Powiat und Gmina bleiben leer, Miejscowosc, KodPocztowy und Poczta gehen als - heraus.
• KodUrzedu (der Code des Finanzamts) wird leer ausgegeben. Ergänzen Sie ihn vor dem Einreichen in der Datei.
• Der Bericht liest bis zu 10.000 Rechnungen ein und filtert sie erst danach auf den gewählten Zeitraum. Erzeugen Sie ihn in einem Shop mit hohem Volumen Monat für Monat.
• Validieren Sie die Datei gegen das offizielle XSD des Finanzministeriums, bevor Sie sie an die Steuerbehörde senden.

Fehlerbehebung

Die UBL-Box zeigt “Noch keine Rechnung.” Der Bestellung ist keine Rechnung zugeordnet. Stellen Sie zuerst eine aus und laden Sie den Bestellbildschirm neu.

JPK_FA kommt mit LiczbaFaktur 0 heraus Der gewählte Zeitraum enthält keine Umsatzsteuerrechnungen und keine Korrekturen. Proformarechnungen und Quittungen zählen nicht für den Bericht.

Die Verkäuferdaten im Bericht zeigen Platzhalter Firmenname, NIP und Adresse sind in den allgemeinen Polski-Einstellungen leer. Tragen Sie sie ein und erzeugen Sie die Datei erneut.

“Du hast keine Erlaubnis.” oder “Sicherheitsüberprüfung fehlgeschlagen.” Beide Downloads erfordern die Berechtigung manage_woocommerce, und Link wie Formular führen einen Nonce mit. Laden Sie die Seite neu und versuchen Sie es erneut.

Nächste Schritte

• Probleme melden: GitHub Issues
• Verwandt: PRO REST API

Diese Seite dient ausschließlich Informationszwecken und stellt keine Rechtsberatung dar. Konsultieren Sie vor der Umsetzung einen Anwalt. Polski for WooCommerce ist Open-Source-Software (GPLv2), die ohne Gewährleistung bereitgestellt wird.