TRANSMISSÃO DE ARQUIVO DE TÍTULOS XML ENTRE O DISTRIBUIDOR/CARTÓRIO DE PROTESTO E O CRA21 P21 Sistemas

(1)

TRANSMISSÃO DE ARQUIVO DE TÍTULOS XML ENTRE O DISTRIBUIDOR/CARTÓRIO DE

PROTESTO E O CRA21

(2)

2

HISTÓRICO DE REVISÃO

Revisão Data Alterações Tarefa Autor

(3)

3 SUMÁRIO

HISTÓRICO DE REVISÃO ... 2

SUMÁRIO ... 3

OBJETIVO ... 4

URL DE ACESSO AO SISTEMA ... 4

PARÂMETROS DE ENVIO ... 5

NOMENCLATURA DE ARQUIVOS

... 7

REMESSA ... 7

CONFIRMAÇÃO

... 7

RETORNO

... 8

DESISTENCIA

... 8

CANCELAMENTO ... 9

DOWNLOAD DE ARQUIVOS ... 10 ENVIO DE ARQUIVOS ... 13

MENSAGENS – DOWNLOAD REMESSA ... 15

MENSAGENS – DOWNLOAD DESISTÊNCIA ... 15

MENSAGENS – DOWNLOAD CANCELAMENTO ... 15

MENSAGENS – UPLOAD CONFIRMAÇÃO ... 16

MENSAGENS – UPLOAD RETORNO ... 17

MENSAGENS – ATRIBUTOS ... 18 MENSAGENS/CÓDIGOS - REMESSA ... 19 MENSAGENS/CÓDIGOS - DESISTÊNCIA ... 19 MENSAGENS/CÓDIGOS - CANCELAMENTO ... 19 MENSAGENS/CÓDIGOS - CONFIRMAÇÃO ... 19 MENSAGENS/CÓDIGOS - RETORNO ... 21

(4)

4

OBJETIVO

Descrever a realização da tramitação de arquivos de Títulos entre os Distribuidores / Cartórios de Protesto e o CRA21.

URL DE ACESSO AO SISTEMA

1. Homologação (ambiente de testes):

cra[sigla_estado].cra21.com.br/cra[sigla_estado]/xmlprotestos_cartorio.php Ex: http://crasc.cra21.com.br/crasc/xml/xml.php

ATENÇÃO: no ambiente de homologação utilizar o protocolo HTTP

2. Produção (ambiente de funcionamento do sistema):

cra[sigla_estado].crabr.com.br/cra[sigla_estado]/xml/protestos_cartorio.php Ex: https://crasc.crabr.com.br/crasc/xml/xml.php

(5)

5

PARÂMETROS DE ENVIO

1. Os dados (parâmetros) devem ser enviados via protocolo SOAP.

Todos os arquivos enviados ou recebidos nos serviços devem estar em conformidade com o padrão FEBRABAN XML.

2. Ao consumir o WebService, em todos os serviços, a autenticação deverá ser realizada utilizando autenticação básica.

 Deverão ser passados os parâmetros de usuário e senha, fornecidos pela CRA.

 Após a autenticação serão validados os parâmetros de entrada e por último a crítica do arquivo.

3. Serviços disponíveis:

 Remessa => download do arquivo de remessa

 Confirmacao => upload do arquivo de confirmação

 Retorno => upload do arquivo de retorno

 Desistencia => download do arquivo de desistência

 Cancelamento => download do arquivo de cancelamento

 BuscarApresentante => download de apresentantes ativos no município 4. Parâmetros dos serviços disponíveis:

Upload:

 user_arq => nome do arquivo no formato FEBRABAN

 user_dados => conteúdo do arquivo XML Download:

(6)

6 5. O encoding do XML deve estar de acordo com ISO-8859-1.

6. Assim como no HTML, o XML possui entidades, que devem ser substituídas conforme tabela abaixo:

De Para < < > > & & ‘ ' “ "

(7)

7

NOMENCLATURA DE ARQUIVOS

REMESSA

