diff --git a/README.md b/README.md index 0aa2950..ff84b74 100644 --- a/README.md +++ b/README.md @@ -46,7 +46,7 @@ Todos os métodos devolvem `array` com o JSON da API. Use argumentos nomeados pa | `consultarCnpj($cnpj, forceFresh: false)` | `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: false)` | `GET /api/consultar-cnd-federal` | CND Federal (Receita Federal + PGFN) | +| `consultarCndFederal(cnpj: \| cpf: + dataNascimento:, emitirNova: false)` | `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: false)` | `GET /api/certidoes-todas` | Todas as certidões em uma chamada | @@ -117,6 +117,8 @@ if (!empty($cnd['result']['pdf_base64'])) { } $federal = $api->consultarCndFederal(cnpj: '12345678000195'); +// CPF: a Receita exige a data de nascimento (DD/MM/AAAA ou AAAA-MM-DD) +$federalPf = $api->consultarCndFederal(cpf: '12345678909', dataNascimento: '12/04/1985'); $trabalhista = $api->consultarCndt(cnpj: '12345678000195'); $fgts = $api->consultarCrfFgts(cnpj: '12345678000195'); ``` diff --git a/src/FiscalAPI.php b/src/FiscalAPI.php index 0de954a..fd8c2cc 100644 --- a/src/FiscalAPI.php +++ b/src/FiscalAPI.php @@ -21,7 +21,7 @@ */ final class FiscalAPI { - public const VERSION = '0.4.0'; + public const VERSION = '0.5.0'; public const DEFAULT_BASE_URL = 'https://api.fiscalapi.com.br'; /** Algumas consultas (NF-e, SIGEF) podem levar até 180 s no servidor. */ public const DEFAULT_TIMEOUT = 200; @@ -138,11 +138,24 @@ public function consultarCndTodos(?string $cpf = null, ?string $cnpj = null): ar return $this->get('/api/consultar-cnd-todos', self::umDocumento(['cpf' => $cpf, 'cnpj' => $cnpj])); } - /** CND Federal — Receita Federal + PGFN (GET /api/consultar-cnd-federal). */ - public function consultarCndFederal(?string $cpf = null, ?string $cnpj = null, bool $emitirNova = false): array - { + /** + * CND Federal — Receita Federal + PGFN (GET /api/consultar-cnd-federal). + * Para CPF, a Receita exige $dataNascimento do titular (DD/MM/AAAA ou AAAA-MM-DD). + */ + public function consultarCndFederal( + ?string $cpf = null, + ?string $cnpj = null, + bool $emitirNova = false, + ?string $dataNascimento = null, + ): array { + $doc = self::umDocumento(['cpf' => $cpf, 'cnpj' => $cnpj]); + $nascimento = trim($dataNascimento ?? ''); + if (isset($doc['cpf']) && $nascimento === '') { + throw new \InvalidArgumentException('Informe dataNascimento: a CND Federal de CPF exige a data de nascimento.'); + } return $this->get('/api/consultar-cnd-federal', [ - ...self::umDocumento(['cpf' => $cpf, 'cnpj' => $cnpj]), + ...$doc, + 'data_nascimento' => isset($doc['cpf']) ? $nascimento : null, 'emitir_nova' => $emitirNova ?: null, ]); }