Passed
Push — main ( 7535b2...286971 )
by Sat CFDI
05:34
created

satcfdi.create.cfd.cfdi33.Retencion.__init__()   A

Complexity

Conditions 1

Size

Total Lines 14
Code Lines 13

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 2
CRAP Score 1

Importance

Changes 0
Metric Value
cc 1
eloc 13
nop 6
dl 0
loc 14
ccs 2
cts 2
cp 1
crap 1
rs 9.75
c 0
b 0
f 0
1
"""cfdi http://www.sat.gob.mx/cfd/3"""
2 1
from collections.abc import *
3 1
from decimal import Decimal
4
5 1
from satcfdi.create.cfd.catalogos import Impuesto as CatImpuesto
6 1
from . import cfdi40, pago10
7 1
from ...cfdi import CFDI
8 1
from ...utils import ScalarMap
9
10
11 1
class CfdiRelacionados(ScalarMap):
12
    """
13
    Nodo opcional para precisar la información de los comprobantes relacionados.
14
15
    :param tipo_relacion: Atributo requerido para indicar la clave de la relación que existe entre éste que se esta generando y el o los CFDI previos.
16
    :param cfdi_relacionado: Nodo requerido para precisar la información de los comprobantes relacionados.
17
    """
18
19 1
    def __init__(
20
            self,
21
            tipo_relacion: str,
22
            cfdi_relacionado: str | Sequence[str],
23
    ):
24
        super().__init__({
25
            'TipoRelacion': tipo_relacion,
26
            'CfdiRelacionado': cfdi_relacionado,
27
        })
28
29
30 1 View Code Duplication
class Parte(ScalarMap):
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated in your project.
Loading history...
31
    """
32
    Nodo opcional para expresar las partes o componentes que integran la totalidad del concepto expresado en el comprobante fiscal digital por Internet.
33
34
    :param clave_prod_serv: Atributo requerido para expresar la clave del producto o del servicio amparado por la presente parte. Es requerido y deben utilizar las claves del catálogo de productos y servicios, cuando los conceptos que registren por sus actividades correspondan con dichos conceptos.
35
    :param cantidad: Atributo requerido para precisar la cantidad de bienes o servicios del tipo particular definido por la presente parte.
36
    :param descripcion: Atributo requerido para precisar la descripción del bien o servicio cubierto por la presente parte.
37
    :param no_identificacion: Atributo opcional para expresar el número de serie, número de parte del bien o identificador del producto o del servicio amparado por la presente parte. Opcionalmente se puede utilizar claves del estándar GTIN.
38
    :param unidad: Atributo opcional para precisar la unidad de medida propia de la operación del emisor, aplicable para la cantidad expresada en la parte. La unidad debe corresponder con la descripción de la parte.
39
    :param valor_unitario: Atributo opcional para precisar el valor o precio unitario del bien o servicio cubierto por la presente parte. No se permiten valores negativos.
40
    :param importe: Atributo opcional para precisar el importe total de los bienes o servicios de la presente parte. Debe ser equivalente al resultado de multiplicar la cantidad por el valor unitario expresado en la parte. No se permiten valores negativos.
41
    :param informacion_aduanera: Nodo opcional para introducir la información aduanera aplicable cuando se trate de ventas de primera mano de mercancías importadas o se trate de operaciones de comercio exterior con bienes o servicios.
42
    """
43
44 1
    def __init__(
45
            self,
46
            clave_prod_serv: str,
47
            cantidad: Decimal | int,
48
            descripcion: str,
49
            no_identificacion: str = None,
50
            unidad: str = None,
51
            valor_unitario: Decimal | int = None,
52
            importe: Decimal | int = None,
53
            informacion_aduanera: str | Sequence[str] = None,
54
    ):
55
        super().__init__({
56
            'ClaveProdServ': clave_prod_serv,
57
            'Cantidad': cantidad,
58
            'Descripcion': descripcion,
59
            'NoIdentificacion': no_identificacion,
60
            'Unidad': unidad,
61
            'ValorUnitario': valor_unitario,
62
            'Importe': importe,
63
            'InformacionAduanera': informacion_aduanera,
64
        })
65
66
67 1
def _find_impuesto(impuesto):
68 1
    try:
69 1
        return CatImpuesto[impuesto]
70 1
    except KeyError:
71 1
        return impuesto
72
73
74 1
class Traslado(ScalarMap):
75
    """
76
    Nodo requerido para la información detallada de un traslado de impuesto específico.
77
78
    :param base: Atributo requerido para señalar la suma de los atributos Base de los conceptos del impuesto trasladado. No se permiten valores negativos.
79
    :param impuesto: Atributo requerido para señalar la clave del tipo de impuesto retencion.
80
    :param tipo_factor: Atributo requerido para señalar la clave del tipo de factor que se aplica a la base del impuesto.
81
    :param tasa_o_cuota: Atributo condicional para señalar el valor de la tasa o cuota del impuesto que se traslada por los conceptos amparados en el comprobante.
82
    :param importe: Atributo condicional para señalar la suma del importe del impuesto trasladado, agrupado por impuesto, TipoFactor y TasaOCuota. No se permiten valores negativos.
83
    """
