libredte\lib\Core\Package\Billing\Component\Integration\Support\Response\SiiValidateDocumentResponse

Complexity

Total Complexity

11

Size/Duplication

Total Lines	174
Duplicated Lines	0 %

Test Coverage

Coverage

0%

Importance

Changes

0

2 Methods

Rating	Name	Duplication	Size	Complexity
A	parseEstado()	0	37	4
B	getData()	0	54	7

<?php

declare(strict_types=1);

/**
 * LibreDTE: Biblioteca PHP (Núcleo).
 * Copyright (C) LibreDTE <https://www.libredte.cl>
 *
 * Este programa es software libre: usted puede redistribuirlo y/o modificarlo
 * bajo los términos de la Licencia Pública General Affero de GNU 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 Licencia Pública
 * General Affero de GNU para obtener una información más detallada.
 *
 * Debería haber recibido una copia de la Licencia Pública General Affero de
 * GNU junto a este programa.
 *
 * En caso contrario, consulte <http://www.gnu.org/licenses/agpl.html>.
 */

namespace libredte\lib\Core\Package\Billing\Component\Integration\Support\Response;

use libredte\lib\Core\Package\Billing\Component\Integration\Abstract\AbstractSiiWsdlResponse;

/**
 * Respuesta con el estado de un DTE aceptado por el SII.
 *
 * Referencia: https://www.sii.cl/factura_electronica/factura_mercado/estado_dte.pdf
 */
class SiiValidateDocumentResponse extends AbstractSiiWsdlResponse
{
    /**
     * Estados de salida.
     *
     * El resultado de la consulta al SII puede arrojar uno de estos estados.
     */
    private const STATUSES = [
        'DOK' => 'Documento Recibido por el SII. Datos Coinciden con los Registrados.',
        'DNK' => 'Documento Recibido por el SII pero Datos NO Coinciden con los registrados.',
        'FAU' => 'Documento No Recibido por el SII.',
        'FNA' => 'Documento No Autorizado.',
        'FAN' => 'Documento Anulado.',
        'EMP' => 'Empresa no autorizada a Emitir Documentos Tributarios Electrónicos',
        'TMD' => 'Existe Nota de Débito que Modifica Texto Documento.',
        'TMC' => 'Existe Nota de Crédito que Modifica Textos Documento.',
        'MMD' => 'Existe Nota de Débito que Modifica Montos Documento.',
        'MMC' => 'Existe Nota de Crédito que Modifica Montos Documento.',
        'AND' => 'Existe Nota de Débito que Anula Documento',
        'ANC' => 'Existe Nota de Crédito que Anula Documento',
    ];

    /**
     * Estados de salida por ERROR.
     *
     * El resultado de la consulta al SII puede arrojar uno de estos estados de
     * error.
     */
    private const ERRORS = [
        // Otros Errores.
        'ESTADO' => [
            '-1' => 'ERROR: RETORNO CAMPO ESTADO',
            '-2' => 'ERROR RETORNO',
            '-3' => 'ERROR RETORNO',
            '-4' => 'ERROR RETORNO',
            //'OTRO' => 'No documentado.',
        ],
        // Errores por autenticación.
        'TOKEN' => [
            '001' => 'Cookie Inactivo (o token no existe)',
            '002' => 'Token Inactivo',
            '003' => 'Token No Existe',
        ],
        // Errores de consulta.
        'SRV_CODE' => [
            0 => 'Todo Ok',
            1 => 'Error en Entrada',
            2 => 'Error SQL',
        ],
        'SQL_CODE' => [
            0 => 'Schema Validado',
            //'OTRO' => 'Código de Oracle',
        ],
        'ERR_CODE' => [
            '0' => 'Documento Recibido por el SII. Datos Coinciden con los Registrados.',
            '1' => 'Documento Recibido por el SII pero Datos NO Coinciden con los registrados.',
            '3' => 'Documento No Recibido por el SII.',
            '4' => 'Documento No Autorizado.',
            '5' => 'Documento Anulado.',
            '6' => 'Empresa no autorizada a Emitir Documentos Tributarios Electrónicos',
            '10' => 'Existe Nota de Debito que Modifica Texto Documento.',
            '11' => 'Existe Nota de Crédito que Modifica Textos Documento.',
            '12' => 'Existe Nota de Debito que Modifica Montos Documento.',
            '13' => 'Existe Nota de Crédito que Modifica Montos Documento.',
            '14' => 'Existe Nota de Debito que Anula Documento',
            '15' => 'Existe Nota de Crédito que Anula Documento Otro Error Interno.',
            //'OTRO' => 'Error Interno.',
        ],
    ];

