SPED DA

https://github.com/nfephp-org/sped-da
Admin
SPED DA provides PHP classes for generating auxiliary documents (DANFE, DACTE, DAMDFE) used in...
Tokens:76,379
Snippets:509
Trust Score:7.8
Update:1 month ago
Show doc for...
Tokens:
Raw
### Install sped-da with Composer

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

Install the sped-da library via Composer. Requires PHP >= 7.4 and the extensions ext-dom, ext-gd, and ext-mbstring.

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

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

### Instantiate DanfeVarejo

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-varejo.md

Example of creating a DanfeVarejo instance with raw XML.

```php
use NFePHP\DA\NFe\DanfeVarejo;

$danfe = new DanfeVarejo($xml);
```

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

### Render and save to file

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-varejo.md

Example of rendering the DANFE and saving it to a file, with error handling.

```php
try {
    $danfe = new DanfeVarejo($xml);
    $danfe->setMargins(1);
    $pdf = $danfe->render();
    file_put_contents('danfe-varejo.pdf', $pdf);
} catch (\Exception $e) {
    error_log($e->getMessage());
}
```

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

### Full usage example with render

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-etiqueta.md

Shows a complete workflow: instantiate DanfeEtiqueta, set paper size, margins, email, render the PDF, and save it to a file.

```php
use NFePHP\DA\NFe\DanfeEtiqueta;

$etiqueta = new DanfeEtiqueta($xml);
$etiqueta->setPaperWidth(100);
$etiqueta->setPaperLength(150);
$etiqueta->setMargins(1);
$etiqueta->setEmitEmail('contato@empresa.com.br');
$pdf = $etiqueta->render($logo);
file_put_contents('etiqueta.pdf', $pdf);
```

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

### Set logo with file path and grayscale

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-common.md

Usage example for logoParameters with a file path, right alignment, and grayscale conversion enabled.

```php
$danfe->logoParameters(realpath('/path/to/logo.jpg'), 'R', true); // grayscale, right aligned
```

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

### Instantiate DanfeSimples with landscape orientation

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-simples.md

Example of instantiating DanfeSimples with landscape orientation. Requires the XML content of an NF-e model 55.

```php
use NFePHP\DA\NFe\DanfeSimples;

$danfe = new DanfeSimples($xml, 'L');
```

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

### Instantiate Daevento with emitter data

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/daevento-nfe.md

Example of instantiating Daevento with a sample $dadosEmitente array. The array keys are used by the renderer; note that 'CNPJ' is overwritten from the XML infEvento.

```php
use NFePHP\DA\NFe\Daevento;

$dadosEmitente = [
    'razao' => 'QQ Comercio e Ind. Ltda',
    'logradouro' => 'Rua vinte e um de março',
    'numero' => '200',
    'complemento' => 'sobreloja',
    'bairro' => 'Nova Onda',
    'CEP' => '99999-999',
    'municipio' => 'Onda',
    'UF' => 'MG',
    'telefone' => '33333-3333',
    'email' => 'qq@gmail.com'
];

$daevento = new Daevento($xml, $dadosEmitente);
```

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

### Render and output event PDF

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/daevento-nfe.md

Example of rendering the event PDF and outputting it directly to the browser. It sets a footer, print parameters, logo parameters, then renders and sends the PDF with the appropriate content type.

```php
$daevento = new Daevento($xml, $dadosEmitente);
$daevento->creditsIntegratorFooter('WEBNFe Sistemas - http://www.webenf.com.br');
$daevento->printParameters('P', 'A4');
$daevento->logoParameters($logo, 'R');
$pdf = $daevento->render();
header('Content-Type: application/pdf');
echo $pdf;
```

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

### Enable debug mode

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/daevento-nfe.md

Example call to enable debug mode on a Daevento instance. This turns on error reporting and display_errors.

```php
$daevento->debugMode(true);
```

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

### Usage example with DaInterface type hint

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-interface.md

Shows how to type-hint a function parameter against DaInterface and call render(). Any implementing class (Danfe, Dacte, Damdfe, Dabpe, Danfse) can be passed, and the function returns the raw PDF bytes as a string.

```php
use NFePHP\DA\NFe\Danfe;

function emitPdf(DaInterface $da): string
{
    $da->creditsIntegratorFooter('Meu Software - https://example.com');
    return $da->render();
}

$pdf = emitPdf(new Danfe($xml));
```

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

### setEmitEmail usage example

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-etiqueta.md

Sets the email to 'contato@empresa.com.br' on an existing DanfeEtiqueta instance.

```php
$etiqueta->setEmitEmail('contato@empresa.com.br');
```

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

### Render DACTE PDF to browser

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/dacte.md

Full rendering example: configures debug mode, footer credits, default font, print parameters, logo, decimal places, then renders and outputs the PDF directly to the browser.

