From f31f0c493faf66408489cca822aaa4e815ed4c06 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lu=C3=ADs=20Eduardo?= Date: Sun, 15 Nov 2026 22:38:45 -0300 Subject: [PATCH 1/3] =?UTF-8?q?feat:=20m=C3=A9todo=20consultarCteXml=20par?= =?UTF-8?q?a=20o=20XML=20de=20CT-e=20por=20chave?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 20 +++++++++++++++++++- src/FiscalAPI.php | 20 ++++++++++++++++++++ 2 files changed, 39 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index ac07595..6d5ec28 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # FiscalAPI — SDK PHP -Cliente PHP da [FiscalAPI](https://fiscalapi.com.br): Inscrição Estadual nos 27 estados, CNPJ, certidões (CND estadual, CND Federal, CNDT, CRF/FGTS), XML de NF-e por chave, NFS-e por chave, Simples Nacional, SIGEF, CNIR e perfil do produtor rural. +Cliente PHP da [FiscalAPI](https://fiscalapi.com.br): Inscrição Estadual nos 27 estados, CNPJ, certidões (CND estadual, CND Federal, CNDT, CRF/FGTS), XML de NF-e e de CT-e por chave, NFS-e por chave, Simples Nacional, SIGEF, CNIR e perfil do produtor rural. - PHP 8.1 ou superior, só com a extensão `curl` (nenhum pacote do Composer). - Autoload PSR-4 (`FiscalApiBr\`). @@ -53,6 +53,7 @@ Todos os métodos devolvem `array` com o JSON da API. Use argumentos nomeados pa | `consultarSimplesNacional($cnpj)` | `GET /api/consultar-simples-nacional` | Situação no Simples Nacional e SIMEI | | `consultarNfse($chave, danfse: false)` | `GET /api/consultar-nfse` | NFS-e (padrão nacional) por chave, sem certificado | | `consultarNfeXml($chave, $certificado, $senha, manifestar: true)` | `POST /api/consultar-nfe-xml` | XML completo da NF-e | +| `consultarCteXml($chave, $certificado, $senha)` | `POST /api/consultar-cte-xml` | XML completo do CT-e | | `consultarSigef(cpf: \| cnpj:)` | `GET /api/consultar-sigef` | Parcelas certificadas no SIGEF/INCRA | | `consultarSigefParcela($uuid, forceFresh: false)` | `GET /api/consultar-sigef-parcela` | Uma parcela com polígono, vértices e confrontantes | | `consultarCnir(cpf: \| cnpj:)` | `GET /api/consultar-cnir` | Imóveis rurais no CNIR/CAFIR | @@ -139,6 +140,23 @@ if ($nota['status'] === 'ok') { O certificado A1 precisa ser de um participante da nota (emitente, destinatário, transportador ou autorizado) e **não é armazenado** pela API. Só há cobrança quando o XML é devolvido. +### XML de CT-e por chave + +```php +$cte = $api->consultarCteXml( + '51261011222333000181570010000001231123456784', + 'certificado.pfx', // caminho do arquivo ou conteúdo em base64 + 'senha-do-certificado', +); +if ($cte['status'] === 'ok') { + file_put_contents($cte['chave'] . '.xml', $cte['xml']); +} else { + echo $cte['status'], ': ', $cte['mensagem'], PHP_EOL; +} +``` + +Aceita CT-e (modelo 57), CT-e OS (67) e GTV-e (64). O certificado A1 precisa ser de um participante do documento (emitente, tomador, remetente, destinatário, expedidor ou recebedor) e **não é armazenado** pela API. Só há cobrança quando o XML é devolvido. + ### Imóvel rural ```php diff --git a/src/FiscalAPI.php b/src/FiscalAPI.php index 88f2350..1ca99ac 100644 --- a/src/FiscalAPI.php +++ b/src/FiscalAPI.php @@ -195,6 +195,26 @@ public function consultarNfeXml(string $chave, string $certificado, string $senh ]); } + /** + * XML completo de um CT-e, CT-e OS ou GTV-e pela chave de acesso (POST /api/consultar-cte-xml). + * + * @param string $chave Chave de acesso com 44 dígitos. + * @param string $certificado Caminho do arquivo .pfx/.p12 ou o conteúdo em base64. + * O certificado não é armazenado pela API. + * @param string $senha Senha do certificado. + */ + public function consultarCteXml(string $chave, string $certificado, string $senha): array + { + if (trim($chave) === '') { + throw new \InvalidArgumentException('Informe a chave de acesso.'); + } + return $this->request('POST', '/api/consultar-cte-xml', [], [ + 'chave' => preg_replace('/\D/', '', $chave), + 'certificado' => self::certificadoBase64($certificado), + 'senha' => $senha, + ]); + } + /** * NFS-e (padrão nacional) pela chave de acesso, sem certificado * (GET /api/consultar-nfse). Com $danfse = true, inclui o PDF do DANFSe em From d312f652348438ce734c94d01d69ecc709d469c1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lu=C3=ADs=20Eduardo?= Date: Sun, 15 Nov 2026 22:45:22 -0300 Subject: [PATCH 2/3] =?UTF-8?q?fix:=20chave=20do=20CT-e=20aceita=20CNPJ=20?= =?UTF-8?q?alfanum=C3=A9rico=20(tira=20s=C3=B3=20separadores)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/FiscalAPI.php | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/FiscalAPI.php b/src/FiscalAPI.php index 1ca99ac..2688714 100644 --- a/src/FiscalAPI.php +++ b/src/FiscalAPI.php @@ -209,7 +209,8 @@ public function consultarCteXml(string $chave, string $certificado, string $senh throw new \InvalidArgumentException('Informe a chave de acesso.'); } return $this->request('POST', '/api/consultar-cte-xml', [], [ - 'chave' => preg_replace('/\D/', '', $chave), + // Aceita CNPJ alfanumérico: só tira separadores e põe em maiúsculas. + 'chave' => strtoupper(preg_replace('/[^0-9A-Za-z]/', '', $chave) ?? ''), 'certificado' => self::certificadoBase64($certificado), 'senha' => $senha, ]); From d35422d692776858b21cbb07265c26a97b17a74d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lu=C3=ADs=20Eduardo?= Date: Mon, 16 Nov 2026 08:51:10 -0300 Subject: [PATCH 3/3] =?UTF-8?q?chore:=20vers=C3=A3o=200.3.0=20(consultarCt?= =?UTF-8?q?eXml)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/FiscalAPI.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/FiscalAPI.php b/src/FiscalAPI.php index 2688714..fca4bc5 100644 --- a/src/FiscalAPI.php +++ b/src/FiscalAPI.php @@ -21,7 +21,7 @@ */ final class FiscalAPI { - public const VERSION = '0.2.0'; + public const VERSION = '0.3.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;