Biblioteca › Solución de problemas › Facturación
La factura sale mal: ITBMS, numeración y el PAC
Los cuatro atascos reales de la facturación electrónica en Panamá: el impuesto que no aparece, el botón de emitir que no hace nada, el número de documento que se desincroniza con el proveedor y el rechazo de la DGI. Cada uno con el mensaje exacto que vas a ver en pantalla.
La factura sale sin impuesto
«Todas las líneas nacen en Exento (0%) y yo sí cobro ITBMS»
Qué ves. Agregas una línea a la factura o a la cotización y el impuesto aparece como Exento (0%). Puedes cambiarlo a mano línea por línea, pero al día siguiente vuelve a pasar lo mismo.
Por qué pasa. Adelys no adivina si eres responsable de ITBMS: lo pregunta una sola vez, en una casilla, y todo lo demás la obedece. Esa casilla se llama Cobro ITBMS y está en Contabilidad → Calendario fiscal. Viene apagada de fábrica, y apagada significa exento. No es un descuido del producto: en Panamá hay muchísimos contribuyentes que no cobran ITBMS, y nacer cobrándolo sería peor error que nacer sin él.
Qué hacer. Abre Contabilidad → Calendario fiscal y marca Cobro ITBMS, en la fila «Aplican a este contribuyente». Desde ese momento las líneas nuevas nacen con la tasa configurada. Las facturas que ya emitiste no cambian — y no deben cambiar: un documento con validez fiscal no se reescribe.
«La cotización decía 7 % y la factura salió exenta»
Qué ves. Convertiste una cotización en factura y los importes no coinciden: la cotización llevaba impuesto y la factura no.
Por qué pasa. Esto ocurría cuando el impuesto de las cotizaciones estaba escrito aparte del de facturación. Hoy hay una sola regla: en Cotizaciones → Opciones → Impuesto por defecto, la opción «Automático — según Cobro ITBMS de Contabilidad» hace que la cotización siga exactamente la misma casilla que la factura.
Qué hacer. Si alguien puso ahí una tarifa fija distinta, ese valor manda sobre la casilla — es una decisión explícita y el CRM la respeta. Devuélvelo a Automático y las dos pantallas vuelven a decir lo mismo. Y recuerda: siempre puedes cambiar el impuesto línea por línea, para el caso de la venta puntualmente exenta.
«Cobro ITBMS al 10 % y me sigue poniendo 7 %»
Qué ves. Las líneas nacen con la tasa que no es.
Por qué pasa. La casilla decide si se cobra; la tasa la decide un ajuste global del CRM. Son dos cosas separadas a propósito, porque en Panamá conviven tarifas distintas.
Qué hacer. Cambia la tasa global en Ajustes. Para las ventas con tarifa especial, elige el impuesto en la propia línea: el catálogo de Cotizaciones trae ITBMS, ITBMS 10% y Exento.
No me deja emitir
«Pulso Emitir y sale un aviso rojo con un dato que falta»
Qué ves. Un aviso con la primera cosa que falta. Estas son las que el CRM comprueba antes de mandar nada al proveedor:
- «Configura el RUC y dígito verificador del emisor (pestaña Configuración).»
- «Configura el nombre o razón social del emisor.» · «Configura la dirección de la sucursal del emisor.»
- «El receptor necesita nombre o razón social.»
- «Un receptor "Contribuyente (con RUC)" requiere RUC.» (con el tipo que hayas elegido)
- «Falta el DV del receptor. Sal del campo RUC o pulsa la lupa para traerlo del padrón de tu PAC.»
- «Un receptor extranjero requiere pasaporte / ID.»
- «Agrega al menos una línea de detalle.» · «Línea 2: falta la descripción.» · «Línea 2: la cantidad debe ser mayor a 0.»
- «Las notas de crédito/débito referenciadas requieren el CUFE del documento original.»
- «El total de la factura debe ser mayor a 0.»
Por qué pasa. Son requisitos de la DGI, no manías del CRM. Se comprueban aquí para que no gastes una llamada al proveedor —que se paga por transacción— en un documento que iba a rechazar.
Qué hacer. Los tres primeros se arreglan una sola vez en Facturación → Configuración fiscal y no vuelven a salir. El DV del receptor es el que más aparece: casi ningún cliente lo da, y no hace falta pedírselo — escribe el RUC, sal del campo o pulsa la lupa, y el dígito verificador llega del padrón de tu proveedor.
«Dice Escribe primero el RUC»
Qué ves. «Escribe primero el RUC.» al pulsar la lupa de consulta.
Por qué pasa. La consulta al padrón necesita el RUC para buscar. Sin él no hay nada que preguntar.
Qué hacer. Escribe el RUC y vuelve a pulsar. Si sale bien verás «DV 47 — Ferretería El Tornillo, S.A.» con el nombre del contribuyente; si el proveedor no ofrece la consulta, «Validación de RUC en línea disponible en Fase Producción (PAC).» y hay que escribir el DV a mano.
«Dice Esta factura ya fue autorizada, o Solo se anulan documentos autorizados»
Qué ves. Uno de esos dos avisos, o al borrar en bloque: «Solo se pueden eliminar borradores o documentos rechazados; los emitidos se anulan.»
Por qué pasa. Un documento autorizado por la DGI tiene validez fiscal: no se edita ni se borra, se anula y queda constancia de la anulación. Si el CRM permitiera reescribirlo en silencio, tu contabilidad dejaría de valer como prueba.
Qué hacer. Para corregir un documento autorizado, anúlalo (con motivo) y emite uno nuevo, o emite una nota de crédito referenciando su CUFE. Los borradores y los rechazados sí se pueden mandar a la papelera.
Si al editar sale «Este registro no puede modificarse en su estado actual» (DAT-0103), la causa es la misma familia: documento autorizado, período contable cerrado o planilla ya pagada.
El proveedor (PAC) rechaza
«Dice que mi proveedor de facturación rechazó las credenciales»
Qué ves. «Tu proveedor de facturación rechazó las credenciales» con «Revisa tu credencial en Facturación → Configuración; puede estar vencida o ser de otro ambiente.» (PAG-0502).
Por qué pasa. El proveedor respondió que no te conoce. Cuatro causas, y la tercera es la que más tiempo hace perder:
- El token venció.
- El token es de otra cuenta o se copió a medias.
- Ambiente cruzado: token de pruebas apuntando a producción, o al revés. Un token recién emitido que da 401 casi siempre es esto.
- La suscripción con el proveedor no está al día.
Qué hacer. En Facturación → Configuración fiscal, comprueba que el selector Ambiente (Pruebas (2) o PRODUCCIÓN (1)) coincida con el token que pegaste, vuelve a pegarlo entero y pulsa Probar conexión. Esto no es un fallo de Adelys: la credencial es tuya y con tu proveedor, y el mensaje lo dice claro para que no pierdas el día esperando que se arregle solo.
«Dice que no encuentra la API de mi proveedor»
Qué ves. «No encontramos la API de tu proveedor de facturación» con «Verifica la URL y que el proveedor seleccionado sea el correcto.» (PAG-0503).
Por qué pasa. La dirección respondió que esa ruta no existe: la URL base está mal escrita, o el proveedor elegido en el selector no es el que atiende esa dirección. Cada PAC publica rutas distintas, así que apuntar el adaptador de uno a la URL de otro falla siempre.
Qué hacer. Copia la URL tal cual la publica tu proveedor (sin barra final de más) y revisa el selector de proveedor. Si tu PAC no está en la lista, hay que escribir su adaptador: escríbenos.
«Dice La facturación electrónica no está configurada»
Qué ves. «La facturación electrónica no está configurada» con «Pídele al administrador que configure los datos fiscales.» (PAG-0501).
Por qué pasa. No hay conexión con el PAC guardada. Cada empresa factura con su propia cuenta ante su proveedor: no se comparte ninguna credencial entre clientes de Adelys.
Qué hacer. La pestaña Configuración fiscal solo la ve un administrador. Ahí se pegan la URL y el token, se pulsa Probar conexión y se guarda.
«La DGI rechazó el documento»
Qué ves. «El PAC rechazó el documento.», normalmente con el motivo que devolvió el proveedor, o la ficha «La entidad fiscal rechazó el documento» (PAG-0102). La factura queda en estado rechazada, nunca como autorizada.
Por qué pasa. Los datos del documento no cuadran: RUC o dígito verificador equivocados, montos que no suman, o un problema de secuencia.
Qué hacer. Corrige y reemite. Reintentar sin cambiar nada da exactamente el mismo resultado — el error es del dato, no del sistema. Un documento rechazado se puede editar y mandar a la papelera; no arrastra número consumido.
«Dice Demasiadas operaciones de facturación seguidas»
Qué ves. «Demasiadas operaciones de facturación seguidas, intenta en un momento».
Por qué pasa. Hay un tope por minuto en las llamadas al PAC. Existe por dinero: cada llamada —emitir, anular, consultar RUC, descargar el CAFE, probar conexión— se paga por transacción en tu plan con el proveedor, así que un bucle accidental te consume el saldo.
Qué hacer. Espera un minuto. Si te pasa a menudo sin haber hecho nada raro, revisa que no tengas dos pestañas del CRM emitiendo a la vez.
El número del documento no cuadra
«Puse 13 en Próximo número, emití, y me quedó 15»
Qué ves. El número que escribiste no es el que salió, o el campo Próximo número aparece gris y no te deja escribir, con la nota «Lo lleva tu proveedor. Adelys solo anota el número que él devuelve.»
Por qué pasa. Hay dos modos de numeración y solo uno usa ese campo:
- Numera Adelys — el CRM reserva el consecutivo y lo manda con el documento. Próximo número manda.
- Numera el proveedor — Adelys no envía número: lo asigna el PAC y el CRM anota el que devuelve. El campo se muestra deshabilitado justamente para que nadie crea que decide algo.
Qué hacer. Elige el modo en Configuración fiscal → Numeración y ambiente según lo que hayas acordado con tu proveedor. Si facturas también desde el panel del proveedor, deja que numere él: es la única forma de que las dos vías no choquen.
«El número de Adelys no coincide con el que muestra mi proveedor»
Qué ves. Al pulsar Verificar en un documento autorizado, uno de estos:
- «Número corregido al del PAC: 000000015» — se ajustó solo, no hay nada que hacer.
- «El proveedor informa el número 000000012, pero ya hay un documento autorizado con el 000000015. Un correlativo no retrocede, así que Adelys no lo aplicó. Revisa la serie con tu proveedor y, si el número correcto es ese, corrígelo a mano.»
- «Tu proveedor no informa el número de este documento. Descarga el CAFE, mira el número que trae impreso y escríbelo con Corregir nº.»
- «El PAC no reconoce ese CUFE.» o «Sin conexión con el PAC configurada.»
Por qué pasa. La serie se desfasa cuando se emite por fuera del CRM —desde el panel del proveedor, desde otro sistema— o cuando una autorización se completó pero su respuesta no llegó de vuelta. Adelys nunca hace retroceder un correlativo por su cuenta: sería mucho peor que dejarlo señalado.
Qué hacer. Descarga el CAFE del documento y mira el número impreso: ese es el bueno. Después pulsa Corregir nº y escríbelo. Si el CRM detecta que ese número ya lo tiene otro documento del mismo tipo, te lo advierte antes de aplicarlo.
Para cortar el problema de raíz, pasa la numeración al proveedor (arriba).
«El CAFE que descargo no es el de mi proveedor»
Qué ves. «No se pudo traer el CAFE del proveedor. Se descarga la representación interna de Adelys.»
Por qué pasa. El CRM intenta primero traer el documento oficial del proveedor. Si no lo consigue —sin conexión, credencial caída, el proveedor no expone la descarga— genera su propia representación para que no te quedes sin nada, y te avisa de que no es la oficial.
Qué hacer. Para lo que tenga que ir a un tercero (auditoría, un cliente que lo exige), usa el del proveedor: arregla la conexión y vuelve a descargar. La representación interna sirve para consulta y archivo propio.
Si nada de esto era tu caso
Los errores de facturación llevan su código en la propia ficha: PAG-0501 (no configurado), PAG-0502 (credenciales), PAG-0503 (URL o proveedor), PAG-0102 (rechazo de la entidad fiscal), DAT-0103 (estado que no admite cambios). Pulsa el código para copiarlo. Cuando el mensaje viene del proveedor, el CRM te muestra además qué hacer en la línea siguiente: esa frase es la que hay que leer primero.
Sigue con
- Facturación electrónica y cartera de cobros — el flujo completo, de la configuración al cobro.
- Contabilidad: del asiento al cierre del año — dónde vive el calendario fiscal y qué hace cada casilla.
- Cotizaciones de principio a fin — para que la cotización y la factura digan lo mismo desde el principio.