SPED NFe

https://github.com/nfephp-org/sped-nfe
Admin
A PHP library for generating, signing, and sending electronic invoices (NFe and NFCe) to Brazilian...
Tokens:401,029
Snippets:2,158
Trust Score:7.8
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### PHP example: calling tagprod with stdClass parameters

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/MakePL010.md

Shows how to instantiate stdClass, set product fields (item, cProd, cEAN, etc.), and call $mk->tagprod($std). Required fields are marked; optional fields include CEST, indEscala, CNPJFab, tpCredPresIBSZFM, and vItem. The example sets some optional fields to null and includes comments with validation rules.

```php
$std = new stdClass();
$std->item = 1; //OBRIGATÓRIO referencia ao item da NFe 1 a 990
$std->cProd = '23qq'; //OBRIGATÓRIO de 1 à 60 caracteres
$std->cEAN = "SEM GTIN";//OBRIGATÓRIO SEM GTIN|[0-9]{0}|[0-9]{8}|[0-9]{12,14}
$std->cBarra = "123";//opcional de 3 à 30 caracteres
$std->xProd = 'SERVICO'; //OBRIGATÓRIO 1 a 120 caracteres
$std->NCM = 99; //OBRIGATÓRIO [0-9]{2}|[0-9]{8}
$std->CEST = '1234567'; //opcional usado apenas para produtos com ST 7 digitos
$std->indEscala = 'S'; //opcional usado junto com CEST, S-escala relevante N-escala NÃO relevante
$std->CNPJFab = '12345678901234'; //opcional usado junto com CEST e qunado indEscala = N
$std->cBenef = 'ab222222'; //opcional codigo beneficio fiscal ([!-ÿ]{8}|[!-ÿ]{10}|SEM CBENEF)?
$std->tpCredPresIBSZFM = null; //opcional Classificação para subapuração do IBS na ZFM **[PL_010_V1.30]**
    // 0 - Sem Crédito Presumido
    // 1 - Bens de consumo final (55%)
    // 2 - Bens de capital (75%)
    // 3 - Bens intermediários (90,25%)
    // 4 - Bens de informática e outros definidos em legislação (100%)
$std->EXTIPI = '01';
$std->CFOP = 5933;
$std->uCom = 'UN';
$std->qCom = 10;
$std->vUnCom = 100.00;
$std->vProd = 1000.00;
$std->cEANTrib = "SEM GTIN";//'6361425485451';
$std->uTrib = 'UN';
$std->qTrib = 10;
$std->vUnTrib = 100.00;
$std->vFrete = 1000.00;
$std->vSeg = 20.00;
$std->vDesc = 10.00;
$std->vOutro = 15.00;
$std->indTot = 1;
$std->indBemMovelUsado = null; //opcional 1-Bem Móvel Usado ou null
$std->xPed = '12345';
$std->nItemPed = 1;
$std->nFCI = '12345678-1234-1234-1234-123456789012';
$std->CEST = null;
$std->indEscala = null;
$std->CNPJFab = null;
$std->vItem = null; //opcional Valor total do Item, correspondente à sua participação no total da nota.
    // A soma dos itens deverá corresponder ao total da nota. com duas decimais
$mk->tagprod($std);
```

--------------------------------

### Run tests with Composer

Source: https://github.com/nfephp-org/sped-nfe/blob/master/CONTRIBUTING.md

Executes the project's test suite using Composer. This is the standard way to run tests as mentioned in the contributing guide.

```bash
$ composer test
```

--------------------------------

### Open fstab with nano

Source: https://github.com/nfephp-org/sped-nfe/wiki/Start-Guide

Opens the /etc/fstab file in the nano editor to add a swap entry.

```bash
nano /etc/fstab
```

--------------------------------

### Install development version with Composer

Source: https://github.com/nfephp-org/sped-nfe/blob/master/README.md

Use this command to install the development version (branch master) of the sped-nfe package.

```bash
composer require nfephp-org/sped-nfe:dev-master
```

--------------------------------

### Install stable version with Composer

Source: https://github.com/nfephp-org/sped-nfe/blob/master/README.md

Use this command to install the stable version of the sped-nfe package via Composer.

```bash
composer require nfephp-org/sped-nfe
```

--------------------------------

### Exemplo de uso do método sefazDownload

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/metodos/Download.md

Exemplo de uso do método sefazDownload para baixar uma NF-e confirmada. Requer configuração JSON, certificado PFX e senha. O serviço opera apenas em ambiente de produção e modelo 55. A resposta é um XML que pode ser enviado diretamente ao cliente.

