From 08b36cc675039c06c0d11382fc07492775543ebc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lu=C3=ADs=20Eduardo?= Date: Wed, 18 Nov 2026 14:20:09 -0300 Subject: [PATCH] feat: consultarCndFederal aceita dataNascimento para CPF A Receita so emite a CND Federal de CPF com a data de nascimento. O tipo exige dataNascimento quando ha cpf e a chamada falha antes da rede se faltar. --- README.md | 4 +++- package.json | 2 +- src/client.ts | 19 ++++++++++++++++--- src/version.ts | 2 +- 4 files changed, 21 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 3f78dc3..d85aed1 100644 --- a/README.md +++ b/README.md @@ -49,7 +49,7 @@ const { FiscalAPI } = require('fiscalapi-br'); | `consultarCnpj({ cnpj, forceFresh? })` | `GET /api/consultar-cnpj` | Dados cadastrais da Receita Federal | | `consultarCnd({ uf, cpf \| cnpj })` | `GET /api/consultar-cnd` | CND estadual (ICMS) com PDF | | `consultarCndTodos({ cpf \| cnpj })` | `GET /api/consultar-cnd-todos` | CND estadual em todos os estados disponíveis | -| `consultarCndFederal({ cpf \| cnpj, emitirNova? })` | `GET /api/consultar-cnd-federal` | CND Federal (Receita Federal + PGFN) | +| `consultarCndFederal({ cnpj \| cpf + dataNascimento, emitirNova? })` | `GET /api/consultar-cnd-federal` | CND Federal (Receita Federal + PGFN) | | `consultarCndt({ cpf \| cnpj })` | `GET /api/consultar-cndt` | Certidão de débitos trabalhistas | | `consultarCrfFgts({ cpf \| cnpj })` | `GET /api/consultar-crf-fgts` | Regularidade do FGTS | | `consultarCertidoesTodas({ cpf \| cnpj, skipEstaduais? })` | `GET /api/certidoes-todas` | Todas as certidões em uma chamada | @@ -120,6 +120,8 @@ if (cnd.result?.pdf_base64) { } const federal = await api.consultarCndFederal({ cnpj: '12345678000195' }); +// CPF: a Receita exige a data de nascimento (DD/MM/AAAA ou AAAA-MM-DD) +const federalPf = await api.consultarCndFederal({ cpf: '12345678909', dataNascimento: '12/04/1985' }); const trabalhista = await api.consultarCndt({ cnpj: '12345678000195' }); const fgts = await api.consultarCrfFgts({ cnpj: '12345678000195' }); ``` diff --git a/package.json b/package.json index 0507f7a..5841287 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "fiscalapi-br", - "version": "0.4.0", + "version": "0.5.0", "description": "SDK da FiscalAPI (Brasil): Inscrição Estadual, CNPJ, certidões, NF-e, CT-e, DIFAL, SIGEF, CNIR e perfil do produtor rural.", "license": "MIT", "author": { diff --git a/src/client.ts b/src/client.ts index 2709325..cb5bec3 100644 --- a/src/client.ts +++ b/src/client.ts @@ -153,12 +153,25 @@ export class FiscalAPI { return this.get('/api/consultar-cnd-todos', umDocumento(params, ['cpf', 'cnpj'])); } - /** CND Federal — Receita Federal + PGFN (`GET /api/consultar-cnd-federal`). */ + /** + * CND Federal — Receita Federal + PGFN (`GET /api/consultar-cnd-federal`). + * Para CPF, a Receita exige a data de nascimento do titular + * (`DD/MM/AAAA` ou `AAAA-MM-DD`). + */ consultarCndFederal( - params: { emitirNova?: boolean } & Documento, + params: { emitirNova?: boolean } & ( + | { cnpj: string; cpf?: never; dataNascimento?: never } + | { cpf: string; dataNascimento: string; cnpj?: never } + ), ): Promise { + const doc = umDocumento(params, ['cpf', 'cnpj']); + const dataNascimento = params.dataNascimento?.trim(); + if (doc.cpf && !dataNascimento) { + throw new Error('Informe dataNascimento: a CND Federal de CPF exige a data de nascimento.'); + } return this.get('/api/consultar-cnd-federal', { - ...umDocumento(params, ['cpf', 'cnpj']), + ...doc, + data_nascimento: doc.cpf ? dataNascimento : undefined, emitir_nova: params.emitirNova || undefined, }); } diff --git a/src/version.ts b/src/version.ts index 465e390..243bfad 100644 --- a/src/version.ts +++ b/src/version.ts @@ -1 +1 @@ -export const VERSION = '0.4.0'; +export const VERSION = '0.5.0';