Merge pull request #176 from josemmo/develop

v1.8.2

.github/workflows/tests.yml

@@ -14,12 +14,12 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php-version: ['5.6', '7.0', '7.1', '7.2', '7.3', '7.4', '8.0', '8.1', '8.2']
+        php-version: ['5.6', '7.0', '7.1', '7.2', '7.3', '7.4', '8.0', '8.1', '8.2', '8.3']
         include:
-          - php-version: '8.3'
+          - php-version: '8.4'
             test-ws: true
             send-coverage: true
-          - php-version: '8.4'
+          - php-version: '8.5'
             experimental: true
     steps:
       # Download code from repository

autoload.php

@@ -0,0 +1,21 @@
+<?php
+/**
+ * This file is an extremely simple autoloader for environments where Composer is not available.
+ */
+
+spl_autoload_register(static function ($class) {
+  // Verify we're importing a class from this library
+  if (mb_strpos($class, 'josemmo\\Facturae\\') !== 0) {
+    return false;
+  }
+
+  // Find file
+  $path = __DIR__ . "/src/" . str_replace('\\', '/', mb_substr($class, 17)) . ".php";
+  if (!file_exists($path)) {
+    return false;
+  }
+
+  // Import file
+  require $path;
+  return true;
+});

doc/anexos/validacion.md

@@ -9,6 +9,6 @@ permalink: /anexos/validacion.html
 Todas las facturas generadas y firmadas con Facturae-PHP son probadas con las siguientes herramientas online para garantizar el cumplimiento del estándar:
 
 - [https://viewer.facturadirecta.com/](https://viewer.facturadirecta.com/) (no soporta 3.2.2)
-- [http://plataforma.firma-e.com/VisualizadorFacturae/](http://plataforma.firma-e.com/VisualizadorFacturae/) (no soporta 3.2.2)
-- [http://sedeaplicaciones2.minetur.gob.es/FacturaE/index.jsp](http://sedeaplicaciones2.minetur.gob.es/FacturaE/index.jsp)
+- [https://plataforma.firma-e.com/VisualizadorFacturae/](https://plataforma.firma-e.com/VisualizadorFacturae/)
 - [https://face.gob.es/es/facturas/validar-visualizar-facturas](https://face.gob.es/es/facturas/validar-visualizar-facturas)
+- [https://sedeaplicaciones2.minetur.gob.es/FacturaE/index.jsp](https://sedeaplicaciones2.minetur.gob.es/FacturaE/index.jsp) (ya no existe)

doc/ejemplos/sin-composer.md

@@ -8,18 +8,10 @@ permalink: /ejemplos/sin-composer.html
 # Uso sin Composer
 Este ejemplo muestra cómo usar `Facturae-PHP` sin tener configurado un entorno de Composer, solo descargando el código fuente de la librería.
 
+Para ello, se incluye el script "autoload.php" en el directorio raíz, que permite auto-cargar las clases de la librería.
+
 ```php
-require_once 'ruta/hacia/Facturae-PHP/src/Common/FacturaeSigner.php';
-require_once 'ruta/hacia/Facturae-PHP/src/Common/KeyPairReaderTrait.php';
-require_once 'ruta/hacia/Facturae-PHP/src/Common/XmlTools.php';
-require_once 'ruta/hacia/Facturae-PHP/src/FacturaeTraits/PropertiesTrait.php';
-require_once 'ruta/hacia/Facturae-PHP/src/FacturaeTraits/UtilsTrait.php';
-require_once 'ruta/hacia/Facturae-PHP/src/FacturaeTraits/SignableTrait.php';
-require_once 'ruta/hacia/Facturae-PHP/src/FacturaeTraits/ExportableTrait.php';
-require_once 'ruta/hacia/Facturae-PHP/src/Facturae.php';
-require_once 'ruta/hacia/Facturae-PHP/src/FacturaeCentre.php';
-require_once 'ruta/hacia/Facturae-PHP/src/FacturaeItem.php';
-require_once 'ruta/hacia/Facturae-PHP/src/FacturaeParty.php';
+require_once 'ruta/hacia/Facturae-PHP/autoload.php'; // <-- Autoloader incluido con la librería
 
 use josemmo\Facturae\Facturae;
 use josemmo\Facturae\FacturaeParty;

doc/entidades/compradores-y-vendedores.md

@@ -12,6 +12,7 @@ $empresa = new FacturaeParty([
   "isLegalEntity" => true, // Se asume true si se omite
   "taxNumber"     => "A00000000",
   "name"          => "Perico el de los Palotes S.A.",
+  "tradeName"     => "Peri Co.", // Nombre comercial
   "address"       => "C/ Falsa, 123",
   "postCode"      => "12345",
   "town"          => "Madrid",

src/Facturae.php

@@ -10,7 +10,7 @@
  * Class for creating electronic invoices that comply with the Spanish FacturaE format.
  */
 class Facturae {
-  const VERSION = "1.8.1";
+  const VERSION = "1.8.2";
   const USER_AGENT = "FacturaePHP/" . self::VERSION;
 
   const SCHEMA_3_2 = "3.2";

src/FacturaeParty.php

@@ -22,6 +22,8 @@ class FacturaeParty {
   public $taxNumber = null;
   /** @var string|null */
   public $name = null;
+  /** @var string|null */
+  public $tradeName = null;
 
   /**
    * Libro (only for legal entities)
@@ -182,14 +184,15 @@ public function getXML($includeAdministrativeCentres) {
     // Add data exclusive to `LegalEntity`
     if ($this->isLegalEntity) {
       $xml .= '<CorporateName>' . XmlTools::escape($this->name) . '</CorporateName>';
-      $fields = array("book", "registerOfCompaniesLocation", "sheet", "folio",
-        "section", "volume");
+      if (!empty($this->tradeName)) {
+        $xml .= '<TradeName>' . XmlTools::escape($this->tradeName) . '</TradeName>';
+      }
 
-      $nonEmptyFields = array();
+      $fields = ["book", "registerOfCompaniesLocation", "sheet", "folio", "section", "volume"];
+      $nonEmptyFields = [];
       foreach ($fields as $fieldName) {
         if (!empty($this->{$fieldName})) $nonEmptyFields[] = $fieldName;
       }
-
       if (count($nonEmptyFields) > 0) {
         $xml .= '<RegistrationData>';
         foreach ($nonEmptyFields as $fieldName) {

tests/InvoiceTest.php

@@ -44,6 +44,7 @@ public function testCreateInvoice($schemaVersion, $isPfx) {
     $fac->setSeller(new FacturaeParty([
       "taxNumber" => "A00000000",
       "name"      => "Perico el de los Palotes S.A.",
+      "tradeName" => "Peri Co.",
       "address"   => "C/ Falsa, 123",
       "postCode"  => "23456",
       "town"      => "Madrid",