01. DATOS GENERALES
| Producto | |
|---|
| Línea de producto: | |
|---|
| Segmento: | |
|---|
| Módulo: |
|---|
TOTVS Backoffice Linha Protheus) - Contabilidade Gerencial (SIGACTB)| SIGAFIN) |
| Función: | | Rutina | Nombre técnico |
|---|
| FINA474 | Mantenimiento de |
|
|---|
extracto |
| País: | PARAGUAY |
|---|
| Ticket: |
|
|---|
| Requisito/Story/Issue (informe el requisito vinculado): | DMICAS-553 |
|---|
02. SITUACIÓN/REQUISITO
Es necesario un estudio para desarrollar la conciliación bancaria en Paraguay. Caso sea necesario, hacer los ajustes.
...
Se ajusto la rutina FINA474 - Mantenimiento de extractoextractos bancarios , para que que se pueda conciliar los extractos de diferentes bancos de Paraguay.
...
| Totvs custom tabs box |
|---|
| tabs | Configuración previa , Banco Familiar, Banco Itaú, Banco Atlas,Banco Continental,Banco Sudameris, Ejemplo de utilización |
|---|
| ids | paso1,paso2,paso3,paso4,paso5,paso6 |
|---|
|
| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | paso1 |
|---|
| - Actualizar los datos en En
catastro de bancos- Actualizaciones>>Archivos>>Ocurrencias de Extracto (FINA480).
- En Actualizaciones>>Archivos>>Bancos (MATA070), validar que el valor en A6_NUMBCO, sea de acuerdo al banco:
| Valor | Banco |
|---|
FAM1 | Familiar | ITAU1 | Itaú | ATLA1 | Atlas | SUD1 | Sudameris | CONT1 | Continental |
|
| Totvs custom tabs box items |
|---|
| 🧩 Objetivo Automatizar la lectura, clasificación y registro de movimientos bancarios provenientes del Banco Familiar, utilizando un archivo de extracto en formato de texto plano con posiciones fijas y un layout configurable (familiar.ret) que define las posiciones de cada campo. 📁 Archivos involucrados
Archivo | Descripción |
|---|
nombre_archivo | Archivo que contiene el extracto bancario con formato de texto plano con posiciones fijas. | familiar.ret | Archivo de configuración con índices de campos. | SEJ, SIF, SIG
| Tablas del sistema Protheus utilizadas para clasificación y registro. |
📄 Estructura del archivo familiar.ret
Este archivo define los campos relevantes del extracto por nombre y rango de posiciones. Cada línea tiene el siguiente formato: Nombre del Campo PPPFFF - Identificador de bloque (líneas de movimiento)
- PPP: Posición inicial (3 dígitos)
- FFF: Posición final (3 dígitos)
Este archivo define los campos relevantes por nombre y su índice dentro del arreglo.
| Campo | Valor |
|---|
Fecha Movimiento | 017027 | descripción | 052074 | Debito | 097117 | Credito | 117136 | Documento | 034051 | Cod movimiento | 170171 |
Ejemplo: Campo | Posición | Resultado |
|---|
Fecha Movimiento | 017027 | 02/08/2025 | descripción | 052074 | DBPP-DEB.PAGO PRESTAMO | Debito | 097117 | 1.234,56 | Credito | 117136 | 0,00 | Documento | 034051 | 306714136 | Cod movimiento | 170171 | 22 |
🧠 Validaciones implementadas - Verificación de existencia del archivo de configuración
- La rutina ignora líneas hasta encontrar "SALDO ANTERIOR"
- Validación de fecha y valor
- Clasificación contable por contenido
- Consulta de tipo contable en SEJ
- Registro de errores por línea en aLog
- Inserción controlada en SIF (solo en la primera línea)
SIGAFIN>>Mantenimiento de extractos bancarios - Importar -Elegir la sucursal - Completar los datos 
 Image Removed Image Added
