Cómo conectar tu sistema de ventas con la facturación electrónica en Panamá

Integrar es hacer que tu sistema de ventas le pase solo los datos de cada venta a un PAC. El PAC los valida con la DGI y te devuelve el CUFE, que es el número de esa factura. Nadie copia nada a mano.

Hay tres formas de lograrlo: usar el portal del PAC, usar un sistema que ya trae la conexión o construir una integración a medida. Cuál te conviene depende de cuántas facturas emites y de qué sistema usas hoy.

Antes de seguir, una aclaración. El facturador gratuito de la DGI no permite integración. Si quieres que tu punto de venta o tu tienda emitan solos, necesitas un PAC.

Qué significa “integrar”, con una comparación

Piensa en un restaurante. El mesero toma el pedido y se lo pasa a la cocina. No cocina él mismo.

Tu sistema de ventas es el mesero. El PAC es la cocina. Es una empresa privada autorizada por la DGI para recibir tus documentos, validarlos y darles la Autorización de Uso.

Así corre una venta:

1. Cobras en tu punto de venta o tu tienda en línea.
2. Tu sistema arma los datos de la venta y se los manda al PAC.
3. El PAC los revisa y los valida con la DGI.
4. El PAC te devuelve la factura autorizada, con su CUFE.
5. Tu sistema guarda el CUFE y le da al cliente su CAFE, el comprobante con código QR.

El CUFE es el Código Único de Factura Electrónica. Es como la placa de un carro: identifica una sola factura y no se repite.

Esa conversación entre tu sistema y el PAC se hace por una API. Una API es una ventanilla con reglas fijas. Tu sistema llega, pide algo en el formato correcto y recibe una respuesta. Todo pasa en segundos y sin que nadie lo vea.

Las 3 formas de conectarte

Forma	Cómo funciona	Para quién sirve	Punto débil
Portal web del PAC	Entras a la página del PAC y llenas cada factura a mano	Pocas ventas al mes	Doble digitación y errores
Sistema con integración lista	Tu punto de venta o ERP ya se conecta con ciertos PAC	Negocios con un sistema estándar	Solo funciona con los PAC que ese sistema soporta
Integración a medida por API	Un equipo técnico conecta tu sistema con el PAC que elijas	Volumen alto o sistema propio	Cuesta desarrollo y requiere buen soporte

Forma 1: el portal del PAC, a mano

Es la más simple. Pagas al PAC, entras a su página y emites cada documento a mano.

Se parece al facturador gratuito, pero sin los topes de B/.36,000.00 al año ni de 100 documentos al mes. Sirve si facturas poco y no tienes sistema. Su problema: tus ventas ya están en otro lado y las vuelves a escribir.

Forma 2: un sistema que ya trae la integración

Muchos puntos de venta y programas de facturación ya vienen conectados con algún PAC. Es como un celular que ya trae la tarjeta SIM puesta.

Es la opción más rápida. Pero hay una trampa. Ese sistema solo habla con los PAC que su fabricante programó. Si luego quieres cambiar de PAC, quizá no puedas.

Antes de comprar un sistema, pregunta con cuáles PAC trabaja y si cubre notas de crédito. Más abajo verás por qué.

Forma 3: integración a medida por API

Aquí un equipo técnico escribe la conexión entre tu sistema y el PAC. Es como construirle a tu casa una puerta con la medida exacta.

Sirve cuando tienes un sistema propio, una tienda en línea con reglas especiales o un ERP que nadie ha conectado. También cuando emites mucho y no puedes depender de pantallazos manuales.

Es la que más control te da. También es la que más requiere de una buena documentación del PAC. Si quieres saber cuándo conviene construir algo propio, mira nuestro servicio de software a medida.

Cómo elegir según tu volumen

No hay una cifra mágica. Hay preguntas que te llevan a la respuesta:

• ¿Cuántos documentos emites al mes? Si son pocos, el portal del PAC aguanta. Si ya cuentas las facturas por cientos, copiar a mano deja de tener sentido.
• ¿Ya tienes un sistema de ventas? Si usa un programa estándar, empieza por revisar si ya trae integración. No construyas lo que ya existe.
• ¿Tu sistema es propio o muy personalizado? Entonces lo normal es una integración a medida.
• ¿Vendes en varios canales? Local, tienda en línea y redes. Cada canal que factura es un punto que hay que conectar.

Si vendes en internet, mira también nuestra guía de cómo crear una tienda online en Panamá. Ahí se decide la plataforma, y esa decisión afecta cuánto cuesta conectarla después.

Qué datos necesita cada factura

El PAC no adivina nada. Tu sistema tiene que mandarle los datos completos y bien escritos. Si falta uno, el documento se rechaza.

Los campos exactos los define el PAC según la ficha técnica de la DGI. Pídele esa lista antes de programar. En general, cada documento lleva:

• Quién vende. Tu razón social, tu RUC y tu sucursal. Deben coincidir con lo que declaraste a la DGI.
• A quién le vendes. Si es una empresa o un consumidor final. Esa distinción la pregunta la DGI cuando te das de alta.
• Qué vendes. Cada producto o servicio, con su descripción, cantidad y precio.
• Cuánto impuesto lleva cada línea. No todo paga la misma tarifa: hay productos al 7%, otros con tarifa distinta y otros exentos. Por eso cada línea lleva la suya. Si quieres repasarlo, mira la guía del ITBMS y el Formulario 430.
• Cómo te pagaron. Efectivo, tarjeta, transferencia u otro.
• Qué tipo de documento es. En el SFEP se emiten tres: facturas, notas de crédito y notas de débito.

Tu sistema también necesita tener a mano tu certificado de firma electrónica y los datos de acceso al PAC. Si aún no los tienes, el trámite está en la guía de facturación electrónica.

Qué pasa si se cae el internet

Es la pregunta que todo dueño de tienda hace. Y con razón: si el PAC no responde, no puedes validar.

La ley lo previó. Puedes facturar en modo contingencia por hasta 72 horas. Contingencia es el plan B: como una planta eléctrica cuando se va la luz.

En la práctica, tu sistema debe saber hacer tres cosas:

1. Detectar la caída. Si el PAC no contesta, el sistema debe avisar y activar el modo contingencia.
2. Seguir vendiendo. El cliente no tiene por qué esperar. El sistema guarda cada venta en cola.
3. Enviar todo al volver la conexión. Las ventas pendientes se mandan al PAC en orden, antes de que se acaben las 72 horas.

Un sistema mal integrado se queda congelado cuando el internet falla. Uno bien integrado casi no se nota. Pregunta cómo maneja este caso antes de contratar. Y pruébalo desconectando el cable.

Recuerda también otros dos datos. El PAC valida el documento y lo manda a la DGI dentro de las 48 horas siguientes. Y guarda copias por 60 días continuos. Tu sistema debe guardar las suyas, porque la ley exige conservar las facturas el tiempo que ella indica.

Errores comunes de integración

Casi todos los problemas se repiten. Mejor conocerlos antes.

Facturas duplicadas

Pasa cuando el sistema manda la venta, no recibe respuesta a tiempo y vuelve a mandarla. El resultado son dos facturas por una sola venta.

La solución es que cada venta tenga un identificador propio. Si el sistema reintenta, manda el mismo identificador y el PAC sabe que es la misma venta. Es como numerar los pedidos del restaurante.

Notas de crédito mal conectadas

Las devoluciones y las anulaciones no se borran. Se corrigen con una nota de crédito, que es una factura al revés: cancela total o parcialmente la original.

Muchas integraciones solo programan la factura y se olvidan de la nota. Entonces el primer día que un cliente devuelve algo, hay que hacerlo a mano. Pide que la nota de crédito esté en el alcance desde el inicio. Y que quede ligada a la factura original.

