API EN WS METHOD DESC: Porovnání verzí

Verze z 21. 1. 2021, 14:56

API EN WS METHOD DESC

Introduction

The Nextis B2B / B2C order platform has embedded web service methods by which third-party customers can program them in their system. Production ENDPOINT is available on request.

The web service consists of the following methods:

1)      ValidateItemsWithSuppliersAndPrices () - returns stocks and prices for a specific customer and selected goods from the Nextis system.

2)      InsertOrder () - inserts the order into the Nextis system

3)      ExportInvoices () - gets invoices from the Nextis system

4)      ExportDeliveryNotes - downloads WZ documents from the Nextis system

Below is a description of how each method works, along with illustrations of the REQUEST / RESPONSE parameters.

ValidateItemsWithSuppliersAndPrices() – gets stocks and prices.

The required parameters such as:

partnerLogin = provided by the Nextis system owner

partnerPassword = provided by the Nextis system owner

_QTY = 1 (sample quantity requested)

_SupplierProductCode = 13046028342K-SET-MS (example product code)

_SupplierBrandName = MASTER-SPORT (example producer name)

Example code:

Private Sub ValidateItemsQuantityAndPrice()

Try

' Create web service instance 

Dim WS As New NextisWS.Web2WSPublicClient()

WS.Endpoint.Address = New System.ServiceModel.EndpointAddress("http://NextisEDI.svc")

' Order request

Dim Request As New NextisWS.WSExchangeOrdersOrderItemsValidationWithSuppliersAndPrices

' Order items 

Request._Items = New List(Of NextisWS.WSExchangeOrdersOrderRequestItemWithSuppliersAndPrices)

Dim Item1 As New NextisWS.WSExchangeOrdersOrderRequestItemWithSuppliersAndPrices

With Item1

._Qty = 3

._SupplierProductCode = "13046028342K-SET-MS"

._SupplierBrandName = "MASTER-SPORT"

.iItemState = NextisWS.WSExchangeOrdersOrderRequest.OrderRequestItem.ItemStates.OK

End With

Request._Items.Add(Item1)

'Web service response (after order sent)

Dim RSP As NextisWS.wsExchangeOrderItemsValidationWithSuppliersAndPrices = WS.ValidateItemsWithSuppliersAndPrices("Nextis_login", "Nextis_password", Request, False, False)

'Response with ITEMS QUANTITY & PRICE FROM NEXTIS SYSTEM

RSP.Value._Items(0)._SupplierCommitedQtyMain.ToString() 'MAIN WAREHOUSE

RSP.Value._Items(0)._SupplierCommitedPrice.ToString() ' NET PRICE

RSP.Value._Items(0)._SupplierCommitedQtyOthers.ToString() 'SUM FROM OTHER WAREHOUSES

Catch ex As Exception

MessageBox.Show(ex.ToString)

End Try

End Sub

[null Example illustration with parameters:]

InsertOrder() – inserts order to Nextis system.

The required parameters such as:

partnerLogin = provided by the Nextis system owner

partnerPassword = provided by the Nextis system owner

_QTY = 1 (sample quantity requested)

_SupplierProductCode = 13046028342K-SET-MS (example product code)

_SupplierBrandName = MASTER-SPORT (example producer name)

Example code:

Private Sub SendOrder()

Try

'********* Create web service instance *********

Dim WS As New NextisWS.Web2WSPublicClient

WS.Endpoint.Address = New System.ServiceModel.EndpointAddress("http://NextisEDI.svc")

'********* Order request *********

Dim Request As New NextisWS.WSExchangeOrdersOrderRequest

'********* Order items list example *********

Request.iItems = New List(Of NextisWS.WSExchangeOrdersOrderRequest.OrderRequestItem)

Dim Item1 As New NextisWS.WSExchangeOrdersOrderRequest.OrderRequestItem

With Item1

._Qty = 1.0

._SupplierProductCode = "18611871042-PCS-MS"

._SupplierBrandName = "MASTER-SPORT"

.iItemState = NextisWS.WSExchangeOrdersOrderRequest.OrderRequestItem.ItemStates.OK

End With

Request.iItems.Add(Item1)

'Web service response (after order sent)

Dim RSP As NextisWS.wsExchangeOrderRequestResponse = WS.InsertOrder("Nextis_login", "Nextis_password", "Order description", Request, False, False)

MsgBox(RSP.Status.Status.ToString)

Catch ex As Exception

MessageBox.Show(ex.ToString)

End Try

End Sub

Example illustration with parameters:

ExportInvoices() – gets invoices from Nextis system

The required parameters such as:

partnerLogin = provided by the Nextis system owner

partnerPassword = provided by the Nextis system owner

dateFrom = date range in format: 27.5.2019 9:49:00

dateTo = date range in format: 28.5.2019 9:49:00 

ExportDeliveryNotes() – gets delivery notes from Nextis system.

The required parameters such as:

partnerLogin = provided by the Nextis system owner

partnerPassword = provided by the Nextis system owner

dateFrom = date range in format: 27.5.2019 9:49:00

dateTo = date range in format: 28.5.2019 9:49:00