satcfdi.create.cfd.pago10.Traslado.__init__()   A
last analyzed

Complexity

Conditions 1

Size

Total Lines 12
Code Lines 11

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 1
CRAP Score 1.125

Importance

Changes 0
Metric Value
cc 1
eloc 11
nop 5
dl 0
loc 12
ccs 1
cts 2
cp 0.5
crap 1.125
rs 9.85
c 0
b 0
f 0
1
"""pago10 http://www.sat.gob.mx/Pagos"""
2 1
from collections.abc import *
3 1
from datetime import datetime
4 1
from decimal import Decimal
5
6 1
from ...cfdi import CFDI
7 1
from ...utils import ScalarMap
8 1
from ...utils import iterate
9
10
11 1
class Traslado(ScalarMap):
12
    """
13
    Nodo requerido para la información detallada de un traslado de impuesto específico.
14
15
    :param impuesto: Atributo requerido para señalar la clave del tipo de impuesto trasladado.
16
    :param tipo_factor: Atributo requerido para señalar la clave del tipo de factor que se aplica a la base del impuesto.
17
    :param tasa_o_cuota: Atributo requerido para señalar el valor de la tasa o cuota del impuesto que se traslada.
18
    :param importe: Atributo requerido para señalar el importe del impuesto trasladado. No se permiten valores negativos.
19
    """
20
21 1
    def __init__(
22
            self,
23
            impuesto: str,
24
            tipo_factor: str,
25
            tasa_o_cuota: Decimal | int,
26
            importe: Decimal | int,
27
    ):
28
        super().__init__({
29
            'Impuesto': impuesto,
30
            'TipoFactor': tipo_factor,
31
            'TasaOCuota': tasa_o_cuota,
32
            'Importe': importe,
33
        })
34
35
36 1
class Retencion(ScalarMap):
37
    """
38
    Nodo requerido para registrar la información detallada de una retención de impuesto específico.
39
40
    :param impuesto: Atributo requerido para señalar la clave del tipo de impuesto retenido.
41
    :param importe: Atributo requerido para señalar el importe o monto del impuesto retenido. No se permiten valores negativos.
42
    """
43
44 1
    def __init__(
45
            self,
46
            impuesto: str,
47
            importe: Decimal | int,
48
    ):
49
        super().__init__({
50
            'Impuesto': impuesto,
51
            'Importe': importe,
52
        })
53
54
55 1
class Impuestos(ScalarMap):
56
    """
57
    Nodo condicional para expresar el resumen de los impuestos aplicables cuando este documento sea un anticipo.
58
59
    :param total_impuestos_retenidos: Atributo condicional para expresar el total de los impuestos retenidos que se desprenden del pago. No se permiten valores negativos.
60
    :param total_impuestos_trasladados: Atributo condicional para expresar el total de los impuestos trasladados que se desprenden del pago. No se permiten valores negativos.
61
    :param retenciones: Nodo condicional para capturar los impuestos retenidos aplicables.
62
    :param traslados: Nodo condicional para capturar los impuestos trasladados aplicables.
63
    """
64
65 1
    def __init__(
66
            self,
67
            total_impuestos_retenidos: Decimal | int = None,
68
            total_impuestos_trasladados: Decimal | int = None,
69
            retenciones: Sequence[Retencion | dict] = None,
70
            traslados: Sequence[Traslado | dict] = None,
71
    ):
72
        super().__init__({
73
            'TotalImpuestosRetenidos': total_impuestos_retenidos,
74
            'TotalImpuestosTrasladados': total_impuestos_trasladados,
75
            'Retenciones': retenciones,
76
            'Traslados': traslados,
77
        })
78
79
80 1
class DoctoRelacionado(ScalarMap):
81
    """
82
    Nodo condicional para expresar la lista de documentos relacionados con los pagos diferentes de anticipos. Por cada documento que se relacione se debe generar un nodo DoctoRelacionado.
83
84
    :param id_documento: Atributo requerido para expresar el identificador del documento relacionado con el pago. Este dato puede ser un Folio Fiscal de la Factura Electrónica o bien el número de operación de un documento digital.
85
    :param moneda_dr: Atributo requerido para identificar la clave de la moneda utilizada en los importes del documento relacionado, cuando se usa moneda nacional o el documento relacionado no especifica la moneda se registra MXN. Los importes registrados en los atributos “ImpSaldoAnt”, “ImpPagado” e “ImpSaldoInsoluto” de éste nodo, deben corresponder a esta moneda. Conforme con la especificación ISO 4217.
86
    :param metodo_de_pago_dr: Atributo requerido para expresar la clave del método de pago que se registró en el documento relacionado.
87
    :param serie: Atributo opcional para precisar la serie del comprobante para control interno del contribuyente, acepta una cadena de caracteres.
88
    :param folio: Atributo opcional para precisar el folio del comprobante para control interno del contribuyente, acepta una cadena de caracteres.
89
    :param tipo_cambio_dr: Atributo condicional para expresar el tipo de cambio conforme con la moneda registrada en el documento relacionado. Es requerido cuando la moneda del documento relacionado es distinta de la moneda de pago. Se debe registrar el número de unidades de la moneda señalada en el documento relacionado que equivalen a una unidad de la moneda del pago. Por ejemplo: El documento relacionado se registra en USD El pago se realiza por 100 EUR. Este atributo se registra como 1.114700 USD/EUR. El importe pagado equivale a 100 EUR * 1.114700 USD/EUR = 111.47 USD.
90
    :param num_parcialidad: Atributo condicional para expresar el número de parcialidad que corresponde al pago. Es requerido cuando MetodoDePagoDR contiene: “PPD” Pago en parcialidades o diferido.
91
    :param imp_saldo_ant: Atributo condicional para expresar el monto del saldo insoluto de la parcialidad anterior. Es requerido cuando MetodoDePagoDR contiene: “PPD” Pago en parcialidades o diferido.En el caso de que sea la primer parcialidad este campo debe contener el importe total del documento relacionado.
92
    :param imp_pagado: Atributo condicional para expresar el importe pagado para el documento relacionado. Es obligatorio cuando exista más de un documento relacionado o cuando existe un documento relacionado y el TipoCambioDR tiene un valor.
93
    """
