PHPackages                             nf26/sdk-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. nf26/sdk-php

ActiveLibrary[API Development](/categories/api)

nf26/sdk-php
============

SDK PHP para integração com API NF26 - Compatível com CloudDFE SDK

1.0.1(7mo ago)01MITPHPPHP >=7.4

Since Nov 30Pushed 7mo agoCompare

[ Source](https://github.com/brazrei/nf26-sdk-php)[ Packagist](https://packagist.org/packages/nf26/sdk-php)[ RSS](/packages/nf26-sdk-php/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (1)Versions (3)Used By (0)

NF26 SDK PHP
============

[](#nf26-sdk-php)

SDK PHP para integração com API NF26 - **Compatível com CloudDFE SDK**

Este SDK mantém a mesma interface do SDK CloudDFE, permitindo que clientes migrem facilmente apenas mudando a URL base.

📋 Características
-----------------

[](#-características)

- ✅ **100% compatível** com CloudDFE SDK
- ✅ **Mesma interface** - apenas mude a `base_url`
- ✅ **Migração fácil** - sem necessidade de alterar código existente
- ✅ **Suporte completo** para NF-e (NFe) e NFSe

🚀 Instalação
------------

[](#-instalação)

```
composer require nf26/sdk-php
```

Ou clone este repositório e instale as dependências:

```
cd sdk-php
composer install
```

📦 Requisitos
------------

[](#-requisitos)

- PHP >= 7.4
- Extensão PHP: `json`, `curl`, `openssl`
- **Nota**: Usa cURL nativo (sem dependências externas), igual ao CloudDFE SDK

🔧 Configuração
--------------

[](#-configuração)

```
use CashNFe\SdkPHP\Nfe;

// Para Homologação
$configSDK = [
    "token" => "seu_token_aqui",
    "ambiente" => 2, // 1 = Produção, 2 = Homologação
    "base_url" => "https://hom-api.nf26.cloud", // URL da API NF26 - Homologação
    "options" => [
        "debug" => false,
        "timeout" => 120
    ]
];

// Para Produção
$configSDKProducao = [
    "token" => "seu_token_aqui",
    "ambiente" => 1, // Produção
    "base_url" => "https://api.nf26.cloud", // URL da API NF26 - Produção
    "options" => [
        "debug" => false,
        "timeout" => 120
    ]
];

$nfe = new Nfe($configSDK);
```

✅ Teste Rápido - Verificar Conexão
----------------------------------

[](#-teste-rápido---verificar-conexão)

Teste simples para verificar se o SDK está conectado corretamente ao servidor de homologação:

```
 "12345678000190"
];

$resp = $nfe->cria($payload);

if ($resp->sucesso) {
    echo "NFe emitida! Chave: " . $resp->chave;
} else {
    echo "Erro: " . $resp->mensagem;
}
```

### Emitir NF-e - Opção 2: Dados Estruturados (NOVO! 🎉)

[](#emitir-nf-e---opção-2-dados-estruturados-novo-)

**Agora você pode emitir NF-e usando dados estruturados, sem precisar gerar XML manualmente!**

O SDK converte automaticamente os dados estruturados para XML válido:

```