=== FEL Guatemala por POSFEL ===
Contributors: posfel
Tags: woocommerce, factura electronica, fel, guatemala, sat
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.7.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Factura electrónica (FEL) de la SAT de Guatemala para los pedidos de WooCommerce: NIT en el checkout, factura automática, anulaciones y notas de crédito.

== Description ==

FEL Guatemala por POSFEL emite la factura electrónica en línea (FEL) de la SAT de Guatemala para cada pedido pagado de tu tienda WooCommerce, con tu certificador: INFILE o FELplex.

* **NIT en el checkout.** Agrega el campo «NIT para la factura» al checkout clásico y al de bloques. Mientras el cliente escribe, consulta el NIT en la SAT y muestra el nombre. Vacío es Consumidor Final; acepta la K al final.
* **Regla de Q2,500.** El checkout no deja pagar sin NIT un pedido de Q2,500 o más (la SAT no acepta Consumidor Final de ese monto). Se puede apagar.
* **Factura automática.** Pago en línea: al pasar el pedido a Procesando. Transferencia: al marcar el pago recibido. Contra entrega: al completar el pedido.
* **Factura FEL en el pedido.** Una caja en el pedido con serie, número, PDF y el botón «Facturar ahora»; una columna en la lista de pedidos.
* **Reembolsos.** Un reembolso total dentro del período de IVA anula la factura; uno parcial emite la nota de crédito por lo devuelto.
* **Para tu cliente.** La factura llega en una nota del pedido (correo de WooCommerce) y queda en Mi cuenta.

Es un plugin delgado: no guarda credenciales FEL en WordPress ni habla con el certificador. Eso lo hace el servicio de POSFEL (ver «Servicio externo»), que tiene un costo de US$25 al mes por tienda después de 14 días de prueba. El certificador (INFILE o FELplex) se contrata aparte.

Manual de instalación paso a paso: https://posfel.com/woocommerce/instalacion

== Installation ==

1. Plugins › Añadir nuevo › Subir plugin, elige el ZIP, pulsa «Instalar ahora» y «Activar».
2. WooCommerce › FEL Guatemala › «Conectar con POSFEL» y aprueba en WooCommerce el acceso de lectura y escritura.
3. En el asistente, elige INFILE o FELplex, pega tus credenciales, revisa los datos de tu negocio y pulsa «Probar».

Requisitos: WordPress 6.4+, PHP 7.4+, WooCommerce 8.9+ y la tienda con HTTPS en un dominio público.

== Frequently Asked Questions ==

= ¿Funciona con el checkout de bloques? =

Sí, con el clásico y con el de bloques, y con o sin el almacenamiento de pedidos de alto rendimiento (HPOS).

= ¿Dónde se guardan mis credenciales de INFILE o FELplex? =

Cifradas en el servicio de POSFEL. WordPress nunca las ve.

= ¿Cuánto cuesta? =

El plugin es gratis. El servicio de POSFEL que emite las facturas cuesta US$25 al mes por tienda, sin tope de facturas, con 14 días de prueba sin tarjeta. El certificador se contrata aparte.

= ¿Necesito una cuenta en POSFEL? =

No. Al conectar, la tienda WooCommerce es la cuenta.

== Servicio externo ==

Este plugin necesita el servicio de POSFEL (https://posfel.com) para funcionar:

* **Al conectar**, WooCommerce envía a POSFEL una llave de su API REST (lectura y escritura) para que POSFEL lea los pedidos, escriba la factura en ellos y registre avisos (webhooks) de pedido creado y actualizado.
* **En el checkout**, el NIT que escribe el cliente se envía a POSFEL para consultarlo en la SAT.
* **Con cada pedido facturado**, POSFEL envía los datos del pedido (productos, montos, NIT, nombre, dirección y correo del cliente) al certificador que eligió la tienda, INFILE o FELplex, que lo certifica ante la SAT de Guatemala.
* **El panel** de WooCommerce › FEL Guatemala se carga desde posfel.com.

Términos de servicio: https://posfel.com/terms-of-service
Política de privacidad: https://posfel.com/privacy-policy

== Changelog ==

= 0.7.0 =
* La cuenta del cliente guarda su NIT y su nombre de la SAT; campos en su perfil.

= 0.6.1 =
* La caja del pedido muestra las horas en hora de Guatemala.

= 0.6.0 =
* Reembolsos: anulación y notas de crédito, con la caja del pedido y «Emitir ahora».

= 0.5.0 =
* Panel de configuración dentro de WooCommerce, con asistente de tres pasos.
