Histórico da Página

01. DATOS GENERALES

Producto

Solucoes_espanhol

Solucao	TOTVS Backoffice

Línea de producto:

Linhas_totvs_espanhol

Linha	Línea Protheus

Segmento:

Segmentos_totvs_espanhol

Segmento	Backoffice

Módulo:

TOTVS Backoffice

Financiero (

Linha Protheus) - Contabilidade Gerencial (SIGACTB)

SIGAFIN)

Función:

Rutina	Nombre técnico
FINA474

Conciliación Bancaria

Mantenimiento de extractos bancarios

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.

...

03. SOLUCIÓN

Se ajusto la rutina FINA474 - Mantenimiento de extractos bancarios , para que que muestre los datos correctamente, y se pueda conciliar los extractos de diferentes bancos de Paraguay.

...

Totvs custom tabs box

tabs	Configuración previa 1 , 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

default	no
referencia	paso2

🧩 Objetivo

Automatizar 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.

Actualizar el valor campo A6_NUMBCO en el formulario de bancos con el valor FAM1

📁 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.ImpExtFa()

Rutina ADVPL que procesa el extracto y realiza la inserción

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 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 aValores, generado por SplitDep().

Campo	Valor
Fecha Movimiento	017027
descripción	052074
Debito	097117
Credito	117136
Documento	034051
Cod movimiento	170171

Ejemplo:

Posicion

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)

📌 Recomendaciones importantes

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

SIGAFIN>>Mantenimiento de extractos bancarios - Importar -Elegir la sucursal - Completar los datos

Image Added

Registrar los errores en aLog para trazabilidad y auditoría

Totvs custom tabs box items

default	no
referencia	paso3

🧩 Objetivo

Implementar una rutina en ADVPL que procese extractos bancarios en formato de texto plano con posiciones fijas, provenientes del banco 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.

Actualizar el valor campo A6_NUMBCO en el formulario de bancos con el valor ITAU1

📁 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.

ImpExtIt()

Rutina ADVPL que procesa el extracto y realiza la inserción

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 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 aValores, generado por SplitDep().

Campo	Valor
Fecha Movimiento	010017
descripción	018048
Tipo Movimiento	051051
Valor	052066
Documento	068074

Ejemplo:

Posicion

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)

📌 Recomendaciones importantes

Validar que el archivo con datos del extracto esté alineado con la estructura.

Mantener actualizada la tabla SEJ con los tipos de movimiento esperados.

Si el layout cambia, actualizar únicamente el archivo de configuración.

SIGAFIN>>Mantenimiento de extractos bancarios - Importar -Elegir la sucursal - Completar los datos

Image Added

Registrar los errores en aLog para trazabilidad y auditoría.

Totvs custom tabs box items

default	no
referencia	paso4

🧩 Objetivo

Implementar una rutina en ADVPL que permita importar extractos bancarios en formato de texto plano con posiciones fijas, provenientes del banco 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.

Actualizar el valor campo A6_NUMBCO en el formulario de bancos con el valor ATLA1

📁 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.

ImpExtAt()

Rutina ADVPL que procesa el extracto y realiza la inserción

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:

Posicion

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)

📌 Requisitos técnicos

SIGAFIN>>Mantenimiento de extractos bancarios - Importar -Elegir la sucursal - Completar los datos

Image Added

Totvs custom tabs box items

default	no
referencia	paso5

🧩 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

El archivo atlas.ret debe estar accesible desde la ruta definida.

Las posiciones deben estar correctamente alineadas y sin solapamientos

La tabla SEJ debe estar actualizada con los tipos de movimiento esperados.

La rutina debe ejecutarse en un ambiente con acceso a las áreas SIF, SIG, SEJ.

Totvs custom tabs box items

default	no
referencia	paso5paso6

🧩 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.

Actualizar el valor campo A6_NUMBCO en el formulario de bancos con el valor SUDA1

📁 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.
ImpExtSuda()	Rutina ADVPL que procesa el extracto y realiza la inserción
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:

Posicion

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

📌 Recomendaciones inportantes

SIGAFIN>>Mantenimiento de extractos bancarios - Importar -Elegir la sucursal - Completar los datos

Image Added

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

...

04. INFORMACIÓN ADICIONAL

Card documentos

Informacao	Utilice este box para resaltar información relevante y/o de destaque..Registrar los errores en Log para trazabilidad y auditoría
Titulo	¡IMPORTANTE!

05. ASUNTOS RELACIONADOS

Catastro FINA130 - Parâmetros de Bancos
Ocurrencias de extractos (FINA480 - SIGAFIN)
Templatedocumentos

Árvore de páginas

Versões comparadas

Versão antiga 16

Nova versão Atual

Chave

01. DATOS GENERALES

02. SITUACIÓN/REQUISITO

03. SOLUCIÓN

04. INFORMACIÓN ADICIONAL

04. INFORMACIÓN ADICIONAL

05. ASUNTOS RELACIONADOS