Conecta tu web propia: checkout y factura FEL | POSFEL
INTEGRACIÓN WEB PROPIA

Conecta tu página web a un POS con checkout y factura FEL.

Cualquier web hecha a mano, o por una IA, se conecta en tres pasos: un token, un archivo de catálogo y un comando. POSFEL importa productos, variantes e imágenes, cobra con su checkout alojado pidiendo NIT o consumidor final, descuenta el mismo stock que tu mostrador y emite la factura FEL certificada por la SAT en cada venta. Sin Shopify, sin WooCommerce y sin tocar tarjetas en tu web.Guía técnica →Skill para IAs

Crear cuenta gratisSin tarjeta · en 2 minutos
✓3 productos creados · 12 variantes · 7 imágenesSYNC
✓"Chaqueta Alpina Pro" publicado al marketplacePUBLICADO
✓posfel.map.json — IDs listos para tu checkoutMAPEO
#Venta web #1043 · Q214.00 · NIT 16897919FEL EMITIDA

Un push del instalador y una venta real · datos de demostración

Lo que la integración hace por tu web

Catálogo importado completo

Nombres, descripciones, precios, variantes, SKUs e imágenes; POSFEL re-hospeda las fotos en su CDN.

Un token, un comando

Generas el token en Configuración → Integraciones y corres posfel-sync push. Sin llaves de pasarelas, sin backend.

Checkout sin tarjetas en tu web

El botón Pagar redirige al checkout alojado: valida precios y stock reales y cobra con Stripe, Tilopay o CyberSource.

NIT o consumidor final

El checkout pide los datos del comprador y la factura FEL sale certificada por la SAT en cada venta.

Stock de verdad

Mostrador, marketplace y tu web descuentan el mismo inventario. Un re-sync jamás pisa el stock.

Revisión antes de crear

POSFEL analiza el manifiesto, muestra qué se crearía o actualizaría con sus errores, y solo crea cuando apruebas.

Hecha para IAs

Skill pública que Claude puede seguir de punta a punta: analizar tu código, generar el catálogo y cablear el checkout.

Guía técnica pública

Los pasos documentados (token, manifiesto, push, aprobación, checkout, venta) con reglas, límites y errores comunes.

Sin Shopify ni WooCommerce: cuándo conviene una web propia conectada a POSFEL

Cada camino para vender en línea en Guatemala tiene su costo oculto. Así se compara una web propia conectada a POSFEL con las alternativas más comunes:

  • Shopify: excelente tienda, pero la factura FEL, el inventario del mostrador y el cobro con pasarelas locales requieren apps aparte. Si ya estás ahí, la app de POSFEL para Shopify lo resuelve.
  • WooCommerce u otro constructor: plugins para pagos, plugins para facturación, un servidor que mantener y un inventario separado del físico.
  • Web propia + POSFEL: tu diseño, el que sea, y de pagos, facturación e inventario se encarga POSFEL. Tu web solo muestra productos y manda el carrito al checkout alojado. Ideal para webs hechas con una IA en una tarde.

Pasarelas de pago para tu página web en Guatemala

El checkout alojado cobra con la pasarela que tengas activa en tu tienda de POSFEL: Stripe, Tilopay (Guatemala y El Salvador, con tarjetas guardadas por cliente) o CyberSource de NeoNet (Visa y Mastercard locales, con devoluciones automáticas por API). Las comisiones son las de cada pasarela y las contratas tú; POSFEL no agrega porcentaje sobre la venta. Tu web nunca ve el número de tarjeta: cumple sin esfuerzo con la seguridad de pagos.

En el mismo checkout el comprador deja su NIT o elige consumidor final, elige envío a domicilio con tus tarifas por municipio o retiro en tienda, y al pagar recibe su factura FEL por correo y WhatsApp.

Precio de la integración

