SAT-CFDI / python-satcfdi

        })

class Retenciones(CFDI):

    """

    Estándar de Documento Electrónico Retenciones e Información de Pagos.

    """

    tag = '{http://www.sat.gob.mx/esquemas/retencionpago/1}Retenciones'

    version = '1.0'

    def __init__(

            self,

            cve_retenc: str,

            emisor: Issuer | dict,

            receptor: Receptor | dict,

            periodo: Periodo | dict,

            totales: Totales | dict,

            folio_int: str = None,

            desc_retenc: str = None,

            complemento: XElement | Sequence[XElement] = None,

            addenda: XElement | Sequence[XElement] = None,

            fecha_exp: datetime = None,

    ):

        """

        Estándar de Documento Electrónico Retenciones e Información de Pagos.

        :param sello: Atributo requerido para contener el sello digital del documento de retención e información de pagos. El sello deberá ser expresado como una cadena de texto en formato base 64.

        :param num_cert: Atributo requerido para expresar el número de serie del certificado de sello digital con el que se selló digitalmente el documento de la retención e información de pagos.

        :param cert: Atributo requerido que sirve para incorporar el certificado de sello digital que ampara el documento de retención e información de pagos como texto, en formato base 64.

        :param fecha_exp: Atributo requerido para la expresión de la fecha y hora de expedición del documento de retención e información de pagos. Se expresa en la forma yyyy-mm-ddThh:mm:ssTZD-6, de acuerdo con la especificación ISO 8601.

        :param cve_retenc: Atributo requerido para expresar la clave de la retención e información de pagos de acuerdo al catálogo publicado en internet por el SAT.

        :param emisor: Nodo requerido para expresar la información del contribuyente emisor del documento electrónico de retenciones e información de pagos.

        :param receptor: Nodo requerido para expresar la información del contribuyente receptor del documento electrónico de retenciones e información de pagos.

        :param periodo: Nodo requerido para expresar el periodo que ampara el documento de retenciones e información de pagos

        :param totales: Nodo requerido para expresar el total de las retenciones e información de pagos efectuados en el período que ampara el documento.

        :param folio_int: Atributo opcional para control interno del contribuyente que expresa el folio del documento que ampara la retención e información de pagos. Permite números y/o letras.

        :param desc_retenc: Atributo opcional que expresa la descripción de la retención e información de pagos en caso de que en el atributo CveRetenc se haya elegido el valor para 'otro tipo de retenciones'

        :param complemento: Nodo opcional donde se incluirá el complemento Timbre Fiscal Digital de manera obligatoria y los nodos complementarios determinados por el SAT, de acuerdo a las disposiciones particulares a un sector o actividad específica.

        :param addenda: Nodo opcional para recibir las extensiones al formato que sean de utilidad al contribuyente. Para las reglas de uso del mismo, referirse al formato de origen.

        """

        fecha_exp = fecha_exp or datetime.now(tz=timezone(timedelta(hours=-6)))

        super().__init__({

            'Version': self.version,

            'Sello': '',

            'NumCert': emisor.certificate_number,

            'Cert':  emisor.signer.certificate_base64(),

            'FechaExp': fecha_exp,

            'CveRetenc': cve_retenc,

            'FolioInt': folio_int,

            'DescRetenc': desc_retenc,

            'Emisor': {

                "RFCEmisor": emisor.rfc,

                "NomDenRazSocE": emisor.legal_name,

                "CURPE": None

            },

            'Receptor': receptor,

            'Periodo': periodo,

            'Totales': totales,

            'Complemento': complemento,

            'Addenda': addenda,

        })

        if emisor.signer:

            self['Sello'] = emisor.signer.sign_sha1(

                self.cadena_original().encode()

            )

        })

