hildogjr / KiCost

Build cost spreadsheet for a KiCad project.
MIT License
528 stars 97 forks source link

Add Rutronik as a distributor #574

Open mxa opened 6 days ago

mxa commented 6 days ago

Rutronik is a commercial only distributor. They provide an API, more info here: https://www.rutronik24.com/api.html

(I am aware adding an API is a lot of work, and it's not likely to happen, please regard this issue as a placeholder)

mxa commented 6 days ago

The API Key can be obtained if you have a Rutronic Account.

Rutronik Shop API Vers. 1.3 21.11.2023

Introduction

The Rutronik Shop API provides a simple REST Webservice for searching parts in the Rutronik webshop. Currently the API offers two methods. One for searching parts with an arbitrary searchterm and one for a detailed pricerequest with a concrete partnumber.

With every request you have to send an API-Key. You will get your personal key form your contact person at Rutronik.

The results are returned in JSON format.

Methods overview

Search

Searches and returns max.10 hits to a search term.

Pricerequest

Returns all information about a particular item number The search and pricerequest methods are intended for our customers. They can be used to query customer- specific prices and delivery times.

Article

Designed for search engines. Fast and almost unlimited access to standard prices and delivery times.

Search

Searches for parts in the Rutronik shop. Returns aa array with max. 10 hits.

Request: https://www.rutronik24.com/api/search/?apikey=123&searchterm=xmc4000

Parameter: searchterm your searchterm

JSON-Response:

[{
    "sku": "ICMCU22246",
    "manufacturer": "INFINEON",
    "mpn": "SP001093080",
    "matchcode": "XMC4500-F100K1024 AC",
    "description": "XMC4000 1024K LQFP-100 125\u00b0C ",
    "package": "LQFP-100",
    "packaging": "TRAY",
    "url": "https://www.rutronik24.com/product/infineon/sp001093080/4844292.html",
    "pu": 1,
    "moq": 1,
    "stock": 128,
    "leadtime": 10,
    "currency": "EUR",
    "price": 8.62,
    "pricebreaks": [{
        "quantity": 1,
        "price": 8.62
      },
      {
        "quantity": 100,
        "price": 8.04
      },
      {
        "quantity": 250,
        "price": 7.58
      }]
},
{
      "sku": "ICMCU22250",
      "manufacturer": "INFINEON",
      "mpn": "SP001093082",
      "matchcode": "XMC4500-F144K1024 AC",
      "description": "XMC4000 1024K LQFP-144 125\u00b0C ",
      "package": "LQFP-144",
      "packaging": "TRAY",
      "url": "https://www.rutronik24.com/product/infineon/sp001093082/4844296.html",
      "pu": 1,
      "moq": 1,
      "stock": 334,
      "leadtime": 10,
      "currency": "EUR",
      "price": 8.62,
      "pricebreaks": [{
          "quantity": 1,
          "price": 8.93
      },
      {
          "quantity": 100,
          "price": 8.34
      },
      {
          "quantity": 250,
          "price": 7.86
      }]
}]

Pricerequest

This methods expects a Rutronik partnumber or the name and partnumber of the supplier. Variation 1: Rutronik partnumber: https://www.rutronik24.com/api/pricerequest/?apikey=123&sku=ICMCU22250

Parameter: sku Rutronik partnumber

Variation 2: supplier partnumber: https://www.rutronik24.com/api/pricerequest/?apikey=123&manufacturer=infineon&mpn=SP001093082

Parameter: manufacturer Name of supplier. A list with allowed suppliernames can be found in the download area. mpn supplier partnumber return results are:: matchcode: Rutronik matchcode description: Rutronik description package: e.g.SOT23 packaging: e.g. BULK / REEL / TUBE url link to this article in the Rutronik shop pu: unit pack moq: minimum order quantity stock: free stock leadtime: standard delivery time in weeks provided by supplier currency: ISO-Code e.g. EUR, USD price: price per unit pricebreaks: scale prices

JSON-Response:

{
"sku":"ICMCU22250",
"manufacturer":"INFINEON",
"mpn":"SP001093082",
"matchcode":"XMC4500-F144K1024 AC",
"description":"XMC4000 1024K LQFP-144 125\u00b0C
 ",
"package":"LQFP-144",
"packaging":"TRAY",
"url":"https://www.rutronik.com/product/4844296/INFINEON/SP001093082.html",
"pu":1,
"moq":1,
"stock":340,
"leadtime":10,
"currency":"EUR",
"price":8.93,
"pricebreaks": [{
"quantity": 1,
"price": 8.93
},
{
"quantity": 100,
"price": 8.335
},
{
"quantity": 250,
"price": 7.8588
}
}]

Article

This method is intended for online platforms or component search machines. The Article method can handle a large number of queries, but it provides only the most necessary information about an article, as well as the standard prices and delivery times. The search is for the manufacturer part number. Exactly one article is returned if the part number matches exactly. Request: https://www.rutronik24.com/api/article/?apikey=pa3ni8h2jfwa&mpn=CC0603KPX7R9BB104 Parameter: mpn supplier partnumber

JSON-Response:

{
    "sku": "KKK19097",
    "manufacturer": "YAGEO",
    "mpn": "CC0603KPX7R9BB104",
    "package": "0603",
    "packaging": "REEL PAP",
    "url": "https://www.rutronik24.com/product/yageo/cc0603kpx7r9bb104/30938.html",
    "pu": 15000,
    "moq": 15000,
    "stock": 185865000,
    "leadtime": 18,
    "pipeline": "In Stock",
    "currency": "EUR",
    "price": "0.00179",
    "pricebreaks": [
        {
            "quantity": "15000",
            "price": "0.001969"
        },
        {
            "quantity": "30000",
            "price": "0.001951"
        },
        {
            "quantity": "60000",
            "price": "0.001951"
        },
        {
            "quantity": "75000",
            "price": "0.001933"
        },
        {
            "quantity": "150000",
            "price": "0.001933"
        }
    ]
}