Se arregló y estandarizó la documentación. Se corrigieron y separaron los tests en pagos_cobros_masivos. Se probó con éxito la mayoría de tests. Se estandarizó el verbose.

Author: SantiagoFiol

.gitignore

@@ -1,6 +1,6 @@
 vendor/
 tests/test.env
-tests/archivos/
+tests/archivos/dte_facturacion/*
 
 var/
 tools/

src/ApiClient.php

@@ -26,8 +26,8 @@
 /**
  * Clase ApiClient para la integración con la API de LibreDTE.
  *
- * Proporciona funcionalidades para realizar peticiones HTTP a la API de LibreDTE,
- * incluyendo métodos para realizar solicitudes GET y POST.
+ * Proporciona funcionalidades para realizar peticiones HTTP a la API de
+ * LibreDTE, incluyendo métodos para realizar solicitudes GET y POST.
  */
 class ApiClient
 {
@@ -66,8 +66,8 @@ class ApiClient
     /**
      * Constructor de la clase ApiClient.
      *
-     * Inicializa el cliente con las credenciales y la URL de la API. Si no se proporcionan,
-     * se intentará obtener desde las variables de entorno.
+     * Inicializa el cliente con las credenciales y la URL de la API. Si no se
+     * proporcionan, se intentará obtener desde las variables de entorno.
      *
      * @param string|null $hash Hash de autenticación del usuario en LibreDTE.
      * @param string|null $url URL base de la API de LibreDTE.
@@ -89,8 +89,8 @@ public function __construct($hash = null, $url = null)
     /**
      * Establece una cabecera para las solicitudes HTTP.
      *
-     * Permite definir un valor para una cabecera específica que se incluirá en todas
-     * las solicitudes HTTP realizadas por la instancia del cliente.
+     * Permite definir un valor para una cabecera específica que se incluirá en
+     * todas las solicitudes HTTP realizadas por la instancia del cliente.
      *
      * @param string $name Nombre de la cabecera.
      * @param mixed $value Valor de la cabecera.
@@ -103,10 +103,11 @@ public function setHeader(string $name, $value)
     /**
      * Configura las opciones de SSL para las conexiones HTTP.
      *
-     * Este método permite activar o desactivar la verificación del certificado SSL
-     * del servidor.
+     * Este método permite activar o desactivar la verificación del certificado
+     * SSL del servidor.
      *
-     * @param boolean $sslcheck Activar o desactivar la verificación del certificado SSL.
+     * @param boolean $sslcheck Activar o desactivar la verificación del
+     * certificado SSL.
      */
     public function setSSL($sslcheck = true)
     {
@@ -137,7 +138,8 @@ public function post($resource, $data = null, array $headers = [])
     /**
      * Realiza una solicitud GET a la API de LibreDTE.
      *
-     * Recupera datos de un recurso específico de la API utilizando el método GET.
+     * Recupera datos de un recurso específico de la API utilizando el método
+     * GET.
      *
      * @param string $resource El recurso de la API a solicitar.
      * @param mixed $data Los datos a enviar en la solicitud GET.
@@ -162,7 +164,8 @@ public function get($resource, $data = null, array $headers = [])
      * como el hash de autenticación o la URL base de la API.
      *
      * @param string $name Nombre de la variable de entorno.
-     * @return string|null Valor de la variable de entorno o null si no está definida.
+     * @return string|null Valor de la variable de entorno o null si no está
+     * definida.
      */
     private function env($name)
     {

src/ApiException.php

@@ -24,12 +24,14 @@
 namespace libredte\api_client;
 
 /**
- * Clase ApiException para la gestión de excepciones en el cliente de la API de LibreDTE.
+ * Clase ApiException para la gestión de excepciones en el cliente de la API
+ * de LibreDTE.
  *
- * Esta clase extiende la clase Exception estándar de PHP y se utiliza para manejar
- * errores específicos que pueden ocurrir durante las interacciones con la API de LibreDTE.
- * Las instancias de ApiException pueden incluir información adicional relevante para
- * los errores de la API.
+ * Esta clase extiende la clase Exception estándar de PHP y se utiliza para
+ * manejar errores específicos que pueden ocurrir durante las interacciones
+ * con la API de LibreDTE.
+ * Las instancias de ApiException pueden incluir información adicional
+ * relevante para los errores de la API.
  */
 class ApiException extends \Exception
 {

src/HttpCurlClient.php

@@ -26,8 +26,9 @@
 /**
  * Clase HttpCurlClient para realizar consultas HTTP utilizando cURL.
  *
- * Esta clase proporciona una interfaz para realizar peticiones HTTP, como GET y POST,
- * utilizando cURL. Ofrece configuración de SSL y manejo de errores de cURL.
+ * Esta clase proporciona una interfaz para realizar peticiones HTTP, como GET
+ * y POST, utilizando cURL. Ofrece configuración de SSL y manejo de errores de
+ * cURL.
  */
 class HttpCurlClient
 {
@@ -61,7 +62,8 @@ public function getErrors()
     /**
      * Devuelve el último error ocurrido en una petición HTTP.
      *
-     * Este método devuelve el último error generado por cURL en una petición HTTP.
+     * Este método devuelve el último error generado por cURL en una petición
+     * HTTP.
      *
      * @return string Descripción del último error de cURL.
      */
@@ -73,10 +75,11 @@ public function getLastError()
     /**
      * Configura las opciones de SSL para las peticiones HTTP.
      *
-     * Este método permite activar o desactivar la verificación del certificado SSL
-     * del servidor.
+     * Este método permite activar o desactivar la verificación del certificado
+     * SSL del servidor.
      *
-     * @param boolean $sslcheck Activar o desactivar la verificación del certificado SSL.
+     * @param boolean $sslcheck Activar o desactivar la verificación del
+     * certificado SSL.
      */
     public function setSSL($sslcheck = true)
     {
@@ -86,7 +89,8 @@ public function setSSL($sslcheck = true)
     /**
      * Realiza una solicitud HTTP a una URL.
      *
-     * Este método ejecuta una petición HTTP utilizando cURL y devuelve la respuesta.
+     * Este método ejecuta una petición HTTP utilizando cURL y devuelve la
+     * respuesta.
      * Soporta varios métodos HTTP como GET, POST, PUT, DELETE, etc.
      *
      * @param string $method Método HTTP a utilizar.
@@ -159,10 +163,12 @@ public function query($method, string $url, $data = [], array $headers = [])
     }
 
     /**
-     * Método que procesa y convierte la cabecera en texto plano a un arreglo asociativo.
+     * Método que procesa y convierte la cabecera en texto plano a un arreglo
+     * asociativo.
      *
-     * Convierte las cabeceras HTTP dadas en texto plano a un arreglo asociativo. Si una cabecera
-     * aparece más de una vez, su valor será un arreglo con todos sus valores.
+     * Convierte las cabeceras HTTP dadas en texto plano a un arreglo
+     * asociativo. Si una cabecera aparece más de una vez, su valor será un
+     * arreglo con todos sus valores.
      *
      * @param string $headers_txt Cabeceras HTTP en formato de texto plano.
      * @return array Arreglo asociativo con las cabeceras procesadas.
@@ -197,13 +203,16 @@ private function parseResponseHeaders($headers_txt)
     }
 
     /**
-     * Método que procesa la línea de estado de la respuesta HTTP y extrae información útil.
+     * Método que procesa la línea de estado de la respuesta HTTP y extrae
+     * información útil.
      *
-     * Extrae el protocolo, el código de estado y el mensaje del estado de la línea de respuesta HTTP.
+     * Extrae el protocolo, el código de estado y el mensaje del estado de la
+     * línea de respuesta HTTP.
      * Útil para entender y manejar la respuesta HTTP.
      *
      * @param array|string $response_line Línea de respuesta HTTP.
-     * @return array Arreglo con información del estado, incluyendo protocolo, código y mensaje.
+     * @return array Arreglo con información del estado, incluyendo protocolo,
+     * código y mensaje.
      */
     private function parseResponseStatus($response_line)
     {

tests/dte_facturacion/AbstractDteFacturacion.php

@@ -98,8 +98,13 @@ abstract class AbstractDteFacturacion extends TestCase
     public static function setUpBeforeClass(): void
     {
         self::$verbose = (bool)env('TEST_VERBOSE', 'false');
-        self::$emisor_rut = (explode('-', (string)env('LIBREDTE_RUT'))[0]);
-        self::$datos['Encabezado']['Emisor']['RUTEmisor'] = env('LIBREDTE_RUT');
+        self::$emisor_rut = (explode(
+            '-',
+            (string)env('LIBREDTE_RUT'))[0]
+        );
+        self::$datos['Encabezado']['Emisor']['RUTEmisor'] = env(
+            'LIBREDTE_RUT'
+        );
         self::$client = new ApiClient();
     }
 
@@ -112,22 +117,28 @@ public static function setUpBeforeClass(): void
      */
     protected function listarDteTemp(): array
     {
-        # Se crea el filtro a utilizar, en este caso fechas de búsqueda.
+        // Se crea el filtro a utilizar, en este caso fechas de búsqueda.
         $filtros = [
-            'fecha_desde' => '2015-01-01',
+            'fecha_desde' => date('Y-m-d', strtotime('-30 days')),
             'fecha_hasta' => date('Y-m-d'),
         ];
-        # Se genera el recurso a consumir.
-        $resource = sprintf('/dte/dte_tmps/buscar/%d', self::$emisor_rut);
-        # Se envía la solicitud http y se guarda su respuesta.
+        // Se genera el recurso a consumir.
+        $resource = sprintf(
+            '/dte/dte_tmps/buscar/%d',
+            self::$emisor_rut
+        );
+        // Se envía la solicitud http y se guarda su respuesta.
         $response = self::$client->post($resource, $filtros);
 
-        # Si el código http no es '200', arroja error ApiException.
+        // Si el código http no es '200', arroja error ApiException.
         if ($response['status']['code'] !== '200') {
-            throw new ApiException($response['body'], (int)$response['status']['code']);
+            throw new ApiException(
+                $response['body'],
+                (int)$response['status']['code']
+            );
         }
 
-        # Retorna la respuesta http.
+        // Retorna la respuesta http.
         return $response;
     }
 
@@ -140,15 +151,21 @@ protected function listarDteTemp(): array
      */
     protected function emitirDteTemp(): array
     {
-        # Se envía la solicitud http y se guarda su respuesta.
-        $response = self::$client->post('/dte/documentos/emitir', self::$datos);
+        // Se envía la solicitud http y se guarda su respuesta.
+        $response = self::$client->post(
+            '/dte/documentos/emitir',
+            self::$datos
+        );
 
-        # Si el código http no es '200', arroja error ApiException.
+        // Si el código http no es '200', arroja error ApiException.
         if ($response['status']['code'] !== '200') {
-            throw new ApiException($response['body'], (int)$response['status']['code']);
+            throw new ApiException(
+                $response['body'],
+                (int)$response['status']['code']
+            );
         }
 
-        # Retorna la respuesta http.
+        // Retorna la respuesta http.
         return $response;
     }
 }

tests/dte_facturacion/BuscarDteTempTest.php

@@ -44,10 +44,10 @@ class BuscarDteTempTest extends AbstractDteFacturacion
     public function testBuscarDteTemp(): void
     {
         try {
-            # Se emite un DTE temporal para ejecutar esta prueba.
+            // Se emite un DTE temporal para ejecutar esta prueba.
             $dte_temp = $this->emitirDteTemp();
 
-            # Se genera el recurso para buscar el DTE temporal generado.
+            // Se genera el recurso para buscar el DTE temporal generado.
             $resource = sprintf(
                 "/dte/dte_tmps/info/%d/%d/%s/%d",
                         $dte_temp['body']['receptor'],
@@ -56,25 +56,34 @@ public function testBuscarDteTemp(): void
                         self::$emisor_rut
             );
 
-            # Se envía la solicitud http y se guarda su respuesta.
+            // Se envía la solicitud http y se guarda su respuesta.
             $response = self::$client->get($resource);
-            # Si el código http no es '200', arroja error ApiException.
+            // Si el código http no es '200', arroja error ApiException.
             if ($response['status']['code'] !== '200') {
-                throw new ApiException($response['body'], (int)$response['status']['code']);
+                throw new ApiException(
+                    $response['body'],
+                    (int)$response['status']['code']
+                );
             }
-            # Se obtiene el body de la lista.
+            // Se obtiene el body de la lista.
             $documento = $response['body'];
 
-            # Se compara el código con '200' Si no es 200, la prueba falla.
+            // Se compara el código con '200' Si no es 200, la prueba falla.
             $this->assertSame('200', $response['status']['code']);
-            # Se despliega en consola los resultados si verbose es true.
+            // Se despliega en consola los resultados si verbose es true.
             if (self::$verbose) {
-                echo "\n",'testBuscarDteTemp() DTE: ',json_encode($documento),"\n";
+                echo "\n",'testBuscarDteTemp() DTE: ',json_encode(
+                    $documento
+                ),"\n";
             }
         } catch (ApiException $e) {
-            # Si falla, desplegará el mensaje y error en el siguiente formato:
-            # [ApiException codigo-http] mensaje]
-            $this->fail(sprintf('[ApiException %d] %s', $e->getCode(), $e->getMessage()));
+            // Si falla, desplegará el mensaje y error en el siguiente formato:
+            // [ApiException codigo-http] mensaje]
+            $this->fail(sprintf(
+                '[ApiException %d] %s',
+                $e->getCode(),
+                $e->getMessage()
+            ));
         }
     }
 }