# Manual de Usuario — Estación Fiscal

**Borrador v1 (2026-07-30).** Recaudo del trámite de homologación (art. 4 de la
Providencia SNAT/2024/000121: "Manuales Técnicos para los Usuarios"). Falta
insertar las capturas de pantalla definitivas cuando se cierre la cara visual.

---

## 1. Qué es la Estación Fiscal

La Estación Fiscal es un programa que se instala en una computadora del negocio
y se encarga de todo lo fiscal de las ventas: arma el documento con su desglose
de impuestos, lo asienta en un libro inmutable con numeración consecutiva, lo
transmite a la imprenta digital autorizada, recibe el número de control y
entrega la factura al cliente (en papel térmico, en el teléfono y por correo).

Reglas que definen el producto:

1. **Una instalación corresponde a un solo contribuyente (un RIF).**
2. **Nada se edita ni se borra.** Las correcciones se hacen únicamente por nota
   de crédito o débito, con su motivo. El documento original queda intacto.
3. **El cobro nunca espera.** Si no hay internet, la venta se sella igual y se
   transmite sola cuando vuelva la señal, en orden y sin duplicar.
4. El sistema de ventas (Gustito Xpress, el Cerebrito de caja, u otro programa
   administrativo) solo ENTREGA la venta: no calcula impuestos, no numera y no
   toca el libro.

## 2. Instalación

1. Copie `Estacion-Fiscal.exe` a una carpeta propia (por ejemplo
   `C:\EstacionFiscal`). Todo lo del programa vive junto al ejecutable: libro,
   bitácora, cola, respaldo y configuración. Si el negocio cambia de equipo,
   se lleva la carpeta completa.
2. Ábralo. La primera vez el programa:
   - se registra para **arrancar solo con Windows** (una estación fiscal no
     puede depender de que alguien se acuerde de abrirla), y
   - deja un **acceso directo en el escritorio** que abre su pantalla.
3. La pantalla se maneja desde el navegador del propio equipo, en
   `http://127.0.0.1:8739`. No está expuesta a internet.

## 3. Primer uso

1. **La clave del dueño.** En el primer uso el programa pide crear la clave del
   dueño. Con ella se entra a todo. Guárdela: sin clave no hay pantalla.
2. **Configurar el negocio** (pantalla Configurar):
   - RIF (se valida el dígito verificador: un RIF mal escrito no pasa),
   - razón social y domicilio fiscal tal como aparecen en el RIF,
   - alícuota general del negocio (16, 8 o 0) y si los precios de la carta ya
     traen el IVA adentro (lo normal en Venezuela),
   - la serie de los documentos (una por instalación) y el nombre del equipo.
3. **La imprenta digital** con la que se emite: el adaptador (la imprenta
   contratada por el negocio), su dirección y la llave o credenciales que esa
   imprenta entregó al dar de alta al negocio. Puede configurarse una **segunda
   imprenta de respaldo**: el cambio a ella es SIEMPRE manual y queda anotado
   (dos fuentes de numeración a la vez es un problema fiscal, no una ayuda).
4. **El enlace con la nube** (opcional): si el negocio usa Gustito Xpress, la
   Estación hala sola las ventas cerradas. Una Estación también puede trabajar
   sola, recibiendo ventas por su puerta local o por la carpeta de intercambio.
5. Regla dura: **si falta un dato obligatorio, la Estación no sella nada.** Es
   preferible enterarse al configurar y no emitir cien documentos con el RIF
   mal escrito.

## 4. El día a día

En operación normal no hay que tocar nada:

1. El negocio cobra en su sistema de ventas como siempre.
2. La venta llega sola a la Estación (por la nube, por la caja o por la
   carpeta de intercambio), se sella, se transmite y el cliente recibe su
   factura con el código QR de comprobación.
3. En la pantalla **Documentos** se ve cada documento con su número, su número
   de control y su estado de transmisión. En **Movimientos** queda el registro
   de eventos: quién hizo qué y cuándo.

Si el internet del local se cae, el negocio sigue vendiendo: los documentos
quedan sellados con la marca "pendiente" y se transmiten solos al volver la
señal, en el mismo orden, sin duplicarse.

## 5. Correcciones: nota de crédito, nunca borrar

Una venta mal facturada no se edita ni se elimina. Desde la pantalla de
documentos se **anula** indicando el motivo (obligatorio): la Estación emite
una **nota de crédito** por el mismo monto en negativo, la numera, la
transmite y la deja ligada a la factura original. Las dos quedan en el libro
para siempre.

## 5.1 Retenciones recibidas: registrar el crédito del mes

