Consultazione e modifica dati via interfaccia tabellare
Dipende da
Supabase (connessione PostgreSQL diretta)
Shopify (E-commerce)
Store
0zzi2q-mt.myshopify.com (MonosTech)
API
GraphQL Admin API 2025-10
Autenticazione
Client Credentials Grant (token 24h)
Scope attivi
read_products, write_products, read_orders
Prodotti
~47.700 — 9 collezioni
Stato
Pre-lancio (password-protected)
Limiti noti
Token scade ogni 24h (workflow automatico di rinnovo). Rate limit API: 50 punti/secondo. productSet richiede productOptions. Dev Dashboard su dev.shopify.com (NON partners.shopify.com).
Keepa (Prezzi Amazon)
Endpoint
GET https://api.keepa.com/product
Piano
€49/mese
Rate limit
60 token/min, riserva massima 3.600 token; ogni EAN richiesto costa circa 2 token
Dominio
8 (Italia)
Formato prezzi
Centesimi di euro
Limiti noti
Rifiuta intero batch se un EAN non è numerico. Può restituire più ASIN per stesso EAN (deduplicazione necessaria). Parametri history=0 e offers=0 causano errore.
Amazon SP-API (Ordini, catalogo, commissioni)
Auth
App privata self-authorized, token in cache (amazon_spapi_token), rinnovo automatico
Cosa usa
Reports API (All Orders Report, offerte attive, settlement), Catalog Items (risoluzione ASIN), Orders API (getOrders, promise date), Product Fees API (commissione reale)
Workflow
ZyM50qRv5BD3vb35 Ottieni Token · giqf40VGF1weKj50 Scarica Report Ordini · risoluzione catalogo/promise/fee dentro EYb73mtnwJihyPgM Amazon Ordini - Analizza · xOl2i2xmTde6bn4i archivio ordini per il magazzino (ogni notte alle 05:00) · sAR2NhyeX0stueA5 / 5vQk9CjBqBdhlsBC monitor offerte in perdita (02:30 e 14:30) · J4GMYfNhrqpsebhU archivio settlement (lunedì 06:00)
Limiti noti
Ogni fase ha un interruttore dedicato in tool_amazon_soglie, regolabile da NocoDB senza deploy. Rate limit reale getMyFeesEstimateForASIN 1 rps; searchCatalogItems paginato a 10 item anche chiedendone 20. Dettagli in docs/architecture/tool-raccomandatore-amazon.md.
Tassi di cambio BCE
Fonte
Feed ufficiale Banca Centrale Europea, 29 valute
Workflow
Tl0H891mq6CpGjUe Tassi Cambio - Aggiorna da BCE, ogni notte all’01:00
Tabella
tassi_cambio
Usato da
Tool Ordini Amazon, per convertire gli ordini in valuta estera
Nessun ripiego cablato
Se il workflow si ferma oltre tassi_cambio_stantio_giorni, il tool non converte le righe estere: le porta in verifica, per non calcolare un margine su un cambio vecchio. Il workflow stesso invia una mail d’errore.
Telegram Bot (Alert)
Bot
@monostestacv_bot
Credenziale n8n
“Telegram Shopify”
Uso
Solo avvisi urgenti: oggi il monitor delle offerte Amazon in perdita, inviato a ogni riga di avvisi_destinatari con un chat ID Telegram. Report e avvisi non urgenti vanno per email
TS Digital Invoice (Fatturazione)
Servizio
TeamSystem TS Digital
Codice SDI
M5UXCR1
P.IVA
05159410876
API
B2BRead / B2BWrite
Token
Non scade (finché chiave non modificata)
Uso automatico
Import fatture di acquisto → carico del ledger magazzino (giornaliero 06:00) e fatture di vendita → scarico (giornaliero 06:15)
Analisi All Orders Report: per ogni riga tutte le opzioni fonte merce (fornitori, conto deposito, sede Monos) × modalità spedizione, con profitto e margine netti IVA, prezzo effettivo (listino con eco-contributi / promozione valida / prezzo BID), freschezza dei dati e scelta manuale registrata
Configurazione
Da NocoDB: regole_fonte_spedizione (combinazioni, accessori, lead time), fornitori_spedizione (tariffe), tool_amazon_soglie (soglie freschezza e interruttori SP-API: spapi_import_report, spapi_catalog_risoluzione, spapi_promise_date), tool_amazon_scelte (storico scelte), prezzi_bid (prezzi riservati: TD Synnex importati dal file ShipAndDebit, inserimento manuale per gli altri fornitori)
Tutto il sistema si ferma (import, pricing, sync Shopify). Lo store Shopify continua a funzionare con i dati dell’ultimo sync. Recovery: attendere ripristino, poi rieseguire pricing + sync.
Se n8n va giù
Nessun import, nessun pricing, nessun sync. I dati in Supabase e Shopify restano invariati. Recovery: riavviare container Docker sulla VPS (docker compose restart).
Se Shopify va giù
Store non raggiungibile, sync fallisce. Il sistema continua a funzionare (import, pricing), i dati si accumulano. La prossima sync allinea tutto.
Se Keepa va giù / quota esaurita
Prezzi Amazon non aggiornati. Il pricing funziona ugualmente, usa gli ultimi prezzi disponibili. Recovery automatico al ripristino.
Se un FTP fornitore va giù
Dati di quel fornitore non aggiornati. Il pricing usa i dati dell’ultimo import riuscito. Recovery automatico al prossimo import schedulato.
5. Riepilogo Costi Servizi
Servizio
Costo
Note
Supabase
Free / $25/mese (Pro)
Dipende dal piano scelto
Keepa
€49/mese
60 token/min
VPS Hostinger
~€10/mese
n8n + NocoDB
Shopify
Piano merchant
Costo standard Shopify
TS Digital
Incluso nel contratto TeamSystem
—
Telegram
Gratuito
Bot API
GitHub
Gratuito
Repository privato
MonosTech — Mappa Componenti e Dipendenze — Ultimo aggiornamento: 12/10/2026