```php
use NFePHP\NFe\Tools;
use NFePHP\Common\Certificate;

try {
    
    $tools = new Tools($configJson, Certificate::readPfx($pfxcontent, $password));
    //só funciona para o modelo 55
    $tools->model('55');
    //este serviço somente opera em ambiente de produção
    $this->tools->setEnvironment(1);
    $chave = '35180174283375000142550010000234761182919182';
    $response = $tools->sefazDownload($chave);
    header('Content-type: text/xml; charset=UTF-8');
    echo $response;
    
} catch (\Exception $e) {
    echo str_replace("\n", "<br/>", $e->getMessage());
}
```

--------------------------------

### Tools::sefazDownload($chave)

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/metodos/Download.md

Método síncrono para download de NF-e confirmadas pelo destinatário. Requer configuração, certificado digital e ambiente de produção. Retorna o XML da NF-e.

```APIDOC
## Tools::sefazDownload($chave)

### Description
Serviço de download da NF-e para uma determinada Chave de Acesso informada, para as NF-e confirmadas pelo destinatário. Processo síncrono.

### Method
sefazDownload

### Endpoint
nfeDownloadNF

### Parameters
#### Path Parameters
- **$chave** (string) - Obrigatório - Chave de 44 dígitos da NFe de interesse.

#### Configuration Parameters
- **$configJson** (string) - Obrigatório - String JSON com os dados de configuração.
- **$pfxcontent** (string) - Obrigatório - String com o conteúdo do certificado PFX.
- **$password** (string) - Obrigatório - String com a senha de acesso ao certificado PFX.

### Request Example
```php
use NFePHP\NFe\Tools;
use NFePHP\Common\Certificate;

try {
    $tools = new Tools($configJson, Certificate::readPfx($pfxcontent, $password));
    //só funciona para o modelo 55
    $tools->model('55');
    //este serviço somente opera em ambiente de produção
    $tools->setEnvironment(1);
    $chave = '35180174283375000142550010000234761182919182';
    $response = $tools->sefazDownload($chave);
    header('Content-type: text/xml; charset=UTF-8');
    echo $response;
} catch (\Exception $e) {
    echo str_replace("\n", "<br/>", $e->getMessage());
}
```

### Response
#### Success Response (200)
- **response** (string) - XML da NF-e baixada.

#### Response Example
```xml
<xml da NF-e>
```

### Notes
- Este serviço NÃO está disponível para os emitentes, mas apenas aos destinatários, transportadores e outros autorizados, desde que essa NFe tenha sido previamente manifestada.
- O serviço somente opera em ambiente de produção.
- O modelo deve ser '55'.
```

--------------------------------

### taggEstornoCred usage example

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/MakePL010.md

Creates the gEstornoCred node. The $std object must include item, vIBSEstCred, and vCBSEstCred fields, all marked as OBRIGATÓRIO. The example sets vIBSEstCred to 34.22 and vCBSEstCred to 87.41.

```php
$std = new stdClass();
$std->item = 1; //OBRIGATÓRIO referencia ao item da NFe
$std->vIBSEstCred = 34.22; //OBRIGATÓRIO Valor do IBS a ser estornado
$std->vCBSEstCred = 87.41; //OBRIGATÓRIO Valor da CBS a ser estornada

$mk->taggEstornoCred($std);
```

--------------------------------

### Exemplo de uso do método signNFe()

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/metodos/SignNFe.md

Exemplo de como instanciar a classe Tools com o certificado A1 e chamar o método signNFe() para assinar o XML da NFe. O método retorna uma string com o XML assinado. Exceções são capturadas e tratadas no bloco catch.

```php
use NFePHP\NFe\Tools;
use NFePHP\Common\Certificate;

try {
    $tools = new Tools($configJson, Certificate::readPfx($content, $password));
    $response = $tools->signNFe($xml);
   
} catch (\Exception $e) {
    //aqui você trata possiveis exceptions
    echo $e->getMessage();
}
```

--------------------------------

### tagentrega usage example

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/MakePL010.md

Creates the delivery location node. The $ent array includes required and optional fields; note that CNPJ and CPF are mutually exclusive, and CNPJ is prioritized if both are provided. The example shows a CPF being used.