```php
use NFePHP\DA\CTe\Dacte;

$da = new Dacte($xml);
$da->debugMode(true);
$da->creditsIntegratorFooter('WEBNFe Sistemas - http://www.webenf.com.br');
$da->setDefaultFont('times');
$da->printParameters('P', 'A4');
$da->logoParameters($logo, 'C', false);
$da->setDefaultDecimalPlaces(2);

$pdf = $da->render();
header('Content-Type: application/pdf');
echo $pdf;
```

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

### Render and save event PDF to file

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/daevento-nfe.md

Example of rendering the event PDF and saving it to a file, with exception handling. The render method may throw exceptions from the underlying PDF library.

```php
try {
    $daevento = new Daevento($xml, $dadosEmitente);
    $pdf = $daevento->render($logo);
    file_put_contents('evento.pdf', $pdf);
} catch (\Exception $e) {
    error_log('Evento: ' . $e->getMessage());
}
```

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

### setPaperWidth usage example

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-etiqueta.md

Sets the paper width to 100 mm on an existing DanfeEtiqueta instance.

```php
$etiqueta->setPaperWidth(100);
```

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

### Set logo with data URL and center alignment

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-common.md

Usage example for logoParameters with a base64 data URL, centered alignment, and no grayscale conversion.

```php
$logo = 'data://text/plain;base64,' . base64_encode(file_get_contents('logo.png'));
$danfe->logoParameters($logo, 'C', false);
```

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

### Set landscape legal print parameters

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-common.md

Usage example for printParameters with landscape legal-size paper and asymmetric margins (top 3mm, left 2mm).

```php
// Landscape legal-size printing, asymmetric margins
$danfe->printParameters('L', 'LEGAL', 3, 2);
```

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

### Set decimal places to 4

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-common.md

Example call that sets the decimal places to 4.

```php
$danfe->setDefaultDecimalPlaces(4);
```

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

### Set portrait A4 print parameters

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-common.md

Usage example for printParameters with portrait A4 and default margins.

```php
$danfe->printParameters('P', 'A4', 2, 2);
```

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

### Render DACTE PDF to file with landscape and cancel flag

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/dacte.md

Rendering example with landscape orientation, forced cancellation stamp, and saving the PDF to a file. Catches InvalidArgumentException.

```php
try {
    $da = new Dacte($xml);
    $da->printParameters('L', 'A4');   // paisagem (tpImp=2)
    $da->setCancelFlag(true);          // força selo "CTe CANCELADO"
    $pdf = $da->render($logo);
    file_put_contents('dacte.pdf', $pdf);
} catch (InvalidArgumentException $e) {
    echo "Ocorreu um erro durante o processamento :" . $e->getMessage();
}
```

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

### setPaperLength usage example

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-etiqueta.md

Sets the paper length to 150 mm on an existing DanfeEtiqueta instance.

```php
$etiqueta->setPaperLength(150);
```

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

### setMargins usage example

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-etiqueta.md

Sets the margin to 1 mm on an existing DanfeEtiqueta instance.

```php
$etiqueta->setMargins(1);
```

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

### Set DPEC number with depecNumber

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-common.md

Usage example for depecNumber with a sample protocol number.

```php
$danfe->depecNumber('123456789');
```

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

### setFont usage example

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-etiqueta.md

Sets the font to 'arial' on an existing DanfeEtiqueta instance.

```php
$etiqueta->setFont('arial');
```

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

### render($logo) - Get PDF bytes

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-common.md

Lazily builds the PDF if not already populated (e.g., by Damdfe::buildMDFe()) and returns the raw PDF bytes. Use the returned string with file_put_contents() or to send as an HTTP response.

```php
public function render(
    $logo = ''
) {
    if (empty($this->pdf)) {
        $this->monta($logo);
    }
    return $this->pdf->getPdf();
}
```

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

### Set integrator footer message

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-common.md

Example call that sets the integrator message to a website URL.

```php
$danfe->creditsIntegratorFooter('WEBNFe Sistemas - http://www.webenf.com.br');
```

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

### Disable debug mode with debugMode(false)

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-common.md

Usage example for debugMode(false) to disable debug mode, which is required in production.

```php
$danfe->debugMode(false); // must be false in production
```

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

### Enable debug mode with debugMode(true) and catch exceptions

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-common.md

Usage example for debugMode(true) inside a try-catch block to rethrow PHP warnings as exceptions and log the error message.

```php
try {
    $danfe->debugMode(true); // rethrows PHP warnings as exceptions
    $pdf = $danfe->render();
} catch (\Exception $e) {
    error_log($e->getMessage());
}
```

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

### Constructor: __construct($xml, $dadosEmitente)

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/daevento-nfe.md

Initializes the Daevento instance with the event XML and emitter address data. It loads the XML and sets up debug mode.

