Nesse passo vamos precisar apenas do IdIntegracao para solicitar o PDF.
POST
Homologação:
https://homologacao.plugboleto.com.br/api/v1/boletos/impressao/lote
Produção:
https://plugboleto.com.br/api/v1/boletos/impressao/lote
Headers
Nome | Descrição | Exemplo |
Content-Type | Indica o tipo de arquivo | application/json |
cnpj-cedente | CNPJ do Cedente | 01001001000113 |
cnpj-sh | CNPJ da Software House | 01001001000113 |
token-sh | Token da Software House | f22b97c0c9a3d41ac0a3875aba69e5aa |
Objeto
Para solicitar o PDF, o objeto JSON pode ter os seguintes campos:
Campo | Tipo | Descrição |
TipoImpressao | string |
Valores aceitos: 0 - PDF normal. 1 - PDF carnê duplo (paisagem). 2 - PDF carnê triplo (retrato). 3 - PDF dupla (retrato). 4 - PDF normal (Com marca D'água). 99 - PDF personalizada. |
Boletos | array | Array de Ids de integração. Para mais de um boleto, deve-se usar a vírgula como separador. |
Personalizacao | Objeto | Objeto com variáveis livres, informadas na personalização. |
Body
Exemplo de JSON:
{
"TipoImpressao" : "1",
"Boletos" : [
"IdIntegracao1",
"IdIntegracao2"
]
}
Apenas as situações EMITIDO, REGISTRADO, LIQUIDADO e BAIXADO permitem a geração do PDF. Ah, lembre-se que, para imprimir mais de um Id, você deve informar a vírgula como separador.
Retorno
Exemplo de retorno:
{
"_status": "sucesso",
"_mensagem": "Impressão em processamento",
"_dados": {
"situacao": "PROCESSANDO",
"protocolo": "S1xeMu5TbZ"
}
}
Exemplo de retorno com erro:
{
"_status": "erro",
"_mensagem": "Id(s) informado(s) não encontrado(s).",
"_dados": [
{
"boletos": [
"IdIntegracao1",
"IdIntegracao2"
]
}
]
}
- Em nossa rota de impressão, possuímos um limite de solicitações de até 100 (cem) boletos por chamada, para os tipos: 0, 1, 2, 3 e 4.
- Para o tipo de impressão personalizada (99), possuímos um limite de 50 boletos por chamada em nossa rota de impressão.
Em caso de sucesso, a rota irá retornar um número de protocolo através do campo protocolo. Isso acontece pois a rota é assíncrona. Usando esse número de protocolo, nosso próximo passo é consultá-lo e verificar o resultado do processamento da geração do PDF.
Comentários
0 comentário
Por favor, entre para comentar.