Podpora.nextis.cz - Příspěvky uživatele [cs]

API EN WS METHOD DESC

2021-01-21T13:56:55Z

Strakos: Obsah stránky nahrazen textem „API EN WS METHOD DESC“

API EN WS METHOD DESC

2021-01-21T13:56:28Z

Strakos:

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

API EN WS METHOD DESC

2021-01-21T13:54:18Z

Strakos: Obsah stránky nahrazen textem „API EN WS METHOD DESC“

API EN WS METHOD DESC

2019-03-20T08:42:42Z

Strakos:

Nastavení skupin produktů pro jednotlivé katalogy

Export XML FEEDů

2019-03-20T08:41:24Z

Strakos:

Export XML FEEDů

2018-10-01T14:14:50Z

Strakos:

Export XML FEEDů

2018-10-01T14:14:02Z

Strakos:

Soubor:Zařadit do kategorie.png

2018-10-01T13:39:13Z

Strakos:

Zařadit do kategorie

2017-09-22T09:31:16Z

Strakos:

= Úvod =
V tomto článku se podívám na systém vázaných položek. Jejich manuální přidání na katalogovou kartu (skupinu) nebo dodavatelskou kartu. Ukážeme si import těchto položek a jejich funkci v praxi při prodeji.

Příplatky můžeme přidat na dvě místa v systému. První možnost je nastavit příplatek na katalogovou kartu skupiny. Při následném prodeji tohoto zboží se tato položka vždy přidá, nehledě na jejího dodavatele. Druhý případ je, nastavit ji na dodavatelské kartě produktu. Příplatek se naváže pouze v případě, že položka bude prodána od konkrétního dodavatele.

= Příplatek na katalogové kartě (skupiny) =
Nejprve si najdeme skupinovou kartu, ke které chceme vložit příplatek. V hlavním menu '''Sklad a Produkty -> Karty produktů (skupiny)'''. Konkrétní kartu otevřeme.

[[Soubor:Priplatky 1.png|1219x1219pixelů]]

Uprostřed v záložkách najdeme '''Příplatky'''. Zobrazí se nám seznam s již vloženými příplatky (pokud už nějaké jsou) a možností přidat ručně. Jako příplatek může sloužit karta služby nebo karta zboží. V případě služby máme výhodu, že nemusíme hlídat skladovou zásobu příplatku, ale taky ztrácíme kontrolu nad pohyby daného příplatku. U zboží musíme mít příplatek vždy při prodeji na skladě, jinak je nemožné ho vydat.

===Zboží===
Nejprve se podíváme na vázanou položku zboží. Nad seznamem vidíme tlačítko '''Přidat zboží''', otevře se okno s výběrem položky a jejím nastavením. Pomocí vyhledávání najdeme položku. Vždy musíme nastavit množství a cenu za kterou se příplatek bude účtovat. Při prodeji se cena bere z tohoto nastavení (nehraje roli dynamický výpočet ceny konkrétního zboží). Ve spodní části můžeme omezit příplatek stát odběratele. V praxi znamená, pokud omezíme stát na Slovensko, ale náš odběratel bude z České republiky, nebude se příplatek při prodeji účtovat.

===Služba===

[[Soubor:Priplatky_2.png|583x583pixelů]]

U přidání služby postupujeme obdobně jako zboží. Tlačítko '''Přidat službu''' otevře okno, kde vyhledáme naši konkrétní službu. Zde zadáváme pouze množství, na rozdíl od zboží se bere cena nastavená přímo na kartě služby. Následně také můžeme přidat omezení na vybraný stát odběratele.

= Příplatek na dodavatelské kartě =
Najdeme a otevřeme dodavatelskou kartu, ke které chceme přidat příplatek. Nastavení je velmi podobné, jako u skupinové karty. V otevřené kartě přejdeme na záložku '''Příplatky'''. V seznamu vidíme všechny již přidané příplatky. Pokud je u položky vlevo symbol zámku, znamená že tento příplatek se nachází na nadřazené katalogové kartě skupiny. '''POZOR''' pokud budeme mít příplatek na obou kartách, při prodeji se přidá dvakrát. Přidání zboží nebo služby je identické jako na kartě skupiny.

