Sistema de facturas

El módulo de facturas genera documentos de venta directamente en WooCommerce. Admite cuatro tipos de documento, numeración automática y PDF.

Tipos de documento

Factura de IVA

Una factura de IVA estándar que contiene:

datos del vendedor y del comprador (incluidos los números de IVA de ambas partes)
líneas de producto con nombre, cantidad, precio neto, tipo de IVA, importe de IVA y precio bruto
resumen con desglose por tipo de IVA
número de factura, fecha de emisión y fecha de venta
condiciones de pago y método de pago

Factura de corrección

Un documento de corrección de una factura emitida anteriormente. Contiene:

número y fecha de la factura corregida
líneas de producto antes y después de la corrección
diferencia de valor
motivo de la corrección

Una factura de corrección puede emitirse desde el panel del pedido o mediante la REST API.

Recibo

Un documento de venta simplificado para clientes particulares (sin número de IVA del comprador). Contiene líneas de producto con precios brutos y un resumen.

Albarán de entrega

Un documento externo de salida adjunto al envío. Contiene una lista de productos, cantidades y las notas del pedido, si las hay. No incluye precios.

Configuración

Vaya a WooCommerce > Invoice Settings (esta entrada de menú aún no está traducida). Los documentos emitidos se listan en WooCommerce > Facturas.

Datos del vendedor

Campo	Descripción
Nombre de la empresa	Nombre completo de la empresa vendedora
Número de IVA (NIP)	Número de identificación fiscal del vendedor
Dirección	Calle, número, código postal, ciudad
Número de cuenta bancaria	Número de cuenta para transferencias
Correo de contacto	Dirección de correo mostrada en la factura

Numeración

El plugin ofrece varias estrategias de numeración de facturas:

Estrategia	Formato	Ejemplo
Anual	`FV/{number}/{year}`	FV/1/2026
Mensual	`FV/{number}/{month}/{year}`	FV/1/04/2026
Continua	`FV/{number}`	FV/1
Patrón personalizado	Definido por el usuario	FV/2026/04/001

Tokens disponibles en el formato personalizado:

{numer} - número de factura secuencial (se reinicia según la estrategia)
{rok} - año de cuatro dígitos
{miesiac} - mes de dos dígitos
{dzien} - día de dos dígitos
{id_zamowienia} - ID de pedido de WooCommerce

Generación automática

El plugin puede generar automáticamente una factura cuando el estado del pedido cambia a “Completado”. Active la opción Generación automática de facturas en los ajustes del módulo.

También puede configurar el envío automático del PDF de la factura como adjunto del correo de WooCommerce “Pedido completado”.

Generación de PDF

Los PDF de las facturas se generan con la biblioteca TCPDF. La plantilla del PDF incluye:

logotipo de la empresa (opcional, configurable en los ajustes)
datos del vendedor y del comprador
tabla de líneas de producto con columnas de IVA
resumen con desglose por tipo de IVA
pie de página con los datos de la empresa

Fuentes

El plugin utiliza la fuente DejaVu Sans, que admite los caracteres diacríticos polacos. No se requiere ninguna configuración adicional.

Estado de la factura

Cada factura pasa por un ciclo de vida de estados:

Draft (Szkic) > Issued (Wystawiona) > Sent (Wysłana) > Paid (Opłacona)
                                                      > Cancelled (Anulowana)

Estado	Descripción
Draft	Factura creada pero aún no emitida. Se puede editar
Issued	Factura emitida con un número asignado. No se puede editar
Sent	Factura enviada al cliente por correo. Un envío a KSeF no establece este estado
Paid	Factura pagada
Cancelled	Factura cancelada. Requiere emitir una corrección

Panel del pedido

En el panel de administración del pedido de WooCommerce, el módulo añade una meta box “Facturas” con las siguientes funciones:

Emitir factura - genera una factura a partir de los datos del pedido
Descargar PDF - descarga la factura en formato PDF
Enviar al cliente - envía la factura por correo
Emitir corrección - crea una factura de corrección
Historial - lista de todos los documentos asociados al pedido

IVA en las líneas de producto

Cada línea de producto de la factura contiene datos de IVA detallados:

precio unitario neto
tipo de IVA (23%, 8%, 5%, 0%, exento, no aplicable, inversión del sujeto pasivo)
importe de IVA unitario
valor neto
valor bruto