```APIDOC
## Constructor: __construct($xml, $dadosEmitente)

### Description
Initializes the Daevento instance with the event XML and emitter address data. It loads the XML and sets up debug mode.

### Method
Constructor

### Parameters
- **$xml** (string) - Required - `procEventoNFe` XML content (file path or string)
- **$dadosEmitente** (array) - Required - Emitter address data. Keys used: `razao`, `logradouro`, `numero`, `complemento`, `bairro`, `CEP`, `municipio`, `UF`, `telefone`, `email`. The `CNPJ` key is overwritten from the XML `infEvento`.

### Request Example
```php
use NFePHP\DA\NFe\Daevento;

$dadosEmitente = [
    'razao' => 'QQ Comercio e Ind. Ltda',
    'logradouro' => 'Rua vinte e um de março',
    'numero' => '200',
    'complemento' => 'sobreloja',
    'bairro' => 'Nova Onda',
    'CEP' => '99999-999',
    'municipio' => 'Onda',
    'UF' => 'MG',
    'telefone' => '33333-3333',
    'email' => 'qq@gmail.com'
];

$daevento = new Daevento($xml, $dadosEmitente);
```

### Response
#### Success Response
Returns a new Daevento instance.

#### Error Handling
If the XML is invalid or cannot be loaded, an exception may be thrown. Wrap in try-catch to handle errors.

```php
try {
    $daevento = new Daevento($xml, $dadosEmitente);
} catch (\Exception $e) {
    error_log($e->getMessage());
}
```
```

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

### Render DANFE with configuration options

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe.md

Creates a Danfe instance, sets various display and printing parameters, renders the PDF, and outputs it directly to the browser with the appropriate content type.

```php
use NFePHP\DA\NFe\Danfe;

$danfe = new Danfe($xml);
$danfe->exibirTextoFatura = false;
$danfe->exibirPIS = true;
$danfe->printParameters('P', 'A4', 2, 2);
$danfe->logoParameters($logo, 'C', false);
$danfe->setDefaultFont('times');
$danfe->setDefaultDecimalPlaces(4);
$danfe->debugMode(false);
$danfe->creditsIntegratorFooter('WEBNFe Sistemas - http://www.webenf.com.br');

$pdf = $danfe->render($logo);
header('Content-Type: application/pdf');
echo $pdf;
```

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

### Set default font to arial

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-common.md

Example call that sets the default font to 'arial' (normalized to 'helvetica').

```php
$danfce->setDefaultFont('arial');
```

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

### render($logo = null): string

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/daevento-nfe.md

Generates and returns the PDF content as a string. Lazily builds the PDF if not already generated.

```APIDOC
## render($logo = null): string

### Description
Generates and returns the PDF content as a string. Lazily builds the PDF if not already generated.

### Method
render

### Parameters
- **$logo** (string|null) - Optional - Logo path or base64 data URL. Defaults to null.

### Request Example
```php
$daevento = new Daevento($xml, $dadosEmitente);
$daevento->creditsIntegratorFooter('WEBNFe Sistemas - http://www.webenf.com.br');
$daevento->printParameters('P', 'A4');
$daevento->logoParameters($logo, 'R');
$pdf = $daevento->render();
header('Content-Type: application/pdf');
echo $pdf;
```

### Response
#### Success Response
Returns `string` - the raw PDF content.

#### Error Handling
If an exception occurs during PDF generation, it may be thrown. Wrap in try-catch to handle errors.

```php
try {
    $daevento = new Daevento($xml, $dadosEmitente);
    $pdf = $daevento->render($logo);
    file_put_contents('evento.pdf', $pdf);
} catch (\Exception $e) {
    error_log('Evento: ' . $e->getMessage());
}
```
```

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

### Force cancellation stamp

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-common.md

Example call that sets the cancellation flag to true, forcing the 'NFe CANCELADA' stamp.

```php
$danfe->setCancelFlag(true); // forza a impressão do selo "NFe CANCELADA"
```

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

### Render and output PDF

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-simples.md

Renders the DANFE and outputs it as a PDF to the browser. Sets print parameters, adds a credits footer, and sends the PDF content with the appropriate header.

```php
use NFePHP\DA\NFe\DanfeSimples;

$danfe = new DanfeSimples($xml, 'P');
$danfe->printParameters('P', 'A4', 2, 2);
$danfe->creditsIntegratorFooter('Minha Empresa - https://example.com');
$pdf = $danfe->render($logo);
header('Content-Type: application/pdf');
echo $pdf;
```

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

### Render and save PDF to file

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-simples.md

Reads an NF-e XML file, renders the DANFE in landscape, and saves the PDF to disk. Errors are logged to the error log.

```php
try {
    $danfe = new DanfeSimples(file_get_contents('mod55-nfe.xml'), 'L');
    $pdf = $danfe->render();
    file_put_contents('danfe-simples.pdf', $pdf);
} catch (\Exception $e) {
    error_log($e->getMessage());
}
```

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

### monta()

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-interface.md

Builds (mounts) the document layout. Implemented as protected in DaCommon and every subclass.

```APIDOC
## monta()

### Description
Builds (mounts) the document layout. Implemented as protected in DaCommon and every subclass.

### Method
monta

### Parameters
None

### Returns
void
```

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

