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\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\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
Loading please wait ...
Before you can download the PHP files, the dependencies should be resolved. This can take some minutes. Please be patient.