Atención: La implementación de los layouts SERASA de envío y devolución está disponible solamente para la versión 12 del Protheus, a partir del release 12.1.6.

Para utilizar el envío y recepción de archivos SERASA, deben importarse los layouts MILE serasa_layout_envio.xml y serasa_layout_retorno.xml, puestos a disposición junto con el release 12.1.6.

Después de la importación de los layouts en el MILE (MILE: Model Integrator Layout Engine), estos pueden modificarse, con el fin atender alguna personalización o particularidad del entorno. Para importarlos es necesario realizar los siguientes procedimientos:

  • En el Configurador (SIGACFG) acceda a Entorno > Workflow > Layouts
  • Seleccione la opción Importar.
  • Se muestra la pantalla para la selección del camino del archivo del layout MILE para importación.

  • Realice el procedimiento para cada archivo de layout por separado.
  • Al final, confirme la importación de los layouts SERA_ENV y SERA_RET.
  • Al importarlos es posible realizar la modificación.

Observación: La nomenclatura de los layouts, SERA_ENV (envío) y SERA_RET (devolución) son estándar para uso en el Protheus y no pueden modificarse.


En la modificación de los layouts es posible modificar las posiciones de captura de datos, el orden. Sin embargo, los segmentos definidos previamente en el layout importado deben mantenerse, para que los archivos se generen y lean correctamente.

Estructura del layout de envío SERASA

Estructura del layout de devolución SERASA

Este layout es utilizado por la rutina de procesos SERASA (FINA770) que está disponible en el Financiero (SIGAFIN) en Actualizaciones/Cuentas por cobrar/ SERASA - Procesos.

Observación: la generación del archivo de envío solamente es posible si existen lotes de envío generados, también por medio de la rutina de procesos SERASA (FINA770).

Para generar el archivo de envío, en la ventana de la rutina de procesos SERASA, seleccione la opción Exportar lote. Para realizar el procesamiento del archivo de devolución SERASA, en la ventana de la rutina de procesos SERASA, seleccione la opción Archivo de devolución.

Estructura del layout SERASA

El layout de envío SERASA tiene la siguiente estructura:

Header:

Campo

Inicio

Final

Tamaño

Contenido

Código del registro

001

001

001

'0'

CNPJ

002

010

009

SM0->M0_CGC

Fecha del movimiento

011

018

008

DtoS(dDataBase)

DDD

019

022

004

Que será definido por el usuario

Teléfono de contacto

023

030

008

Que será definido por el usuario

Extensión teléfono contacto

031

034

004

Que será definido por el usuario

Nombre del contacto

035

104

070

Que será definido por el usuario

ID archivo fijo

105

119

015

"SERASA-CONVEM04"

Número de envío

120

125

006

F770GetArq()

Código envío de archivo

126

126

001

"E"

Diferencial de envío

127

130

004

Space(4)

Blancos

131

533

403

Space(403)

Código de errores

534

593

060

Space(60)

Secuencia de registro

594

600

007

F770SeqReg()


Detail:

Campo

Inicio

Final

Tamaño

Contenido

Tipo de registro                

001

001

001

"1"                                              

Código operación              

002

002

001

Fa770GetOp()                                    

Sucursal/Dígito contratante

003

008

006

Configurable por el usuario con la información del CNPJ del contratante del servicio del Serasa

Fecha de ocurrencia

009

018

008

F770Vencto()

Fecha final del contrato

017

024

008

F770Vencto()

Código Modalidad Operación

025

027

003

FW9_TIPO

Código Plaza Embratel

028

031

004

SPACE(4)                                         

Tipo Persona

032

032

001

F770Client(1)

Tipo primer documento

033

033

001

F770BTip()

Primer documento

034

048

015

F770Client(2)

Motivo baja

049

050

002

SPACE(2)                                         

Tipo segundo documento

051

051

001

SPACE(1)                                         

Segundo documento

052

056

015

SPACE(15)                                        

UF Documento

067

068

002

F770BEst()

Coobligado

069

069

001

SPACE(1)                                        

Tipo documento coobligado

070

070

001

SPACE(1)                                        

Primer documento coobligado

071

085

015

SPACE(15)                                         

Blancos

086

087

002

SPACE(2)

Tipo segundo documento coobligado

088

088

001

SPACE(1)

Segundo documento coobligado

089

103

015

SPACE(15)

UF Documento

104

105

002

SPACE(2)

Nombre deudor coobligado

106

175

070

SPACE(70)

Fecha nacimiento

176

183

008

SPACE(8)                                         

Nombre padre

184

253

070

SPACE(70)                                        

Nombre madre

254

323

070

SPACE(70)                                        

Dirección completa

324

368

045

F770Client(3)

Barrio correspondiente

369

105

020

F770Client(4)

Municipio correspondiente

389

175

025

F770Client(5)

UF Cobranza

414

415

002

F770Client(6)

CEP Cobranza

416

423

008

F770Client(7)

Valor

424

438

015

F770ValTit()

Identificación del título enviado

439

454

025

FW9->FW9_IDTITU

Blancos

455

488

034

SPACE(34)

DDN Deudor

489

492

004

F770Client(8)

Teléfono deudor

493

501

009

F770Client(9)

Fecha compromiso

502

509

008

F770Vencto()

Valor compromiso

510

524

015

F770ValTit()

Blancos

525

533

009

SPACE(9)

Códigos error

534

593

060

SPACE(60)

Secuencia registro

594

600

007

F770SEQREG()                                      


Trailer:

Campo

Inicio

Final

Tamaño

Contenido

Tipo registro

001

001

001

"9"

Blancos

002

002

001

Space(1)

Códigos errores

003

008

006

Space(6)

Secuencia registro

594

600

007

F770SeqReg()


El layout de devolución SERASA tiene la siguiente estructura:

Campo

Inicio

Final

Tamaño

Variable*

Tipo registro

001

001

001

TP_REG

Lote

120

125

006

CD_LOTE

Tipo archivo

126

126

001

TP_ARQ

Operación

002

002

001

CD_OPER

Tipo operación

025

027

003

TP_OPER

Cliente

034

048

015

CD_CLIENTE

Valor

424

438

015

VL_SERASA

Id del título

439

454

016

ID_TIT

Error

534

593

060

CD_ERRO


*Cada variable corresponde al campo definido en el layout de devolución. Si el layout de devolución se personaliza, estos campos deben mantenerse, solamente pueden incluirse nuevos campos en el layout.

**Las variables se alimentan en cada línea leída del archivo. Para identificar si la línea corresponde al Header, Detail o Trailer del archivo, valide el contenido de la variable TP_REG, donde: "0" = Header; "1" = Detail; "9" = Trailer.