### Daevento render method

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/daevento-nfe.md

Implementation of render() for Daevento. It lazily builds the PDF via monta() if not already built, then returns the raw PDF string. The $logo parameter can be a path or base64 data URL.

```php
public function render($logo = null)
{
    if (empty($this->pdf)) {
        $this->monta($logo);
    }
    return $this->pdf->getPdf();
}
```

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

### Enable print resume

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfce.md

Enables resume printing with a comment.

```php
$danfce->setPrintResume(true); // impressão apenas do resumo
```

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

### Instantiate Daevento with exception handling

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/daevento-nfe.md

Shows wrapping the Daevento constructor in a try-catch to handle exceptions. Note that unsupported event types do not throw; they set an error message and render anyway.

```php
try {
    $daevento = new Daevento($xml, $dadosEmitente);
} catch (\Exception $e) {
    error_log($e->getMessage());
}
```

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

### Catch constructor exceptions

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-simples.md

Shows how to catch exceptions thrown by the constructor, such as "Isso não é um NFe." or "O xml deve ser NF-e modelo 55."

```php
try {
    $danfe = new DanfeSimples($xml, 'P');
} catch (\Exception $e) {
    echo $e->getMessage();
}
```

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

### Render DANFE with error handling and save to file

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe.md

Creates a Danfe instance, sets additional options, renders the PDF, and saves it to a file. Catches exceptions and logs an error message.

```php
try {
    $danfe = new Danfe($xml);
    $danfe->setOcultarUnidadeTributavel(true);
    $danfe->obsContShow(false);
    $danfe->setGerarInformacoesAutomaticas(true);   // contigência/compra info
    $pdf = $danfe->render();
    file_put_contents('danfe.pdf', $pdf);
} catch (\Exception $e) {
    error_log('Falha ao gerar DANFE: ' . $e->getMessage());
}
```

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

### printParameters($orientacao = '', $papel = 'A4', $margSup = 2, $margEsq = 2): void

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-common.md

Method to configure printing parameters like orientation, paper size, and margins.

```APIDOC
## printParameters($orientacao = '', $papel = 'A4', $margSup = 2, $margEsq = 2): void

### Description
Sets printing parameters such as orientation, paper size, and margins. It updates internal dimensions for the printable area.

### Method
N/A (PHP method)

### Endpoint
N/A (PHP method)

### Parameters
- **$orientacao** (string) - Optional - `'P'` (portrait) or `'L'` (landscape). Any other value leaves the current orientation untouched.
- **$papel** (string) - Optional - `'A4'` (210×297 mm) or `'LEGAL'` (216×355 mm); case-insensitive.
- **$margSup** (int) - Optional - Top margin in mm (also used for bottom margin: `$this->marginf = $margSup`; a `null` value falls back to 2).
- **$margEsq** (int) - Optional - Left margin in mm (also used as right margin). `null` falls back to 2.

### Returns
- **void** - Sets `maxW`/`maxH` (495×297 or 216×355 mm, swapped for landscape), `wPrint = maxW - margesq*2`, `hPrint = maxH - margsup - 5`.

### Request Example
```php
$danfe->printParameters('P', 'A4', 2, 2);
```

```php
// Landscape legal-size printing, asymmetric margins
$danfe->printParameters('L', 'LEGAL', 3, 2);
```
```

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

### logoParameters($logo, $logoAlign = null, $mode_bw = false): void

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-common.md

Method to set the logo image, alignment, and optional grayscale conversion.

```APIDOC
## logoParameters($logo, $logoAlign = null, $mode_bw = false): void

### Description
Sets the logo to be printed on the document. Accepts a file path, a data URL, or a base64-encoded image. Optionally aligns the logo and converts it to grayscale.

### Method
N/A (PHP method)

### Endpoint
N/A (PHP method)

### Parameters
- **$logo** (string) - Required - Path to an image file, or a `data://text/plain;base64,...` data URL, or a base64-encoded JPG/PNG data URL produced by `adjustImage()`.
- **$logoAlign** (string) - Optional - `'C'` (center), `'L'`, `'R'`; only applied when non-empty.
- **$mode_bw** (bool) - Optional - When `true`, converts PNG/JPG logos to grayscale before embedding.

### Returns
- **void**

### Throws
- **\Exception** - "O formato da imagem não é aceitável! Somente PNG ou JPG podem ser usados." when the image type is neither JPG nor PNG.

### Request Example
```php
$logo = 'data://text/plain;base64,' . base64_encode(file_get_contents('logo.png'));
$danfe->logoParameters($logo, 'C', false);
```

