PHP code example of brasilnfe / brasilnfe-php-sdk

1. Go to this page and download the library: Download brasilnfe/brasilnfe-php-sdk library. Choose the download type require.

2. Extract the ZIP file and open the index.php.

3. Add this code to the index.php.
    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

brasilnfe / brasilnfe-php-sdk example snippets




rasilNFeSdk\BrasilNFe;

$token     = 'SEU_TOKEN_AQUI';     // Token da empresa (obrigatório)
$userToken = 'SEU_USER_TOKEN';     // Token do usuário (opcional, p/ Empresa)

$bnfe = new BrasilNFe($token, $userToken);

// Por padrão o SDK aponta para https://api.brasilnfe.com.br/services/
// Para sobrescrever (ex.: ambiente interno / sandbox específico):
$bnfe = new BrasilNFe($token, $userToken, 'https://api.brasilnfe.com.br/services/');



rasilNFeSdk\BrasilNFe;
use BrasilNFeSdk\Envio\NFe\StatusSefazEnvio;

$bnfe = new BrasilNFe('SEU_TOKEN');

$req = new StatusSefazEnvio();
$req->modeloDocumento = 55;
$req->tipoAmbiente    = 2; // homologação

$resp = $bnfe->Consultas->consultarStatusSefaz($req);

echo $resp->statusSefaz->dsStatusRespostaSefaz ?? 'indisponível';



use BrasilNFeSdk\BrasilNFe;
use BrasilNFeSdk\Envio\NFe\{NotaFiscalEnvio, Produto, Pagamento, Volume};

$bnfe = new BrasilNFe('SEU_TOKEN');

$nf = new NotaFiscalEnvio();
$nf->tipoAmbiente       = 2;           // 1=Produção, 2=Homologação
$nf->modeloDocumento    = 55;          // NF-e
$nf->finalidade         = 1;           // Normal
$nf->naturezaOperacao   = 'VENDA DE MERCADORIA';
$nf->indicadorPresenca  = 1;
$nf->consumidorFinal    = false;
$nf->enviarEmail        = true;

// Destinatário
$nf->cliente->cpfCnpj     = '00000000000191';
$nf->cliente->nmCliente   = 'EMPRESA EXEMPLO LTDA';
$nf->cliente->indicadorIe = 1;         // Contribuinte ICMS
$nf->cliente->ie          = '123456789';
$nf->cliente->email       = '[email protected]';
$nf->cliente->endereco->logradouro   = 'Av. Industrial';
$nf->cliente->endereco->numero       = '500';
$nf->cliente->endereco->bairro       = 'Distrito Industrial';
$nf->cliente->endereco->codMunicipio = '3550308';
$nf->cliente->endereco->municipio    = 'São Paulo';
$nf->cliente->endereco->uf           = 'SP';
$nf->cliente->endereco->cep          = '01000000';

// Produto
$produto = new Produto();
$produto->codProdutoServico = 'COD-100';
$produto->nmProduto         = 'PARAFUSADEIRA ELETRICA 220V';
$produto->ncm               = '84672100';
$produto->cfop              = 5102;
$produto->unidadeComercial  = 'UN';
$produto->quantidade        = 2;
$produto->valorUnitario     = 150.00;
$produto->valorTotal        = 300.00;
$produto->origemProduto     = 0;

$produto->imposto->icms->codSituacaoTributaria   = '102';
$produto->imposto->icms->aliquotaICMS            = 0;
$produto->imposto->pis->codSituacaoTributaria    = '99';
$produto->imposto->pis->aliquota                 = 0;
$produto->imposto->cofins->codSituacaoTributaria = '99';
$produto->imposto->cofins->aliquota              = 0;

$nf->produtos[] = $produto;

// Pagamento
$pagamento = new Pagamento();
$pagamento->indicadorPagamento = 0;     // À vista
$pagamento->formaPagamento     = '15';  // Boleto
$pagamento->vlPago             = 300.00;
$nf->pagamentos[] = $pagamento;

// Transporte
$nf->transporte->modalidadeFrete = 0;   // CIF
$volume = new Volume();
$volume->quantidadeVolume = 2;
$volume->especie          = 'CAIXA';
$volume->pesoBruto        = 5.500;
$volume->pesoLiquido      = 5.000;
$nf->transporte->volumes = [$volume];

try {
    $resposta = $bnfe->NotaFiscal->enviarNotaFiscal($nf);

    if ($resposta->returnNF->ok) {
        echo "NF-e autorizada!\n";
        echo "Chave:     {$resposta->returnNF->chaveNf}\n";
        echo "Protocolo: {$resposta->returnNF->numero}\n";
        echo "PDF:       " . ($resposta->base64File ? 'recebido' : 'não gerado') . "\n";
    } else {
        echo "Rejeitada: {$resposta->returnNF->dsStatusRespostaSefaz}\n";
    }
} catch (\Exception $e) {
    echo "Erro de comunicação: {$e->getMessage()}\n";
}

