Artikel v2.2 (Vilma 2.8)

Allmän information

Denna endpoint låter dig hämta artikelinformation. Den är designad för att vara flexibel och stödja olika sökparametrar för att förfina din sökning. För fältspecifiktation se Byggmaterialhandlarna.

Tidsbaserad hämtning

finfoSupplierId måste anges vid tidsbaserad hämtning
Om inga tidsparametrar anges, beaktas endast datumet
Alla datum är inkluderande, både from och to
Om även tid används ska den anges i UTC (t.ex. 2023-07-05T12:17:30.974Z)
Om endast from anges, antas to vara den nuvarande tiden

Övriga noteringar

supplierArticleId kräver att finfoSupplierId också anges.

Samtliga svar filtreras på mottagarens specifika leverantörer. Det går alltså inte att hämta artikeldata på en leverantör om man inte lagt en beställning på denna i Finfo-portalen.

Paginering

JSON

{
  "pagination": {
    "offset": 0,
    "limit": 0,
    "totalCount": 2
  },
  "articleList": []
}

I våra API-svar skickar vi alltid med pagineringsinformation, även om det bara förekommer en artikel i svaret. Pagineringen innehåller följande fält:

offset: Anger startpositionen för de returnerade artiklarna.
limit: Anger det maximala antalet artiklar som kan returneras per begäran. Max limit är 1000 artiklar.
totalCount: Anger det totala antalet artiklar som matchar sökkriterierna. Om en artikel finns i flera avtal, räknas varje artikel-avtal-kombination separat i totalCount.

Offset/limit krävs om följande variabler används

finfoSupplierId utan kompletterande variabel
changed-from-date

Avvikelser mot v1.0/article

Numeriska fält skickas inte längre som strängar, det innebär att tomma värden inte skickas som 0 utan som null.
Datum har tidigare endast skickats om de haft ett värde; i v2.1 kommer dessa att skickas med null om värde saknas.
Nya fält har tillkommit i samband med uppdateringen till Vilma 2.7.

Avvikelser mot v2.0/article

I tidigare versioner av API:t skickades datum tillsammans med tidsangivelse, vilket indikerade en högre precision än vad den inkommande datan medgav. Eftersom den mottagna datan endast innehåller ett datum utan tidsangivelse, har vi i den nya versionen av endpointen justerat detta. Alla datum returneras nu utan tidskomponent för att bättre återspegla den faktiska datan och undvika missförstånd gällande precisionen.

Avvikelser mot v2.2/article

Nya fält har tillkommit i samband med uppdateringen till Vilma 2.8.

Formatering av svar (JSON)

JSON

