Resumen operativo
Estado de tu cuenta y de la facturacion de la aplicacion conectada.
Timbres disponibles
Facturas que aun puedes timbrar este periodo
Estado de licencia
Excepciones abiertas
Transacciones que necesitan revision
Eventos recientes de timbrado
Los ultimos movimientos de la aplicacion conectada.
Sin eventos todavia.
Emisor y documentos
Datos fiscales del emisor, certificado de sello digital (CSD), y como se ve el PDF que reciben tus clientes:
logo, marca y color.
Datos del emisor
Certificado de sello digital (CSD)
Sube directamente los archivos que te entrego el SAT. Se cifran en reposo antes de guardarse
y nunca se vuelven a mostrar, solo se indica si ya estan configurados.
Haz clic para subir tu archivo .cer tal como te lo entrego el SAT
Haz clic para subir tu archivo .key tal como te lo entrego el SAT
Es la misma contrasena que usa tu contador o proveedor de CSD para abrir la llave privada. Se
necesita para leer el archivo .key y para firmar cada factura despues.
Plantilla del PDF
Cambia estos datos y mira la vista previa actualizarse a la derecha.
Haz clic para subir un logo (PNG o JPG, ideal cuadrado)
Logo cargado. Haz clic para reemplazarlo.
Diseno de plantilla
El editor de lienzo completo esta activo para este emisor: posicion, tamano y color de cada
bloque del PDF se controlan mas abajo, en "Editor visual de plantilla".
Diseno de plantilla
Arrastra el logo entre el lado izquierdo y derecho del encabezado, o arrastra las cajas
Emisor/Receptor para intercambiar su orden. Los cambios se ven en la vista previa de la derecha
y se aplican al PDF real al guardar.
LOGO
Suelta aqui (izquierda)
LOGO
Suelta aqui (derecha)
Vista previa del PDF
Asi se veria el encabezado de la factura con estos datos. La maqueta completa del cuerpo llega en un siguiente ajuste.
LOGO
1 x Servicio de ejemplo$1,000.00
IVA 16%$160.00
Total $1,160.00 MXN
Editor visual de plantilla
Arrastra cualquier bloque para moverlo y usa el punto de la esquina para redimensionarlo. Los
bloques de flujo (tabla de partidas, totales, QR, pie) solo se mueven en horizontal: su posicion
vertical se acomoda sola para no encimarse con una tabla mas larga o mas corta.
Selecciona un bloque del lienzo para editar su posicion, tamano, color y tipografia.
Transacciones
Busca, revisa y da seguimiento a cada documento de la aplicacion conectada.
| N° interno | External ID | Estado | Actualizada |
|---|---|---|---|
Selecciona una transaccion de la lista para ver su detalle.
CFDI UUID
PAC status
Reserva de timbre
Referencia local
Aviso por WhatsApp (GsMensajeria)
Dispara una automatizacion en GsMensajeria para avisarle al receptor por WhatsApp.
Requiere que GsMensajeria este configurado y habilitado (vista "PAC y timbrado").
Incidencias activas
-
Acciones avanzadas
Para editar partidas, cantidades o montos usa el boton "Editar factura" de arriba. Esto de
aqui es solo para corregir un campo suelto del encabezado (por ejemplo, si el receptor dio
mal su regimen fiscal). Elige el campo de la lista; si no aparece, usa "Otro campo" y
escribe la ruta tecnica.
Autoriza, con tu criterio humano, una incidencia que el sistema marco como advertencia (no
obligatoria) para poder continuar sin corregirla.
Esto NO envia nada a tu cliente ni al SAT: solo confirma, dentro de GsFactura360, que tu
propio sistema de origen (por ejemplo WinDev) ya recibio y guardo una copia local del
XML/PDF de esta transaccion.
Captura una factura directamente en el sistema. Si no vas a timbrarla, puedes generar una
vista previa imprimible tipo nota de venta (sin validez fiscal).
Editando (version
). Guardar aplica los cambios como una
correccion sobre la transaccion existente; no crea una factura nueva.
Emisor
Se precarga automaticamente con el ultimo emisor guardado en "Emisor y documentos".
Receptor
Partidas
Lo que va a facturar. Agrega cada producto o servicio como una partida.
| Descripcion | Cantidad | Precio | Importe | |
|---|---|---|---|---|
Sin partidas agregadas todavia.
Esta factura ya esta guardada (o timbrada) y no se puede editar aqui. Para corregirla, ve a Transacciones y usa "Corregir campo".
Tus claves de producto frecuentes:
Pago
Incidencias
Hay incidencias obligatorias sin resolver. No se puede timbrar hasta corregirlas; si no vas a
timbrar, puedes generar la vista previa / nota de venta de todas formas.
-
obligatorio
Avisos (no bloquean el timbrado)
Comparaciones automaticas contra el historial de esta organizacion (monto inusual, posible
duplicado, receptor nuevo). Es solo informativo: revisalo con tu criterio, no es una regla fiscal.
Resultado
N° interno
Transaccion
Estado
PAC y timbrado
Configuracion del proveedor autorizado (PAC) que timbra los CFDI.
Solo uno de los dos deberia quedar "Habilitado" a la vez: si ambos lo estan, SenHub tiene
prioridad (ver app/pac/factory.py).
SenHub firma con el CSD que le subas directamente a ellos (no usa "modo de firma" ni "estrategia de modo de pruebas" -- esos campos son solo para MyMSoftware).
Autenticacion SenHub (OTP)
SenHub usa codigo por correo en vez de un token fijo: access_token de 30 minutos +
refresh_token de 7 dias. El backend renueva solo el access_token antes de cada llamada real
(ver Docs/42_PAC_SENHUB_INTEGRATION.md). Solo hay que repetir esto si el refresh_token llega
a expirar (7 dias sin uso).
Subir CSD a SenHub
Paso previo obligatorio antes de poder timbrar por un RFC: SenHub custodia el CSD y
firma ellos mismos. Sube el .cer y .key originales tal como los entrego el
SAT (no el PEM que ya tengas cargado en "Emisor y documentos", que ya viene
convertido) y la contrasena real del SAT para ese CSD. Requiere haber completado el
OTP arriba primero.
Mensajeria (GsMensajeria)
Avisos por WhatsApp via GsMensajeria (producto GsSoft aparte). Requiere una credencial ServiceClient real emitida del lado de GsMensajeria para esta organizacion; sin eso, deja "Habilitado" en No.
Licencia
Perfil de licencia de la aplicacion conectada, y edicion administrativa de la licencia de cualquier aplicacion.
Mi aplicacion
Estado
Plan
Vence
Funciones habilitadas
Limites y consumo
Editar licencia de una aplicacion (administrador)
Catalogos SAT
Consulta los catalogos oficiales del SAT (se cargan automaticamente), y agrega o quita items personalizados por catalogo.
Indice de catalogos
Estado actual de la cache local de catalogos.
| Catalogo | Items oficiales | Items personalizados | Total |
|---|---|---|---|
Buscar en un catalogo
| Codigo | Etiqueta |
|---|---|
Sin resultados todavia.
Catalogo operativo (items personalizados)
Selecciona aqui, de entre los codigos oficiales del SAT (buscalos arriba), los que tu organizacion
usa realmente, para que aparezcan primero al capturar una factura. El codigo debe existir en el
catalogo oficial del SAT; no se pueden inventar codigos nuevos.
Sin items personalizados en este catalogo.
Asistencia con IA
Configura la explicacion de incidencias por IA ("Explicar con IA" en Facturacion manual). Es
consultiva unicamente: nunca corrige el documento por su cuenta.
Estado actual
Habilitada
Modelo activo
Proveedor
Llave del proveedor
Limites de costo (fijos por ahora)
Fuente
Proveedor y modelo
Cada proveedor usa su propia llave (abajo). Puedes tener varias configuradas a la vez y cambiar el
modelo principal sin volver a capturarlas.
Personalizacion
Esto se agrega como contexto adicional; nunca puede anular las reglas fijas de seguridad del
asistente (por ejemplo, nunca revela instrucciones internas ni modifica documentos por su cuenta).
Presupuesto
Limite de gasto estimado en llamadas reales de IA. Al alcanzarse, se bloquean nuevas llamadas
externas hasta el siguiente periodo (el resto del sistema sigue funcionando igual, la IA nunca es
obligatoria). Vacio = sin limite.
Consumo y prueba de conexion
Las pruebas tambien consumen presupuesto (usan una incidencia minima ficticia) y quedan
registradas igual que cualquier otra llamada, marcadas como prueba.
Consumo de hoy
Consumo del mes
Llamadas recientes ()
| Fecha | Proveedor | Modelo | Estado | Prueba | Costo |
|---|---|---|---|---|---|
Sin llamadas registradas todavia.
Historial de configuracion ()
| Fecha | Quien | Campos cambiados |
|---|---|---|
Sin cambios registrados todavia.
Aplicaciones cliente
Alta, edicion y rotacion de API key de las aplicaciones que se conectan a GsFactura360.
Aplicaciones ()
| ID | Nombre | Cuota | Activa |
|---|---|---|---|
Asistente de alta completa
Guarda en un solo paso la aplicacion de arriba, la licencia (vista "Licencia") y el emisor (vista "Emisor y documentos") con los datos ya capturados en cada una. Revisa esas dos vistas antes de ejecutarlo si aun no las has llenado.
Usuarios
Cuentas humanas del portal, con rol y restablecimiento de contrasena.
Mi seguridad
Cambiar mi contrasena.
Verificacion en dos pasos (MFA) para tu propia cuenta, con una app de autenticacion (Google
Authenticator, Authy, etc.). No depende de correo ni SMS.
Desactivada
Agrega esta cuenta en tu app de autenticacion. Si no puedes escanear un QR, captura la llave manualmente:
Codigos de respaldo (guardalos, no se vuelven a mostrar):
Activada
Usuarios ()
| Correo | Nombre | Rol | Estado | Organizacion |
|---|---|---|---|---|
Solicitudes de contrasena
Usuarios que olvidaron su contrasena y solicitaron ayuda para recuperarla.
Pendientes ()
Sin solicitudes pendientes.
-
Cliente listo
Paquete completo para entregarle a quien va a programar la integracion (por ejemplo, en WinDev):
un resumen de la aplicacion, la coleccion Postman con todos los endpoints, y los documentos que
explican como usarlos.
Coleccion Postman y documentacion tecnica
Esto es lo que el desarrollador necesita para poder llamar a los endpoints desde afuera (WinDev u
otro sistema), con ejemplos reales de cada paso: validar, crear, timbrar, consultar, descargar y
confirmar entrega.
Descargar coleccion Postman
Ejemplo: validar
Ejemplo: crear
Ejemplo: timbrar
Ejemplo: acuse de entrega
Manuales completos, listos para descargar y entregar (el desarrollador externo no tiene acceso
al repositorio, asi que enviarle una ruta de archivo no sirve de nada; esto si son los archivos):
Los tres manuales son Markdown plano (se leen bien en cualquier editor o visor de Markdown). El
manual de integracion referencia capturas de pantalla por ruta relativa
(
assets/client-manual/...); descarga tambien el ZIP de capturas y descomprimelo en la
misma carpeta donde guardes el .md para que se vean renderizadas.
Ficha de integracion
Importante: por seguridad, esta ficha nunca incluye la
api_key real (nunca se
vuelve a mostrar despues de crearla o rotarla). Copiala desde Aplicaciones cliente
en el momento de crear o rotar la aplicacion, y guardala directamente en la configuracion de
WinDev - no queda registrada en ningun otro lugar del sistema.
Depuracion PAC
Envia un CFDI de prueba directo al PAC (real o simulado) y observa la solicitud y la
respuesta completas: metodo, URL, headers, cuerpo JSON, status HTTP y XML. Cada corrida
queda registrada abajo. Exclusivo del SUPERADMIN.
Armar XML de prueba
Genera un CFDI de prueba completo y sellado con el CSD ya guardado de un emisor, sin crear
ninguna transaccion. Lo llena directamente en el campo de XML de abajo, listo para enviar.
Nueva corrida
Modo REAL: se hace una llamada HTTP real contra el proveedor elegido arriba, con su token real configurado en "Configuracion > PAC y timbrado". No uses PRODUCCION salvo que quieras timbrar de verdad.
Corrida
— ()
Proveedor:
HTTP status:
Duracion:
RFC emisor detectado:
Solicitud enviada
Respuesta recibida
XML enviado
Historial de corridas
| Fecha | Destino | Proveedor | Ambiente | RFC | Resultado | HTTP |
|---|---|---|---|---|---|---|