satcfdi.create.cfd.pago20.ImpuestosDR.__init__()   A
last analyzed

Complexity

Conditions 1

Size

Total Lines 8
Code Lines 7

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 1
CRAP Score 1.125

Importance

Changes 0
Metric Value
cc 1
eloc 7
nop 3
dl 0
loc 8
ccs 1
cts 2
cp 0.5
crap 1.125
rs 10
c 0
b 0
f 0
1
"""pago20 http://www.sat.gob.mx/Pagos20"""
2 1
from collections.abc import *
3 1
from datetime import datetime
4 1
from decimal import Decimal
5
6 1
from ..compute import make_impuestos_p, make_pago_totales
7 1
from ...utils import iterate
8 1
from ...cfdi import CFDI
9 1
from ...utils import ScalarMap
10
11
12 1
class TrasladoDR(ScalarMap):
13
    """
14
    Nodo requerido para asentar la información detallada de un traslado de impuesto específico conforme al monto del pago recibido.
15
16
    :param base_dr: Atributo requerido para señalar la base para el cálculo del impuesto trasladado conforme al monto del pago, aplicable al documento relacionado, la determinación de la base se realiza de acuerdo con las disposiciones fiscales vigentes. No se permiten valores negativos.
17
    :param impuesto_dr: Atributo requerido para señalar la clave del tipo de impuesto trasladado conforme al monto del pago, aplicable al documento relacionado.
18
    :param tipo_factor_dr: Atributo requerido para señalar la clave del tipo de factor que se aplica a la base del impuesto.
19
    :param tasa_o_cuota_dr: Atributo condicional para señalar el valor de la tasa o cuota del impuesto que se traslada. Es requerido cuando el atributo TipoFactorDR contenga una clave que corresponda a Tasa o Cuota.
20
    :param importe_dr: Atributo condicional para señalar el importe del impuesto trasladado conforme al monto del pago, aplicable al documento relacionado. No se permiten valores negativos. Es requerido cuando el tipo factor sea Tasa o Cuota.
21
    """
22
23 1
    def __init__(
24
            self,
25
            base_dr: Decimal | int,
26
            impuesto_dr: str,
27
            tipo_factor_dr: str,
28
            tasa_o_cuota_dr: Decimal | int = None,
29
            importe_dr: Decimal | int = None,
30
    ):
31
        super().__init__({
32
            'BaseDR': base_dr,
33
            'ImpuestoDR': impuesto_dr,
34
            'TipoFactorDR': tipo_factor_dr,
35
            'TasaOCuotaDR': tasa_o_cuota_dr,
36
            'ImporteDR': importe_dr,
37
        })
38
        
39
40 1
class RetencionDR(ScalarMap):
41
    """
42
    Nodo requerido para registrar la información detallada de una retención de impuesto específico conforme al monto del pago recibido.
43
44
    :param base_dr: Atributo requerido para señalar la base para el cálculo de la retención conforme al monto del pago, aplicable al documento relacionado, la determinación de la base se realiza de acuerdo con las disposiciones fiscales vigentes. No se permiten valores negativos.
45
    :param impuesto_dr: Atributo requerido para señalar la clave del tipo de impuesto retenido conforme al monto del pago, aplicable al documento relacionado.
46
    :param tipo_factor_dr: Atributo requerido para señalar la clave del tipo de factor que se aplica a la base del impuesto.
47
    :param tasa_o_cuota_dr: Atributo requerido para señalar el valor de la tasa o cuota del impuesto que se retiene.
48
    :param importe_dr: Atributo requerido para señalar el importe del impuesto retenido conforme al monto del pago, aplicable al documento relacionado. No se permiten valores negativos.
49
    """
50
51 1
    def __init__(
52
            self,
53
            base_dr: Decimal | int,
54
            impuesto_dr: str,
55
            tipo_factor_dr: str,
56
            tasa_o_cuota_dr: Decimal | int,
57
            importe_dr: Decimal | int,
58
    ):
59
        super().__init__({
60
            'BaseDR': base_dr,
61
            'ImpuestoDR': impuesto_dr,
62
            'TipoFactorDR': tipo_factor_dr,
63
            'TasaOCuotaDR': tasa_o_cuota_dr,
64
            'ImporteDR': importe_dr,
65
        })
66
        
67
68 1
class ImpuestosDR(ScalarMap):
69
    """
70
    Nodo condicional para registrar los impuestos aplicables conforme al monto del pago recibido, expresados a la moneda del documento relacionado.
71
72
    :param retenciones_dr: Nodo opcional para capturar los impuestos retenidos aplicables conforme al monto del pago recibido.
73
    :param traslados_dr: Nodo opcional para capturar los impuestos trasladados aplicables conforme al monto del pago recibido.
74
    """
75
76 1
    def __init__(
77
            self,
78
            retenciones_dr: Sequence[RetencionDR | dict] = None,
79
            traslados_dr: Sequence[TrasladoDR | dict] = None,
80
    ):
81
        super().__init__({
82
            'RetencionesDR': retenciones_dr,
83
            'TrasladosDR': traslados_dr,
84
        })
85
        
86
87 1
class DoctoRelacionado(ScalarMap):
88
    """
89
    Nodo requerido para expresar la lista de documentos relacionados con los pagos. Por cada documento que se relacione se debe generar un nodo DoctoRelacionado.
90
91
    :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.
92
    :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.
93
    :param num_parcialidad: Atributo requerido para expresar el número de parcialidad que corresponde al pago.
94
    :param imp_saldo_ant: Atributo requerido para expresar el monto del saldo insoluto de la parcialidad anterior. En el caso de que sea la primer parcialidad este atributo debe contener el importe total del documento relacionado.
95
    :param imp_pagado: Atributo requerido para expresar el importe pagado para el documento relacionado.
96
    :param objeto_imp_dr: Atributo requerido para expresar si el pago del documento relacionado es objeto o no de impuesto.
97
    :param serie: Atributo opcional para precisar la serie del comprobante para control interno del contribuyente, acepta una cadena de caracteres.
98
    :param folio: Atributo opcional para precisar el folio del comprobante para control interno del contribuyente, acepta una cadena de caracteres.
99
    :param equivalencia_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.
100
    :param impuestos_dr: Nodo condicional para registrar los impuestos aplicables conforme al monto del pago recibido, expresados a la moneda del documento relacionado.
101
    """
