API EN WS METHOD DESC
API EN WS METHOD DESC
Obsah
- 1 Introduction
- 2 1) ValidateItemsWithSuppliersAndPrices () - returns stocks and prices for a specific customer and selected goods from the Nextis system.
- 3 2) InsertOrder () - inserts the order into the Nextis system
- 4 3) ExportInvoices () - gets invoices from the Nextis system
- 5 4) ExportDeliveryNotes - downloads WZ documents from the Nextis system
- 6 ValidateItemsWithSuppliersAndPrices() – gets stocks and prices.
- 7 InsertOrder() – inserts order to Nextis system.
- 8 ExportInvoices() – gets invoices from Nextis system
- 9 ExportDeliveryNotes() – gets delivery notes from Nextis system.
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
