---
title: SOAP client proxy documentation
summary: Entry point for consumed SOAP service proxy documentation.
status: draft
owner: SAIF.Core documentation
last_reviewed: 2026-09-24
---

# SOAP client proxy documentation

This proxy calls the external `clsCAServices`† address-cleansing service and is carried inside `SAIF.Services`, a packaged class library that ships in the `SAIF.SAIFCode.Core` NuGet package; three authored adapter types wrap it, but no production code in this repository constructs those adapters — the only exercise found is in unit tests.

| Field | Value |
| --- | --- |
| **Proxy name** | `CleanAddressSvc` |
| **Mechanism** | Web Reference (wsdl.exe) |
| **Generated namespace** | `SAIF.Services.CleanAddressSvc` |
| **Generated artifacts** | `Services/SAIF.Services/Web References/CleanAddressSvc/Reference.cs` |
| **WSDL document** | `Services/SAIF.Services/Web References/CleanAddressSvc/clsCAServices.wsdl` |
| **Proxy base type** | `System.Web.Services.Protocols.SoapHttpClientProtocol` |
| **Hand-written wrapper** | `SAIF.Services.Utilities.CleanAddress.CleanAddressService`, `AddressSearchService`, `CleanAddressBatchService` (`Services/SAIF.Services/Utilities/CleanAddress/`) |
| **Consuming project** | `SAIF.Services` (`Services/SAIF.Services/SAIF.Services.csproj`) |
| **Target service** | `clsCAServices` |
| **Endpoint source** | Generated settings (`SAIF.Services.Properties.Settings`) |
| **Binding** | HTTP (ASMX default), SOAP 1.1 binding `clsCAServicesSoap` |
| **Operations present** | 5 |
| **Operations called** | 4 |

## Documentation sections

| Section | Description |
| --- | --- |
| [Overview](overview.md) | Which service is called, who consumes the proxy, and capability summary |
| [Architecture](architecture.md) | How the proxy is constructed, configured, and invoked |
| [Contract](contract.md) | The WSDL-declared operations, messages, faults, and binding |
| [Operation map](operation-map.md) | Operations present in the proxy versus operations actually called |
| [Client reference](reference.md) | One section per operation called from repository source |
| [Consumption](consumption.md) | Construction, disposal, resilience, and endpoint configuration |
| [Dependencies](dependencies.md) | Packages, framework components, and the called service |
| [Business rules](business-rules.md) | Rules enforced around the call |
| [Tech debt](tech-debt.md) | CRITICAL and HIGH severity findings |

## Called service

| Attribute | Value |
| --- | --- |
| Service name | `clsCAServices` |
| Documented by this run | No |
| Service documentation | `clsCAServices`† |
| Endpoint address | `http://correctaddress/wsCorrectAddress/clsCAServices.asmx` (compiled default, effective inside this repository) |
| Address source | `Services/SAIF.Services/Properties/Settings.Designer.cs` |
| SOAP namespace | `http://tempuri.org/` |

## Related documentation
- [Overview](overview.md)
- [Architecture](architecture.md)
- [Contract](contract.md)
- [Operation map](operation-map.md)
- [Client reference](reference.md)
- [Consumption](consumption.md)
- [Dependencies](dependencies.md)
- [Business rules](business-rules.md)
- [Tech debt](tech-debt.md)

> **Note:** Statements marked with † were retrieved from dependency library documentation
> via the Legends CLI RAG service. They describe inherited behavior from the indicated
> origin library and should be verified if the dependency version changes.

## Sources
- `Services/SAIF.Services/Web References/CleanAddressSvc/Reference.cs`
- `Services/SAIF.Services/Web References/CleanAddressSvc/clsCAServices.wsdl`
- `Services/SAIF.Services/SAIF.Services.csproj`
- `Services/SAIF.Services/Properties/Settings.Designer.cs`
- `Services/SAIF.Services/app.config`