Manual de instalación: FEL Guatemala para WooCommerce | POSFEL

>_ Manual de instalación · WooCommerce

Factura FEL en tu tienda WooCommerce, paso a paso. Para quien administra el WordPress: instalar el plugin, conectarlo, poner tu certificador y ver salir la primera factura.

WordPress 6.4+ · PHP 7.4+ · WooCommerce 8.9+ · HTTPS

WordPressPOSFELTu cliente

el recorrido de la instalación · toque un paso para ir a su sección

Índice del manual

EmpezandoAntes de empezar

Ten a mano esto. Con lo demás te guía el asistente.

  • Ser administrador del WordPress: instala el plugin y aprueba el acceso de WooCommerce.
  • Una tienda con HTTPS en un dominio público. Un sitio local o una dirección IP no sirve: POSFEL tiene que poder leer los pedidos.
  • Las credenciales de tu certificador: INFILE (NIT emisor, usuario, llave, usuario de firma y llave de firma) o FELplex (API key e ID de empresa). Basta con uno.
  • Tu régimen ante la SAT y el código de tu establecimiento.

No necesitas cuenta en POSFEL: la tienda WooCommerce es la cuenta.

requisitos del plugin

WordPress6.4 o más
PHP7.4 o más
WooCommerce8.9 o más (probado hasta 11.3)
CheckoutClásico o de bloques
PedidosCon o sin el almacenamiento de alto rendimiento (HPOS)

EmpezandoQué hace solo

Una vez instalado, no hay que tocar nada por pedido.

  • Pide el NIT en el checkout y muestra el nombre de la SAT mientras el cliente lo escribe. Vacío es Consumidor Final; desde Q2,500 lo exige.
  • Factura cada pedido pagado y le manda al cliente el enlace al PDF en la nota del pedido.
  • Con un reembolso anula la factura o emite la nota de crédito.
  • Muestra la factura en el pedido, en la lista de pedidos y en Mi cuenta del cliente.

la caja «Factura FEL» del pedido

Pedido #57Editar pedido
Factura FEL
Emitida
Serie A1B2C3D4
Número 1234567890
Consumidor Final · 19/11/2026 16:01
Ver factura (PDF)

Paso 1Instala el plugin

WordPress

En el administrador de WordPress: Plugins › Añadir nuevo › Subir plugin. Elige fel-guatemala-posfel.zip, pulsa Instalar ahora y después Activar.

Al activarlo aparecen el menú WooCommerce › FEL Guatemala y el campo NIT para la factura en el checkout.

WordPress · Plugins › Añadir nuevo

Añadir pluginsSubir plugin
Añadir plugins
Si tiene un plugin en formato .zip, puede instalarlo o actualizarlo subiéndolo aquí.
Elegir archivofel-guatemala-posfel.zipInstalar ahora

Paso 2Conecta con POSFEL

WordPress

En WooCommerce › FEL Guatemala pulsa Conectar con POSFEL.

WooCommerce te pide aprobar el acceso de lectura y escritura para «FEL Guatemala por POSFEL»: es lo que permite leer los pedidos para facturarlos y escribir la factura en cada uno. WooCommerce muestra su lista estándar de permisos; POSFEL usa los pedidos, sus reembolsos y la cuenta del cliente.

Al aprobar vuelves a WordPress con la tienda conectada y se abre el panel de FEL Guatemala, con el asistente. Si no apruebas el acceso, la página lo dice y puedes volver a intentarlo.

WooCommerce · aprobar el acceso

FEL Guatemala por POSFEL quiere conectarse a su tienda.
Acceso de lectura y escritura: cupones, clientes, pedidos e informes, y productos.
DenegarAprobar

Paso 3Tu certificador

POSFEL

Elige INFILE o FELplex y pega tus credenciales. Se guardan cifradas en POSFEL: WordPress nunca las ve.

  • INFILE: NIT emisor, usuario, llave, usuario de firma y llave de firma.
  • FELplex: API key e ID de empresa.

el asistente · paso 1 de 3

INFILEFELplex
12345678
12345678
••••••••••••
12345678
Siguiente

Paso 4Tu negocio en la factura

POSFEL

Con INFILE, la razón social y la dirección vienen de la SAT con tu NIT: solo las revisas.

Elige tu régimen (General, Pequeño contribuyente, Agropecuario o Exento) y el establecimiento. Con FELplex, la razón social y la dirección se toman de tu panel de FELplex.