La integración de web propia viene desde el plan Pro de POSFEL (Q349 al mes), junto con Zoho Books, eBay, campañas y hasta 10 usuarios. Las cuentas nuevas prueban el plan Pro durante 30 días sin tarjeta, tiempo de sobra para conectar tu web y hacer las primeras ventas.

Cómo funciona, en seis pasos

PASO 1

Genera el token

En Configuración → Integraciones → Web propia creas un token de integración (empieza con pfi_).

PASO 2

Describe tu catálogo

Tu proyecto genera posfel-catalog.json con productos, variantes, precios, SKUs e imágenes. Una IA puede escribirlo leyendo tu código.

PASO 3

Corre el instalador

npx posfel-sync push envía el manifiesto; POSFEL lo analiza y te muestra qué se crearía o actualizaría.

PASO 4

Aprueba el análisis

Confirmas y POSFEL crea los productos, descarga las imágenes y devuelve el mapeo de IDs para tu checkout.

PASO 5

Cablea el botón Pagar

Tu web manda el carrito al checkout alojado de POSFEL con esos IDs. Sin tarjetas ni pasarelas en tu código.

PASO 6

Vende

Cada compra valida stock, cobra, descuenta inventario y emite la factura FEL certificada por la SAT.

Preguntas frecuentes

¿Qué necesito para conectar mi página web a POSFEL?

Tres cosas: una cuenta POSFEL con el marketplace habilitado, una pasarela de pago activa (Stripe, Tilopay o CyberSource) y el token de integración que generas en Configuración → Integraciones → Web propia. No necesitas backend propio ni conocimientos de pagos.

¿Necesito Shopify o WooCommerce?

No. La integración es para cualquier web hecha a mano o por una IA, en el framework que sea; POSFEL funciona con o sin Shopify. Si ya vendes en Shopify, usa la app de POSFEL para Shopify en su lugar.

¿Cómo cobra mi web si no integro ninguna pasarela?

Tu web redirige al checkout alojado de POSFEL con el carrito. Ahí se validan precios y stock reales, se piden los datos del comprador (incluido NIT o consumidor final) y se cobra con la pasarela de tu tienda. Tu web nunca toca tarjetas.

¿La factura FEL se emite sola?

Sí. Cada venta del checkout sale con su factura FEL certificada por la SAT automáticamente, con NIT o a consumidor final, y el PDF viaja por WhatsApp y correo al cliente.

¿Cómo detecta POSFEL mis productos, variantes e imágenes?

Tu proyecto genera un archivo posfel-catalog.json con el catálogo (nombres, descripciones, precios, variantes con sus opciones Color/Talla, SKUs e imágenes) y lo envías con el CLI posfel-sync. POSFEL lo analiza, te muestra qué se crearía o actualizaría con los errores y su corrección, y cuando apruebas crea los productos, descarga las imágenes a su CDN y te da el mapeo de IDs para tu checkout.

¿Quién administra el stock después de conectar?

POSFEL. El stock del manifiesto solo se usa al crear cada producto; después, cada venta del checkout de tu web, del mostrador o del marketplace lo descuenta en POSFEL, y un re-sync nunca lo sobreescribe.

¿Puede una IA hacer toda la integración sola?

Sí. Dale a Claude (u otra IA) la URL de la skill pública de POSFEL y tu token de integración: la IA analiza el código de tu web, genera el manifiesto, corre el instalador y cablea el checkout con los IDs devueltos.

¿Qué pasa cuando cambio precios o agrego productos en mi web?

Vuelves a correr posfel-sync push (o el botón Sincronizar ahora en POSFEL) y apruebas el análisis. Los productos existentes se actualizan (nombre, descripción, precio, imágenes) y los nuevos se crean; el stock nunca se pisa. Si quitaste productos, la opción removeMissing los desactiva en POSFEL.

Conecta tu web en una tarde.

Crea tu cuenta, genera el token en Integraciones y deja que tu IA haga el resto con la skill pública.

Crear cuenta gratis