94
95 1
    def __init__(
96
            self,
97
            id_documento: str,
98
            moneda_dr: str,
99
            metodo_de_pago_dr: str,
100
            serie: str = None,
101
            folio: str = None,
102
            tipo_cambio_dr: Decimal | int = None,
103
            num_parcialidad: int = None,
104
            imp_saldo_ant: Decimal | int = None,
105
            imp_pagado: Decimal | int = None,
106
    ):
107
        super().__init__({
108
            'IdDocumento': id_documento,
109
            'MonedaDR': moneda_dr,
110
            'MetodoDePagoDR': metodo_de_pago_dr,
111
            'Serie': serie,
112
            'Folio': folio,
113
            'TipoCambioDR': tipo_cambio_dr,
114
            'NumParcialidad': num_parcialidad,
115
            'ImpSaldoAnt': imp_saldo_ant,
116
            'ImpPagado': imp_pagado
117
        })
118
119
120 1 View Code Duplication
class Pago(ScalarMap):
0 ignored issues
show
Duplication introduced by
This code seems to be duplicated in your project.
Loading history...
121
    """
122
    Elemento requerido para incorporar la información de la recepción de pagos.
123
124
    :param fecha_pago: Atributo requerido para expresar la fecha y hora en la que el beneficiario recibe el pago. Se expresa en la forma aaaa-mm-ddThh:mm:ss, de acuerdo con la especificación ISO 8601.En caso de no contar con la hora se debe registrar 12:00:00.
125
    :param forma_de_pago_p: Atributo requerido para expresar la clave de la forma en que se realiza el pago.
126
    :param moneda_p: Atributo requerido para identificar la clave de la moneda utilizada para realizar el pago, cuando se usa moneda nacional se registra MXN. El atributo Pagos:Pago:Monto y los atributos TotalImpuestosRetenidos, TotalImpuestosTrasladados, Traslados:Traslado:Importe y Retenciones:Retencion:Importe del nodo Pago:Impuestos deben ser expresados en esta moneda. Conforme con la especificación ISO 4217.
127
    :param tipo_cambio_p: Atributo condicional para expresar el tipo de cambio de la moneda a la fecha en que se realizó el pago. El valor debe reflejar el número de pesos mexicanos que equivalen a una unidad de la divisa señalada en el atributo MonedaP. Es requerido cuando el atributo MonedaP es diferente a MXN.
128
    :param num_operacion: Atributo condicional para expresar el número de cheque, número de autorización, número de referencia, clave de rastreo en caso de ser SPEI, línea de captura o algún número de referencia análogo que identifique la operación que ampara el pago efectuado
129
    :param rfc_emisor_cta_ord: Atributo condicional para expresar la clave RFC de la entidad emisora de la cuenta origen, es decir, la operadora, el banco, la institución financiera, emisor de monedero electrónico, etc., en caso de ser extranjero colocar XEXX010101000, considerar las reglas de obligatoriedad publicadas en la página del SAT para éste atributo de acuerdo con el catálogo catCFDI:c_FormaPago.
130
    :param nom_banco_ord_ext: Atributo condicional para expresar el nombre del banco ordenante, es requerido en caso de ser extranjero. Considerar las reglas de obligatoriedad publicadas en la página del SAT para éste atributo de acuerdo con el catálogo catCFDI:c_FormaPago.
131
    :param cta_ordenante: Atributo condicional para incorporar el número de la cuenta con la que se realizó el pago. Considerar las reglas de obligatoriedad publicadas en la página del SAT para éste atributo de acuerdo con el catálogo catCFDI:c_FormaPago
132
    :param rfc_emisor_cta_ben: Atributo condicional para expresar la clave RFC de la entidad operadora de la cuenta destino, es decir, la operadora, el banco, la institución financiera, emisor de monedero electrónico, etc. Considerar las reglas de obligatoriedad publicadas en la página del SAT para éste atributo de acuerdo con el catálogo catCFDI:c_FormaPago.
133
    :param cta_beneficiario: Atributo condicional para incorporar el número de cuenta en donde se recibió el pago. Considerar las reglas de obligatoriedad publicadas en la página del SAT para éste atributo de acuerdo con el catálogo catCFDI:c_FormaPago.
134
    :param tipo_cad_pago: Atributo condicional para identificar la clave del tipo de cadena de pago que genera la entidad receptora del pago. Considerar las reglas de obligatoriedad publicadas en la página del SAT para éste atributo de acuerdo con el catálogo catCFDI:c_FormaPago.
135
    :param cert_pago: Atributo condicional que sirve para incorporar el certificado que ampara al pago, como una cadena de texto en formato base 64. Es requerido en caso de que el atributo TipoCadPago contenga información.
136
    :param cad_pago: Atributo condicional para expresar la cadena original del comprobante de pago generado por la entidad emisora de la cuenta beneficiaria. Es requerido en caso de que el atributo TipoCadPago contenga información.
137
    :param sello_pago: Atributo condicional para integrar el sello digital que se asocie al pago. La entidad que emite el comprobante de pago, ingresa una cadena original y el sello digital en una sección de dicho comprobante, este sello digital es el que se debe registrar en este campo. Debe ser expresado como una cadena de texto en formato base 64. Es requerido en caso de que el atributo TipoCadPago contenga información.
138
    :param docto_relacionado: Nodo condicional para expresar la lista de documentos relacionados con los pagos diferentes de anticipos. Por cada documento que se relacione se debe generar un nodo DoctoRelacionado.
139
    :param impuestos: Nodo condicional para expresar el resumen de los impuestos aplicables cuando este documento sea un anticipo.
140
    """
