Code examples

SOAP client setup and working examples for C#, Python, and Java.

Setup and dependencies

C# (.NET)

Add a WSDL reference in Visual Studio:

1. Right-click the project.

2. Select Add Connected Service or Add Web Reference.

3. Enter https://soap.ecall.ch/eCall.asmx.

4. Set a namespace, for example eCallService.

You can also use dotnet-svcutil:

dotnet tool install --global dotnet-svcutil
dotnet-svcutil https://soap.ecall.ch/eCall.asmx?WSDL

Python

pip install zeep

Java

Generate JAX-WS client code:

wsimport -keep -p com.ecall.soap https://soap.ecall.ch/eCall.asmx?WSDL

Or add the runtime dependency:

<dependency>
    <groupId>com.sun.xml.ws</groupId>
    <artifactId>jaxws-rt</artifactId>
    <version>4.0.0</version>
</dependency>

Send SMS — SendSMSBasic

C# (.NET)

using eCallService;

var client = new eCallSoapClient(
    eCallSoapClient.EndpointConfiguration.eCallSoap12
);

var request = new SendSMSBasicRequest
{
    AccountName     = "johnsmith",
    AccountPassword = "secretpassword",
    Address         = "0041791234567",
    Message         = "Hello from eCall!",
    JobID           = "SMS-001"
};

var response = await client.SendSMSBasicAsync(request);

if (response.ResponseCode == 0)
{
    Console.WriteLine("SMS successfully submitted.");
}
else
{
    Console.WriteLine($"Error {response.ResponseCode}: {response.ResponseText}");
}

Python

from zeep import Client
from zeep.transports import Transport
import requests

session = requests.Session()
transport = Transport(session=session, timeout=30)

client = Client(
    wsdl="https://soap.ecall.ch/eCall.asmx?WSDL",
    transport=transport
)

service = client.bind("eCall", "eCallSoap12")

response = service.SendSMSBasic(
    AccountName="johnsmith",
    AccountPassword="secretpassword",
    Address="0041791234567",
    Message="Hello from eCall!",
    JobID="SMS-001"
)

if response.ResponseCode == 0:
    print("SMS successfully submitted.")
else:
    print(f"Error {response.ResponseCode}: {response.ResponseText}")

Java

import com.ecall.soap.*;

ECall service = new ECall();
ECallSoap port = service.getECallSoap12();

SendSMSBasicRequest request = new SendSMSBasicRequest();
request.setAccountName("johnsmith");
request.setAccountPassword("secretpassword");
request.setAddress("0041791234567");
request.setMessage("Hello from eCall!");
request.setJobID("SMS-001");

SendSMSBasicResponse response = port.sendSMSBasic(request);

if (response.getResponseCode() == 0) {
    System.out.println("SMS successfully submitted.");
} else {
    System.out.printf("Error %d: %s%n",
        response.getResponseCode(),
        response.getResponseText());
}

Send fax with attachment — SendFax

C# (.NET)

using System.IO;
using eCallService;

var client = new eCallSoapClient(
    eCallSoapClient.EndpointConfiguration.eCallSoap12
);

byte[] pdfBytes  = File.ReadAllBytes("document.pdf");
string pdfBase64 = Convert.ToBase64String(pdfBytes);

var request = new SendFaxRequest
{
    AccountName     = "johnsmith",
    AccountPassword = "secretpassword",
    Address         = "0041441234567",
    Message         = "Please find the document attached.",
    Subject         = "Test fax",
    JobID           = "FAX-001",
    FaxHeaderID     = "[phone]",
    FaxHeaderInfo   = "F24 Schweiz AG",
    TokenFields     = "MaxRetries;=3;:RetriesTimeIntervallInMin;=10",
    Attachments     = new[]
    {
        new Attachment { FileName = "document.pdf", FileContent = pdfBase64 }
    }
};

var response = await client.SendFaxAsync(request);
Console.WriteLine(response.ResponseCode == 0 ? "Fax submitted." : $"Error: {response.ResponseText}");

Python

import base64
from zeep import Client
from zeep.transports import Transport
import requests

session = requests.Session()
client = Client(
    wsdl="https://soap.ecall.ch/eCall.asmx?WSDL",
    transport=Transport(session=session, timeout=30)
)
service = client.bind("eCall", "eCallSoap12")

with open("document.pdf", "rb") as f:
    pdf_base64 = base64.b64encode(f.read()).decode("utf-8")