|
| Totvs custom tabs box items |
|---|
| 🧩 Objetivo Automatizar la lectura, clasificación y registro de movimientos bancarios provenientes del Banco Itaú, y registre los movimientos contables en las tablas SIF y SIG del sistema Protheus. La rutina utiliza un archivo de configuración externo (itau.ret) para definir las posiciones de cada campo. 📁 Archivos involucrados
Archivo | Descripción |
|---|
nombre_archivo | Archivo que contiene el extracto bancario con formato de texto plano con posiciones fijas. | itau.ret | Archivo de configuración con índices de campos. | SEJ, SIF, SIG
| Tablas del sistema Protheus utilizadas para clasificación y registro. |
📄 Estructura del archivo itau.ret Este archivo define los campos relevantes del extracto por nombre y rango de posiciones. Cada línea tiene el siguiente formato: Nombre del Campo PPPFFF - Identificador de bloque (líneas de movimiento)
- PPP: Posición inicial (3 dígitos)
- FFF: Posición final (3 dígitos)
Este archivo define los campos relevantes por nombre y su índice dentro del arreglo. Campo | Valor |
|---|
Fecha Movimiento | 010017 | descripción | 018048 | Tipo Movimiento | 051051 | Valor | 052066 | Documento | 068074 |
Ejemplo: Campo | Posición | Resultado |
|---|
Fecha Movimiento | 010017 | 01082025 | descripción | 023072 | Transf.Credito SIPAP | Tipo Movimiento | 051051 | C | Valor | 052066 | 000000000012300 | Documento | 068074 | 3727372 |
🧠 Validaciones implementadas - Verificación de existencia del archivo de configuración
- Validación de fecha y valor
- Clasificación del contenido
- Consulta de tipo movimiento en SEJ
- Registro de errores por línea en aLog
- Inserción controlada en SIF (solo en la primera línea)
SIGAFIN>>Mantenimiento de extractos bancarios - Importar -Elegir la sucursal - Completar los datos 
|
| Totvs custom tabs box items |
|---|
| 🧩 Objetivo Automatizar la lectura, clasificación y registro de movimientos bancarios provenientes del Banco ATLAS, y registrar los movimientos contables en las tablas SIF y SIG del sistema Protheus. 📁 Archivos involucrados
Archivo | Descripción |
|---|
nombre_archivo | Archivo que contiene el extracto bancario con formato de texto plano con posiciones fijas. | atlas.ret | Archivo de configuración con índices de campos. | SEJ, SIF, SIG
| Tablas del sistema Protheus utilizadas para clasificación y registro. |
📄 Estructura del archivo atlas.ret Este archivo define los campos relevantes por nombre y su índice dentro del arreglo aValores, generado por SplitDep(). Campo | Valor |
|---|
Fecha Movimiento | 001008 | descripción | 023072 | Documento | 073092 | Valor Débito | 088104 | Valor Crédito | 108123 |
📄 Estructura del archivo atlas.ret Este archivo define los campos relevantes del extracto por nombre y rango de posiciones. Cada línea tiene el siguiente formato: Nombre del Campo PPPFFF - Nombre del Campo: Etiqueta descriptiva del dato
- PPP: Posición inicial (3 dígitos)
- FFF: Posición final (3 dígitos)
Ejemplo: Campo | Posición | Resultado |
|---|
Fecha Movimiento | 001008 | 02092024 | descripción | 023072 | TRANSFERENCIAS ENTRE CUENTAS | Documento | 073092 | 33671630 | Valor Débito | 088104 | 0 | Valor Crédito | 108123 | 7904000 |
🧠 Validaciones implementadas - Verificación de existencia del archivo
- Validación de fecha y valor
- Consulta de tipo movimiento en SEJ
- Registro de errores por línea en aLog
- Inserción controlada en SIF (solo en la primera línea)
SIGAFIN>>Mantenimiento de extractos bancarios - Importar -Elegir la sucursal - Completar los datos 
|
| Totvs custom tabs box items |
|---|
| 🧩 Objetivo Automatizar la lectura, clasificación y registro de movimientos bancarios provenientes del Banco Continental, y registrar los movimientos bancarios en las tablas SIF y SIG del sistema Protheus. La rutina utiliza un archivo de configuración externo (continental.ret) para definir los índices de cada campo relevante. 📁 Archivos involucrados: Archivo | Descripción |
|---|
nombre_archivo | Archivo que contiene el extracto bancario con datos separados por ; | continental.ret | Archivo de configuración con índices de campos. | SEJ, SIF, SIG
| Tablas del sistema Protheus utilizadas para clasificación y registro. |
📄 Estructura del archivo continental.ret Este archivo define los campos relevantes por nombre y su índice dentro del arreglo. Campo | Valor |
|---|
Fecha Movimiento | 14 | descripción | 4 | Documento | 10 | Debito | 5 | Credito | 6 | Tipo Movimiento | 13 |
Ejemplo: Campo | Posicion | Resultado |
|---|
Fecha Movimiento | 14 | 06/08/25 | descripción | 4 | 25-CM-WEB;PS.Id:22590396, SALARIO | 29250017901602 | Documento | 10 | 286928 | Debito | 5 | 3.276.000 | Credito | 6 |
| Tipo Movimiento | 13 | 01 |
🧠 Validaciones implementadas - Verificación de existencia del archivo en formato CSV.
- Omisión de encabezado.
- Eliminación de separadores de miles (.) en valores.
- Validación si es débito o crédito contra tabla SEJ.
- Validación de tipo de movimiento contra tabla SEJ.
- Registro de errores en Log si faltan datos clave.
SIGAFIN>>Mantenimiento de extractos bancarios - Importar -Elegir la sucursal - Completar los datos  Image Added
 Image Added
