Dec.Ebusiness.Message.Client 1.21.432

BMDNL MessageService Client

For easy communication with BMDNL's MessageService.

About the project

The BMDNL MessageService Client is a .NET tool with which messages can be sent to the MessageService API of BMDNL in a simple way.

The MessageService is an API with which transaction messages can be exchanged. The API is based on the standard defined by the Ketenstandaard foundation: https://ketenstandaard.nl/

With the client you will:

• Be able to place a delivery order.
• Not having to deal with the underlying complexity of the Ketenstandaard.
• Only have to fill in and use the fields that are necessary for BMDNL.
• Be able to implement error handling in an easy way.

Using the client

Setup code

In order to be able to call the MessageService from the client, the account details and the correct environment (acceptance or production) must be passed on.

var client = new MessageServiceClient(
    "[your-username]", 
    "[your-password]",
    TargetEnvironment.Acceptance); // or TargetEnvironment.Production
                

Note: You can request the account details from the BMDNL development team.

The order request

Now you can compose the request for a delivery order by using the DeliveryOrder object.

var request = new DeliveryOrder();
request.IsOrderProposal = false;
request.References = new Sgbdnl.Ebusiness.Message.Client.Dto.OrderReferences
{
    CustomerOrderNumber = "TSTCLNT001",
};
request.RequestedDeliveryMoment = new DeliveryMoment
{
    AllowPartialDeliveries = true,
    OnCall = true,
    DeliveryDate = new Sgbdnl.Ebusiness.Message.Client.Dto.DeliveryDate
    {
        NotBeforeDate = DateTime.Now,
        NotAfterDate = DateTime.Now,
    },
};
request.Customer = new Sgbdnl.Ebusiness.Message.Client.Dto.Customer
{
    Gln = "9999999999999",
    OrganisationId = "[your customer number]",
};
request.Supplier = new Supplier
{
    Gln = "9999999999999",
};
request.DeliveryAddress = new Sgbdnl.Ebusiness.Message.Client.Dto.DeliveryAddress
{
    AddressName = "Naam van afleveradres",
    Address = new Sgbdnl.Ebusiness.Message.Client.Dto.Address
    {
        Street = "Magazijnstraat",
        HouseNumber = 4,
        City = "BEMMEL",
        PostalCode = "6681 LT",
        CountryCode = "NL",
    }
};
request.OrderLines = new List<SalesOrderLine>
{
    new SalesOrderLine
    {
        Product = new Sgbdnl.Ebusiness.Message.Client.Dto.Product
        {
            ProductNumber = "1000000",
        },
        Quantity = new Sgbdnl.Ebusiness.Message.Client.Dto.Quantity
        {
            Amount = 1,
        }
    },
};

Note: If you do not yet have your own GLN (Customer.Gln field), you can request one from the Ketenstandaard. The GLN of your supplier (Supplier.Gln field) can be obtained from the BMDNL team.

Post the delivery order

After setting up the order, you can send the request to the MessageService.

// Setup code
...

// Setting the request
var request = new DeliveryOrder();
...

// Post delivery order
var response = await client.PostDeliveryOrder(request);

// Handling the response
...

Note: When the order has been successfully processed, the MessageService client returns the order details in a SalesOrder response object.

Error handling

The client offers the possibility to easily interpret the handling of an invalid order, if you get an error back from the MessageService.

try
{
    ...
    var response = await client.PostDeliveryOrder(request);
    ...
}
catch (FaultException e)
{
    if (e.GetFaultDetails().ErrorCode.Equals("121")) // Faultcode 121 = Wrong Credentials
    {
        // Get more information about the error with e.GetFaultDetails().Message;
    }
    else
    {
        // Handle more error codes
    }
}

Error codes

Below is a list of the error codes that the MessageService can return.