Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

01. DATOS GENERALES


Producto

Solucoes_espanhol
SolucaoTOTVS Backoffice

Línea de producto: 

Linhas_totvs_espanhol
LinhaLínea Protheus

Segmento:

Segmentos_totvs_espanhol
SegmentoBackoffice

Módulo:
TOTVS Backoffice (Linha Protheus) - Contabilidade Gerencial (SIGACTB
Financiero (SIGAFIN)
Función:
RutinaNombre 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
tabsConfiguración previa 1 , Banco Familiar, Banco Itaú, Banco Atlas,Banco Continental,Banco Sudameris, Ejemplo de utilización
idspaso1,paso2,paso3,paso4,paso5,paso6
Totvs custom tabs box items
defaultyes
referenciapaso1
  • 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:
ValorBanco

FAM1

Familiar

ITAU1

Itaú

ATLA1

Atlas

SUD1

Sudameris

CONT1

Continental

Totvs custom tabs box items
defaultno
referenciapaso2

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


CampoValor

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)

📌 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


    Image Added

    Registrar los errores en aLog para trazabilidad y auditoría


    Totvs custom tabs box items
    defaultno
    referenciapaso3

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

    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)

    📌 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


    Image Added

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

    Totvs custom tabs box items
    defaultno
    referenciapaso4

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

    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)

    📌 Requisitos técnicos

  • 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.
  • SIGAFIN>>Mantenimiento de extractos bancarios - Importar -Elegir la sucursal - Completar los datos

    Image Added


    Image Added

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

    Totvs custom tabs box items
    defaultno
    referenciapaso5

    🧩 Objetivo

    Procesar únicamente extractos bancarios en formato csv separados por punto y coma (;), provenientes del banco 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.

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

    📁 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 aLog Log si faltan datos clave

    📌 Recomendaciones importantes

  • Validar con archivo real del Banco Continental.
  • Verificar que los campos estén correctamente mapeados.
  • Confirmar que los registros se inserten en SIF y SIG.
    • .

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

    Image Added


    Image Added

    Revisar el log (aLog) ante errores de tipo o datos faltantes.



    Totvs custom tabs box items
    defaultno
    referenciapaso6

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

    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
    📌 Recomendaciones importantes

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

    Image Added


    Image Added




    04. INFORMACIÓN ADICIONAL


    Card documentos
    InformacaoValidar 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
    InformacaoUtilice 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