Sat.Cfdi.Descarga.Masiva.Solicitud (sat_cfdi_descarga v1.5.0)

Copy Markdown

Servicio SolicitaDescarga del WS de Descarga Masiva (v1.5).

Endpoint: https://cfdidescargamasivasolicitud.clouda.sat.gob.mx/CFDI-descarga-masiva-CSD-SolicitudService/solicitud.

Registra una solicitud de descarga por rango de fechas, RFC emisor/receptor, tipo de comprobante, estado, complemento, UUID, etc. Retorna un IdSolicitud que se usara despues para verificar el estado.

En v1.5 la operacion SolicitaDescarga fue reemplazada por tres operaciones:

  • SolicitaDescargaEmitidos — facturas emitidas por el RFC
  • SolicitaDescargaRecibidos — facturas recibidas por el RFC
  • SolicitaDescargaFolio — un CFDI especifico por UUID (Folio)

La funcion solicitar/3 selecciona automaticamente la operacion correcta segun params.tipo_solicitud (:emitidos | :recibidos | :folio).

Summary

Functions

endpoint()

Endpoint del servicio.

soap_action_base()

SOAPAction base (sin sufijo de operacion).

soap_operation(arg1)

Selecciona la operacion SOAP segun el tipo de solicitud.

solicitar(token, params, opts \\ [])

Registra una solicitud y retorna el IdSolicitud.

Functions

endpoint()

Endpoint del servicio.

soap_action_base()

SOAPAction base (sin sufijo de operacion).

soap_operation(arg1)

Selecciona la operacion SOAP segun el tipo de solicitud.

solicitar(token, params, opts \\ [])

@spec solicitar(
  Sat.Cfdi.Descarga.Masiva.Types.Token.t(),
  Sat.Cfdi.Descarga.Masiva.Types.SolicitudParams.t(),
  keyword()
) ::
  {:ok, Sat.Cfdi.Descarga.Masiva.Types.SolicitudResult.t()} | {:error, term()}

Registra una solicitud y retorna el IdSolicitud.

Requiere un token vigente (Sat.Cfdi.Descarga.Masiva.Autenticacion.autenticar/1) y la FIEL para firmar el sobre SOAP.

Selecciona la operacion SOAP segun params.tipo_solicitud:

  • :emitidos → SolicitaDescargaEmitidos
  • :recibidos → SolicitaDescargaRecibidos
  • :folio → SolicitaDescargaFolio

Opciones:

  • :credential (requerido) — FIEL para firmar
  • :endpoint — override
  • :timeout — HTTP timeout

IMPORTANTE: El SAT permite maximo 2 solicitudes con los mismos parametros (mismo RFC + mismo rango de fechas). La tercera solicitud identica devuelve cod_estatus = "5002" de forma permanente para esa combinacion.