Add new invoice fields and refactor AEAT client

Introduces new optional fields to the VeriFactuInvoice contract and Invoice model: operation_date, tax_period, correction_type, and external_reference. Refactors AeatClient to modularize SOAP request building, support the new fields, and improve testability. Adds a unit test to verify correct structure and field mapping in AEAT client requests.

Author: jcancig

composer.json

@@ -1,53 +1,58 @@
 {
-    "name": "squareetlabs/laravel-verifactu",
-    "description": "Paquete Laravel para gestión y registro de facturación electrónica VeriFactu. Compatible con Laravel 10 a 12.x",
-    "type": "library",
-    "license": "MIT",
-    "keywords": ["laravel", "verifactu", "facturacion electrónica"],
-    "authors": [
-        {
-            "name": "Alberto Rial Barreiro",
-            "email": "[email protected]",
-            "homepage": "https://www.squareet.com",
-            "role": "Developer"
-        },
-        {
-            "name": "Jacobo Cantorna Cigarrán",
-            "email": "[email protected]",
-            "homepage": "https://www.squareet.com",
-            "role": "Developer"
-        }
-    ],
-    "require": {
-        "php": ">=8.1",
-        "illuminate/support": "^10.0|^11.0|^12.0"
+  "name": "squareetlabs/laravel-verifactu",
+  "description": "Paquete Laravel para gestión y registro de facturación electrónica VeriFactu. Compatible con Laravel 10 a 12.x",
+  "type": "library",
+  "license": "MIT",
+  "keywords": [
+    "laravel",
+    "verifactu",
+    "facturacion electrónica"
+  ],
+  "authors": [
+    {
+      "name": "Alberto Rial Barreiro",
+      "email": "[email protected]",
+      "homepage": "https://www.squareet.com",
+      "role": "Developer"
     },
-    "autoload": {
-        "psr-4": {
-            "Squareetlabs\\VeriFactu\\": "src/"
-        }
-    },
-    "autoload-dev": {
-        "psr-4": {
-            "Tests\\": "tests/",
-            "Database\\Factories\\": "database/factories/",
-            "Database\\Factories\\Squareetlabs\\VeriFactu\\Models\\": "database/factories/Squareetlabs/VeriFactu/Models/"
-          }
-    },
-    "extra": {
-        "laravel": {
-            "providers": [
-                "Squareetlabs\\VeriFactu\\Providers\\VeriFactuServiceProvider"
-            ],
-            "aliases": {
-                "VeriFactu": "Squareetlabs\\VeriFactu\\Facades\\VeriFactu"
-            }
-        }
-    },
-    "minimum-stability": "dev",
-    "prefer-stable": true,
-    "require-dev": {
-        "phpunit/phpunit": "^10.0|^11.5",
-        "orchestra/testbench": "^8.0|^9.0|^10.4"
+    {
+      "name": "Jacobo Cantorna Cigarrán",
+      "email": "[email protected]",
+      "homepage": "https://www.squareet.com",
+      "role": "Developer"
+    }
+  ],
+  "require": {
+    "php": ">=8.1",
+    "illuminate/support": "^10.0|^11.0|^12.0",
+    "ext-soap": "*"
+  },
+  "autoload": {
+    "psr-4": {
+      "Squareetlabs\\VeriFactu\\": "src/"
+    }
+  },
+  "autoload-dev": {
+    "psr-4": {
+      "Tests\\": "tests/",
+      "Database\\Factories\\": "database/factories/",
+      "Database\\Factories\\Squareetlabs\\VeriFactu\\Models\\": "database/factories/Squareetlabs/VeriFactu/Models/"
+    }
+  },
+  "extra": {
+    "laravel": {
+      "providers": [
+        "Squareetlabs\\VeriFactu\\Providers\\VeriFactuServiceProvider"
+      ],
+      "aliases": {
+        "VeriFactu": "Squareetlabs\\VeriFactu\\Facades\\VeriFactu"
+      }
     }
+  },
+  "minimum-stability": "dev",
+  "prefer-stable": true,
+  "require-dev": {
+    "phpunit/phpunit": "^10.0|^11.5",
+    "orchestra/testbench": "^8.0|^9.0|^10.4"
+  }
 }

src/Contracts/VeriFactuInvoice.php

@@ -93,4 +93,33 @@ public function getPreviousHash(): ?string;
      * @return string
      */
     public function getOperationDescription(): string;
+
+    /**
+     * Get the operation date (if different from issue date)
+     *
+     * @return Carbon|null
+     */
+    public function getOperationDate(): ?Carbon;
+
+    /**
+     * Get the tax period (e.g., "01", "02", "0A")
+     *
+     * @return string|null
+     */
+    public function getTaxPeriod(): ?string;
+
+    /**
+     * Get the correction type (e.g., "S", "I")
+     * Required for corrective invoices (R1-R5)
+     *
+     * @return string|null
+     */
+    public function getCorrectionType(): ?string;
+
+    /**
+     * Get the external reference (optional)
+     *
+     * @return string|null
+     */
+    public function getExternalReference(): ?string;
 }

src/Models/Invoice.php

@@ -63,10 +63,14 @@ protected static function booted()
         'issued_at',
         'cancelled_at',
         'hash',
+        'operation_date',
+        'tax_period',
+        'correction_type',
     ];
 
     protected $casts = [
         'date' => 'date',
+        'operation_date' => 'date',
         'type' => InvoiceType::class,
         'amount' => 'decimal:2',
         'tax' => 'decimal:2',
@@ -139,4 +143,24 @@ public function getOperationDescription(): string
     {
         return $this->description ?? 'Invoice issued';
     }
+
+    public function getOperationDate(): ?Carbon
+    {
+        return $this->operation_date;
+    }
+
+    public function getTaxPeriod(): ?string
+    {
+        return $this->tax_period;
+    }
+
+    public function getCorrectionType(): ?string
+    {
+        return $this->correction_type;
+    }
+
+    public function getExternalReference(): ?string
+    {
+        return $this->external_reference;
+    }
 }