diff --git a/changelog.md b/changelog.md index 5ccbe5a..95be992 100644 --- a/changelog.md +++ b/changelog.md @@ -2,6 +2,14 @@ Mudanças relevantes na API Pix serão documentadas aqui neste documento. +## [2.6.3] + +- Inclusão de esclarecimento referente ao domínio `AGPSS` do campo `modalidadeAgente` para Pix Saque e Pix Troco, dispondo que ele deve ser convertido para `AGFSS` na elaboração da mensagem `pacs.008`. Optou-se pela não alteração desse domínio (para `AGFSS`) na API Pix neste momento, ficando a uniformização com o Catálogo de Mensagens do SPI reservada para a próxima *major version* da API Pix. +- Descontos em cobranças com vencimento agora podem ser aplicados para datas **menores ou iguais** à data de vencimento. +- Correção dos exemplos `F` e `G` conforme apontado na issue [[#485](https://github.com/bacen/pix-api/issues/485)]. +- Uniformização das descrições dos campos `/lotecobv/{id}` do request e `id` no response do GET `/lotecobv/{id}` que semânticamente são o mesmo valor. +- Remoção do 'pagador' como campo obrigatório do 'Pix' no *seu respectivo schema*. + ## [2.6.2] - Inclusão do valor `AGTOT` no domínio do campo `valor.retirada.troco.modalidadeAgente`. diff --git a/openapi.yaml b/openapi.yaml index 16fc457..bdb94f3 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: title: API Pix - version: "2.6.2" + version: "2.6.3" license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0 @@ -896,7 +896,7 @@ paths: required: true schema: type: "string" - title: "Id do lote de cobranças com vencimento" + title: "Identificador do lote de cobranças com vencimento, em formato de texto." put: tags: - "LoteCobV" @@ -2697,7 +2697,7 @@ components: - Pix Troco: o valor da devolução é limitado ao valor relativo à compra ou ao troco: - Quando a devolução for referente à compra, o valor limita-se ao valor da compra (a natureza nesse caso deve ser ORIGINAL); e - Quando a devolução for referente ao troco, o valor limita-se ao valor do troco (a natureza nesse caso deve ser RETIRADA). - + enum: - "ORIGINAL" - "RETIRADA" @@ -2721,7 +2721,7 @@ components: - Pix Troco: o valor da devolução é limitado ao valor relativo à compra ou ao troco: - Quando a devolução for referente à compra, o valor limita-se ao valor da compra (a natureza nesse caso deve ser ORIGINAL); e - Quando a devolução for referente ao troco, o valor limita-se ao valor do troco (a natureza nesse caso deve ser RETIRADA). - + enum: - "ORIGINAL" - "RETIRADA" @@ -3002,13 +3002,13 @@ components: dataDeVencimento: 2021-08-27, sexta-feira. validadeAposVencimento: 5 - Tenta-se pagar no dia 2020-08-27, sexta: aceito. (#)(*) - Tenta-se pagar no dia 2020-08-28, sábado: aceito. (1) - Tenta-se pagar no dia 2020-08-29, domingo: aceito. (2) - Tenta-se pagar no dia 2020-08-30, segunda: aceito. (3) - Tenta-se pagar no dia 2020-12-31, terça: aceito. (4) - Tenta-se pagar no dia 2020-12-01, quarta: aceito. (5) - Tenta-se pagar no dia 2020-12-02, quinta: negado. + Tenta-se pagar no dia 2021-08-27, sexta: aceito. (#)(*) + Tenta-se pagar no dia 2021-08-28, sábado: aceito. (1) + Tenta-se pagar no dia 2021-08-29, domingo: aceito. (2) + Tenta-se pagar no dia 2021-08-30, segunda: aceito. (3) + Tenta-se pagar no dia 2021-08-31, terça: aceito. (4) + Tenta-se pagar no dia 2021-09-01, quarta: aceito. (5) + Tenta-se pagar no dia 2021-09-02, quinta: negado. ``` Exemplo G: @@ -3017,16 +3017,16 @@ components: dataDeVencimento: 2021-08-28, sábado. validadeAposVencimento: 5 - Tenta-se pagar no dia 2020-08-28, sábado: aceito. (#) - Tenta-se pagar no dia 2020-08-29, domingo: aceito. - Tenta-se pagar no dia 2020-08-30, segunda: aceito. (*) - Tenta-se pagar no dia 2020-08-31, terça: aceito. (1) - Tenta-se pagar no dia 2020-09-01, quarta: aceito. (2) - Tenta-se pagar no dia 2020-09-02, quinta: aceito. (3) - Tenta-se pagar no dia 2020-09-03, sexta: aceito. (4) - Tenta-se pagar no dia 2020-09-04, sabado: aceito. - Tenta-se pagar no dia 2020-09-05, domingo: aceito. - Tenta-se pagar no dia 2020-09-06, segunda: aceito. (5) + Tenta-se pagar no dia 2021-08-28, sábado: aceito. (#) + Tenta-se pagar no dia 2021-08-29, domingo: aceito. + Tenta-se pagar no dia 2021-08-30, segunda: aceito. (*) + Tenta-se pagar no dia 2021-08-31, terça: aceito. (1) + Tenta-se pagar no dia 2021-09-01, quarta: aceito. (2) + Tenta-se pagar no dia 2021-09-02, quinta: aceito. (3) + Tenta-se pagar no dia 2021-09-03, sexta: aceito. (4) + Tenta-se pagar no dia 2021-09-04, sabado: aceito. + Tenta-se pagar no dia 2021-09-05, domingo: aceito. + Tenta-se pagar no dia 2021-09-06, segunda: aceito. (5) ``` default: 30 CobApresentacao: @@ -3150,7 +3150,7 @@ components: - properties: data: title: "Data limite para o desconto absoluto da cobrança" - description: 'Descontos por pagamento antecipado, com data fixa. Matriz com até três elementos, sendo que cada elemento é composto por um par "data e valorPerc", para estabelecer descontos percentuais ou absolutos, até aquela data de pagamento. Trata-se de uma data, no formato `YYYY-MM-DD`, segundo ISO 8601. A data de desconto obrigatoriamente deverá ser menor que a data de vencimento da cobrança.' + description: 'Descontos por pagamento antecipado, com data fixa. Matriz com até três elementos, sendo que cada elemento é composto por um par "data e valorPerc", para estabelecer descontos percentuais ou absolutos, até aquela data de pagamento. Trata-se de uma data, no formato `YYYY-MM-DD`, segundo ISO 8601. A data de desconto obrigatoriamente deverá ser menor ou igual à data de vencimento da cobrança.' type: "string" format: "date" example: "2020-04-01" @@ -3412,7 +3412,7 @@ components: title: "Modalidade do Agente" description: | ##### Modalidade do Agente -
SIGLADescrição
AGTECAgente Estabelecimento Comercial
AGTOTAgente Outra Espécie de Pessoa Jurídica ou Correspondente no País
AGPSSAgente Facilitador de Serviço de Saque
+
SIGLADescrição
AGTECAgente Estabelecimento Comercial
AGTOTAgente Outra Espécie de Pessoa Jurídica ou Correspondente no País
AGPSSAgente Facilitador de Serviço de Saque (ATENÇÃO: no mapeamento para o campo 'modalidadeAgente', da pacs.008, esse valor deve ser substituído por AGFSS)
enum: - "AGTEC" - "AGTOT" @@ -3702,7 +3702,7 @@ components: title: "Modalidade do Agente" description: | ##### Modalidade do Agente -
SIGLADescrição
AGTECAgente Estabelecimento Comercial
AGTOTAgente Outra Espécie de Pessoa Jurídica ou Correspondente no País
AGPSSAgente Facilitador de Serviço de Saque
+
SIGLADescrição
AGTECAgente Estabelecimento Comercial
AGTOTAgente Outra Espécie de Pessoa Jurídica ou Correspondente no País
AGPSSAgente Facilitador de Serviço de Saque (ATENÇÃO: no mapeamento para o campo 'modalidadeAgente', da pacs.008, esse valor deve ser substituído por AGFSS)
enum: - "AGTEC" - "AGTOT" @@ -3834,7 +3834,7 @@ components: type: "string" title: "Pix Copia e Cola correspondente à cobrança." description: "Este campo retorna o valor do Pix Copia e Cola correspondente à cobrança. Trata-se da sequência de caracteres que representa o BR Code." - maxLength: 512 + maxLength: 512 - $ref: "#/components/schemas/CobBase" CobSolicitada: type: "object" @@ -4155,7 +4155,7 @@ components: id: type: "integer" format: "int64" - title: "Id do lote" + title: "Identificador do lote em formato numérico." descricao: type: "string" title: "Descrição do lote" @@ -4451,7 +4451,7 @@ components: Pix: type: "object" title: "Pix" - required: ["endToEndId", "valor", "horario", "pagador"] + required: ["endToEndId", "valor", "horario"] properties: endToEndId: $ref: "#/components/schemas/EndToEndId" @@ -4684,7 +4684,7 @@ components: title: "Modalidade do Agente" description: | ##### Modalidade do Agente -
SIGLADescrição
AGTECAgente Estabelecimento Comercial
AGTOTAgente Outra Espécie de Pessoa Jurídica ou Correspondente no País
AGPSSAgente Facilitador de Serviço de Saque
+
SIGLADescrição
AGTECAgente Estabelecimento Comercial
AGTOTAgente Outra Espécie de Pessoa Jurídica ou Correspondente no País
AGPSSAgente Facilitador de Serviço de Saque (ATENÇÃO: no mapeamento para o campo 'modalidadeAgente', da pacs.008, esse valor deve ser substituído por AGFSS)
enum: - "AGTEC" - "AGTOT" diff --git a/readme.md b/readme.md index d306659..dfc9f46 100644 --- a/readme.md +++ b/readme.md @@ -10,6 +10,6 @@ O branch `master` da API pode ser visualizado __[aqui](https://bacen.github.io/pix-api/index.html)__. -# Release atual: 2.6.2 +# Release atual: 2.6.3 -* A release atual da API Pix pode ser encontrada neste __[link](https://github.com/bacen/pix-api/releases/tag/2.6.2)__. +* A release atual da API Pix pode ser encontrada neste __[link](https://github.com/bacen/pix-api/releases/tag/2.6.3)__.