Artikel v1.0 FIN20 | Dokumentation

Rekommendationen är att utgå från /v1.0/fin20text/noprice/* endpoints så länge inte priser ska skickas mellan informationsgivare och mottagare.

Det finns fyra huvudsakliga kategorier av endpoints för artikeldata i FIN20:

article/fin20code/
article/fin20code/noprice
article/fin20text/
article/fin20text/noprice

article/fin20code

Denna endpoint returnerar data med fältnamn från en äldre specifikation. Användning av denna rekommenderas endast för äldre affärssystem inom byggsektorn där fältnamnen i API:et matchar systemets egna.

article/fin20text

Denna kategori använder mer intuitiva och självbeskrivande fältnamn och är att föredra för nyare implementationer.

noprice

Endpoints som innehåller “noprice” är optimerade för snabbare svarstider, då de inte behöver söka i pristabellerna. Detta kan avsevärt minska svarstiden vid hämtning av artiklar.

Best Practice för hämtning av artikeldata via API

När du behöver uppdatera eller hämta förändrad artikeldata från Finfos system, rekommenderas följande tillvägagångssätt för att säkerställa effektivitet och datakonsistens:

Identifiera relevanta leverantörer:
Börja med att identifiera vilka leverantörer som är relevanta för dig. Detta görs genom att anropa /v1.0/suppliers/mysuppliers. Svaret från detta anrop innehåller finfoSupplierId för varje leverantör som är kopplad till dig som mottagare. Det kan finnas affärsmässiga anledningar till att filtrera leverantörer före hämtning.
Hämta förändrad artikeldata:
Använd endpointen /v1.0/article/fin20text/noprice/period för att hämta artikeldata som har förändrats under en specifik period. Ange finfoSupplierId som en variabel tillsammans med changed-from-date och changed-to-date för att specificera perioden. Notera att changed-from-date är inkluderande medan changed-to-date är exkluderande. Det innebär att om du exempelvis anger changed-from-date till 2000-01-01 och changed-to-date till 2000-01-02, kommer du enbart att få data för artiklar som ändrats den 1:a januari.
Frekvens för Datahämtning:
Det är rekommenderat att hämta data en gång per dygn baserat på datumet för den senaste lyckade hämtningen. Detta kräver att du lagrar information om när den senaste lyckade datahämtningen genomfördes. Om en hämtning misslyckas, bör du nästa dag hämta data för de två senaste dagarna för att säkerställa att ingen data går förlorad.
Hantering av Nya Leverantörer:
Om du lägger till data från en ny leverantör eller av någon anledning behöver synkronisera din data med Finfo, bör du använda /v1.0/article/supplier endpointen. Detta säkerställer att du har all relevant data för den nya leverantören. Därefter används /v1.0/article/period.

Användning av/v1.0/article/fin20text/noprice/item:

Endpointen /v1.0/article/fin20text/noprice/item bör endast användas för att hämta data för enstaka artiklar. Detta är inte den rekommenderade metoden för att hämta stora mängder data eller för att hålla din databas synkroniserad med Finfo.

Exempel på ett API-svar (JSON)

JSON

 {
  "pagination": {
    "offset": 0,
    "limit": 1,
    "totalCount": 1570
  },
  "articleList": [
    {
      "supplierId": "3242195",
      "supplierArticleNumber": "G16JCHL",
      "supplierReplacementArticleNumber": null,
      "finfoId": "1317518",
      "rskId": null,
      "tunId": "0",
      "nobbId": "0",
      "supplierArticleDesc1": "OSB/SPÅN/PLYFASKRUV 3,8X28",
      "supplierArticleDesc2": "GRABBER GULKROMATERAD BITS PH2",
      "finfoArticleDesc1": "SPÅN/OSB/PLYFASKRUV GRABBER",
      "finfoArticleDesc2": "GULKROMATERAD BITS PH2 3,8X28",
      "finfoSearchWord": "SPÅNSKIVESKRUV FZB",
      "supplierSearchWord1": null,
      "supplierSearchWord2": null,
      "supplierSearchWord3": null,
      "supplierSearchWord4": null,
      "supplierSearchWord5": null,
      "basePrice": null,
      "basePriceUnit": null,
      "msrp": null,
      "currencyCode": null,
      "priceComparasionFactor": null,
      "priceComparasionUnit": null,
      "pricePer": null,
      "customerSpecificNetPrice": null,
      "customerSpecificMSRP": null,
      "factorBasePrice": "1",
      "primaryPackageUnit": "PKT",
      "factorPrimarySecondaryUnit": "0",
      "secondaryPackageUnit": null,
      "factorPrimaryTertiaryUnit": "0",
      "tertiaryPackageUnit": null,
      "primaryPackageContent": "10",
      "primaryPackageContentUnit": "HST",
      "primaryPackageGTIN": "7391695103903",
      "primaryPackageLength": "108.2",
      "primaryPackageWidth": "92",
      "primaryPackageHeight": "145.2",
      "primaryPackageWeight": "1.926",
      "primaryPackageVolume": "1.445",
      "primaryPackageOrderingIndicator": null,
      "secondaryPackageContent": "0",
      "secondaryPackageContentUnit": null,
      "secondaryPackageOrderingIndicator": null,
      "secondaryPackagingSplittingInfo": null,
      "secondaryPackagingGTIN": null,
      "tertiaryPackageContent": "0",
      "tertiaryPackageContentUnit": null,
      "tertiaryPackagingGTIN": null,
      "productGroupBK04": "05109",
      "customerSpecificProductGroup": "N/A",
      "discountGroupVilma": "02013",
      "priceGroup": null,
      "calculationGroup": null,
      "calculationGroupDescription": null,
      "productGroupUNSPSC": "31161508",
      "articleRegistrationDate": "2009-12-14",
      "endOfLifeDate": null,
      "onDemandProductionCode": "L",
      "statisticsProductGroupBK04": "05109",
      "eNumber": "0",
      "primaryPackageSplitCost": "0",
      "primaryPackageSplitCapability": null,
      "secondaryPackageSplitCost": "0",
      "tertiaryPackageSplitCost": "0",
      "tertiaryPackageSplitInformation": null,
      "vatCode": null,
      "secondaryPackageLength": "0",
      "secondaryPackageWidth": "0",
      "secondaryPackageHeight": "0",
      "secondaryPackageWeight": "0",
      "secondaryPackageVolume": "0",
      "tertiaryPackageLength": "0",
      "tertiaryPackageWidth": "0",
      "tertiaryPackageHeight": "0",
      "tertiaryPackageWeight": "0",
      "tertiaryPackageVolume": "0",
      "commodityCode": "7318129090",
      "originCountry": "TW",
      "bastaIsTrue": "1",
      "bvbIsTrue": null,
      "sundaHusIsTrue": null,
      "euEcolabelIsTrue": "0",
      "svanenIsTrue": "0",
      "braMiljovalIsTrue": "0",
      "fscIsTrue": "0",
      "pefcIsTrue": "0",
      "bastaBetaIsTrue": "0",
      "safetyDataSheetIsTrue": "0",
      "comparativePricingIsTrue": "1",
      "etimIsTrue": "1",
      "code13": "0",
      "code14": "0",
      "code15": "0",
      "code16": "0",
      "code17": "0",
      "code18": "0",
      "code19": "0",
      "code20": "0",
      "code21": "0",
      "code22": null,
      "code23": null,
      "code24": null,
      "code25": null,
      "code26": null,
      "code27": null,
      "code28": null,
      "code29": null,
      "code30": null,
      "customerSpecificPrimaryPackageNetPrice": null,
      "customerSpecificSecondaryPackageNetPrice": null,
      "customerSpecificTertiaryPackageNetPrice": null,
      "leadTime": "0",
      "flashPointTemperature": "0",
      "unCode": null,
      "minimumLifespan": "0",
      "minimumStorageTemperature": null,
      "netWeightPrimaryPackage": "1.84",
      "brandName": "GRABBER",
      "supplierPreviousArticleID": null,
      "supplierPreviousArticleIDChangeDate": null,
      "etimClass": "EC002385"
    }
  ]
}

Fältspecifikation

FIN20	Filed Name	Field specification (SE)
supplierID	Supplier Identification issued by FINFO	Skapas av Finfo och används för att unikt identifiera leverantören. Kontakta Finfo för besked.
supplierArticleNumber	Suppliers article number	Här anges det artikelnummer som leverantören använder i affärskommunikationen med sina kunder. Leverera numret oförändrat till Finfo. Artikelnumret ska vara unikt för artikeln, dvs. det får aldrig förekomma två identiska artikelnummer från samma leverantör. Artikelnummer bör om möjligt aldrig återanvändas, det är tillåtet först efter två år. Artikelnummer är unikt per leverantör, det är dock möjligt för olika leverantörer att ha samma artikelnummer.
supplierReplacementArticleNumber	Suppliers replacement article number	När en artikel utgår och ersätts av en ny artikel, anges den ersättande artikelns nummer.
finfoID	Finfos article number	Skapas av Finfo löpnummer som är unikt, tilldelas artikeln när den är ny och ändras och återanvänds aldrig. Används för att unikt identifiera artikel.
rskID	RSK number	Artikelnummer för VVS-branschens artiklar. Artikelnummer som administreras av VVS info. Kan användas som sökbegrepp för att hitta aktuell artikel.
tunID	TUN number	Byggebasen, Danmarks motsvarighet till Finfo. Informationsfält. Tidigare namn TUN-nummer.
nobbID	NOBB number	Byggvarebasen, Norges motsvarighet till Finfo. Informationsfält.
supplierArticleDescriptionLine1	Suppliers article description line 1	Benämningen ska struktureras enligt följande, varunamn – varutyp – fabrikat – utförande – dimension - innehåll (när detta tillför värde, se Instruktion). Benämningen ska vara på svenska, ska vara unik för varje artikel med undantag när artikel utgår och ersätts av annan med samma benämning. Ev fortsättning LBN2
supplierArticleDescriptionLine2	Suppliers article description line 2	Fortsättning av benämning från LBN1.
supplierSearchWord1	Suppliers search word 1	Möjlighet för leverantören att tillföra sökord/synonym till artikeln. Leverantören kan registrera fem olika sökord i fälten SOKL1 till 5. Kan användas som sökbegrepp för att hitta aktuell artikel.
supplierSearchWord2	Suppliers search word 2	Möjlighet för leverantören att tillföra sökord/synonym till artikeln. Leverantören kan registrera fem olika sökord i fälten SOKL1 till 5. Kan användas som sökbegrepp för att hitta aktuell artikel.
supplierSearchWord3	Suppliers search word 3	Möjlighet för leverantören att tillföra sökord/synonym till artikeln. Leverantören kan registrera fem olika sökord i fälten SOKL1 till 5. Kan användas som sökbegrepp för att hitta aktuell artikel.
supplierSearchWord4	Suppliers search word 4	Möjlighet för leverantören att tillföra sökord/synonym till artikeln. Leverantören kan registrera fem olika sökord i fälten SOKL1 till 5. Kan användas som sökbegrepp för att hitta aktuell artikel.
supplierSearchWord5	Suppliers search word 5	Möjlighet för leverantören att tillföra sökord/synonym till artikeln. Leverantören kan registrera fem olika sökord i fälten SOKL1 till 5. Kan användas som sökbegrepp för att hitta aktuell artikel.
basePrice	Basic price	Leverantörens generella (bas)pris (enligt prislista), exklusive moms. Pris anges med två decimaler, använd kommatecken som decimalavskiljare. Om artikeln inte har något generellt baspris är NKOD obligatorisk.
basePriceUnit	Basic price unit	Enhet för vilket baspriset gäller.
priceTypeCode	Code for price type	Kod som anger varför bas- elle kundunika priset noll. Om artikeln saknar baspris (PRIS) eller kundunikt pris (NETPR), är kod för pristyp obligatorisk
MSRP	Selling price (approximated price)	Försäljningspris exklusive moms. Anges alltid per basprisenhet (ENH).
currencyCode	Currency code	Valutakod för alla prisfält, SEK för svenska kronor. Enligt ISO 4217.
priceComparasionFactor	Factor for Price comparison	Antal jämförprisenheter per basprisenhet. Jämförprisfaktorn är obligatorisk om artikeln inte är undantagen av regelverket. Jämförprisfaktorn är en dividend för att räkna ut jämförpriset i jämförprisenheten.
priceComparasionUnit	Unit for Price comparison	Enhet som jämförpriset anges i.
basePriceEffectiveDate	Effective date for the basic price	Prisgällandedatum från när det nya baspriset börjar gälla. Datumet ändras endast när baspriset ändras.
pricePer	Price per	Anger vilket antal priset gäller för, 1, 100 eller 1000. Om inte baspriset är per 100 eller 1000 ska Pris per vara = 1
factorBasePrice	Factor basic price/primary unit of package	Anger förhållandet mellan basprisenheten och primärförpackningsenheten.
primaryPackageUnit	Primary unit of package	Enhet för primärförpackningen. Primärförpackningen är den enhet som slutkonsument handlar i butiksledet (konsumentförpackning) som också har en egen GTIN. Artikelns primärförpackningsenhet kan ändras om inte förpackningens innehåll (PRIINH) eller enhet (ENHPRI) förändras annars måste en ny artikel skapas.
factorPrimarySecondaryUnit	Factor primary-/secondary unit	Antal primärförpackningar/sekundärförpackning. Sekundärförpackningen är den större enhet som primärförpackningen är förpackad i.
secondaryPackageUnit	Secondary unit of package	Enhet för sekundärförpackningen. Sekundärförpackningen är den större enhet som primärförpackningen är förpackad i.
factorPrimaryTertiaryUnit	Factor primary-/tertiary unit	Faktor primär-/tertiärenhet. Antal primärförpackningar/tertiärförpackning.
tertiaryPackageUnit	Tertiary unit of package	Enhet för tertiärförpackningsenhet. Tertiärförpackningen är den större enhet som sekundärförpackningen är förpackad i.
primaryPackageContent	Content of primary package	Antal för primärförpackningens innehåll.
primaryPackageContentUnit	Unit for primary package content	Enhet för primärförpackningens innehåll.
primaryPackageGTIN	GTIN for primary package	Primärförpackningens GTIN.
primaryPackageLength	Primary package length/depth in mm	Primärförpackningens längd eller djup i mm. Beroende på artikelns användningsområde kan olika sidor betraktas som längd eller djup. Se exempel.
primaryPackageWidth	Primary package width in mm	Primärförpackningens bredd i mm.
primaryPackageHeight	Primary package height in mm	Primärförpackningens höjd i mm. Beroende på artikelns användningsområde kan olika sidor betraktas som höjd. Kommatecken ska användas som decimalavskiljare. Se exempel.
primaryPackageWeight	Primary package weight in kg	Primärförpackningens (brutto)vikt i kg. Vikt inklusive förpackningsmaterial.
primaryPackageVolume	Primary package volume in liter	Primärförpackningens volym i liter.
primaryPackageOrderingIndicator	Primary package ordering indicator	Kod som anger att primärförpackningen inte är beställningsbar från leverantören. Om kod anges måste sekundär- eller tertiärförpackningen vara beställningsbar.
secondaryPackageContent	Content of secondary packaging	Antal för sekundärförpackningens innehåll.
secondaryPackageContentUnit	Unit for secondary package content	Enhet för sekundärförpackningens innehåll.
secondaryPackageOrderingIndicator	Secondary package ordering indicator	Kod som anger att sekundärförpackningen inte är beställningsbar från leverantören. Om kod anges måste primär- eller tertiärförpackningen vara beställningsbar.
secondaryPackagingSplittingInfo	Secondary package splitting information	Sekundärförpackningens delningsinformation. Information för delning av förpackningen.
secondaryPackagingGTIN	GTIN for secondary packaging	Sekundärförpackningens GTIN.
tertiaryPackageContent	Content of tertiary packaging	Antal för tertiärförpackningens innehåll.
tertiaryPackageContentUnit	Unit for tertiary package content	Enhet för tertiärförpackningens innehåll.
tertiaryPackagingGTIN	GTIN for tertiary packaging	Tertiärförpackningens GTIN.
productGroupBK04	Product group BK04	Varugrupp BK04. Bygghandels varugrupp.
discountGroupVilma	Vilma discount group	Artikelgrupp för rabattgivning till återförsäljaren. Syftet med rabattgrupperna är att dela upp hela sortiment i ett antal strategiska grupper baserat på egenskaper. Även om man som leverantör inte själv ger differentierade rabatter ska artiklarna grupperas enligt ”produktegenskaper”. Artiklar med olika rabatt kan inte ligga i samma rabattgrupp. Grupperna kan även användas för kalkylering i mottagande system (hos era kunder).
discountGroupVilmaDescription	Description of (Vilma) discount group	Rabattgruppens benämning. Benämningen av rabattgrupper ska göras så beskrivande som möjligt så man tydligt kan förstå vilka varor som finns i gruppen. Alla artiklar i en och samma rabattgrupp ska ha samma rabattgruppsbenämning och denna ska vara unik för rabattgruppen.
priceGroup	Price group	För gruppering av artiklar med samma försäljningspris.
calculationGroup	Calculation group	Logisk artikelgrupp mot leverantörens sortiment med inriktning mot hjälp med strategisk differentierad utpriskalkylering.
calculationGroupDescription	Description of calculation group	Kalkylgruppens benämning.
productGroupUNSPSC	Product Group UNSPSC	UNSPSC varugrupp, i förekommande fall. En internationell varugruppering i FNs regi.
linkCode	Link code	Länkkod, i förekommande fall. Kod som anger vilken typ/typer av externa länkar som finns på artikeln.
articleRegistrationDate	Article registration date	Artikelns registreringsdatum hos leverantören. Datum då artikeln upprättades i leverantörens artikelregister.
endOfLifeCode	Article discontinuation code	Kod som anger artikelns utgåendestatus. Kod 90 sätts per automatik av Finfo då artikeln varit utgående i mer än 2 år för artiklar med kod 04.
endOfLifeDate	Discontinuation date	Artikelns utgåendedatum. Datum från vilken utgåendekoden gäller.
onDemandProductionCode	Code for stock/on demand production	Kod som anger om artikeln är lager- eller en beställnings-/tillverkningsartikel från leverantören.
articleType	Article Type	Kod som anger vad artikeln är för typ av vara.
productIdentityVilmabas	Product Identity VilmaBas	Egenskapsdeklarerade standardartiklar, för närvarande endast för träprodukter. Kan användas av leverantörer som är anslutna till VilmaBas. VilmaBas produktidentitet kopplas till eget artikelnummer vilket innebär att egen artikel måste uppfylla de kvalitetskrav som är kopplat till aktuell produktidentitet.
statisticsProductGroupBK04	Branch statistics product group BK04	BK04 Branschstatistik, Bygghandelns varugrupp för gemensam statistik. Får inte användas till annat än försäljningsstatistik som ska rapporteras in centralt. Ändras när en ny version driftsätts.
eNumber	E-number	Artikelnummer för elbranschens artiklar. Artikelnummer som administreras av Sveriges ElGrossister. Produkter som säljs i Sverige genom de svenska elgrossisterna kan förses med en egen unik identifikation, ett så kallat E-nummer. Kan användas som sökbegrepp för att hitta aktuell artikel.
primaryPackageSplitCost	Primary package split cost	Kostnad för brytning av primärförpackningen.
primaryPackageSplitCapability	Primary package split capability	Information för delning av primärförpackningen.
secondaryPackageSplitCost	Secondary package split cost	Kostnad för brytning av sekundärförpackningen.
tertiaryPackageSplitCost	Tertiary package split cost	Kostnad för brytning av tertiärförpackningen.
tertiaryPackageSplitInformation	Tertiary package split information	Information för delning av tertiärförpackningen.
vatCode	VAT Code	Kod för vilken momssats artikeln tillhör.
secondaryPackageLength	Secondary package length/depth in mm	Sekundärförpackningens längd/djup i mm.
secondaryPackageWidth	Secondary package width in mm	Sekundärförpackningens bredd i mm.
secondaryPackageHeight	Secondary package height in mm	Sekundärförpackningens höjd i mm.
secondaryPackageWeight	Secondary package gross weight in kg	Sekundärförpackningens bruttovikt i kg.
secondaryPackageVolume	Secondary package volume in liter	Sekundärförpackningens volym i liter.
tertiaryPackageLength	Tertiary package length/depth in mm	Tertiärförpackningens längd/djup i mm.
tertiaryPackageWidth	Tertiary package width in mm	Tertiärförpackningens bredd i mm.
tertiaryPackageHeight	Tertiary package height in mm	Tertiärförpackningens höjd i mm.
tertiaryPackageWeight	Tertiary package gross weight in kg	Tertiärförpackningens bruttovikt i kg.
tertiaryPackageVolume	Tertiary package volume in liter	Tertiärförpackningens volym i liter.
commodityCode	Commodity code	Statistisk varukod (Intrastatnummer) Kod för Tullverkets krav på kodifiering av varor som kan tänkas importeras eller exporteras. Anges med 8 eller 10 siffror. Finfo kontrollerar att angivet nummer återfinns i Tulltaxan.
originCountry	Country of origin	Anger varans ursprungsland. Enligt ISO 3166-1 alpha-2. Definition av ursprungsland är det land där varan har producerats eller tillverkats. Ifall varan har tillverkats i två eller flera olika länder är ursprungslandet det land där det senaste betydande och ekonomiskt motiverade tillverkningen eller behandlingen har skett.
bastaIsTrue	Is Article registered for classification in Basta as BASTA by Supplier	Är artikeln registrerad i Basta som BASTA
euEcolabelIsTrue	Is Article registered for classification in EU Ecolabel by Supplier	Anges om artikeln är registrerad och märkt med EU Ecolabel
svanenIsTrue	Is Article registered for classification in Svanen by Supplier	Anges om artikeln är registrerad och märkt med Svanen
braMiljovalIsTrue	Is Article registered for classification in Bra miljöval by Supplier	Anges om artikeln är registrerad och märkt med Bra miljöval
fscIsTrue	Does Article meet criterias for FSC	Artikeln kan köpas med intyg på faktura om ursprung i FSC-certifierat skogsbruk.
pefcIsTrue	Does Article meet criterias for PEFC	Artikeln kan köpas med intyg på faktura om ursprung i PEFC certifierat skogsbruk.
bastaBetaIsTrue	Is Article registered for classification in Basta as BETA by Supplier	Är artikeln registrerad i Basta som BETA
safetyDataSheetIsTrue	Does Article have a Safety Data Sheet?	Omfattas artikeln av Reach-förordningen (EG) nr 1907/2006, artikel 31 ”Krav på säkerhetsdatablad”? Om ja skall senaste säkerhetsdatablad skickas in till MediaCentralen.
comparativePricingIsTrue	Is Article relevant for Comparative Pricing?	Är artikeln relevant för Jämförpris? Om ja så blir Jämförprisfaktor och tillhörande enhet(JIFA, ENHJ) obligatoriska.
leadTime	Normal lead time	Antal arbetsdagar som produkten normalt kan levereras på från leverantör till handel. Informationen i detta fält anses inte såsom juridiskt bindande utan ska mer ses som preliminär information.
flashPointTemperature	Flash point temperature	Värde i Celsius. Obligatoriskt att ange i de fall produkten omfattas av regel för hantering av brandfarligt gods.
unCode	UN code - dangerous goods number	Koder enligt kodlista ADR-S 2023. Är obligatoriskt att ange i de fall produkten faller under ADR krav.
minimumLifespan	Minimum trade item lifespan from time of production	Ange antal dagar produkten är hållbar. Information är obligatorisk att ange om produkten har en begränsad hållbarhet och datum finns på förpackningen.
minimumStorageTemperature	Minimum storage temperature	Minimum förvaringstemperatur i grader Celsius. Obligatorisk att ange om produkten är temperaturkänslig.
netWeightPrimaryPackage	Net weight of the primary package.	Primärförpackningens nettovikt i kg.
brandName	Brand name	Namn på varumärke för artikeln. Lista med godkända varumärken finns på Finfo-portalen.
supplierPreviousArticleID	Supplier's previous article number	Det artikelnummer som leverantören hade på artikeln innan bytet den FARTLDAT. Nuvarande leverantörsartikelnummer är ARTL.
supplierPreviousArticleIDChangeDate	Date when suppliers article number changed.	Datum då leverantörens artikelnummer byttes ut mot nuvarande. Nuvarande ARTL, föregående FARTL
etimClass	ETIM-class	Artikelns tillhörande ETIM-klass enligt ETIMs modell