sat

class satcfdi.pacs.sat.EstadoSolicitud(value)[source]

Bases: IntEnum

ACEPTADA = 1
EN_PROCESO = 2
TERMINADA = 3
ERROR = 4
RECHAZADA = 5
VENCIDA = 6
class satcfdi.pacs.sat.EstadoComprobante(value)[source]

Bases: StrEnum

CANCELADO = 'Cancelado'
VIGENTE = 'Vigente'
TODOS = 'Todos'
class satcfdi.pacs.sat.CodigoEstadoSolicitud(value)[source]

Bases: StrEnum

EXITO = '5000'
AGOTADO = '5002'
TOPE_MAXIMO = '5003'
NO_ENCONTRADO = '5004'
DUPLICADO = '5005'
ERROR_NO_CONTROLADO = '404'
class satcfdi.pacs.sat.TipoDescargaMasivaTerceros(value)[source]

Bases: StrEnum

CFDI = 'CFDI'
METADATA = 'Metadata'
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

status_retencion(cfdi: CFDI) → dict[source]
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_emited_request(fecha_inicial: date | datetime | None = None, fecha_final: date | datetime | None = None, rfc_receptor: str | Sequence[str] | None = None, rfc_emisor: str | None = None, tipo_solicitud: TipoDescargaMasivaTerceros | str = TipoDescargaMasivaTerceros.CFDI, tipo_comprobante: TipoDeComprobante | str | None = None, estado_comprobante: EstadoComprobante | str | None = None, rfc_a_cuenta_terceros: str | None = None, complemento: str | None = 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_received_request(fecha_inicial: date | datetime | None = None, fecha_final: date | datetime | None = None, rfc_receptor: str | None = None, rfc_emisor: str | None = None, tipo_solicitud: TipoDescargaMasivaTerceros | str = TipoDescargaMasivaTerceros.CFDI, tipo_comprobante: TipoDeComprobante | str | None = None, estado_comprobante: EstadoComprobante | str | None = None, rfc_a_cuenta_terceros: str | None = None, complemento: str | None = 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_uuid_request(folio: str | UUID | None = 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:

folio – 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_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_certificate(no_certificado: str | int) → Certificate[source]