TRANSMISSÃO DE ARQUIVO DE TÍTULOS XML ENTRE O CARTÓRIO DE PROTESTO E O

EDITAL21
(Versão 1.9)
P21 Sistemas
P21
Transmissão XML EDITAL21

SUMÁRIO
SUMÁRIO .................................................................................................................................. 2
OBJETIVO ................................................................................................................................. 3
HISTÓRICO DE VERSÕES ...................................................................................................... 3
URL DE ACESSO AO SISTEMA .............................................................................................. 3
URL DE ACESSO AO SERVIÇO .............................................................................................. 4
PARÂMETROS DE ENVIO ....................................................................................................... 4
ARQUIVO XML .......................................................................................................................... 5
NOMENCLATURA DO ARQUIVO ............................................................................................ 5
PREENCHIMENTO DOS CAMPOS ......................................................................................... 6
ESTRUTURA DO ARQUIVO..................................................................................................... 6
EXEMPLO ARQUIVO XML ....................................................................................................... 7
DESCRIÇÃO DOS CAMPOS .................................................................................................... 8
REGISTRO HEADER – Tag <header> ........................................................................... 8
REGISTRO DE TRANSAÇÃO –Tag <titulo> ................................................................. 8
REGISTRO TRANSAÇÃO – Tag <devedor> ................................................................. 9
REGISTRO DE TRAILLER –Tag <trailler> .................................................................... 9

2
P21
Transmissão XML EDITAL21

OBJETIVO

Descrever a realização da tramitação de arquivos de editais entre os cartórios de protesto e o EDITAL21.

HISTÓRICO DE VERSÕES
Versão Data Alterações
1.0 12/07/2012 Criação do documento.
1.1 11/08/2017 Inclusão dos encargos ISS, FRJ e AR
Inclusão do campo <fins_falimentares>.
1.2 25/08/2017
Atualização da descrição sobre o valor do pagamento na tag <juros>.
1.4 17/01/2018 Atualização do exemplo de edital.
1.5 27/02/2018 Substituição da sigla do estado SC para UF, no link de acesso aos ambientes.
1.6 07/03/2018 Atualização do link de homologação/produção e orientações de envio
1.7 16/03/2018 Inclusão do tipo de documento para devedores
1.8 11/09/2018 Atualização do link (https) para consumir o serviço do edital
1.9 01/06/2021 Atualização do Layout – Remoção de tags não obrigatórias

URL DE ACESSO AO SISTEMA

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

http://UF.teste.edital21.com.br/admin

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

https://UF.edital21.com.br

3
P21
Transmissão XML EDITAL21

URL DE ACESSO AO SERVIÇO

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

[sigla_estado].teste.edital21.com.br/service?wsdl

http://UF.teste.edital21.com.br/service?wsdl

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

[sigla_estado]..edital21.com.br/service?wsdl

https://UF.edital21.com.br/service?wsdl

PARÂMETROS DE ENVIO

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

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 pelo IEPTB.

 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:
 edital => upload de edital

4. Parâmetros dos serviços disponíveis:

Upload:

 userArq => nome do arquivo no formato EDDMMAA.xml (ver Nomenclatura do Arquivo pág. 5)
 userDados => conteúdo do arquivo XML

4
P21
Transmissão XML EDITAL21

ARQUIVO XML
Para maiores informações sobre o preenchimento dos campos XML e qual o padrão adotado, acessar os links:

https://www.w3schools.com/xml/

https://www.w3schools.com/xml/xml_elements.asp

NOMENCLATURA DO ARQUIVO

EDDMMAA.xml

 E: constante que indica ser arquivo de Edital;

 DD: dia;
 MM: mês;
 AA: ano;

5
P21
Transmissão XML EDITAL21

PREENCHIMENTO DOS CAMPOS

Campos Numéricos: Preencher com números.

Campos decimais Preencher com casas decimais separadas por um ponto. Ex: 1725.99

Campos Alfanuméricos: Preencher com letras e/ou números.

Campos de Data: Preencher no formato DD/MM/AAAA.

ESTRUTURA DO ARQUIVO
O cartório deverá informar apenas um dia de movimento em cada arquivo.
A maioria dos campos é opcional, porém, é recomendado o preenchimento de todos os campos possíveis para que a consulta ao Edital, no Jornal do
Protesto, seja mais efetiva.

O arquivo será composto por 3 tipos de registro:

1 registro de header
1 ou mais registros de transação (títulos)
1 registro de trailler

<?xml version="1.0" encoding="UTF-8"?>

<edital>
<header></header>
<titulos>
<titulo></titulo>
<titulo></titulo>
<titulos>
<trailler></trailler>
</edital>

6
P21
Transmissão XML EDITAL21

EXEMPLO ARQUIVO XML

<?xml version="1.0" encoding="UTF-8"?>
<edital>
<header>
<data_geracao>17/01/2018</data_geracao>
<data_movimento>17/01/2018</data_movimento>
</header>
<titulos>
<titulo>
<devedores>
<devedor>
<nome>JOAQUIM JOSÉ DA SILVA XAVIER</nome>
<tipo>2</tipo>
<documento>27846518780</documento>
</devedor>
<devedor>
<nome>ALTAIR DA SILVA CUNHA</nome>
<tipo>2</tipo>
<documento>85464342125</documento>
</devedor>
</devedores>
<nome_apresentante>Banco Bradesco SA</nome_apresentante>
<protocolo>0000241545</protocolo>
<data_protocolo>06/07/2017</data_protocolo>
<especie>DMI</especie>
<numero>785550001</numero>
<data_pagamento>17/01/2018</data_pagamento>
<saldo>1600.00</saldo>
<motivo_edital>Ausente</motivo_edital>
</titulo>
</titulos>
<trailler>
<data_movimento>17/01/2018</data_movimento>
<total_registros>1</total_registros>
</trailler>
</edital>

7
P21
Transmissão XML EDITAL21

DESCRIÇÃO DOS CAMPOS

REGISTRO HEADER – Tag <header>

Elemento Descrição Tipo

data_geracao Informar a data em que o arquivo foi gerado. Data

data_movimento Informar a data de publicação dos editais contidos no arquivo Data

REGISTRO DE TRANSAÇÃO –Tag <titulo>

Elemento Descrição Tipo

devedores Ver detalhes do elemento na seção Tag devedor <devedores>

nome_apresentante Nome do apresentante Alfanumérico
protocolo Protocolo do título Alfanumérico
data_protocolo Data de protocolo do título Data
especie Espécie do título Alfanumérico
numero Número do título Alfanumérico
data_pagameto Data (prazo) de pagamento Data
saldo Saldo do título Decimal
motivo_edital Preencher com a descrição do motivo do Edital Alfanumérico

8
P21
Transmissão XML EDITAL21

REGISTRO TRANSAÇÃO – Tag <devedor>

Elemento Descrição Tipo

nome Nome do devedor Alfanumérico

tipo Informar o tipo de documento do devedor: Numérico
1 - CNPJ
2 - CPF
documento Documento do devedor Alfanumérico

REGISTRO DE TRAILLER –Tag <trailler>

Elemento Descrição Tipo

data_movimento Informar a data de publicação dos editais contidos no arquivo Data

total_registros Total de títulos no arquivo Numérico