    /**
     * Obtiene los datos normalizados de la respuesta.
     *
     * @return array Datos normalizados de la respuesta del SII.
     */
    public function getData(): array
    {
        // Si no existen los datos normalizados de la respuesta se normalizan.
        if (!isset($this->data)) {
            // Si hay número de atención se normaliza.
            [$number, $datetime] = !empty($this->headers['NUM_ATENCION'])
                ? $this->parseNumeroAtencion($this->headers['NUM_ATENCION'])
                : null
            ;

            // RUT de la empresa emisora del documento.
            $rutExists = isset($this->requestData['RutCompania'])
                && isset($this->requestData['DvCompania'])
            ;
            $company = $rutExists
                ? $this->requestData['RutCompania']
                    . '-' . $this->requestData['DvCompania']
                : null
            ;

            // RUT del receptor del documento.
            $rutExists = isset($this->requestData['RutReceptor'])
                && isset($this->requestData['DvReceptor'])
            ;
            $recipient = $rutExists
                ? $this->requestData['RutReceptor']
                    . '-' . $this->requestData['DvReceptor']
                : null
            ;

            // Normalizar el estado de la consulta del envío.
            [$status, $received, $description] = $this->parseEstado(
                $this->headers
            );

            // Armar los datos normalizados.
            $this->data = [
                'query_number' => $number ?? null,
                'query_datetime' => $datetime ?? null,
                'company' => $company,
                'document' => $this->requestData['TipoDte'] ?? null,
                'number' => $this->requestData['FolioDte'] ?? null,
                'date' => $this->requestData['FechaEmisionDte'] ?? null,
                'total' => $this->requestData['MontoDte'] ?? null,
                'recipient' => $recipient,
                'status' => $status,
                'received' => $received,
                'description' => $description,
                'token' => $this->requestData['Token'] ?? null,
            ];
        }

        // Entregar los datos de la respuesta del estado del DTE.
        return $this->data;
    }

    /**
     * Parsea el estado de la respuesta del SII.
     *
     * @param array $headers Encabezados de la respuesta.
     * @return array Arreglo con el estado, error y descripción.
     */
    private function parseEstado(array $headers): array
    {
        // Asignar el código del estado y asumir que hubo error en la
        // validación del documento por parte del SII.
        $status = $headers['ESTADO'];
        $received = null;
        $description = null;

        // Verificar si el estado es uno de los estados "normales", o sea, no
        // es un estado de error en el envío. Se valida esto primero pues es lo
        // que normalmente debería entregar el SII en la respuesta.
        if (isset(self::STATUSES[$status])) {
            $received = !in_array($status[0], ['F', 'E']);
            $description = $headers['GLOSA_ERR'] ?? null;
        }

        // Si el estado es un error de token se asigna.
        elseif (isset(self::ERRORS['TOKEN'][$status])) {
            //$description = self::ERRORS['TOKEN'][$code];
            $description = $headers['GLOSA'] ?? null;
        }

        // El error es uno de los definidos como error de estado (excepto -11).
        elseif (isset(self::ERRORS['ESTADO'][$status])) {
            $description = self::ERRORS['ESTADO'][$status];
        }

        // El error es de estado pero no se tiene el código de error registrado.
        else {
            $description = sprintf(
                'Error desconocido código #%s al subir el XML.',
                $status
            );
        }

        // Entregar valores determinados para el error.
        return [$status, $received, $description];
    }
}