apigatewaycl / apigateway-api-client-php

src/sii/ActividadesEconomicas.php

<?php

declare(strict_types=1);

/**
 * API Gateway: Cliente de API en PHP.
 * Copyright (C) API Gateway <https://www.apigateway.cl>
 *
 * Este programa es software libre: usted puede redistribuirlo y/o modificarlo
 * bajo los términos de la GNU Lesser General Public License (LGPL) publicada
 * por la Fundación para el Software Libre, ya sea la versión 3 de la Licencia,
 * o (a su elección) cualquier versión posterior de la misma.
 *
 * Este programa se distribuye con la esperanza de que sea útil, pero SIN
 * GARANTÍA ALGUNA; ni siquiera la garantía implícita MERCANTIL o de APTITUD
 * PARA UN PROPÓSITO DETERMINADO. Consulte los detalles de la GNU Lesser General
 * Public License (LGPL) para obtener una información más detallada.
 *
 * Debería haber recibido una copia de la GNU Lesser General Public License
 * (LGPL) junto a este programa. En caso contrario, consulte
 * <http://www.gnu.org/licenses/lgpl.html>.
 */

namespace apigatewaycl\api_client\sii;

use apigatewaycl\api_client\ApiBase;
use Psr\Http\Message\ResponseInterface;

/**
 * Módulo para obtener las actividades económicas del SII.
 *
 * Para más información sobre la API, consulte la `documentación completa de
 * Actividades Económicas <https://developers.apigateway.cl/#e64eb128-173a-48c7-ab0b-b6152e59c327>`_.
 *
 * Cliente específico para interactuar con los endpoints de actividades
 * económicas de la API de API Gateway.
 *
 * Provee métodos para obtener listados de actividades económicas, tanto de
 * primera como de segunda categoría.
 */
class ActividadesEconomicas extends ApiBase
{
    /**
     * Obtiene un listado de actividades económicas. Puede filtrar por categoría.
     *
     * @param int $categoria Categoría de las actividades económicas (opcional).
     * @return \Psr\Http\Message\ResponseInterface Respuesta JSON con el
     * listado de actividades económicas.
     */
    public function listarActividades(
        int $categoria = null
    ): ResponseInterface {
        $url = '/sii/contribuyentes/actividades_economicas';
        if ($categoria != null) {

It seems like you are loosely comparing $categoria of type integer|null against null; this is ambiguous if the integer can be zero. Consider using a strict comparison !== instead.

            $url = $url.sprintf(
                '/categoria=%d',
                $categoria
            );
        }
        $response = $this->get(resource: $url);

        return $response;

The expression return $response could return the type null which is incompatible with the type-hinted return Psr\Http\Message\ResponseInterface. Consider adding an additional type-check to rule them out.

    }

    /**
     * Obtiene un listado de actividades económicas de primera categoría.
     *
     * @return \Psr\Http\Message\ResponseInterface Respuesta JSON con el
     * listado de actividades económicas de primera categoría.
     */
    public function listado_primera_categoria(): ResponseInterface
    {
        $response = $this->listarActividades(categoria: 1);

        return $response;
    }

    /**
     * Obtiene un listado de actividades económicas de segunda categoría.
     *
     * @return \Psr\Http\Message\ResponseInterface Respuesta JSON con el
     * listado de actividades económicas de segunda categoría.
     */
    public function listado_segunda_categoria(): ResponseInterface
    {
        $response = $this->listarActividades(categoria: 2);

        return $response;
    }
}