{
    "lnr": "numerisk",
    "artl": "sträng", 
    "eart": "sträng",
    "arts": "numerisk",
    "rsk": "sträng", 
    "tun": "sträng", 
    "nobb": "sträng", 
    "lbn1": "sträng",
    "lbn2": "sträng",
    "bnl1": "sträng",
    "bnl2": "sträng",
    "bens": "sträng",
    "sokl1": "sträng",
    "sokl2": "sträng",
    "sokl3": "sträng",
    "sokl4": "sträng",
    "sokl5": "sträng",
    "pris": "numerisk",
    "enh": "sträng",
    "nkod": "sträng", 
    "pc1": "numerisk",
    "valk": "sträng",
    "jifa": "numerisk",
    "enhj": "sträng",
    "uda": "ÅÅÅÅ-MM-DD",
    "prpr": "numerisk",
    "netpr": "numerisk",
    "npruda": "ÅÅÅÅ-MM-DD",
    "brupr": "numerisk",
    "bpruda": "ÅÅÅÅ-MM-DD",
    "prtbasf": "numerisk",
    "prienh": "sträng",
    "sektprf": "numerisk",
    "sekenh": "sträng",
    "tertprf": "numerisk",
    "terenh": "sträng",
    "priinh": "numerisk",
    "enhpri": "sträng",
    "prean": "sträng",
    "prilen": "numerisk",
    "pribre": "numerisk",
    "prihjd": "numerisk",
    "privikt": "numerisk",
    "privol": "numerisk",
    "prfbein": "sträng",
    "sekinh": "numerisk",
    "enhsek": "sträng",
    "sefbein": "sträng",
    "sdelnin": "sträng",
    "seean": "sträng",
    "terinh": "numerisk",
    "enhter": "sträng",
    "teean": "sträng",
    "bravg": "sträng",
    "rabgr": "sträng",
    "ragben": "sträng",
    "pgrp": "sträng",
    "kalgr": "sträng",
    "kaben": "sträng",
    "unspsc": "sträng",
    "milj": "sträng",
    "regdat": "ÅÅÅÅ-MM-DD",
    "utgkod": "sträng",
    "utgd": "sträng", 
    "ltyp": "sträng",
    "artkl": "sträng",
    "basart": "sträng",
    "statvgrp": "sträng",
    "enummer": "sträng",
    "pribrytk": "numerisk",
    "pdelnin": "sträng",
    "sekbrytk": "numerisk",
    "terbrytk": "numerisk",
    "tdelnin": "sträng",
    "moms": "sträng",
    "seklen": "numerisk",
    "sekbre": "numerisk",
    "sekhjd": "numerisk",
    "sekvikt": "numerisk",
    "sekvol": "numerisk",
    "terlen": "numerisk",
    "terbre": "numerisk",
    "terhjd": "numerisk",
    "tervikt": "numerisk",
    "tervol": "numerisk",
    "intrasta": "sträng",
    "urspland": "sträng",
    "artkod01": "sträng",
    "artkod04": "sträng",
    "artkod05": "sträng",
    "artkod06": "sträng",
    "artkod07": "sträng",
    "artkod08": "sträng",
    "artkod09": "sträng",
    "artkod10": "sträng",
    "artkod11": "sträng",
    "artkod13": "sträng",
    "artkod14": "sträng",
    "artkod17": "sträng",
    "artkod18": "sträng",
    "artkod19": "sträng",
    "artkod20": "sträng",
    "artkod21": "sträng",
    "artkod22": "sträng",
    "lenkk01": "sträng",
    "lenkk02": "sträng",
    "lenkk03": "sträng",
    "lenkk04": "sträng",
    "lenkk05": "sträng",
    "lenkk06": "sträng",
    "lenkk07": "sträng",
    "lenkk08": "sträng",
    "lenkk09": "sträng",
    "prinetpr": "numerisk",
    "prnpruda": "ÅÅÅÅ-MM-DD",
    "seknetpr": "numerisk",
    "senpruda": "ÅÅÅÅ-MM-DD",
    "ternetpr": "numerisk",
    "tenpruda": "ÅÅÅÅ-MM-DD",
    "ldtd": "numerisk",
    "flampkt": "numerisk",
    "unnr": "sträng",
    "tothallb": "numerisk",
    "tempmin": "numerisk",
    "prinetvi": "numerisk",
    "varum": "sträng",
    "fartl": "sträng",
    "fartldat": "sträng", 
    "etimkl": "sträng",
    "sluepdda": "ÅÅÅÅ-MM-DD",
    "biocreg": "sträng",
    "bioregnr": "sträng",
    "forbdat": "ÅÅÅÅ-MM-DD",
    "biockl": "sträng",
    "scipnu01": "sträng",
    "scipnu02": "sträng",
    "infogln": "sträng",
    "pc1dat": "sträng",
    "sprang": "sträng",
    "inkind": "sträng",
    "tillgdat": "ÅÅÅÅ-MM-DD",
    "lansdat": "ÅÅÅÅ-MM-DD",
    "modgmn": "sträng",
    "modnum": "sträng",
    "modbes": "sträng",
    "modvarbes": "sträng"
    "avtid": "sträng", 
    "mainAgreement": "sträng"
}

Exempel på ett API-svar (JSON)

JSON