Redondeo del ITBMS

Imagina que cada producto lleva su impuesto con decimales. Si tu sistema redondea de un modo y el PAC de otro, el total no cuadra. Por centavos, el documento puede salir rechazado.

La solución es definir una sola regla de redondeo. Hazlo línea por línea o sobre el total, pero igual en todas partes. Y pruébalo con casos reales: descuentos, varios productos y precios con decimales.

Catálogo de productos desordenado

Si tu catálogo tiene productos duplicados, sin descripción o con impuestos mal asignados, la integración los repite en cada factura. El PAC no corrige tus datos. Los valida y los rechaza.

Antes de conectar, limpia el catálogo. Un producto, un nombre, un impuesto. Es un trabajo aburrido, pero ahorra semanas de problemas.

Qué preguntarle a un PAC antes de contratar

La DGI publica el listado oficial de PAC autorizados. Cambia seguido, así que consúltalo ahí. Primero confirma que el proveedor esté en esa lista. Después hazle estas preguntas:

• ¿Tienen una API documentada? Pide ver la documentación antes de pagar. Si no existe o es confusa, tu integración será lenta y cara.
• ¿Hay ambiente de pruebas? Es una copia de práctica donde emites facturas de mentira. Sin ella, tus errores los pagas con documentos reales.
• ¿Cuánto cobran por documento? Pregunta si se cobra por factura, por mes o por paquete. Pregunta también si las notas de crédito cuentan igual.
• ¿Qué soporte dan? Pregunta cuándo atienden, por qué canal y quién resuelve un error técnico. A las 6 de la tarde de un viernes, eso importa.
• ¿Qué hacen en contingencia? Que te expliquen su procedimiento paso a paso.

Checklist antes de salir a producción

Producción es cuando ya facturas de verdad. Antes de llegar ahí, revisa esta lista:

• Hiciste la declaración jurada de adopción y tienes tu firma electrónica.
• Tus datos del RUC en el sistema coinciden con los de la DGI.
• Probaste facturas en el ambiente de pruebas, con casos normales y raros.
• Probaste notas de crédito ligadas a su factura original.
• El redondeo del ITBMS cuadra con el PAC en todos tus casos de prueba.
• El catálogo de productos está limpio y con el impuesto correcto.
• Cada venta tiene un identificador propio para evitar duplicados.
• Simulaste una caída de internet y el modo contingencia funcionó.
• El cajero sabe entregar el CAFE y qué hacer si el sistema falla.
• Tu contador sabe que cambió el flujo y recibe los reportes que necesita.

Ese último punto es el que más se olvida. La integración la hace un técnico, pero los números caen en la contabilidad. Si no hablan entre sí, aparecen diferencias al declarar. Para eso existe nuestra área de contabilidad e impuestos.

Lo que se conecta con esto

• Facturación electrónica en Panamá: PAC, CUFE y los nuevos límites
• ITBMS en Panamá y el Formulario 430
• Cómo crear una tienda online en Panamá
• Cuánto cuesta una página web en Panamá

Nosotros lo hacemos por ti

La mayoría de las integraciones fallan porque las hace solo un lado. El programador conecta el sistema pero no sabe qué exige la DGI. El contador sabe la norma pero no ve por qué el sistema rechaza una factura.

En BCG cubrimos los dos lados. Tenemos equipo de contabilidad y equipo de desarrollo propio. Con ese equipo construimos para AW Seguros una plataforma de venta de seguros en línea. Y Kioskito (kioskito.app) es un producto propio.

Del lado contable, nos encargamos de la declaración jurada, la firma electrónica y el ITBMS desde contabilidad e impuestos. Del lado técnico, conectamos tu sistema con el PAC desde software a medida.

Tú no tienes que explicarle a un programador qué es una nota de crédito. Tampoco tienes que explicarle a un contador qué es una API. Escríbenos y lo resolvemos juntos.