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 |
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 | Kostnadsobjektets namn. Skapas vid behov. | Projekt |
| 4 | dimensionitem | Sträng | 1 | Kostnadsobjekt. Skapas vid behov. | Projekt 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 |
Hjälpte det här svaret? Ja Nej
Send feedback