Attachment = client.get_type("ns0:Attachment")
attachment = Attachment(FileName="document.pdf", FileContent=pdf_base64)

response = service.SendFax(
    AccountName="johnsmith",
    AccountPassword="secretpassword",
    Address="0041441234567",
    Message="Please find the document attached.",
    Subject="Test fax",
    JobID="FAX-001",
    FaxHeaderID="[phone]",
    FaxHeaderInfo="F24 Schweiz AG",
    TokenFields="MaxRetries;=3;:RetriesTimeIntervallInMin;=10",
    Attachments=[attachment]
)

print("OK" if response.ResponseCode == 0 else f"Error: {response.ResponseText}")

Java

import java.nio.file.*;
import java.util.Base64;
import com.ecall.soap.*;

ECall service = new ECall();
ECallSoap port = service.getECallSoap12();

byte[] pdfBytes = Files.readAllBytes(Path.of("document.pdf"));
String pdfBase64 = Base64.getEncoder().encodeToString(pdfBytes);

Attachment attachment = new Attachment();
attachment.setFileName("document.pdf");
attachment.setFileContent(pdfBase64);

SendFaxRequest request = new SendFaxRequest();
request.setAccountName("johnsmith");
request.setAccountPassword("secretpassword");
request.setAddress("0041441234567");
request.setMessage("Please find the document attached.");
request.setSubject("Test fax");
request.setJobID("FAX-001");
request.setFaxHeaderID("[phone]");
request.setFaxHeaderInfo("F24 Schweiz AG");
request.setTokenFields("MaxRetries;=3;:RetriesTimeIntervallInMin;=10");
request.getAttachments().add(attachment);

SendFaxResponse response = port.sendFax(request);
System.out.println(response.getResponseCode() == 0 ? "Fax submitted." : "Error: " + response.getResponseText());

Send voice message — SendVoiceBasic

C# (.NET)

var request = new SendVoiceBasicRequest
{
    AccountName      = "johnsmith",
    AccountPassword  = "secretpassword",
    Address          = "0041791234567",
    Message          = "Attention! This is a test message from eCall.",
    MessageLanguage  = "EN",
    JobID            = "VOICE-001"
};

var response = await client.SendVoiceBasicAsync(request);

Python

response = service.SendVoiceBasic(
    AccountName="johnsmith",
    AccountPassword="secretpassword",
    Address="0041791234567",
    Message="Attention! This is a test message from eCall.",
    MessageLanguage="EN",
    JobID="VOICE-001"
)

Java

SendVoiceBasicRequest request = new SendVoiceBasicRequest();
request.setAccountName("johnsmith");
request.setAccountPassword("secretpassword");
request.setAddress("0041791234567");
request.setMessage("Attention! This is a test message from eCall.");
request.setMessageLanguage("EN");
request.setJobID("VOICE-001");

SendVoiceBasicResponse response = port.sendVoiceBasic(request);

Query send status — GetStateBasic

C# (.NET)

var request = new GetStateBasicRequest
{
    AccountName     = "johnsmith",
    AccountPassword = "secretpassword",
    JobID           = "SMS-001",
    Address         = "0041791234567"
};

var response = await client.GetStateBasicAsync(request);

if (response.ResponseCode == 0)
{
    var job = response.JobResponse;
    Console.WriteLine($"Status:    {job.SendState}");
    Console.WriteLine($"Completed: {job.FinishDate}");
    Console.WriteLine($"Credits:   {job.PointsUsed}");
}

Python

response = service.GetStateBasic(
    AccountName="johnsmith",
    AccountPassword="secretpassword",
    JobID="SMS-001",
    Address="0041791234567"
)

if response.ResponseCode == 0:
    job = response.JobResponse
    print(f"Status:    {job.SendState}")
    print(f"Completed: {job.FinishDate}")
    print(f"Credits:   {job.PointsUsed}")
else:
    print(f"Error {response.ResponseCode}: {response.ResponseText}")

Java

GetStateBasicRequest request = new GetStateBasicRequest();
request.setAccountName("johnsmith");
request.setAccountPassword("secretpassword");
request.setJobID("SMS-001");
request.setAddress("0041791234567");

GetStateBasicResponse response = port.getStateBasic(request);

if (response.getResponseCode() == 0) {
    JobResponse job = response.getJobResponse();
    System.out.println("Status:    " + job.getSendState());
    System.out.println("Completed: " + job.getFinishDate());
    System.out.println("Credits:   " + job.getPointsUsed());
}