```php
$ent = [
    'xNome' => 'Ele Ltda', //OBRIGATÓRIO 2 a 60 caracteres
    //'CNPJ' => '01234123456789', //opcional se informar o CPF NOTA: a partir de 2026 ALFA [A-Z0-9]{12}[0-9]{2}
    'CPF' => '12345678901', //opcional se informar o CNPJ
    'IE' => '11111111111',
    'xLgr' => 'Rua A', //OBRIGATÓRIO 2 a 60 caracteres
    'nro' => '1', //OBRIGATÓRIO 1 a 60 caracteres
    'xCpl' => 'frente', //opcional 1 a 60 caracteres
    'xBairro' => 'Fim do mundo', //OBRIGATÓRIO 2 a 60 caracteres
    'cMun' => 3512345, //OBRIGATÓRIO 7 digitos
    'xMun' => 'São Vito', //OBRIGATÓRIO 2 a 60 caracteres
    'UF' => 'SP', //OBRIGATÓRIO 2 caracteres
    'CEP' => '00000000', //opcional 8 digitos
    'cPais' => 1058, //opcional 1 à 4 digitos
    'xPais' => 'Brasil', //opcional 2 a 60 caracteres
    'fone' => '222222', //opcional de 6 a 14 digitos
    'email' => 'ele@mail.com' //opcional 1 a 60 caracteres
];
$mk->tagentrega((object)$ent);
```

--------------------------------

### tag AgropecuarioGuia

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/MakePL010.md

Creates data of the agricultural transport guide (optional).

```APIDOC
## tag AgropecuarioGuia

### Description
Cria dados da Guia de transporte Agropecuario (opcional).

### Method
N/A

### Endpoint
N/A

### Parameters
N/A

### Request Example
N/A

### Response
N/A
```

--------------------------------

### tagdup($std):DOMElement

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/Make.md

Creates the XML node for installment (duplicate) information.

```APIDOC
## tagdup($std):DOMElement

### Description
Node de informações das duplicatas.

### Method
Function call

### Parameters
- **$std** (stdClass) - Required - Contêm os dados dos campos, nomeados conforme manual.

### Request Example
```php
$std = new stdClass();
$std->nDup = '1233-1';
$std->dVenc = '2017-08-22';
$std->vDup = 1254.22;

$nfe->tagdup($std);
```

### Response
Returns a DOMElement representing the installment node.
```

--------------------------------

### Exemplo de uso do método sefazDistDFe em PHP

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/metodos/DistDFe.md

Exemplo completo de como usar o método sefazDistDFe para buscar documentos fiscais em loop. Inclui configuração do ambiente, loop com limite de iterações, tratamento de erros e extração dos dados da resposta. Recomenda-se intervalo de pelo menos 2 segundos entre consultas e limite de 50 iterações.

```php
use NFePHP\NFe\Tools;
use NFePHP\Common\Certificate;

$tools = new Tools($configJson, Certificate::readPfx($pfxcontent, $password));

//só funciona para o modelo 55
$tools->model('55');
//este serviço somente opera em ambiente de produção
$tools->setEnvironment(1);

//este numero deverá vir do banco de dados nas proximas buscas para reduzir 
//a quantidade de documentos, e para não baixar várias vezes as mesmas coisas.
$ultNSU = 0;
$maxNSU = $ultNSU;
$loopLimit = 12; //mantenha o numero de consultas abaixo de 20, cada consulta retorna até 50 documentos por vez
$iCount = 0;

//executa a busca de DFe em loop
while ($ultNSU <= $maxNSU) {
    $iCount++;
    if ($iCount >= $loopLimit) {
        //o limite de loops foi atingido pare de consultar
        break;
    }
    try {
        //executa a busca pelos documentos
        $resp = $tools->sefazDistDFe($ultNSU);
    } catch (\Exception $e) {
        echo $e->getMessage();
        //pare de consultar e resolva o erro (pode ser que a SEFAZ esteja fora do ar)
        break;
    }
 
    //extrair e salvar os retornos
    $dom = new \DOMDocument();
    $dom->loadXML($resp);
    $node = $dom->getElementsByTagName('retDistDFeInt')->item(0);
    $tpAmb = $node->getElementsByTagName('tpAmb')->item(0)->nodeValue;
    $verAplic = $node->getElementsByTagName('verAplic')->item(0)->nodeValue;
    $cStat = $node->getElementsByTagName('cStat')->item(0)->nodeValue;
    $xMotivo = $node->getElementsByTagName('xMotivo')->item(0)->nodeValue;
    $dhResp = $node->getElementsByTagName('dhResp')->item(0)->nodeValue;
    $ultNSU = $node->getElementsByTagName('ultNSU')->item(0)->nodeValue;
    $maxNSU = $node->getElementsByTagName('maxNSU')->item(0)->nodeValue;
    $lote = $node->getElementsByTagName('loteDistDFeInt')->item(0);
    if (in_array($cStat, ['137', '656']) {
         //137 - Nenhum documento localizado, a SEFAZ está te informando para consultar novamente após uma hora a contar desse momento
         //656 - Consumo Indevido, a SEFAZ bloqueou o seu acesso por uma hora pois as regras de consultas não foram observadas
        //nesses dois casos pare as consultas imediatamente e retome apenas daqui a uma hora, pelo menos !!
        break;
    }
    if (empty($lote)) {
        //lote vazio
        continue;
    }
    //essas tags irão conter os documentos zipados
    $docs = $lote->getElementsByTagName('docZip');
    foreach ($docs as $doc) {
        $numnsu = $doc->getAttribute('NSU');
        $schema = $doc->getAttribute('schema');
        //descompacta o documento e recupera o XML original
        $content = gzdecode(base64_decode($doc->nodeValue));
        //identifica o tipo de documento
        $tipo = substr($schema, 0, 6);
        //processar o conteudo do NSU, da forma que melhor lhe interessar
        //esse processamento depende do seu aplicativo
    }
    if ($ultNSU == $maxNSU) {
       //quando o numero máximo de NSU foi atingido não existem mais dados a buscar
       //nesse caso a proxima busca deve ser no minimo após mais uma hora
       break;
    }
    sleep(2);
}
//salve o ultNSU pesquisado em sua base pois a proxima consulta deverá iniciar a partir desse numero + 1
```