84
85 1
    def __init__(
86
            self,
87
            impuesto: str,
88
            tipo_factor: str,
89
            tasa_o_cuota: Decimal | int = None,
90
            importe: Decimal | int = None,
91
            base: Decimal | int = None,
92
    ):
93 1
        super().__init__({
94
            'Base': base,
95
            'Impuesto': _find_impuesto(impuesto),
96
            'TipoFactor': tipo_factor,
97
            'TasaOCuota': tasa_o_cuota,
98
            'Importe': importe,
99
        })
100
101
102 1
class Retencion(ScalarMap):
103
    """
104
    Nodo requerido para la información detallada de un traslado de impuesto específico.
105
106
    :param base: Atributo requerido para señalar la suma de los atributos Base de los conceptos del impuesto trasladado. No se permiten valores negativos.
107
    :param impuesto: Atributo requerido para señalar la clave del tipo de impuesto retencion.
108
    :param tipo_factor: Atributo requerido para señalar la clave del tipo de factor que se aplica a la base del impuesto.
109
    :param tasa_o_cuota: Atributo condicional para señalar el valor de la tasa o cuota del impuesto que se traslada por los conceptos amparados en el comprobante.
110
    :param importe: Atributo condicional para señalar la suma del importe del impuesto trasladado, agrupado por impuesto, TipoFactor y TasaOCuota. No se permiten valores negativos.
111
    """
112
113 1
    def __init__(
114
            self,
115
            impuesto: str,
116
            tipo_factor: str,
117
            tasa_o_cuota: Decimal | int = None,
118
            importe: Decimal | int = None,
119
            base: Decimal | int = None,
120
    ):
121 1
        super().__init__({
122
            'Base': base,
123
            'Impuesto': _find_impuesto(impuesto),
124
            'TipoFactor': tipo_factor,
125
            'TasaOCuota': tasa_o_cuota,
126
            'Importe': importe,
127
        })
128
129
130 1 View Code Duplication
class Impuestos(ScalarMap):
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated in your project.
Loading history...
131
    """
132
    Nodo condicional para expresar el resumen de los impuestos aplicables.
133
134
    :param retenciones: Nodo condicional para capturar los impuestos retenidos aplicables. Es requerido cuando en los conceptos se registre algún impuesto retenido.
135
    :param traslados: Nodo condicional para capturar los impuestos trasladados aplicables. Es requerido cuando en los conceptos se registre un impuesto trasladado.
136
    """
137
138 1
    def __init__(
139
            self,
140
            retenciones: Retencion | dict | str | Sequence[Retencion | dict | str] = None,
141
            traslados: Traslado | dict | str | Sequence[Traslado | dict | str] = None,
142
    ):
143 1
        super().__init__({
144
            'Retenciones': retenciones,
145
            'Traslados': traslados,
146
        })
147
148
149 1
class Concepto(ScalarMap):
150
    """
151
    Nodo requerido para registrar la información detallada de un bien o servicio amparado en el comprobante.
152
153
    :param clave_prod_serv: Atributo requerido para expresar la clave del producto o del servicio amparado por el presente concepto. Es requerido y deben utilizar las claves del catálogo de productos y servicios, cuando los conceptos que registren por sus actividades correspondan con dichos conceptos.
154
    :param cantidad: Atributo requerido para precisar la cantidad de bienes o servicios del tipo particular definido por el presente concepto.
155
    :param clave_unidad: Atributo requerido para precisar la clave de unidad de medida estandarizada aplicable para la cantidad expresada en el concepto. La unidad debe corresponder con la descripción del concepto.
156
    :param descripcion: Atributo requerido para precisar la descripción del bien o servicio cubierto por el presente concepto.
157
    :param valor_unitario: Atributo requerido para precisar el valor o precio unitario del bien o servicio cubierto por el presente concepto.
158
    :param no_identificacion: Atributo opcional para expresar el número de parte, identificador del producto o del servicio, la clave de producto o servicio, SKU o equivalente, propia de la operación del emisor, amparado por el presente concepto. Opcionalmente se puede utilizar claves del estándar GTIN.
159
    :param unidad: Atributo opcional para precisar la unidad de medida propia de la operación del emisor, aplicable para la cantidad expresada en el concepto. La unidad debe corresponder con la descripción del concepto.
160
    :param descuento: Atributo opcional para representar el importe de los descuentos aplicables al concepto. No se permiten valores negativos.
161
    :param informacion_aduanera: Nodo opcional para introducir la información aduanera aplicable cuando se trate de ventas de primera mano de mercancías importadas o se trate de operaciones de comercio exterior con bienes o servicios.
162
    :param cuenta_predial: Nodo opcional para asentar el número de cuenta predial con el que fue registrado el inmueble, en el sistema catastral de la entidad federativa de que trate, o bien para incorporar los datos de identificación del certificado de participación inmobiliaria no amortizable.
163
    :param complemento_concepto: Nodo opcional donde se incluyen los nodos complementarios de extensión al concepto definidos por el SAT, de acuerdo con las disposiciones particulares para un sector o actividad específica.
164
    :param parte: Nodo opcional para expresar las partes o componentes que integran la totalidad del concepto expresado en el comprobante fiscal digital por Internet.
165
    :param _traslados_incluidos: si el valor valor_unitario ya incluye traslados.
166
    """
