Magnus Karlsson
Updated :
Denna guide är ett hjälpmedel för dig som ska integrera ett externt system med Specter via vårt API. Eftersom olika integratörer har olika lösningar och tekniska förutsättningar, syftar listan nedan till att förklara hur varje specifikt fält i affärssystemet motsvaras av de tekniska fälten i API-beskrivningen (version 3.20).
Öppet API och Beställning
Vårt API är öppet för integrationer. Om ni önskar beställa tillgång till API:et eller har frågor kring licenser, kan ni göra detta direkt i vår shop på https://shop.specter.se/ eller kontakta vår säljavdelning på telefon 0304-649450.
Mappningstabell: Affärssystem vs API
Tabellen nedan innehåller samtliga standardfält för artikel- och lagerdata. Notera att lagerställen och språk hanteras via dynamiska ID-parametrar i API:et. OBS att de olika fälten ingår i olika och ibland samma anrop. Detta är enbart en guide / översättning av hur de benämns i Specter vs API.
| Fält i Specter | API-Fält / Tagg | Beskrivning / Förklaring |
|---|---|---|
| Artikelnummer | articleNo |
Unikt ID för artikeln i systemet. |
| Benämning | name |
Artikelns huvudnamn. |
| Artikelkommentar | articleComment |
Allmän kommentar knuten till artikeln. |
| Artikeltyp | articleType |
Definierar varutyp (t.ex. lagerförd vara). |
| Artikelgrupp Id | groupId |
Koppling till artikelkategori/grupp. |
| Moms Id | vatId |
Systemets interna ID för momssats. |
| Enhet Id | itemUnitId |
Måttenhet (st, m, kg etc.). |
| Förpackningsstorlek | packagingSize |
Antal artiklar per inköpsförpackning. |
| Vikt (kg) | productWeight |
Artikelns vikt angiven i kilogram. |
| Volym (m3) | productVolume |
Artikelns volym angiven i kubikmeter. |
| Streckkod | barCode |
Artikelns EAN- eller streckkod. |
| Intern kommentar | internalComment |
Kommentarer som endast visas internt. |
| Y-kod | yTaric |
Tullkod/Statistiknummer för export/import. |
| Länk artikelbild | articleImageUrl |
URL-länk till artikelns bildfil. |
| Försäljningspris ex moms | priceExclVAT |
Standardpris ut till kund exklusive moms. |
| Försäljningskonto hemland | saleAccount |
Bokföringskonto för inhemsk försäljning. |
| Försäljningskonto EU | saleAccountEU |
Bokföringskonto för försäljning inom EU. |
| Försäljningskonto export | saleAccountExport |
Bokföringskonto för försäljning utanför EU. |
| Kalkylinköpspris | buyPrice |
Teoretiskt inköpspris för marginalberäkning. |
| Kostnadskonto | costAccount |
Inköpskonto i bokföringen. |
| Antal beställda | noItemsOnOrder |
Totalt antal som ligger på lagda inköpsordrar. |
| Inventeringspris | stockPrice |
Lagervärderingspris. |
| Ordinarie pris | standardOldPrice |
Marknadspris/Rekommenderat pris (webbshop). |
| Webshop Kort info | shortArticleInfo |
Kortfattad produktbeskrivning för webb. |
| Webshop Artikelinfo | articleInfo |
Fullständig produktbeskrivning för webb. |
| Webshop Extern länk | extraUrl |
Länk till t.ex. manual eller tillverkare. |
| Webshop Länkbeskrivning | extraUrlDescription |
Visningstext för den externa länken. |
| Webshop Titel | metaTitle |
SEO-titel för sökmotorer. |
| Webshop Nyckelord | metaKeywords |
SEO-nyckelord. |
| Webshop Beskrivning | metaDescription |
SEO-beskrivning (Meta-tagg). |
| Beställningspunkt | orderPoint |
Gräns för när artikeln bör köpas in (per lager). |
| Antal att beställa | noPackagesToOrder |
Systemets förslag på inköpskvantitet. |
| Lagerplats | location |
Specifik hyllplats på aktuellt lagerställe. |
| Lagersaldo | noItems |
Fysiskt antal artiklar på aktuellt lagerställe. |
| Disponibelt lagersaldo | noItemsAv |
Lagersaldo minus reservationer/bokningar. |
| Pris i utländsk valuta | currencyArticlePrice |
Pris i valutor som NOK, GBP, EUR, USD, DKK. |
| Benämning (Språk) | languageSpecificInfo |
Översatt namn (t.ex. Engelska, Finska etc.). |
| Artikelkommentar (Språk) | languageSpecificInfo |
Översatt kommentar per språkkod. |
| Leverantör Id | supplierId |
ID-nummer för huvudleverantören. |
| Leverantör Inköpspris | supplierPrice |
Pris i leverantörens valuta. |
| Leverantör Artikelnr | supplierArticleNo |
Leverantörens eget artikelnummer. |
| Leverantör Tullkostnad | supplierCustomsCost |
Beräknad tullkostnad per artikel. |
| Sekundära leverantörer |
supplierInfo (index)
|
Information om leverantör 2 och 3. |
| Nästa leverans | nextDeliveryDateOnOrder |
Datum då nästa inleverans väntas. |
| Antal vid nästa leverans | noItemsOnOrder |
Antal som väntas vid nästa inleverans. |
| Försäljningskonto (Norge) |
saleAccount (vid land NO)
|
Bokföringskonto för den norska marknaden. |
| Publicera i webshop | viewInShop |
Flagga (Sant/Falskt) för synlighet online. |
Teknisk information för integratörer
Lagerställen: Specter stödjer flera fysiska lagerenheter. I API:et identifieras dessa genom ett
stock id. Istället för separata fältnamn för olika butiker eller lagerplatser, skickas ett ID-nummer i anropet för att styra vilket lager informationen rör.Språkhanting: Översättningar för benämningar och kommentarer (t.ex. på norska, danska eller tyska) hämtas dynamiskt via språkkoder i taggen
languageSpecificInfo.Valutor: Priser i utländska valutor hämtas via valutakoder (t.ex.
code="EUR") undercurrencyArticlePrice.
För fullständiga tekniska specifikationer, XML-strukturer och kodexempel, vänligen se vår kompletta API-dokumentation.
Kommentarer