Árvore de páginas

Versões comparadas

Chave

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

...

Totvs custom tabs box
tabsConfiguración previa 1, Banco Familiar, Banco Itaú, Banco Atlas,Banco Continental,Banco Sudameris
idspaso1,paso2,paso3,paso4,paso5,paso6
Totvs custom tabs box items
defaultyes
referenciapaso1

En catastro de bancos, validar que el valor en A6_NUMBCO, de acuerdo al banco:


ValorBanco

FAM1

Familiar

ITAU1

Itaú

ATLA1

Atlas

SUD1

Sudameris

CONT1

Continental

Totvs custom tabs box items
defaultno
referenciapaso2


📄 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)

Card documentos
Informacao
📌 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

.Registrar los errores en

aLog

Log para trazabilidad y auditoría
Titulo¡IMPORTANTE!

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 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)

Card documentos
Informacao
📌 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.

Registrar los errores en

aLog

Log para trazabilidad y auditoría

.

Titulo¡IMPORTANTE!

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

    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

    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.

    Si el layout cambia, actualizar únicamente el archivo de configuración.Registrar los errores en Log para trazabilidad y auditoría
    Titulo¡IMPORTANTE!

    Totvs custom tabs box items
    defaultno
    referenciapaso5

    🧩 Objetivo

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


    Card documentos
    Informacao
    📌 Recomendaciones importantes
    Validar que el archivo con

    archivo real del Banco Continental.
  • Verificar que los campos estén correctamente mapeados.
  • Confirmar que los registros se inserten en SIF y SIG.
  • 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!

    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


    Card documentos
    InformacaoValidar que el archivo con datos del extracto esté alineado con sudameris.ret 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 las posiciones de los campos en el archivo con datos del extracto cambianel layout cambia, actualizar únicamente el archivo de configuración sudameris.ret..Registrar los errores en Log para trazabilidad y auditoría
    Titulo¡IMPORTANTE!
    📌 Recomendaciones importantes


    04. INFORMACIÓN ADICIONAL

    ...