167
168 1
    def __init__(
169
            self,
170
            clave_prod_serv: str,
171
            cantidad: Decimal | int,
172
            clave_unidad: str,
173
            descripcion: str,
174
            valor_unitario: Decimal | int,
175
            no_identificacion: str = None,
176
            unidad: str = None,
177
            descuento: Decimal | int = None,
178
            impuestos: Impuestos | dict = None,
179
            informacion_aduanera: str | Sequence[str] = None,
180
            cuenta_predial: str = None,
181
            complemento_concepto: Sequence[CFDI] = None,
182
            parte: Sequence[Parte | dict] = None,
183
            _traslados_incluidos: bool = False
184
    ):
185 1
        super().__init__({
186
            'ClaveProdServ': clave_prod_serv,
187
            'Cantidad': cantidad,
188
            'ClaveUnidad': clave_unidad,
189
            'Descripcion': descripcion,
190
            'ValorUnitario': valor_unitario,
191
            'NoIdentificacion': no_identificacion,
192
            'Unidad': unidad,
193
            'Descuento': descuento,
194
            'Impuestos': impuestos,
195
            'InformacionAduanera': informacion_aduanera,
196
            'CuentaPredial': cuenta_predial,
197
            'ComplementoConcepto': complemento_concepto,
198
            'Parte': parte,
199
            '_traslados_incluidos': _traslados_incluidos
200
        })
201
202
203 1
class Receptor(ScalarMap):
204
    """
205
    Nodo requerido para precisar la información del contribuyente receptor del comprobante.
206
207
    :param rfc: Atributo requerido para precisar la Clave del Registro Federal de Contribuyentes correspondiente al contribuyente receptor del comprobante.
208
    :param uso_cfdi: Atributo requerido para expresar la clave del uso que dará a esta factura el receptor del CFDI.
209
    :param nombre: Atributo opcional para precisar el nombre, denominación o razón social del contribuyente receptor del comprobante.
210
    :param residencia_fiscal: Atributo condicional para registrar la clave del país de residencia para efectos fiscales del receptor del comprobante, cuando se trate de un extranjero, y que es conforme con la especificación ISO 3166-1 alpha-3. Es requerido cuando se incluya el complemento de comercio exterior o se registre el atributo NumRegIdTrib.
211
    :param num_reg_id_trib: Atributo condicional para expresar el número de registro de identidad fiscal del receptor cuando sea residente en el extranjero. Es requerido cuando se incluya el complemento de comercio exterior.
212
    """
213
214 1
    def __init__(
215
            self,
216
            rfc: str,
217
            uso_cfdi: str,
218
            nombre: str = None,
219
            residencia_fiscal: str = None,
220
            num_reg_id_trib: str = None,
221
    ):
222 1
        super().__init__({
223
            'Rfc': rfc,
224
            'UsoCFDI': uso_cfdi,
225
            'Nombre': nombre,
226
            'ResidenciaFiscal': residencia_fiscal,
227
            'NumRegIdTrib': num_reg_id_trib,
228
        })
229
230
231 1
class Emisor(ScalarMap):
232
    """
233
    Nodo requerido para expresar la información del contribuyente emisor del comprobante.
234
235
    :param rfc: Atributo requerido para registrar la Clave del Registro Federal de Contribuyentes correspondiente al contribuyente emisor del comprobante.
236
    :param regimen_fiscal: Atributo requerido para incorporar la clave del régimen del contribuyente emisor al que aplicará el efecto fiscal de este comprobante.
237
    :param nombre: Atributo opcional para registrar el nombre, denominación o razón social del contribuyente emisor del comprobante.
238
    """
239
240 1
    def __init__(
241
            self,
242
            rfc: str,
243
            regimen_fiscal: str,
244
            nombre: str = None,
245
    ):
246 1
        super().__init__({
247
            'Rfc': rfc,
248
            'RegimenFiscal': regimen_fiscal,
249
            'Nombre': nombre,
250
        })
251
252
253 1
class Comprobante(cfdi40.Comprobante):
254 1
    tag = '{http://www.sat.gob.mx/cfd/3}Comprobante'
255 1
    version = '3.3'
256
    complemento_pago = pago10.Pagos
257