Skip to content

Commit 0d74e5e

Browse files
author
Thiago Luiz Vieira de Lima Santos
committed
release 2.9.0
1 parent 03864a2 commit 0d74e5e

3 files changed

Lines changed: 40 additions & 33 deletions

File tree

‎changelog.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,16 @@
22

33
Mudanças relevantes na API Pix serão documentadas aqui neste documento.
44

5+
## [2.9.0]
6+
7+
- Atualização do padrão de campos com domínio `CNPJ` para aceitar valores alfanuméricos, conforme Instrução Normativa RFB nº 2229, de 15 de outubro de 2024.
8+
- Atualização dos padrões dos campos `ispbParticipante` e `prestadorDoServicoDeSaque` para permitir valores alfanuméricos, considerando que o `ISPB` pode ser derivado do respectivo `CNPJ`.
9+
- Atualização dos padrões dos campos `idRec` e `idSolicRec` para permitir valores alfanuméricos nos componentes `xxxxxxxx` (ISPBs) das suas regras de formação.
10+
- Correção na descrição do campo `idRec`.
11+
- Correção nos campos `cob.devedor` e `cobv.devedor` removendo campos duplicados.
12+
- Correção nas violações de `CobVOperacaoInvalida` removendo informações duplicadas.
13+
14+
515
## [2.8.2]
616
- Ajuste na descrição do `PUT /webhookrec`.
717
- Correção nas informações do parâmetro `status` em `GET /cobr` que se refere ao status da cobrança recorrente.

‎openapi.yaml‎