use BrasilNFeSdk\Envio\NFe\{NotaFiscalEnvio, Produto, Pagamento};

$nfce = new NotaFiscalEnvio();
$nfce->tipoAmbiente      = 2;
$nfce->modeloDocumento   = 65;       // NFC-e
$nfce->finalidade        = 1;
$nfce->naturezaOperacao  = 'VENDA AO CONSUMIDOR';
$nfce->indicadorPresenca = 1;
$nfce->consumidorFinal   = true;     // obrigatório na NFC-e

$nfce->cliente->cpfCnpj = '12345678909'; // opcional em valores baixos

$item = new Produto();
$item->codProdutoServico = 'REFRI-LATA';
$item->nmProduto         = 'REFRIGERANTE LATA 350ML';
$item->ncm               = '22021000';
$item->cfop              = 5102;
$item->unidadeComercial  = 'UN';
$item->quantidade        = 1;
$item->valorUnitario     = 5.00;
$item->valorTotal        = 5.00;
$item->origemProduto     = 0;
$item->imposto->icms->codSituacaoTributaria   = '102';
$item->imposto->pis->codSituacaoTributaria    = '99';
$item->imposto->cofins->codSituacaoTributaria = '99';
$nfce->produtos[] = $item;

$pag = new Pagamento();
$pag->indicadorPagamento = 0;
$pag->formaPagamento     = '03';   // Cartão de crédito
$pag->vlPago             = 5.00;
$pag->bandeiraOperadora  = '01';   // Visa
$nfce->pagamentos[] = $pag;

$resposta = $bnfe->NotaFiscal->enviarNotaFiscal($nfce);

use BrasilNFeSdk\Envio\NFe\{NotaFiscalLoteEnvio, NFInfo};

$lote = new NotaFiscalLoteEnvio();
$lote->tipoAmbiente    = 2;
$lote->modeloDocumento = 55;

foreach ($pedidos as $pedido) {
    $nf = new NFInfo();
    // …preencher como no exemplo 1
    $lote->nfInfos[] = $nf;
}

$resp = $bnfe->NotaFiscal->enviarNotaFiscalLote($lote);

foreach ($resp->notas as $nota) {
    echo "{$nota->identificadorInterno}: {$nota->returnNf->chaveNf}\n";
}

use BrasilNFeSdk\Envio\NFSe\{NotaFiscalServicoEnvio, NFSInfo};

$nfse = new NotaFiscalServicoEnvio();
$nfse->tipoAmbiente = 2;

$info = new NFSInfo();
$info->tomador->cpfCnpj = '00000000000191';
$info->servico->descricao    = 'Consultoria em tecnologia';
$info->servico->valores->valorServico = 1500.00;
$nfse->nFSInfo[] = $info;

$resp = $bnfe->NotaFiscal->enviarNotaFiscalServico($nfse);

use BrasilNFeSdk\Envio\CTe\CTeEnvio;

$cte = new CTeEnvio();
// preencha remetente, destinatário, tomador, serviço, carga, etc.
$resp = $bnfe->NotaFiscal->enviarConhecimentoTransporte($cte);

use BrasilNFeSdk\Envio\NFe\CancelarNotaFiscalEnvio;

$cancel = new CancelarNotaFiscalEnvio();
$cancel->chaveNF         = '35230100000000000000550010000000011000000000';
$cancel->numeroProtocolo = '135230000000000';
$cancel->justificativa   = 'Erro de digitação no valor do produto';

$resp = $bnfe->Eventos->cancelarNotaFiscal($cancel);
echo $resp->status ?? 'ok';

use BrasilNFeSdk\Envio\NFe\CartaCorrecaoEnvio;

$cce = new CartaCorrecaoEnvio();
$cce->tipoAmbiente     = 1;
$cce->chaveNF          = '35230100000000000000550010000000011000000000';
$cce->correcao         = 'Correção na descrição do produto item 1';
$cce->numeroSequencial = 1;

$bnfe->Eventos->enviarCartaCorrecao($cce);

use BrasilNFeSdk\Envio\NFe\InutilizarNumeracaoEnvio;

$inut = new InutilizarNumeracaoEnvio();
$inut->tipoAmbiente     = 1;
$inut->modeloDocumento  = 55;
$inut->serie            = 1;
$inut->numeracaoInicial = 101;
$inut->numeracaoFinal   = 105;
$inut->justificativa    = 'Falha no sistema durante emissão sequencial';

