Puca Gutiérrez

Procesamiento de facturas electrónicas

PucaGutiérrez Group

Cargar Excel de la DIAN

El mismo archivo que se descarga del portal de la DIAN (.xlsx).

Lotes

#LoteCreadoFacturasCon XMLCon PDF

1. Traer facturas de la DIAN

Descarga el XML de cada CUFE y extrae los ítems.

2. Asignar cuenta PUC

Busca primero en el histórico; solo usa IA para lo que no encuentra.

3. Descargar PDFs

Independiente: no requiere los pasos 1 y 2.

Descargar ZIP

Ítems

FacturaProveedorDescripciónCant.Precio IVAIVA %Cuenta PUCTipo IVA RetenciónMedio de pagoOrigen

Facturas con problema

CUFEProveedorXMLPDFDetalle

Facturas históricas

Los XML se guardan en XMLs/AAAA/MM/ con el mismo nombre que los PDFs: DDMM PROVEEDOR PREFIJOFOLIO.xml, según la fecha de emisión. Haz clic en una factura para ver su XML.

EmisiónFactura ProveedorTotal ArchivoLote Soportes

PDFs de facturas

Los PDF que descarga el paso 3 se guardan en PDFs/AAAA/MM/ con el nombre DDMM PROVEEDOR PREFIJOFOLIO.pdf, según la fecha de emisión. Haz clic en una factura para abrir su PDF.

Descargar ZIP
EmisiónFactura ProveedorTotal ArchivoLote Soportes

Gerencia financiera

El libro de caja de la empresa: cada movimiento va a una cuenta (dónde está la plata: banco, tarjeta, caja) y a un centro (para quién o por qué: la empresa, una CxC de socio, un aporte a un proyecto). El saldo lo calcula la app; no se digita.

FechaCuentaCentroConcepto EntraSaleSaldoSoporte

Entra y sale por centro y cuenta, con los filtros de arriba (por ejemplo, un rango de fechas o solo Bancolombia y la tarjeta, como la hoja Consolidado del Excel).

Cuentas

NombreTipoMedio de pago Saldo inicialSaldo MovimientosÚltimo

Centros

Si un mismo centro quedó escrito de dos formas («Aporte Mr Odd» y «Aporte Mr. Odd»), fusiónalo: sus movimientos pasan al otro y el repetido desaparece.

CentroMovimientosNeto

Lo que toca pagar en el mes según los gastos recurrentes. «Registrar pago» lleva al libro con el movimiento listo; al guardarlo, el gasto queda pagado.

DíasTipoDescripciónCentroValor EstadoPagos

Gastos recurrentes

TipoDescripciónValorPeriodicidad Meses Día desdeDía hastaSoporteCentroCuentaActivo

Sube el PDF del extracto de Bancolombia (cuenta de ahorros o tarjeta de crédito) y la app lo cruza con el libro: lo que coincide queda conciliado, lo que está en el banco y no en el libro se puede crear, y lo que está en el libro y no en el banco queda a la vista. También puedes anotar el saldo de un corte a mano.

CorteSaldo extractoSaldo librosDiferencia ExtractoNota

Sube la «Gerencia Financiera» de la empresa. La app reconoce cada hoja con columnas FECHA, CONCEPTO, ENTRA/SALE (o INGRESO/EGRESO) y compara su saldo final con la columna SALDO del Excel. Vienen marcadas las hojas visibles. El archivo no se guarda.

HojaCuentaTipoMovimientosPeríodo CentrosSaldo calculadoSaldo en el Excel

Diccionario PUC

Traduce la descripción de un ítem a su cuenta contable. Cada entrada evita una consulta a la IA, y marcar «revisado» hace que además se use como ejemplo.

Exportar
NITProveedorDescripciónCuenta PUC Tipo IVAUsos

Empresas

Cada empresa tiene su propio plan de cuentas, diccionario, lotes y archivos. El NIT va sin dígito de verificación y no se puede cambiar después. «Servicio XML DIAN» es la URL del firmador; vacío usa el de la VPS. El certificado de firma de cada empresa se carga aquí y lo guarda el firmador, no la app; pide la clave de certificados, que es distinta de la de entrada.

NITNombreServicio XML DIANCertificado DIAN

Plan de cuentas y retenciones

Se cargan desde el archivo de la empresa (el de GG es Puc_ReteGG.xlsx), hoja «Reporte Retenciones». Reemplaza el plan de cuentas y las tarifas de esta empresa; las cuentas que ya no estén en el archivo se desactivan, no se borran. Súbelo de nuevo cada año cuando cambie la UVT.

CuentaConcepto Jurídica / PN decl.PN no declaranteObservaciones

Régimen de proveedores

Define qué columna de tarifas aplica. La app lo infiere del NIT; confirmar uno lo saca de la lista de supuestos y no se vuelve a preguntar.

NITProveedorFacturasRégimenEstado

Parámetros de procesamiento

Aplican al próximo job que se ejecute; no hay que reiniciar nada. Las cuentas son de esta empresa; los de la IA valen para todas. La API key de la IA no se edita aquí: vive en el servidor.

Bitácora

Todo lo que cambia algo o descarga archivos, en todas las empresas: quién, cuándo, en qué empresa, qué se mandó y si salió bien. Las claves y el contenido de los archivos no se guardan, solo el nombre del archivo. Hora de Colombia.

FechaUsuarioEmpresaAcciónDetalle ResultadoIP

Usuarios

admin: edita y gestiona usuarios; editor: lee y edita; lector: solo lee y descarga. Un usuario desactivado no puede entrar y, si estaba dentro, sale en su próxima acción. La clave mínima es de 8 caracteres. «Empresas» limita a un editor o lector a ciertas empresas (clic para elegir); el admin entra a todas.

UsuarioRolEmpresasEstadoCreado

Roles y permisos

Qué puede hacer cada rol. Ver lo puede todo el mundo; el admin tiene todos los permisos siempre y es el único que gestiona usuarios. Marca o desmarca para el editor y el lector y guarda: vale de inmediato para todos los usuarios de ese rol. El servidor rechaza lo que el rol no tenga, aunque alguien vea el botón.

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

  1. Descarga del portal de la DIAN el Excel de facturas recibidas del período.
  2. En Lotes → Cargar Excel de la DIAN, súbelo. Si trae facturas de otra empresa (otro NIT receptor), se rechaza entero: revisa el selector.
  3. Abre el lote y ejecuta 1. Traer facturas de la DIAN.
  4. Ejecuta 2. Asignar cuenta PUC.
  5. Ejecuta 3. Descargar PDFs (puede ir antes o en paralelo: no depende de los otros dos).
  6. Revisa la grilla de ítems, corrige lo que haga falta y pulsa Guardar cambios.
  7. 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:

  1. Diccionario exacto: mismo proveedor y misma descripción.
  2. Diccionario similar: mismo proveedor y descripción parecida.
  3. Reglas fijas: peajes, si la empresa tiene configurada la cuenta.
  4. 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égimenQué aplica
Jurídica / PN declaranteTarifa de la columna PJ
PN no declaranteTarifa 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.