class Retenciones(CFDI):

    """

    Estándar del Comprobante Fiscal Digital por Internet que ampara retenciones e información de pagos. Los importes se expresan en la moneda de pesos mexicanos (MXN).

    """

    tag = '{http://www.sat.gob.mx/esquemas/retencionpago/2}Retenciones'

    version = '2.0'

    def __init__(

            self,

            lugar_exp_retenc: str,

            cve_retenc: str,

            emisor: Issuer | dict,

            receptor: Receptor | dict,

            periodo: Periodo | dict,

            totales: Totales | dict,

            folio_int: str = None,

            desc_retenc: str = None,

            cfdi_reten_relacionados: CfdiRetenRelacionados | dict = None,

            complemento: XElement | Sequence[XElement] = None,

            addenda: XElement | Sequence[XElement] = None,

            fecha_exp: datetime = None,

    ):

        """

        Estándar del Comprobante Fiscal Digital por Internet que ampara retenciones e información de pagos. Los importes se expresan en la moneda de pesos mexicanos (MXN).

        :param sello: Atributo requerido para contener el sello digital del comprobante que ampara retenciones e información de pagos, al que hacen referencia las reglas de resolución miscelánea vigente. El sello debe ser expresado como una cadena de texto en formato Base 64.

        :param no_certificado: Atributo requerido para expresar el número de serie del certificado de sello digital que ampara al comprobante de retención e información de pagos, de acuerdo con el acuse correspondiente a 20 posiciones otorgado por el sistema del SAT.

        :param certificado: Atributo requerido que sirve para incorporar el certificado de sello digital que ampara el comprobante de retención e información de pagos. El certificado debe ser expresado como una cadena de texto en formato Base 64.

        :param fecha_exp: Atributo requerido para la expresión de la fecha y hora de expedición del comprobante que ampara retenciones e información de pagos. Se expresa en la forma AAAA-MM-DDThh:mm:ss y debe corresponder con la hora local donde se expide el comprobante.

        :param lugar_exp_retenc: Atributo requerido para incorporar el código postal del lugar de expedición del comprobante que ampara retenciones e información de pagos.

        :param cve_retenc: Atributo requerido para expresar la clave de la retención e información de pagos de acuerdo al catálogo publicado en internet por el SAT.

        :param emisor: Nodo requerido para expresar la información del contribuyente emisor del comprobante que ampara retenciones e información de pagos.

        :param receptor: Nodo requerido para expresar la información del contribuyente receptor del comprobante que ampara retenciones e información de pagos.

        :param periodo: Nodo requerido para expresar el período que corresponde al comprobante que ampara retenciones e información de pagos.

        :param totales: Nodo requerido para expresar el total de las retenciones e información de los pagos efectuados en el período que ampara el comprobante.

        :param folio_int: Atributo opcional para control interno del contribuyente que expresa el folio del comprobante que ampara retenciones e información de pagos. Permite números y/o letras.

        :param desc_retenc: Atributo condicional que expresa la descripción de la retención e información de pagos.

        :param cfdi_reten_relacionados: Nodo opcional para precisar la información de los comprobantes relacionados.

        :param complemento: Nodo opcional donde se incluirá el complemento Timbre Fiscal Digital de manera obligatoria y los nodos complementarios determinados por el SAT, de acuerdo a las disposiciones particulares a un sector o actividad específica.

        :param addenda: Nodo opcional para recibir las extensiones al formato que sean de utilidad al contribuyente. Para las reglas de uso del mismo, referirse al formato de origen.

        """

        fecha_exp = fecha_exp or datetime.now(tz=get_timezone(lugar_exp_retenc)).replace(tzinfo=None)

        super().__init__({

            'Version': self.version,

            'Sello': '',

            'NoCertificado': emisor.certificate_number,

            'Certificado': emisor.signer.certificate_base64(),

            'FechaExp': fecha_exp,

            'LugarExpRetenc': lugar_exp_retenc,

            'CveRetenc': cve_retenc,

            'FolioInt': folio_int,

            'DescRetenc': desc_retenc,

            'CfdiRetenRelacionados': cfdi_reten_relacionados,

            'Emisor': {

                "RfcE": emisor.rfc,

                "NomDenRazSocE": emisor.legal_name,

                "RegimenFiscalE": emisor.tax_system

            },

            'Receptor': receptor,

            'Periodo': periodo,

            'Totales': totales,

            'Complemento': complemento,

            'Addenda': addenda,

        })

        if emisor.signer:

            self['Sello'] = emisor.signer.sign_sha256(

                self.cadena_original().encode()

            )