```php
$danfe->logoParameters(realpath('/path/to/logo.jpg'), 'R', true); // grayscale, right aligned
```
```

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

### Danfce constructor implementation

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfce.md

Constructor that accepts raw NFC-e XML, throws an exception if empty, and loads XML data. Throws 'Um xml de NFCe deve ser passado ao construtor da classe.' for empty XML and 'O xml do DANFE deve ser uma NFC-e modelo 65' for invalid model.

```php
public function __construct($xml)
{
    $this->xml = $xml;
    if (empty($xml)) {
        throw new \Exception('Um xml de NFCe deve ser passado ao construtor da classe.');
    }
    //carrega dados do xml
    $this->loadXml();
}
```

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

### Daevento constructor

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/daevento-nfe.md

Constructor for Daevento. Accepts the procEventoNFe XML (as string or directory) and an array with emitter address data. It stores the emitter data, activates debug mode by default, and loads the XML document.

```php
/**
 * @param string $xml Arquivo XML (diretório ou string)
 * @param array $dadosEmitente Dados do endereço do emitente
 */
public function __construct($xml, $dadosEmitente)
{
    $this->dadosEmitente = $dadosEmitente;
    $this->debugMode();
    $this->loadDoc($xml);
}
```

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

### render()

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-interface.md

Renders the document and returns the raw PDF bytes as a string.

```APIDOC
## render()

### Description
Renders the document and returns the raw PDF bytes as a string.

### Method
render

### Parameters
None

### Returns
string - The raw PDF bytes.
```

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

### Instantiate Dacte with error handling

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/dacte.md

Instantiation with exception handling. Catches the two documented exceptions: "Isso não é um CT-e." and "O xml deve ser CT-e modelo 57."

```php
try {
    $da = new Dacte($xml);
} catch (\Exception $e) {
    // "Isso não é um CT-e."
    // "O xml deve ser CT-e modelo 57."
    echo $e->getMessage();
}
```

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

### setMostrarProdutos method

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-varejo.md

Controls whether the product table block is shown. When false, the block is skipped. Returns void.

```php
public function setMostrarProdutos($mostrarProdutos = true)
{
    $this->mostrarProdutos = $mostrarProdutos;
}
```

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

### Set extra content

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfce.md

Sets extra promotional text.

```php
$danfce->setExtraContent('Promoção válida até 30/11');
```

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

### Save Danfce PDF to file with error handling

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfce.md

Creates a Danfce instance, sets paper width and extra content, renders the PDF, and saves it to 'danfce.pdf'. Catches exceptions and logs the error message.

```php
try {
    $danfce = new Danfce($xml);
    $danfce->setPaperWidth(80);
    $danfce->setExtraContent('Impresso pelo caixa 03');
    $pdf = $danfce->render();
    file_put_contents('danfce.pdf', $pdf);
} catch (\Exception $e) {
    error_log('NFC-e: ' . $e->getMessage());
}
```

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

### Handle setPaperWidth exception

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfce.md

Attempts to set paper width to 50 mm, catching the exception and printing the error message.

```php
try {
    $danfce->setPaperWidth(50); // min. is 58mm
} catch (Exception $e) {
    echo $e->getMessage(); // "Largura insuficiente para a impressão do documento"
}
```

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

### Instantiate DanfeEtiqueta with XML

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-etiqueta.md

Creates a new DanfeEtiqueta instance by passing the NF-e XML. This is the basic usage for generating a shipping-label DANFE.

```php
use NFePHP\DA\NFe\DanfeEtiqueta;

$etiqueta = new DanfeEtiqueta($xml);
```

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

### DanfeVarejo constructor

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-varejo.md

Constructor signature for DanfeVarejo. Accepts raw NF-e XML content for model 55. Throws exceptions for invalid XML or wrong model.

```php
public function __construct($xml)
```

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

### render($logo = ''): string

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-etiqueta.md

Renders the DANFE label PDF. Always rebuilds the document, renders blocks bloco1…bloco5 on a page of the configured size, and returns the raw PDF string.

```APIDOC
## render($logo = ''): string

### Description
Renders the DANFE label PDF. Always rebuilds the document, renders blocks bloco1…bloco5 on a page of the configured size, and returns the raw PDF string.

### Method
render

### Parameters
- `$logo` (string) - Optional - Default: '' - Logo (file path or base64 data URL); converted to grayscale

### Returns
string - Raw PDF content

### Example
```php
use NFePHP\DA\NFe\DanfeEtiqueta;

$etiqueta = new DanfeEtiqueta($xml);
$etiqueta->setPaperWidth(100);
$etiqueta->setPaperLength(150);
$etiqueta->setMargins(1);
$etiqueta->setEmitEmail('contato@empresa.com.br');
$pdf = $etiqueta->render($logo);
file_put_contents('etiqueta.pdf', $pdf);
```

```php
try {
    $etiqueta = new DanfeEtiqueta($xml);
    $etiqueta->setPaperWidth(80); // etiqueta menor
    $pdf = $etiqueta->render();
    echo base64_encode($pdf);
} catch (\Exception $e) {
    error_log($e->getMessage());
}
```
```

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

### setViaEstabelecimento implementation

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfce.md

Switches the printed copy label to 'Via Estabelecimento'.

```php
public function setViaEstabelecimento()
{
    $this->via = "Via Estabelecimento";
}
```

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

### Instantiate Danfce with XML

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfce.md

Creates a new Danfce instance using the provided XML document.

```php
use NFePHP\DA\NFe\Danfce;

