diff --git a/README.md b/README.md index df9f97d..6586333 100644 --- a/README.md +++ b/README.md @@ -40,7 +40,7 @@ for ie in resp["results"]: | `consultar_cnpj(cnpj, force_fresh=False)` | `GET /api/consultar-cnpj` | Dados cadastrais da Receita Federal | | `consultar_cnd(uf, cpf=/cnpj=)` | `GET /api/consultar-cnd` | CND estadual (ICMS) com PDF | | `consultar_cnd_todos(cpf=/cnpj=)` | `GET /api/consultar-cnd-todos` | CND estadual em todos os estados disponíveis | -| `consultar_cnd_federal(cpf=/cnpj=, emitir_nova=False)` | `GET /api/consultar-cnd-federal` | CND Federal (Receita Federal + PGFN) | +| `consultar_cnd_federal(cnpj= \| cpf= + data_nascimento=, emitir_nova=False)` | `GET /api/consultar-cnd-federal` | CND Federal (Receita Federal + PGFN) | | `consultar_cndt(cpf=/cnpj=)` | `GET /api/consultar-cndt` | Certidão de débitos trabalhistas | | `consultar_crf_fgts(cpf=/cnpj=)` | `GET /api/consultar-crf-fgts` | Regularidade do FGTS | | `consultar_certidoes_todas(cpf=/cnpj=, skip_estaduais=False)` | `GET /api/certidoes-todas` | Todas as certidões em uma chamada | @@ -111,6 +111,8 @@ if resultado.get("pdf_base64"): f.write(base64.b64decode(resultado["pdf_base64"])) federal = api.consultar_cnd_federal(cnpj="12345678000195") +# CPF: a Receita exige a data de nascimento (DD/MM/AAAA ou AAAA-MM-DD) +federal_pf = api.consultar_cnd_federal(cpf="12345678909", data_nascimento="12/04/1985") trabalhista = api.consultar_cndt(cnpj="12345678000195") fgts = api.consultar_crf_fgts(cnpj="12345678000195") ``` diff --git a/pyproject.toml b/pyproject.toml index 51465e1..13131dd 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "hatchling.build" [project] 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." readme = "README.md" license = "MIT" diff --git a/src/fiscalapi_br/_client.py b/src/fiscalapi_br/_client.py index e8b68cb..2a18c1b 100644 --- a/src/fiscalapi_br/_client.py +++ b/src/fiscalapi_br/_client.py @@ -174,6 +174,7 @@ def consultar_cnd_federal( *, cpf: Optional[str] = None, cnpj: Optional[str] = None, + data_nascimento: Optional[str] = None, emitir_nova: bool = False, ) -> CertidaoFederalResponse: """CND Federal — Receita Federal + PGFN (``GET /api/consultar-cnd-federal``). @@ -181,8 +182,19 @@ def consultar_cnd_federal( Devolve a certidão vigente quando ela vale por mais de 3 dias (``modo="consulta"``); senão, emite uma nova (``modo="emissao"``). ``emitir_nova=True`` força uma nova emissão. + + Para CPF, a Receita exige ``data_nascimento`` do titular + (``DD/MM/AAAA`` ou ``AAAA-MM-DD``). """ - params = {**_um_documento(cpf=cpf, cnpj=cnpj), "emitir_nova": emitir_nova or None} + doc = _um_documento(cpf=cpf, cnpj=cnpj) + nascimento = (data_nascimento or "").strip() + if "cpf" in doc and not nascimento: + raise ValueError("Informe data_nascimento: a CND Federal de CPF exige a data de nascimento.") + params = { + **doc, + "data_nascimento": nascimento if "cpf" in doc else None, + "emitir_nova": emitir_nova or None, + } return cast(CertidaoFederalResponse, self._get("/api/consultar-cnd-federal", params)) def consultar_cndt( diff --git a/src/fiscalapi_br/_version.py b/src/fiscalapi_br/_version.py index 6a9beea..3d18726 100644 --- a/src/fiscalapi_br/_version.py +++ b/src/fiscalapi_br/_version.py @@ -1 +1 @@ -__version__ = "0.4.0" +__version__ = "0.5.0"