Guia de Integração via Webservice
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.