$danfce = new Danfce($docxml);
```

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

### setPaperWidth implementation

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfce.md

Sets the paper width in mm, throwing an exception if width is less than 58.

```php
public function setPaperWidth($width = 80)
{
    if ($width < 58) {
        throw new Exception("Largura insuficiente para a impressão do documento");
    }
    $this->paperwidth = $width;
}
```

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

### setExtraContent($texto): void

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfce.md

Sets additional free text to be printed at the end of the document.

```APIDOC
## setExtraContent($texto): void

### Description
Sets free text to be printed at the end of the PDF.

### Method
setExtraContent

### Parameters
- **$texto** (string) - Required - Free text printed at the end of the PDF.

### Returns
void

### Example
```php
$danfce->setExtraContent('Promoção válida até 30/11');
```
```

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

### Render with error handling and base64 output

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-etiqueta.md

Shows a try-catch block that creates a DanfeEtiqueta, sets a smaller paper width, renders the PDF, and outputs it as base64. Catches exceptions and logs them.

```php
try {
    $etiqueta = new DanfeEtiqueta($xml);
    $etiqueta->setPaperWidth(80); // etiqueta menor
    $pdf = $etiqueta->render();
    echo base64_encode($pdf);
} catch (\Exception $e) {
    error_log($e->getMessage());
}
```

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

### Instantiate Dacte

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/dacte.md

Basic instantiation of the Dacte class with a CT-e XML string.

```php
use NFePHP\DA\CTe\Dacte;

$da = new Dacte($xml);
```

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

### render method

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-varejo.md

Renders the DANFE PDF. Always rebuilds the document, growing paper length if content overflows. Returns raw PDF string.

```php
public function render($logo = '')
{
    $this->monta($logo);
    return $this->pdf->getPdf();
}
```

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

### Handle constructor exceptions

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfce.md

Wraps Danfce instantiation in a try-catch to handle exceptions for empty XML or invalid model.

```php
try {
    $danfce = new Danfce($raw);
} catch (\Exception $e) {
    // "Um xml de NFCe deve ser passado ao construtor da classe."
    // "O xml do DANFE deve ser uma NFC-e modelo 65"
    echo $e->getMessage();
}
```

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

### setQComCasasDec($qComCasasDec): void

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe.md

Sets decimal places for commercial quantity.

```APIDOC
## setQComCasasDec($qComCasasDec): void

### Description
Sets the number of decimal places for the commercial quantity (`qCom`).

### Method
setQComCasasDec

### Parameters
- **$qComCasasDec** (integer) - Required - Number of decimal places.

### Returns
void

### Example
```php
$danfe->setQComCasasDec(4);
```
```

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

### Stream Danfce PDF to browser

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfce.md

Creates a Danfce instance, configures paper width, margins, font, offline double-print, and footer credits, then renders and outputs the PDF with the appropriate Content-Type header.

```php
use NFePHP\DA\NFe\Danfce;

$danfce = new Danfce($xml);
$danfce->debugMode(false);
$danfce->setPaperWidth(80);
$danfce->setMargins(2);
$danfce->setDefaultFont('arial');
$danfce->setOffLineDoublePrint(true);
$danfce->creditsIntegratorFooter('WEBNFe Sistemas - http://www.webenf.com.br');

$pdf = $danfce->render($logo);
header('Content-Type: application/pdf');
echo $pdf;
```

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

### Instantiate DanfeEtiqueta with try-catch

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-etiqueta.md

Wraps the constructor in a try-catch block to handle exceptions thrown for invalid XML. Catches \Exception and echoes the error message.

```php
try {
    $etiqueta = new DanfeEtiqueta($xml);
} catch (\Exception $e) {
    echo $e->getMessage();
}
```

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

### DanfeVarejo::setMostrarProdutos

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-varejo.md

Sets whether to show product lines in the DANFE.

```APIDOC
## setMostrarProdutos

### Description
Controls whether the product table block is displayed.

### Method
`setMostrarProdutos`

### Signature
`public function setMostrarProdutos($mostrarProdutos = true): void`

### Parameters
- `$mostrarProdutos` (bool) - Optional - Default: true - When false, the product table block is skipped.

### Returns
`void`
```

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

### Constructor: new DanfeEtiqueta($xml)

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-etiqueta.md

Creates a new DanfeEtiqueta instance from raw NF-e XML content (model 55). Throws an exception if the XML is not a valid NF-e or not model 55.

```APIDOC
## Constructor: new DanfeEtiqueta($xml)

### Description
Creates a new DanfeEtiqueta instance from raw NF-e XML content (model 55). Throws an exception if the XML is not a valid NF-e or not model 55.

### Method
Constructor

