Entidades de Documentos

LibreDTE Core proporciona un conjunto de entidades para trabajar con documentos tributarios electrónicos y sus elementos relacionados. Estas entidades representan los diferentes aspectos del sistema de facturación electrónica chileno.

Entidades Principales

TipoDocumento

La entidad central que representa un tipo de documento tributario.

use libredte\lib\Core\Package\Billing\Component\Document\Entity\TipoDocumento;

Propiedades principales:

codigo: Código oficial del SII (int|string)
nombre: Nombre completo del documento
nombre_corto: Nombre corto del documento
categoria: Categoría del documento (CategoriaDocumento enum)
electronico: Si es un documento electrónico (bool)
enviar: Si se debe enviar al SII (bool)
compra: Si está disponible para compras (bool)
venta: Si está disponible para ventas (bool)
operacion: Tipo de operación en libros (OperacionDocumento enum)
cedible: Si el documento puede ser cedido (bool)
tag_xml: Tag XML del documento (TagXmlDocumento enum)
alias: Código técnico interno
interface: Interfaz PHP asociada

Métodos destacados:

getCodigo(): Obtiene el código del documento
getNombre(): Obtiene el nombre completo
getNombreCorto(): Obtiene el nombre corto
esElectronico(): Verifica si es electrónico
seEnviaAlSii(): Verifica si se envía al SII
esGuiaDespacho(): Verifica si es guía de despacho
esBoleta(): Verifica si es boleta
esExportacion(): Verifica si es documento de exportación
esExento(): Verifica si es documento exento
getDefaultTasaIVA(): Obtiene la tasa de IVA por defecto

Ejemplo:

$tipoDoc = new TipoDocumento(33, 'Factura electrónica', 'Factura');

if ($tipoDoc->esElectronico() && $tipoDoc->seEnviaAlSii()) {
    echo "Este documento debe ser enviado al SII\n";
}

$tasa = $tipoDoc->getDefaultTasaIVA();
if ($tasa !== false) {
    echo "Tasa de IVA: {$tasa}%\n";
}

Entidades de Configuración

FormaPago

Representa una forma de pago utilizada en los documentos.

use libredte\lib\Core\Package\Billing\Component\Document\Entity\FormaPago;

Extiende de Derafu\Repository\Entity y proporciona acceso a los atributos de configuración de formas de pago. Ejemplo:

$formaPago = new FormaPago();
echo $formaPago; // Imprime la glosa de la forma de pago

MedioPago

Representa un medio de pago específico.

use libredte\lib\Core\Package\Billing\Component\Document\Entity\MedioPago;

Similar a FormaPago, extiende de Derafu\Repository\Entity. Ejemplo:

$medioPago = new MedioPago();
echo $medioPago; // Imprime la glosa del medio de pago

FormaPagoExportacion

Forma de pago específica para documentos de exportación.

use libredte\lib\Core\Package\Billing\Component\Document\Entity\FormaPagoExportacion;

ImpuestoAdicionalRetencion

Representa impuestos adicionales y retenciones aplicables a los documentos.

use libredte\lib\Core\Package\Billing\Component\Document\Entity\ImpuestoAdicionalRetencion;

Entidades de Despacho y Logística

Traslado

Información sobre el traslado de mercancías en guías de despacho.

use libredte\lib\Core\Package\Billing\Component\Document\Entity\Traslado;

SobreEnvio

Representa el sobre de envío de documentos electrónicos al SII.

use libredte\lib\Core\Package\Billing\Component\Document\Entity\SobreEnvio;

TagXml

Define los tags XML utilizados en los documentos electrónicos.

use libredte\lib\Core\Package\Billing\Component\Document\Entity\TagXml;

Entidades Geográficas

Comuna

Representa las comunas (municipios) de Chile.

use libredte\lib\Core\Package\Billing\Component\Document\Entity\Comuna;

Entidades de Aduana (Exportación)

Para documentos de exportación, se incluyen varias entidades relacionadas con trámites aduaneros:

AduanaUnidad

Unidades de medida para comercio internacional.

use libredte\lib\Core\Package\Billing\Component\Document\Entity\AduanaUnidad;

AduanaTransporte

Medios de transporte internacional.

use libredte\lib\Core\Package\Billing\Component\Document\Entity\AduanaTransporte;

AduanaTipoBulto

Tipos de bultos o embalajes.

use libredte\lib\Core\Package\Billing\Component\Document\Entity\AduanaTipoBulto;

AduanaPuerto

Puertos de embarque/desembarque.

use libredte\lib\Core\Package\Billing\Component\Document\Entity\AduanaPuerto;

AduanaPais

Países para operaciones de exportación.

use libredte\lib\Core\Package\Billing\Component\Document\Entity\AduanaPais;

AduanaMoneda

Monedas utilizadas en operaciones internacionales.

use libredte\lib\Core\Package\Billing\Component\Document\Entity\AduanaMoneda;

AduanaModalidadVenta

Modalidades de venta internacional.

use libredte\lib\Core\Package\Billing\Component\Document\Entity\AduanaModalidadVenta;

AduanaFormaPago

Formas de pago para operaciones de exportación.

use libredte\lib\Core\Package\Billing\Component\Document\Entity\AduanaFormaPago;

AduanaClausulaVenta

Cláusulas de venta internacional (INCOTERMS).

use libredte\lib\Core\Package\Billing\Component\Document\Entity\AduanaClausulaVenta;