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