Guia de Integração via Webservice

O conveniado utiliza o CRA21 para enviar uma variedade de arquivos aos cartórios de protesto, todos contidos em arquivos XML. Os arquivos de envio 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.

O CRA21 retorna arquivos XML conforme os cartórios atualizam as informações dos títulos. Os arquivos que deverão ser baixados são:

• Confirmações: 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, e a indicação de possíveis títulos devolvidos por 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.

Endpoints do Sistema (URLs)

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.