Resurs: product.nv
HTTP-metod: POST
Observera! Om Rackbeat lagerhantering används i Netvisor, finns API-beskrivningar här: https://support.netvisor.fi/fi/support/solutions/articles/77000554491-rackbeat-stoplight-rajapinta
För utökad produkthantering kan en ny produkt importeras via API enligt beskrivningen nedan, men uppdatering av produkter via API stöds inte med utökad produkthantering.
Parametrar som används i anropet (QueryString):
| Parameter | Förekomster | Beskrivning | Exempel |
| method | 1 | add eller edit | add |
| id | 0..1 | Om method är edit, behövs id för produkten som ska redigeras | 123 |
| checkdimensionvalidityperiod | 0...1 | Aktiverar kontroll av giltighetsperiod mot verifikationsdatumet. Importen misslyckas om kostnadsobjekt eller rubrik inte är giltig vid verifikationens datum. 1 = kontroll aktiverad | 1 |
| useonlyexistingdimensions | 0...1 | Förhindrar automatisk skapning av nya kostnadsobjektrubriker och kostnadsobjekt. Returnerar ett fel om det angivna kostnadsobjektet inte finns. 1 = blockering aktiverad | 1 |
Om ingen metod har angetts eller om produkten som ska uppdateras inte finns i systemet, returneras INVALID_DATA-fel med beskrivning. Id för produkten som ska uppdateras kan erhållas genom att först fråga produktlistan.
Produktens information kan presenteras exakt med hjälp av nya viktfält (productnetweight, productgrossweigh och productweightunit), det rekommenderas att det gamla produktviktfältet inte längre används (unitweight). Fältet kan fortfarande användas för att säkerställa bakåtkompatibilitet, men i användargränssnittet ändras alla befintliga produkters viktenheter till kilo (kg) och uttrycks i nettopviktfältet.
Den information som ska importeras skickas med anropet som xml enligt beskrivningen nedan (POST-data):
| Nivå | Element | Format | Förekomster | Beskrivning | Exempel |
| Root | root | Aggregat | 1 | ||
| 1 | product | Aggregat | 1 | ||
| 2 | productbaseinformation | Aggregat | 1 | ||
| 3 | productcode | Sträng, max 50 tecken | 0...1 | Produktkod | CC |
| 3 | productgroup | Sträng | 1 | Produktgruppens namn, produkten läggs till i gruppen om produktgruppen finns i systemet. Om den inte finns, skapas den | Böcker |
| 3 | name | Sträng, max 200 tecken | 1 | Produktens namn | Code Complete |
| 3 | description | Sträng | 0...1 | Beskrivning | Andra upplagan |
| 3 | unitprice | Numerisk | 1 | Produktens enhetspris | 42,5 |
| Attr. | type | Sträng | 1 | Anger om det angivna priset är inklusive moms (gross) eller exklusive moms (net). | net |
| 3 | unit | Sträng, max 50 tecken | 0...1 | Produktens enhet, om den angivna enheten inte finns i systemet skapas den. Om den finns, används den befintliga. | st |
| 3 | unitweight | Sträng | 0...1 | Produktens enhetsvikt med två decimaler. Det rekommenderas att detta viktfält (unitweight) inte längre används, utan att de nya viktfälten används (productnetweight, productgrossweigh och productweightunit) | 1,00 |
| 3 | purchaseprice | Numerisk | 0...1 | Inköpspris | 25 |
| 3 | tariffheading | Sträng | 0...1 | Tullkod | Code complete |
| 3 | comissionpercentage | Numerisk | 0...1 | Provisionsprocent | 11 |
| 3 | isactive | Numerisk | 1 | Är produkten aktiv, 0 = inaktiv / 1 = aktiv | 1 |
| 3 | issalesproduct | Numerisk | 1 | Är produkten en försäljningsprodukt, 0 = nej / 1 = ja | 0 |
| 3 | inventoryenabled | Numerisk | 0...1 | Är produkten lagerförd, 0 = nej / 1 = ja | 1 |
| 3 | inventorybatchlinkingmode | Numerisk | 0...1 | Batchhanteringstyp. Tillåtna värden: Ingen batchhantering = 1 Manuell batchval = 2 Leveransdatum, nyaste först = 3 Leveransdatum, äldsta först = 4 (FIFO) Bäst före datum, nyaste först = 5 Bäst före datum, äldsta först = 6 Tillverkningsdatum, nyaste först = 7 Tillverkningsdatum, äldsta först = 8 | 4 |
| 3 | countryoforigin | Sträng | 0...1 | Ursprungsland | FI |
| Attr. | type | Sträng | 0...1 | Alltid ISO-3166 | ISO-3166 |
| 3 | primaryeancode | Sträng | 0...1 | Produktens primära EAN-kod | 123456789012 |
| Attr. | type | Sträng | 0...1 | EAN-kodens typ. API kontrollerar EAN-kodens format enligt typ. any, ean8, ean13, code128. | ean13 |
| 3 | secondaryeancode | Sträng | 0...1 | Produktens sekundära EAN-kod | 12345689012 |
| Attr | type | Sträng | EAN-kodens typ. API kontrollerar EAN-kodens format enligt typ. any, ean8, ean13, code128. | ean13 | |
| 3 | inventoryalertlimit | Numerisk | 0...1 | Larmnivå | 20,50 |
| 2 | productbookkeepingdetails | Aggregat | 0...1 | ||
| 3 | defaultvatpercentage | Numerisk | 1 | Moms-sats, om den angivna skattesatsen inte finns i systemet returneras ett fel | 24 |
| 3 | defaultdomesticaccountnumber | Numerisk | 0...1 | Inhemskt försäljningskonto | 3000 |
| 3 | defaulteuaccountnumber | Numerisk | 0...1 | EU-försäljningskonto | 3360 |
| 3 | defaultoutsideeuaccountnumber | Numerisk | 0...1 | Försäljningskonto utanför EU | 3380 |
| 2 | productadditionalinformation | Aggregat | 0...1 | ||
| 3 | productnetweight | Numerisk | 0...1 | Nettovikt | 11,2 |
| 3 | productgrossweight | Numerisk | 0...1 | Bruttovikt | 12,6 |
| 3 | productweightunit | Sträng | 0...1 | Enhet för netto- och bruttovikt: g, kg eller ton | kg |
| 3 | dimension | Aggregat | 0...1 | ||
| 4 | dimensionname | Sträng | 1 | Kostnadsobjektrubrikens namn. Skapas vid behov. | Projekt |
| 4 | dimensionitem | Sträng | 1 | Kostnadsobjekt. Skapas vid behov. | Projekt 1 |
| 4 | dimensionitemcode | Sträng | 0...1 | Kostnadsobjektets kod (när detta har angetts, ignoreras elementet dimensionitem) | DIMC-001 |
| 4 | dimensionitemname | Sträng | 0...1 | Kostnadsobjektets namn (när detta har angetts, ignoreras elementet dimensionitem) | Item Name 1 |
| 3 | productpackageinformation | Aggregat | 0...1 | ||
| 4 | packagewidth | Numerisk | 1 | Förpackningens bredd i centimeter | 7,3 |
| 4 | packageheight | Numerisk | 1 | Förpackningens höjd i centimeter | 15,0 |
| 4 | packagelength | Numerisk | 1 | Förpackningens längd i centimeter | 36,1 |
| 2 | productcustomtags | Aggregat | 0..1 | ||
| 3 | productcustomtag | Aggregat | 1...n | ||
| 4 | tagname | Sträng | 1 | Tilläggsinformationsfältets namn. | Datumfält |
| 4 | tagvalue | Sträng | 1 | Tilläggsinformationsfältets värde. | 2022-01-01 |
| Attr. | datatype | Sträng | 1 | Tilläggsinformationsfältets typ. date, text, decimal eller enum | date |
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.