el asistente · paso 2 de 3

General (GEN)
1
MI TIENDA, SOCIEDAD ANONIMA
Siguiente

Paso 5La prueba

POSFEL

El asistente comprueba tus credenciales, que tu NIT esté activo en la SAT y que WooCommerce avise de cada pedido. No emite ninguna factura.

Si todo pasa, deja encendido Facturar los pedidos pagados y pulsa Terminar.

el asistente · paso 3 de 3

✓
Credenciales de INFILERespondió en 1.2 s
✓
NIT emisor activo en la SAT12345678 · MI TIENDA, SOCIEDAD ANONIMA
✓
Avisos de pedido de WooCommerce2 activos · revisión cada 5 min
Terminar

Paso 6El primer pedido

Tu cliente

El cliente escribe su NIT, o lo deja vacío para Consumidor Final, y ve el nombre de la SAT bajo el campo.

Al confirmarse el pago sale la factura y le llega el enlace al PDF en la nota del pedido. En el pedido, la caja Factura FEL muestra serie, número y PDF. Si algo falla (por ejemplo, falta el NIT), lo dice y tiene el botón Facturar ahora.

el checkout de la tienda

NIT para la factura (vacío = Consumidor Final)
12345678
✓ MI TIENDA, SOCIEDAD ANONIMA

ReferenciaCuándo se factura

Se cambia en el panel, pestaña Automatización.

Pago en líneaAl pasar el pedido a Procesando (pago confirmado).
TransferenciaCuando marcas el pago recibido.
Contra entregaAl marcar el pedido Completado.
«Esperar a Completado»Todos al marcarlos Completado.
Pedidos de antes de conectarNo se facturan solos; tienen el botón Facturar ahora.

ReferenciaDevoluciones

Tú solo haces el reembolso en WooCommerce. POSFEL elige el documento con las reglas de la SAT.

  • Reembolso total en el mismo período de IVA: la factura se anula sola.
  • Reembolso parcial: nota de crédito por lo devuelto, sola a los 10 minutos o con «Emitir ahora».
  • Período ya cerrado, o una nota anterior: nota de crédito por el resto.

Todas las facturas y notas están en el panel, pestaña Facturas.

la caja del pedido tras un reembolso

Nota de crédito en camino
Reembolso sin documento: Q65.00
1 × Taza de cerámica
Se emite sola a las 16:18 (en 10 min).
Emitir ahora

ReferenciaEl plan

14 días de prueba desde que conectas la tienda, sin tarjeta. Después, $25 al mes con tarjeta, por Stripe, sin límite de facturas.

Si agregas la tarjeta durante la prueba, el primer cobro es el día que la prueba termina. Si la prueba termina sin plan, la tienda deja de facturar; no se borra nada.

Precio$25 al mes, en dólares
FacturasSin límite
CobroTarjeta, por Stripe: POSFEL nunca ve el número
CancelarCuando quieras, desde la pestaña Plan

ReferenciaProblemas comunes

Los que más aparecen, con su salida. ¿Otro? Escríbenos a soporte@posfel.com con la dirección de tu tienda y el número de pedido.

La factura tarda unos minutos en salir

WooCommerce manda sus avisos con su cron interno, que a veces se atrasa. POSFEL revisa además la tienda cada 5 minutos: ningún pedido pagado se queda sin factura.

El pedido dice «Falta el NIT»

Era de Q2,500 o más y vino sin NIT. Escribe el NIT en Facturación (el lápiz), en «NIT para la factura», guarda el pedido y pulsa Facturar ahora.

Dice «Verificando en FELplex»

FELplex no respondió a tiempo. POSFEL busca la factura en su reporte antes de volver a emitir, para no duplicarla. Se actualiza sola en unos minutos.

«No se aprobó el acceso en WooCommerce»

Se pulsó Denegar en la pantalla de WooCommerce. Vuelve a WooCommerce › FEL Guatemala y conecta otra vez.

Mi sitio no tiene HTTPS o es local

La conexión solo acepta sitios con HTTPS en un dominio público. Activa el certificado en tu hosting y vuelve a conectar.

Quiero desconectar la tienda

En el panel, Conexión › Desconectar. POSFEL deja de facturar, borra sus llaves de WooCommerce y cancela la renovación del plan. Las facturas emitidas se quedan.

Listo para facturar en WooCommerce. Instala el plugin, conéctalo y la próxima venta sale con factura FEL.