Endpoint del servicio.

@spec esperar_terminada(
  Sat.Cfdi.Descarga.Masiva.Types.Token.t(),
  String.t(),
  keyword()
) ::
  {:ok, Sat.Cfdi.Descarga.Masiva.Types.VerificacionResult.t()}
  | {:error, term()}

Hace polling llamando a verificar/3 hasta que la solicitud llegue a un estado terminal: :terminada, :error, :rechazada o :vencida.

Opciones extra

• :poll_interval_ms (default 30_000) — espera entre intentos.
• :max_attempts (default 60 — total máximo ~30 minutos).
• (más las mismas de verificar/3: :credential, :rfc_solicitante, …).

Retorno

• {:ok, %VerificacionResult{}} con un estado_solicitud terminal. Ojo: terminal NO implica éxito — :rechazada/:error/:vencida también terminan el polling. Revisa estado_solicitud y codigo_estado_solicitud (p. ej. :rechazada + "5004" = sin datos).
• {:error, {:timeout, :max_attempts_reached, max}} — se agotaron los intentos y la solicitud seguía en :aceptada/:en_proceso. Reintenta más tarde o sube :max_attempts.
• cualquier {:error, reason} que devuelva verificar/3.

Ejemplo

case Verificacion.esperar_terminada(token, id, credential: cred, max_attempts: 20) do
  {:ok, %{estado_solicitud: :terminada, ids_paquetes: ids}} -> descargar(ids)
  {:ok, %{estado_solicitud: :rechazada, codigo_estado_solicitud: "5004"}} -> :sin_datos
  {:ok, %{estado_solicitud: estado}} -> {:error, {:no_terminada, estado}}
  {:error, {:timeout, _, _}} -> {:error, :sigue_en_proceso}
  {:error, reason} -> {:error, reason}
end

SOAPAction.

@spec verificar(Sat.Cfdi.Descarga.Masiva.Types.Token.t(), String.t(), keyword()) ::
  {:ok, Sat.Cfdi.Descarga.Masiva.Types.VerificacionResult.t()}
  | {:error, term()}

Verifica el estado de una solicitud por su id_solicitud.

Opciones

• :credential (requerido) — FIEL para firmar.
• :rfc_solicitante — RFC del solicitante (default: el del certificado).
• :endpoint — override.
• :timeout — HTTP timeout.

Retorno

{:ok, %VerificacionResult{estado_solicitud, codigo_estado_solicitud, numero_cfdis, mensaje, ids_paquetes, id_solicitud}}.

El campo clave es estado_solicitud (átomo):

codigo_estado_solicitud (string) da el detalle, sobre todo si :rechazada:

ids_paquetes solo trae elementos cuando estado_solicitud == :terminada.

Errores ({:error, reason})

{:missing_option, :credential}, {:http_error, status, body}, {:network_error, reason}, {:soap_fault, code, string}, {:parse_error, :missing_fields, body}.

Respuesta cruda del SAT (HTTP 200) y mapeo a VerificacionResult

El cuerpo relevante es el elemento <VerificaSolicitudDescargaResult>. Cada atributo/hijo se mapea así:

Ejemplo TERMINADA (hay paquetes para descargar)

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body>
    <VerificaSolicitudDescargaResponse xmlns="http://DescargaMasivaTerceros.sat.gob.mx">
      <VerificaSolicitudDescargaResult CodEstatus="5000" EstadoSolicitud="3"
        CodigoEstadoSolicitud="5000" NumeroCFDIs="35" Mensaje="Solicitud Aceptada">
        <IdsPaquetes>790040c0-1135-4a30-bf03-9cb25f863396_01</IdsPaquetes>
      </VerificaSolicitudDescargaResult>
    </VerificaSolicitudDescargaResponse>
  </s:Body>
</s:Envelope>

→ %VerificacionResult{estado_solicitud: :terminada, codigo_estado_solicitud: "5000", numero_cfdis: 35, ids_paquetes: ["790040c0-...-_01"], mensaje: "Solicitud Aceptada"}

Ejemplo RECHAZADA sin datos (respuesta real del SAT)

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body>
    <VerificaSolicitudDescargaResponse xmlns="http://DescargaMasivaTerceros.sat.gob.mx">
      <VerificaSolicitudDescargaResult CodEstatus="5000" EstadoSolicitud="5"
        CodigoEstadoSolicitud="5004" NumeroCFDIs="0" Mensaje="Solicitud Aceptada"/>
    </VerificaSolicitudDescargaResponse>
  </s:Body>
</s:Envelope>

→ %VerificacionResult{estado_solicitud: :rechazada, codigo_estado_solicitud: "5004", numero_cfdis: 0, ids_paquetes: [], mensaje: "Solicitud Aceptada"}

Nota: CodEstatus="5000" + Mensaje="Solicitud Aceptada" se refieren a que la consulta de verificación fue procesada, NO a que la solicitud tenga datos. El estado real de la solicitud está en estado_solicitud + codigo_estado_solicitud (aquí :rechazada / "5004" = sin CFDIs).

Ejemplo

case Verificacion.verificar(token, id, credential: cred) do
  {:ok, %{estado_solicitud: :terminada, ids_paquetes: ids}} -> {:ok, ids}
  {:ok, %{estado_solicitud: e}} when e in [:aceptada, :en_proceso] -> :en_proceso
  {:ok, %{estado_solicitud: :rechazada, codigo_estado_solicitud: "5004"}} -> {:ok, []}
  {:ok, %{codigo_estado_solicitud: cod}} -> {:error, {:rechazada, cod}}
  {:error, reason} -> {:error, reason}
end