Exibir origem

Atenção: A implementação dos layouts SERASA de envio e retorno está disponível somente para a versão 12 do Protheus, a partir do release 12.1.6.

Para utilização do envio e recebimento de arquivos SERASA, deve-se importar os layouts MILE serasa_layout_envio.xml e serasa_layout_retorno.xml, disponibilizados junto com o release 12.1.6.

Após a importação dos layouts no MILE, os mesmos poderão ser modificados, de forma a atender alguma customização ou particularidade do ambiente do usuário. Para importar os layouts no MILE, basta serem adotados os procedimentos abaixo:

Linha Microsiga Protheus > SERASA - Layouts de envio e retorno utilizando MILE > SERASA_1.png

Ao selecionar a opção "Importar" dentro do MILE (no SIGACFG, acessar o menu Ambiente > Aceleradores > Mile > Layouts), será exibida tela para seleção do caminho onde está o arquivo de layout MILE para importação.

Linha Microsiga Protheus > SERASA - Layouts de envio e retorno utilizando MILE > SERASA_2.png

Efetuar o procedimento para cada arquivo de layout separadamente e, ao final do procedimento, confirmar a importação dos layouts SERA_ENV e SERA_RET. Uma vez os layouts importados, os mesmos poderão ser alterados. Observação: a nomenclatura dos layouts, SERA_ENV (envio) e SERA_RET (retorno) são padrão para uso no protheus e não podem ser alterados.

Linha Microsiga Protheus > SERASA - Layouts de envio e retorno utilizando MILE > SERASA_3.png

Na alteração dos layouts poderão ser alteradas as posições de captura dos dados, a ordem e etc. Contudo, os segmentos pré-definidos no layout importado devem ser mantidos, para que os arquivos sejam gerados e lidos corretamente.

Linha Microsiga Protheus > SERASA - Layouts de envio e retorno utilizando MILE > SERASA_4.png

Estrutura do layout de envio SERASA

Linha Microsiga Protheus > SERASA - Layouts de envio e retorno utilizando MILE > SERASA_5.png

Estrutura do layout de retorno SERASA

Após a importação e, caso seja opção do usuário, customização dos layouts, ambos serão utilizados pela rotina de processos SERASA (FINA770), disponível no menu do SIGAFIN, na entrada Atualizações > Contas a Receber > SERASA - Processos. Observação: a geração do arquivo de envio só é possível quando existirem lotes de envio gerados, também através da rotina de processos SERASA (FINA770).

Linha Microsiga Protheus > SERASA - Layouts de envio e retorno utilizando MILE > SERASA_6.png

Para gerar o arquivo de envio, na janela da rotina de processos SERASA, deve-se utilizar a opção Exportar lote. Para efetuar o processamento do arquivo de retorno SERASA, na janela da rotina de processos SERASA, deve-se utilizar a opção Arquivo de retorno.

Estrutura do layout SERASA

O layout de envio SERASA possui a seguinte estrutura:

Header:

Campo	Início	Fim	Tamanho	Conteúdo
Código do Registro	001	001	001	'0'
CNPJ	002	010	009	SM0->M0_CGC
Data do Movimento	011	018	008	DtoS(dDataBase)
DDD	019	022	004	A ser definido pelo usuário
Telefone de contato	023	030	008	A ser definido pelo usuário
Ramal telefone contato	031	034	004	A ser definido pelo usuário
Nome do contato	035	104	070	A ser definido pelo usuário
ID arquivo fixo	105	119	015	"SERASA-CONVEM04"
Número da remessa	120	125	006	F770GetArq()
Código envio de arquivo	126	126	001	"E"
Diferencial de remessa	127	130	004	Space(4)
Brancos	131	533	403	Space(403)
Código de erros	534	593	060	Space(60)
Sequência de registro	594	600	007	F770SeqReg()

Detail:

Campo	Início	Fim	Tamanho	Conteúdo
Tipo Registro	001	001	001	"1"
Código Operação	002	002	001	Fa770GetOp()
Filial/Dígito Contratante	003	008	006	*Configurável pelo usuário com as informações do CNPJ do contratante do serviço do Serasa*
Data Ocorrência	009	018	008	F770Vencto()
Data Término Contrato	017	024	008	F770Vencto()
Código Natureza Operação	025	027	003	FW9_TIPO
Código Praça Embratel	028	031	004	SPACE(4)
Tipo Pessoa	032	032	001	F770Client(1)
Tipo Primeiro Documento	033	033	001	F770BTip()
Primeiro Documento	034	048	015	F770Client(2)
Motivo Baixa	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()
Coobrigado	069	069	001	SPACE(1)
Tipo Documento Coobrigado	070	070	001	SPACE(1)
Primeiro Documento Coobrigado	071	085	015	SPACE(15)
Brancos	086	087	002	SPACE(2)
Tipo Segundo Documento Coobrigado	088	088	001	SPACE(1)
Segundo Documento Coobrigado	089	103	015	SPACE(15)
UF Documento	104	105	002	SPACE(2)
Nome Devedor Coobrigado	106	175	070	SPACE(70)
Data Nascimento	176	183	008	SPACE(8)
Nome Pai	184	253	070	SPACE(70)
Nome Mãe	254	323	070	SPACE(70)
Endereço Completo	324	368	045	F770Client(3)
Bairro Correspondente	369	105	020	F770Client(4)
Município Correspondente	389	175	025	F770Client(5)
UF Cobrança	414	415	002	F770Client(6)
CEP Cobrança	416	423	008	F770Client(7)
Valor	424	438	015	F770ValTit()
Número Contrato/Nosso Número	439	488	025	FW9->(FW9_FILORI+FW9_PREFIX+FW9_NUM+FW9_PARCEL)
DDD Devedor	489	492	004	F770Client(8)
Telefone Devedor	493	501	009	F770Client(9)
Data Compromisso	502	509	008	F770Vencto()
Valor Compromisso	510	524	015	F770ValTit()
Brancos	525	533	009	SPACE(9)
Códigos Erro	534	593	060	SPACE(60)
Sequência Registro	594	600	007	F770SEQREG()

Trailer:

Campo	Início	Fim	Tamanho	Conteúdo
Tipo registro	001	001	001	"9"
Brancos	002	002	001	Space(1)
Códigos erros	003	008	006	Space(6)
Sequência registro	594	600	007	F770SeqReg()

O layout de retorno SERASA possui a seguinte estrutura:

Campo	Início	Fim	Tamanho	Variável*
Tipo registro	001	001	001	TP_REG
Lote	120	125	006	CD_LOTE
Tipo arquivo	126	126	001	TP_ARQ
Operação	002	002	001	CD_OPER
Tipo operação	025	027	003	TP_OPER
Cliente	034	048	015	CD_CLIENTE
Valor	424	438	015	VL_SERASA
Título	439	488	050	CD_TITULO
Erro	534	593	060	CD_ERRO

*Cada variável corresponde ao campo definido no layout de retorno. Caso o layout de retorno seja customizado, esses campos devem ser mantidos, apenas novos campos podem ser inseridos no layout.

**As variáveis são alimentadas a cada linha lida do arquivo. Para identificar se a linha corresponde ao Header, Detail ou Trailer do arquivo, validar o conteúdo da variável TP_REG, sendo: "0" = Header; "1" = Detail; "9" = Trailer.