Quickstart: Submit Your First Invoice with Verifactu PHP

<?php

require_once __DIR__ . '/vendor/autoload.php';

use eseperio\verifactu\Verifactu;

Verifactu::config(
    '/path/to/your-certificate.p12', // Absolute path to your PKCS#12 certificate
    'your-certificate-password',     // Certificate password
    Verifactu::TYPE_CERTIFICATE,     // TYPE_CERTIFICATE or TYPE_SEAL
    Verifactu::ENVIRONMENT_SANDBOX   // Use ENVIRONMENT_PRODUCTION for live submissions
);

use eseperio\verifactu\models\InvoiceId;

$invoiceId = new InvoiceId();
$invoiceId->issuerNif    = 'B12345678';   // Spanish NIF of the invoice issuer
$invoiceId->seriesNumber = 'FA2024/001';  // Series + invoice number (up to 60 chars)
$invoiceId->issueDate    = '2024-07-01';  // Issue date in YYYY-MM-DD format

use eseperio\verifactu\models\ComputerSystem;
use eseperio\verifactu\models\LegalPerson;
use eseperio\verifactu\models\enums\YesNoType;

// Software provider identity
$provider = new LegalPerson();
$provider->name = 'Software Provider SL';
$provider->nif  = 'B87654321';

// Computer system metadata
$computerSystem = new ComputerSystem();
$computerSystem->providerName        = 'Software Provider SL';
$computerSystem->systemName          = 'My ERP System';
$computerSystem->systemId            = '01';
$computerSystem->version             = '1.0';
$computerSystem->installationNumber  = '1';
$computerSystem->onlyVerifactu       = YesNoType::YES; // This software only emits Verifactu invoices
$computerSystem->multipleObligations = YesNoType::NO;  // Single tax obligation
$computerSystem->hasMultipleObligations = YesNoType::NO;
$computerSystem->setProviderId($provider);

use eseperio\verifactu\models\Breakdown;
use eseperio\verifactu\models\BreakdownDetail;
use eseperio\verifactu\models\enums\TaxType;
use eseperio\verifactu\models\enums\RegimeType;
use eseperio\verifactu\models\enums\OperationQualificationType;

$detail = new BreakdownDetail();
$detail->taxType                = TaxType::IVA;                                          // IVA (01)
$detail->regimeKey              = RegimeType::GENERAL;                                   // General regime (01)
$detail->operationQualification = OperationQualificationType::SUBJECT_NO_EXEMPT_NO_REVERSE; // S1
$detail->taxRate                = 21.00;  // 21% VAT
$detail->taxableBase            = 100.00; // Net amount before tax
$detail->taxAmount              = 21.00;  // Tax amount (taxableBase × taxRate / 100)

$breakdown = new Breakdown();
$breakdown->addDetail($detail);

use eseperio\verifactu\models\Chaining;

// For the very first invoice in a series:
$chaining = new Chaining();
$chaining->setAsFirstRecord(); // Sets PrimerRegistro = 'S'

// For subsequent invoices, link to the previous record's hash instead:
// $chaining->setPreviousInvoice([
//     'issuerNif'    => 'B12345678',
//     'seriesNumber' => 'FA2024/000',
//     'issueDate'    => '2024-06-30',
//     'hash'         => '<SHA-256 hash of previous invoice>',
// ]);

use eseperio\verifactu\models\InvoiceSubmission;
use eseperio\verifactu\models\LegalPerson;
use eseperio\verifactu\models\enums\InvoiceType;
use eseperio\verifactu\models\enums\YesNoType;

$invoice = new InvoiceSubmission();

// Invoice identification
$invoice->setInvoiceId($invoiceId);

// Basic invoice data
$invoice->issuerName          = 'Empresa Ejemplo SL';      // Must match AEAT census exactly
$invoice->invoiceType         = InvoiceType::STANDARD;     // F1 — standard invoice
$invoice->operationDescription = 'Venta de productos';     // Free-text description
$invoice->taxAmount           = 21.00;                     // Total tax (all rates summed)
$invoice->totalAmount         = 121.00;                    // Grand total including tax
$invoice->simplifiedInvoice   = YesNoType::NO;
$invoice->invoiceWithoutRecipient = YesNoType::NO;

// Tax breakdown
$invoice->setBreakdown($breakdown);

// Chaining
$invoice->setChaining($chaining);

// Computer system
$invoice->setSystemInfo($computerSystem);

// Timestamp — use the actual generation date/time with timezone offset
$invoice->recordTimestamp = '2024-07-01T12:00:00+02:00';

// Recipient (required for STANDARD / F1 invoices)
$recipient = new LegalPerson();
$recipient->name = 'Cliente Ejemplo SL';
$recipient->nif  = 'A98765432';
$invoice->addRecipient($recipient);

$validationResult = $invoice->validate();

if ($validationResult !== true) {
    // $validationResult is an associative array: ['fieldName' => ['error message', ...]]
    foreach ($validationResult as $field => $errors) {
        echo "Field '{$field}': " . implode(', ', $errors) . PHP_EOL;
    }
    exit(1);
}

use eseperio\verifactu\models\InvoiceResponse;

try {
    $response = Verifactu::registerInvoice($invoice);
} catch (\SoapFault $e) {
    // Network / SOAP communication error
    echo "SOAP error: " . $e->getMessage() . PHP_EOL;
    exit(1);
} catch (\Exception $e) {
    // Certificate, XML signing, or other error
    echo "Error: " . $e->getMessage() . PHP_EOL;
    exit(1);
}

if ($response->submissionStatus === InvoiceResponse::STATUS_OK) {
    // SUCCESS: invoice accepted by AEAT
    echo "Invoice registered successfully!" . PHP_EOL;
    echo "AEAT CSV: " . $response->csv . PHP_EOL;

    // The CSV is now printed on the invoice and embedded in the QR code
    // Store $response->csv in your database alongside the invoice record

} else {
    // REJECTED: one or more lines were rejected by AEAT
    echo "Submission status: " . $response->submissionStatus . PHP_EOL;

    // lineResponses contains per-invoice error details
    if (is_array($response->lineResponses)) {
        foreach ($response->lineResponses as $line) {
            if (!empty($line['CodigoErrorRegistro'])) {
                echo "Error code: " . $line['CodigoErrorRegistro'] . PHP_EOL;
                echo "Description: " . $line['DescripcionErrorRegistro'] . PHP_EOL;
            }
        }
    }

    // Convenience helper — returns ['errorCode' => 'description'] array
    $errors = $response->getErrors();
    print_r($errors);
}