--------------------------------

### tagICMSSN usage example with CSOSN 102

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/MakePL010.md

Shows how to build the $ic array with required and optional fields for the ICMSSN node and call tagICMSSN. The example uses CSOSN 102 (Simples sem Permissão de Crédito) and sets optional fields to null. Required fields are 'item', 'orig', and 'CSOSN'.

```php
$ic = [
    'item' => 1, //OBRIGATÓRIO item da NFe 
    'orig' => '0', //OBRIGATÓRIO Origem da Mercadoria/Serviço
        //0 - Nacional, exceto as indicadas nos códigos 3 a 5;
        //1 - Estrangeira - Importação direta, exceto a indicada no código 6;
        //2 - Estrangeira - Adquirida no mercado interno, exceto a indicada no código 7;
        //3 - Nacional, mercadoria ou bem com Conteúdo de Importação superior a 40%;
        //4 - Nacional, cuja produção tenha sido feita em conformidade com os processos produtivos básicos de que tratam o Decreto-Lei nº 288/1967 , e as Leis nºs 8.248/1991, 8.387/1991, 10.176/2001 e 11.484/2007;
        //5 - Nacional, mercadoria ou bem com Conteúdo de Importação inferior ou igual a 40%;
        //6 - Estrangeira - Importação direta, sem similar nacional, constante em lista de Resolução Camex e gás natural;
        //7 - Estrangeira - Adquirida no mercado interno, sem similar nacional, constante em lista de Resolução Camex e gás natural. 
    'CSOSN' => '102', //OBRIGATÓRIO Código de Situação da Operação no Simples Nacional
        //101 - Tributação pelo Simples com Permissão de Crédito
        //102 - Tributação pelo Simples sem Permissão de Crédito
        //103 - Isenção do ICMS no Simples para receita bruta
        //201 - Simples Nacional com Permissão de Crédito e ICMS por Substituição Tributária
        //202 - Simples Nacional sem Permissão de crédito e com cobrança de ICMS por substituição tributária
        //203 - Isenção do ICMS no Simples para faixa da Receita Bruta e com cobrança de ICMS por substituição tributária
        //300 - Imunidade
        //400 - Não tributado pelo Simples
        //500 - ICMS cobrado anteriormente por substituição
        //900 - Outros. (neste código estão todas as operações que não se encaixam nos demais já citados).
    'pCredSN' => null, //opcional Alíquota aplicável de cálculo do crédito (Simples Nacional).
    'vCredICMSSN' => null, //opcional Valor crédito do ICMS que pode ser aproveitado nos termos do art. 23 da LC 123 (Simples Nacional)
    'modBCST' => null, //opcional Modalidade de determinação da BC do ICMS ST
        //0 – Preço tabelado ou máximo sugerido;
        //1 - Lista Negativa (valor);
        //2 - Lista Positiva (valor);
        //3 - Lista Neutra (valor);
        //4 - Margem Valor Agregado (%);
        //5 - Pauta (valor). (v2.0)
        //6 - Valor da Operação
    'pMVAST' => null, //opcional Percentual da Margem de Valor Adicionado ICMS ST 
    'pRedBCST' => null, //opcional Percentual da Redução de BC do ICMS ST
    'vBCST' => null, //opcional Valor da BC do ICMS ST
    'pICMSST' => null, //opcional Alíquota do imposto do ICMS ST
    'vICMSST' => null, //opcional Valor do ICMS ST
    'vBCFCPST' => null, //opcional Valor da Base de Cálculo do FCP retido por Substituição Tributária
    'pFCPST' => null, //opcional Percentual do FCP retido por Substituição Tributária"
    'vFCPST' => null, //opcional Valor do FCP retido por Substituição Tributária
     'vBCSTRet' => null, //opcional Valor da BC do ICMS ST retido
     'pST' => null, //opcional Alíquota suportada pelo Consumidor Final
     'vICMSSTRet' => null, //opcional Valor do ICMS ST retido
     'vBCFCPSTRet' => null, //opcional Valor da Base de Cálculo do FCP retido anteriormente por Substituição Tributária
     'pFCPSTRet' => null, //opcional Percentual do FCP retido anteriormente por Substituição Tributária
     'vFCPSTRet' => null, //opcional Valor do FCP retido anteiormente por Substituição Tributária
     'modBC' => null, //opcional Modalidade de determinação da BC do ICMS
        //0 - Margem Valor Agregado (%);
        //1 - Pauta (valor);
        //2 - Preço Tabelado Máximo (valor);
        //3 - Valor da Operação
     'vBC' => null, //opcional Valor da BC do ICMS
     'pRedBC' => null, //opcional Percentual da Redução de BC
     'pICMS' => null, //opcional Alíquota do imposto
     'vICMS' => null, //opcional Valor do ICMS
     'pRedBCEfet' => null, //opcional Percentual de redução da base de cálculo efetiva
     'vBCEfet' => null, //opcional Valor da base de cálculo efetiva
     'pICMSEfet' => null, //opcional Alíquota do ICMS efetiva
     'vICMSEfet' => null, //opcional Valor do ICMS efetivo
     'vICMSSubstituto' => null //opcional Valor do ICMS próprio do Substituto
];
$mk->tagICMSSN((object)$ic);
```

