Resurs: extendedproductlist.nv
HTTP-metod: GET
Obs! Om Rackbeat lagerhantering används i Netvisor, finns API-beskrivningar här: https://support.netvisor.fi/fi/support/solutions/articles/77000554491-rackbeat-stoplight-rajapinta
Resursen extendedproductlist.nv kan hämta modellprodukter samt vanliga produkter men inte huvudprodukter eller TEMP-produkt. Resursen kan begränsas med flera olika parametrar som finns i tabellen nedan. Resursen kan också användas utan utökad produkt hantering, då kanske inte alla uppgifter returneras eftersom dessa inte är tillgängliga.
Hämtningen returnerar publicerade produkter, borttagna produkter returneras aldrig. Om man vill hämta opublicerade produkter måste produktlistan hämtas med produktens NetvisorKey.
| Parameterns namn | Förekomster | Beskrivning | Exempel |
| replyoptions | 0...1 | Välj vilken information som returneras utöver grundläggande information. Anges som ett numeriskt värde eller med flaggornas namn. Alternativ och flaggvärden: Prisgrupper - IncludeProductPriceGroups (1) Kundpriser - IncludeProductCustomerPrices (2) Leverantörsinformation - IncludeDistributerPurchaseInformation (4) Hylla information - IncludeProductInventoryPlaceShelves (8) Leveransinformation - IncludeProductShipmentInformation (16) Grupperingskriterier - IncludeProductGroupingCriterias (32) Bokföringsinformation - IncludeProductAccountingInformation (64) Kostnadsobjekt - IncludeProductDimensionInformation (128) Informationsfält - IncludeProductInformationFields (256) Produktreferenser - IncludeProductReferences (512) Egenskaper - IncludeProductProperties (1024) Underprodukter - IncludeProductSubProducts (2048) Bilder - IncludeProductImages (2096) Bilagor - IncludeProductAttachments (8192) Ställ alla sökkriterier - SetAllReplyOptions (4294967295) | 3 Returnerar då prisgrupper och kundpriser. Fås genom att summera flaggvärdena för alternativen. Om flaggvärdenas namn används, anges i formatet "IncludeProductPriceGroups, IncludeProductCustomerPrices". Som parameter: *.nv?replyoptions=includeproductpricegroups, includeproductcustomerprice eller *.nv?replyoptions=3 |
| searchlanguage | 0...1 | Välj vilken språkversion sökorden riktas mot. Utan utökad produkt hantering är endast "fi" tillgänglig. Tillåtna värden "fi", "se" och "en". Om inget anges används värdet "fi". | se |
| productnetvisorkeys | 0...1 | Komma-separerad lista över produkternas netvisorkey-värden. Kan också vara bara ett värde. | 7,12 |
| productnamekeyword | 0...1 | Ett sökord som söks i produktnamnet. | test |
| productcodekeyword | 0...1 | Ett sökord som söks i produktkoden. | ABC |
| producteancode | 0...1 | EAN-koden för den sökta produkten. Koden jämförs med primär och sekundär EAN-kod. | |
| onlysellableproducts | 0...1 | Är produkten säljar. Värden true eller false. | true |
| onlystoragedproducts | 0...1 | Är produkten lagringsbar. Endast relevant om lagerhantering används. Värden true eller false. | false |
| productchangedsince | 0...1 | Har produkten ändrats efter det angivna datumet och tiden. Minutprecision. Format yyyy-MM-ddTHH:mm | 2020-09-17T10:21 |
| productgroupnetvisorkeys | 0...1 | Komma-separerad lista över produktgruppernas netvisorkey-värden. Kan också vara bara ett värde. | 7, 20 |
| productgroupname | 0...1 | Namnet på produktgruppen för de produkter som ska hämtas. | Test product |
| productgroupnamekeyword | 0...1 | Början av namnet på produktgruppen för de produkter som ska hämtas. | Test |
| productgroupnamefreetext | 0...1 | Namnet på produktgruppen för de produkter som ska hämtas innehåller det angivna parametern | Test |
| excludeproductgroupnamefreetext | 0...1 | Namnet på produktgruppen för de produkter som ska uteslutas innehåller det angivna parametern | Test |
| productgroupingcriterianame | 0...1 | Namnet på grupperingskriterierna för de produkter som ska hämtas. | Grouping |
| productsonpage | 0...1 | Maximalt antal produkter per sida, dvs. meddelande. (1-Maximalt antal inställt i Netvisor) | 2500 |
| page | 0...1 | Numret på den sida som ska returneras. (1-Antal sidor i sökresultatet) |
En del av den returnerade datan är endast tillgänglig om företaget har utökad produkt hantering, inköpsorder hantering eller lager hantering. Annars returneras strukturen likadant oavsett om utökad produkt hantering är aktiverad eller inte.
Maximal storlek för det returnerade meddelandet är satt till 25Mb. Om maxgränsen är på väg att överskridas returnerar API:et ett fel och instruktioner om hur man minskar meddelandets storlek. Data returneras inte förrän meddelandets storlek har minskats.
Vid paginering kan man ställa in maximalt antal produkter per meddelande (ProductsOnPage = 1 - Maximalt antal inställt i Netvisor) och man kan hämta en specifik sida för meddelandet (Page = 1 - PageCount). Sidor måste alltid hämtas med samma sökkriterier. Observera att om produktregistret redigeras mellan hämtningarna kan exakt samma hämtning returnera olika resultat.
Läs mer om terminologin för utökad produkt hantering här.
Svar:
| Nivå | Element | Format | Förekomster | Beskrivning | Exempel |
| Root | Root | Aggregat | 1 | ||
| 1 | Products | Aggregat | 1 | ||
| 2 | Product | Aggregat | 1 | ||
| 3 | NetvisorKey | Numerisk | 1 | Produktens NetvisorKey | 13848 |
| 3 | ProductCodes | Aggregat | 1 | ||
| 4 | ProductCode | Numerisk | 1 | Produktens produktkod | 1 |
| 4 | ProductPrimaryEanCode | Numerisk | 1 | Produktens primära EAN-kod | |
| 4 | ProductSecondaryEanCode | Numerisk | 1 | Produktens sekundära EAN-kod | |
| 3 | ProductNameTranslations | Aggregat | 1 | Produktens namnöversättningar | |
| 4 | Translation | Sträng | 1 | Produktens namn | Testprodukt |
| Attr. | Language | Sträng | 1 | FI, SE eller EN | FI |
| 3 | ProductDescriptionTranslations | Aggregat | 1 | Produktens beskrivningsöversättningar | |
| 4 | Translation | Sträng | 1 | Produktbeskrivning | Beskrivning |
| Attr. | Language | Sträng | 1 | FI, SE eller EN | FI |
| 3 | ProductFeatures | Aggregat | 1 | Produktens egenskaper | |
| 4 | IsPublishedProduct | Sträng | 1 | Är produkten publicerad, true eller false | true |
| 4 | IsSellableProduct | Sträng | 1 | Är produkten en försäljningsprodukt, true eller false | true |
| 4 | IsStorageProduct | Sträng | 1 | Är produkten lagringsbar, true eller false | false |
| 4 | IsProductStructureProduct | Sträng | 1 | Är produkten en produkt med utökad produkt hantering, true eller false | false |
| 4 | IsModel | Sträng | 1 | Är produkten en modellprodukt, true eller false | false |
| 4 | IsSummaryOfProducts | Sträng | 1 | Är produkten en sammanställningsprodukt, true eller false | false |
| 4 | LastChangedDate | Datum | 1 | Datum för senaste redigering | 2021-03-23 09:30 |
| Attr. | Format | Sträng | 1 | Datumformat, alltid ansi | ansi |
| 3 | ProductGroup | Aggregat | 1 | Produktgrupp | |
| 4 | NetvisorKey | Numerisk | 0...1 | Produktgruppens NetvisorKey | 5 |
| 4 | ProductGroupTranslations | Aggregat | 0...1 | Produktgruppens språköversättningar | |
| 5 | Translation | Sträng | 0...1 | Produktgruppens språköversättning | Produktgrupp |
| Attr. | language | Sträng | 1 | FI, EN eller SE | FI |
| 3 | ProductUnit | Aggregat | 1 | Produktens enhetsinformation | |
| 4 | NetvisorKey | Numerisk | 0...1 | Enhetens NetvisorKey | 10 |
| 4 | ProductUnitTranslations | Aggregat | 0...1 | Enhetens språköversättningar | |
| 5 | Translation | Sträng | 0...1 | Enhetens språköversättning | st |
| Attr. | language | Sträng | 1 | FI, EN eller SE | FI |
| 3 | ProductPriceInformation | Aggregat | 1 | Produktens prisinformation | |
| 4 | DefaultNetPrice | Numerisk | 1 | Produktens nettopris | 5,00 |
| 4 | DefaultGrossPrice | Numerisk | 1 | Produktens bruttopris | 5,00 |
| 4 | Vat | Aggregat | 1 | Produktens MOMS-sats | |
| 5 | NetvisorKey | Numerisk | 1 | MOMS-satsens NetvisorKey | 1 |
| 5 | Percentage | Numerisk | 1 | MOMS-procent | 0 |
| 4 | PriceMargin | Numerisk | 1 | Lägsta försäljningspris | 8,00 |
| 4 | ProvisionPercentage | Numerisk | 1 | Provisionsprocent | 2,00 |
| 4 | PriceGroups | Aggregat | 0...n | Prisgrupper | |
| 5 | Group | Aggregat | 1 | ||
| 6 | NetvisorKey | Numerisk | 1 | Prisgruppens NetvisorKey | 7 |
| 6 | PriceGroupName | Sträng | 1 | Prisgruppens namn | Price group |
| 6 | NetPrice | Numerisk | 1 | Nettopris | 7,00 |
| 6 | GrossPrice | Numerisk | 1 | Bruttopris | 9,00 |
| 4 | CustomerPrices | Aggregat | 0...n | Kundpriser | |
| 5 | Customer | Aggregat | 1 | Kund | |
| 6 | NetvisorKey | Numerisk | 1 | Kundens NetvisorKey | 11 |
| 6 | CustomerCode | Numerisk | 1 | Kundens kundkod | 1000 |
| 6 | CustomerName | Sträng | 1 | Kundens namn | Customer |
| 6 | NetPrice | Numerisk | 1 | Kundspecifikt nettopris | 6,50 |
| 6 | GrossPrice | Numerisk | 1 | Kundspecifikt bruttopris | 8,05 |
| 3 | ProductPurchaseInformation | Aggregat | 0...1 | Inköpsinformation | |
| 4 | DefaultPurchasePrice | Numerisk | 1 | Produktens inköpspris | 2,50 |
| 4 | DistirbuterPurchaseInformations | Aggregat | 0...1 | Leverantörens information | |
| 5 | Distributer | Aggregat | 1 | Leverantör | |
| 6 | NetvisorKey | Numerisk | 1 | Leverantörens NetvisorKey | 33587 |
| 6 | DistributerCode | Numerisk | 1 | Leverantörskod | 855 |
| 6 | DistributerName | Sträng | 1 | Leverantörens namn | Distributer |
| 6 | DistributerProductCode | Sträng | 1 | Leverantörens produktkod | abc |
| 6 | DistributerProductName | Sträng | 1 | Leverantörens produktnamn | Name |
| 6 | PurchasePrice | Numerisk | 1 | Leverantörens inköpspris | 1,50 |
| 6 | CurrencyAbbreviation | Sträng | 1 | Leverantörens valuta | SEK |
| 3 | ProductStorageInformation | Aggregat | 0...1 | Lagerinformation | |
| 4 | DefaultInvetoryPlace | Aggregat | 1 | Standardlager | |
| 5 | NetvisorKey | Numerisk | 0...1 | Lagrets NetvisorKey | 17 |
| 5 | InventoryPlaceName | Sträng | 0...1 | Lagrets namn | Warehouse |
| 4 | InventoryPlaceShelves | Aggregat | 0...1 | Hylla platser | |
| 5 | InventoryPlaceShelve | Aggregat | 1 | Hylla plats | |
| 6 | InventoryPlaceNetvisorKey | Numerisk | 1 | Lagrets NetvisorKey | 22 |
| 6 | InventoryPlaceName | Sträng | 1 | Lagrets namn | Warehouse 1 |
| 6 | ShelveNetvisorKey | Numerisk | 1 | Hylla platsens NetvisorKey | 31 |
| 6 | ShelveName | Sträng | 1 | Hylla platsens namn | Shelve 1 |
| 4 | AlertLimit | Numerisk | 1 | Larmnivå | 10 |
| 4 | CustomsTariffHeader | Sträng | 1 | Tulltariff | Code |
| 4 | ProductBatchLinkingMode | Aggregat | 0...1 | Batch hantering | |
| 5 | NetvisorKey | Numerisk | 1 | Batch hanteringsmetodens NetvisorKey | 4 |
| 5 | Definition | Sträng | 1 | Batch hanteringsmetodens typ | OldestFirstByValueDate |
| 3 | ProductShipmentInformation | Aggregat | 0...1 | Produktens transportinformation | |
| 4 | DefaultProductCountryOfOrigin | Sträng | 1 | Produktens ursprungsland | SE |
| Attr. | type | Sträng | 1 | Alltid ISO-3166 | ISO-3166 |
| 4 | ProductNetWeight | Numerisk | 1 | Produktens nettovikt | 0 |
| Attr. | unit | Sträng | 1 | Viktens enhet | g |
| 4 | ProductGrossWeigh | Numerisk | 1 | Produktens bruttovikt | 0 |
| Attr. | unit | Sträng | 1 | Viktens enhet | g |
| 4 | ProductPackageWidth | Numerisk | 1 | Förpackningens bredd | 0 |
| Attr. | unit | Sträng | 1 | Breddens enhet | cm |
| 4 | ProductPackageHeight | Numerisk | 1 | Förpackningens höjd | 0 |
| Attr. | unit | Sträng | 1 | Höjdens enhet | cm |
| 4 | ProductPackageLength | Numerisk | 1 | Förpackningens längd | 0 |
| Attr. | unit | Sträng | 1 | Längdens enhet | cm |
| 3 | ProductGroupingCriterias | Aggregat | 0..n | Grupperingskriterier | |
| 4 | Translation | Sträng | 1 | Grupperingskriteriets namn | TestGroup |
| Attr. | language | Sträng | 1 | FI, EN eller SE | FI |
| 3 | ProductAccountInformation | Aggregat | 0...1 | Produktens bokföringsinformation | |
| 4 | DefaultDomesticAccountNumber | Numerisk | 1 | Standardkonto för inhemsk försäljning | 3000 |
| 4 | DefaultEuAccountNumber | Numerisk | 1 | Standardkonto för EU-försäljning | 3360 |
| 4 | DefaultOutsideEUAccountNumber | Numerisk | 1 | Standardkonto för försäljning utanför EU | 3380 |
| 4 | DefaultInventoryAccountNumber | Numerisk | 1 | Standard lagerkonto | 1521 |
| 3 | ProductDimensionInformation | Denna artikel har översatts med hjälp av ett AI-baserat översättningsverktyg. Innehållet eller formuleringen i dessa instruktioner kan avvika från dem i andra instruktioner eller i programvaran. |
Hjälpte det här svaret? Ja Nej
Send feedbackVi beklagar att vi inte kunde vara till hjälp. Lämna gärna feedback och hjälp oss att förbättra den här artikeln.