Accounting exports
El módulo convierte las facturas ya emitidas por Polski PRO en archivos que puede leer una asesoría o una red de facturación electrónica. Se incluyen dos exportaciones: la descarga de una factura individual como XML UBL/PEPPOL y un informe JPK_FA para un intervalo de fechas.
Qué se incluye
Sección titulada «Qué se incluye»| Exportación | Dónde | Resultado |
|---|---|---|
| XML UBL / PEPPOL | Pantalla de edición del pedido, caja PEPPOL / UBL (XML) | Un archivo .xml por factura |
| Informe JPK_FA | Polski > Informe JPK_FA | Un archivo .xml por intervalo de fechas |
Ambas requieren la capacidad manage_woocommerce y están protegidas con nonce.
Exportación UBL / PEPPOL
Sección titulada «Exportación UBL / PEPPOL»Dónde encontrarla
Sección titulada «Dónde encontrarla»Abra un pedido en el escritorio. En la columna lateral hay una caja PEPPOL / UBL (XML) con un botón por cada factura asociada a ese pedido, con la etiqueta UBL: <número de factura>. Si el pedido todavía no tiene factura, la caja lo indica y no hay nada que descargar.
El archivo se sirve como invoice-<número>.xml con el tipo de contenido application/xml.
Qué contiene el archivo
Sección titulada «Qué contiene el archivo»UBL 2.1, generado con el identificador de personalización EN 16931 y el identificador de perfil PEPPOL BIS Billing 3.0:
| Elemento | Origen |
|---|---|
cbc:ID |
Número de factura |
cbc:IssueDate |
Fecha de emisión de la factura |
cbc:InvoiceTypeCode |
380 para una factura, 384 para una rectificativa |
cbc:DocumentCurrencyCode |
Moneda de la factura |
cac:AccountingSupplierParty |
Nombre del sitio, NIP del vendedor, país base de WooCommerce |
cac:AccountingCustomerParty |
Empresa de la dirección de facturación (o nombre y apellidos), NIP del comprador, país de facturación |
cac:TaxTotal |
Un cac:TaxSubtotal por tipo de IVA, categoría S, o Z al 0% |
cac:LegalMonetaryTotal |
Importes de líneas, base imponible, total con impuestos e importe a pagar |
cac:InvoiceLine |
Una por línea de factura, con cantidad, código de unidad, nombre del artículo, categoría de IVA y precio unitario |
Los códigos de unidad se asignan desde la unidad de la línea de factura: szt, szt. y pcs pasan a C62, kg a KGM, l a LTR, m a MTR, h a HUR. Cualquier otro valor recurre a C62.
Ejemplo (abreviado)
Sección titulada «Ejemplo (abreviado)»<?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 tiene la misma estructura, rellenada con la dirección de facturación --> <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>El mapeador cubre los elementos obligatorios básicos. Valide la salida con el validador oficial EN 16931 / PEPPOL antes de usarla para intercambio B2B en producción.
Informe JPK_FA
Sección titulada «Informe JPK_FA»Dónde encontrarlo
Sección titulada «Dónde encontrarlo»Vaya a Polski > Informe JPK_FA. El formulario tiene dos campos de fecha, De y a, rellenados con el primer y el último día del mes en curso, y un botón Descargar JPK_FA XML. El archivo se sirve como JPK_FA_<desde>_<hasta>.xml.
Qué contiene el informe
Sección titulada «Qué contiene el informe»JPK_FA(3), con la estructura que espera el Ministerio de Hacienda polaco:
| Sección | Contenido |
|---|---|
Naglowek |
KodFormularza JPK_FA, WariantFormularza 3, CelZlozenia 1, marca de tiempo de generación, DataOd y DataDo del formulario |
Podmiot1 |
NIP, nombre y calle del vendedor desde los ajustes generales de Polski |
Faktura |
Una por documento: fecha de emisión, número, nombre y dirección del comprador, NIP del vendedor y del comprador, base y IVA por tipo, total bruto, tipo de documento |
FakturaCtrl |
Número de facturas y su valor bruto total |
FakturaWiersz |
Una por línea de factura: número de factura, nombre del artículo, unidad, cantidad, precio unitario neto, valor neto de la línea, tipo de IVA |
FakturaWierszCtrl |
Número de líneas y su valor neto total |
Los campos por tipo se escriben solo cuando la factura tiene líneas con ese tipo: P_13_1 y P_14_1 para el 23%, P_13_2 y P_14_2 para el 8%, P_13_3 y P_14_3 para el 5%, P_13_6 para el 0%. RodzajFaktury es VAT, o KOREKTA en una rectificativa.
Qué se incluye y qué se omite
Sección titulada «Qué se incluye y qué se omite»Solo se exportan documentos contables: facturas con IVA y rectificativas. Las proformas, los recibos (paragon) y los albaranes se omiten a propósito y no cuentan en FakturaCtrl.
Antes de presentarlo
Sección titulada «Antes de presentarlo»- Rellene primero el nombre de la empresa, el NIP y la dirección en los ajustes de Polski. Los valores vacíos se escriben como marcadores de posición.
- El bloque de dirección lleva solo la calle de los ajustes.
Wojewodztwo,PowiatyGminasalen vacíos, yMiejscowosc,KodPocztowyyPocztasalen como-. KodUrzedu(el código de la oficina tributaria) se emite vacío. Añádalo al archivo antes de presentarlo.- El informe lee hasta 10 000 facturas y luego las filtra al intervalo elegido. En una tienda de gran volumen, genérelo mes a mes.
- Valide el archivo con el XSD oficial del Ministerio de Hacienda antes de enviarlo a la administración tributaria.
Resolución de problemas
Sección titulada «Resolución de problemas»La caja UBL muestra “Aún no hay factura.” El pedido no tiene ninguna factura asociada. Emita una primero y recargue la pantalla del pedido.
El JPK_FA sale con LiczbaFaktur 0
El intervalo elegido no contiene facturas con IVA ni rectificativas. Las proformas y los recibos no cuentan para el informe.
Los datos del vendedor en el informe son marcadores de posición El nombre de la empresa, el NIP y la dirección están vacíos en los ajustes generales de Polski. Rellénelos y vuelva a generar el archivo.
“No tienes permiso.” o “El control de seguridad falló.”
Ambas descargas requieren la capacidad manage_woocommerce, y tanto el enlace como el formulario llevan un nonce. Recargue la página e inténtelo de nuevo.
Próximos pasos
Sección titulada «Próximos pasos»- Informar de problemas: GitHub Issues
- Relacionado: PRO REST API