2.2.2

• [#331]: O campo validadeAposVencimento estava constando como opcional na resposta da criação da cobrança, um efeito colateral da correção correlata ocorrida na release 2.2.1.
• [#334]: adicionados detalhes a respeito da manipulação da revisão da cobrança em cenário de alteração do location.
• [#342]: removidos trechos duplicados na seção de tratamento de erros.

2.2.1

Corrigido:

• Os campos no objeto "devedor" no request do endpoint PUT /cobv/{txid} passam a ser opcionais.
  Nem sempre o usuário recebedor tem a posse de todas as informações que constavam como obrigatórias.
• [#307]: Detalhada a semântica do campo validadeAposVencimento. Passa a apresentar redação
  detalhando o que ocorre em casos de exceção em que o vencimento da cobrança seja um final de semana
  ou um feriado juntamente com a atribuição de um valor pequeno para validadeAposVencimento.
• O campo validadeAposVencimento estava constando como required, o que estava incorreto.
  Quando não preenchido, o PSP recebedor assume o valor deste campo como 30, então não há motivos para
  o campo ser obrigatório.
• [#269]. A regex do txid, na parte concernente ao tamanho, nos endpoints /pix e no callback webhook,
  estava errada. Corrigida de {26,35} para {1,35} porque pode haver a presença de pagamentos de QRs
  estáticos nesses locais.
• [#270]: O id do objeto location estava especificado como int32. De fato, apenas cerca de 2 bilhões
  de possibilidades pode acabar muito rápido para grandes emissores de cobranças. Entendemos que o identificador do objeto lotecobv
  se encaixa na mesma situação. Nesse sentido, alteramos de int32 para int64,
  o que não deve causar maiores problemas no momento.
• [#249], [#250]: Com a entrada do campo "chave" como identificador do webhook, toda a parte referente à paginação
  em GET /webhook perde a razão de existir. Nesse sentido, os parâmetros de busca "inicio" e "fim" passam
  a ser opcionais. O objeto de paginação "parametros", também torna-se opcional.
• [#239]: Conforme relatado nesta discussão, entendemos que
  seria interessante, tanto sob o aspecto de segurança quanto sob o aspecto de funcionalidade, que o
  objeto pix agregue o atributo "chave", opcional.
• [#241]: Acrescentamos detalhes em relação à questão do acionamento do webhook por parte do PSP recebedor.
• [#294]: Erro de ortografia. Na documentação, onde se lê pixUrlAcessToken deveria estar escrito pixUrlAccessToken.
• [#273]: O texto do response 202 do endpoint PATCH lotecobv/{id} estava erroneamente induzindo o
  leitor a pensar que o lote já estava revisado quando, na verdade, estaria apenas em processamento
• [#273]: Na lista de violações em lotecobv, havia indicações do endpoint /lotecobv/{txid}, o que inexiste. O correto é /lotecobv/{id}.
• [#316]: Duas violações específicas foram removidas por questões de performance.

2.2.1-rc.0

Corrigido:

• Os campos no objeto "devedor" no request do endpoint PUT /cobv/{txid} passam a ser opcionais.
  Nem sempre o usuário recebedor tem a posse de todas as informações que constavam como obrigatórias.
• [#307]: Detalhada a semântica do campo validadeAposVencimento. Passa a apresentar redação
  detalhando o que ocorre em casos de exceção em que o vencimento da cobrança seja um final de semana
  ou um feriado juntamente com a atribuição de um valor pequeno para validadeAposVencimento.
• [#269]. A regex do txid, na parte concernente ao tamanho, nos endpoints /pix e no callback webhook,
  estava errada. Corrigida de {26,35} para {1,35} porque pode haver a presença de pagamentos de QRs
  estáticos nesses locais.
• [#270]: O id do objeto location estava especificado como int32. De fato, apenas cerca de 2 bilhões
  de possibilidades pode acabar muito rápido para grandes emissores de cobranças. Entendemos que o identificador do objeto lotecobv
  se encaixa na mesma situação. Nesse sentido, alteramos de int32 para int64,
  o que não deve causar maiores problemas no momento.
• [#249], [#250]: Com a entrada do campo "chave" como identificador do webhook, toda a parte referente à paginação
  em GET /webhook perde a razão de existir. Nesse sentido, os parâmetros de busca "inicio" e "fim" passam
  a ser opcionais. O objeto de paginação "parametros", também torna-se opcional.
• [#239]: Conforme relatado nesta discussão, entendemos que
  seria interessante, tanto sob o aspecto de segurança quanto sob o aspecto de funcionalidade, que o
  objeto pix agregue o atributo "chave", opcional.
• [#241]: Acrescentamos detalhes em relação à questão do acionamento do webhook por parte do PSP recebedor.
• [#294]: Erro de ortografia. Na documentação, onde se lê pixUrlAcessToken deveria estar escrito pixUrlAccessToken.
• [#273]: O texto do response 202 do endpoint PATCH lotecobv/{id} estava erroneamente induzindo o
  leitor a pensar que o lote já estava revisado quando, na verdade, estaria apenas em processamento
• [#273]: Na lista de violações em lotecobv, havia indicações do endpoint /lotecobv/{txid}, o que inexiste. O correto é /lotecobv/{id}.
• [#316]: Duas violações específicas foram removidas por questões de performance.

2.2.0 - API Pix: Tratamento de Erros

Adicionado:

• A API Pix agora estabelece uma série de erros padronizados seguindo a RFC 7807 reunidos na seção
  "Tratamento de erros". Procuramos ser exaustivos com relação aos possíveis erros semânticos.

• Adicionado o endpoint PATCH /lotecobv/{id}. Este endpoint pode ser utilizado quando a intenção do
  usuário recebedor for alterar cobranças específicas dentro do conjunto de cobranças criadas no lote em
  questão. O endpoint PUT /lotecobv/{id} também pode ser utilizado para alterar cobranças, mas deve
  ser atribuído na requisição o array exatamente como especificado na requisição originária, o que torna
  este endpoint ineficiente no caso em que quer se alterar uma cobrança específica ou poucas dentro de um
  array com grande quantidade de cobranças.

• Incorporadas melhorias de redação em alguns endpoints específicos.

Corrigido:

• adiciona o atributo problema no array cobsv no response do endpoint GET /lotecobv/{id}
• corrige os status REMOVIDA_*, que erroneamente vieram como REMOVIDO_* no branch 2.1.X. #222

2.2.0-rc.0 - API Pix: Tratamento de Erros

Adicionado:

• A API Pix agora estabelece uma série de erros padronizados seguindo a RFC 7807 reunidos na seção
  "Tratamento de erros". Procuramos ser exaustivos com relação aos possíveis erros semânticos.

• Adicionado o endpoint PATCH /lotecobv/{id}. Este endpoint pode ser utilizado quando a intenção do
  usuário recebedor for alterar cobranças específicas dentro do conjunto de cobranças criadas no lote em
  questão. O endpoint PUT /lotecobv/{id} também pode ser utilizado para alterar cobranças, mas deve
  ser atribuído na requisição o array exatamente como especificado na requisição originária, o que torna
  este endpoint ineficiente no caso em que quer se alterar uma cobrança específica ou poucas dentro de um
  array com grande quantidade de cobranças.

• Incorporadas melhorias de redação em alguns endpoints específicos.

Corrigido:

• adiciona o atributo problema no array cobsv no response do endpoint GET /lotecobv/{id}
• corrige os status REMOVIDA_*, que erroneamente vieram como REMOVIDO_* no branch 2.1.X. #222

2.1.2 - API Pix: Função Vencimentos

[2.1.2]

• Readme: corrige informações sobre os Manuais
• #172: corrige campos de cobv.devedor na exibição do Payload JSON que não estavam aderentes com o Manual de Iniciação
• #171: corrige descrição do campo cobsv[n].criacao

2.1.1 - API Pix: Função Vencimentos

Corrigido:

• Readme: adiciona menção ao Manual de Padrões para iniciação do Pix.
• #168: corrige descrição do endpoint webhook.

2.1.0 - API Pix: Função Vencimentos

API Pix: Função vencimentos

Esta release incorpora novas funcionalidades à API Pix: Reuso de Location e Cobrança com vencimento. Além disso, agrega melhorias oriundas de sugestões do mercado colhidas no repositório oficial do Bacen no github bem como via Fórum Pix.

2.1.0-rc.5 - API Pix: Função Vencimentos

Adicionado

• A API agora apresenta Endpoints para gerenciamento de Cobranças com Vencimento
• Cobranças com vencimento dispõem de seu próprio endpoint
• A API agora apresenta Endpoints para gerenciamento de Lotes de Cobranças com Vencimento
• Adicionado um endpoint para criação de cobrança imediata com txid criado pelo PSP recebedor
• Adicionados Endpoints para o gerenciamento de Locations, habilitando o caso de uso "Reuso de Locations".
• Adicionado campo para descrição complementar do status da devolucão #148

Correções

• removido o objeto opcional pix.pagador #153
• os webhooks agora são associados a uma chave pix #120
• os endereços dos endpoints agora apresentam corretamente o fragmento v2 #3

2.1.0-rc.4 - API Pix: Função Vencimentos

Correções

• removido endpoint DELETE /cob/{txid}/loc, uma vez que o endpoint PATCH cobre a situação. #108