@spec build(atom() | String.t(), map(), keyword()) ::
  {:ok, String.t()} | {:error, any()}

Builds a SOAP envelope for the given operation and parameters.

Parameters

• operation - The operation name (atom or string)
• params - Parameters for the operation (map)
• options - Envelope options

Options

• :version - SOAP version (:v1_1 or :v1_2, default: :v1_1)
• :headers - SOAP headers to include
• :namespace - Target namespace for the operation
• :namespace_prefix - Optional namespace prefix for the operation element (e.g. "ns0"). When set the element is rendered as <ns0:Op xmlns:ns0="..."> instead of the default <Op xmlns="...">. When omitted, the existing default-namespace behaviour is preserved.

Examples

iex> Envelope.build(:get_user, %{id: 123})
{:ok, "<?xml version=\"1.0\" encoding=\"UTF-8\"?>..."}

@spec parse_response(map()) :: {:ok, any()} | {:error, any()}

Parses a SOAP response and extracts the result or fault.

Parameters

• response - HTTP response map with :body key containing XML

Returns

• {:ok, result} - Successful response with parsed body
• {:error, fault} - SOAP fault or parsing error