141
142 1
    def __init__(
143
            self,
144
            fecha_pago: datetime,
145
            forma_de_pago_p: str,
146
            moneda_p: str,
147
            tipo_cambio_p: Decimal | int = None,
148
            num_operacion: str = None,
149
            rfc_emisor_cta_ord: str = None,
150
            nom_banco_ord_ext: str = None,
151
            cta_ordenante: str = None,
152
            rfc_emisor_cta_ben: str = None,
153
            cta_beneficiario: str = None,
154
            tipo_cad_pago: str = None,
155
            cert_pago: str = None,
156
            cad_pago: str = None,
157
            sello_pago: str = None,
158
            docto_relacionado: Sequence[DoctoRelacionado | dict] = None,
159
            impuestos: Sequence[Impuestos | dict] = None,
160
    ):
161
        super().__init__({
162
            'FechaPago': fecha_pago,
163
            'FormaDePagoP': forma_de_pago_p,
164
            'MonedaP': moneda_p,
165
            'TipoCambioP': tipo_cambio_p,
166
            'NumOperacion': num_operacion,
167
            'RfcEmisorCtaOrd': rfc_emisor_cta_ord,
168
            'NomBancoOrdExt': nom_banco_ord_ext,
169
            'CtaOrdenante': cta_ordenante,
170
            'RfcEmisorCtaBen': rfc_emisor_cta_ben,
171
            'CtaBeneficiario': cta_beneficiario,
172
            'TipoCadPago': tipo_cad_pago,
173
            'CertPago': cert_pago,
174
            'CadPago': cad_pago,
175
            'SelloPago': sello_pago,
176
            'DoctoRelacionado': docto_relacionado,
177
            'Impuestos': impuestos,
178
        })
179
180
181 1
class Pagos(CFDI):
182
    """
183
    Complemento para el Comprobante Fiscal Digital por Internet (CFDI) para registrar información sobre la recepción de pagos. El emisor de este complemento para recepción de pagos debe ser quien las leyes le obligue a expedir comprobantes por los actos o actividades que realicen, por los ingresos que se perciban o por las retenciones de contribuciones que efectúen.
184
185
    :param pago: Elemento requerido para incorporar la información de la recepción de pagos.
186
    """
187
188 1
    tag = '{http://www.sat.gob.mx/Pagos}Pagos'
189 1
    version = '1.0'
190
191 1
    def __init__(
192
            self,
193
            pago: Pago | Sequence[Pago | dict],
194
    ):
195 1
        for p in iterate(pago):
196 1
            docto_relacionado = p['DoctoRelacionado']
197 1
            for d in iterate(docto_relacionado):
198 1
                d['ImpSaldoInsoluto'] = d['ImpSaldoAnt'] - d['ImpPagado']
199
200 1
            p['Monto'] = sum(c["ImpPagado"] for c in docto_relacionado)
201
202 1
        super().__init__({
203
            'Version': self.version,
204
            'Pago': pago,
205
        })
206