eConnect.PosSdk 2.0.1

eConnect PosSdk

.NET client for eConnect POS JsonApi.

Technologies

Project supports

• .NET Standard 2.0 and .NET 8.0 and above

Code Example

// sample authentication parameters
// production parameters provided by eConnect
const string pluginId = "b510fb1f-124f-46dc-a7f3-cc9813755fa6";
var authId = Guid.NewGuid().ToString();
const string host = "devcenter.econnect.tv";
const int port = 6500;
var options = new PosClientOptions(pluginId, authId, host, port)
{
    EnableAutomaticRecovery = true, // optional, defaults to true
    ConnectionRetryDelay = TimeSpan.FromMinutes(10) // optional, defaults to 3 minutes
};

await using var client = new SecurePosClient(options);
await client.ConnectAsync();
// when using EnableAutomaticRecovery true, use this EventHandler to catch errors during Reconnect attempts
client.ReconnectError += (sender, exception) =>
            {
                // do some logging in here
            };

var signIn = new SignInEvent
{
    RevenueCenterNumber = 1,
    TerminalNumber = 123,
    EmployeeNumber = 456
};

string response = await client.SendAsync(signIn);
// response == "Valid signIn event object received."

var newCheck = new NewCheckEvent
{
    RevenueCenterNumber = 248,
    TerminalNumber = 1132,
    EmployeeNumber = 634277,
    CheckNumber = 237712
};
response = await Client.SendAsync(newCheck);
// response == "Valid newcheck event object received"

var itemAdd = new ItemAddEvent
{
    RevenueCenterNumber = 248,
    TerminalNumber = 1132,
    EmployeeNumber = 634277,
    CheckNumber = 237712,
    ItemId = "049000608779",
    ItemName = "Apple (Golden Delicious)",
    Quantity = 1,
    Amount = 0.99M
};
response = await Client.SendAsync(itemAdd);
// response == "Valid itemadd event object received"

var totalDue = new TotalDueEvent
{
    RevenueCenterNumber = 248,
    TerminalNumber = 1132,
    EmployeeNumber = 634277,
    CheckNumber = 237712,
    Amount = -.99M
};
response = await Client.SendAsync(totalDue);
// response == "Valid totaldue event object received"

var tenderApply = new TenderApplyEvent
{
    RevenueCenterNumber = 248,
    TerminalNumber = 1132,
    EmployeeNumber = 634277,
    CheckNumber = 237712,
    TenderTypeNumber = 5,
    TenderTypeName = "Cash",
    Amount = 1M
};
response = await Client.SendAsync(tenderApply);
// response == "Valid tenderapply event object received"

var changeDue = new ChangeDueEvent
{
    RevenueCenterNumber = 248,
    TerminalNumber = 1132,
    EmployeeNumber = 634277,
    CheckNumber = 237712,
    Amount = .01M
};
response = await Client.SendAsync(changeDue);
// response == "Valid changedue event object received"

var closeCheck = new CloseCheckEvent
{
    RevenueCenterNumber = 11291,
    TerminalNumber = 88332,
    EmployeeNumber = 634277,
    CheckNumber = 237712
};
response = await Client.SendAsync(closeCheck);
// response == "Valid closecheck event object received"

Testing

eConnect provides a TCP JSON API Test Service, showing sample credentials that work in combination with an online Testing Console.