102
103 1
    def __init__(
104
            self,
105
            id_documento: str,
106
            moneda_dr: str,
107
            num_parcialidad: int,
108
            imp_saldo_ant: Decimal | int,
109
            imp_pagado: Decimal | int,
110
            objeto_imp_dr: str,
111
            serie: str = None,
112
            folio: str = None,
113
            equivalencia_dr: Decimal | int = None,
114
            impuestos_dr: ImpuestosDR | dict = None,
115
    ):
116 1
        super().__init__({
117
            'IdDocumento': id_documento,
118
            'MonedaDR': moneda_dr,
119
            'NumParcialidad': num_parcialidad,
120
            'ImpSaldoAnt': imp_saldo_ant,
121
            'ImpPagado': imp_pagado,
122
            'ObjetoImpDR': objeto_imp_dr,
123
            'Serie': serie,
124
            'Folio': folio,
125
            'EquivalenciaDR': equivalencia_dr,
126
            'ImpuestosDR': impuestos_dr,
127
        })
128
        
129
130 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...
131
    """
132
    Elemento requerido para incorporar la información de la recepción de pagos.
133
134
    :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.
135
    :param forma_de_pago_p: Atributo requerido para expresar la clave de la forma en que se realiza el pago.
136
    :param moneda_p: Atributo requerido para identificar la clave de la moneda utilizada para realizar el pago conforme a la especificación ISO 4217. Cuando se usa moneda nacional se registra MXN. El atributo Pagos:Pago:Monto debe ser expresado en la moneda registrada en este atributo.
137
    :param monto: Atributo requerido para expresar el importe del pago.
138
    :param docto_relacionado: Nodo requerido para expresar la lista de documentos relacionados con los pagos. Por cada documento que se relacione se debe generar un nodo DoctoRelacionado.
139
    :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.
140
    :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.
141
    :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.
142
    :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.
143
    :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.
144
    :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.
145
    :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.
146
    :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.
147
    :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.
148
    :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.
149
    :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 atributo. Debe ser expresado como una cadena de texto en formato base 64. Es requerido en caso de que el atributo TipoCadPago contenga información.
150
    :param impuestos_p: Nodo condicional para registrar el resumen de los impuestos aplicables conforme al monto del pago recibido, expresados a la moneda de pago.
151
    """
152
153 1
    def __init__(
154
            self,
155
            fecha_pago: datetime,
156
            forma_de_pago_p: str,
157
            moneda_p: str,
158
            docto_relacionado: Sequence[DoctoRelacionado | dict],
159
            monto: Decimal | int = None,
160
            tipo_cambio_p: Decimal | int = None,
161
            num_operacion: str = None,
162
            rfc_emisor_cta_ord: str = None,
163
            nom_banco_ord_ext: str = None,
164
            cta_ordenante: str = None,
165
            rfc_emisor_cta_ben: str = None,
166
            cta_beneficiario: str = None,
167
            tipo_cad_pago: str = None,
168
            cert_pago: str = None,
169
            cad_pago: str = None,
170
            sello_pago: str = None,
171
    ):
172 1
        super().__init__({
173
            'FechaPago': fecha_pago,
174
            'FormaDePagoP': forma_de_pago_p,
175
            'MonedaP': moneda_p,
176
            'Monto': monto,
177
            'TipoCambioP': tipo_cambio_p,
178
            'NumOperacion': num_operacion,
179
            'RfcEmisorCtaOrd': rfc_emisor_cta_ord,
180
            'NomBancoOrdExt': nom_banco_ord_ext,
181
            'CtaOrdenante': cta_ordenante,
182
            'RfcEmisorCtaBen': rfc_emisor_cta_ben,
183
            'CtaBeneficiario': cta_beneficiario,
184
            'TipoCadPago': tipo_cad_pago,
185
            'CertPago': cert_pago,
186
            'CadPago': cad_pago,
187
            'SelloPago': sello_pago,
188
            'DoctoRelacionado': docto_relacionado,
189
        })
190
191
192
# MAIN #
193 1
class Pagos(CFDI):
194
    """
195
    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.
196
197
    :param pago: Elemento requerido para incorporar la información de la recepción de pagos.
198
    :return: objeto CFDI
199
    """
200
201 1
    tag = '{http://www.sat.gob.mx/Pagos20}Pagos'
202 1
    version = '2.0'
203
204 1
    def __init__(
205
            self,
206
            pago: Sequence[Pago | dict],
207
    ):
208 1
        for p in iterate(pago):
209 1
            docto_relacionado = p['DoctoRelacionado']
210 1
            for d in iterate(docto_relacionado):
211 1
                d['ImpSaldoInsoluto'] = d['ImpSaldoAnt'] - d['ImpPagado']
212
213 1
            p['Monto'] = sum(c["ImpPagado"] / (c.get('EquivalenciaDR') or 1) for c in iterate(docto_relacionado))
214 1
            p['ImpuestosP'] = make_impuestos_p(docto_relacionado)
215
216 1
        totales = make_pago_totales(pago)
217
218 1
        super().__init__({
219
            'Version': self.version,
220
            'Totales': totales,
221
            'Pago': pago,
222
        })
223