El plugin reconoce automáticamente el tipo de IVA a partir de la configuración de WooCommerce Tax. Admite varios tipos de IVA en una misma factura con totales correctos.

REST API

El módulo proporciona endpoints de REST API para gestionar las facturas de forma programática.

Listar facturas

GET /wp-json/polski-pro/v1/invoices

Parámetros de consulta:

Parámetro	Tipo	Descripción
`order_id`	int	Filtrar por ID de pedido
`status`	string	Filtrar por estado (draft, issued, sent, paid, cancelled)
`type`	string	Filtrar por tipo (invoice, correction, receipt, packing_slip)
`date_from`	string	Fecha desde (YYYY-MM-DD)
`date_to`	string	Fecha hasta (YYYY-MM-DD)
`per_page`	int	Resultados por página (predeterminado 20)
`page`	int	Número de página

Crear factura

POST /wp-json/polski-pro/v1/invoices

{
    "order_id": 123,
    "type": "invoice",
    "auto_number": true
}

Descargar PDF

GET /wp-json/polski-pro/v1/invoices/{id}/pdf

Devuelve un archivo PDF como application/pdf con una cabecera Content-Disposition: attachment.

Emitir corrección

POST /wp-json/polski-pro/v1/invoices/{id}/correction

{
    "reason": "Zmiana danych nabywcy",
    "items": [
        {
            "product_id": 45,
            "quantity": 1,
            "net_price": 100.00,
            "vat_rate": 23
        }
    ]
}

Estadísticas

GET /wp-json/polski-pro/v1/invoices/stats

Devuelve estadísticas de las facturas: recuento total, valores netos/brutos, desglose por estado.

Hooks

`polski_pro/invoices/before_generate`

Acción que se dispara antes de generar una factura.

/**
 * @param int    $order_id ID zamówienia
 * @param string $type     Typ dokumentu (invoice, correction, receipt, packing_slip)
 */
do_action('polski_pro/invoices/before_generate', int $order_id, string $type);

Ejemplo:

add_action('polski_pro/invoices/before_generate', function (int $order_id, string $type): void {
    if ($type === 'invoice') {
        // Logowanie generowania faktury
        error_log("Generowanie faktury dla zamówienia #{$order_id}");
    }
}, 10, 2);

`polski_pro/invoices/number_format`

Filtra el formato del número de factura.

/**
 * @param string $number    Wygenerowany numer faktury
 * @param string $type      Typ dokumentu
 * @param int    $order_id  ID zamówienia
 */
apply_filters('polski_pro/invoices/number_format', string $number, string $type, int $order_id): string;

Ejemplo:

add_filter('polski_pro/invoices/number_format', function (string $number, string $type, int $order_id): string {
    if ($type === 'correction') {
        return 'KOR/' . $number;
    }
    return $number;
}, 10, 3);

`polski_pro/invoices/pdf_content`

Filtra los datos que se pasan a la plantilla del PDF.

/**
 * @param array  $data     Dane faktury (seller, buyer, items, totals)
 * @param int    $invoice_id ID faktury
 */
apply_filters('polski_pro/invoices/pdf_content', array $data, int $invoice_id): array;

Ejemplo:

add_filter('polski_pro/invoices/pdf_content', function (array $data, int $invoice_id): array {
    $data['footer_note'] = 'Dziękujemy za zakupy!';
    return $data;
}, 10, 2);

Problemas frecuentes

El PDF genera páginas en blanco

Compruebe si la extensión de PHP mbstring está instalada
Asegúrese de que el directorio wp-content/uploads/polski-pro/invoices/ tiene permisos de escritura (755)
Verifique que los datos del vendedor estén rellenados en los ajustes

La numeración se reinicia

La numeración se reinicia según la estrategia seleccionada - la anual se reinicia el 1 de enero, la mensual el día 1 de cada mes. Si desea una numeración continua, seleccione la estrategia “Continua”.

No hay IVA en las líneas de producto

Compruebe la configuración de WooCommerce Tax. El plugin obtiene los tipos de IVA de los ajustes de impuestos de WooCommerce. Asegúrese de que los tipos estén configurados correctamente para Polonia.

Recursos relacionados

Esta página tiene fines exclusivamente informativos y no constituye asesoramiento legal. Consulte a un abogado antes de la implementación. Polski for WooCommerce es software de código abierto (GPLv2) proporcionado sin garantía.