$bnfe->Eventos->inutilizarNumeracao($inut);

use BrasilNFeSdk\Envio\NFe\ManifestarNotaFiscalEnvio;

$evt = new ManifestarNotaFiscalEnvio();
$evt->chave            = '35230100000000000000550010000000011000000000';
$evt->tipoAmbiente     = 1;
$evt->tipoManifestacao = 1; // 1=Confirmação, 2=Ciência, 3=Desconhecimento, 4=Não realizada

$bnfe->Eventos->manifestarNotaFiscal($evt);

use BrasilNFeSdk\Envio\NFe\StatusSefazEnvio;

$req = new StatusSefazEnvio();
$req->tipoAmbiente    = 2;
$req->modeloDocumento = 55;

$resp = $bnfe->Consultas->consultarStatusSefaz($req);
echo $resp->statusSefaz->dsStatusRespostaSefaz;

use BrasilNFeSdk\Envio\NFe\BuscarNotaFiscalEnvio;

$busca = new BuscarNotaFiscalEnvio();
$busca->tipoDocumentoFiscal = 1;                 // 0=Entradas, 1=Saídas
$busca->dtInicio = new \DateTime('2026-04-01');
$busca->dtFim    = new \DateTime('2026-04-18');

$resp = $bnfe->Consultas->obterNotasFiscais($busca);

use BrasilNFeSdk\Envio\NFe\PegarArquivoEnvio;

$req = new PegarArquivoEnvio();
$req->chaveNF  = '35230100000000000000550010000000011000000000';
$req->fileType = 2;                // 1=XML, 2=DANFE/Cupom
$req->tipoDocumentoFiscal = 1;     // 0=Entrada, 1=Saída

$bytes = $bnfe->Arquivos->obterArquivoNotaFiscal($req);   // já vem decodificado de base64
file_put_contents('danfe.pdf', $bytes);

use BrasilNFeSdk\Envio\Outros\{SpedEnvio, SintegraEnvio};

$sped = new SpedEnvio();
// preencha período, tipo, finalidade…
$resp = $bnfe->Arquivos->gerarArquivoSped($sped);

$sintegra = new SintegraEnvio();
$resp = $bnfe->Arquivos->gerarArquivoSintegra($sintegra);

use BrasilNFeSdk\Envio\Empresa\{EmpresaEnvio, CertificadoEnvio};

$bnfe = new BrasilNFe('TOKEN', 'USER_TOKEN');

// Cadastro
$empresa = new EmpresaEnvio();
$empresa->cnpj     = '00000000000191';
$empresa->rzSocial = 'EMPRESA EXEMPLO LTDA';
$empresa->crt      = 1;   // 1=Simples, 3=Regime Normal
$bnfe->Empresa->adicionarEmpresa($empresa);

// Certificado A1
$cert = new CertificadoEnvio();
$cert->base64Certificado = base64_encode(file_get_contents('certificado.pfx'));
$cert->senha             = 'senha-do-pfx';
$bnfe->Empresa->alterarCertificado($cert);

// Listagem
$empresas = $bnfe->Empresa->buscarTodasEmpresas();

try {
    $resp = $bnfe->NotaFiscal->enviarNotaFiscal($nf);

    if (!$resp->returnNF->ok) {
        echo "Rejeitada [{$resp->returnNF->codStatusRespostaSefaz}] "
           . "{$resp->returnNF->dsStatusRespostaSefaz}\n";

        if (!empty($resp->error))  { echo "Erro: {$resp->error}\n"; }
        foreach ($resp->avisos ?? [] as $aviso) {
            echo "Aviso: {$aviso}\n";
        }
        return;
    }

    echo "Autorizada: chave {$resp->returnNF->chaveNf}\n";
} catch (\Throwable $e) {
    error_log("Falha na integração Brasil NFe: " . $e->getMessage());
}

use BrasilNFeSdk\BrasilNFeHelper;

BrasilNFeHelper::ratear(
    $nf->produtos,
    50.00,                                // valor total a distribuir (ex.: frete)
    fn($p) => $p->valorFrete ?? 0,        // seletor do campo a atualizar
    fn($p) => $p->valorTotal,             // seletor da proporção (base)
    BrasilNFeHelper::TIPO_SOMAR           // SUBSTITUIR | SOMAR | SUBTRAIR
);
bash
composer 

src/
├── BrasilNFe.php          # Classe agregadora
├── BrasilNFeRequest.php   # Camada HTTP + serialização
├── Methods/               # Módulos de alto nível
├── Envio/                 # DTOs de entrada (payloads)
│   ├── NFe/
│   ├── CTe/
│   ├── MDFe/
│   ├── Empresa/
│   └── Outros/
└── Retorno/               # DTOs de retorno da API