inter-pj v0.5.0

Cobranças: boletos com Pix para os clientes da empresa, da emissão ao cancelamento, com o QR Code do Pix no terminal e em PNG.

Adicionado

• inter-pj cobranca emitir: emite uma cobrança com boleto e Pix pelas opções (casos simples) ou por --arquivo (JSON com os campos da API, inclusive beneficiário final e nota fiscal, ou - para a entrada padrão), conferida localmente com mensagens que apontam a opção ou o campo; campos desconhecidos no arquivo são recusados. O resumo mostra o valor por extenso, até quando vale o desconto e quando a cobrança não paga é cancelada, e avisa sobre multa e juros que não chegam a valer (--dias-agenda 0 cancela a cobrança no vencimento), prazo de desconto já passado e vencimento no mesmo dia (só até as 19h59). Confirmação, --sim e --simular; sem chave de idempotência, um resultado incerto sai com o código 9 e vem com o comando que procura a cobrança antes de emiti-la de novo. Com --aguardar [--timeout 60s], espera a emissão e mostra o boleto e o Pix, com --qrcode e --qrcode-png (#28).
• inter-pj cobranca modelo: imprime um arquivo de exemplo para cobranca emitir --arquivo, com dados fictícios e vencimento em 30 dias (#28).
• inter-pj cobranca consultar <codigo>: situação, valores, encargos, pagador, boleto (linha digitável formatada e código de barras) e Pix de uma cobrança, em texto ou JSON; --qrcode desenha o QR Code do Pix no terminal (preto no branco em qualquer tema; sem cores com NO_COLOR ou saída redirecionada) e --qrcode-png o grava em PNG, depois de conferir o CRC do copia e cola; sem um Pix que dê o QR Code, os dois terminam com o código 5, sem mostrar a cobrança (#29, #31).
• inter-pj cobranca pdf <codigo> [--saida ARQUIVO|-] [--sobrescrever]: PDF da cobrança com o boleto e o QR Code, gravado com permissão 600 (#29).
• inter-pj cobranca listar: cobranças de um período por vencimento (padrão), emissão ou pagamento, com filtros de situação, pagador, CPF/CNPJ, seu número e tipo, ordem e todas as páginas (ou --pagina), em texto com totais, JSON ou CSV com os nomes da API (#29).
• inter-pj cobranca sumario: quantidade e valor das cobranças do período por situação, com total, em texto, JSON ou CSV (#29).
• inter-pj cobranca cancelar <codigo> --motivo TEXTO: cancela uma cobrança depois de consultá-la, mostrá-la e pedir confirmação; cobranças pagas, canceladas ou expiradas são recusadas sem nenhuma alteração, e, sem terminal nem --sim, nenhuma requisição é feita. Um resultado incerto (tempo esgotado, erro 5xx) sai com o código 9, como em editar e pagar, com o comando que confere a cobrança (#30).
• inter-pj cobranca editar <codigo> [--valor] [--vencimento]: altera o valor e o vencimento, os únicos campos que a API aceita, mostrando o antes e o depois; com --aguardar, acompanha a alteração até o fim, saindo com 5 se ela não foi feita e 8 se o tempo acabou (#30).
• inter-pj cobranca edicao <codigo-edicao> [--aguardar [--recem-pedida]]: mostra em que pé está uma alteração; --recem-pedida, que o comando sugerido por editar traz, continua a espera enquanto a API ainda não mostra a alteração (#30).
• inter-pj cobranca pagar <codigo> --com boleto|pix: paga uma cobrança no sandbox, para testar o fluxo completo; em produção, é recusado antes de qualquer requisição (#32).
• Biblioteca: InterClient::cobranca, com Cobranca::emitir (cobrança com boleto e Pix, conferida localmente: seu número, valor, pagador com CPF/CNPJ, UF e CEP, desconto, multa, mora, mensagem, formas de recebimento e nota fiscal, cuja chave de acesso confere número e série; o tipo de pessoa vem do documento) e Cobranca::consultar (situação, valores, encargos, boleto, Pix e nota fiscal) (#28).
• Biblioteca: Cobranca::listar e listar_todas (período por vencimento, emissão ou pagamento, situação, pagador, seu número, tipo e ordenação, com páginas de até 1.000), sumario (quantidade e valor por situação), pdf, cancelar (com o motivo conferido por cobranca::motivo_cancelamento), editar (vencimento e valor) com consultar_edicao, e pagar_no_sandbox, recusado fora do sandbox sem nenhuma requisição (#29, #30, #32).

Alterado

• Os códigos de saída 5 e 8 valem também para cobranca emitir, cobranca editar e cobranca edicao com --aguardar (cobrança não emitida ou alteração não feita; tempo esgotado), e o 9, para uma consulta de cobranca emitir ou cobranca editar com --aguardar que falha de um jeito que esperar não resolve. Nesses dois comandos, os erros 8 e 9 trazem o código da cobrança ou da alteração pedida e o comando que a acompanha. 429, 5xx e falhas de rede durante a espera só adiam a próxima consulta, e, em cobranca edicao, um código que a API não conhece é um erro na hora, a não ser com --recem-pedida: aí o 404 só adia a próxima consulta e, se durar até o fim do tempo, o comando sai com 8, como em editar.