Allmänt
Pris-endpointen ger tillgång till leverantörers prisinformation för artiklar registrerade i Finfo. Endpointen returnerar baspriser, förpackningsinformation, brytkostnader, jämförprisinformation samt avtalspriser.
Version 1.2 utvidgar version 1.1 med strukturerad momsinformation.
Nyheter i version 1.2
I version 1.2 har momsinformationen utökats från en enkel kod till ett strukturerat objekt med både kod och klartext. Momsinformationen levereras nu via ett vat-objekt med följande koder:
01 - Standard (25%)
02 - Livsmedel (12% | tillfälligt 6%)
03 - Tidningar (6%)
04 - Momsfritt (0%)
Objektet innehåller både code (tvåsiffrig kod) och name (beskrivande text), vilket gör det enklare att tolka momsinformationen utan att behöva en separat kodtabell.
Grundläggande artikelinformation
Varje prissvar innehåller identifierande information för artikeln. finfoSupplierId är leverantörens unika ID i Finfo, articleId är Finfos interna artikel-ID (Finfonummer), supplierArticleId är leverantörens eget artikelnummer som används i affärskommunikationen, och gtin är artikelns GTIN (streckkod).
Baspriser
Baspriset (basePrice) är leverantörens generella baspris exklusive moms, angivet med två decimaler. Baspriset anges i den enhet som basePriceUnit specificerar. Fältet pricePer anger hur många enheter priset gäller för (1, 100 eller 1000).
Basprisets giltighetsdatum anges i basePriceStartDate, vilket ändras enbart vid prisändring. Fältet basePriceUpdatedDate anger när prisinformationen senast uppdaterades i Finfo.
Om baspriset är noll kan basePriceCode ange orsaken:
-
1 = Pris på begäran
-
2 = Dagspris
-
3 = Kedjeberoende/kampanj
Rekommenderat försäljningspris (ca-pris) levereras via recommendedPrice med tillhörande startdatum i recommendedPriceStartDate. Försäljningspriset anges exklusive moms per basprisenhet.
Valutan för samtliga prisfält anges i currency enligt ISO 4217 (t.ex. SEK för svenska kronor).
Förpackningsenheter och faktorer
Prissvaret beskriver förhållandet mellan basprisenheten och artikelns förpackningsnivåer.
factorBasePriceUnitPrimaryPackingUnit anger förhållandet mellan basprisenheten och primärförpackningsenheten. factorBasicPricevsPrimaryUnit anger antal basenheter per primärförpackning. primaryUnitPackage anger enheten för primärförpackningen (konsumentförpackningen).
factorPrimaryvsSecondaryUnit anger antal primärförpackningar per sekundärförpackning, och secondaryUnitPackage anger enheten för sekundärförpackningen.
factorPrimaryvsTertiaryUnit anger antal primärförpackningar per tertiärförpackning, och tertiaryUnitPackage anger enheten för tertiärförpackningen.
Jämförprisinformation
För artiklar där jämförpris är relevant levereras factorForPriceComparison, som anger antal jämförprisenheter per basprisenhet, samt unitForPriceComparison, som anger enheten jämförpriset uttrycks i.
Brytkostnader
Brytkostnader och delningsinformation levereras per förpackningsnivå.
För primärförpackningen anges brytkostnaden i primaryPackageSplitCost och delningsinformation i primaryPackageSplitInformation.
För sekundärförpackningen anges motsvarande i secondaryPackageSplitCost och secondaryPackageSplitInformation.
För tertiärförpackningen anges motsvarande i tertiaryPackageSplitCost och tertiaryPackageSplitInformation.
Momsinformation
Momsinformationen levereras i version 1.2 som ett strukturerat objekt (vat) med två fält: code och name.
Följande momskoder används:
code: "01", name: "Standard" - Standardmoms (25%)
code: "02", name: "Livsmedel" - Reducerad moms för livsmedel (12% | tillfälligt 6%)
code: "03", name: "Tidningar" - Reducerad moms för tidningar (6%)
code: "04", name: "Momsfritt" - Ingen moms (0%)
Avtalspriser
Avtalsinformationen levereras som en lista (agreements) där varje avtal innehåller följande information.
agreementId är Finfos interna avtals-ID. supplierAgreementId är leeverantörens eget avtals-ID. agreementPriceType anger typen av avtalspris. agreementText är en fritext från leverantören som beskriver avtalet. agreementChangeDate anger när avtalet senast ändrades.
Varje avtal kan innehålla en lista av priser (prices) med följande information: priceStartDate och priceEndDate anger giltighetstiden för priset, priceSupplierText är leverantörens beskrivning av priset, agreementPriceUpdatedDate anger när avtalspriset senast uppdaterades, articlePriceType anger pristypen, price är själva priset, discount anger eventuell rabatt, packaging anger vilken förpackningsnivå priset avser, och gtin anger GTIN för den aktuella förpackningen.
Tillgängliga endpoints
Endpointen är tillgänglig i tre varianter: hämtning av prisinformation för en enskild artikel, hämtning av alla priser för en specifik leverantör, samt hämtning av prisändringar inom en angiven tidsperiod.
{
"pagination": {
"offset": 0,
"limit": 1,
"totalCount": 1207
},
"articleList": [
{
"finfoSupplierId": 55103782,
"articleId": 5054119,
"supplierArticleId": "2017095430RPK",
"gtin": "7340080300595",
"recommendedPrice": "248",
"recommendedPriceStartDate": "2025-07-01",
"basePrice": "48.1",
"basePriceUnit": "M",
"pricePer": "1",
"basePriceStartDate": "2018-07-01",
"basePriceUpdatedDate": "2018-05-29T11:23:23.000+02:00",
"basePriceCode": null,
"factorBasePriceUnitPrimaryPackingUnit": "1",
"vat": {
"code": "01",
"name": "STANDARD"
},
"currency": "SEK",
"factorForPriceComparison": "0",
"unitForPriceComparison": null,
"factorBasicPricevsPrimaryUnit": "1",
"primaryUnitPackage": "M",
"factorPrimaryvsSecondaryUnit": "0",
"secondaryUnitPackage": null,
"factorPrimaryvsTertiaryUnit": "0",
"tertiaryUnitPackage": null,
"primaryPackageSplitCost": "0",
"primaryPackageSplitInformation": null,
"secondaryPackageSplitCost": "0",
"secondaryPackageSplitInformation": null,
"tertiaryPackageSplitCost": "0",
"tertiaryPackageSplitInformation": null,
"agreements": [
{
"agreementId": 8064,
"supplierAgreementId": "BYGG4",
"agreementPriceType": "net",
"agreementText": "Ej Virkes samverkan BT.",
"agreementChangeDate": "2022-07-01T06:38:04.000+02:00",
"prices": [
{
"priceStartDate": "2022-07-01",
"priceEndDate": "9999-01-01",
"agreementPriceUpdatedDate": "2022-06-28T21:01:22.000+02:00",
"articlePriceType": "net",
"price": 77.67
}
]
},
{
"agreementId": 8551,
"supplierAgreementId": "BYGG1",
"agreementPriceType": "net",
"agreementText": "Virkes Samverkan BT.",
"agreementChangeDate": "2022-07-01T06:37:45.000+02:00",
"prices": [
{
"priceStartDate": "2022-07-01",
"priceEndDate": "9999-01-01",
"agreementPriceUpdatedDate": "2022-06-28T21:03:53.000+02:00",
"articlePriceType": "net",
"price": 78.34
}
]
}
]
}
]
}