sat

class satcfdi.pacs.sat.EstadoSolicitud(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)[source]

Bases: IntEnum

Aceptada = 1
EnProceso = 2
Terminada = 3
Error = 4
Rechazada = 5
Vencida = 6
class satcfdi.pacs.sat.TipoDescargaMasivaTerceros(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)[source]

Bases: Enum

CFDI = 'CFDI'
Metadata = 'Metadata'
class satcfdi.pacs.sat.TipoDeComprobante(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)[source]

Bases: Enum

Ingreso = 'I'
Egreso = 'E'
Traslado = 'T'
Nomina = 'N'
Pago = 'P'
class satcfdi.pacs.sat.EstadoComprobante(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)[source]

Bases: Enum

Cancelado = '0'
Vigente = '1'
class satcfdi.pacs.sat.SAT(signer: Signer = None, environment=Environment.PRODUCTION)[source]

Bases: PAC

RFC = 'SAT970701NN3'
status(cfdi: CFDI) → dict[source]

Consulta el estado de un CFDI :return: Respuesta de la consulta

validate(cfdi: CFDI)[source]

verify if the CFDI is valid based on its signatures and certificates this method might need improvements :return: True is all certificate and signatures verifications passed

list_69b(rfc: str) → TaxpayerStatus | None[source]

Operation to get list69b status

recover_comprobante_request(fecha_inicial: date = None, fecha_final: date = None, rfc_receptor: str | Sequence[str] = None, rfc_emisor: str = None, tipo_solicitud: TipoDescargaMasivaTerceros | str = TipoDescargaMasivaTerceros.CFDI, tipo_comprobante: TipoDeComprobante | str = None, estado_comprobante: EstadoComprobante | str = None, rfc_a_cuenta_terceros: str = None, complemento: str = None, uuid: str | UUID = None) → dict[source]

Esta operación permite solicitar la descarga de CFDIs o Metadata y como resultado devuelve un id de solicitud o estatus de la petición realizada.

Parameters:

  • fecha_inicial – Solo se buscarán CFDI, cuya fecha de emisión sea igual o mayor a la fecha inicial indicada en este parámetro. Parámetro obligatorio. Este parámetro no debe declararse en caso de realizar una consulta por el folio fiscal (UUID).

  • fecha_final – Solo se buscarán CFDI, cuya fecha de emisión sea igual o menor a la fecha final indicada en este parámetro. Parámetro obligatorio. Este parámetro no debe declararse en caso de realizar una consulta por el folio fiscal (UUID).

  • rfc_receptor – Contiene el/los RFCs receptores de los cuales se quiere consultar los CFDIs Importante: El campo RfcReceptor, únicamente permite la captura de 5 registros como máximo

  • rfc_emisor – Contiene el RFC del emisor del cual se quiere consultar los CFDI. Parámetro obligatorio. Este parámetro no debe declararse en caso de realizar una consulta por el folio fiscal (UUID).

  • tipo_solicitud – Define el tipo de descarga

  • tipo_comprobante – Define el tipo de comprobante

  • estado_comprobante – Define el estado del comprobante

  • rfc_a_cuenta_terceros – Contiene el RFC del a cuenta a tercero del cual se quiere consultar los CFDIs

  • complemento – Define el complemento de CFDI a descargar

  • uuid – Folio Fiscal

Returns:

respuesta de solicitud de descarga

recover_comprobante_status(id_solicitud: str) → dict[source]
recover_comprobante_download(id_paquete: str) -> (<class 'dict'>, <class 'str'>)[source]
recover_comprobante_iwait(fecha_inicial: date = None, fecha_final: date = None, rfc_receptor: str | Sequence[str] = None, rfc_emisor: str = None, tipo_solicitud: TipoDescargaMasivaTerceros | str = TipoDescargaMasivaTerceros.CFDI, tipo_comprobante: TipoDeComprobante | str = None, estado_comprobante: EstadoComprobante | str = None, rfc_a_cuenta_terceros: str = None, complemento: str = None, uuid: str | UUID = None, id_solicitud: str | UUID = None) → Iterator[tuple[str, bytes]][source]

Itera sobre los paquetes obtenidos

Parameters:

  • fecha_inicial – Solo se buscarán CFDI, cuya fecha de emisión sea igual o mayor a la fecha inicial indicada en este parámetro. Parámetro obligatorio. Este parámetro no debe declararse en caso de realizar una consulta por el folio fiscal (UUID).

  • fecha_final – Solo se buscarán CFDI, cuya fecha de emisión sea igual o menor a la fecha final indicada en este parámetro. Parámetro obligatorio. Este parámetro no debe declararse en caso de realizar una consulta por el folio fiscal (UUID).

  • rfc_receptor – Contiene el/los RFCs receptores de los cuales se quiere consultar los CFDIs Importante: El campo RfcReceptor, únicamente permite la captura de 5 registros como máximo

  • rfc_emisor – Contiene el RFC del emisor del cual se quiere consultar los CFDI. Parámetro obligatorio. Este parámetro no debe declararse en caso de realizar una consulta por el folio fiscal (UUID).

  • tipo_solicitud – Define el tipo de descarga

  • tipo_comprobante – Define el tipo de comprobante

  • estado_comprobante – Define el estado del comprobante

  • rfc_a_cuenta_terceros – Contiene el RFC del a cuenta a tercero del cual se quiere consultar los CFDIs

  • complemento – Define el complemento de CFDI a descargar

  • uuid – Folio Fiscal

  • id_solicitud – Si ya se cuenta con el id de una solicitud anterior, solo pasar este parametro

