mirror of
https://github.com/inventree/inventree-website.git
synced 2025-05-06 17:28:53 +00:00
352 lines
14 KiB
HTML
352 lines
14 KiB
HTML
<!DOCTYPE html>
|
||
<html lang=" en-US ">
|
||
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||
|
||
<link rel="stylesheet" href="/assets/splide/css/splide.min.css">
|
||
<link rel="stylesheet" href="/assets/index.css">
|
||
<link rel="shortcut icon" type="image/png" href="/assets/icon/favicon.ico">
|
||
|
||
<script src="/assets/splide/js/splide.min.js"></script>
|
||
|
||
<!-- Fontawesome integration -->
|
||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.2.1/css/all.min.css">
|
||
|
||
<title>InvenTree - Inventree Supplier Panel</title>
|
||
<meta itemprop="description" name="description"
|
||
content="InvenTree is an open-source inventory management system which provides intuitive parts management and stock control. It is at the center of an ecosystem of a..." />
|
||
|
||
<!-- Begin Jekyll SEO tag v2.8.0 -->
|
||
<title>Inventree Supplier Panel | InvenTree</title>
|
||
<meta name="generator" content="Jekyll v4.3.3" />
|
||
<meta property="og:title" content="Inventree Supplier Panel" />
|
||
<meta name="author" content="SergeoLacruz" />
|
||
<meta property="og:locale" content="en_US" />
|
||
<meta name="description" content="Create Mouser shopping cart from purchase order" />
|
||
<meta property="og:description" content="Create Mouser shopping cart from purchase order" />
|
||
<link rel="canonical" href="/SergeoLacruz/inventree-supplier-panel" />
|
||
<meta property="og:url" content="/SergeoLacruz/inventree-supplier-panel" />
|
||
<meta property="og:site_name" content="InvenTree" />
|
||
<meta property="og:type" content="article" />
|
||
<meta property="article:published_time" content="2024-04-17T00:53:22+00:00" />
|
||
<meta name="twitter:card" content="summary" />
|
||
<meta property="twitter:title" content="Inventree Supplier Panel" />
|
||
<script type="application/ld+json">
|
||
{"@context":"https://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"SergeoLacruz"},"dateModified":"2024-04-17T00:53:22+00:00","datePublished":"2024-04-17T00:53:22+00:00","description":"Create Mouser shopping cart from purchase order","headline":"Inventree Supplier Panel","mainEntityOfPage":{"@type":"WebPage","@id":"/SergeoLacruz/inventree-supplier-panel"},"url":"/SergeoLacruz/inventree-supplier-panel"}</script>
|
||
<!-- End Jekyll SEO tag -->
|
||
|
||
</head>
|
||
|
||
<body class="flex flex-col antialiased cm-gray-1 min-h-screen">
|
||
<div class="flex-none">
|
||
<header class="cm-gray-2 body-font sticky top-0 z-50 bg-gradient-to-r from-white to-secondary">
|
||
<div class="container mx-auto flex flex-wrap p-5 flex-row items-center">
|
||
<a class="flex title-font font-medium items-center cm-gray-1 mb-0 mr-2" href="/">
|
||
<img src="/assets/logo.png" alt="logo" height="32" width="32" class="h-8">
|
||
<span class="ml-3 text-xl">InvenTree</span>
|
||
</a>
|
||
|
||
<div class="flex-grow xs:flex-none"></div>
|
||
|
||
<nav class="md:mr-auto md:py-1 xs:ml-4 xs:pl-4 xs:border-l xs:border-gray-400 flex flex-wrap items-center text-base justify-center">
|
||
<a class="mr-5 hover:cm-gray-1" href="/deploy.html">Deploy</a>
|
||
<a class="mr-5 hover:cm-gray-1" href="https://docs.inventree.org/en/latest/">Docs</a>
|
||
<a class="mr-5 hover:cm-gray-1" href="/blog">Blog</a>
|
||
</nav>
|
||
|
||
|
||
</div>
|
||
</header> <article class="max-w-p90">
|
||
|
||
<h2>inventree-supplier-panel
|
||
<span class="sm:ml-2 text-sm">
|
||
<a href="/SergeoLacruz">
|
||
<span class="inline-flex">
|
||
<img src="https://github.com/SergeoLacruz.png?size=40" alt="mdo" class="self-center w-5 h-5 rounded-full" style="margin:0px">
|
||
<p> SergeoLacruz</p>
|
||
</span>
|
||
</a></span>
|
||
<span class="sm:ml-2 text-sm">last modified: 17 Apr 2024</span>
|
||
</h2>
|
||
|
||
<div class="flex-wrap md:flex md:flex-nowrap">
|
||
<div class="w-full md:w-auto md:mr-4">
|
||
<p>Create Mouser shopping cart from purchase order</p>
|
||
|
||
<p>This is a plugin for <a href="https://inventree.org">InvenTree</a>, which translates a purchase order
|
||
into a Mouser shopping cart. After using this plugin you can directly order the shopping
|
||
cart on the Mouser WEB page. You need to have a Mouser account and a Mouser API key.
|
||
The shopping cart will be created in your Mouser account.</p>
|
||
|
||
<h2 id="prerequisites">Prerequisites</h2>
|
||
|
||
<p>For this plugin to work you need to have Mouser as as supplier in your InvenTree data.
|
||
Suppliers parts must be added to all the parts that you like to buy at Mouser. All Mouser supplier
|
||
parts need to have the proper SKU. It needs to match the Mouser part number exactly.</p>
|
||
|
||
<p>For access to the Mouser API you need a Mouser account and a shopping cart API key.
|
||
You can get this on the Mouser WEB page. Do not mess up with the Mouser search API
|
||
key. This is different. If the key is properly set up you can find it on the Mouser
|
||
WEB page here:</p>
|
||
|
||
<p><img src="/assets/plugins/mouser_api.png" alt="Mouser WEB"></p>
|
||
|
||
<h2 id="installation">Installation</h2>
|
||
|
||
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>pip install git+https://github.com/SergeoLacruz/inventree-supplier-panel
|
||
</code></pre></div></div>
|
||
|
||
<h2 id="configuration">Configuration</h2>
|
||
<h3 id="mouser-supplier-id">Mouser Supplier ID</h3>
|
||
<p>Place here the primary key of the supplier Mouser in your system. You can select from a list of
|
||
your suppliers.</p>
|
||
|
||
<h3 id="supplier-api-key">Supplier API key</h3>
|
||
<p>Place here you Mouser key for manipulating shopping carts.</p>
|
||
|
||
<h3 id="supplier-shopping-cart-key">Supplier shopping cart key</h3>
|
||
<p>Each shopping cart on the Mouser page has a designated key. You can have several shopping carts
|
||
in our account. Each cart has a separate key. The plugin puts your PO into the cart with this key.
|
||
If you do not have a shopping cart key, leave the field empty. The plugin will create a cart
|
||
and save the key in the field.</p>
|
||
|
||
<h3 id="proxies">Proxies</h3>
|
||
<p>In case you need to authorise a proxy server between your InvenTree server and the internet
|
||
put the required setting here. The argument for the request is {‘Proxy CON’ : ‘Proxy URL’} for
|
||
example:</p>
|
||
|
||
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>{ 'https' : 'https://user:password@ipaddress:port' }
|
||
</code></pre></div></div>
|
||
|
||
<p>If you do not need this just leave Proxy CON empty.</p>
|
||
|
||
<h2 id="what-it-does">What it does</h2>
|
||
|
||
<p>The plugin creates a new panel which is visible on the purchase order details view.
|
||
This is called Mouser actions. On the panel there are three things:</p>
|
||
|
||
<ul>
|
||
<li>a button that starts the transfer of your PO to Mouser</li>
|
||
<li>a status bar that shows error messages</li>
|
||
<li>a table that contains the created Mouser shopping cart.</li>
|
||
</ul>
|
||
|
||
<p><img src="/assets/plugins/mouser_panel.png" alt="Mouser Panel"></p>
|
||
|
||
<p>The button initiates the transfer. It takes each element of your PO, takes the SKU of
|
||
the Mouser supplier part and adds it into your shopping cart. When finished it downloads
|
||
the shopping cart from the Mouser WEB page and puts the data into the table. Here you see
|
||
the actual stock at mouser and an OK bubble when the stock is large enough for you order.
|
||
You also find the actual price as well as the total amount of your order.</p>
|
||
|
||
<p>All items that have been in the cart before get deleted. The cart always contains only the parts
|
||
in your PO. SergelLacruz</p>
|
||
|
||
<p>The plugin also transfers your IPNs (internal part numbers). Mouser reserves a field
|
||
for such numbers. They show up in your shopping cart as well as on the invoice and even
|
||
on the labels that they put onto the bags and reels.</p>
|
||
|
||
<p>Finally the prices that come with the Mouser shopping cart will be copied back into your
|
||
InvenTree purchase order line items. So you can always see what you payed for the part when
|
||
you ordered it. This does not modify the price breaks of the supplier part. These are stored
|
||
with the supplier part. Here we just modify the purchase order.</p>
|
||
|
||
<p>The panel is only displayed when the supplier of the current purchase order is Mouser.
|
||
In addition the current user must have change, add or delete access to purchase orders.</p>
|
||
|
||
<h2 id="issues">Issues</h2>
|
||
<h3 id="mouser-messed-up">Mouser messed up</h3>
|
||
<p>It can happen that the Mouser shopping cart API gets messed up and no item are added into
|
||
your cart. Just delete the cart in that case and delete the key in the plugin setting.
|
||
A new key will be created and usually works.</p>
|
||
|
||
<h3 id="api-keys-are-global">API keys are global</h3>
|
||
<p>The API keys and especially the proxy password are user specific and shall not be given to
|
||
others. Up to now there are no user specific settings in InvenTree. So these keys are global
|
||
and visible to, at least every admin. All users who use the plugin will have the same
|
||
keys. We use a team key to solve this.</p>
|
||
|
||
<h3 id="other-suppliers">Other suppliers</h3>
|
||
<p>Actually this works only for Mouser. Other suppliers like Digikey, Farnell or Buerklin
|
||
might follow.</p>
|
||
|
||
|
||
</div>
|
||
|
||
<div class="w-full md:w-1/4">
|
||
<h2 class="block sm:hidden">Detail section</h2>
|
||
<div>
|
||
<p class="mb-0">License:
|
||
<small>
|
||
<i class="fa-brands fa-osi"></i>
|
||
MIT<br>
|
||
</small>
|
||
</p>
|
||
<div class="">
|
||
Status:<br>
|
||
<div>
|
||
<small>
|
||
|
||
<i class="fa-regular fa-circle-check success"></i>Stable
|
||
|
||
</small>
|
||
</div>
|
||
<div>
|
||
<small>
|
||
|
||
<i class="fa-regular fa-circle-check success"></i>Maintained
|
||
|
||
</small>
|
||
</div>
|
||
</div>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<a href="https://github.com/SergeoLacruz/inventree-supplier-panel/issues" class="no-underline" aria-label="open the issue tracker">
|
||
<div>
|
||
<h4 class="plugin_links">Issue Tracker <i class="fa-solid fa-arrow-up-right-from-square" title="External link"></i>
|
||
</h4>
|
||
</div>
|
||
</a>
|
||
|
||
|
||
|
||
<a href="https://github.com/sergeolacruz/inventree-supplier-panel" class="no-underline" aria-label="open source on GitHub">
|
||
<div>
|
||
<h4 class="plugin_links">Sourcecode on GitHub <i class="fa-solid fa-arrow-up-right-from-square" title="External link"></i>
|
||
</h4>
|
||
<p class="font-normal">sergeolacruz/inventree-supplier-panel</p>
|
||
</div>
|
||
</a>
|
||
|
||
|
||
|
||
|
||
<div>
|
||
<h4 class="plugin_links">Categories</h4>
|
||
<div>
|
||
|
||
<a href="/plugins/categories/#supplier"><span class="plugin_cat">Supplier</span></a>
|
||
|
||
</div>
|
||
</div>
|
||
|
||
<div>
|
||
<h4 class="plugin_links">Tags</h4>
|
||
<div>
|
||
|
||
<a href="/plugins/tags/#supplier"><span class="plugin_tag">supplier</span></a>
|
||
|
||
<a href="/plugins/tags/#mouser"><span class="plugin_tag">mouser</span></a>
|
||
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
</article>
|
||
|
||
</div>
|
||
|
||
<div class="flex-grow"></div>
|
||
<div class="flex-none">
|
||
<footer class="cm-gray-2 body-font">
|
||
<div class="container px-5 pt-8 mx-auto flex md:flex-row md:flex-nowrap flex-wrap flex-col">
|
||
<div class="w-64 flex-shrink-0 md:mx-0 mx-auto text-center md:text-left">
|
||
<div class="flex title-font font-medium items-center md:justify-start justify-center cm-gray-1">
|
||
<img src="/assets/logo.png" alt="logo" height="32" width="32" class="h-8">
|
||
<span class="ml-3 text-xl">InvenTree</span>
|
||
</div>
|
||
<p class="mt-2 text-sm cm-gray-3">Intuitive Inventory Management</p>
|
||
</div>
|
||
|
||
<div class="flex-grow flex flex-wrap md:pl-10 mb-1 md:mt-0 mt-10 md:text-left text-center md:justify-left justify-center">
|
||
|
||
|
||
<div class="md:w-1/4 px-4">
|
||
<h2 class="footer-categorie title-font">
|
||
Quick
|
||
</h2>
|
||
<nav class="list-none mb-10"><ul>
|
||
|
||
<li><a href="/demo.html" class="footer-link">Demo</a></li>
|
||
|
||
<li><a href="/deploy.html" class="footer-link">Deploy</a></li>
|
||
|
||
<li><a href="https://docs.inventree.org/en/latest/" class="footer-link">Docs</a></li>
|
||
|
||
<li><a href="/news" class="footer-link">News</a></li>
|
||
|
||
<li><a href="/plugins" class="footer-link">Plugin List</a></li>
|
||
|
||
</ul></nav>
|
||
</div>
|
||
|
||
<div class="md:w-1/4 px-4">
|
||
<h2 class="footer-categorie title-font">
|
||
<a href="/extend/">Ecosystem</a>
|
||
</h2>
|
||
<nav class="list-none mb-10"><ul>
|
||
|
||
<li><a href="/extend/api.html" class="footer-link">API</a></li>
|
||
|
||
<li><a href="/extend/app.html" class="footer-link">App</a></li>
|
||
|
||
<li><a href="/extend/plugin/" class="footer-link">Plugins</a></li>
|
||
|
||
<li><a href="/extend/integrate/" class="footer-link">Integrations</a></li>
|
||
|
||
</ul></nav>
|
||
</div>
|
||
|
||
<div class="md:w-1/4 px-4">
|
||
<h2 class="footer-categorie title-font">
|
||
Sitemap
|
||
</h2>
|
||
<nav class="list-none mb-10"><ul>
|
||
|
||
<li><a href="/about/" class="footer-link">About</a></li>
|
||
|
||
<li><a href="/alternatives/" class="footer-link">Alternatives</a></li>
|
||
|
||
<li><a href="/blog" class="footer-link">Blog</a></li>
|
||
|
||
<li><a href="/contribute.html" class="footer-link">Contribute</a></li>
|
||
|
||
<li><a href="/support.html" class="footer-link">Support</a></li>
|
||
|
||
</ul></nav>
|
||
</div>
|
||
|
||
</div>
|
||
</div>
|
||
|
||
<div class="bg-gray-100">
|
||
<div class="container mx-auto py-4 px-5 flex flex-wrap flex-col sm:flex-row">
|
||
<p class="cm-gray-2 text-sm text-center sm:text-left">© 2021-now InvenTree by<a href="https://github.com/inventree" rel="noopener" class="cm-gray-2 ml-1" target="_blank">@inventree</a>— website made with ♥ by<a href="https://github.com/matmair" rel="noopener" class="cm-gray-2 ml-1" target="_blank">@matmair</a></p>
|
||
<span class="inline-flex sm:ml-auto sm:mt-0 mt-2 justify-center sm:justify-start">
|
||
<a href="https://github.com/inventree/inventree" alt="github repo" class="ml-3 cm-gray-3">
|
||
<img class="h-5 w-5" alt="GitHub logo" src="/assets/github.svg">
|
||
</a>
|
||
<a href="https://reddit.com/r/inventree" alt="Reddit" class="ml-3 cm-gray-3">
|
||
<img class="h-5 w-5" alt="Reddit logo" src="/assets/reddit.svg">
|
||
</a>
|
||
<a href="https://twitter.com/inventreedb" alt="Twitter" class="ml-3 cm-gray-3">
|
||
<img class="h-5 w-5" alt="Twitter logo" src="/assets/twitter.svg">
|
||
</a>
|
||
</span>
|
||
</div>
|
||
</div>
|
||
</footer>
|
||
</div>
|
||
</body>
|
||
|
||
</html>
|