|
|
Řádka 1: |
Řádka 1: |
| API EN WS METHOD DESC | | 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("<nowiki>http://NextisEDI.svc</nowiki>")
| |
− |
| |
− | ' 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("<nowiki>http://NextisEDI.svc</nowiki>")
| |
− |
| |
− | '********* 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
| |