Qué es Puca
Puca procesa las facturas electrónicas que llegan a la DIAN a nombre de Gutiérrez Group
y de las empresas a las que les llevamos la contabilidad: trae el XML de cada factura,
le asigna cuenta PUC a cada ítem, calcula la retención en la fuente y entrega los
archivos listos para Contai.
Todo se hace sobre la empresa elegida en el selector del encabezado.
Cada empresa tiene su propio plan de cuentas, diccionario, lotes y archivos; nada se
mezcla entre ellas. Dos pestañas del navegador pueden estar en empresas distintas.
Procesar un mes, paso a paso
- Descarga del portal de la DIAN el Excel de facturas recibidas del período.
- En Lotes → Cargar Excel de la DIAN, súbelo. Si trae facturas de otra
empresa (otro NIT receptor), se rechaza entero: revisa el selector.
- Abre el lote y ejecuta 1. Traer facturas de la DIAN.
- Ejecuta 2. Asignar cuenta PUC.
- Ejecuta 3. Descargar PDFs (puede ir antes o en paralelo: no depende de los otros dos).
- Revisa la grilla de ítems, corrige lo que haga falta y pulsa Guardar cambios.
- Descarga Detalle, Consolidado y Plano Contai.
Cada paso se puede detener y volver a ejecutar; lo que ya quedó hecho no se repite.
Paso 1: Traer facturas de la DIAN
Por cada CUFE consulta a la DIAN el XML de la factura, firmando con el certificado de la
empresa. Del XML salen el encabezado, los ítems y las responsabilidades fiscales del
proveedor (con eso se decide su régimen de retención).
Las que fallan aparecen en Facturas con problema, al final del lote.
Las causas más comunes: certificado vencido o no cargado (ver Empresas) o la DIAN
caída; en ese caso basta con volver a ejecutar el paso más tarde.
Paso 2: Asignar cuenta PUC
Busca la cuenta de cada ítem en este orden y se detiene en el primero que acierte:
- Diccionario exacto: mismo proveedor y misma descripción.
- Diccionario similar: mismo proveedor y descripción parecida.
- Reglas fijas: peajes, si la empresa tiene configurada la cuenta.
- IA: solo para lo que quedó sin resolver.
La columna Origen de la grilla dice de dónde salió cada cuenta. Lo que
clasifica la IA entra al diccionario sin revisar; conviene mirarlo antes de exportar.
Si el paso se niega a correr, la empresa no tiene plan de cuentas: súbelo en Ajustes.
Paso 3: Descargar PDFs
Baja la representación gráfica de cada factura. Se guardan por año y mes de emisión, con
el nombre DDMM PROVEEDOR PREFIJOFOLIO.pdf, y se pueden bajar todos en un ZIP
desde el lote o desde la pestaña PDFs.
Si alguna queda sin PDF, el lote muestra un aviso con la lista. Se puede reintentar.
Revisar y corregir ítems
La grilla del lote se filtra por proveedor, origen, cuenta PUC, tipo de IVA, concepto y
estado de la retención, o por texto libre. Solo los que necesitan revisión deja
los que no tienen cuenta o la tienen fuera del plan.
Al cambiar una cuenta y guardar, la corrección entra al diccionario como
revisada: la próxima factura igual se resuelve sola y además sirve de
ejemplo para la IA.
El número de factura abre su ficha (encabezado, líneas, XML y PDF) sin salir del lote.
Los anchos de las columnas se ajustan arrastrando el borde del encabezado; doble clic
los restablece.
Retención en la fuente
Se calcula con las tarifas del plan de cuentas de la empresa y el régimen del proveedor:
| Régimen | Qué aplica |
| Jurídica / PN declarante | Tarifa de la columna PJ |
| PN no declarante | Tarifa de la columna PN |
| Autorretenedor (O-15) | No se retiene |
| Régimen simple (O-47) | No se retiene |
La base mínima se compara contra la factura completa, y se suman las
facturas del mismo proveedor el mismo día. La base de cada línea es su subtotal sin IVA,
menos descuentos y más recargos (sin contar propinas).
Se calcula al descargar, no se guarda: corregir una cuenta o un régimen se refleja en la
siguiente descarga. El valor y la cuenta 236X se pueden editar a mano en la grilla; la
línea queda marcada manual hasta que vuelva a coincidir con el cálculo.
Esta app no calcula retención de IVA.
Cruzar medio de pago
Sube el Excel de Gerencia Financiera (hojas Bancol, TDC, Cajas y CXC Socios) desde la
grilla del lote. Cada factura se asigna al medio donde haya un egreso por su total, o por
su total menos la retención, entre unos días antes de la emisión y unos meses después.
Nunca pisa un medio ya elegido, y si hay empate se deja sin asignar para que lo elijas a
mano. El archivo no se guarda en el servidor.
Archivos de salida
- Detalle.xlsx: un renglón por ítem, con cuenta, IVA y retención.
- Consolidado.xlsx: totales por factura.
- Plano Contai.xlsx: asiento por ítem (gasto, IVA descontable,
contrapartida) y una línea de retención por factura y cuenta 236X.
Contai consolidado agrupa las líneas.
Antes de descargar, junto a los botones, la app dice cuántas líneas no quedarían bien
contabilizadas (sin cuenta, cuenta fuera del plan o retención sin 236X). Si un asiento no
cuadra, el plano no se genera en vez de entregar un archivo malo.
Diccionario PUC
Traduce «esta descripción, de este proveedor» a una cuenta contable. Cada entrada evita
una consulta a la IA.
- Lo que clasifica la IA entra solo, sin revisar.
- Lo que se corrige en la grilla entra revisado.
- Las revisadas más usadas se le pasan a la IA como ejemplo.
Usos cuenta ítems distintos resueltos por esa entrada; al hacerle clic muestra
dónde se usó. La casilla del encabezado marca o desmarca todos los visibles.
Importar xlsx se puede repetir sin duplicar.
Históricos y PDFs
Las dos pestañas muestran las facturas por carpetas de año y mes de emisión.
Históricos abre la ficha de la factura con su XML; PDFs muestra solo las
que tienen PDF, lo abre directo y permite bajar el ZIP del período.
Gerencia financiera
Reemplaza el Excel de Gerencia Financiera de cada empresa. Cada movimiento tiene una
cuenta (dónde está la plata: Bancolombia, la tarjeta, la caja) y un centro
(para quién o por qué: la empresa, la CxC de un socio, el aporte a un proyecto).
- Libro: los movimientos, del más reciente al más viejo, con el saldo corrido de su
cuenta. El saldo lo calcula la app: no hay columna SALDO que se pueda romper. Filtrar
por fecha no cambia el saldo de cada fila.
- Consolidado: entra y sale por centro y por cuenta, con los mismos filtros. Es la
hoja Consolidado del Excel, pero sobre todas las cuentas y sin centros que se queden por
fuera por no estar en la lista.
- Soporte: cada salida del libro está pendiente hasta que se enlaza a su factura o
se marca «No aplica» (GMF, cuota de manejo). El enlace lo pone «Cruzar medio de pago» en el lote:
cruza las facturas contra las salidas de las cuentas que tienen medio de pago y deja cada movimiento
apuntando a su factura (clic para abrirla). Al importar, el «N/A» de la columna FACT ELECT entra
como «No aplica».
- Gastos del mes: lo que toca pagar según los gastos recurrentes (se importan de la hoja
«Gastos Mes», sin las columnas de usuarios y claves) y su estado: pendiente, vencido, parcial o
pagado. «Registrar pago» abre el libro con el movimiento listo; «Enlazar existente» muestra
las salidas del mes que ya están en el libro (las del mismo valor primero) para marcar una como
el pago. La ✕ junto a un pago quita el enlace sin borrar el movimiento.
- Conciliación: elige la cuenta y sube el PDF del extracto de Bancolombia (cuenta de ahorros o
tarjeta de crédito). La app lo cruza con el libro por valor y fecha (primero la misma fecha, después
hasta 3 días de diferencia). Antes de confirmar puedes corregir el cruce: «Quitar» deshace una pareja
y «Emparejar con» une lo que falta con un movimiento del libro, aunque tenga otra fecha o valor.
Lo que coincide queda conciliado
(✓ junto al saldo en el Libro), lo que está en el banco y no en el libro se puede crear (sumado por
familia, como los abonos de intereses del mes, o línea por línea) y lo que está en el libro y no en el
banco queda listado para revisarlo. Al confirmar se anota el corte con el saldo del extracto. De la
tarjeta solo entran las compras nuevas del período (cuota 1), no las cuotas de compras anteriores.
Si el PDF no cuadra con su propio resumen, la app lo rechaza. Al confirmar se guardan el PDF (enlace
«PDF» en la tabla de cortes) y la foto de la conciliación: cómo quedó el cruce ese día, quién
lo hizo, qué se creó y qué quedó pendiente. La foto no cambia aunque el libro cambie después. El corte
también se puede anotar a mano, sin PDF ni foto.
- Cuentas y centros: crear cuentas, cambiarles el saldo inicial y el medio de pago con que
cruzan, renombrar centros y fusionar los que quedaron escritos de dos formas.
- Importar Excel: reconoce las hojas con FECHA, CONCEPTO, ENTRA y SALE, y compara el
saldo que calcula con la columna SALDO del Excel antes de importar. Una fila sin fecha
toma la de arriba; los totales y las filas sin valor se saltan. Volver a importar una
cuenta que ya existe exige marcar «Reemplazar». El archivo no se guarda.
Ajustes de la empresa
- Plan de cuentas y retenciones: se sube el archivo de la empresa
(hoja «Reporte Retenciones»). Hay que volver a subirlo cada año, cuando
cambia la UVT. Las cuentas que salen del archivo se desactivan, no se borran.
- Régimen de proveedores: la app lo toma del RUT que viene en el XML o lo
infiere del NIT. Ante la duda asume PN no declarante. Confirmar lo saca de la
lista de supuestos.
- Parámetros: cuentas de IVA, contrapartida y peajes de la empresa, y
parámetros de la IA (estos valen para todas). Aplican al siguiente proceso.
Empresas y certificados
Una empresa se crea con su NIT sin dígito de verificación (no se puede cambiar después) y
su nombre. Recién creada no tiene plan de cuentas ni cuentas del plano: configúralas en
Ajustes antes de procesar.
El certificado de firma de la DIAN (.p12) se carga en Empresas → Cargar
certificado, con su clave y la clave de certificados del equipo. Se rechaza si la clave
no lo abre, si está vencido o si es de otro NIT. Al entrar, la app avisa de los que vencen
en 30 días o menos.
Roles y permisos
Cada usuario tiene un rol: admin, editor o lector. El admin puede todo y es el
único que crea usuarios y decide qué puede el editor y el lector (pestaña Usuarios). Un editor o
lector también se puede limitar a ciertas empresas. Si te falta un permiso, el botón no aparece y,
si igual lo intentas, la app lo rechaza. Así está configurado hoy:
Bitácora
Registro de todo lo que cambia algo o descarga archivos, en todas las empresas: cargar o
borrar lotes, lanzar procesos, corregir ítems, editar el diccionario, proveedores,
parámetros, empresas y certificados, descargas de planos y ZIPs, y cada entrada o intento
de entrada. Cada fila dice quién (el usuario con el que entró), cuándo, en qué empresa, qué
se mandó y si salió bien o fue rechazado. Las claves y el contenido de los archivos no se
guardan. Se filtra por empresa, usuario, acción y fecha, y se descarga en CSV.
Problemas frecuentes
- «El Excel trae facturas de otra empresa»
- El selector del encabezado está en otra empresa. Cámbialo y vuelve a cargar.
- El paso 1 falla en todas las facturas
- Revisa el certificado de la empresa en Empresas. Si está vigente, la DIAN puede
estar caída: reintenta más tarde.
- El paso 2 no corre o deja ítems sin cuenta
- Falta el plan de cuentas o se agotó el cupo de la IA. Lo que no se resolvió se puede
asignar a mano o reintentar después.
- Una retención salió en cero
- Mira el régimen del proveedor (autorretenedor y régimen simple no retienen) y si la
factura llega a la base mínima.
- El plano Contai no se descarga
- Algún asiento no cuadra. El aviso junto a los botones dice qué líneas revisar.
Nada coincide con la búsqueda.