[[Soubor:Priplatky 3.png|1131x1131pixelů]]

Jediný rozdíl najdeme dole na kartě. Vidíme zde tři řádky s označením '''Příplatek 1 -3'''. Nastavení slouží pro vložení příplatku jako textové pole. Příplatek nebude mít žádnou vazbu na zboží ani službu, ale při prodeji se bude jevit jako textová položka, tedy pouze informace o částce a název.

= Importy =
Pro přidání příplatku k více položkám zároveň použijeme importy. Import najdeme v přehledu katalogových karet skupin. V hlavním menu vybereme '''Sklad a Produkty - PIM''' a '''Karty produktů (skupiny)'''. Nahoře v možnostech rozbalíme '''Import''' a najdeme '''Import vázaných produktů'''. Jsou zde dva rozdílné importy pro '''zboží''' a '''služby''' (vysvětlení rozdílu výše).

[[Soubor:Priplatky 4.png|1600x1600pixelů]]

Po otevření okna s importem vybereme v horní části náš soubor. V něm potřebujeme mít sloupce s informací o:

==Import zboží==

===Soubor (sloupce)===
<ul>
<li>'''Číslo skupiny (katalogové číslo)''' - Číslo skupiny hlavní položky, ke které chceme importovat příplatek.</li>
<li>'''Výrobce / značka''' - Výrobce hlavní položky, ke které chceme importovat příplatek.</li>
<li>'''Vázaný produkt (číslo skupiny)''' - Číslo skupiny příplatku</li>
<li>'''Vázaný produkt (výrobce)''' - Výrobce příplatku</li>
<li>'''Vázaný produkt (cena)''' - Cena příplatku</li>
<li>'''Množství''' - Množství příplatku, pokud nemáme v souboru informaci o množství, můžeme nastavit '''<Vždy 1 ks>'''</li>
</ul>

===Další nastavení===
<ul>
<li>'''Pouze pokud je dodavatel''' - Pokud u položky bude konkrétní dodavatel, příplatek se naimportuje</li>
<li>'''Omezení na stát odběratele''' - Pokud omezíme stát na Slovensko, ale náš odběratel bude z České republiky, nebude se příplatek při prodeji účtovat.</li>
<li>'''Odstranit všechny původní vázané produkty u importovaných karet''' - Import se u každé položky podívá, zda nemá už nějaký příplatek přiřazen. Pokud ano, všechny smaže a přidá aktuální ze souboru</li>
</ul>

==import služby==
Import služeb, jako příplatků, se nastavuje podobně jako v případě zboží. Jediná změna, potřebujeme mít v souboru čísla služeb jako vázaných položek a místo výrobce vázané položky budeme mít název.

2017-09-22T08:20:11Z

Strakos:

Vázané položky (příplatky)

2017-09-22T08:19:57Z

Strakos:

= [[Soubor:Priplatky 4.png|1600x1600pixelů]]Úvod =
V tomto článku se podívám na systém vázaných položek. Jejich manuální přidání na katalogovou kartu (skupinu) nebo dodavatelskou kartu. Ukážeme si import těchto položek a jejich funkci v praxi při prodeji.

Příplatky můžeme přidat na dvě místa v systému. První možnost je nastavit příplatek na katalogovou kartu skupiny. Při následném prodeji tohoto zboží se tato položka vždy přidá, nehledě na jejího dodavatele. Druhý případ je, nastavit ji na dodavatelské kartě produktu. Příplatek se naváže pouze v případě, že položka bude prodána od konkrétního dodavatele.

= Příplatek na katalogové kartě (skupiny) =
Nejprve si najdeme skupinovou kartu, ke které chceme vložit příplatek. V hlavním menu '''Sklad a Produkty -> Karty produktů (skupiny)'''. Konkrétní kartu otevřeme.

