EConnect.Psb 0.1.20

EConnect PSB .NET Client

A reference implementation meant as an example how to use the PSB api using C#.

The Procurement Service Bus (PSB) provides a cloud managed connection to eDelivery networks like the Peppol network.

Requirements

• .NET Core 2.0 or higher / .NET Framework 4.6.1 or higher

Install

• Go through the Getting started documentation.

• Install the package in your project, through nuget or another tool of choice.

Install-Package EConnect.Psb

API references

For the API you can refer to the following documentation.

Setup

Make sure to initialise the service and setup the proper authentication.

Hostbuilder

The recommended way to setup the PSB apis is by using the hostbuilder so you could get the advantages of the dependency injection framework.

builder.Services.AddPsbService(_ =>
{
    _.Username = "{username}";
    _.Password = "{password}";
    _.PsbUrl = "{psbUrl}";
    _.IdentityUrl = "{identityUrl}";
    _.ClientId = "{clientId}";
    _.ClientSecret = "{clientSecret}";
    _.SubscriptionKey = "{SubscriptionKey}";
});

After the PsbService is intialized you can use the following apis:

• IPsbMeApi
• IPsbHookApi
• IPsbPeppolApi
• IPsbPurchaseInvoiceApi
• IPsbPurchaseOrderApi
• IPsbSalesInvoiceApi
• IPsbSalesOrderApi
• IPsbGenericApi

You could now for example inject the sales invoice api into your controller:

public YourController(IPsbSalesInvoiceApi salesInvoice)
{
    _salesInvoice = salesInvoice;
}

All api interfaces are public which makes it possible to mock them.

Example (web) hostbuilder

An example of the hosthuilder can be found in the project EConnect.Psb.Web.Example. In this project the .net client can be used to send an invoice via Peppol.
Additionally, the supplied webhook receiver shows a simple implementation to receive invoices from Peppol.

PsbServiceHost

Use the PsbServiceHost when you are not able to use a dependency framework.

using (var psb = PsbServiceHost.Create(_ =>
    {
    _.Username = "{username}";
    _.Password = "{password}";
    _.PsbUrl = "{psbUrl}";
    _.IdentityUrl = "{identityUrl}";
    _.ClientId = "{clientId}";
    _.ClientSecret = "{clientSecret}";
    _.SubscriptionKey = "{SubscriptionKey}";
    }
))
{
    // Example for QueryRecipientParty
    var res = await psb.SalesInvoice.QueryRecipientParty("{senderPartyId}", new[] { "{receiverPartyId}"  });
    Console.WriteLine(res);
}

Example console application

An example of the PsbServiceHost can be found in the project EConnect.Psb.ConsoleNet.Example.

Read more

If you want to know more about Peppol e-procurement or other procurement network the go to the Procurement Service Bus introduction page.