--------------------------------

### Correct usage with Composer autoload and namespaces

Source: https://github.com/nfephp-org/sped-nfe/blob/master/README.md

Shows the correct way to use the library: require the Composer autoload file, import the Make class with its namespace, and instantiate it.

```php
// VENDOR_DIR = pasta vendor da sua instalação composer
require VENDOR_DIR . 'autoload.php';

use NFePHP\NFe\Make;

$nfe = new Make();
```

--------------------------------

### taggCredPresOper usage example

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/MakePL010.md

Creates the gCredPresOper node. The $std object must include item, vBCCredPres, and cCredPres fields, all marked as OBRIGATÓRIO. Optional IBS and CBS subfields are provided; if one field in a subgrupo is informed, all others must also be informed. The example sets vBCCredPres to 1234.99 and cCredPres to '04'.

```php
$std = new stdClass();
$std->item = 1; //OBRIGATÓRIO referencia ao item da NFe
$std->vBCCredPres = 1234.99; //OBRIGATÓRIO
$std->cCredPres = '04'; //OBRIGATÓRIO
//subgrupo referente IBS, um dos campos for informado TODOS os outros devem ser também
$std->ibs_pCredPres = 50.00; //opcional
$std->ibs_vCredPres = 123.899; //opcional
$std->ibs_vCredPresCondSus = 12.3456; //opcional
//subgrupo referente CBS, um dos campos for informado TODOS outros devem ser também
$std->cbs_pCredPres = 50.00; //opcional
$std->cbs_vCredPres = 432.444; //opcional
$std->cbs_vCredPresCondSus = 32.983; //opcional
$mk->taggCredPresOper($std);
```

--------------------------------

### PHP: Instantiate Make class with schema and options

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/MakePL010.md

Shows how to create a Make object with a specific schema (PL_010_V1) and set options for ASCII and GTIN validation. If no schema is provided, the default PL_009_V4 is used. The setOnlyAscii and setCheckGtin methods accept boolean values to enable or disable features.

```php
$schema = 'PL_010_V1';

$mk = new Make($schema); //se não informado o schema será usado o PL_009_V4, o conjunto de xsd atualmente em uso.
$mk->setOnlyAscii(false); //opções true remove todos a acentuação ou false mantêm os acentos nos textos. DEFAULT false
$mk->setCheckGtin(false); //opções true ativa a verificação do número GTIN ou false desativa essa validação. DEFAULT false  
```

--------------------------------

### PHP example: Creating stdClass for tagICMS

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/MakePL010.md

Shows how to populate the stdClass object with ICMS fields. The item and orig fields are required, and CST determines which fields are used; fields not belonging to the indicated CST are ignored. The example sets CST to '00' (fully taxed) and includes optional fields with null defaults.