BNNNDDMM.AAS, onde:

 B: constante que indica ser arquivo de Remessa;

 NNN: código numérico do Apresentante;

 DD: dia;

 MM: mês;

 AA: ano de referência;

 S: sequencial do arquivo (mínimo 1, máximo 9).

Ex: B0002401.121 (Arquivo único de 24/01/2012 e sequencial 1).

Obs: o campo “NNN” pode ser alterado para mais posições no caso de apresentantes conveniados que não são bancos.

CONFIRMAÇÃO

CNNNDDMM.AAS, onde:

 C: constante que indica ser arquivo de Confirmação;

 DD: dia;

 MM: mês;

Ex: C3412401.121 (Arquivo do Itaú de 24/01/2012 e sequencial 1).

(8)

8 RETORNO

RNNNDDMM.AAS, onde:

 R: constante que indica ser arquivo de Confirmação;

 DD: dia;

 MM: mês;

Ex: R3412401.121 (Arquivo do Itaú de 24/01/2012 e sequencial 1).

Obs: o campo “NNN” pode ser alterado para mais posições no caso de apresentantes conveniados que não são bancos. DESISTENCIA

DPNNNDDMM.AAS, onde:

 DP: constante que indica ser arquivo de Desistência;

 DD: dia;

 MM: mês;

Ex: DP0002401.121 (Arquivo único de 24/01/2012 e sequencial 1).

(9)

9 CANCELAMENTO

CPNNDDMM.AAS, onde:

 CP: constante que indica ser arquivo de Cancelamento;

 DD: dia;

 MM: mês;

Ex: CP0002401.121 (Arquivo único de 24/01/2012 e sequencial 1).

(10)

10

DOWNLOAD DE ARQUIVOS

1. Informar somente o parâmetro “user_arq”.

2. Serão retornados todos os arquivos de remessa/desistência/cancelamento conforme a data informada no nome do arquivo.

Por exemplo, ao requisitar a REMESSA com o nome do arquivo B0002401.141 será retornada a REMESSA de 24/01/2014 tendo como base a data de envio da remessa pelo apresentante. Serão retornadas remessas de todos apresentantes na data informada. A mesma regra se aplica para o download de CANCELAMENTO/DESISTENCIA.

3. Exemplo do arquivo XML de REMESSA (formato FEBRABAN):

<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>

<nome_arquivo>B0001811.141</nome_arquivo>

<hd h01="0" h02="341" h03="ITAU UNIBANCO SA" h04="18112014" h05="BFO"

h06="SDT" h07="TPR" h08="000353" h09="0002" h10="0002" h11="0002" h12="0000"

h13="659608" h14="043" h15="5300108" h16="" h17="0001" />

<tr t01="1" t02="341" t03="2938231194/6596" t04="ATACADAO DIST COM E IND LTDA"

t05="ATACADAO DIST COM E IND LTDA" t06="75315333000109"

t07="AV MOVAN DIAS DE FIGUEIREDO 6169" t08="02170901" t09="SAO PAULO"

t10="SP" t11="109-00003341-3" t12="DMI" t13="0000084118" t14="30102014"

t15="10112014" t16="001" t17="00000000063558" t18="00000000063558"

t19="PRESIDENTE FIGUEI" t20="M" t21="N" t22="1"

t23="BDA SERVICOS EM CONST. E C. AL" t24="001" t25="17010074000101"

t26="" t27="RUA TURQUEZA 9 VILA B" t28="69735000" t29="PRESIDENTE FIGU"

t30="AM" t31="00" t32="" t33="" t34="00000000" t35="0000000000" t36="0"

t37="00000000" t38="" t39="PITINGA ZO" t40="0000000000" t41="000000"

t42="0000000000" t43="00000" t44="000000000000000" t45="000" t46="0"

t47="" t48="" t49="" t50="0000000000" t51="" t52="0002" />

<tl t01="9" t02="341" t03="ITAU UNIBANCO SA" t04="18112014" t05="00006"