|
| Totvs custom tabs box items |
|---|
| 🧩 Objetivo Procesar únicamente extractos bancarios en formato csv separados por punto y coma (;), provenientes del banco SUDAMERIS, y registrar los movimientos bancarios en las tablas SIF y SIG del sistema Protheus. La rutina utiliza un archivo de configuración externo (sudameris.ret) para definir los índices de cada campo relevante. 📁 Archivos involucrados:
Archivo | Descripción |
|---|
nombre_archivo | Archivo que contiene el extracto bancario con datos separados por ; | sudameris.ret | Archivo de configuración con índices de campos. | SEJ, SIF, SIG
| Tablas del sistema Protheus utilizadas para clasificación y registro. |
📄 Estructura del archivo sudameris.ret Este archivo define los campos relevantes por nombre y su índice dentro del arreglo aValores, generado por SplitDep(). Campo | Valor |
|---|
Fecha Movimiento | 4 | descripción | 6 | Documento | 10 | Valor | 11 | Tipo Movimiento | 17 |
Ejemplo: Campo | Posición | Resultado |
|---|
Fecha Movimiento | 4 | 30.04.24 | descripción | 6 | Serv. de Pago a proveedores | Documento | 10 | 286928 | Valor | 11 | 96500,37 | Tipo Movimiento | 17 | MSC |
🧠 Validaciones implementadas - Verificación de existencia de sudameris.ret
- Validación de fecha y valor
- Consulta de tipo de movimiento en SEJ
- Registro de errores por línea en aLog
- Inserción controlada en SIF (solo en la primera línea)
✅ Beneficios de esta implementación - Evita hardcodeo de índices
- Permite trazabilidad completa de cada movimiento
- Facilita mantenimiento y adaptación a nuevos layouts
- Compatible con lógica modular por configuración externa
| | Totvs custom tabs box items |
|---|
| SIGAFIN>>Mantenimiento de extractos bancarios - Importar -Elegir la sucursal - Completar los datos  Image Added
 Image Added
- Crear un banco desde la rutina Bancos (MATA070).
- Definir los parámetros del banco a través de la rutina Actualiza Parámetros de Banco - CBE (FINA130).
- Cargar la información del banco desde la rutina Mantenimiento de Extractos Bancarios (FINA474).
Ejemplo de la información de los archivos de extracto bancario:  Image Removed |
|
04. INFORMACIÓN ADICIONAL
...
| Card documentos |
|---|
| Informacao | Validar que el archivo con datos del extracto esté alineado con la estructura y validar que el archivo con datos del extracto no tenga líneas incompletas ni campos fuera de rango. Mantener actualizada la tabla SEJ con los tipos de movimiento esperados. Si el layout cambia, actualizar únicamente el archivo de configuración.Registrar los errores en Log para trazabilidad y auditoría |
|---|
| Titulo | ¡IMPORTANTE! |
|---|
|
05. ASUNTOS RELACIONADOS