```php
$std = new stdClass();
$std->item = 1; //OBRIGATÓRIO item da NFe 
$std->orig = 0; //OBRIGATÓRIO Origem da Mercadoria/Serviço
    //0 - Nacional, exceto as indicadas nos códigos 3 a 5;
    //1 - Estrangeira - Importação direta, exceto a indicada no código 6;
    //2 - Estrangeira - Adquirida no mercado interno, exceto a indicada no código 7;
    //3 - Nacional, mercadoria ou bem com Conteúdo de Importação superior a 40%;
    //4 - Nacional, cuja produção tenha sido feita em conformidade com os processos produtivos básicos de que tratam o Decreto-Lei n.º 288/1967 , e as Leis nºs 8.248/1991, 8.387/1991, 10.176/2001 e 11.484/2007;
    //5 - Nacional, mercadoria ou bem com Conteúdo de Importação inferior ou igual a 40%;
    //6 - Estrangeira - Importação direta, sem similar nacional, constante em lista de Resolução Camex e gás natural;
    //7 - Estrangeira - Adquirida no mercado interno, sem similar nacional, constante em lista de Resolução Camex e gás natural.  
$std->CST = '00'; //OBRIGATÓRIO Código de Situação Tributária
    //00 - tributada integralmente.
    //02 - Tributação monofásica própria sobre combustíveis
    //10 - tributada e com cobrança do ICMS por substituição tributária.
    //15 - Tributação monofásica própria e com responsabilidade pela retenção sobre combustíveis
    //20 - tributada com redução de base de cálculo.
    //30 - isenta ou não tributada e com cobrança do ICMS por substituição tributária.
    //40 - isenta.
    //41 - não tributada.
    //50 - suspensão.
    //51 - diferimento (a exigência do preenchimento das informações do ICMS diferido fica a critério de cada UF).
    //53 - Tributação monofásica sobre combustíveis com recolhimento diferido
    //60 - cobrado anteriormente por substituição tributária.
    //61 - Tributação monofásica sobre combustíveis cobrada anteriormente
    //70 - tributada com redução de base de cálculo e com cobrança do ICMS por substituição tributária.
    //90 - outras (regime Normal).
$std->modBC = '3'; //OBRIGATÓRIO Modalidade de determinação da BC do ICMS
    //0 - Margem Valor Agregado (%).
    //1 - Pauta (Valor).
    //2 - Preço Tabelado Máx. (valor).
    //3 - Valor da operação
$std->vBC = '1200'; //OBRIGATÓRIO Valor da Base de Cálculo do ICMS
$std->pICMS = 10; //opcional Percentual de ICMS
$std->vICMS = 120; //opcional Valor do ICMS
$std->pFCP = null; //opcional Percentual do Fundo de Combate a Pobreza do ICMS
$std->vFCP = null; //opcional Valor do Fundo de Combate a Pobreza
$std->vBCFCP = null; //opcional Valor da Base de Cálculo do Fundo de Combate a Porbreza
$std->modBCST = null; //opcional Modalidade de determinação da base de cálculo do ICMS ST
    //0 - Preço tabelado ou máximo sugerido.
    //1 - Lista Negativa (valor).
    //2 - Lista Positiva (valor).
    //3 - Lista Neutra (valor).
    //4 - Margem Valor Agregado (%).
    //5 - Pauta (valor).
    //6 - Valor da Operação
$std->pMVAST = null; //opcional Percentual da margem de valor Adicionado do ICMS ST 
$std->pRedBCST = null; //opcional Percentual da Redução de Base de Cálculo do ICMS ST
$std->vBCST = null; //opcional Valor da Base de Calculo do ICMS ST
$std->pICMSST = null; //opcional Percentual do ICMS ST
$std->vICMSST = null; //opcional Valor do ICMS ST
$std->vBCFCPST = null; //opcional Valor da Base de Cálculo do Fundo de Combate a Pobreza do ICMS ST 
$std->pFCPST = null; //opcional Percentual do Fundo de Combate a Pobreza do ICMS ST
$std->vFCPST = null; //opcional Valor do Fundo de Combate a Pobreza do ICMS ST
$std->vICMSDeson = null; //opcional Valor do ICMS Desonerado
$std->motDesICMS = null; //opcional Motivo da Deseoneração do ICMS
    //3-Uso na agropecuária;
    //9-Outros;
    //12-Fomento agropecuário
$std->pRedBC = null; //opcional Percentual da Redução de Base de Cálculo do ICMS 
$std->vICMSOp = null; //opcional Valor do ICMS da Operação
$std->pDif = null; //opcional Percentual do diferemento
$std->vICMSDif = null; //opcional Valor do ICMS da diferido
$std->vBCSTRet = null; //opcional Valor da BC do ICMS ST retido anteriormente
$std->pST = null; //opcional Aliquota suportada pelo consumidor final
std->vICMSSTRet = null; //opcional Valor do ICMS ST retido anteriormente
$std->vBCFCPSTRet = null; //opcional Valor da Base de cálculo do FCP retido anteriormente por ST
$std->pFCPSTRet = null; //opcional Percentual de FCP retido anteriormente por substituição tributária
$std->vFCPSTRet = null; //opcional Valor do FCP retido por substituição tributária
```

