Skip to content

Contrato oficial v1.1.1: 0.3.0 do client e do mock - #14

Merged
Mozurok merged 5 commits into
mainfrom
feat/contrato-v1-1-1
Oct 22, 2026
Merged

Mozurok merged 5 commits into
mainfrom
feat/contrato-v1-1-1

Conversation

@Mozurok

@Mozurok Mozurok commented Oct 22, 2026

Copy link
Copy Markdown
Owner

O CGIBS publicou em 24/09/2026 o OpenAPI v1.1.1 e seis manuais do Split Payment, aprovados pelo Ato Técnico Conjunto RFB/CGIBS nº 5. Este PR vendora tudo, migra os dois pacotes para o v1.1.1 e prepara a 0.3.0.

Closes #13.

O que quebra

Rotas e nomes de schema são os mesmos. Mudam três coisas:

  • indPgtoIntegral saiu de Pix Dinâmico e Pix Automático (Preliminar e Segregação), onde era obrigatório;
  • cnpjRaizPspRecInd saiu dos seis schemas de Boleto;
  • as respostas de erro 403, 410, 500 e os 422 trocaram errors por resourceId.

Commits

  • vendor: OAS v1.1.1, Manuais de Integração v1.1.1, Operações e Tempos v1.0.1, Segurança v1.0.0, Redes v1.0.1, Habilitação de Participantes v1.0.0, Formulários de Habilitação, NT 2025.002 v1.52, IT 2025.002 v1.70 e os contratos da Calculadora (portal 49 rotas, piloto 50). Todas as linhas pinadas do MANIFEST conferem com o SHA-256 em disco. O _meta do inventário do CGIBS citava uma flag --pin-cgibs que nunca existiu.
  • client: tipos regenerados e um teste de tipos que não compila contra o v1.1.0.
  • mock: spec e hash do v1.1.1, matrizes pelas tabelas do manual v1.1.1, resourceId em toda resposta de erro em /api/. Mais três bugs que já existiam: códigos RSUP x02 e x03 trocados desde o início (a tabela oficial está no manual desde a v1.0), numPgto exigido na Baixa de Boleto desde a 0.2.0, e cnpjRaizPspRecInd aceito no TEF.
  • docs: guia de migração 0.2.x para 0.3.0, novidades, estado da regulação e base legal. O tutorial estava quebrado desde a 0.2.0 (passo 7 dava 400, passo 9 dava 404); os comandos foram corrigidos e as saídas recapturadas rodando a página contra o mock.
  • release: 0.3.0 nos dois pacotes. A constante VERSION do mock estava em 0.1.0; os dois testes agora comparam com o package.json.

Fica de fora, de propósito

  • hashPayload: o Manual de Segurança v1.0.0 pede esse claim no JWS, mas o Manual de Integração v1.1.1 e o OpenAPI não pedem, e nenhum documento define o formato. O client e o mock seguem o OpenAPI; a divergência está documentada no guia de migração.
  • O 400 do mock usa a chave erros (com o objeto do Ajv) em vez de errors com field/message, como o contrato declara. Isso já era assim antes do v1.1.1 e merece um PR próprio.

Verificação

  • pnpm -r typecheck, pnpm test (client 74, mock 123, scripts 41) e pnpm test:site passam.
  • pnpm site:build passa.
  • pnpm drift-check da máquina do mantenedor: os quatro alvos em MATCH depois do re-vendor.
  • Tutorial executado de ponta a ponta contra o mock local.

Depois do merge

Publicar @splitbr/client antes de @splitbr/mock.

O CGIBS publicou em 24/09/2026 o OpenAPI v1.1.1 e seis manuais, tres deles
ineditos (Seguranca, Redes, Habilitacao de Participantes), aprovados pelo
Ato Tecnico Conjunto n. 5. Tudo entra como arquivo novo com linha nova no
MANIFEST. Tambem re-vendorados os contratos de portal e piloto da
Calculadora (issue #13) e vendoradas a NT 2025.002 v1.52 e a IT 2025.002
v1.70. O inventario do CGIBS foi repinado, e o _meta dele deixa de citar
uma flag --pin-cgibs que nunca existiu.
Tipos regenerados do OAS v1.1.1. Tres remocoes quebram quem consome os
tipos: indPgtoIntegral saiu de Pix Dinamico e Pix Automatico (Preliminar e
Segregacao), cnpjRaizPspRecInd saiu dos schemas de Boleto, e as respostas
problem+json trocaram errors por resourceId (o envelope 201 mantem errors).
Um teste de tipos trava as tres; contra os tipos do v1.1.0 ele nao compila.
Spec embarcado e hash pinado trocados pelo OAS v1.1.1. As matrizes seguem as
tabelas do Manual de Integracao v1.1.1: indPgtoIntegral vira N/E em Pix
Dinamico e Automatico, cnpjRaizPspRecInd vira N/E no Boleto. Toda resposta de
erro em /api/ ganha resourceId (capitulo 9).

Tres correcoes de bugs que ja existiam:
- a Baixa de Boleto exigia numPgto, campo que o contrato removeu na v1.1.0;
  uma baixa valida era rejeitada desde a 0.2.0;
- cnpjRaizPspRecInd era aceito no TEF, onde o manual o marca como N/E;
- os codigos RSUP x02 e x03 estavam trocados. O capitulo 6 do manual define
  x01 CBS corrigido, x02 CBS em aberto, x03 IBS corrigido, x04 IBS em aberto
  desde a v1.0; o comentario dizia que isso ainda nao tinha sido publicado.

README: exemplo do client sem o tenantId que nao existe desde a 0.2.0,
nsuInicial no lugar de fromNsu, cnpjRaizPspRecDir no curl de cenario.
… 24/09

Migracao, novidades, estado da regulacao e base legal passam a refletir o
OAS v1.1.1 e os seis manuais publicados em 24/09/2026; o unico documento
ainda inedito e o Plano de Implantacao.

O tutorial estava quebrado desde a 0.2.0 e ninguem tinha reexecutado: o
passo 7 dava 400 (numIdentcBaixa virou string) e o passo 9 dava 404 (rota
de stream renomeada). Os comandos foram corrigidos e as saidas recapturadas
executando a pagina contra o mock.

A rotina de vigilancia registra a execucao de hoje e a auditoria: o v1.1.1
passou 28 dias sem deteccao. O drift-check local entra no passo 1.
O v1.1.1 remove campos que eram obrigatorios, entao e quebra de tipo e vai no
minor, como na 0.2.0: `^0.2.0` nao atravessa minor em 0.x.

A constante VERSION do mock estava em "0.1.0" desde o lancamento, e a do
client so acertava porque o teste repetia o literal. Os dois testes agora
comparam com o package.json.
@Mozurok
Mozurok merged commit b94957a into main Oct 22, 2026
2 checks passed
@Mozurok
Mozurok deleted the feat/contrato-v1-1-1 branch November 3, 2026 16:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Drift detectado nos contratos oficiais

1 participant