Após fazermos a solicitação da remessa de alteração, chegou a hora de consultar o protocolo obtido para efetivamente, receber o conteúdo do arquivo de remessa de alteração ou saber se ela foi gerada com sucesso e encaminhada ao banco (caso utilize a Transmissão Automátia).
Para fazermos essa consulta, vamos precisar do protocolo gerado na requisição anterior.
GET
A solicitação é feita através de uma requisição GET. A rota chamada deve ter a seguinte URL:
Homologação:
https://homologacao.plugboleto.com.br/api/v1/boletos/altera/lote/:protocolo
Produção:
https://plugboleto.com.br/api/v1/boletos/altera/lote/:protocolo
*Aqui temos um exemplo da URL completa, informando um número de protocolo:
Headers
| Nome | Descrição | Exemplo |
| cnpj-sh | CNPJ da Software House | 01001001000113 |
| cnpj-cedente | CNPJ da Cedente | 01001001000113 |
| token-sh | Token da Software House | f22b97c0c9a3d41ac0a3875aba69e5aa |
Headers (Opcional)
Utilizar esses headers em caso de autenticação direto com as credenciais do cedente:
| Nome | Descrição | Exemplo |
| Content-Type | Indica o tipo de arquivo | application/json |
| cnpj-cedente | CNPJ do Cedente | 01001001000113 |
| token-cedente | Token do Cedente | f22b97c0c9a3d41ac0a3875aba69e5aa1 |
Retorno
Exemplo de retorno:
{
"_status": "sucesso",
"_dados": {
"_sucesso": [
{
"numero": 4,
"arquivo": "COB_341_247033_010717_00004.rem",
"remessa": "MDFSRU1FU1NBMDFDT0JSQU5DQSAgICAgICAzNzg4MDAyNDcwMzMgICAgICAgIFRFQ05PU1BFRUQgVEVDTk9MT0dJQSBEQSBJTkZPUjM0MUJBTkNPIElUQVUgU0EgIDMwMDYxNyAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIDAwMDAwMQ0KMTAyMDgxODcxNjgwMDAxNjAzNzg4MDAyNDcwMzMgICAgMDAwMCAgICAgICAgICAgICAgICAgICAgICAgICAwMDAwMDYwMjAwMDAwMDAwMDAwMDAxMDkgICAgICAgICAgICAgICAgICAgICBJMDEwOTA4MTYgICAgMzAxMDE5MDAwMDAwMDAwMDAwMjM0MTAwMDAwOTlOMjExMDE2MDkwMDAwMDAwMDAwMDAwMDEwODExMTYwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMTAwMDA0Nzc5MjQ5OTk2RmVybmFuZG8gTWlnbGlvcmluaSBUZW5vcmlvICAgICAgICAgICAgIFJ1YSBDYXN0cm8gQWx2ZXMsIDcyOCwgNzI4LCBCTDEgQVAwNzUgICBab25hIDA2ICAgICA4NzAxNTQ0ME1hcmluZ2EgICAgICAgIFBSICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIDAwMDAwMDYwIDAwMDAwMg0KOSAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIDAwMDAwMw0K",
"titulos": [
{
"campo": null,
"valor": null,
"idintegracao": "IdIntegracao1"
}
],
"mensagem": "Remessa gerada com sucesso",
"situacao": "GERADA",
"uniqueId": "SD48F945S",
"CedenteContaNumero": "24703",
"CedenteConvenioNumero": "3788247033",
"transmissaoAutomatica": false,
"CedenteContaCodigoBanco": "341"
}
],
"_falha": []
}
}
Neste JSON de resposta, dentro do objeto "remessa" você receberá o conteúdo da remessa encodado em base64. O próximo passo que seu sistema deve fazer é capturar este base64 e "decodar", para formato texto comum. Depois disso, você já pode salvar em arquivo e encaminhar ao banco.
Outro detalhe é que, caso os idIntegracao fornecidos JSON de solicitação da remessa pertençam ao mesmo convênio, será gerada uma única remessa contendo todos os boletos solicitados. Caso contrário, será gerada uma remessa por convênio.
Exemplo de retorno com erro:
{
"_status": "erro",
"_mensagem": "Protocolo inválido ou inexistente."
}
Exemplo de retorno 'em processamento':
{
"_status": "sucesso",
"_mensagem": "Solicitação pendente de processamento",
"_dados" : {
"situacao": "PROCESSANDO"
}
}
O status acima indica que o arquivo ainda está em processamento na nossa API. Fique tranquilo, se você tiver esse retorno basta refazer a consulta (passando o mesmo protocolo informado inicialmente) até que o arquivo seja devolvido.
Uma implementação interessante neste caso, é colocar este método de consulta do protocolo em um While, que refaz a consulta caso a situação seja igual a "Processando", com um delay de pelo menos 5 segundos entre cada consulta.
As remessas geradas serão importadas no banco, que posteriormente irá devolver um arquivo de retorno. Esse arquivo de retorno também pode ser enviado para a API de Boletos da Tcnospeed para processarmos e gravarmos as novas informações referentes ao valor do boleto ou ao vencimento em nosso banco de dados.
Comentários
0 comentário
Por favor, entre para comentar.