Se ha estandarizado el largo de código en general y su formato, tanto en el API Client como en los tests y servicios. Se añadió un caso de ejemplo nuevo para la documentación. Se hizo una corrección menor en unit-test.rst. Se añadió la alternativa de usar variables de entorno además de buscar automáticamente para obtener variables necesarias para los tests. Se eliminaron algunos métodos innecesarios en el API Client, y se añadió tipado a dichos métodos, tanto en parámetros de entrada como en sus retornos. Se añadió más alias para facilitar testeo en composer.json. Se hicieron correcciones de funcionamiento a algunos tests que requerían buscar y obtener datos por índice, como ObtenerPdfBteEmitidaTest.php.

Author: SantiagoFiol

.gitignore

@@ -2,6 +2,8 @@ vendor/
 test.env
 .phpunit.result.cache
 Dockerfile
+.vscode/
+**/.DS_Store
 
 var/
 tools/

composer.json

@@ -35,6 +35,11 @@
         "docs": "php tools/phpdocumentor run --config=phpdoc.xml",
         "tests": "XDEBUG_MODE=coverage vendor/bin/phpunit --configuration=phpunit.xml",
         "tests-contribuyentes": "vendor/bin/phpunit --configuration=phpunit.xml --no-coverage --testsuite contribuyentes",
+        "tests-facturacion": "vendor/bin/phpunit --configuration=phpunit.xml --no-coverage --testsuite facturacion",
+        "tests-bhe": "vendor/bin/phpunit --configuration=phpunit.xml --no-coverage --testsuite bhe",
+        "tests-bte": "vendor/bin/phpunit --configuration=phpunit.xml --no-coverage --testsuite bte",
+        "tests-remuneraciones": "vendor/bin/phpunit --configuration=phpunit.xml --no-coverage --testsuite remuneraciones",
+        "tests-movimientos": "vendor/bin/phpunit --configuration=phpunit.xml --no-coverage --testsuite movimientos",
         "tests-readonly": "XDEBUG_MODE=coverage vendor/bin/phpunit --configuration=phpunit.xml --filter 'testObtenerDatosContribuyente|testObtenerEstadisticasContribuyente|testObtenerRoles|testListarMovimientos|testListarRemuneraciones'",
         "phpcs-fix": "php-cs-fixer fix -v --config=php-cs-fixer.php .",
         "phpcs-fix-dry-run": "php-cs-fixer fix -v --dry-run --diff --config=php-cs-fixer.php .",

docs/dev/unit-test.rst

@@ -1,8 +1,6 @@
 Pruebas unitarias
 =================
 
-Para ejecutar las pruebas unitarias se necesita tener instaladas las dependencias de composer y luego ejecutar:
-
 .. important::
   Al ejecutar pruebas, deberás tener configuradas las variables de entorno necesarias en el archivo test.env. Favor de duplicar test.env-dist, cambiar su nombre a test.env y rellenar las variables necesarias.
 
@@ -26,4 +24,4 @@ También es posible ejecutar una pruebas específica indicando el test. Ejemplo:
 Alternativamente, se puede ejecutar un "testsuite", o conjunto de tests (solo válido desde la versión de GitHub, o si has definido testsuites previamente):
 
 .. code-block:: shell
-    ./vendor/bin/phpunit --no-coverage --testsuite contribuyentes
+    ./vendor/bin/phpunit --no-coverage --testsuite contribuyentes

docs/getting-started/example.rst

@@ -14,26 +14,84 @@ Para utilizar el cliente de API de ContaFi, deberás tener definido el token de
 .. code-block:: php
     <?php
 
-    # Definición de directorio autoload. Necesario si se usa la versión de GitHub.
+    // Definición de directorio autoload. Necesario si se usa la versión de GitHub.
     require_once __DIR__ . '/vendor/autoload.php';
 
-    # Importaciones del cliente de API de ContaFi
+    // Importaciones del cliente de API de ContaFi
     use contafi\api_client\client\Contribuyentes;
 
-    # Instancia de cliente.
+    // Instancia de cliente.
     $client = new Contribuyentes();
-    # RUT del contribuyente a consultar.
+    // RUT del contribuyente a consultar.
     $rut = "12345678-9";
 
-    # Respuesta de solicitud HTTP (POST) de emisión de boleta.
+    // Respuesta de solicitud HTTP (POST) de emisión de boleta.
     $response = $client->datosContribuyente($rut);
 
-    # Despliegue del resultado.
+    // Despliegue del resultado.
     echo "\n",$response->getStatusCode();
     echo "\nCONTRIBUYENTE DATOS: \n";
     echo "\n",$response->getBody()->getContents(),"\n";
 
+Ejemplo de emitir una BTE
+-------------------------
 
+A continuación se mostrará un segundo ejemplo en donde se podrá emitir una BTE:
+
+.. code-block:: php
+    <?php
+
+    declare(strict_types=1);
+
+    // Definición de directorio autoload. Necesario si se usa la versión de GitHub.
+    require_once __DIR__ . '/vendor/autoload.php';
+
+    // Importaciones del cliente de API de ContaFi
+    use contafi\api_client\client\Bte;
+
+    // Instancia de cliente.
+    $client = new Bte();
+    // RUT del contribuyente emisor de la BTE.
+    $rutEmisor = '12345678-9';
+
+    // Fecha de emisión de la BTE.
+    $fecha = date('Y-m-d');
+
+    // Datos de la BTE a emitir.
+    $datosBte = [
+        'Encabezado' => [
+            'IdDoc' => [
+                'FchEmis' => $fecha,
+            ],
+            'Emisor' => [
+                'RUTEmisor' => $rutEmisor,
+            ],
+            'Receptor' => [
+                'RUTRecep' => '66666666-6',
+                'RznSocRecep' => 'Receptor generico',
+                'DirRecep' => 'Santa Cruz',
+                'CmnaRecep' => 'Santa Cruz',
+            ],
+        ],
+        'Detalle' => [
+            [
+                'NmbItem' => 'Prueba integracion ContaFi 1',
+                'MontoItem' => 50,
+            ],
+            [
+                'NmbItem' => 'Prueba integracion ContaFi 2',
+                'MontoItem' => 100,
+            ],
+        ],
+    ];
+
+    // Obtención de respuesta a la emisión de la BTE.
+    $response = $client->emitir($datosBte);
+
+    // Se despliega en consola los resultados.
+    echo "\n",$response->getStatusCode();
+    echo "\nEMITIR BTE: \n";
+    echo "\n",$response->getBody()->getContents(),"\n";
 
 .. seealso::
     Para saber más sobre los parámetros posibles y el cómo consumir las API, referirse a la `documentación de ContaFi. <https://developers.contafi.cl/>`_

src/ApiBase.php

@@ -31,9 +31,9 @@ class ApiBase extends ApiClient
     /**
      * Clase base para las clases que consumen la API (wrappers).
      *
-     * @param string $token Token de autenticación para la API
-     * @param string $rut RUT del emisor de ContaFi.
-     * @param string $url Versión de la API.
+     * @param string|null $token Token de autenticación para la API
+     * @param string|null $rut RUT del emisor de ContaFi.
+     * @param string|null $url Versión de la API.
      */
     public function __construct(
         string $token = null,