Consultar Ordens de Cancelamento

Alguns estados utilizam a plataforma de cancelamento no sistema CRA21.
A solução consiste em disponibilizar um boleto com as custas de cancelamento para que o devedor possa realizar o pagamento, seja por meio do apresentante, pelo site, no cartório ou gerado diretamente por um usuário da própria CRA.

Quando o pagamento é realizado pelo devedor, a CRA efetua o repasse das custas ao cartório e envia um relatório, por e-mail ou mensagem, com a lista dos cancelamentos que devem ser executados.

Com o aumento no volume de operações, esse processo se tornou inviável. Por isso, foi criado um arquivo específico para ser processado diretamente no cartório, permitindo a realização dos cancelamentos dos protestos cujas custas já foram pagas pelos devedores.

Esse arquivo é denominado OC (Ordem de Cancelamento) e possui um layout similar ao do arquivo de cancelamento convencional.

O processamento desse arquivo, seja em TXT ou XML, deve ter ação imediata no cartório, resultando na geração do cancelamento do título. As custas do cartório são repassadas pela CRA estadual no mesmo dia da liberação da ordem de cancelamento.

O objetivo deste manual é descrever as informações necessárias para que o cartório consiga processar corretamente o arquivo em seu sistema interno.

  • Homologação (ambiente de testes):

craUF.cra21.com.br/craUF/xml/protestos_cartorio.php?wsdl

Ex: https://cradf.cra21.com.br/cradf/xml/protestos_cartorio.php?wsdl

ATENÇÃO: no ambiente de homologação utilizar o protocolo HTTPS
  • Produção (ambiente de funcionamento do sistema):

craUF.crabr.com.br/craUF/xml/protestos_cartorio.php?wsdl


Ex: https://cradf.crabr.com.br/cradf/xml/protestos_cartorio.php?wsdl

ATENÇÃO: no ambiente de produção utilizar o protocolo HTTPS
  • Os dados (parâmetros) devem ser enviados via protocolo SOAP
  • 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
  • Serviços disponíveis:
    • OrdemCancelamento Consulta de ordens de cancelamento
  • Parâmetros dos serviços disponíveis:
    • Upload
      userArq Nome do arquivo no formato OCNNNDDMM.AAS.
    • O encoding do XML deve estar de acordo com ISO-8859-1.
    • O conteúdo dos arquivos enviados para CRA devem seguir o padrão de codificação ASCII

ORDEM DE CANCELAMENTO

  • OCNNNDDMM.AAS, onde:
    • OC: constante que indica ser arquivo de Ordem de Cancelamento;
    • NNN: código do apresentante;
    • DD: dia;
    • MM: mês;
    • AA: ano de referência;
    • S: sequencial do arquivo (mínimo 1, máximo 9).Ex: OC0012608.221

REGISTRO – ARQUIVO ORDEM DE CANCELAMENTO

CLIQUE AQUI E BAIXE O EXEMPLO DO ARQUIVO DE ORDEM DE CANCELAMENTO

Header Arquivo – hdb

Atributo Descrição Tam Tipo Casas Decimais Obrigatório
01 Tipo do Registro: Constante '0' 1 Numérico Nenhuma Sim
02 Código do apresentante 3 Alfanumérico Nenhuma Sim
03 Nome do apresentante 45 Alfanumérico Nenhuma Sim
04 Data do movimento 08 Alfanumérico Nenhuma Sim
05 Quantidade de registros 5 Alfanumérico Nenhuma Sim
08 Sequencial 5 Numérico Nenhuma Sim

Header Cartório – hdc

Atributo Descrição Tam Tipo Casas Decimais Obrigatório
01 Tipo do Registro: Constante '1' 1 Numérico Nenhuma Sim
02 Código do cartório 2 Numérico Nenhuma Sim
03 Quantidade 5 Numérico Nenhuma Sim
06 Sequencial 5 Numérico Nenhuma Sim

Transação – tr

Atributo Descrição Tam Tipo Casas Decimais Obrigatório
01 Tipo do Registro: Constante '2' 1 Numérico Nenhuma Sim
02 Protocolo do título 10 Alfanumérico Nenhuma Sim
03 Data em que o título foi protocolado 08 Data (DDMMAAAA) Nenhuma Sim
04 Número do título 11 Alfanumérico Nenhuma Sim
05 Nome do devedor 45 Alfanumérico Nenhuma Sim
06 Valor do título 14 Numérico Nenhuma Sim
07 Constante “O" 1 Alfanumérico Nenhuma Sim
09 Nosso número 12 Alfanumérico Nenhuma Sim
12 Sequencial do registro 5 Numérico Nenhuma Sim

Trailer Cartório – tlc

Atributo Descrição Tam Tipo Casas Decimais Obrigatório
01 Tipo do Registro: Constante '8' 1 Numérico Nenhuma Sim
02 Código do cartório 2 Numérico Nenhuma Sim
03 Quantidade 5 Numérico Nenhuma Sim
05 Sequencial 5 Numérico Nenhuma Sim

Trailer Arquivo – tlb

Atributo Descrição Tam Tipo Casas Decimais Obrigatório
01 Tipo do Registro: Constante '9' 1 Numérico Nenhuma Sim
02 Código do apresentante 3 Alfanumérico Nenhuma Sim
03 Nome do apresentante 45 Alfanumérico Nenhuma Sim
04 Data do movimento 08 Alfanumérico Nenhuma Sim
05 Quantidade de registros 5 Alfanumérico Nenhuma Sim
06 Somatório do valor 14 Numérico Nenhuma Sim
08 Sequencial 5 Numérico Nenhuma Sim