### Parameters
- `$xml` (string) - Required - Raw NF-e XML content (model 55)

### Throws
- `\Exception` - "Isso não é um NFe." / "O xml deve ser NF-e modelo 55."

### Example
```php
use NFePHP\DA\NFe\DanfeEtiqueta;

$etiqueta = new DanfeEtiqueta($xml);
```

```php
try {
    $etiqueta = new DanfeEtiqueta($xml);
} catch (\Exception $e) {
    echo $e->getMessage();
}
```
```

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

### logoParameters

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-common.md

Method to configure the logo image and its alignment.

```APIDOC
## logoParameters

### Description
Sets the logo image and its alignment on the document. Optionally converts the logo to black and white.

### Method
N/A (PHP method)

### Endpoint
N/A

### Parameters
- **$logo** (string) - Required - Path or data:// URL of the logo image.
- **$logoAlign** (string|null) - Optional - Alignment: 'C' (center), 'L' (left), or 'R' (right). Defaults to 'C'.
- **$mode_bw** (bool) - Optional - If `true`, converts the logo to black and white.

### Returns
- (void)

### Example
```php
$da->logoParameters('/path/to/logo.png', 'C', false);
```
```

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

### Send rendered PDF as HTTP response

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/da-common.md

Checks that the rendered PDF is not empty, throws a RuntimeException on failure, then sends it as an application/pdf HTTP response.

```php
if (empty($pdf = $danfe->render())) {
    throw new RuntimeException('Falha na geração do PDF');
}
header('Content-Type: application/pdf');
echo $pdf;
```

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

### DanfeSimples::__construct

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-simples.md

Constructor for the DanfeSimples class, initializes the object with NF-e XML and orientation.

```APIDOC
## Constructor

### Description
Creates a new DanfeSimples instance, loading the NF-e XML and setting the page orientation.

### Method
Constructor

### Signature
`public function __construct($xml, $orientacao = 'P')`

### Parameters
- **$xml** (string) - Required - Raw NF-e XML content (model 55)
- **$orientacao** (string) - Optional - 'P' portrait or 'L' landscape (default 'P')

### Throws
- \Exception - "Isso não é um NFe." if missing <infNFe>, "O xml deve ser NF-e modelo 55." if mod != 55

### Example
```php
use NFePHP\DA\NFe\DanfeSimples;

$danfe = new DanfeSimples($xml, 'L');
```
```

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

### render()

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe.md

Renders the DANFE PDF document. Inherited from DaCommon, it builds the PDF lazily via the protected monta($logo) method and returns the raw PDF as a string.

```APIDOC
## render()

### Description
Renders the DANFE PDF document. Inherited from `DaCommon`, it builds the PDF lazily via the protected `monta($logo)` method and returns the raw PDF as a string.

### Method
render

### Parameters
- **$logo** (mixed) - Optional - Logo data to be used in the PDF.

### Return Value
- **string** - The raw PDF content.

### Example
```php
use NFePHP\DA\NFe\Danfe;

$danfe = new Danfe($xml);
$danfe->exibirTextoFatura = false;
$danfe->exibirPIS = true;
$danfe->printParameters('P', 'A4', 2, 2);
$danfe->logoParameters($logo, 'C', false);
$danfe->setDefaultFont('times');
$danfe->setDefaultDecimalPlaces(4);
$danfe->debugMode(false);
$danfe->creditsIntegratorFooter('WEBNFe Sistemas - http://www.webenf.com.br');

$pdf = $danfe->render($logo);
header('Content-Type: application/pdf');
echo $pdf;
```
```

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

### Set margins to 2

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfce.md

Sets the margin width to 2 mm.

```php
$danfce->setMargins(2);
```

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

### Danfe constructor definition

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe.md

The constructor takes a string containing the NF-e XML (with or without the nfeProc wrapper). It calls loadDoc() to parse and store DOM nodes. Throws exceptions if the XML is not an NFe or if the model is not 55.

```php
/**
 * @param string $xml Conteúdo XML da NF-e (com ou sem a tag nfeProc)
 */
public function __construct($xml)
{
    $this->loadDoc($xml);
}
```

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

### setEmitEmail($email): void

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-etiqueta.md

Sets the e-mail printed on the label. Returns void.

```APIDOC
## setEmitEmail($email): void

### Description
Sets the e-mail printed on the label. Returns void.

### Method
setEmitEmail

### Parameters
- `$email` (string) - Required - E-mail to print on the label

### Returns
void

### Example
```php
$etiqueta->setEmitEmail('contato@empresa.com.br');
```
```

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

### DanfeVarejo::render

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-varejo.md

Renders the DANFE and returns the PDF as a string.

```APIDOC
## render

### Description
Renders the DANFE document and returns the raw PDF as a string. Always rebuilds the document, growing the paper length if content overflows.

### Method
`render`

### Signature
`public function render($logo = ''): string`

### Parameters
- `$logo` (string) - Optional - Default: '' - Logo image path or data. Converted to grayscale.