t06="000000000000758422" t07="" t08="0004" /> </remessa>

(11)

11 4. Exemplo do arquivo XML de DESISTENCIA (formato FEBRABAN):

<nome_arquivo>DP0001110.131</nome_arquivo>

<hdb h01="0" h02="341" h03="4684ITAU UNIBANCO SA" h04="05092013"

h05="00003" h06="00003" h07="" h08="00001" />

<hdc h01="1" h02="10" h03="00003" h04="5300108" h05="" h06="00002" /> <tr t01="2" t02="8004376569" t03="21082013" t04="0252N1"

t05="JETTA AUTO PECAS LTDA" t06="00000000216840" t07="S" t08="868000286906"

t09="156207325603" t10="" t11="000000" t12="00003" /> <tr t01="2" t02="8004376576" t03="21082013" t04="0252A"

t05="JETTA AUTO PECAS LTDA" t06="00000000248875" t07="S" t08="868000286906"

t09="156207325595" t10="" t11="000000" t12="00004" /> <tlc t01="8" t02="10" t03="00006" t04="" t05="00006" />

<tlb t01="9" t02="341" t03="ITAU UNIBANCO SA" t04="05092013" t05="00006"

t06="00000000785689" t07="" t08="00007" /> </sustacao>

5. Exemplo do arquivo XML de CANCELAMENTO (formato FEBRABAN):

<nome_arquivo>CP0001811.141</nome_arquivo>

<hdb h01="0" h02="341" h03="2897ITAU UNIBANCO SA" h04="01072013"

h05="00002" h06="00002" h07="" h08="00001" />

<hdc h01="1" h02="10" h03="00002" h04="5300108" h05="" h06="00002" /> <tr t01="2" t02="0000009241" t03="22042001" t04="4623096947"

t05="ELIANE ARRUDA FERNANDES" t06="00000000042991" t07="C" t08="093300890378"

t09="179150044257" t10="" t11="000000" t12="00003" /> <tr t01="2" t02="0000074924" t03="10072006" t04="0778462416"

t05="JORGE LUIZ SILVA DE SOUZA" t06="00000000068053" t07="C"

t08="093300890378" t09="179193895053" t10="" t11="000000" t12="00004" /> <tlc t01="8" t02="10" t03="00004" t04="" t05="00005" />

(12)

12

t06="00000000111044" t07="" t08="00006" /> </sustacao>

(13)

13

ENVIO DE ARQUIVOS

1. O conteúdo do arquivo deve estar de acordo com o Layout XML da FEBRABAN. O arquivo pode conter mais de uma confirmação/retorno, agrupadas uma abaixo da outra (uma remessa para cada apresentante). Desde que esteja em conformidade com o Padrão.

2. Exemplo do arquivo XML de CONFIRMAÇÃO (formato FEBRABAN):

<?xml version="1.0" encoding="ISO-8859-1"?>

<hd h01="0" h02="341" h03="ITAU UNIBANCO SA" h04="18112014" h05="SDT"

h06="BFO" h07="CRT" h08="000353" h09="0002" h10="0002" h11="0002" h12="0000"

h13="659608" h14="043" h15="5300108" h16="" h17="0001" />

<tr t01="1" t02="341" t03="2938231194/6596" t04="ATACADAO DIST COM E IND LTDA"

t05="ATACADAO DIST COM E IND LTDA" t06="75315333000109"

t07="AV MOVAN DIAS DE FIGUEIREDO 6169" t08="02170901" t09="SAO PAULO"

t10="SP" t11="109-00003341-3" t12="DMI" t13="0000084118" t14="30102014"

t15="10112014" t16="001" t17="00000000063558" t18="00000000063558"

t19="PRESIDENTE FIGUEI" t20="M" t21="N" t22="1"

t23="BDA SERVICOS EM CONST. E C. AL" t24="001" t25="17010074000101"

t26="" t27="RUA TURQUEZA 9 VILA B" t28="69735000" t29="PRESIDENTE FIGU"

t30="AM" t31="10" t32="0000008176" t33="" t34="18112014" t35="0000000000"

