Create and Submit RegistroAlta Invoice Records to AEAT

The RegistroAlta is the core invoice submission record in VeriFactu. It combines a set of object dependencies — such as an emisor, a destinatario, and a desglose — with a set of data fields that describe the invoice itself. Once built, you submit the record to VeriFactuAPI with altaRegistroAlta(), which POSTs it to the /api/alta-registro-facturacion endpoint for processing and, if enviarAeat is enabled on the emisor, onward submission to AEAT.

Build and Submit a RegistroAlta

The nuevoRegistroAlta() method accepts two required arrays and one optional integer:

$objetos — an associative array of model objects (emisor, destinatario, desglose, tercero, facturaRectificada, facturaSustituida). Only emisor is required; the rest default to empty objects.
$dataRegistroAlta — an associative array of invoice data fields.
$webhookID (optional) — an integer webhook ID. If omitted or 0, the emisor’s own webhookID is used automatically.

The examples below show the three most common invoice types. Each builds on the same emisor and desglose for brevity.

Standard Invoice (F1)
Simplified Invoice (F2)
Rectified Invoice (R5)

A standard invoice (F1) requires an emisor, a destinatario, and a desglose. The IDEmisorFactura and NombreRazonEmisor fields are automatically populated from the $emisor object.

$emisor = $client->nuevoEmisor([
    'nif'        => 'A39200019',
    'nombre'     => 'Mi Empresa S.L.',
    'enviarAeat' => true,
]);

$destinatario = $client->nuevoDestinatario([
    'nombreRazon' => 'Cliente S.A.',
    'nif'         => '39707287H',
]);

$desglose = $client->nuevoDesglose([
    'impuesto'                     => '01',
    'claveRegimen'                 => 1,
    'tipoImpositivo'               => 21,
    'baseImponibleOImporteNoSujeto' => 100,
    'cuotaRepercutida'             => 21,
]);

$registroAlta = $client->nuevoRegistroAlta(
    [
        'emisor'       => $emisor,
        'destinatario' => $destinatario,
        'desglose'     => $desglose,
    ],
    [
        'numSerieFactura'        => 'AX/202412-118',
        'fechaExpedicionFactura' => '2024-12-16',
        'tipoFactura'            => 'F1',
        'cuotaTotal'             => 21.0,
        'importeTotal'           => 121.0,
    ]
);

$client->altaRegistroAlta($registroAlta);

A simplified invoice (F2) does not require a destinatario. Set facturaSinIdentifDestinatarioArt61d to 'S' to indicate that the buyer’s identity is not recorded, as permitted under Article 61d.

$registroAltaSimple = $client->nuevoRegistroAlta(
    [
        'emisor'   => $emisor,
        'desglose' => $desglose,
    ],
    [
        'numSerieFactura'                     => 'AX/202412-119',
        'fechaExpedicionFactura'              => '2024-12-16',
        'tipoFactura'                         => 'F2',
        'facturaSinIdentifDestinatarioArt61d' => 'S',
        'cuotaTotal'                          => 21.0,
        'importeTotal'                        => 121.0,
    ]
);

$client->altaRegistroAlta($registroAltaSimple);

A rectified invoice (R5) references the original invoice it corrects via a FacturaRectificada object. Use the getter methods on the original RegistroAlta to populate the reference fields accurately.

$facturaRectificada = $client->nuevaFacturaRectificada([
    'IDEmisorFactura'        => $registroAltaSimple->getIDEmisorFactuara(),
    'numSerieFactura'        => $registroAltaSimple->getNumSerieFactura(),
    'fechaExpedicionFactura' => $registroAltaSimple->getFechaExpedicionFactura(),
]);

$registroAltaRectificativa = $client->nuevoRegistroAlta(
    [
        'emisor'             => $emisor,
        'desglose'           => $desglose,
        'facturaRectificada' => $facturaRectificada,
    ],
    [
        'numSerieFactura'        => 'AX/202412-120',
        'fechaExpedicionFactura' => '2024-12-16',
        'tipoFactura'            => 'R5',
        'tipoRectificativa'      => 2,
        'cuotaTotal'             => 21.0,
        'importeTotal'           => 121.0,
    ]
);

$client->altaRegistroAlta($registroAltaRectificativa);

RegistroAlta Data Fields Reference

The second argument to nuevoRegistroAlta() accepts the following fields. All fields are optional at the object-construction level, but VeriFactuAPI may require certain fields depending on the invoice type.

Field	Type	Description
`numSerieFactura`	string	Invoice series and number (e.g. `AX/202412-118`)
`fechaExpedicionFactura`	string	Invoice issue date in `YYYY-MM-DD` format
`refExterna`	string	Your own external reference string for this record
`tipoFactura`	int\|string	Invoice type (list L2): `F1` = standard, `F2` = simplified, `R1`–`R5` = rectified
`tipoRectificativa`	int\|string	Rectification type (list L3); required when `tipoFactura` is a rectificative type
`baseRectificada`	float	Rectified taxable base amount
`cuotaRectificada`	float	Rectified tax quota amount
`cuotaRecargoRectificado`	float	Rectified surcharge quota amount
`fechaOperacion`	string	Date of the actual operation if different from the issue date (`YYYY-MM-DD`)
`descripcionOperacion`	string	Free-text description of the operation
`facturaSimplificadaArt7273`	int\|string	Simplified invoice under Art. 72/73 flag (list L4)
`facturaSinIdentifDestinatarioArt61d`	int\|string	Invoice without buyer identification under Art. 61d (list L5); use `'S'` for simplified invoices with no destinatario
`macrodato`	int\|string	Large-amount transaction flag (list L14)
`emitidaPorTercODestinatario`	int\|string	Issued by third party or buyer flag (list L6)
`cupon`	int\|string	Coupon flag (list L4)
`subsanacion`	int\|string	Amendment of a previously rejected record (list L4)
`rechazoPrevio`	int\|string	Prior rejection reference (list L17)
`cuotaTotal`	float	Total tax quota for the invoice
`importeTotal`	float	Total invoice amount including tax

List-based fields such as tipoFactura and tipoRectificativa accept both the integer ID and the string code interchangeably — for example, 1 and 'F1' are equivalent for tipoFactura. Use listarListas() or idValorLista() to look up valid values for any list at runtime. See Listing Resources for details.

If you do not pass a $webhookID as the third argument to nuevoRegistroAlta(), the emisor’s own webhookID is used automatically. Pass an explicit integer to override the default on a per-record basis.

Getting Started

Core Concepts

Guides

Create and Submit RegistroAlta Invoice Records to AEAT

Build and Submit a RegistroAlta

RegistroAlta Data Fields Reference

Build docs developers (and LLMs) love

Getting Started

Core Concepts

Guides

Documentation Index

​Build and Submit a RegistroAlta

​RegistroAlta Data Fields Reference

Build docs developers (and LLMs) love

Build and Submit a RegistroAlta

RegistroAlta Data Fields Reference