Lines changed: 28 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
openapi: 3.0.0
22
info:
33
title: API Pix
4-
version: "2.8.2"
4+
version: "2.9.0"
55
license:
66
name: Apache 2.0
77
url: http://www.apache.org/licenses/LICENSE-2.0
@@ -409,7 +409,6 @@ info:
409409
- O campo `cobv.calendario.dataDeVencimento` é anterior à data de criação da cobrança.
410410
- O campo `cobv.calendario.validadeAposVencimento` é menor do que zero.
411411
- O objeto `cobv.devedor` não respeita o _schema_.
412-
- O objeto `cobv.devedor` não respeita o _schema_.
413412
- O campo `cobv.chave` não respeita o _schema_.
414413
- O campo `cobv.chave` corresponde a uma conta que não pertence a este usuário recebedor.
415414
- O campo `solicitacaoPagador` não respeita o _schema_.
@@ -968,7 +967,7 @@ paths:
968967
schema:
969968
type: "string"
970969
title: "CNPJ"
971-
pattern: "/^\\d{14}$/"
970+
pattern: "^[0-9A-Z]{14}$"
972971
description: "Filtro pelo CNPJ do devedor. Não pode ser utilizado ao mesmo tempo que o CPF."
973972
- name: "locationPresente"
974973
in: "query"
@@ -1135,7 +1134,7 @@ paths:
11351134
schema:
11361135
type: "string"
11371136
title: "CNPJ"
1138-
pattern: "/^\\d{14}$/"
1137+
pattern: "^[0-9A-Z]{14}$"
11391138
description: "Filtro pelo CNPJ do devedor. Não pode ser utilizado ao mesmo tempo que o CPF."
11401139
- name: "locationPresente"
11411140
in: "query"
@@ -1712,7 +1711,7 @@ paths:
17121711
schema:
17131712
type: "string"
17141713
title: "CNPJ"
1715-
pattern: "/^\\d{14}$/"
1714+
pattern: "^[0-9A-Z]{14}$"
17161715
description: "Filtro pelo CNPJ do pagador. Não pode ser utilizado ao mesmo tempo que o CPF."
17171716
- $ref: "#/components/parameters/paginaAtual"
17181717
- $ref: "#/components/parameters/itensPorPagina"
@@ -2422,7 +2421,7 @@ paths:
24222421
schema:
24232422
type: "string"
24242423
title: "CNPJ"
2425-
pattern: "/^\\d{14}$/"
2424+
pattern: "^[0-9A-Z]{14}$"
24262425
description: "Filtro pelo CNPJ do devedor. Não pode ser utilizado ao mesmo tempo que o CPF."
24272426
- name: "locationPresente"
24282427
in: "query"
@@ -2770,7 +2769,7 @@ paths:
27702769
schema:
27712770
type: "string"
27722771
title: "CNPJ"
2773-
pattern: "/^\\d{14}$/"
2772+
pattern: "^[0-9A-Z]{14}$"
27742773
description: "Filtro pelo CNPJ do devedor. Não pode ser utilizado ao mesmo tempo que o CPF."
27752774
- name: "status"
27762775
in: "query"
@@ -3281,14 +3280,14 @@ components:
32813280
chave: "40a0932d-1918-4eee-845d-35a2da1690dc"
32823281
solicitacaoPagador: "Informar cartão fidelidade"
32833282
pix:
3284-
- endToEndId: "E12345678202009091221kkkkkkkkkkk"
3283+
- endToEndId: "E1234567820200909122120200808008"
32853284
txid: "655dfdb1a4514b8fbb58254b958913fb"
32863285
valor: "110.00"
32873286
horario: "2020-09-09T20:15:00.358Z"
32883287
infoPagador: "0123456789"
32893288
devolucoes:
32903289
- id: "123ABC"
3291-
rtrId: "Dxxxxxxxx202009091221kkkkkkkkkkk"
3290+
rtrId: "D1234567820200909122120200808006"
32923291
valor: "10.00"
32933292
horario:
32943293
solicitacao: "2020-09-09T20:15:00.358Z"
@@ -4972,7 +4971,7 @@ components:
49724971
cnpj:
49734972
type: "string"
49744973
title: "CNPJ"
4975-
pattern: "/^\\d{14}$/"
4974+
pattern: "^[0-9A-Z]{14}$"
49764975
description: "CNPJ do usuário."
49774976
nome:
49784977
type: "string"
@@ -5002,7 +5001,7 @@ components:
50025001
cnpj:
50035002
type: "string"
50045003
title: "CNPJ"
5005-
pattern: "/^\\d{14}$/"
5004+
pattern: "^[0-9A-Z]{14}$"
50065005
description: "CNPJ do usuário."
50075006
nome:
50085007
type: "string"
@@ -5027,7 +5026,7 @@ components:
50275026
cnpj:
50285027
type: "string"
50295028
title: "CNPJ"
5030-
pattern: "/^\\d{14}$/"
5029+
pattern: "^[0-9A-Z]{14}$"
50315030
description: "CNPJ do usuário."
50325031
DadosComplementaresPessoa:
50335032
type: "object"
@@ -5115,7 +5114,7 @@ components:
51155114
type: "string"
51165115
title: "ISPB do usuário pagador."
51175116
description: "ISPB do usuário pagador."
5118-
pattern: "\\d{8}"
5117+
pattern: "^[0-9A-Z]{8}$"
51195118
agencia:
51205119
type: "string"
51215120
title: "Agência do Usuário Pagador"
@@ -5154,7 +5153,7 @@ components:
51545153
type: "string"
51555154
title: "ISPB do PSP pagador."
51565155
description: "ISPB do PSP pagador."
5157-
pattern: "\\d{8}"
5156+
pattern: "^[0-9A-Z]{8}$"
51585157
- type: "object"
51595158
properties:
51605159
codMun:
@@ -5187,7 +5186,7 @@ components:
51875186
cnpj:
51885187
type: "string"
51895188
title: "CNPJ"
5190-
pattern: "/^\\d{14}$/"
5189+
pattern: "^[0-9A-Z]{14}$"
51915190
description: "Filtro pelo CNPJ do devedor. Não pode ser utilizado ao mesmo tempo que o CPF."
51925191
criacao:
51935192
type: "string"
@@ -5831,7 +5830,7 @@ components:
58315830
prestadorDoServicoDeSaque:
58325831
type: "string"
58335832
title: "Facilitador de Serviço de Saque"
5834-
pattern: "\\d{8}"
5833+
pattern: "^[0-9A-Z]{8}$"
58355834
description: "ISPB do Facilitador de Serviço de Saque"
58365835
- type: "object"
58375836
properties:
@@ -5867,7 +5866,7 @@ components:
58675866
prestadorDoServicoDeSaque:
58685867
type: "string"
58695868
title: "Facilitador de Serviço de Saque"
5870-
pattern: "\\d{8}"
5869+
pattern: "^[0-9A-Z]{8}$"
58715870
description: "ISPB do Facilitador de Serviço de Saque"
58725871
CobPayloadValor:
58735872
type: "object"
@@ -6121,7 +6120,7 @@ components:
61216120
prestadorDoServicoDeSaque:
61226121
type: "string"
61236122
title: "Facilitador de Serviço de Saque"
6124-
pattern: "\\d{8}"
6123+
pattern: "^[0-9A-Z]{8}$"
61256124
description: "ISPB do Facilitador de Serviço de Saque"
61266125
- type: "object"
61276126
properties:
@@ -6157,7 +6156,7 @@ components:
61576156
prestadorDoServicoDeSaque:
61586157
type: "string"
61596158
title: "Facilitador de Serviço de Saque"
6160-
pattern: "\\d{8}"
6159+
pattern: "^[0-9A-Z]{8}$"
61616160
description: "ISPB do Facilitador de Serviço de Saque"
61626161
CobVPayloadValor:
61636162
type: "object"
@@ -6398,7 +6397,7 @@ components:
63986397
type: "string"
63996398
title: "ISPB do usuário recebedor."
64006399
description: "ISPB do usuário recebedor."
6401-
pattern: "\\d{8}"
6400+
pattern: "^[0-9A-Z]{8}$"
64026401
- $ref: "#/components/schemas/RecConfiguracao"
64036402
- $ref: "#/components/schemas/RecAtualizacao"
64046403
RecRevisada:
@@ -6656,9 +6655,9 @@ components:
66566655
- RAxxxxxxxxyyyyMMddkkkkkkkkkkk (29 caracteres; "case sensitive", isso é, diferencia letras maiúsculas e minúsculas), sendo:
66576656
- "R": fixo (1 caractere). "R" para a recorrência criada dentro do Pix;
66586657
- "A": identificação da possibilidade de novas tentativas, sendo possíveis os valores "R" ou "N" (1 caractere). "R" caso a recorrência permita novas tentativas de pagamento pós vencimento, ou "N" caso não permita novas tentativas.
6659-
- "xxxxxxxx": identificação do agente que presta serviço para o usuário recebedor que gerou o <Id>, podendo ser: o ISPB do participante direto, o ISPB do participante indireto ou os 8 primeiros dígitos do CNPJ do prestador de serviço de iniciação (8 caracteres numéricos [0-9]);
6658+
- "xxxxxxxx": identificação do agente que presta serviço para o usuário recebedor que gerou o ID Recorrência, podendo ser: o ISPB do participante direto, o ISPB do participante indireto ou os 8 primeiros caracteres do CNPJ do prestador de serviço de iniciação (8 caracteres alfanuméricos [A-Z|0-9]);
66606659
- "yyyyMMdd": data (8 caracteres) de criação da recorrência;
6661-
- "kkkkkkkkkkk": sequencial criado pelo agente que gerou o <Id> (11 caracteres alfanuméricos [a-z|A-Z|0-9]). Deve ser único dentro de cada "yyyyMMdd".
6660+
- "kkkkkkkkkkk": sequencial criado pelo agente que gerou o ID Recorrência (11 caracteres alfanuméricos [a-z|A-Z|0-9]). Deve ser único dentro de cada "yyyyMMdd".
66626661
66636662
Dessa forma, o ID da recorrência deve ser formado de acordo com um dos tipos a seguir:
66646663
- "RRxxxxxxxxyyyyMMddkkkkkkkkkkk"; para recorrência criada dentro do Pix e que permite novas tentativas de pagamento pós vencimento; ou
@@ -6754,7 +6753,7 @@ components:
67546753
Regra de formação:
67556754
- SCxxxxxxxxyyyyMMddkkkkkkkkkkk (29 caracteres; “case sensitive”, isso é, diferencia letras maiúsculas e minúsculas), sendo:
67566755
- SC - fixo (2 caracteres);
6757-
- xxxxxxxx – ISPB do agente que envia a mensagem pain.009 de solicitação de confirmação da recorrência;
6756+
- xxxxxxxx – ISPB do agente que envia a mensagem pain.009 de solicitação de confirmação da recorrência (8 caracteres alfanuméricos [A-Z|0-9]);
67586757
- yyyyMMdd – data (8 caracteres) de criação da mensagem pain.009 de solicitação de confirmação da recorrência;
67596758
- kkkkkkkkkkk – sequencial criado pelo agente que gerou a mensagem de solicitação de confirmação da recorrência (11 caracteres alfanuméricos [a-z|A-Z|0-9]). Deve ser único dentro de cada “yyyyMMdd”.
67606759
pattern: "[a-zA-Z0-9]{29}"
@@ -7588,7 +7587,6 @@ components:
75887587
title: "Cobrança com vencimento completa"
75897588
required: ["status"]
75907589
allOf:
7591-
- $ref: "#/components/schemas/CobVSolicitada"
75927590
- $ref: "#/components/schemas/CobVGerada"
75937591
- type: "object"
75947592
properties:
@@ -7612,7 +7610,6 @@ components:
76127610
title: "Cobrança imediata completa"
76137611
required: ["status"]
76147612
allOf:
7615-
- $ref: "#/components/schemas/CobSolicitada"
76167613
- $ref: "#/components/schemas/CobGerada"
76177614
- type: "object"
76187615
properties:
@@ -7917,7 +7914,7 @@ components:
79177914
cnpj:
79187915
type: "string"
79197916
title: "CNPJ"
7920-
pattern: "/^\\d{14}$/"
7917+
pattern: "^[0-9A-Z]{14}$"
79217918
description: "Filtro pelo CNPJ do devedor. Não pode ser utilizado ao mesmo tempo que o CPF."
79227919
locationPresente:
79237920
type: "boolean"
@@ -7963,7 +7960,7 @@ components:
79637960
cnpj:
79647961
type: "string"
79657962
title: "CNPJ"
7966-
pattern: "/^\\d{14}$/"
7963+
pattern: "^[0-9A-Z]{14}$"
79677964
description: "Filtro pelo CNPJ do devedor. Não pode ser utilizado ao mesmo tempo que o CPF."
79687965
locationPresente:
79697966
type: "boolean"
@@ -8002,7 +7999,7 @@ components:
80027999
cnpj:
80038000
type: "string"
80048001
title: "CNPJ"
8005-
pattern: "/^\\d{14}$/"
8002+
pattern: "^[0-9A-Z]{14}$"
80068003
description: "Filtro pelo CNPJ do devedor. Não pode ser utilizado ao mesmo tempo que o CPF."
80078004
status:
80088005
type: "string"
@@ -8373,7 +8370,7 @@ components:
83738370
prestadorDoServicoDeSaque:
83748371
type: "string"
83758372
title: "Facilitador de Serviço de Saque"
8376-
pattern: "\\d{8}"
8373+
pattern: "^[0-9A-Z]{8}$"
83778374
description: "ISPB do Facilitador de Serviço de Saque"
83788375
PixValorTroco:
83798376
type: "object"
@@ -8399,7 +8396,7 @@ components:
83998396
prestadorDoServicoDeSaque:
84008397
type: "string"
84018398
title: "Facilitador de Serviço de Saque"
8402-
pattern: "\\d{8}"
8399+
pattern: "^[0-9A-Z]{8}$"
84038400
description: "ISPB do Facilitador de Serviço de Saque"
84048401
PixValorJuros:
84058402
type: "object"
@@ -8695,7 +8692,7 @@ components:
86958692
description: "CPF"
86968693
cnpj:
86978694
type: "string"
8698-
pattern: "/^\\d{14}$/"
8695+
pattern: "^[0-9A-Z]{14}$"
86998696
description: "CNPJ"
87008697
paginacao:
87018698
$ref: "#/components/schemas/Paginacao"

‎readme.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,6 @@
1010

1111
O branch `master` da API pode ser visualizado __[aqui](https://bacen.github.io/pix-api/index.html)__.
1212

13-
# Release atual: 2.8.2
13+
# Release atual: 2.9.0
1414

15-
* A release atual da API Pix pode ser encontrada neste __[link](https://github.com/bacen/pix-api/releases/tag/2.8.2)__.
15+
* A release atual da API Pix pode ser encontrada neste __[link](https://github.com/bacen/pix-api/releases/tag/2.9.0)__.

0 commit comments

Comments
 (0)