### Returns
- `string` - Raw PDF content.

### Example
```php
use NFePHP\DA\NFe\DanfeVarejo;

$danfe = new DanfeVarejo($xml);
$danfe->setPaperWidth(80);
$danfe->setPaperLength(150);
$danfe->setMostrarProdutos(true);
$danfe->setMostrarEndereco(false);
$pdf = $danfe->render($logo);
header('Content-Type: application/pdf');
echo $pdf;
```

```php
try {
    $danfe = new DanfeVarejo($xml);
    $danfe->setMargins(1);
    $pdf = $danfe->render();
    file_put_contents('danfe-varejo.pdf', $pdf);
} catch (\Exception $e) {
    error_log($e->getMessage());
}
```
```

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

### Instantiate Danfe with XML file

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe.md

Creates a Danfe object from the contents of an XML file. The XML must be a valid NF-e model 55.

```php
use NFePHP\DA\NFe\Danfe;

$danfe = new Danfe(file_get_contents('nfe.xml'));
```

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

### Danfce::render()

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfce.md

Documentation for the Danfce::render() method, which generates the PDF for a DANFCE document.

```APIDOC
## `render($logo = ''): string`

### Description
Renders the DANFCE PDF document. Overrides `DaCommon::render()` and always rebuilds the document. The page height is computed dynamically by summing the ten block heights; the last block prints the credits from `creditsIntegratorFooter()`. In homologation environment (`tpAmb == 2`) a gray watermark is stamped.

### Method
`render`

### Signature
`public function render($logo = '')`

### Parameters
- **$logo** (string) - Optional - Default: `''` - Logo (file path or base64 data URL); always converted to grayscale.

### Returns
- **string** - Raw PDF bytes.

### Usage Example
```php
use NFePHP\DA\NFe\Danfce;

$danfce = new Danfce($xml);
$danfce->debugMode(false);
$danfce->setPaperWidth(80);
$danfce->setMargins(2);
$danfce->setDefaultFont('arial');
$danfce->setOffLineDoublePrint(true);
$danfce->creditsIntegratorFooter('WEBNFe Sistemas - http://www.webenf.com.br');

$pdf = $danfce->render($logo);
header('Content-Type: application/pdf');
echo $pdf;
```

### Error Handling Example
```php
try {
    $danfce = new Danfce($xml);
    $danfce->setPaperWidth(80);
    $danfce->setExtraContent('Impresso pelo caixa 03');
    $pdf = $danfce->render();
    file_put_contents('danfce.pdf', $pdf);
} catch (\Exception $e) {
    error_log('NFC-e: ' . $e->getMessage());
}
```
```

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

### Danfce::render() method implementation

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfce.md

Overrides DaCommon::render() and always rebuilds the document. Returns raw PDF bytes as a string. The page height is computed dynamically by summing the ten block heights; set paper width and margins before calling. In homologation mode (tpAmb == 2) a gray 'SEM VALOR FISCAL\nEmitida em ambiente de homologacao' watermark is stamped.

```php
public function render($logo = '')
{
    $this->monta($logo);
    //$this->papel = 80;
    return $this->pdf->getPdf();
}
```

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

### Constructor

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfce.md

Constructor for the Danfce class that accepts raw NFC-e XML and validates it.

```APIDOC
## Constructor

### Description
Creates a Danfce instance from raw NFC-e XML content. The XML must be a NFC-e model 65.

### Method
Constructor

### Parameters
- **$xml** (string) - Required - Raw NFC-e XML content; `<ide><mod>` must be `65`.

### Throws
- `\Exception` - `"Um xml de NFCe deve ser passado ao construtor da classe."` if XML is empty.
- `\Exception` - `"O xml do DANFE deve ser uma NFC-e modelo 65"` if `mod != 65`.

### Example
```php
use NFePHP\DA\NFe\Danfce;

$danfce = new Danfce($docxml);
```
```

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

### setTitle($title): void

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe.md

Sets the PDF metadata title.

```APIDOC
## setTitle($title): void

### Description
Sets the PDF metadata title (property `$title` is inherited from `NFePHP\DA\Legacy\FPDF\Fpdf`).

### Method
setTitle

### Parameters
- **$title** (string) - Required - The title to set.

### Returns
void

### Example
```php
$danfe->setTitle('DANFE 1234');
```
```

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

### DanfeSimples constructor

Source: https://github.com/nfephp-org/sped-da/blob/master/_autodocs/api-reference/danfe-simples.md

Constructor implementation for DanfeSimples. It loads the XML document and sets the orientation. The orientation defaults to 'P' (portrait) and can be 'L' (landscape).

```php
/**
 * __construct
 *
 * @name  __construct
 *
 * @param string $xml Conteúdo XML da NF-e (com ou sem a tag nfeProc)
 */
public function __construct($xml, $orientacao = 'P')
{
    $this->loadDoc($xml);
    $this->orientacao = $orientacao;
}
```
Tokens:
Raw