Emisor Model Reference: Invoice Issuer in verifactuPHP

The Emisor model represents the legal entity that issues invoices in the VeriFactu system. Every RegistroAlta and RegistroAnulacion is linked to an Emisor, which supplies the issuer’s NIF and legal name automatically. You can construct an Emisor directly or retrieve a pre-configured one through the ClienteVerifactu factory.

Construction

Pass a keyed array of property names to the constructor, or use the ClienteVerifactu factory method when working within the full client context:

use verifactuPHP\Models\Emisor;

$emisor = new Emisor([
    'nif'                      => 'B12345678',
    'nombre'                   => 'Mi Empresa S.L.',
    'representanteRazonSocial' => 'Juan García López',
    'representanteNif'         => '12345678A',
    'webhookID'                => 42,
    'enviarAeat'               => true,
    'enviarAeatPaused'         => false,
]);

nif and nombre are the two fields consumed by RegistroAlta to populate IDEmisorFactura and NombreRazonEmisor automatically. Always supply them when the Emisor will be attached to an invoice record.

Fields

nif

string

required

Tax identification number (NIF) of the issuing entity. Maps to API field nif. This value is automatically copied into the IDEmisorFactura field of every RegistroAlta that references this Emisor.

nombre

string

required

Legal company name or business name (razón social) of the issuer. Maps to API field nombre. Automatically propagated to NombreRazonEmisor in RegistroAlta.

Legal name of the issuer’s authorised representative. Maps to API field representante_razon_social. Only required when the invoice is signed by a representative rather than the issuer directly.

representanteNif

string

NIF of the issuer’s authorised representative. Maps to API field representante_nif.

webhookID

int

Default webhook ID used for AEAT submission notifications. Maps to API field default_webhook_id. This value is used as the fallback webhook_id in any RegistroAlta that does not specify its own webhook.

enviarAeat

bool

Whether invoices belonging to this issuer should be submitted to AEAT automatically. Maps to API field enviar_aeat. Defaults to false when omitted.

enviarAeatPaused

bool

Whether automatic AEAT submission is currently paused for this issuer. Maps to API field enviar_aeat_paused. Defaults to false when omitted.

Getters and Setters

Each field exposes a matching getter and setter:

Method	Description
`getNif(): string`	Returns the issuer’s NIF.
`setNif(string $v): void`	Sets the issuer’s NIF.
`getNombre(): string`	Returns the legal company name.
`setNombre(string $v): void`	Sets the legal company name.
`getRepresentanteRazonSocial(): string`	Returns the representative’s legal name.
`setRepresentanteRazonSocial(string $v): void`	Sets the representative’s legal name.
`getRepresentanteNif(): string`	Returns the representative’s NIF.
`setRepresentanteNif(string $v): void`	Sets the representative’s NIF.
`getWebhookID(): int`	Returns the default webhook ID.
`setWebhookID(int $v): void`	Sets the default webhook ID.
`getEnviarAeat(): bool`	Returns the AEAT auto-submission flag.
`setEnviarAeat(bool $v): void`	Sets the AEAT auto-submission flag.
`getEnviarAeatPaused(): bool`	Returns the AEAT paused flag.
`setEnviarAeatPaused(bool $v): void`	Sets the AEAT paused flag.

getArrayData()

getArrayData(): array serialises the model into the API-ready format. Only fields that are non-empty (non-empty string, non-zero integer, or true boolean) are included in the output — omitted fields are not sent to the API. PHP property names differ from the API field names used in the payload:

PHP property	API field key
`nif`	`nif`
`nombre`	`nombre`
`representanteRazonSocial`	`representante_razon_social`
`representanteNif`	`representante_nif`
`webhookID`	`default_webhook_id`
`enviarAeat`	`enviar_aeat`
`enviarAeatPaused`	`enviar_aeat_paused`

$payload = $emisor->getArrayData();
// Example output:
// [
//     'nif'    => 'B12345678',
//     'nombre' => 'Mi Empresa S.L.',
//     'enviar_aeat' => true,
// ]

empty()

Emisor::empty(): Emisor is a static factory that returns an Emisor instance with all fields set to their zero values ('', 0, false). It is used internally by RegistroAlta::empty() and RegistroAnulacion::empty() as a safe placeholder when no real issuer is required.

$placeholder = Emisor::empty();

Use Emisor::empty() in unit tests or as a default value when constructing other model stubs, rather than passing null or an uninitialised array.

Client

Models

Documentation Index

​Construction

​Fields

​Getters and Setters

​getArrayData()

​empty()

Build docs developers (and LLMs) love

Construction

Fields

Getters and Setters

getArrayData()

empty()