Article v1.0 FIN20 | Dokumentation

The recommendation is to use the /v1.0/fin20text/noprice/* endpoints as long as prices are not to be sent between information providers and recipients.

Best Practice for Retrieving Article Data via API

When you need to update or retrieve changed article data from Finfo’s system, the following approach is recommended to ensure efficiency and data consistency:

Identify Relevant Suppliers:
Start by identifying the suppliers relevant to you. This can be done by calling /v1.0/suppliers/mysuppliers. The response from this call will contain the finfoSupplierId for each supplier associated with you as a recipient. There may be business reasons for filtering suppliers before retrieval.
Retrieve Changed Article Data:
Use the endpoint /v1.0/article/fin20text/noprice/period to retrieve article data that has changed during a specific period. Provide finfoSupplierId as a variable, along with changed-from-date and changed-to-date to specify the period. Note that changed-from-date is inclusive, while changed-to-date is exclusive. For example, if you set changed-from-date to 2000-01-01 and changed-to-date to 2000-01-02, you will only get data for articles changed on January 1st.
Frequency of Data Retrieval:
It is recommended to retrieve data once per day based on the date of the last successful retrieval. This requires storing information about when the last successful data retrieval occurred. If a retrieval fails, the next day you should retrieve data for the last two days to ensure no data is lost.
Handling New Suppliers:
If you add data from a new supplier or need to synchronize your data with Finfo for any reason, you should use the /v1.0/article/supplier endpoint. This ensures you have all the relevant data for the new supplier. Afterward, the /v1.0/article/period endpoint can be used.

Usage of /v1.0/article/fin20text/noprice/item:

The endpoint /v1.0/article/fin20text/noprice/item should only be used to retrieve data for individual articles. This is not the recommended method for fetching large amounts of data or for keeping your database synchronized with Finfo.

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