t36="0" t37="00000000" t38="" t39="PITINGA ZO" t40="" t41="" t42=""

t43="00000" t44="000000000000000" t45="000" t46="" t47="" t48="" t49=""

t50="" t51="" t52="0002" />

t06="000000000000758422" t07="" t08="0004" /> </confirmacao>

(14)

14 3. Exemplo do arquivo XML de RETORNO (formato FEBRABAN) com 2 apresentantes:

<?xml version="1.0" encoding="ISO-8859-1"?>

<hd h01="0" h02="341" h03="ITAU UNIBANCO SA" h04="18112014" h05="SDT"

h06="BFO" h07="RTP" h08="000001" h09="0005" h10="" h11="" h12="" h13="659608" h14="043" h15="5300108" h16="" h17="0001" /> <tr t01="1" t02="341" t03="0355068206/6596" t04="" t05="" t06="" t07="" t08="" t09="" t10="" t11="191-82762218-1" t12="" t13="" t14="" t15="" t16="001" t17="00000000065021" t18="00000000065021" t19="" t20="" t21="" t22="" t23="" t24="" t25="" t26="" t27="" t28="" t29="" t30="" t31="10" t32="0000008141" t33="2" t34="07112014" t35="0000008924" t36="" t37="17112014" t38="" t39="" t40="" t41="" t42="" t43="" t44="" t45="" t46="" t47="" t48="" t49="" t50="00000000000000" t51="" t52="0002" />

t06="000000000000384268" t07="" t08="0007" />

<hd h01="0" h02="237" h03="BANCO BRADESCO S A" h04="18112014" h05="SDT"

h06="BFO" h07="RTP" h08="000002" h09="0001" h10="" h11="" h12="" h13="100320" h14="043" h15="5300108" h16="" h17="0001" /> <tr t01="1" t02="237" t03="003702800087637" t04="" t05="" t06="" t07="" t08="" t09="" t10="" t11="009134246006252" t12="" t13="" t14="" t15="" t16="001" t17="00000000040000" t18="00000000040000" t19="" t20="" t21="" t22="" t23="" t24="" t25="" t26="" t27="" t28="" t29="" t30="" t31="10" t32="0000008144" t33="1" t34="11112014" t35="0000000000" t36="" t37="14112014" t38="" t39="" t40="" t41="" t42="" t43="" t44="" t45="" t46="" t47="" t48="" t49="" t50="00000000001500" t51="" t52="0002" /> <tl t01="9" t02="237" t03="BANCO BRADESCO S A" t04="18112014" t05="00001"

t06="000000000000040000" t07="" t08="0003" /> </retorno>

(15)

15

MENSAGENS – DOWNLOAD REMESSA

<nome_arquivo>B0001911.141</nome_arquivo>

<ocorrencia>NÃO EXISTE REMESSA NA DATA INFORMADA.</ocorrencia>

</relatorio>

MENSAGENS – DOWNLOAD DESISTÊNCIA

<nome_arquivo>DP0001911.141</nome_arquivo>

<ocorrencia>NÃO EXISTE DESISTÊNCIA NA DATA INFORMADA.</ocorrencia>

</relatorio>

MENSAGENS – DOWNLOAD CANCELAMENTO

<nome_arquivo>CP0001911.141</nome_arquivo>

<ocorrencia>NÃO EXISTE CANCELAMENTO NA DATA INFORMADA.</ocorrencia>

(16)

16

MENSAGENS – UPLOAD CONFIRMAÇÃO

Envio com sucesso

<ocorrencia>APRESENTANTE: ITAÚ (341) - SEQUENCIAL REMESSA: 000353 (2 TÍTULOS).</ocorrencia>

</comarca> </relatorio>

Envio com erro

<ocorrencia>JÁ• FOI ENVIADA REMESSA COM O MESMO SEQUENCIAL (000353) PARA O MUNICÍPIO (5300108).</ocorrencia>

Envio com erro no arquivo