[[Soubor:Priplatky 1.png|1219x1219pixelů]]

Uprostřed v záložkách najdeme '''Příplatky'''. Zobrazí se nám seznam s již vloženými příplatky (pokud už nějaké jsou) a možností přidat ručně. Jako příplatek může sloužit karta služby nebo karta zboží. V případě služby máme výhodu, že nemusíme hlídat skladovou zásobu příplatku, ale taky ztrácíme kontrolu nad pohyby daného příplatku. U zboží musíme mít příplatek vždy při prodeji na skladě, jinak je nemožné ho vydat.

===Zboží===
Nejprve se podíváme na vázanou položku zboží. Nad seznamem vidíme tlačítko '''Přidat zboží''', otevře se okno s výběrem položky a jejím nastavením. Pomocí vyhledávání najdeme položku. Vždy musíme nastavit množství a cenu za kterou se příplatek bude účtovat. Při prodeji se cena bere z tohoto nastavení (nehraje roli dynamický výpočet ceny konkrétního zboží). Ve spodní části můžeme omezit příplatek stát odběratele. V praxi znamená, pokud omezíme stát na Slovensko, ale náš odběratel bude z České republiky, nebude se příplatek účtovat.

===Služba===

[[Soubor:Priplatky_2.png|583x583pixelů]]

U přidání služby postupujeme obdobně jako zboží. Tlačítko '''Přidat službu''' otevře okno, kde vyhledáme naši konkrétní službu. Zde zadáváme pouze množství, na rozdíl od zboží se bere cena nastavená přímo na kartě služby. Následně také můžeme přidat omezení na vybraný stát odběratele.

= Příplatek na dodavatelské kartě =
Najdeme a otevřeme dodavatelskou kartu, ke které chceme přidat příplatek. Nastavení je velmi podobné, jako u skupinové karty. V otevřené kartě přejdeme na záložku '''Příplatky'''. V seznamu vidíme všechny již přidané příplatky. Pokud je u položky vlevo symbol zámku, znamená že tento příplatek se nachází na nadřazené katalogové kartě skupiny. '''POZOR''' pokud budeme mít příplatek na obou kartách, při prodeji se přidá dvakrát. Přidání zboží nebo služby je identické jako na kartě skupiny.

[[Soubor:Priplatky 3.png|1131x1131pixelů]]

Jediný rozdíl najdeme dole na kartě. Vidíme zde tři řádky s označením '''Příplatek 1 -3'''. Nastavení slouží pro vložení příplatku jako textové pole. Příplatek nebude mít žádnou vazbu na zboží ani službu, ale při prodeji se bude jevit jako textová položka, tedy pouze informace o částce a název.

= Importy =

Soubor:Priplatky 4.png

2017-09-22T08:19:10Z

Strakos:

Příplatky - import

Vázané položky (příplatky)

2017-09-22T06:53:43Z

Strakos:

Vázané položky (příplatky)

2017-09-22T06:53:37Z

Strakos:

2017-09-22T06:07:54Z

Strakos:

Vázané položky (příplatky)

2017-09-22T05:58:16Z

Strakos:

Vázané položky (příplatky)

2017-09-22T05:55:11Z

Strakos:

Vázané položky (příplatky)

2017-09-22T05:54:56Z

Strakos:

= [[Soubor:Priplatky 1.png|1219x1219pixelů]]Úvod =
V tomto článku se podívám na systém vázaných položek. Jejich manuální přidání na katalogovou kartu (skupinu) nebo dodavatelskou kartu. Ukážeme si import těchto položek a jejich funkci v praxi při prodeji.

Příplatky můžeme přidat na dvě místa v systému. První možnost je nastavit příplatek na katalogovou kartu skupiny. Při následném prodeji tohoto zboží se tato položka vždy přidá, nehledě na jejího dodavatele. Druhý případ je, nastavit ji na dodavatelské kartě produktu. Příplatek se naváže pouze v případě, že položka bude prodána od konkrétního dodavatele.

= Příplatek na katalogové kartě (skupiny) =