--------------------------------

### tagimposto: Create taxes node

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/Make.md

Creates a DOMElement for the initial taxes node for a product or service in an NFe item. Requires a stdClass with item number and vTotTrib.

```php
$std = new stdClass();
$std->item = 1; //item da NFe
$std->vTotTrib = 1000.00;

$nfe->tagimposto($std);
```

--------------------------------

### tagICMSUFDest PHP Example

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/MakePL010.md

Example of using the tagICMSUFDest method with a stdClass object containing the ICMSUFDest fields. The 'item' field is required and references the NFe item. The 'vBCUFDest' and 'pICMSUFDest' fields are required, while 'vBCFCPUFDest', 'pFCPUFDest', 'vFCPUFDest', and 'vICMSUFDest' are optional. The commented lines show default values for 'pICMSInterPart' (100) and 'vICMSUFRemet' (0).

```php
$ufd = [
    'item' => 1, //OBRIGATÓRIO referencia ao item da NFe
    'vBCUFDest' => 200, //OBRIGATÓRIO Valor da Base de Cálculo do ICMS na UF do destinatário 2 decimais
    'vBCFCPUFDest' => 200, //opcional Valor da Base de Cálculo do FCP na UF do destinatário. 2 decimais
    'pFCPUFDest' => 2, //opcional Percentual adicional inserido na alíquota interna da UF de destino, relativo ao Fundo de Combate à Pobreza (FCP) naquela UF. até 4 decimais
    'pICMSUFDest' => 21.5, //OBRIGATÓRIO Alíquota adotada nas operações internas na UF do destinatário para o produto / mercadoria. até 4 decimais
    'pICMSInter' => 7, //OBRIGATÓRIO Alíquota interestadual das UF envolvidas 4.00 ou 7.00 ou 12.00
    //'pICMSInterPart' => 100, //DEFAULT 100 Percentual de partilha para a UF do destinatário
    'vFCPUFDest' => 3.45, //opcional Valor do ICMS relativo ao Fundo de Combate à Pobreza (FCP) da UF 2 decimais
    'vICMSUFDest' => 34.97, //OBRIGATÓRIO Valor do ICMS de partilha para a UF do destinatário 2 decimais
    //'vICMSUFRemet' => 0 //DEFAULT ZERO Valor do ICMS de partilha para a UF do remetente.
];
$mk->tagICMSUFDest((object)$ufd);
```

--------------------------------

### Open sysctl.conf with nano

Source: https://github.com/nfephp-org/sped-nfe/wiki/Start-Guide

Opens the /etc/sysctl.conf file in the nano editor to adjust kernel parameters.

```bash
nano /etc/sysctl.conf
```

--------------------------------

### function __construct()

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/Make.md

Instantiates the Make class.

```APIDOC
## function __construct()

### Description
Instantiates the Make class.

### Method
__construct

### Parameters
None

### Request Example
```php
$nfe = new Make();
```

### Response
No return value.
```

--------------------------------

### tagCOFINS usage example

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/Make.md

Creates a stdClass with COFINS fields and calls $nfe->tagCOFINS($std).

```php
$std = new stdClass();
$std->item = 1; //item da NFe
$std->CST = '07';
$std->vBC = null;
$std->pCOFINS = null;
$std->vCOFINS = null;
$std->qBCProd = null;
$std->vAliqProd = null;

$nfe->tagCOFINS($std);
```

--------------------------------

### toAuthorize usage example

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/Complements.md

Combines the original request XML with the SEFAZ response to create a valid document. Throws exceptions for invalid XML, mismatched documents, or error responses.

```php
use NFePHP\NFe\Complements;

$req = "<XML conteudo original do documento que quer protocolar>";
$res = "<XML conteudo do retorno com a resposta da SEFAZ>";

try {
    $xml = Complements::toAuthorize($req, $res);
    header('Content-type: text/xml; charset=UTF-8');
    echo $xml;
} catch (\Exception $e) {
    echo "Erro: " . $e->getMessage();
}
```

--------------------------------

### tagPIS usage example

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/Make.md

Creates a stdClass with PIS fields and calls $nfe->tagPIS($std).

```php
$std = new stdClass();
$std->item = 1; //item da NFe
$std->CST = '07';
$std->vBC = null;
$std->pPIS = null;
$std->vPIS = null;
$std->qBCProd = null;
$std->vAliqProd = null;

$nfe->tagPIS($std);
```