<nome_arquivo>C3411811.141</nome_arquivo>

<ocorrencia>O ARQUIVO C3411811.141 JÁ• FOI ENVIADO EM 18/11/2014.</ocorrencia>

(17)

17

MENSAGENS – UPLOAD RETORNO

Envio com sucesso

<ocorrencia>APRESENTANTE: 341 – ITAÚ (5 TÍTULOS).</ocorrencia>

Envio com erro

<ocorrencia>CÓDIGO DO MUNICÍPIO INFORMADO NO ARQUIVO (5500108) NÃO CORRESPONDE AO SEU MUNICÍPIO.</ocorrencia>

Envio com erro no arquivo

<nome_arquivo>R0001811.141</nome_arquivo>

<ocorrencia>O ARQUIVO R0001811.141 JÁ• FOI ENVIADO EM 18/11/2014.</ocorrencia>

(18)

18

MENSAGENS – ATRIBUTOS

Atributo Descrição

nome_arquivo Nome do arquivo no processamento

datahora Data e hora do processamento no WebService dataoperacao Data do movimento considerada pelo sistema da CRA

codigo Código da mensagem

ocorrencia Descrição da mensagem

registro Linha do registro do arquivo com erro

(19)

19

MENSAGENS/CÓDIGOS - REMESSA

CÓDIGO DESCRIÇÃO

0001 Falha na autenticação.

0009 A instituição (xxx) do usuário está inativa 0002 Nome do arquivo inválido.

0003 Não existe remessa na data informada.

MENSAGENS/CÓDIGOS - DESISTÊNCIA

0006 Não existe desistência na data informada.

MENSAGENS/CÓDIGOS - CANCELAMENTO

0007 Não existe cancelamento na data informada.

MENSAGENS/CÓDIGOS - CONFIRMAÇÃO

0000 Envio efetuado com sucesso 9999 Erro no processamento do arquivo

(20)

20 0001 Falha na autenticação.

2101 Arquivo contém caractere que não está no padrão ASCII. Linha: XXX - Coluna(s): XXX. 2102 Arquivo corrompido. Tamanho da linha inválido. Tamanho: XXX - Linha: XXX.

2107 Arquivo corrompido. Número de controle do devedor (XXX) não está contínuo.

2108 Arquivo corrompido. Soma de títulos existentes no arquivo (XXX) não confere com total informado no header (XXX). 2109 Arquivo corrompido. Soma de indicações existentes no arquivo (XXX) não confere com total informado no header (XXX). 2110 Arquivo corrompido. Soma de originais existentes no arquivo (XXX) não confere com total informado no header (XXX). 2114 Arquivo corrompido. Número sequencial do registro no header (XXX) não está contínuo. Faltou registro (XXX).

2116 O arquivo XXX já foi enviado em XXX.

2117 Já foi enviada remessa com o mesmo sequencial (XXX) para o município (XXX).

2120 Arquivo corrompido. Número sequencial do registro na transação (XXX) não está contínuo. Faltou registro (XXX).

2122 Arquivo corrompido. Soma de registros de transação existentes no arquivo (XXX) não confere com total informado no header (XXX). 2123 Arquivo corrompido. Somatório do saldo no trailler (XXX) não confere com somatório dos saldos dos títulos (XXX).

2126 Arquivo corrompido. Número sequencial do registro no trailler do cartório (XXX) não está contínuo. Faltou registro (XXX). 2134 Protocolo inválido (XXX).

2135 Data do protocolo inválida (XXX).

2136 Arquivo corrompido. Somatório de segurança dos registros (XXX) não confere com a soma das quantidades informadas no header (XXX). 2142 Código do município informado no arquivo (XXX) não corresponde ao seu município.

2143 Não existe remessa (XXX) do apresentante (XXX - XXX) para ser confirmada. 2144 Arquivo corrompido. Este arquivo não é de confirmação de remessa (tipo CRT).

(21)

21 2146 Código de ocorrência inválido (XXX).

2147 Código de irregularidade inválido (XXX). 2148 Data de ocorrência inválida (XXX).

