Components are the fundamental building blocks that make up electronic assemblies (PCBs, products, etc.). You can view components in Luminovo under the "Parts" tab. There are OffTheShelf and Custom components in order to get good data quality in Luminovo.
OffTheShelfare all electonic components which have a MPN and can be purchased from an electronic parts suppliers.Customare all other non-electronic components, such as screws, packaging materials, lables, etc. Also, custom are all electronic components which are not standartized and don't have an MPN.
Import your ERP component data into Luminovo.
Important Notes:
We will update your data once/day. For technical reasons, data sent to this endpoint will be imported only once a day on weekdays (Mon-Fri, early in the morning) on our side. Hence, newly uploaded data will therefore usually only become available in the product the next day. Only the last uploaded data will be imported, so every new upload to this endpoint will overwrite the previous one from the same day.
Include all your components in the import. Components with IPNs that were uploaded previously but are not present in a new upload are deleted.
For best results and most up-to-date component library, we recommend uploading your Components once/day at 11 pm CET.
Describes this component. We try to extract the component's specification from this field as well if given.
Your customers' numbers referring to this component.
CPNs will be matched to existing customers by their number.
If a customer name is also given in the input data, the following cases are handled:
- if the customer does not yet exist, it will be created with the number and name provided.
- if the customer exists but has no name yet, it will be updated with the customer name from the input.
- if the customer exists and also has a name, the input customer name is ignored (i.e. the customer's name will not be updated with the input name).
If only a customer number is given in the input data and a customer by that number does not yet exist, the associated CPN is filtered out and will not be imported.
Whether the component is restricted to the customers listed in customer_part_numbers. Defaults to false. If a component is restricted, then it is only visible and available in projects for the listed customers. Beware: if you set it to true and customer_part_numbers is empty you will not be able to use this component in any projects.
Restricting a component is only possible if the component is not currently used in a project by a customer that would violate the new restriction.
I.e. setting this field to true for an existing component that is currently not restricted (i.e. false) is only allowed if the component is not used at all or only used by customers (defined by their numbers) listed in customer_part_numbers. If the component is used in projects of customers that are not listed in customer_part_numbers, the entire update of this component is ignored.
Similarly, for an existing restricted component, the set of customers (defined by their numbers) listed in customer_part_numbers can only be reduced in a new update if the component is not used by the customer that is being removed from the list of restricted customers. If the component is still in use in a project by a customer that is to be removed from the customer_part_numbers list, the entire update of this component is ignored as well.
Whether the component is preferred over other components. Setting this flag will add a star icon to the component for easier visibility. Preferred components may also get sorted to the top in various places of the product, for example in suggestions.
The optional origin this component belongs to. This is useful if you want to upload components from different places separately. Subsequent uploads will only override the components in the same origin.
Caution: If two or more distinct origins are specified in the same upload, the import is considered "full" and will remove all components not provided in the upload.
Caution: Importing components without an origin works as before and is still expected to contain all components at once.
curl -i -X POST \
https://api.luminovo.com/components/import \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '[
{
"internal_part_number": {
"value": "1000-0",
"revision": "rev1"
},
"description": "470R0_1%_TK100_250mW 1206",
"customer_part_numbers": [
{
"value": "123-456",
"revision": "A",
"customer": {
"number": "9987",
"name": "MyOEM"
}
}
],
"is_restricted_to_customers": true,
"is_preferred": true,
"component": {
"type": "OffTheShelf",
"data": {
"specification": {
"type": "BoundToMPNs",
"form_and_fit": {
"name": "0603",
"mounting": "SMT",
"number_of_pins": 2
},
"function": {
"type": "Resistor",
"data": {
"resistance_ohms": "100",
"power_rating_watts": "50",
"tolerance_percent": "5",
"voltage_rating_volts": "10",
"temperature_coefficient_ppmk": "200"
}
},
"approved_manufacturers": [
"Yageo"
]
},
"parts": [
{
"mpn": "RC1206FR-10470RL",
"manufacturer": "Yageo"
}
]
}
},
"origin": "string",
"category": "string"
}
]'