PartsBox è uno strumento online per la gestione dell'inventario dei componenti elettronici, dei prezzi delle distinte base e della produzione. Fornisce una piattaforma centralizzata per l'intero processo di produzione elettronica — dall'approvvigionamento e stoccaggio dei componenti alla costruzione di progetti e al tracciamento della produzione.
Le funzionalità chiave includono:
PartsBox è progettato per essere veloce, discreto e facile da usare. L'interfaccia è reattiva — la ricerca di componenti, il controllo delle scorte e la gestione dei progetti avvengono istantaneamente. Più utenti possono lavorare contemporaneamente, con le modifiche visibili a tutti in tempo reale.
A differenza dei tradizionali strumenti ERP (Enterprise Resource Planning) o MRP (Material Requirements Planning), PartsBox è facile da introdurre e integrare in un flusso di lavoro esistente, con il minimo attrito. L'obiettivo è uno strumento che ti aiuti a rimanere organizzato ed efficiente senza intralciarti.
Questa sezione ti guida attraverso le basi di PartsBox: creare un luogo di stoccaggio, aggiungere un componente, immagazzinarlo e costruire il tuo primo progetto. Ogni passaggio si basa sul precedente e alla fine avrai un progetto funzionante con una distinta base (BOM) prezzata. Le sezioni successive di questa guida trattano ogni argomento in modo molto più dettagliato.
Prima di aggiungere componenti, imposta almeno un luogo di stoccaggio per rappresentare dove risiederanno fisicamente i tuoi componenti. Vai su 'Stoccaggio' nel menu in alto e fai clic su 'Crea'. La scheda predefinita è 'Singolo', che crea un solo luogo.
Inserisci un nome per il tuo luogo di stoccaggio (ad esempio, 'b01' per la tua prima scatola, o 'scaffale-A1' per uno scomparto dello scaffale) e fai clic su 'Crea'. Puoi sempre aggiungere altri luoghi in seguito, incluse griglie di luoghi per scatole con scomparti.
Per suggerimenti su come nominare i luoghi di stoccaggio, consulta la sezione Luoghi di stoccaggio sotto Giacenza e Stoccaggio.
Naviga su 'Componenti' nel menu in alto e fai clic su 'Crea'. Vedrai una scelta di tipi di componenti: Componente collegato, Componente locale e Meta-componente.
Scegli 'Componente collegato' se il tuo componente ha un codice componente del produttore (MPN). Digita l'MPN nel campo 'Corrispondenza nome esatto componente' e fai clic su 'Corrispondenza'. PartsBox cercherà il tuo componente e visualizzerà i risultati corrispondenti insieme alle loro specifiche e ai link ai datasheet. Seleziona la corrispondenza corretta dall'elenco e fai clic su 'Crea Componente'.
Se il tuo componente non ha un MPN (un resistore generico, un PCB, un componente meccanico personalizzato), scegli invece 'Componente locale' e inserisci un nome.
Per maggiori dettagli sui tipi di componenti, consulta la sezione Cosa sono i componenti? in Componenti.
Dopo aver creato un componente, devi aggiungere scorte per rappresentare i componenti fisici che hai a disposizione. Vai alla pagina dei dettagli del componente e fai clic su 'Aggiungi Scorta' nel menu a sinistra.
La procedura guidata per le scorte ha tre passaggi:
Fai clic su 'Aggiungi scorte' per confermare.
Per ulteriori informazioni sulla gestione delle scorte, consulta la sezione Scorte in Scorte e Stoccaggio.
Un progetto in PartsBox rappresenta una Distinta Base (BOM). Naviga su 'Progetti' nel menu in alto e fai clic su 'Crea'. Inserisci un nome (e opzionalmente una descrizione) per il tuo progetto e fai clic su 'Crea Progetto'.
Apri il tuo progetto appena creato e vai alla scheda 'BOM'. Fai clic su 'Aggiungi voce componente' per aprire il selettore dei componenti. Cerca il componente che hai creato in precedenza, selezionalo e conferma. Il componente verrà aggiunto alla distinta base con una quantità predefinita di 1. Puoi quindi fare clic sulla voce per espanderla e regolare la quantità, aggiungere designatori o configurare altri campi.
Se hai già una distinta base esportata da uno strumento CAD (KiCad, Altium, Eagle o qualsiasi altro strumento in grado di esportare CSV), puoi creare un progetto importandola. Vai su 'Progetti' e fai clic su 'Importa'. Carica il tuo file CSV o TSV.
PartsBox analizzerà il file e mostrerà un'anteprima. Regola il separatore di campo e la codifica dei caratteri se necessario finché l'anteprima non sembra corretta. Quindi mappa ogni colonna al campo BOM appropriato usando i menu a discesa sopra ogni colonna. Il pulsante 'Indovina' spesso riesce a ottenere automaticamente le mappature corrette, ma rivedi sempre il risultato. Le mappature più importanti sono 'Quantità', 'Componente' e 'Designatori'.
Dopo aver mappato le colonne, PartsBox tenterà di abbinare automaticamente ogni voce della distinta base a un componente nel tuo database. Le voci che corrispondono a un componente vengono mostrate con il nome del componente; le voci non abbinate sono evidenziate. Se hai creato il componente dai passaggi precedenti e la distinta base contiene lo stesso MPN, verrà abbinato automaticamente.
Per abbinare manualmente una voce non abbinata, fai clic su di essa per espandere i dettagli della voce. Nella sezione 'Abbinamento componente', fai clic su 'Abbina a un componente esistente' per aprire il selettore dei componenti e selezionare il componente corretto. Se necessario, puoi anche creare un nuovo componente direttamente da lì.
Una volta soddisfatto delle mappature e degli abbinamenti, inserisci un nome per il progetto e fai clic su 'Importa'.
Per maggiori dettagli sull'importazione, l'abbinamento e la gestione delle voci della distinta base, consulta la sezione Lavorare con le distinte base in Progetti e distinte base.
PartsBox utilizza ampiamente le tabelle per visualizzare e gestire i dati. Molte funzionalità – come la ricerca all'interno delle tabelle, il filtraggio, la configurazione delle tabelle, le operazioni in blocco, i campi personalizzati, i tag e gli allegati – funzionano in modo coerente su diversi tipi di dati (componenti, lotti, luoghi di stoccaggio, ordini, progetti, voci della distinta base e costruzioni). Questa sezione descrive queste funzionalità trasversali.
Le tabelle in PartsBox sono interattive e ricche di funzionalità. Supportano la ricerca, il filtraggio, la configurazione delle colonne, l'ordinamento, la selezione in blocco e l'esportazione in PDF o CSV. Le impostazioni della tabella vengono ricordate per ogni tabella, in modo che le tue preferenze persistano tra le sessioni. Le funzionalità descritte di seguito si applicano alla maggior parte delle tabelle nell'applicazione.
Oltre alla casella di ricerca principale dei componenti (descritta nella sezione Componenti), le funzionalità di ricerca sono disponibili nella maggior parte delle tabelle in tutta l'applicazione. Queste caselle di ricerca all'interno delle tabelle offrono funzionalità di corrispondenza esatta per aiutarti a restringere rapidamente le righe visualizzate. Digita semplicemente nella casella di ricerca sopra una tabella per filtrarne i contenuti. La ricerca considera i valori in tutte le colonne visibili.
La maggior parte delle tabelle in PartsBox supporta funzionalità di filtraggio avanzate, consentendo di restringere rapidamente i dati visualizzati per corrispondere a criteri specifici. Il sistema di filtraggio è altamente configurabile e supporta condizioni logiche complesse. Questa sezione ti guiderà attraverso il processo di creazione, utilizzo e gestione dei filtri in PartsBox.
Per filtrare i dati in una tabella, segui questi passaggi:
Per rimuovere rapidamente tutti i filtri attualmente applicati a una tabella, usa il pulsante "Rimuovi tutti i filtri". Se prevedi di riutilizzare il filtro in futuro, assicurati di salvarlo come preset prima di rimuoverlo.
Le condizioni del filtro sono i mattoni dei tuoi filtri. Ogni condizione consiste in un campo, una condizione e un valore:
Puoi combinare più condizioni di filtro utilizzando gli operatori logici AND/OR. PartsBox supporta condizioni nidificate, consentendoti di creare logiche di filtraggio complesse aggiungendo singole condizioni o più condizioni combinate con AND/OR sotto ogni istruzione AND/OR.
Quando inserisci valori numerici nelle condizioni del filtro, puoi usare i prefissi delle unità per comodità. Inserisci semplicemente il prefisso senza l'unità. Ad esempio, usa "22u" invece di "22μF" e "10k" invece di "10kΩ". Nota che i prefissi distinguono tra maiuscole e minuscole, quindi "m" e "M" rappresentano valori diversi.
PartsBox supporta i seguenti prefissi di unità:
PartsBox ti consente di salvare i tuoi filtri come preset, che possono essere personali o condivisi all'interno della tua azienda. Questa funzionalità ti consente di caricare rapidamente filtri complessi e definire filtri utili per tutti nella tua organizzazione.
Per gestire i tuoi preset dei filtri:
Quando salvi le configurazioni dei filtri come preset, appaiono in un menu a discesa nell'intestazione della tabella. Questo fornisce un accesso rapido ai tuoi filtri comunemente usati e rende efficiente il passaggio tra diverse visualizzazioni.
I preset dei filtri possono funzionare in modo simile alle categorie quando basati su tag o nomi. A differenza dei rigidi sistemi di categorie in cui ogni elemento appartiene a una sola categoria, i preset offrono maggiore flessibilità consentendo agli elementi di apparire contemporaneamente in più viste filtrate. Questo approccio ti offre i vantaggi organizzativi delle categorie senza le loro tipiche limitazioni.
Oltre ai preset di filtro, PartsBox consente di salvare e condividere le configurazioni delle colonne della tabella come preset. Questo è utile quando diversi utenti nella tua organizzazione devono vedere le stesse colonne in un layout coerente, o quando vuoi passare rapidamente tra diverse disposizioni di colonne per compiti diversi.
I preset di configurazione della tabella memorizzano la selezione delle colonne, il loro ordine e le loro larghezze relative. Come i preset dei filtri, possono essere salvati come preset personali (visibili solo a te) o come preset aziendali (condivisi con tutti gli utenti nella tua organizzazione).
Per salvare una configurazione di tabella come preset:
Per caricare una preimpostazione di configurazione tabella salvata:
Puoi anche gestire i tuoi preset cliccando sull'icona di configurazione della tabella e utilizzando il pulsante "Gestisci preset" per:
I preset di configurazione delle tabelle sono particolarmente utili per i team che necessitano di visualizzazioni coerenti tra diversi utenti, come garantire che tutti vedano le stesse colonne durante l'esportazione dei dati o la revisione dell'inventario.
La maggior parte delle tabelle in PartsBox può essere esportata come PDF o CSV utilizzando il pulsante Esporta nel piè di pagina della tabella. L'esportazione include tutte le righe che corrispondono ai criteri di ricerca e filtro attuali, utilizzando le colonne attualmente configurate.
Ogni tabella ha due configurazioni di colonne separate: una per la visualizzazione e una per l'esportazione. L'esportazione spesso richiede un set di colonne diverso da quello che vedi sullo schermo, quindi queste vengono mantenute in modo indipendente. Quando accedi alla modalità di configurazione della tabella (facendo clic sull'icona delle colonne nell'intestazione della tabella), un selettore sul lato sinistro ti consente di passare dalla modifica della configurazione di visualizzazione alla configurazione di esportazione. Se scopri che i dati esportati non corrispondono a ciò che vedi sullo schermo, controlla la configurazione delle colonne di esportazione — è probabile che sia impostata su colonne diverse.
Le esportazioni PDF producono un output di alta qualità con un'intestazione contenente il titolo del documento e il logo della tua azienda (se caricato in Impostazioni > Generali, vedi la sezione Organizzazioni e Accesso), e i dati della tabella con una formattazione appropriata per la stampa. Le immagini e gli URL presenti nelle colonne della tabella sono inclusi nell'esportazione PDF. Le immagini in miniatura sono mostrate in linea dove applicabile.
Le esportazioni CSV producono un file standard separato da virgole adatto per l'uso in fogli di calcolo e altri strumenti.
Molte tabelle in PartsBox supportano la selezione di più elementi e l'esecuzione di operazioni in blocco su di essi. Questo modello funziona in modo coerente su componenti, lotti, luoghi di stoccaggio, ordini, progetti, voci della distinta base e costruzioni.
Per selezionare gli elementi, usa le caselle di controllo accanto a ogni riga. L'applicazione ricorda le tue selezioni mentre cerchi e filtri, così puoi costruire una selezione nel tempo senza perdere gli elementi precedentemente selezionati. Usa la casella di controllo nell'intestazione della tabella per selezionare o deselezionare tutti gli elementi visibili. Una volta selezionati gli elementi, usa il menu "Selezionati..." per accedere alle operazioni disponibili. Le operazioni specifiche differiscono a seconda del tipo di dati con cui stai lavorando – vedi le sezioni pertinenti per i dettagli.
I campi personalizzati forniscono un modo flessibile per memorizzare e organizzare dati strutturati per vari oggetti in PartsBox. I campi personalizzati possono essere aggiunti a componenti, lotti, luoghi di stoccaggio, ordini, progetti, voci di progetto (BOM) e produzioni.
A differenza delle note o dei commenti, i campi personalizzati sono strutturati, indicizzati per la ricerca e possono essere utilizzati nelle colonne delle tabelle e nei filtri in tutta l'applicazione. Ciò consente di definire e memorizzare attributi aggiuntivi specifici per le esigenze della tua organizzazione, i flussi di lavoro o i requisiti del settore.
Alcuni esempi di come potrebbero essere utilizzati i campi personalizzati:
I campi personalizzati sono completamente integrati nell'interfaccia di PartsBox e possono essere:
Quando si lavora con più elementi, è possibile eseguire operazioni in blocco sui campi personalizzati:
Per utilizzare queste operazioni:
Queste operazioni in blocco sono disponibili per componenti, lotti, posizioni di stoccaggio, ordini, progetti, voci di progetto e build.
I tag forniscono un modo potente e flessibile per categorizzare e organizzare i tuoi dati in PartsBox. Applicando tag a vari oggetti come componenti, posizioni di stoccaggio, progetti, ordini, lotti e produzioni, puoi trovare e filtrare rapidamente sottoinsiemi specifici dei tuoi dati.
I tag possono essere assegnati dalle schermate di informazioni/modifica o selezionando più elementi e utilizzando l'opzione 'Aggiungi/Rimuovi tag...' dal menu 'Selezione'.
Quando aggiungi tag, inserisci semplicemente il nome del tag senza il carattere # iniziale. Un oggetto può avere un numero qualsiasi di tag allegati.
I tag svolgono un ruolo importante nella ricerca e nel filtraggio dei tuoi dati. Quando inserisci un tag nella casella di ricerca (preceduto dal carattere #), PartsBox limiterà i risultati della ricerca agli oggetti che hanno quel tag specifico assegnato.
Tieni presente che i tag vengono abbinati esattamente. Se inserisci più tag nella casella di ricerca, un oggetto deve avere tutti i tag specificati per essere incluso nei risultati.
PartsBox genera automaticamente auto-tag per i tuoi componenti in base alle loro specifiche. Questi auto-tag vengono creati indipendentemente dai tag assegnati manualmente, quindi non devi preoccuparti di conflitti se assegni un tag con lo stesso nome di un auto-tag.
Gli auto-tag forniscono un modo conveniente per classificare i componenti senza richiedere sforzi manuali. Assicurano che i componenti con specifiche simili siano raggruppati automaticamente, rendendo più facile trovarli e gestirli.
PartsBox consente di allegare file arbitrari a componenti, lotti, progetti, luoghi di stoccaggio, ordini, offerte locali e produzioni. Questa funzione è utile per mantenere tutte le informazioni rilevanti organizzate e facilmente accessibili. Alcuni esempi comuni di file che potresti voler allegare includono:
Allegando questi file direttamente agli elementi rilevanti in PartsBox, puoi assicurarti che le informazioni importanti siano sempre a portata di mano. Non c'è bisogno di preoccuparsi delle convenzioni di denominazione, delle strutture delle directory o di ricordare dove sono archiviati i file su un server.
Gli allegati sono archiviati in modo sicuro nel cloud e possono essere consultati da qualsiasi luogo.
Quando visualizzi la pagina dei dettagli per un elemento con allegati, vedrai un elenco di tutti i file allegati. Cliccando su un nome file scaricherai l'allegato sul tuo computer. Puoi anche rinominare gli allegati o eliminarli se non sono più necessari.
Sfruttando la funzionalità degli allegati di PartsBox, puoi mantenere tutta la documentazione essenziale organizzata e collegata agli articoli rilevanti nel tuo inventario. Questo fa risparmiare tempo e garantisce che tutti nel tuo team abbiano accesso alle informazioni di cui hanno bisogno.
PartsBox riguarda i componenti elettronici, quindi un 'componente' è un concetto fondamentale. Un componente rappresenta un componente elettronico o meccanico. Esistono diversi tipi di componenti:
Nota che per componenti generici e senza nome (ad es. un NE555 senza nome in un package DIP) è solitamente meglio usare componenti locali. Ci sono centinaia di versioni dell'NE555 e la tua versione particolare potrebbe essere leggermente diversa da quella di qualcun altro. Quindi usa i componenti collegati solo per componenti esattamente corrispondenti (ad esempio se hai un 'NE555PWG4' di Texas Instruments, collegalo).
I componenti sono astratti: descrivono il componente, ma finché non aggiungi stock effettivo, non rappresentano cose fisiche. Anche i componenti senza stock sono utili—ad esempio, puoi aggiungerli ai progetti (BOM) per ottenere prezzi per i tuoi progetti.
I componenti collegati hanno due nomi: il nome locale (interno) e l'MPN ufficiale. Nel piano gratuito per hobbisti, il nome locale deve essere lo stesso dell'MPN. Nei piani commerciali, entrambi i nomi possono essere utilizzati e il nome locale può essere diverso dall'MPN. Il nome locale può essere modificato rinominando il componente.
Oltre agli attributi standard come un nome o un produttore, i componenti possono anche avere campi/attributi personalizzati (nei piani che supportano questa funzionalità). Come il campo 'Note', questi possono essere utilizzati per memorizzare qualsiasi dato ma in modo più strutturato. Alcuni esempi di utilizzo includono Distributore, Numero Parte Distributore, URL Parte Fornitore, Peso o Peso Tara Contenitore. I campi personalizzati sono indicizzati per la ricerca.
Per aggiungere un nuovo componente, vai alla sezione Componenti nel menu principale e usa il pulsante 'Crea' per aprire la finestra di dialogo di creazione componente.
Il campo 'Tipo di Componente' determina il tipo di componente che verrà creato:
Ci sono due metodi per cercare i componenti collegati:
Dopo aver inserito un termine di ricerca e cliccato su 'Corrispondenza' o 'Cerca', verranno visualizzati i risultati. Scegli il componente che corrisponde esattamente ai tuoi requisiti, prestando molta attenzione alle piccole variazioni nella denominazione, in quanto possono indicare differenze significative nei componenti effettivi. Quando selezioni un risultato, verranno mostrate le sue specifiche e verrà fornito un link alla scheda tecnica accanto a ciascun componente, se disponibile.
Per gli utenti commerciali, è possibile assegnare immediatamente un numero di parte locale (interno/aziendale) a un componente collegato.
Quando si creano componenti locali, è richiesto solo il nome del componente; tutti gli altri campi sono opzionali.
Alcuni piani consentono di caricare e allegare datasheet, immagini, modelli CAD e altre informazioni ai componenti. Questo viene fatto dopo che il componente è stato creato.
Per creare un meta-componente, fornisci un nome e facoltativamente un footprint e una descrizione. Il meta-componente appena creato sarà vuoto, il che significa che non conterrà alcun componente membro (sostituti). Questi dovranno essere aggiunti in seguito, utilizzando il pulsante 'Aggiungi componente' nella schermata delle informazioni del meta-componente o selezionando più componenti nella tabella principale dei componenti e utilizzando l'opzione 'Selezionati | Aggiungi a meta-componente'.
Se hai un componente esistente con stock, offerte e cronologia di utilizzo che vuoi trasformare in un meta-componente, puoi convertirlo piuttosto che creare un nuovo meta-componente vuoto. Questo è utile quando ti rendi conto che un componente che stavi utilizzando dovrebbe in realtà rappresentare un gruppo di alternative intercambiabili.
Un componente può essere convertito in un meta-componente se non è già un meta-componente, non è un sotto-assemblaggio e non è archiviato.
Come convertire:
Cosa succede durante la conversione:
Cosa rimane invariato:
Quando un componente diventa obsoleto o fuori produzione, potresti volerlo sostituire con un componente diverso in tutti i tuoi progetti. Invece di modificare ogni voce di progetto individualmente, puoi utilizzare l'operazione "Sostituisci nei progetti" per farlo in un solo passaggio.
Come sostituire:
Cosa succede durante la sostituzione:
Cosa rimane invariato:
Se vuoi sostituire un componente solo in progetti specifici piuttosto che in tutti i progetti, puoi farlo dall'elenco Progetti utilizzando la selezione multipla.
Come sostituire nei progetti selezionati:
Questo è utile quando una sostituzione di componente si applica solo a determinati progetti, o quando si desidera implementare una sostituzione gradualmente, progetto per progetto.
Si applicano gli stessi comportamenti della sostituzione globale: le offerte bloccate sulle voci interessate vengono cancellate, le voci dell'elenco e la cronologia delle produzioni non vengono influenzate e il componente originale non viene modificato o eliminato.
La ricerca è una funzionalità fondamentale in PartsBox che ti consente di trovare rapidamente i componenti di cui hai bisogno. La casella di ricerca principale si trova nella parte superiore della sezione Componenti.
Il motore di ricerca dei componenti impiega la corrispondenza fuzzy, il che significa che anche se i termini di ricerca non corrispondono esattamente, verranno comunque visualizzati risultati pertinenti. Per aiutarti a identificare rapidamente le corrispondenze più rilevanti, i risultati esatti sono distinti visivamente dalle corrispondenze parziali utilizzando colori di sfondo diversi.
Quando si cercano componenti, i seguenti campi sono inclusi nell'ambito della ricerca:
Oltre alla ricerca per parole chiave, puoi anche cercare utilizzando i tag. Per cercare per tag, inserisci semplicemente il carattere # seguito dal nome del tag. I tag devono corrispondere esattamente e, se inserisci più tag, un componente deve avere tutti i tag specificati per essere incluso nei risultati.
Per una flessibilità ancora maggiore, puoi combinare parole chiave e tag nelle tue query di ricerca. Questo ti consente di creare ricerche altamente mirate che ti aiutano a trovare esattamente ciò di cui hai bisogno, anche in database di componenti grandi e complessi.
Oltre alla ricerca principale dei componenti, la maggior parte delle tabelle in tutta l'applicazione ha la propria funzionalità di ricerca. Vedi la sezione Ricerca nelle Tabelle sotto Lavorare con i Dati per i dettagli.
Ci sono due modi per eliminare un componente:
L'eliminazione di un componente è un'operazione distruttiva che non è raccomandata a meno che non si stia eliminando un componente appena creato che non è mai stato utilizzato nelle build e a cui non è mai stato aggiunto alcuno stock. Quando elimini un componente, PartsBox non sarà in grado di risolvere i riferimenti a quel componente nella cronologia delle build passate. In generale, evita di eliminare componenti che sono stati utilizzati nelle build.
La maggior parte delle volte, è meglio archiviare un componente invece (vedi sotto).
Un componente che è stato archiviato non apparirà nelle tabelle e nelle ricerche regolari, il che impedisce che interferisca con il normale utilizzo. Sarà comunque disponibile nella tabella "Componenti | Archiviati" e rimarrà visibile nelle cronologie delle build.
Per archiviare un componente, vai su "Altre Operazioni" nella schermata delle informazioni del componente e clicca sul pulsante "Archivia Componente".
Il componente che viene archiviato non dovrebbe avere stock (né disponibile né ordinato). Archiviare un componente che ha stock non è tipicamente logico. Anche se i componenti archiviati non appaiono nelle tabelle standard e nelle ricerche, influenzano comunque i report come il report del valore dei componenti o il report del valore della posizione di stoccaggio. Per questo motivo, non puoi archiviare un componente con stock esistente. Devi prima rimuovere manualmente lo stock dal componente e/o rimuovere il componente dagli ordini prima di archiviarlo.
L'archiviazione è l'approccio raccomandato per i componenti che non vuoi vedere nelle tue operazioni quotidiane sul database. Elimina solo i componenti che sono stati creati per errore e non sono mai stati utilizzati.
Per informazioni generali sulla selezione e l'esecuzione di operazioni su più elementi, consulta la sezione Operazioni su Più Elementi in Lavorare con i Dati. Le operazioni specifiche per i componenti sono descritte di seguito:
Nella produzione elettronica, è comune che un componente abbia possibili sostituti: componenti funzionalmente equivalenti che possono essere utilizzati in modo intercambiabile. PartsBox offre diversi modi per definire i sostituti, ognuno con la propria semantica e casi d'uso.
I meta-componenti consentono di raggruppare diversi componenti sostitutivi (noti come componenti membri) sotto un unico nome. Questo nome può quindi essere utilizzato in Progetti e BOM. I meta-componenti sono raggruppamenti logici che forniscono una visione aggregata dello stock per tutti i loro componenti membri. Abilitano anche avvisi di scorte basse a livello di meta-componente.
Un buon esempio di quando utilizzare un meta-componente è per componenti come 'TPS61161DRVR' e 'TPS61161DRVT'. Questi sono lo stesso componente, solo in confezioni diverse. Creando un meta-componente chiamato 'TPS61161DRV' e utilizzando quel nome nelle tue BOM, puoi gestire il loro inventario come se fossero un singolo componente. Il meta-componente 'TPS61161DRV' mostrerà lo stock combinato per entrambe le varianti di confezionamento.
I sostituti dei componenti forniscono un modo per indicare che un componente diverso può essere utilizzato al posto di quello attuale. A differenza dei meta-componenti, i sostituti dei componenti non forniscono alcun raggruppamento di stock. Lo stock per ogni componente è ancora gestito in modo indipendente.
I sostituti dei componenti sono particolarmente utili per i componenti passivi, che spesso hanno equivalenti funzionali che non vuoi necessariamente gestire come un singolo articolo di magazzino. Definendo i sostituti dei componenti, puoi indicare che un altro componente può essere usato al posto di quello attuale in ogni Progetto, voce della BOM e voce della lista d'acquisto, globalmente.
A volte, un componente può essere sostituito per una specifica voce della BOM in un progetto, ma non necessariamente altrove. È qui che entrano in gioco i sostituti BOM.
I sostituti BOM ti consentono di definire un componente sostitutivo per una specifica voce della BOM in un progetto. Questa sostituzione si applica solo a quella particolare voce della BOM e non influisce sull'utilizzo del componente in altri progetti o BOM.
Durante la costruzione o l'acquisto, PartsBox combina le informazioni su tutti i tipi di sostituti sopra indicati per produrre un elenco completo di tutti i possibili sostituti per una determinata voce della distinta base (BOM) o voce dell'elenco di acquisto.
Questa potente funzionalità assicura che tu abbia la massima flessibilità nell'approvvigionamento e nell'utilizzo dei componenti, mantenendo comunque un controllo rigoroso sul tuo inventario e sulle produzioni.
Usa i meta-componenti per raggruppare componenti intercambiabili (alternativi o sostituti) e mantenere flessibili le tue distinte base (BOM), evitando ritardi nei progetti dovuti alla carenza di componenti. Tutti i sostituti dei componenti sono considerati per la determinazione dei prezzi del progetto, l'acquisto e la costruzione.
Quando si visualizzano le informazioni di un componente, la sezione "utilizzato nei progetti" mostra tutti i progetti in cui il componente è referenziato — non solo come componente principale in una voce della distinta base, ma anche dove appare come sostituto della distinta base o come membro di un meta-componente utilizzato in un progetto. Questo può anche essere configurato come colonna della tabella.
Molti componenti hanno una posizione "home" dedicata dove dovrebbero essere sempre conservati. PartsBox ti consente di assegnare una posizione di stoccaggio predefinita a qualsiasi componente, il che offre due vantaggi:
Per impostare una posizione di stoccaggio predefinita per un componente:
Il menu a discesa della posizione di stoccaggio predefinita mostra solo le posizioni che possono accettare il componente. Le posizioni che sono piene, archiviate o limitate (come le posizioni a componente singolo che contengono già un componente diverso) non appariranno nell'elenco.
Quando si aggiunge stock, se il componente ha una posizione predefinita impostata, PartsBox evidenzierà questo nel selettore della posizione di stoccaggio. Se la posizione è obbligatoria, le altre opzioni saranno disabilitate, assicurando che il componente vada nella sua posizione designata.
Questa funzionalità è particolarmente utile per:
Nel processo di assemblaggio di dispositivi elettronici utilizzando macchine pick-and-place SMT (Surface Mount Technology), una certa percentuale di componenti andrà inevitabilmente persa o scartata. Ciò è dovuto alle limitazioni e alle imperfezioni intrinseche del processo di assemblaggio automatizzato.
Inoltre, il design meccanico degli alimentatori a nastro utilizzati in queste macchine richiede che una lunghezza minima di nastro, nota come "leader", sia presente prima che la macchina possa prelevare automaticamente i componenti dal nastro. I componenti contenuti all'interno di questo nastro leader sono effettivamente inutilizzati e contribuiscono all'attrito complessivo dei componenti.
L'attrito dei componenti, indicato anche come spreco di componenti, è un fattore importante da considerare quando si pianifica la produzione e si gestisce l'inventario. Non tenere conto dell'attrito può portare a carenze impreviste e ritardi nella produzione.
PartsBox ti consente di definire i parametri di logorio per ogni componente individualmente, assicurando che il tuo inventario e le quantità degli ordini tengano conto di queste perdite previste. Quando usi PartsBox per produrre o prezzare Progetti e BOM, l'applicazione tiene automaticamente conto dei parametri di logorio definiti. Calcola il numero totale di componenti richiesti in base alle esigenze del progetto e alle perdite previste, assicurandoti di avere scorte sufficienti o quantità di ordini per completare la produzione.
PartsBox fornisce due metodi per specificare l'attrito:
Per impostare i parametri di attrito per un singolo componente, vai alla pagina dei dettagli del componente e individua le impostazioni di attrito. Puoi inserire i valori percentuali e/o quantitativi secondo necessità.
Se hai bisogno di impostare i parametri di attrito per più componenti contemporaneamente, PartsBox lo rende facile con la funzione di modifica in blocco:
L'attrito non può essere impostato direttamente per i meta-componenti, che sono usati per raggruppare componenti intercambiabili. Quando si prezzano progetti che includono meta-componenti, PartsBox utilizzerà i valori massimi di attrito da tutti i singoli componenti all'interno del meta-componente. Quando si costruiscono progetti, l'attrito effettivo sarà calcolato in base allo specifico componente selezionato dal gruppo meta-componente al momento della build.
Dopo aver creato un componente in PartsBox, puoi aggiungere stock per rappresentare l'inventario fisico di quel componente elettronico. Lo stock rappresenta le copie reali e tangibili del componente che hai a portata di mano o a cui avrai accesso in futuro.
Un singolo componente può avere scorte in più posizioni. Questo è particolarmente utile quando si ha a che fare con bobine di componenti. Spesso, potresti voler tenere una bobina intera in una posizione mentre conservi una quantità minore su nastro tagliato in un'altra. Tracciare le scorte attraverso diverse posizioni si rivela prezioso anche quando si lavora con produttori a contratto, in quanto ti permette di monitorare l'inventario che è fisicamente situato fuori dal tuo ufficio.
PartsBox separa intenzionalmente i concetti di componenti e giacenza. Puoi pensare ai componenti come contenitori che possono contenere componenti effettivi (giacenza). I componenti con giacenza zero servono a scopi importanti:
PartsBox tratta la cronologia delle scorte come un registro permanente con opzioni di modifica limitate. Puoi sempre rimuovere la voce più recente, ma le voci più vecchie non possono essere eliminate e le loro quantità non possono essere modificate. Questo approccio garantisce l'integrità e la tracciabilità dei dati delle tue scorte nel tempo.
In PartsBox, un lotto rappresenta uno specifico batch o spedizione di componenti elettronici, tracciabile fino a una fonte nota. Il controllo dei lotti è una funzionalità opzionale che consente un tracciamento e una gestione più dettagliati dell'inventario dei componenti.
Quando il controllo lotti è abilitato, tutto lo stock per un dato componente è diviso in lotti distinti. Un lotto viene creato quando si aggiunge nuovo stock, assicurando che ogni partita di componenti sia associata a un lotto specifico. Ciò consente la differenziazione tra componenti identici che potrebbero essere stati acquistati in momenti diversi o da fornitori diversi.
Ad esempio, considera un condensatore da 100nF di cui hai una bobina completa di 5000 pezzi da un fornitore e una striscia di nastro tagliato con 100 pezzi da un altro. Senza il controllo dei lotti, PartsBox ti dice solo che hai 5100 pezzi in totale — i due lotti sono indistinguibili. Con il controllo dei lotti, la bobina e la striscia di nastro tagliato vengono tracciate come lotti separati, ciascuno con la propria origine, prezzo e cronologia. Puoi vedere esattamente quanti pezzi rimangono sulla bobina rispetto alla striscia, scegliere quale lotto consumare durante una costruzione e rintracciare qualsiasi problema di qualità fino alla sua fonte specifica.
I lotti possono avere vari dati associati:
Utilizzando il controllo lotti, PartsBox consente un tracciamento preciso dei componenti durante tutto il processo di gestione dell'inventario. Ciò è particolarmente utile per gestire componenti con durata di conservazione limitata, garantire la tracciabilità in caso di problemi di qualità o conformarsi ai requisiti normativi.
Quando i componenti vengono consumati durante una produzione o trasferiti tra le posizioni di stoccaggio, viene registrato il lotto specifico, mantenendo una cronologia completa dell'utilizzo di ciascun lotto. Questo tracciamento dettagliato consente una più facile identificazione e isolamento dei problemi, qualora si verifichino.
Il controllo dei lotti in PartsBox fornisce un ulteriore livello di controllo e visibilità sull'inventario dei componenti elettronici, consentendo una gestione più efficiente e accurata dei componenti.
Una posizione di stoccaggio è un luogo in cui i componenti possono essere conservati. Può essere una stanza, un cassetto, uno scaffale, una scatola, uno scomparto all'interno di una scatola o qualsiasi altra cosa ti venga in mente.
Il principio più importante è: non cercare di categorizzare i componenti per tipo. Un istinto comune è quello di mettere insieme tutte le resistenze, tutti i condensatori e così via — ma questo crea un lavoro di riorganizzazione costante man mano che il tuo inventario cresce, e non è scalabile. Invece, lascia che PartsBox tenga traccia di dove si trova tutto. Quando arriva una nuova spedizione, posiziona i componenti ovunque si adattino fisicamente. PartsBox ti dirà sempre esattamente dove trovare qualsiasi componente.
Ecco alcuni approcci comuni che funzionano bene in pratica:
Questi approcci possono essere mescolati liberamente. Potresti avere uno scaffale per le bobine, alcune scatole a scomparti per nastri tagliati e piccoli componenti, e una scatola per progetto sulla tua scrivania.
Puoi nominare i tuoi luoghi di stoccaggio come preferisci, ma ecco uno schema di denominazione suggerito:
Inizia con una lettera che indica il tipo di stoccaggio: 'b' per scatole, 's' per scaffali, 'c' per armadi, 'd' per cassetti. Segue un numero a due cifre per l'unità specifica. Quindi, se la posizione ha sotto-scomparti, usa un sistema a griglia: a1, a2, b1, b2 e così via. Questo si traduce in nomi come 'b01-a4' (scatola 1, riga a, colonna 4) o 's01-r3' (scaffale 1, posizione bobina 3). Usa qualsiasi schema ti permetta di trovare facilmente i componenti.
I nomi dei tuoi luoghi di stoccaggio possono essere modificati in qualsiasi momento, ma sceglili con attenzione, poiché una volta stampate le etichette, modificarli diventa leggermente più difficile.
Le aziende che lavorano con CM/EMS (produttori a contratto) spesso prefissano alcune delle loro posizioni di stoccaggio con il nome del produttore, in modo da poter filtrare facilmente le posizioni e vedere cosa il CM ha in magazzino in questo momento.
Le aziende CM/EMS, d'altra parte, spesso prefissano alcune posizioni di stoccaggio con i nomi dei clienti, per ottenere posizioni di stoccaggio per cliente per i componenti in conto deposito.
Per creare una nuova posizione di stoccaggio, vai alla sezione Stoccaggio nel menu principale e fai clic sul pulsante 'Crea'. PartsBox offre quattro metodi per creare posizioni di stoccaggio:
Dopo aver creato le posizioni di stoccaggio, puoi assegnare loro dei componenti, rendendo facile tracciare la posizione fisica del tuo inventario. Le posizioni di stoccaggio possono essere rinominate dopo la creazione per riflettere meglio il loro contenuto o scopo. Tuttavia, le posizioni di stoccaggio non possono essere eliminate. Invece, puoi archiviare una posizione di stoccaggio, che la nasconderà dalla vista ma la conserverà comunque (insieme alla sua cronologia) nel database. Ciò garantisce che i dati storici sulla posizione e sui componenti associati siano conservati per riferimento futuro o scopi di audit.
Per informazioni generali sulla selezione e l'operazione su più elementi, vedi la sezione Operazioni su Più Elementi sotto Lavorare con i Dati. Le operazioni specifiche per i lotti sono descritte di seguito.
Simile all'operazione su più componenti, puoi eseguire operazioni su più lotti. Nella sezione Componenti, seleziona il pulsante Lotti per visualizzare la tabella che elenca tutti i lotti nel tuo inventario. Puoi quindi selezionare i lotti su cui vuoi operare e utilizzare il menu "Selezionati..." per:
Se scegli di spostare una quantità inferiore all'intero lotto, il lotto verrà diviso e PartsBox ti chiederà ulteriori informazioni sul lotto appena creato. Quando si divide un lotto creato da una produzione, il nuovo lotto visualizzerà le informazioni originali della produzione nella scheda Produzioni, mantenendo la piena tracciabilità.
La gestione dei lotti è disponibile solo nei piani con la funzionalità Controllo Lotti.
Per informazioni generali sulla selezione e l'esecuzione di operazioni su più elementi, consulta la sezione Operazioni su Più Elementi in Lavorare con i Dati. Le operazioni specifiche per i lotti di scorte sono descritte di seguito.
Anche nei piani senza controllo lotti, puoi eseguire operazioni su più lotti di componenti. Tuttavia, in questo caso, queste operazioni possono essere eseguite solo all'interno di un luogo di stoccaggio.
Per visualizzare i componenti immagazzinati in una posizione di stoccaggio, vai alla sezione Stoccaggio e seleziona una posizione di stoccaggio. In alternativa, espandi una riga di posizione di stoccaggio nella tabella per vedere l'elenco dei componenti immagazzinati lì. Seleziona uno o più componenti e usa il menu "Selezionati..." per:
Nei piani con controllo dei lotti, queste operazioni tracceranno correttamente i lotti. Se scegli di spostare una quantità inferiore all'intero lotto, il lotto verrà diviso e PartsBox ti chiederà ulteriori informazioni sul lotto appena creato.
Un progetto in PartsBox rappresenta una distinta base (BOM), che è un elenco di componenti necessari per costruire un dispositivo elettronico o un assemblaggio. Ogni progetto corrisponde a un design o prodotto specifico.
I progetti servono a molteplici scopi in PartsBox:
PartsBox offre diversi metodi convenienti per aggiungere componenti a un progetto, permettendoti di popolare efficientemente la tua distinta base (BOM). Ecco le opzioni disponibili:
PartsBox può importare una BOM (Distinta Base) da numerosi pacchetti CAD/eCAD, in formato CSV o TSV. Puoi importare le voci della BOM creando un nuovo progetto o in qualsiasi progetto esistente.
Per creare un nuovo progetto importando una BOM esistente, utilizza il pulsante 'Importa' nella sezione 'Progetti'. Questo richiederà il caricamento del file. Carica un file CSV/TSV esportato dal tuo programma CAD.
PartsBox proverà ad analizzare la tua BOM e visualizzerà i risultati preliminari. Per favore, regola prima le opzioni 'Separatore di campo' e 'Codifica caratteri' finché la BOM non viene analizzata correttamente e vengono mostrate le prime righe di esempio. Assicurati che la casella di controllo 'La prima riga contiene i nomi delle colonne' sia impostata correttamente per la tua BOM.
Successivamente, regola la mappatura dalle colonne della BOM ai campi della BOM di PartsBox. C'è un pulsante 'Indovina' che utilizzerà euristiche per fare un tentativo migliore di indovinare le mappature delle colonne, ma per favore rivedi sempre attentamente i risultati.
La BOM importata è mostrata sotto la tabella di mappatura delle colonne, una volta mappate le colonne richieste.
Le scelte disponibili per i campi della BOM sono:
Per risparmiare tempo sulle importazioni future, puoi salvare le impostazioni di mappatura delle colonne come preimpostazione per un accesso rapido in seguito.
Dopo aver importato una BOM in PartsBox, ogni riga che rappresenta un componente deve essere abbinata a un componente specifico che è già stato creato. Non c'è modo di creare automaticamente componenti durante l'importazione di una BOM a causa dell'ambiguità e dei potenziali errori costosi: ci sono molti componenti con lo stesso nome. L'abbinamento può essere fatto automaticamente se i componenti sono già stati creati in diversi modi che vengono provati in ordine:
Si raccomanda vivamente di memorizzare i codici ID Anything™ o le chiavi CAD nel database dei componenti CAD ed esportarli nelle BOM per ottenere una corrispondenza rapida, semplice e precisa.
Le voci che non sono state abbinate ai componenti verranno evidenziate. Per tali voci, è possibile creare componenti aggiuntivi e riprovare l'abbinamento (vedere sotto), oppure aprire ciascuna delle voci ed eseguire l'abbinamento manualmente, possibilmente creando anche un nuovo componente nel processo. È anche possibile annullare l'abbinamento della voce se si è commesso un errore.
Per riprovare l'abbinamento, puoi selezionare alcune o tutte le voci nella BOM e utilizzare l'opzione di menu 'Selezionati | Abbina voci'. Questo riproverà l'abbinamento per tutte le voci selezionate. Puoi anche annullare l'abbinamento di più voci se necessario.
Le voci della distinta base (BOM) non sono limitate ai componenti, e possono anche rappresentare servizi o manodopera, come assemblaggio PCB, test o imballaggio. Queste voci possono avere offerte allegate proprio come i componenti, il che consente di stimare l'intero costo di produzione, non solo il costo dei componenti. Le offerte per voci di servizio/manodopera della BOM sono simili alle offerte di componenti: sono supportati sconti per quantità multiple, MOQ e date di scadenza, e le offerte possono essere inserite in qualsiasi valuta supportata.
Le voci della BOM vengono controllate per verificarne la correttezza, per aiutare a evitare errori e consentire la modifica strutturale della BOM. La quantità per una determinata voce deve corrispondere al numero di designatori. Ad esempio, una voce della BOM con una quantità di 2 e designatori C1, C2 è corretta, ma una quantità di 2 e un singolo designatore C1 è probabilmente un errore. PartsBox visualizza avvisi quando ciò accade, e questo renderà anche impossibile unire le voci della BOM con questi errori.
Se più voci corrispondono allo stesso componente, di solito ha senso combinarle in un'unica voce, regolando di conseguenza la quantità e i designatori. Questa è la funzione dell'opzione 'Selezionati | Unisci voci'. Se selezioni diverse voci che si riferiscono allo stesso componente, puoi unirle in un'unica voce della BOM.
È anche possibile espandere le voci della distinta base. Una voce della distinta base con una quantità maggiore di 1 può essere espansa in singole voci, ciascuna con una quantità di 1. Ad esempio, se c'è una voce con RC0805FR-0710KL, una quantità di 3 e designatori R1,R2,R3, può essere espansa in tre voci:
RC0805FR-0710KL, quantità di 1, designatore R1RC0805FR-0710KL, quantità di 1, designatore R2RC0805FR-0710KL, quantità di 1, designatore R3Questo è utile se desideri modificare una delle voci individualmente o escluderla dalle produzioni. Per espandere, fai clic sul pulsante 'Espandi voce' durante la modifica di una voce della BOM, oppure seleziona più voci e usa "Selezionati | Espandi voci...".
È possibile anche l'operazione inversa: è possibile selezionare diverse voci della distinta base (BOM) con lo stesso componente e utilizzare l'opzione di menu 'Selezionati | Unisci voci...'. Questo unirà le voci selezionate in un'unica voce della distinta base, combinando i designatori.
Quando si uniscono le voci della distinta base (BOM), viene eseguita un'operazione AND sui sostituti della distinta base: l'intersezione degli insiemi di sostituti della distinta base delle voci selezionate diventa l'insieme dei sostituti della voce unita.
In fondo alla BOM potrebbe esserci un avviso su più righe della BOM che si riferiscono agli stessi componenti. Questo non è un problema, PartsBox offre semplicemente un modo conveniente per eseguire l'operazione 'Unisci' sull'intera BOM. Se clicchi su 'Unisci tutto', tutte le istanze di più righe della BOM che si riferiscono allo stesso componente verranno elaborate e unite.
Quando modifichi una distinta base (BOM) in PartsBox, hai la flessibilità di aggiungere sostituti dei componenti per singole voci della BOM. Questa funzione ti consente di specificare componenti alternativi che possono essere utilizzati in modo intercambiabile con il componente principale. Durante la produzione, la quotazione o l'acquisto, PartsBox tratta il componente principale e tutti i suoi sostituti come scelte ugualmente valide, offrendoti una maggiore flessibilità nell'approvvigionamento dei componenti.
I sostituti BOM funzionano in modo simile ai componenti membri (sostituti) nei meta-componenti e ai sostituti per singoli componenti. Tuttavia, c'è una differenza fondamentale: i sostituti BOM sono configurati per singola voce all'interno di un progetto specifico e non hanno alcun effetto al di fuori di quella particolare voce. Questo controllo granulare consente di adattare i sostituti ai requisiti specifici di ogni progetto.
Quando si combinano le BOM per l'acquisto, PartsBox adotta un approccio conservativo nella gestione dei sostituti. Se ci sono due voci per lo stesso componente ma con diversi set di sostituti, PartsBox considererà solo l'intersezione dei sostituti — cioè, i sostituti che sono comuni a entrambe le voci. Questo assicura che vengano utilizzati nella lista d'acquisto solo i sostituti universalmente applicabili al componente in tutte le istanze. Per illustrare questo, consideriamo un esempio. Supponiamo di avere una BOM in cui il Componente A ha i sostituti B e C, e un'altra BOM in cui il Componente A ha i sostituti B e D. In questo caso, PartsBox non può presumere che il Componente A possa sempre essere sostituito con B, C o D. Invece, PartsBox sarà certo solo che il Componente A possa essere sostituito con B, poiché è l'unico sostituto comune a entrambe le BOM.
È noto che alcune versioni di Altium Designer hanno problemi con la gestione delle virgolette doppie (") nei file CSV che generano. Nello specifico, queste versioni non riescono a eseguire correttamente l'escape delle virgolette doppie all'interno dei valori dei campi. Ad esempio, se un campo contiene un valore come 0.156", il file CSV risultante non aderirà alle regole di formattazione CSV standard, rendendolo problematico per ulteriori elaborazioni o importazioni.
Per risolvere questo problema, gli utenti che riscontrano problemi con i loro file CSV a causa di virgolette doppie non precedute da escape hanno un paio di opzioni di correzione manuale:
Considera di verificare la presenza di aggiornamenti software o patch da Altium che potrebbero risolvere questo problema nelle versioni future, riducendo la necessità di regolazioni manuali dei file.
Le offerte di fornitori/distributori possono essere allegate ai componenti, per essere utilizzate durante la quotazione di progetti che richiedono il componente. Le offerte possono avere più scaglioni di prezzo, così come periodi di validità (date di scadenza), quantità minima ordinabile (MOQ) e multipli d'ordine.
Stimare il costo di un progetto è un passo importante nel processo di produzione. PartsBox semplifica questo compito fornendo una funzionalità di determinazione dei prezzi completa. Per accedere a questa funzionalità, vai al progetto che desideri prezzare e seleziona la scheda 'Prezzi'.
Aprendo la scheda 'Prezzi', ti verrà presentata la tabella principale dei prezzi, che mostra una ripartizione dettagliata dei componenti del progetto e dei relativi costi. Questa tabella include informazioni come il nome del componente, il produttore, l'MPN (Manufacturer Part Number), la quantità richiesta e il prezzo unitario per ogni componente.
La dimensione della produzione/lotto è il numero di unità per le quali si desidera stimare il prezzo. Diverse quantità comuni sono fornite per un accesso rapido, ma è possibile inserire qualsiasi quantità nella casella di input.
Il prezzo unitario totale e il prezzo totale sono visualizzati in caratteri grandi sul lato destro. Il pulsante di espansione accanto ad essi consente di confrontare rapidamente i prezzi per l'intera gamma di quantità di produzione comuni, senza inserirli manualmente.
Se c'è un segnale di avvertimento con punto esclamativo rosso accanto al prezzo unitario e totale, significa che PartsBox non è stato in grado di calcolare il prezzo, perché mancavano alcune informazioni. I componenti problematici sono evidenziati in rosso nella tabella dei prezzi sottostante.
Le opzioni di approvvigionamento dei componenti consentono di scegliere da dove provengono i componenti. 'Solo stock locale' considererà solo i componenti che hai già, utilizzando il loro prezzo medio di acquisto per la determinazione dei prezzi della distinta base (BOM). 'Solo acquisto' ignorerà lo stock locale e utilizzerà solo i prezzi online e le informazioni sullo stock. 'Usa stock locale, poi acquista' utilizzerà prima tutto lo stock locale e poi, se non è sufficiente, considererà le offerte online.
Nota che se la tua cronologia delle scorte non contiene prezzi, non otterrai informazioni corrette sui prezzi se provi a utilizzare le scorte locali nella quotazione Progetto/BOM. Puoi sempre tornare indietro e modificare la cronologia delle scorte per aggiungere i prezzi.
Le opzioni di filtro delle offerte consentono di restringere l'elenco delle offerte:
La tabella dei prezzi è il componente centrale della funzionalità di determinazione prezzi della distinta base (BOM) in PartsBox. Fornisce una panoramica completa di tutti i componenti in un progetto, insieme alle loro informazioni sui prezzi e alle opzioni di approvvigionamento. Questa tabella ti consente di prendere decisioni informate sull'acquisto di componenti per il tuo progetto.
Le colonne chiave nella tabella dei prezzi includono:
La tabella dei prezzi offre la possibilità di 'bloccare' una particolare offerta per un componente utilizzando l'icona del lucchetto. Quando un'offerta è bloccata, verrà utilizzata per calcolare il prezzo complessivo della BOM, indipendentemente da eventuali modifiche nei prezzi o nella disponibilità.

Ogni riga nella tabella dei prezzi include una casella di controllo 'escludi', che ti consente di escludere rapidamente un componente dai calcoli dei prezzi. Questo è utile quando vuoi vedere l'impatto della rimozione di un particolare componente dalla tua BOM.
Per visualizzare maggiori dettagli sulle offerte disponibili per un componente specifico, puoi espandere la riga utilizzando l'icona a forma di freccia sul lato sinistro. Questo mostrerà un elenco di tutte le offerte per quel componente, inclusi prezzi, scaglioni di quantità e tempi di consegna.
PartsBox seleziona automaticamente la migliore offerta (meno costosa) per ogni voce della BOM collegata a un'identità online (Codice Componente del Produttore). Con tipicamente 20-40 offerte disponibili per ogni componente, il processo di selezione è complesso, tenendo conto di vari fattori:
La tabella principale dei prezzi della BOM mostra solo la migliore offerta per ogni componente. PartsBox seleziona questa offerta basandosi sul 'Prezzo Scartando l'Eccesso' — il prezzo pagato assumendo che qualsiasi inventario in eccesso acquistato verrà scartato. Questo approccio garantisce che venga scelta l'opzione più conveniente, anche se la quantità richiesta è inferiore al MOQ o non è un multiplo del multiplo d'ordine.
Ad esempio, se sono necessari 50 componenti ma il MOQ è 100, PartsBox considererà il prezzo per 100 componenti, supponendo che i 50 in eccesso verranno scartati. Se questo prezzo è ancora competitivo a causa degli sconti per quantità, potrebbe essere selezionato come la migliore offerta. Paradossalmente, a volte è meno costoso acquistarne di più. Allo stesso modo, le quantità vengono arrotondate al multiplo d'ordine più vicino per il confronto.

La classifica delle offerte, e quindi la migliore offerta, cambia in base alla quantità di costruzione. Ciò consente la scoperta di nuove e inaspettate fonti di componenti che diventano convenienti a determinate quantità.
Espandendo ogni offerta si rivelano dettagli aggiuntivi:

Per i meta-componenti, i sostituti della distinta base (BOM) o i sostituti del componente, le offerte vengono raccolte per tutti i componenti raggruppati. Poiché questi componenti sono considerati intercambiabili, le offerte vengono combinate e viene selezionata la migliore dall'intero gruppo.
Oltre a reperire componenti dai principali distributori, è comune ricevere offerte personalizzate da altri fornitori per quantità specifiche, spesso con prezzi scontati. PartsBox accoglie questa possibilità permettendoti di inserire le tue offerte locali, che vengono poi considerate e classificate insieme alle offerte online durante il processo di determinazione dei prezzi.
Le offerte locali possono essere aggiunte in due modi:
Come le offerte online, le offerte locali supportano molteplici scaglioni di prezzo per qualsiasi quantità, così come una quantità minima d'ordine (MOQ) e multipli d'ordine. Questi parametri vengono presi in considerazione dall'algoritmo di pricing quando determina le migliori offerte per un dato progetto.

Quando aggiungi un'offerta locale, puoi fornire informazioni aggiuntive come:
La data di scadenza è particolarmente importante, poiché PartsBox escluderà automaticamente qualsiasi offerta scaduta dalla considerazione durante la determinazione del prezzo. Un'offerta non sarà considerata se è scaduta.
Dopo aver creato un'offerta locale, puoi allegare file ad essa cliccando sull'offerta e utilizzando la sezione allegati. Questo è utile per archiviare preventivi, corrispondenza e-mail o qualsiasi altro documento relativo all'offerta.
PartsBox supporta tutte le principali valute per le offerte locali. Converte i prezzi nella valuta di visualizzazione preferita utilizzando tassi di cambio aggiornati, preservando i prezzi e la valuta originali per riferimento. Ciò consente di lavorare con offerte da vari fornitori in tutto il mondo senza conversioni manuali di valuta.
PartsBox semplifica la gestione della valuta. Gli utenti possono selezionare la loro valuta preferita nelle impostazioni e tutti i prezzi verranno visualizzati in quella valuta in tutta l'applicazione. Ciò consente un'esperienza coerente e personalizzata quando si lavora con le informazioni sui prezzi.
Il software utilizza i tassi di cambio della Banca Centrale Europea (BCE) per una conversione valutaria accurata. Questi tassi vengono aggiornati regolarmente. Ciò elimina la necessità di conversioni valutarie manuali e fornisce agli utenti informazioni sui prezzi aggiornate.
Quando si inseriscono le offerte manualmente, è possibile scegliere tra una qualsiasi delle valute supportate. PartsBox gestirà automaticamente la conversione della valuta, visualizzando i prezzi nella valuta preferita dell'utente. Questa funzione accoglie offerte da vari fornitori e regioni, rendendo facile confrontare e analizzare i dati sui prezzi.
La tabella di prezzatura può essere esportata come documento PDF utilizzando il pulsante Esporta nel piè di pagina della tabella. Il PDF esportato include le informazioni sul progetto (nome, descrizione, date), una tabella riassuntiva prezzo-vs-quantità che mostra i prezzi unitari e totali per le quantità di costruzione preimpostate, la quantità di costruzione attualmente selezionata con il suo prezzo unitario e totale, e la tabella completa dei dettagli di prezzatura con tutti i componenti e le relative informazioni di approvvigionamento. Se è stato caricato un logo aziendale (vedi la sezione Organizzazioni e Accesso), questo viene incluso nell'intestazione del PDF.
Le regole del fornitore controllano quali distributori e fornitori vengono presi in considerazione quando PartsBox seleziona la migliore offerta per le voci della distinta base. Organizzando le regole in gruppi di regole denominati, puoi creare strategie di approvvigionamento flessibili — ad esempio, preferendo determinati fornitori e ripiegando su altri se non hanno scorte. I gruppi di regole possono essere applicati a livello globale o bloccati a progetti specifici e liste di acquisto.
Per configurare le regole del fornitore, vai su Impostazioni e seleziona 'Regole del fornitore'. Da lì, puoi:
La gestione delle regole dei fornitori richiede l'autorizzazione 'Modifica regole fornitori'.
Ogni gruppo di regole contiene un elenco ordinato di regole. Le regole possono essere aggiunte, rimosse e riordinate utilizzando le frecce su/giù.
Ogni regola ha un'impostazione Acquista da che determina quali fornitori vengono considerati:
Ogni regola può anche avere un campo opzionale Nome regola/commenti per scopi di documentazione. L'elenco dei fornitori è popolato dai fornitori che hanno offerte attive nel tuo database.
Le regole all'interno di un gruppo vengono elaborate dall'alto verso il basso:
Questo crea una catena di fallback. Ad esempio, un gruppo di regole con tre regole potrebbe implementare la seguente strategia:
Se LCSC o TME hanno offerte corrispondenti, vengono utilizzate quelle. Altrimenti, viene provato Mouser. Se anche Mouser non ha offerte, viene accettato qualsiasi fornitore disponibile.
Il selettore delle regole dei fornitori appare nella scheda Prezzi del progetto e negli elenchi di acquisto. Elenca tutti i gruppi di regole disponibili, con l'impostazione predefinita globale annotata come '(Predefinito globale)'. Selezionando 'Nessuna regola (tutto accettato)' si disabilita completamente il filtraggio dei fornitori.
Poiché il passaggio tra i gruppi di regole è istantaneo, funzionano anche come scenari di acquisto. Puoi definire diversi gruppi che rappresentano diverse strategie di approvvigionamento e passare rapidamente da uno all'altro per confrontare come ciascuno influisce sui prezzi della BOM prima di impegnarsi in una decisione di acquisto.
Usa il pulsante Blocca per fissare un gruppo di regole specifico a un progetto o a un elenco di acquisto. Un gruppo di regole bloccato (mostrato come '(Bloccato localmente)') rimane in vigore per quel progetto o elenco indipendentemente dalle modifiche all'impostazione predefinita globale. Usa Sblocca per tornare a seguire l'impostazione predefinita globale.
Il selettore delle regole del fornitore appare anche nelle viste di prezzatura dei singoli componenti, consentendoti di vedere come i diversi gruppi di regole influenzano la selezione dell'offerta per un componente specifico.
Una lista di acquisto è un elenco consolidato di componenti necessari per costruire uno o più progetti, basato sulla Distinta Base (BOM) per ogni progetto e sulle quantità di produzione specificate. Rappresenta i componenti che devi ordinare per completare le tue produzioni pianificate.
Per creare una lista di acquisto, aggiungi i progetti al tuo carrello, specificando la quantità di ogni progetto che intendi costruire. PartsBox combina quindi le singole BOM, moltiplicando le quantità dei componenti per le quantità di costruzione, e le unisce in un'unica lista. Questo processo elimina i duplicati dei componenti comuni tra i progetti, risultando in una lista unificata di tutti i componenti che devi acquistare.
La lista d'acquisto fornisce una chiara panoramica dei tuoi requisiti di acquisto, rendendo più facile gestire il tuo inventario e pianificare i tuoi ordini. Prende in considerazione i livelli attuali delle scorte nel tuo inventario, indicando quali componenti devono essere ordinati e in quali quantità.
Le quantità dell'ordine nell'elenco degli acquisti possono essere modificate direttamente. Questo è utile per regolare le quantità per soddisfare le quantità minime di ordine (MOQ), sfruttare gli sconti di quantità o arrotondare alle quantità di bobina intera.
Una volta che hai rivisto e finalizzato la tua lista di acquisto, puoi procedere a creare ordini fornitore direttamente dalla lista. PartsBox ti aiuta a selezionare i migliori fornitori in base alle tue preferenze, come prezzo, disponibilità e tempi di consegna. Puoi dividere la lista di acquisto in più ordini fornitore se necessario, ottimizzando il tuo processo di acquisto e riducendo i costi.
Una produzione rappresenta il risultato della costruzione di un progetto. Normalmente corrisponde a un lotto di dispositivi che sono stati fabbricati o sono in fase di fabbricazione. PartsBox supporta produzioni a fase singola e multi-fase, e una produzione multi-fase può essere in corso (non ancora completata).
Le produzioni sono una caratteristica essenziale in PartsBox per pianificare e tracciare la produzione. Ti consentono di verificare se hai quantità sufficienti di componenti (inclusa l'attrito), preparare la tua produzione, generare una lista di prelievo e rimuovere le quantità utilizzate dal tuo magazzino.
Le produzioni forniscono anche tracciabilità. A seconda del tuo piano di abbonamento, la cronologia di produzione mostra quali componenti specifici sono stati utilizzati in ogni produzione, con vari livelli di dettaglio.
Per accedere alla cronologia delle produzioni passate, visualizzare le produzioni multistadio in corso o avviare una nuova produzione, vai alla scheda 'Produzioni' all'interno di un progetto.
Quando si avvia una nuova produzione (build), la tabella di produzione mostra tutti i componenti del progetto insieme alle loro quantità richieste e disponibili. Per i piani che supportano il calcolo dell'attrito dei componenti, la quantità necessaria include il sovraccarico per attrito, calcolato individualmente per ciascun componente in base alle sue impostazioni di attrito. Quando viene applicato l'attrito, la colonna Richiesto mostra la ripartizione nel formato "15 (12+3)", indicando la quantità totale richiesta seguita dalla quantità base e dal sovraccarico per attrito tra parentesi.
Per i piani Production e superiori, puoi disabilitare i calcoli dell'attrito per una costruzione utilizzando la casella di controllo "Disabilita attrito?" nelle impostazioni di costruzione. Quando disabilitato, verranno utilizzate le quantità esatte della distinta base (BOM) senza aggiungere componenti extra per l'attrito. Puoi anche sovrascrivere questa impostazione per singole voci della distinta base espandendo la riga della voce e regolando l'impostazione dell'attrito per quella voce specifica.
La colonna 'Richieste di magazzino' indica da dove verranno reperiti i componenti. Per i componenti immagazzinati in più posizioni, i componenti con controllo del lotto e i meta-componenti, questa colonna potrebbe mostrare più fonti.
Puoi impostare la quantità di costruzione pianificata inserendo un numero o utilizzando i pulsanti +/-. La regolazione della quantità aggiorna istantaneamente tutto. Se lo stock per un componente è insufficiente, quella riga verrà evidenziata in rosso con un avviso.
PartsBox utilizza varie strategie per soddisfare la domanda:
Puoi anche limitare PartsBox all'uso di una singola fonte di componenti per ogni voce della distinta base (BOM). Alcuni piani sono limitati a una singola fonte, e in altri piani può essere utile per garantire la completa tracciabilità.
La strategia predefinita di selezione della fonte del componente determina le assegnazioni iniziali, ma queste possono essere modificate nella tabella. Ogni riga può essere espansa per mostrare le fonti, consentendoti di selezionarle individualmente e riordinarle (soggetto alle limitazioni del piano). Puoi anche sovrascrivere la quantità utilizzata per ogni voce.
Ogni riga include una casella di controllo 'Escludi?'. Selezionandola si escluderà il componente dalla produzione (essenzialmente un DNP - Do Not Populate). Nessuno stock verrà rimosso per i componenti esclusi.
Se non c'è scorta sufficiente per alcune voci della distinta base (BOM), PartsBox visualizzerà un avviso ma ti permetterà comunque di procedere con la produzione. Questo può essere utile se hai scorte aggiuntive a portata di mano che non sono state inserite in PartsBox, o se vuoi produrre schede parzialmente popolate. La quantità massima disponibile verrà rimossa dal tuo magazzino.
Nelle build a fase singola, premendo il pulsante 'Costruisci e rimuovi stock' (e confermando) verrà rimosso lo stock per tutti i componenti non esclusi appartenenti al progetto. La build verrà quindi contrassegnata come completata.
Per le costruzioni multi-fase, seleziona la casella di controllo 'costruzione multi-fase'. PartsBox visualizzerà caselle di selezione accanto a ciascun componente nella costruzione. Puoi utilizzare le singole caselle per selezionare le righe, selezionare/deselezionare tutte le righe e utilizzare l'interfaccia di ricerca/filtro per contrassegnare i componenti da costruire/posizionare nella fase corrente. L'interfaccia di filtro supporta i tag, quindi inserire '#smd' è un modo rapido per selezionare tutti gli elementi SMD, che vengono spesso posizionati per primi.
Premendo 'Costruisci e rimuovi stock' verranno elaborate solo le voci selezionate (come nelle costruzioni a fase singola).
Eseguire una fase di produzione senza selezionare alcun componente può essere utile per documentare un passaggio di lavorazione nella cronologia di produzione.
Una costruzione multi-fase incompleta apparirà nella scheda 'In corso' dell'interfaccia Costruzioni. Selezionandola ti permette di costruire la fase successiva o terminare la costruzione, segnandola come completa.
Una costruzione può avere un numero qualsiasi di fasi. Può anche essere contrassegnata come finita anche se non tutti i componenti sono stati posizionati. In tal caso, le voci non utilizzate saranno contrassegnate come escluse nella costruzione.
Una costruzione a più fasi è rappresentata dallo stesso codice ID Anything™ in tutte le fasi, consentendo di attaccare etichette ID Anything™ anche a dispositivi incompleti per una rapida identificazione e accesso alle informazioni di costruzione.
Quando si gestisce la produzione, è importante mantenere un registro della cronologia delle produzioni. Questo registro include tipicamente informazioni come il numero di unità costruite per un progetto o BOM, la data e l'ora della produzione e qualsiasi commento rilevante. Sebbene questo livello di dettaglio sia sufficiente per semplici cicli di produzione, le produzioni più complesse richiedono spesso il tracciamento di dati aggiuntivi.
Negli scenari reali, ogni produzione ha la sua configurazione unica. Questa configurazione include informazioni supplementari, tra cui:
PartsBox memorizza tutte queste informazioni come parte della cronologia delle build, consentendoti di rivedere e verificare facilmente come una particolare build è stata configurata in qualsiasi momento futuro.
Per accedere alla cronologia della configurazione della build, vai alla scheda 'Build' all'interno della sezione Progetti di PartsBox. Qui troverai un elenco di tutte le build. Puoi scegliere di visualizzare l'elenco completo o filtrarlo per mostrare solo le build completate o le build a più fasi attualmente in corso.
A ogni produzione viene assegnato un codice univoco ID Anything™, che può essere stampato su un'etichetta e apposto sui dispositivi fisici prodotti durante quella produzione. Questo codice fornisce un accesso rapido e comodo alle informazioni sulla produzione, garantendo che tu possa recuperare i dettagli rilevanti ogni volta che è necessario, anche molto tempo dopo che la produzione è stata completata.
Quando si visualizza una costruzione completata o in corso, la scheda Scorte utilizzate nella navigazione a sinistra mostra le scorte che sono state consumate durante quella costruzione. La tabella Scorte utilizzate ha due scopi: in primo luogo, mostra cosa è stato utilizzato o consumato in una costruzione e quanto è costato; in secondo luogo, ti consente di gestire i lotti visualizzati nella tabella — ad esempio, spostarli in un luogo di stoccaggio diverso, regolarne i conteggi delle scorte o etichettarli.
Il livello di dettaglio disponibile dipende dall'abilitazione del controllo dei lotti. Senza il controllo dei lotti, le scorte per un componente in un determinato luogo di stoccaggio sono fungibili — non esiste il concetto di un lotto che può essere tracciato o gestito individualmente. Di conseguenza, non è possibile vedere il costo esatto dei componenti consumati in una costruzione, né gestire le scorte consumate direttamente da questa vista.
Per i piani senza controllo dei lotti, la tabella Giacenza Utilizzata visualizza i nomi dei componenti, le quantità utilizzate, i designatori e i luoghi di stoccaggio. Questo fornisce un riepilogo di ciò che è stato consumato.
Per i piani con controllo dei lotti, la tabella Giacenza Utilizzata fornisce dettagli completi. Le colonne predefinite includono il nome del componente, il nome del lotto, la quantità utilizzata, il costo, i designatori, il luogo di stoccaggio e la quantità rimanente attuale in ogni lotto. Il tracciamento dei costi mostra il costo totale della giacenza consumata, calcolato dal costo unitario di ogni lotto. Puoi espandere ogni riga per vedere i dettagli completi del lotto.
La variante di controllo dei lotti supporta anche operazioni in blocco sui lotti consumati:
Per utilizzare le operazioni in blocco, seleziona i lotti utilizzando le caselle di controllo, quindi scegli un'operazione dal menu.
I meta-componenti in PartsBox rappresentano lo stock risultante dalla costruzione di progetti. Quando viene costruito un progetto, lo stock del meta-componente corrispondente viene incrementato della quantità costruita. Ciò consente di gestire efficacemente prodotti complessi costituiti da più sotto-assiemi e componenti, con ogni sotto-assieme prodotto o reperito separatamente.
Per creare un meta-componente per un progetto:
Dopo la creazione, il componente sotto-assemblaggio apparirà nell'elenco dei componenti e potrà essere gestito come qualsiasi altro componente, con un'eccezione: il nome di un componente sotto-assemblaggio è sempre lo stesso del progetto corrispondente e non può essere modificato.
Quando si costruisce un progetto, la schermata di conferma della produzione include un'opzione per aggiungere stock al componente di sotto-assemblaggio associato. Se abilitata, puoi:
Dopo la conferma, lo stock del componente di sotto-assemblaggio verrà incrementato della quantità di costruzione. Poiché i componenti di sotto-assemblaggio si comportano come componenti regolari, possono essere utilizzati in altri progetti e costruzioni, e possono essere configurate funzionalità come avvisi di scorte basse e parametri di attrito.
Quando il controllo lotti è abilitato, ogni costruzione di un progetto risulta in un lotto distinto del corrispondente meta-componente di sotto-assemblaggio, identificato da un codice univoco ID Anything™. Attaccando etichette ID Anything™ ai dispositivi prodotti, puoi scansionare rapidamente il codice utilizzando un dispositivo mobile per accedere alle informazioni di costruzione associate.
Quando si visualizza una produzione per un progetto con un componente sotto-assemblaggio, la scheda Risultati Produzione nella navigazione a sinistra mostra la giacenza risultante creata da quella produzione. Questo funziona in modo simile alla vista Giacenza Utilizzata descritta sopra: con il controllo dei lotti, ottieni dettagli completi per lotto (nome del lotto, quantità, luogo di stoccaggio, commenti) e operazioni in blocco (tagging, spostamento, regolazione dei conteggi delle scorte); senza il controllo dei lotti, viene mostrato un riepilogo dei luoghi di stoccaggio, delle quantità e dei commenti.
PartsBox offre una potente funzionalità per tracciare i singoli dispositivi costruiti da progetti/BOM. Quando si avvia una build, è possibile abilitare l'opzione "Traccia separatamente ogni sotto-assemblaggio risultante". Questo cambia il processo di build per generare lotti individuali per ogni sotto-assemblaggio costruito, assegnando effettivamente un numero di serie univoco a ogni dispositivo.
Abilitare questa opzione sblocca una vasta gamma di possibilità per tracciare il ciclo di vita dei singoli dispositivi. I lotti in PartsBox portano già una quantità significativa di dati e hanno codici ID Anything™ unici assegnati a loro. Puoi allegare dati aggiuntivi a questi lotti sotto forma di file, come risultati dei test, protocolli di riparazione, documenti normativi, cronologia dei servizi o qualsiasi altra informazione rilevante.
A ogni lotto viene assegnato un codice ID Anything™ univoco, che può essere stampato come codice QR e attaccato fisicamente al dispositivo corrispondente. Ciò consente una facile identificazione e tracciabilità dei singoli dispositivi. In alternativa, i dispositivi possono essere identificati da una combinazione del codice ID Anything™ della produzione (che punta alla produzione specifica) e un numero seriale intero assegnato automaticamente all'interno di quella produzione.
Quando l'opzione per aggiungere stock di componenti sotto-assemblaggio è abilitata per una produzione multi-fase, PartsBox tiene traccia dello stock attualmente in produzione. Ciò consente di allegare informazioni su potenziali anomalie nella produzione o risultati di test individuali a ciascun lotto di dispositivi mentre vengono costruiti. Al completamento della produzione, lo stato dello stock cambia da "In produzione" a "Disponibile".
PartsBox supporta tre tipi di ordini, ognuno dei quali rappresenta una fase diversa nel processo di acquisto:
Per creare un ordine o aggiungere articoli a un ordine aperto esistente, puoi iniziare esaminando i prezzi e le offerte per un singolo componente o lavorando con una Lista d'Acquisto. PartsBox ti consente di aggiungere singole offerte o un gruppo di offerte a un ordine, associandole al fornitore corrispondente che ha fornito il prezzo.
Quando si modificano le quantità in un ordine aperto, PartsBox recupera automaticamente le informazioni sui prezzi correnti e regola il prezzo totale in base alla quantità e agli eventuali sconti per quantità applicabili. Questo garantisce che tu abbia sempre prezzi aggiornati e accurati per i tuoi ordini.
Gli ordini aperti possono essere trasferiti al sito web di un distributore tramite copia e incolla, oppure possono essere esportati in un formato adatto se è richiesto un ordine di acquisto stampato più formale.
Il modo più efficiente per effettuare un ordine con un fornitore è utilizzare la funzione 'Carica carrello'. Questo ti permette di copiare e incollare o caricare un file CSV contenente i dettagli dell'ordine.
Quando contrassegni un ordine aperto come 'Ordinato', PartsBox ti chiede di fornire una data di consegna prevista. Queste informazioni ti aiutano a tenere traccia di quando è previsto l'arrivo dei tuoi componenti e consentono al sistema di visualizzare lo stock ordinato in varie sezioni pertinenti dell'applicazione.
Se necessario, puoi annullare un ordine, il che riporta il suo stato a 'Aperto' e rimuove lo stock previsto dalla visualizzazione.
PartsBox offre diversi metodi convenienti per ricevere componenti da un ordine:
Quando si pianifica la produzione di più dispositivi elettronici, è spesso necessario acquistare componenti all'ingrosso. Tuttavia, determinare le quantità esatte necessarie può essere difficile, specialmente quando si considera lo stock locale esistente e i componenti condivisi tra diverse BOM (Distinte Base).
La presenza di meta-componenti (sostituti di componente), alternative di componente e sostituti BOM aggiunge un altro livello di complessità al processo di acquisto. Fino al momento dell'ordine, è vantaggioso mantenere la flessibilità nella scelta di specifici MPN (Manufacturer Part Numbers).
Per avviare il processo di acquisto, vai alla sezione 'Progetti' e inizia ad aggiungere progetti/BOM al tuo carrello progetti utilizzando i pulsanti 'Aggiungi al carrello' situati nella parte inferiore di ogni scheda progetto. Quando aggiungi un progetto, avrai l'opportunità di specificare le quantità che intendi costruire.
Una volta aggiunti i progetti desiderati al carrello, assegna un nome descrittivo alla tua lista e clicca su 'Crea Lista di Acquisto'. Questa azione ti reindirizzerà alla sezione 'Acquisti', dove potrai visualizzare tutte le tue liste di acquisto.
Cliccando su una specifica lista di acquisto si aprirà la familiare interfaccia di determinazione dei prezzi, simile a quella utilizzata per Prezzi Progetto/BOM. Questa interfaccia ti consente di selezionare offerte, aggiungere le tue offerte, scegliere specifici componenti alternativi (per i meta-componenti) e limitare la tua selezione ai distributori preferiti.
Dopo aver finalizzato la tua lista di acquisto, passa alla visualizzazione 'Raggruppa per Distributore/Venditore' per vedere i tuoi componenti organizzati in ordini separati per ogni venditore. Questa visualizzazione fornisce la stessa funzionalità della visualizzazione 'Tutti i componenti', consentendoti di modificare le scelte di offerta se necessario. Inoltre, puoi aggiungere rapidamente tutti i componenti a un ordine nuovo o esistente con un venditore specifico e procedere a effettuare l'ordine direttamente con loro.
Sebbene il supporto per l'ordinazione automatica sia sempre stato parte del piano a lungo termine, la sua implementazione rimane impegnativa a causa delle complessità coinvolte nell'integrazione con i sistemi dei vari distributori.
PartsBox calcola il valore del tuo inventario di componenti utilizzando i prezzi di acquisto inseriti durante l'aggiunta delle scorte. Comprendere come funziona questa valutazione aiuta con i report finanziari e la gestione dell'inventario. Anche la strategia di selezione della fonte del componente (FIFO, LIFO, ecc. — vedi la sezione Costruzione di Progetti) influisce sulla valutazione: con il controllo dei lotti, determina quali costi specifici dei lotti sono attribuiti a ciascuna costruzione, mentre senza il controllo dei lotti viene utilizzato il costo medio.
Per ogni componente, PartsBox traccia:
Quando il controllo lotti è abilitato, PartsBox traccia il prezzo di acquisto esatto per ogni lotto. Questo fornisce informazioni precise sui costi per lotto:
Questa valutazione esatta è particolarmente utile per:
Senza il controllo dei lotti, PartsBox utilizza il metodo del costo medio per la valutazione dell'inventario:
I report ti consentono di ottenere informazioni generali sui tuoi dati.
Come tutto il resto in PartsBox, i report si aggiornano in tempo reale. Ad esempio, se tieni aperto un report 'Scorte Basse' e qualcun altro rimuove dello stock (causando la discesa dello stock per un particolare componente al di sotto di una soglia), il tuo report verrà aggiornato istantaneamente.
PartsBox supporta la collaborazione attraverso il concetto di organizzazione (aziende). Un'azienda o organizzazione in PartsBox rappresenta un database condiviso a cui più utenti possono accedere contemporaneamente. Ciò consente ai team di lavorare insieme alla gestione del proprio inventario di componenti elettronici, agli acquisti e alla produzione.
Quando crei un'azienda o un'organizzazione in PartsBox, puoi invitare altri utenti a unirsi e collaborare. Il numero di utenti che possono accedere a un database aziendale dipende dal tuo piano di abbonamento. Se hai bisogno di ospitare più utenti, puoi aggiornare il tuo piano di conseguenza.
Per concedere a qualcuno l'accesso a un database aziendale, deve prima creare un account PartsBox. Una volta che ha un account, un amministratore dell'azienda può invitarlo e concedergli i diritti di accesso appropriati. Ciò ti consente di controllare chi ha accesso ai dati della tua azienda e quali azioni può eseguire.
Oltre ai database aziendali, ogni utente di PartsBox ha anche un database privato gratuito per uso personale. Questo database privato è separato da qualsiasi database aziendale a cui potresti avere accesso. Puoi passare facilmente tra il tuo database privato e qualsiasi database aziendale utilizzando il selettore di database situato nella parte superiore della schermata dell'app PartsBox. Il selettore mostra il nome del database attualmente selezionato.
Le organizzazioni possono caricare un logo aziendale in Impostazioni > Generali. Il logo viene visualizzato nelle esportazioni PDF, incluse le esportazioni di tabelle e i PDF di prezzatura della distinta base, sostituendo il logo predefinito di PartsBox nell'intestazione del documento.
PartsBox offre opzioni flessibili di controllo degli accessi per garantire che gli utenti abbiano i permessi appropriati in base ai loro ruoli e responsabilità all'interno dell'azienda. Un'azienda ha sempre almeno un utente 'admin' che possiede il massimo livello di controllo e può gestire le informazioni di fatturazione e concedere o revocare l'accesso ad altri utenti.
Per i piani senza Controllo degli Accessi Basato sui Ruoli (RBAC), PartsBox fornisce tre livelli di accesso base:
Per i piani con Controllo degli Accessi Basato sui Ruoli (RBAC), PartsBox offre un approccio più granulare e personalizzabile alla gestione degli accessi. Con RBAC, le aziende possono definire un numero qualsiasi di ruoli e assegnarli agli utenti in base alle loro specifiche responsabilità. Ogni ruolo definisce i permessi per le singole operazioni, come la creazione di componenti, l'aggiunta di stock o l'esecuzione di produzioni.
RBAC consente un controllo granulare sulle autorizzazioni, permettendo alle aziende di creare ruoli limitati con accesso ristretto. Ad esempio, un ruolo 'Ricezione' potrebbe essere definito per consentire agli utenti di aggiungere e spostare lo stock ma non modificare progetti o eseguire build. Questo ruolo sarebbe adatto per i dipendenti responsabili della ricezione e dell'organizzazione dell'inventario in entrata.
Allo stesso modo, un ruolo 'Produzione' potrebbe essere creato per consentire agli utenti di eseguire build da progetti predefiniti ma non modificare i progetti stessi. Questo ruolo sarebbe utile per i dipendenti coinvolti nel processo di produzione che devono assemblare prodotti basati su design stabiliti.
Nelle organizzazioni più grandi, mantenere una traccia di controllo immutabile di tutte le modifiche al database è spesso necessario per la conformità normativa e la tracciabilità. Questo è particolarmente importante per le aziende soggette a normative come la US FDA Title 21 CFR Part 11, che impone rigorosi requisiti di conservazione dei registri e integrità dei dati.
Anche in assenza di obblighi legali, molte aziende scelgono di implementare un audit trail come best practice per garantire la responsabilità e facilitare l'analisi delle cause alla radice in caso di problemi o discrepanze.
I piani PartsBox con la funzione Audit Trail registrano automaticamente una cronologia dettagliata di ogni modifica apportata al database. Ogni record dell'audit trail include:
Queste informazioni forniscono una visione completa e granulare dell'evoluzione del database nel tempo, consentendo agli amministratori di ricostruire la sequenza degli eventi e comprendere il contesto dietro ogni modifica.
I dati dell'audit trail possono essere facilmente esportati da PartsBox in un formato adatto per la firma digitale e l'archiviazione a lungo termine. Questi dati esportati servono come record verificabile della cronologia del sistema, che può essere utilizzato per dimostrare la conformità alle normative pertinenti durante audit o ispezioni.
A ogni oggetto in PartsBox — componenti, lotti, luoghi di stoccaggio, costruzioni, ordini e progetti — viene assegnato automaticamente un identificatore univoco e compatto chiamato codice ID Anything™. Questi codici sono abbastanza brevi da essere leggibili dall'uomo (26 caratteri) e possono essere codificati come codici QR per la scansione.
I codici ID Anything™ servono a diversi scopi:
Il sistema ID Anything™ è utilizzato in tutto PartsBox. Le sezioni seguenti descrivono queste funzionalità in dettaglio.
La scansione dei codici a barre è un modo rapido ed efficiente per elaborare le spedizioni in arrivo, aggiungere o rimuovere stock e creare nuovi componenti in PartsBox. Questa funzionalità migliora il flusso di lavoro della gestione dell'inventario, risparmiando tempo e riducendo l'inserimento manuale dei dati.
PartsBox supporta due metodi per la scansione dei codici a barre:
Per iniziare a scansionare i codici a barre, fai clic sul pulsante del menu 'Scansiona' in PartsBox. A seconda del metodo di scansione:
Dopo che un codice a barre è stato decodificato con successo, PartsBox analizza i dati e intraprende una delle seguenti azioni:
PartsBox supporta un'ampia gamma di formati di codici a barre comunemente utilizzati dai distributori di componenti elettronici:
Se il codice a barre scansionato include informazioni sulla quantità, verrà automaticamente precompilato nella finestra di dialogo 'Aggiungi Stock'.
Se hai creato il tuo ordine DigiKey all'interno di PartsBox e copiato i codici ID generati nel tuo carrello DigiKey, i codici a barre sui componenti ricevuti conterranno gli ID di PartsBox. Scansionando questi codici a barre, PartsBox identificherà automaticamente l'ordine e la riga associati, permettendoti di ricevere facilmente i componenti a fronte dell'ordine.
Puoi stampare etichette per componenti, lotti, posizioni di stoccaggio, ordini, progetti e produzioni direttamente da PartsBox. Esiste un sistema di modelli che ti consente di personalizzare le etichette in base alle tue esigenze.
Cosa ti serve per la stampa diretta delle etichette:
Il motivo del requisito di JSPrintManager è che i browser non hanno accesso diretto alle stampanti. Per inviare codici grezzi a una stampante, PartsBox deve connettersi a JSPrintManager localmente e chiedergli di inviare i dati alla stampante.
Se hai i prerequisiti, andando su 'Impostazioni | Etichette | Stampante' dovresti vedere un elenco di stampanti disponibili nel tuo sistema. Seleziona lì la tua stampante di etichette compatibile ZPL.
Esistono più categorie di etichette: Componenti, Lotti, Posizioni di stoccaggio, Ordini, Progetti e Costruzioni. In ciascuna di queste categorie, PartsBox ti consente di definire più modelli di etichette. Ciò ti consente di passare rapidamente tra vari tipi o dimensioni di etichette. Nei piani commerciali, i modelli di etichette sono condivisi all'interno dell'intera azienda.
Per creare un nuovo modello di etichetta, vai su 'Impostazioni | Etichette' e seleziona una delle categorie. Se clicchi su 'Crea' nella categoria selezionata, vedrai un modello precompilato con un'etichetta di esempio. Questi esempi sono stati preparati con cura per essere un buon default con etichette da 2,25x1,25 pollici (sì, Zebra specifica le dimensioni delle etichette solo in pollici, queste sono 57,15mm x 31,75mm).
Sul lato sinistro del modulo del modello di etichetta, vedrai:
Sul lato destro del modulo del modello di etichetta c'è una sezione "Campi". Questa elenca i campi dati nel tuo modello (contrassegnati con numeri tra parentesi graffe). PartsBox rileva automaticamente i campi in base al numero più alto utilizzato nel tuo modello. Ad esempio, se usi {0}, {1} e {5} nel tuo modello, avrai 6 campi da configurare (campi da 0 a 5). Per ciascuno di questi campi, puoi scegliere qualsiasi campo dati disponibile in PartsBox. Suggeriamo di digitare sulla tastiera per cercare, poiché ci sono così tanti campi dati PartsBox tra cui scegliere.
Una volta cliccato su 'Salva', il tuo modello sarà disponibile per l'uso.
Una volta selezionata una stampante e creato almeno un modello di etichetta, puoi stampare etichette per qualsiasi oggetto in PartsBox.
Per stampare un'etichetta, apri la schermata delle informazioni per l'oggetto che vuoi etichettare. Per i componenti, questa è la schermata delle informazioni del componente; per le posizioni di stoccaggio, la schermata delle informazioni della posizione di stoccaggio; e similmente per altri oggetti. Nell'angolo in alto a destra della schermata delle informazioni, cerca il pulsante ID Anything™, che mostra una piccola icona di codice QR e una versione breve del codice ID Anything™. Clicca su questo pulsante per aprire una finestra di dialogo che mostra un selettore di modelli, un'anteprima dell'etichetta e un pulsante 'Stampa Etichetta'.
PartsBox supporta scanner di codici a barre che generano sequenze di tasti, il che include la maggior parte degli scanner USB. Lo Zebra LS2208 è uno scanner 1D affidabile ed economico che funziona bene con PartsBox. Tuttavia, poiché i distributori di componenti stanno adottando sempre più codici a barre 2D per la loro superiore capacità di archiviazione dati, si raccomanda uno scanner 2D per rendere la tua configurazione a prova di futuro.
Per utilizzare uno scanner 2D con PartsBox, devi configurarlo per sostituire i caratteri speciali non stampabili (codici ASCII RS, GS ed EOT) rispettivamente con le stringhe '{RS}', '{GS}' e '{EOT}'. Questo è necessario affinché lo scanner funzioni correttamente con le applicazioni basate sul web. Se possiedi uno scanner Zebra DS2208, scansiona semplicemente il codice a barre fornito per configurarlo automaticamente per l'uso con PartsBox:

Qualsiasi scanner 1D che supporti l'interfaccia USB HID (cioè, agisce come una tastiera) dovrebbe funzionare con PartsBox. Se l'output dello scanner è visibile in un editor di testo, è compatibile con PartsBox.
Gli scanner 2D noti per funzionare bene con PartsBox includono:
È noto che lo Zebra DS6608 (fuori produzione dal 2007) non funziona con PartsBox.
Per utilizzare uno scanner 2D con PartsBox, lo scanner deve supportare le sostituzioni di stringhe nei codici scansionati (noto come 'Advanced Data Formatting' o 'ADF' negli scanner Zebra). Questa è una limitazione dei browser web, non di PartsBox.
Per la migliore esperienza di scansione dei codici a barre, PartsBox consiglia di utilizzare uno scanner 2D dedicato, in particolare lo Zebra DS2208. Uno scanner 2D può decodificare codici a barre sia 1D che 2D, garantendo la compatibilità con la crescente tendenza dei codici a barre 2D utilizzati dai distributori.
Un'alternativa più economica è l'app Barcode to PC, che consiste in un software installato sul tuo PC e un'app mobile per la scansione. Sebbene questa soluzione non funzioni attualmente in modo affidabile con i codici DataMatrix, sono previsti miglioramenti in futuro.
A causa di fattori al di fuori del controllo di PartsBox, non è possibile garantire un'affidabilità al 100% quando si utilizzano scanner USB per la scansione di codici a barre.
Se uno scanner 2D non funziona con PartsBox:
Si prega di fare riferimento alla sezione 'Problemi noti e limitazioni' sopra per vedere se il problema è elencato. Se l'output dello scanner in Blocco note appare corretto ma PartsBox non riesce ancora a riconoscere il codice a barre, utilizzare il modulo di feedback per segnalare il problema.
PartsBox ti permette di rendere pubblico il tuo database di componenti, condividendo alcuni o tutti i tuoi componenti con altri. Questa funzione è utile per gli hobbisti che vogliono condividere il loro inventario di componenti, così come per i makerspace che vogliono mostrare i componenti disponibili.
Per pubblicare i tuoi componenti, vai alla sezione Impostazioni | Pubblicazione. Qui puoi inserire informazioni su te stesso o sulla tua organizzazione, come una breve descrizione, un URL e una descrizione più lunga. Queste informazioni verranno visualizzate sulla tua pagina pubblica.
Nota che la tua pagina pubblica esisterà solo se hai selezionato dei componenti per la pubblicazione. Gli aggiornamenti alla pagina pubblica non sono istantanei e possono richiedere da diversi minuti a un'ora.
PartsBox offre tre opzioni per selezionare i componenti da rendere visibili pubblicamente:
Selezionando attentamente quali componenti pubblicare, puoi controllare le informazioni che vengono condivise con altri mantenendo privati gli altri tuoi dati.
PartsBox si integra con KiCad versione 7.0 o successiva, permettendoti di accedere ai dati dei tuoi componenti PartsBox direttamente all'interno del Symbol Chooser di KiCad. Questa integrazione utilizza la funzionalità Librerie HTTP di KiCad.
Le librerie HTTP di KiCad funzionano come interfacce di sola lettura verso fonti di dati esterne come PartsBox. Non memorizzano i dati dei simboli o dei footprint, ma fanno riferimento a simboli e footprint definiti nelle librerie standard di KiCad (.kicad_sym). Quando selezioni un componente dalla libreria HTTP di PartsBox in KiCad, questo popola il simbolo schematico con i dati da PartsBox, come il codice produttore (MPN), il valore, il footprint e altri campi specificati.
Per configurare l'integrazione di KiCad in PartsBox:
La configurazione è divisa in queste sezioni:
Le categorie definiscono sottoinsiemi del tuo database componenti che saranno visibili come sezioni navigabili separate all'interno del Selettore Simboli di KiCad.
Questa sezione controlla come i dati dei componenti di PartsBox vengono mappati ai campi simbolo di KiCad.
Value, Footprint, Datasheet, Keywords, Reference, MPN, Manufacturer. Puoi anche definire nomi di campi personalizzati.\n- Scegli se il campo deve essere visibile nello schema per impostazione predefinita.\n- Alcune mappature sono integrate e non possono essere modificate. La mappatura symbolIdStr è essenziale: dice a KiCad quale simbolo utilizzare dalle tue librerie KiCad standard. Questo è sempre mappato al campo "[Componente] Simbolo KiCad" in PartsBox.\n- ID Anything™ viene utilizzato per abbinare le distinte base importate ai componenti ed è sempre mappato al campo KiCad "ID PartsBox".\n- L'URL ID Anything™ viene utilizzato per passare rapidamente alla pagina delle informazioni del componente in PartsBox (dove è possibile accedere ai datasheet), quindi è sempre mappato al campo KiCad "datasheet". Questo ti consente di premere 'd' in KiCad per aprire la pagina delle informazioni del componente in PartsBox.\n- Si consiglia di mappare Footprint a "[Componente] Impronta KiCad" e Reference a "[Componente] Riferimento KiCad".Questa sezione fornisce il file di configurazione necessario per KiCad.
.kicad_httplib.Per abilitare la libreria PartsBox in KiCad:
partsbox.kicad_httplib (o qualsiasi nome con l'estensione .kicad_httplib).\n- Posiziona questo file in una posizione accessibile da KiCad, come una directory della libreria KiCad o una posizione personalizzata.\n- In KiCad, vai su 'Preferenze' -> 'Gestisci librerie di simboli...'.\n- Nella finestra di dialogo 'Librerie di simboli', fai clic sul pulsante '+' o su 'Aggiungi libreria'.\n- Naviga e seleziona il file partsbox.kicad_httplib che hai salvato.\n- (Facoltativo, consigliato) Assegna un nome alla libreria in modo che appaia prima delle altre librerie nel selettore dei simboli, ad esempio "*Libreria PartsBox".\n- Assicurati che la libreria sia abilitata (casella di controllo selezionata) e fai clic su 'OK'.La libreria PartsBox apparirà ora nel Selettore Simboli di KiCad. Puoi sfogliare le categorie che hai definito e selezionare i componenti.
Affinché l'integrazione funzioni correttamente, PartsBox deve sapere quale simbolo KiCad, footprint e prefisso di riferimento associare a ciascun componente. Questo è configurato nella vista dettagli del componente:
Device:R, MyLibrary:MySymbol). Questo valore verrà mappato al campo symbolIdStr in KiCad.Resistor_SMD:R_0603_1608Metric).R, C, U).Salvare queste impostazioni le rende disponibili tramite l'API per l'uso da parte di KiCad quando il componente viene selezionato.
In futuro, ci sarà un modo per impostare questi campi per più componenti selezionati contemporaneamente (ad esempio, selezionare tutti i componenti con un tag "resistore" e impostare il loro riferimento KiCad su "R").
Puoi rendere accessibile la tua libreria PartsBox in Altium Designer. I tuoi simboli e impronte risiederanno ancora in Altium, mentre tutti gli altri dati sui componenti saranno accessibili da PartsBox. L'integrazione con Altium Designer è leggermente più complessa da configurare a causa dei suoi requisiti legacy di connessione al database ODBC.
Dovrai eseguire PartsBox Outpost™ sulla tua macchina. È un'applicazione che fornisce sincronizzazione in tempo reale con il tuo database PartsBox online e offre un'interfaccia SQL a cui Altium Designer può connettersi. Outpost™ viene fornito come container Docker. Per ora, la sincronizzazione è solo unidirezionale, quindi non c'è modo di apportare modifiche al tuo database PartsBox dall'interno di Altium, ma questo potrebbe cambiare in futuro.
Prerequisiti:
Inizia installando il driver ODBC PostgreSQL. Quindi, installa Docker Desktop e scarica l'immagine jrychter/outpost:latest da Docker Hub.
In Docker Desktop, fai clic sull'icona Esegui accanto al nome dell'immagine nella sezione "Images". Quindi apri la sezione "Optional settings".
Nella sezione "Porte", inserisci 5432 per la porta host corrispondente a :5432/tcp.
Nella sezione "Variabili d'ambiente", crea due variabili d'ambiente:
PARTSBOX_API_KEY: questo dovrebbe contenere la tua chiave API di PartsBoxPOSTGRES_PASSWORD: password del database che utilizzerai in Altium Designer per connetterti al databaseClicca sul pulsante "Run" e dovresti vedere un container in esecuzione nella sezione "Containers". Se clicchi sul container, puoi controllare i log per eventuali messaggi anomali.
Dopodiché, puoi creare una DbLib o DbLink in Altium (consulta la documentazione di Altium Designer per i dettagli sulle differenze tra questi). Scegli "File | New | Library" dal menu principale, poi scegli "Database Library".
Nella sezione "Origine della connessione", scegli "Usa stringa di connessione". Quindi configura la seguente stringa di connessione: Driver={PostgreSQL Unicode};Server=localhost;Port=5432;Database=postgres;UID=postgres;PWD=LA_TUA_PASSWORD_QUI
Assicurati di utilizzare la stessa password del database che hai usato all'avvio del container Docker. Inoltre, assicurati che non ci siano spazi alla fine della stringa di connessione.
Clicca sul pulsante "Avanzate". Nelle opzioni SQL, cambia i caratteri di virgolette sinistra e destra in virgolette doppie (") e lascia selezionata l'opzione "Quote Tables".
Fai clic su "Connetti". Dovresti vedere i campi del database apparire nella tabella appena sotto le impostazioni dei campi.
Nella sezione "Impostazioni Campo", scegli "Ricerca Chiave Singola", e per il campo "Database", scegli "ID PartsBox".
A questo punto, dovresti avere una connessione al database funzionante con la mappatura automatica dei campi essenziali. Probabilmente vorrai salvare questo database.
Se la connessione fallisce con un messaggio di errore, una cosa da controllare è il nome del driver ODBC a cui si fa riferimento nella stringa di connessione. Per elencare tutti i driver ODBC sulla tua macchina, puoi usare Windows PowerShell e il seguente comando: Get-OdbcDriver. Dovresti quindi usare il nome del driver appropriato di uno dei driver elencati nella stringa di connessione.
PartsBox fornisce un'API per l'accesso programmatico al tuo database di componenti. L'API è orientata alle operazioni: piuttosto che esporre direttamente gli oggetti del database, fornisce operazioni specifiche per la gestione di componenti, giacenze, luoghi di stoccaggio, progetti, BOM, ordini, produzioni, lotti e altro ancora. Questo consente l'integrazione con altri sistemi come ERP, MES o strumenti personalizzati.
L'API utilizza JSON per le richieste e le risposte (con EDN come alternativa) e si autentica utilizzando le chiavi API. Per generare una chiave API, vai su Impostazioni nella tua organizzazione.
Per la documentazione completa, incluse le operazioni disponibili, i formati di richiesta/risposta e gli esempi, consulta la documentazione API.