Guia de Integração via Webservice

Estimated reading: 3 minutes 103 views

Documentação Cartórios

A comunicação entre o cartório e o CRA21 é realizada por meio da troca de arquivos no formato XML, permitindo que baixe eletronicamente títulos e documentos de dívida enviado pelos apresentantes.

Arquivos que podem ser enviados pelos Cartórios

O cartório utiliza o CRA21 para enviar uma variedade de arquivos aos conveniados, todos contidos em arquivos XML. Os arquivos de envio são:

Confirmação: São os arquivos enviados pelos cartórios, confirmando o recebimento e o processamento inicial da remessa. Neles, você encontrará os dados dos títulos, o número e a data do protocolo, além de uma indicação dos possíveis títulos devolvidos por alguma irregularidade.
Retornos: Arquivos que trazem a ocorrência de cada título, indicando se foi protestado, pago, cancelado, etc.
Instrumentos de Protesto: Documentos eletrônicos que confirmam a efetivação do protesto de um título.

Arquivos que podem ser baixados pelos Cartórios

O CRA21 envia arquivos XML conforme os conveniados enviam com as informações dos títulos. Os arquivos que deverão ser baixados são:

Remessas: Arquivos que contêm os títulos de dívida a serem protestados.
Autorizações de Desistência e Cancelamento: Autoriza que o devedor solicite a interrupção ou o encerramento de um protesto.
Pedidos de Cancelamentos e Desistências: Solicita o cancelamento ou desistência de um protesto.
Imagens: Documentos e informações adicionais que podem ser anexados à remessa para complementar o processo.
Ofícios: Envio de ofícios para os cartórios referente a algum título.

Informações de Acesso e Configurações

Endpoints do Sistema (URLs)

Ambiente de Homologação (Testes)

Lembre-se de substituir UF pela sigla do estado correspondente.

WSDL: craUF.cra21.com.br/craUF/xml/protestos_cartorio.php?wsdl
Exemplo (DF): https://cradf.cra21.com.br/cradf/xml/protestos_cartorio.php?wsdl

Ambiente de Produção

Para uso oficial, após a conclusão e validação dos testes.

WSDL: craUF.crabr.com.br/craUF/xml/protestos_cartorio.php?wsdl
Exemplo (DF): https://cradf.crabr.com.br/cradf/xml/protestos_cartorio.php?wsdl

Atenção: Em ambos os ambientes, é obrigatório o uso do protocolo HTTPS para todas as requisições.

Configurações do Servidor

Tamanho máximo de arquivos: 100 MB (média).
Tempo limite de upload (Timeout): 30 minutos.

Observação: Caso ocorra um erro de timeout antes dos 30 minutos, verifique as configurações de tempo de espera na sua aplicação cliente.