release 2.2.1

changelog.md

@@ -11,6 +11,9 @@ Nem sempre o usuário recebedor tem a posse de todas as informações que consta
 * [[#307](https://github.com/bacen/pix-api/issues/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](https://github.com/bacen/pix-api/issues/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. 

openapi.yaml

@@ -1532,12 +1532,27 @@ paths:
           $ref: "#/components/responses/NaoEncontrado"
         "503":
           $ref: "#/components/responses/ServicoIndisponivel"
-      callbacks:   
-        listaPix:   
+      callbacks:
+        listaPix:
           "{$request.body#/webhookUrl}/pix":
             post:
               description: |
-                Esse serviço está protegido por uma camada de autenticação mTLS.
+                 O callback deve ser acionado sempre que um ou mais Pix associados a um txid forem recebidos
+                 pelo usuário recebedor e desde que a chave associada ao Pix em questão esteja
+                 associada a um webhook cadastrado.
+                 
+                 O callback também deve ser acionado sempre que uma devolução associada a um Pix
+                 associado a um txid seja liquidada.
+                
+                 O SLA específico a ser definido no contexto dos acionamento dos callbacks fica a
+                 cargo de cada PSP recebedor. Orienta-se, no entanto, que o SLA seja definido dentro
+                 de um limite razoável tendo em vista que a expectativa é que o callback seja um aviso "on-line" da
+                 ocorrência do pagamento.
+                
+                 No contexto da estratégia específica de SLA de cada PSP recebedor, é possível agrupar
+                 Pix associados a uma mesma chave para economizar acionamentos múltiplos.
+                 Este serviço está protegido por uma camada de autenticação mTLS. Para maiores detalhes,
+                 verificar o [Manual de padrões para iniciação do Pix](https://www.bcb.gov.br/estabilidadefinanceira/pix).
               security: []
               requestBody:
                 $ref: "#/components/requestBodies/WebhookPixBody"
@@ -2614,7 +2629,7 @@ components:
     CobDataDeVencimento:
       type: "object"
       title: "Data de Vencimento"
-      required: ["dataDeVencimento","validadeAposVencimento"]
+      required: ["dataDeVencimento"]
       properties:
         dataDeVencimento:
           type: "string"

readme.md

@@ -10,9 +10,9 @@
 
 O branch `master` da API pode ser visualizado __[aqui](https://bacen.github.io/pix-api/index.html)__
 
-# Release Corrente: 2.2.0
+# Release Corrente: 2.2.1
 
-* A release corrente da API Pix pode ser encontrada neste __[link](https://github.com/bacen/pix-api/releases/tag/2.2.0)__.
+* A release corrente da API Pix pode ser encontrada neste __[link](https://github.com/bacen/pix-api/releases/tag/2.2.1)__.