Test Failed
Push — master ( e81f34...58150d )
by
unknown
19:06
created

PortalMipymeDteRecibidos::obtenerDtesRecibidos()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 13
Code Lines 8

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 0
CRAP Score 2

Importance

Changes 1
Bugs 0 Features 0
Metric Value
cc 1
eloc 8
c 1
b 0
f 0
nc 1
nop 2
dl 0
loc 13
ccs 0
cts 11
cp 0
crap 2
rs 10
1
<?php
2
3
declare(strict_types=1);
4
5
/**
6
 * API Gateway: Cliente de API en PHP.
7
 * Copyright (C) API Gateway <https://www.apigateway.cl>
8
 *
9
 * Este programa es software libre: usted puede redistribuirlo y/o modificarlo
10
 * bajo los términos de la GNU Lesser General Public License (LGPL) publicada
11
 * por la Fundación para el Software Libre, ya sea la versión 3 de la Licencia,
12
 * o (a su elección) cualquier versión posterior de la misma.
13
 *
14
 * Este programa se distribuye con la esperanza de que sea útil, pero SIN
15
 * GARANTÍA ALGUNA; ni siquiera la garantía implícita MERCANTIL o de APTITUD
16
 * PARA UN PROPÓSITO DETERMINADO. Consulte los detalles de la GNU Lesser General
17
 * Public License (LGPL) para obtener una información más detallada.
18
 *
19
 * Debería haber recibido una copia de la GNU Lesser General Public License
20
 * (LGPL) junto a este programa. En caso contrario, consulte
21
 * <http://www.gnu.org/licenses/lgpl.html>.
22
 */
23
24
namespace apigatewaycl\api_client\sii;
25
26
use apigatewaycl\api_client\sii\PortalMipymeDte;
27
28
/**
29
 * Módulo para consultas de DTEs recibidos al Portal MIPYME del SII.
30
 *
31
 * Para más información sobre la API, consulte la `documentación completa de DTEs
32
 * recibidos en el Portal MIPYME <https://developers.apigateway.cl/#24456c78-2c1d-4e91-a0b3-450eab612e7e>`_.
33
 *
34
 * Cliente específico para gestionar DTE recibidos en el Portal Mipyme.
35
 * Proporciona métodos para obtener documentos, PDF y XML de DTE recibidos.
36
 */
37
class PortalMipymeDteRecibidos extends PortalMiPymeDte
38
{
39
    /**
40
     * Obtiene documentos de DTE recibidos por un receptor.
41
     *
42
     * @param string $receptor RUT del receptor.
43
     * @param array $filtros Filtros adicionales para la consulta.
44
     * @return \Psr\Http\Message\ResponseInterface Documentos de DTE recibidos.
45
     */
46
    public function obtenerDtesRecibidos(string $receptor, array $filtros = [])
47
    {
48
        $url = sprintf(
49
            '/sii/mipyme/recibidos/documentos/%s',
50
            $receptor
51
        );
52
53
        $body = [
54
            'auth' => $this->getAuthPass(),
55
            'filtros' => $filtros,
56
        ];
57
        $response = $this->post($url, $body);
58
        return $response;
59
    }
60
61
    /**
62
     * Obtiene el PDF de un DTE recibido.
63
     *
64
     * @param string $receptor RUT del receptor.
65
     * @param string $emisor RUT del emisor.
66
     * @param string $dte Tipo de DTE o código del DTE recibido si no se pasa folio.
67
     * @param string $folio Número de folio del DTE (opcional).
68
     * @return \Psr\Http\Message\ResponseInterface Contenido del PDF del DTE recibido.
69
     */
70
    public function descargarPdfDteRecibido(
71
        string $receptor,
72
        string $emisor,
73
        string $dte,
74
        string $folio = null
75
    )
76
    {
77
        $url = $folio != null ? sprintf(
0 ignored issues
show
Bug introduced by
It seems like you are loosely comparing $folio of type null|string against null; this is ambiguous if the string can be empty. Consider using a strict comparison !== instead.
Loading history...
78
            '/sii/mipyme/recibidos/pdf/%s/%s/%s/%s',
79
            $receptor,
80
            $emisor,
81
            $dte,
82
            $folio
83
        ) : sprintf(
84
            '/sii/mipyme/recibidos/pdf/%s/%s/%s',
85
            $receptor,
86
            $emisor,
87
            $dte,
88
        );
89
90
        $body = [
91
            'auth' => $this->getAuthPass(),
92
        ];
93
        $response = $this->post($url, $body);
94
        return $response;
95
    }
96
97
    /**
98
     * Obtiene el XML de un DTE recibido.
99
     *
100
     * @param string $receptor RUT del receptor.
101
     * @param string $emisor RUT del emisor.
102
     * @param string $dte Tipo de DTE.
103
     * @param string $folio Número de folio del DTE.
104
     * @return \Psr\Http\Message\ResponseInterface Contenido del XML del
105
     * DTE recibido.
106
     */
107
    public function descargarXmlDteRecibido(
108
        string $receptor,
109
        string $emisor,
110
        string $dte,
111
        string $folio
112
    )
113
    {
114
        $url = sprintf(
115
            '/sii/mipyme/recibidos/xml/%s/%s/%s/%s',
116
            $receptor,
117
            $emisor,
118
            $dte,
119
            $folio
120
        );
121
122
        $body = [
123
            'auth' => $this->getAuthPass(),
124
        ];
125
        $response = $this->post($url, $body);
126
        return $response;
127
    }
128
}
129