Facturación electrónica de la DGI dentro de tu propio sistema

Cada documento que hay que emitir entra en una cola con su propio estado: pendiente, enviado, aceptado, rechazado. No se emite desde el botón que apretó el usuario, sino desde esa cola, y esa distinción es todo.

Significa que si la conexión se cae a mitad del envío, el documento no se pierde ni se duplica: queda en el estado que le corresponde y el sistema sabe exactamente qué hacer con él. Significa que un reintento no genera un segundo documento fiscal. Y significa que en cualquier momento puedes preguntarle al sistema cuántos documentos están trabados y por qué, en vez de descubrirlo a fin de mes.

Un rechazo tampoco es un callejón sin salida. El documento queda con el motivo del rechazo guardado, se corrige el dato que estaba mal y vuelve a la cola. Lo que nunca pasa es que un documento desaparezca sin dejar rastro.

• estado explícito por documento: pendiente, enviado, aceptado, rechazado
• reintento seguro: un envío repetido no crea un segundo documento
• motivo de rechazo guardado junto al documento, no en un log suelto
• la emisión se dispara desde la cola, no desde el clic del usuario

El impuesto parece un detalle de cálculo hasta que dos pantallas del mismo sistema muestran totales distintos por un centavo. Ahí deja de ser un detalle y pasa a ser un problema de confianza: si el cliente ve un número en la cotización y otro en la factura, el sistema perdió.

El origen casi siempre es el mismo: cada pantalla recalcula el impuesto por su cuenta, y el redondeo no cae igual en todas. La forma de evitarlo es decidir una sola vez cómo se compone el precio, guardarlo así, y que todas las pantallas lean ese valor en lugar de volver a calcularlo.

El resultado es un total invariante: el número que se cotizó es el que se factura y el que se cobra, sin explicaciones.

• el impuesto se resuelve una vez y se guarda, no se recalcula por pantalla
• el total de la cotización, la orden y la factura es el mismo número

La facturación se monta como un módulo aparte, detrás de su propio interruptor y apagado por defecto. Se deja corriendo en paralelo contra el ambiente de pruebas mientras el negocio sigue facturando como siempre, y solo se enciende cuando los documentos salen aceptados de forma consistente.

Ese periodo en paralelo es la parte que más se salta la gente y la que más problemas evita. Nadie debería estrenar su facturación electrónica un día de cierre de mes.

Si ya cobras por Yappy, las dos piezas se conectan: el pago confirmado del lado del servidor es lo que dispara la emisión del documento. No hay que acordarse de facturar.

Panamá lleva años ampliando la obligación de facturar electrónicamente, y el calendario y los detalles del régimen los fija la Dirección General de Ingresos, no nosotros. Antes de escribir una línea de código conviene confirmar con tu contador o directamente con la DGI qué te aplica a ti y desde cuándo.

Lo que sí podemos afirmar es la parte de ingeniería: el sistema queda preparado para emitir, para reintentar sin duplicar, para registrar cada estado y para adaptarse cuando cambie el proveedor autorizado o el formato. La regla la pone la DGI; nosotros hacemos que tu sistema pueda cumplirla sin rehacerse.