Breadcrumbs

Article v2.2 (Vilma 2.8)

General information

This endpoint allows you to retrieve article information. It is designed to be flexible and support various search parameters to refine your query.

Field specification can be retrieved here.

Time-based retrieval

  • finfoSupplierId must be specified for time-based retrieval.

  • If no time parameters are provided, only the date will be considered.

  • All dates are inclusive, both from and to.

  • If time is also used, it must be specified in UTC (e.g., 2023-07-05T12:17:30.974Z).

  • If only from is provided, to is assumed to be the current time.

Other notes

  • supplierArticleId requires that finfoSupplierId is also specified.

All responses are filtered based on the recipient’s specific suppliers. It is therefore not possible to retrieve article data for a supplier unless an order has been placed for that supplier in the Finfo portal.

Pagination

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

In our API responses, we always include pagination information, even if the response contains only a single article. The pagination includes the following fields:

  • offset: Indicates the starting position of the returned articles.

  • limit: Specifies the maximum number of articles that can be returned per request. The maximum limit is 1000 articles.

  • totalCount: Indicates the total number of articles that match the search criteria. If an article appears in multiple agreements, each article-agreement combination is counted separately in totalCount.

Offset/limit are required when the following variables are used:

  • finfoSupplierId without an accompanying variable

  • changed-from-date

Deviations from v1.0/article

  • Numeric fields are no longer sent as strings. This means that empty values are now sent as null instead of 0.

  • Dates were previously sent only if they had a value; in v2.1 they are now included with a null value when missing.

  • New fields have been added in connection with the update to Vilma 2.7.

Deviations from v2.0/article

In previous API versions, dates were sent with a time component, which indicated higher precision than the incoming data allowed. Since the received data only contains a date without a time component, this new version of the endpoint adjusts accordingly. All dates are now returned without a time component to better reflect the actual data and avoid misunderstandings about precision.

Deviations from v2.2/article

  • New fields have been added in connection with the update to Vilma 2.8.

Response formatting (JSON)

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

Example of an API response (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"
    }
  ]
}