Returns:

Iterador sobre packetes y su contenido en bytes

recover_retencion_request(fecha_inicial: date = None, fecha_final: date = None, rfc_receptor: str | Sequence[str] = None, rfc_emisor: str = None, tipo_solicitud: TipoDescargaMasivaTerceros | str = TipoDescargaMasivaTerceros.CFDI, tipo_comprobante: TipoDeComprobante | str = None, estado_comprobante: EstadoComprobante | str = None, rfc_a_cuenta_terceros: str = None, complemento: str = None, uuid: str | UUID = None) → dict[source]

Esta operación permite solicitar la descarga de CFDIs o Metadata y como resultado devuelve un id de solicitud o estatus de la petición realizada.

Parameters:

  • fecha_inicial – Solo se buscarán CFDI, cuya fecha de emisión sea igual o mayor a la fecha inicial indicada en este parámetro. Parámetro obligatorio. Este parámetro no debe declararse en caso de realizar una consulta por el folio fiscal (UUID).

  • fecha_final – Solo se buscarán CFDI, cuya fecha de emisión sea igual o menor a la fecha final indicada en este parámetro. Parámetro obligatorio. Este parámetro no debe declararse en caso de realizar una consulta por el folio fiscal (UUID).

  • rfc_receptor – Contiene el/los RFCs receptores de los cuales se quiere consultar los CFDIs Importante: El campo RfcReceptor, únicamente permite la captura de 5 registros como máximo

  • rfc_emisor – Contiene el RFC del emisor del cual se quiere consultar los CFDI. Parámetro obligatorio. Este parámetro no debe declararse en caso de realizar una consulta por el folio fiscal (UUID).

  • tipo_solicitud – Define el tipo de descarga

  • tipo_comprobante – Define el tipo de comprobante

  • estado_comprobante – Define el estado del comprobante

  • rfc_a_cuenta_terceros – Contiene el RFC del a cuenta a tercero del cual se quiere consultar los CFDIs

  • complemento – Define el complemento de CFDI a descargar

  • uuid – Folio Fiscal

Returns:

respuesta de solicitud de descarga

recover_retencion_status(id_solicitud: str) → dict[source]
recover_retencion_download(id_paquete: str) -> (<class 'dict'>, <class 'str'>)[source]
recover_retencion_iwait(fecha_inicial: date = None, fecha_final: date = None, rfc_receptor: str | Sequence[str] = None, rfc_emisor: str = None, tipo_solicitud: TipoDescargaMasivaTerceros | str = TipoDescargaMasivaTerceros.CFDI, tipo_comprobante: TipoDeComprobante | str = None, estado_comprobante: EstadoComprobante | str = None, rfc_a_cuenta_terceros: str = None, complemento: str = None, uuid: str | UUID = None, id_solicitud: str | UUID = None) → Iterator[tuple[str, bytes]][source]

Itera sobre los paquetes obtenidos

Parameters:

  • fecha_inicial – Solo se buscarán CFDI, cuya fecha de emisión sea igual o mayor a la fecha inicial indicada en este parámetro. Parámetro obligatorio. Este parámetro no debe declararse en caso de realizar una consulta por el folio fiscal (UUID).

  • fecha_final – Solo se buscarán CFDI, cuya fecha de emisión sea igual o menor a la fecha final indicada en este parámetro. Parámetro obligatorio. Este parámetro no debe declararse en caso de realizar una consulta por el folio fiscal (UUID).

  • rfc_receptor – Contiene el/los RFCs receptores de los cuales se quiere consultar los CFDIs Importante: El campo RfcReceptor, únicamente permite la captura de 5 registros como máximo

  • rfc_emisor – Contiene el RFC del emisor del cual se quiere consultar los CFDI. Parámetro obligatorio. Este parámetro no debe declararse en caso de realizar una consulta por el folio fiscal (UUID).

  • tipo_solicitud – Define el tipo de descarga

  • tipo_comprobante – Define el tipo de comprobante

  • estado_comprobante – Define el estado del comprobante

  • rfc_a_cuenta_terceros – Contiene el RFC del a cuenta a tercero del cual se quiere consultar los CFDIs

  • complemento – Define el complemento de CFDI a descargar

  • uuid – Folio Fiscal

  • id_solicitud – Si ya se cuenta con el id de una solicitud anterior, solo pasar este parametro

Returns:

Iterador sobre packetes y su contenido en bytes

recover_certificate(no_certificado: str | int) → Certificate[source]