--------------------------------

### Exemplo de uso do método sefazInutiliza

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/metodos/Inutilizacao.md

Exemplo completo de como inutilizar uma faixa de números de NF-e usando a classe Tools. Requer certificado digital e configuração JSON. Após a chamada, a resposta pode ser padronizada com Standardize para extrair dados em stdClass, array ou JSON.

```php
use NFePHP\NFe\Tools;
use NFePHP\Common\Certificate;
use NFePHP\NFe\Common\Standardize;
use NFePHP\NFe\Complements;

try {

    $certificate = Certificate::readPfx($content, 'senha');
    $tools = new Tools($configJson, $certificate);

    $nSerie = '1';
    $nIni = '116698';
    $nFin = '116700';
    $xJust = 'Erro de digitação dos números sequencias das notas'
    $response = $tools->sefazInutiliza($nSerie, $nIni, $nFin, $xJust);

    //você pode padronizar os dados de retorno atraves da classe abaixo
    //de forma a facilitar a extração dos dados do XML
    //NOTA: mas lembre-se que esse XML muitas vezes será necessário, 
    //      quando houver a necessidade de protocolos
    $stdCl = new Standardize($response);
    //nesse caso $std irá conter uma representação em stdClass do XML
    $std = $stdCl->toStd();
    //nesse caso o $arr irá conter uma representação em array do XML
    $arr = $stdCl->toArray();
    //nesse caso o $json irá conter uma representação em JSON do XML
    $json = $stdCl->toJson();
    
} catch (\Exception $e) {
    echo $e->getMessage();
}
```

--------------------------------

### taggPagAntecipado usage example

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/MakePL010.md

Creates a stdClass with refNFe array and calls taggPagAntecipado. Only used when schema is PL_010.

```php
$std = ['refNFe' => [
            '12345678901234567890123456789012345678901234',
            '23456789012345678901234567890123456789012345',
            '34567890123456789012345678901234567890123456'
       ]
    ];
$mk->taggPagAntecipado((object)$std);
```

--------------------------------

### Exemplo de uso do método sefazConsultaChave

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/metodos/ConsultaChave.md

Exemplo completo de consulta de NF-e pela chave usando NFePHP. Requer certificado digital, configuração JSON e a chave de acesso. A resposta pode ser padronizada em stdClass, array ou JSON com a classe Standardize.

```php
use NFePHP\NFe\Tools;
use NFePHP\Common\Certificate;
use NFePHP\NFe\Common\Standardize;

try {

    $certificate = Certificate::readPfx($content, 'senha');
    $tools = new Tools($configJson, $certificate);
    $tools->model('55');

    $chave = '52170522555994000145550010000009651275106690';
    $response = $tools->sefazConsultaChave($chave);

    //você pode padronizar os dados de retorno atraves da classe abaixo
    //de forma a facilitar a extração dos dados do XML
    //NOTA: mas lembre-se que esse XML muitas vezes será necessário, 
    //      quando houver a necessidade de protocolos
    $stdCl = new Standardize($response);
    //nesse caso $std irá conter uma representação em stdClass do XML
    $std = $stdCl->toStd();
    //nesse caso o $arr irá conter uma representação em array do XML
    $arr = $stdCl->toArray();
    //nesse caso o $json irá conter uma representação em JSON do XML
    $json = $stdCl->toJson();

} catch (\Exception $e) {
    echo $e->getMessage();
}
```

--------------------------------

### tagII usage example

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/Make.md

Creates a stdClass with import tax fields and calls $nfe->tagII($std).

```php
$std = new stdClass();
$std->item = 1; //item da NFe
$std->vBC = 1000.00;
$std->vDespAdu = 100.00;
$std->vII = 220.00;
$std->vIOF = null;

$nfe->tagII($std);
```

--------------------------------

### tagICMSUFDest usage example

Source: https://github.com/nfephp-org/sped-nfe/blob/master/docs/Make.md

Creates a stdClass with ICMS interestadual fields and calls $nfe->tagICMSUFDest($std).

```php
$std = new stdClass();
$std->item = 1; //item da NFe
$std->vBCUFDest = 100.00;
$std->vBCFCPUFDest = 100.00;
$std->pFCPUFDest = 1.00;
$std->pICMSUFDest = 18.00;
$std->pICMSInter = 12.00;
$std->pICMSInterPart = 80.00;
$std->vFCPUFDest = 1.00;
$std->vICMSUFDest = 14.44;
$std->vICMSUFRemet = 3.56;

$nfe->tagICMSUFDest($std);
```
Tokens:
Raw