Repository navigation
Contrato oficial v1.1.1: 0.3.0 do client e do mock - #14
Merged
Merged
Conversation
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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:
indPgtoIntegralsaiu de Pix Dinâmico e Pix Automático (Preliminar e Segregação), onde era obrigatório;cnpjRaizPspRecIndsaiu dos seis schemas de Boleto;errorsporresourceId.Commits
_metado inventário do CGIBS citava uma flag--pin-cgibsque nunca existiu.resourceIdem 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),numPgtoexigido na Baixa de Boleto desde a 0.2.0, ecnpjRaizPspRecIndaceito no TEF.VERSIONdo mock estava em0.1.0; os dois testes agora comparam com opackage.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.erros(com o objeto do Ajv) em vez deerrorscomfield/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) epnpm test:sitepassam.pnpm site:buildpassa.pnpm drift-checkda máquina do mantenedor: os quatro alvos em MATCH depois do re-vendor.Depois do merge
Publicar
@splitbr/clientantes de@splitbr/mock.