{
  "pagination": {
    "offset": 0,
    "limit": 0,
    "totalCount": 1
  },
  "articleList": [
    {
      "lnr": 40,
      "artl": "VILMA2.7-1",
      "eart": null,
      "arts": 7759227,
      "rsk": null,
      "tun": "0",
      "nobb": "0",
      "lbn1": "TESTARTIKEL VILMA 2.7",
      "lbn2": "1",
      "bnl1": "TESTARTIKEL VILMA 2.7",
      "bnl2": "1",
      "bens": "ELSPIS",
      "sokl1": null,
      "sokl2": null,
      "sokl3": null,
      "sokl4": null,
      "sokl5": null,
      "pris": 1,
      "enh": "ST",
      "nkod": "0",
      "pc1": 2,
      "valk": "SEK",
      "jifa": null,
      "enhj": null,
      "uda": "2024-05-22",
      "prpr": 1,
      "netpr": null,
      "npruda": null,
      "brupr": null,
      "bpruda": null,
      "prtbasf": 1,
      "prienh": "ST",
      "sektprf": null,
      "sekenh": null,
      "tertprf": null,
      "terenh": null,
      "priinh": 1,
      "enhpri": "ST",
      "prean": "4584545445114",
      "prilen": 100,
      "pribre": 100,
      "prihjd": 100,
      "privikt": 1.1,
      "privol": 1,
      "prfbein": null,
      "sekinh": null,
      "enhsek": null,
      "sefbein": null,
      "sdelnin": null,
      "seean": null,
      "terinh": null,
      "enhter": null,
      "teean": null,
      "bravg": "18001",
      "kunvg": null,
      "rabgr": "1",
      "ragben": "GRUPP1",
      "pgrp": null,
      "kalgr": null,
      "kaben": null,
      "unspsc": "52141504",
      "milj": null,
      "regdat": "2024-05-20",
      "utgkod": "0",
      "utgd": null,
      "ltyp": "L",
      "artkl": "0",
      "basart": null,
      "statvgrp": "18001",
      "enummer": "0",
      "pribrytk": null,
      "pdelnin": null,
      "sekbrytk": null,
      "terbrytk": null,
      "tdelnin": null,
      "moms": null,
      "seklen": null,
      "sekbre": null,
      "sekhjd": null,
      "sekvikt": null,
      "sekvol": null,
      "terlen": null,
      "terbre": null,
      "terhjd": null,
      "tervikt": null,
      "tervol": null,
      "intrasta": "0102211000",
      "urspland": "SE",
      "artkod01": "0",
      "artkod04": "0",
      "artkod05": "0",
      "artkod06": "0",
      "artkod07": "0",
      "artkod08": "0",
      "artkod09": "0",
      "artkod10": "0",
      "artkod11": "0",
      "artkod13": "0",
      "artkod14": "0",
      "artkod17": "1",
      "artkod18": "0",
      "artkod19": "0",
      "artkod20": "1",
      "artkod21": "1",
      "artkod22": "1",
      "lenkk01": null,
      "lenkk02": null,
      "lenkk03": null,
      "lenkk04": null,
      "lenkk05": null,
      "lenkk06": null,
      "lenkk07": null,
      "lenkk08": null,
      "lenkk09": null,
      "prinetpr": null,
      "prnpruda": null,
      "seknetpr": null,
      "senpruda": null,
      "ternetpr": null,
      "tenpruda": null,
      "ldtd": 10,
      "flampkt": null,
      "unnr": null,
      "tothallb": null,
      "tempmin": -12.3,
      "prinetvi": 1,
      "varum": "FINFO",
      "fartl": null,
      "fartldat": null,
      "etimkl": null,
      "sluepdda": "2024-11-30",
      "undvarum": "UNDER1",
      "biocreg": "1",
      "bioregnr": "a23-567-901-34567890",
      "forbdat": "2023-12-05",
      "biockl": "b23456",
      "scipnu01": "xx1111A9DB-D817-4758-9A51-7DEA6E541111xx",
      "scipnu02": "xx2222A9DB-D817-4758-9A51-7DEA6E542222xx",
      "infogln": "7309861014625",
      "pc1dat": "2023-11-30",
      "sprang": "1",
      "inkind": "1",
      "tillgdat": "2023-11-30",
      "lansdat": "2023-11-30",
      "modgmn": "735014655ABC123TT",
      "modnum": null,
      "modbes": "Tröja röd",
      "modvarbes": "stolek large"
      "avtid": null,
      "mainAgreement": "no"
    }
  ]
}