---
title: SOAP client proxy documentation
summary: Entry point for the Fax 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 `SAIFFaxService`† ASMX service to send a single fax with an attachment path, a recipient name, and a fax number; it is consumed by `SAIF.Services.Web.Proxies`, and its one in-repository caller is the WCF service `SAIF.Services.WCF.Services.FaxService`.

| Field | Value |
| --- | --- |
| **Proxy name** | `Fax` |
| **Mechanism** | Service Reference (svcutil) |
| **Generated namespace** | `SAIF.Services.Web.Proxies.Fax` |
| **Generated artifacts** | `Services/SAIF.Services.Web.Proxies/Service References/Fax/Reference.cs` |
| **WSDL document** | `Services/SAIF.Services.Web.Proxies/Service References/Fax/faxservice.wsdl` |
| **Proxy base type** | `System.ServiceModel.ClientBase<T>` |
| **Hand-written wrapper** | `FaxServiceProxy` (`Services/SAIF.Services.Web.Proxies/FaxServiceProxy.cs`) |
| **Consuming project** | `SAIF.Services.Web.Proxies` |
| **Target service** | `SAIFFaxService` (`FaxService` ASMX class) |
| **Endpoint source** | Constructor argument — `EndpointAddress` built by the wrapper from an environment setting; the `app.config` `<client><endpoint>` is present but bypassed |
| **Binding** | `BasicHttpBinding(BasicHttpSecurityMode.TransportCredentialOnly)` constructed in code, Windows client credentials |
| **Operations present** | 1 |
| **Operations called** | 1 |

## 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 |
| [Tech debt](tech-debt.md) | CRITICAL and HIGH severity findings |

## Called service

| Attribute | Value |
| --- | --- |
| Service name | `SAIFFaxService` |
| Documented by this run | No |
| Service documentation | `SAIFFaxService`† |
| Endpoint address | `http://websvcprod/webservices/SAIFFaxService/faxservice.asmx` (every environment track) |
| Address source | `Services/SAIF.Services.WCF/Services/FaxService.cs:21-25` (environment key `faxSoapServiceUrl`) |
| SOAP namespace | `http://www.saif.com/` |

## 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)
- [Tech debt](tech-debt.md)

> **Note:** Statements marked with `†` are derived from dependency library
> documentation via the Legends CLI.

## Sources
- `Services/SAIF.Services.Web.Proxies/SAIF.Services.Web.Proxies.csproj`
- `Services/SAIF.Services.Web.Proxies/Service References/Fax/Reference.cs`
- `Services/SAIF.Services.Web.Proxies/Service References/Fax/faxservice.wsdl`
- `Services/SAIF.Services.Web.Proxies/FaxServiceProxy.cs`
- `Services/SAIF.Services.WCF/Services/FaxService.cs`
