Ayuda del sistema

Documentación por entidad y campo (estilo HELPTEXT de Temenos Transact): qué es cada campo, sus valores permitidos, la regla de validación y un ejemplo.

Comprobante / Venta

Comprobante electrónico (factura, nota de crédito/débito, retención, guía de remisión o liquidación de compra) según la ficha técnica del SRI. Puede ser EMITIDO por la empresa o RECIBIDO de un proveedor. Su clave de acceso de 49 dígitos es la clave de idempotencia del sistema (única en BD). El cálculo fiscal (subtotales, IVA, clave) es autoritativo del servidor; el formulario solo captura el input. Ciclo de vida: BORRADOR -> FIRMADO -> ENVIADO -> RECIBIDA_SRI -> AUTORIZADA | RECHAZADA | DEVUELTA.

12campos documentados →

Producto

Ítem del catálogo de venta de un comercio (datos maestros + inventario). El código es el codigoPrincipal SRI y el codigoBarras el codigoAuxiliar (lo lee el escáner). Si controlaStock es true, el stock se mueve SOLO por el kardex (movimientos ENTRADA/AJUSTE y SALIDA automática al autorizarse una venta), nunca por edición directa. La valoración usa costeo PROMEDIO ponderado o FIFO.

13campos documentados →

Periodo fiscal

Periodo fiscal mensual de una empresa, base de la declaración de IVA (Formulario 104) y retenciones (Formulario 103) y del Anexo Transaccional Simplificado (ATS). Estado: ABIERTO -> CALCULADO -> DECLARADO. La fechaMaxima de presentación se calcula automáticamente con el calendario del SRI: mes SIGUIENTE al periodo, en el día que marca el noveno dígito del RUC; si cae fin de semana o feriado se traslada al siguiente día hábil.

8campos documentados →

Empresa

Empresa / contribuyente (tenant) dueña de los registros. Su RUC es la identidad fiscal (inmutable) y el noveno dígito define el calendario de declaración del SRI. El ADMIN de negocio administra su propia empresa; el operador de plataforma (SUPER_ADMIN) administra cualquiera.

7campos documentados →

Establecimiento

Sucursal o local de la empresa. Su código de 3 dígitos forma la serie de los comprobantes (estab-ptoEmi-secuencial, ej. 001-001-000000123) junto con sus puntos de emisión. También define el LOGO que sale en la factura (RIDE): si el establecimiento tiene logo propio se usa ese; si no, se usa el logo de la empresa; si ninguno existe, la factura sale sin logo. DÓNDE SE CAMBIA: el Administrador del negocio en Establecimientos -> Editar (campo "Logo del establecimiento"); el logo general de la empresa lo cambia el operador de plataforma en Empresas -> Editar (campo "Logo de la empresa").

5campos documentados →