2149 Data do protocolo (XXX) anterior à data da remessa (XXX) 2150 Código de cartório não informado.

2151 Código de cartório inválido ou não encontrado no município (XXX).

2152 Código do cartório informado no arquivo deve ser o mesmo do cartório logado. 2153 Campo "XXX" diferente do informado no envio da remessa.

2154 Apresentante: XXX - Sequencial Remessa: XXX não foi encontrado na CRA. 2155 Já foi enviado título com o Protocolo XXX e Data XXX no dia XXX.

2156 Os dados da devolução devem ser os mesmos para todos os devedores do título. 2157 Os dados da confirmação devem ser os mesmos para todos os devedores do título.

2158 Apresentante: XXX (XXX) - Sequencial Remessa: XXX (Faltam títulos enviados na remessa).

MENSAGENS/CÓDIGOS - RETORNO

0000 Envio efetuado com sucesso 9999 Erro no processamento do arquivo 0001 Falha na autenticação.

2101 Arquivo contém caractere que não está no padrão ASCII. Linha: XXX - Coluna(s): XXX. 2102 Arquivo corrompido. Tamanho da linha inválido. Tamanho: XXX - Linha: XXX.

(22)

22 2116 O arquivo %s já foi enviado em %s.

2120 Arquivo corrompido. Número sequencial do registro na transação (%s) não está contínuo. Faltou registro (%s). 2121 Arquivo corrompido. Número sequencial do registro no trailler (%s) não está contínuo. Faltou registro (%s).

2122 Arquivo corrompido. Soma de registros de transação existentes no arquivo (%d) não confere com total informado no header (%d). 2123 Arquivo corrompido. Somatório do saldo no trailler (%.2f) não confere com somatório dos saldos dos títulos (%.2f).

2142 Código do município informado no arquivo (%s) não corresponde ao seu município. 2146 Código de ocorrência inválido (%s).

2147 Código de irregularidade inválido (%s). 2148 Data de ocorrência inválida (%s). 2135 Data do protocolo inválida (%s).

2151 Código de cartório inválido ou não encontrado no município (%s).

2152 Código do cartório informado no arquivo deve ser o mesmo do cartório logado. 2154 Apresentante: %s - Sequencial Remessa: %s não foi encontrado na CRA. 2137 Campo (%s) inválido.

2161 Nenhum registro foi gravado.

2162 Arquivo corrompido. Este arquivo não é de retorno de remessa (tipo RTP).

2163 Já foi enviado arquivo de retorno com o sequencial (%s) para o apresentante %s (%s) 2164 Arquivo corrompido. Faltou informar o campo Agência Centralizadora.

2165 Arquivo corrompido. Faltou informar o campo Agência/Código do Cedente. 2166 Arquivo corrompido. Campo Agência Centralizadora inválido (%s).

2167 Arquivo corrompido. Campo Agência/Código do Cedente inválido (%s).

2168 Arquivo corrompido. Campo Agência/Código do Cedente (%s) não pode ser menor que 10 posições. 2169 Arquivo corrompido. Faltou informar o campo nosso número.

(23)

23 2170 Valor do saldo do título no retorno (%.2f) menor que o valor do saldo na remessa (%.2f).

2171 Existem títulos no arquivo com o mesmo protocolo (%s) ou nosso número (%s) para o cartório (%s).

2172 Arquivo corrompido. Somatório de segurança dos registros (%d) não confere com a quantidade informada no trailler (%d). 2173 Custas do cartório não pode ser informada para título pago. Protocolo: %s.

2174 Título liquidado não pode ser informado com custas de distribuição. Protocolo: %s. 2175 Valor do título inválido (%s). É permitido somente caracteres numéricos.

2176 Saldo do título inválido (%s). É permitido somente caracteres numéricos. 2177 Cartório não autorizado a trabalhar com o apresentante (%s - %s).

2178 Campo Nosso Número do retorno está diferente do informado na remessa. 2179 Título não foi encontrado na remessa.