Cuando un **agente de retención** (una empresa designada sujeto pasivo
especial) paga una factura del negocio, retiene el 75% o el 100% del IVA y
entrega un **comprobante de retención**. Ese papel es plata: es crédito contra
la cuota del período en la declaración de IVA. En la pantalla **Retenciones**
el responsable lo registra copiando lo que dice el comprobante (número, fecha,
RIF y razón social del agente, factura a la que corresponde, porcentaje y monto
retenido en bolívares). La Estación no emite ese comprobante (lo emite el
agente): lo registra para que el período cuadre y el crédito no se pierda.

La misma pantalla muestra el resumen del período (comprobantes vigentes y
total retenido) y permite bajar el archivo del período para el contador. Un
comprobante mal cargado **no se borra**: se anula con su motivo y el registro
original queda con la contramarca, igual que en el resto del sistema.

## 6. Contingencia: el talonario manual

Si el equipo o el sistema quedan fuera de servicio, la contingencia legal es el
**talonario manual**. Al volver el servicio, las facturas hechas a mano se
cargan en la pantalla **Contingencia** copiando lo que dice el papel (número
impreso del talonario, fecha real de emisión, cliente y total). La Estación las
anota SIN ponerles numeración propia (ese papel ya tiene la suya) para que el
reporte del mes cuadre con lo que de verdad se vendió.

## 7. El respaldo

El libro fiscal se respalda **cifrado y fuera del equipo** de forma automática:
si la computadora se quema, el libro no se quema con ella. En el primer uso el
programa entrega una **frase de recuperación**: guárdela impresa en un lugar
seguro; con ella se restaura el libro en un equipo nuevo. La restauración está
probada y documentada en la memoria técnica.

## 8. El reloj

La hora del equipo se compara contra una referencia externa al arrancar y cada
quince minutos. Si alguien mueve la hora de Windows, la Estación **deja de
sellar** hasta que se corrija (las ventas no se pierden: esperan en el buzón).
Un documento fiscal con fecha adulterada es peor que un documento tardío.

## 9. Claves, roles y llaves

1. **Dueño**: entra a todo, configura y administra.
2. **Operadores**: cuentas propias para el personal que opera el día a día,
   cada una con su clave. Todo lo que hacen queda en la bitácora con su nombre.
3. **Llave de máquina**: la que usan los PROGRAMAS del negocio (la caja, un
   administrativo de terceros) para entregar ventas por la puerta local. Se
   genera y se revoca desde la pantalla de claves. Un programa cualquiera del
   equipo no tiene por qué poder quemar numeración fiscal.
4. **Clave del auditor fiscal**: véase la sección siguiente. Es independiente
   de la del dueño a propósito.

## 10. El acceso de consulta para la Administración Tributaria

La Estación tiene una puerta de **solo lectura** para la fiscalización
(pantalla `/fiscal` y su interfaz de programación): documentos emitidos,
totales, verificación de integridad del libro y registro de eventos, con
exportación a CSV. Se entra con la clave de auditor, que el dueño entrega
cuando la Administración la requiera. Por esa puerta **no se puede escribir
nada**: es ver y comprobar.

## 11. Responsabilidades del usuario

Conforme al art. 12 de la Providencia 000121, el usuario no debe alterar el
sistema ni sus registros. La Estación lo impide por diseño y lo registra todo:

1. El libro está **encadenado criptográficamente**: cualquier alteración de un
   asiento se detecta y se señala en qué línea ocurrió.
2. Cada acción de pantalla queda en la bitácora con usuario, fecha y detalle.
3. El programa **no se actualiza solo**: cada versión nueva se libera por su
   canal formal (y, una vez homologado el sistema, previa homologación de la
   versión, arts. 9 al 11).

Si el equipo presenta fallas, contacte al soporte antes de intentar cualquier
manipulación de las carpetas del programa.

## 12. Problemas frecuentes

| Síntoma | Qué es | Qué hacer |
| --- | --- | --- |
| "La estación fiscal no está configurada" | Falta un dato obligatorio del emisor | Abrir Configurar y completar lo que la pantalla señale |
| Documentos en "pendiente" | No hay internet o la imprenta no responde | Nada: se transmiten solos al volver la señal. Si pasa de horas, revisar la conexión del local |
| "La hora del equipo está corrida" | El reloj de Windows no cuadra con la referencia | Corregir la hora del equipo; el sellado se reanuda solo |
| Un archivo quedó en `intercambio/rechazadas` | El archivo no era JSON válido o le faltaban datos | Ver su porqué en `intercambio/respuestas`, corregir en el sistema de origen y volver a dejarlo en `entrada` |
| El cliente no recibió el correo de su factura | El pedido no traía correo, o el envío está en cola | El enlace del sello sale igual en el papel y en el teléfono; el correo es cortesía y reintenta solo |

---

*Estación Fiscal — Manual de usuario, borrador v1. Complementa a la
`MEMORIA_TECNICA.md` (la descripción técnica del sistema) y a la
`GUIA_INTEGRACION.md` (el contrato para programas administrativos de terceros).*
