AGPL-3.0 · Innsbruck Beta v0.4 · Docs →
Vol. 1 · Numero 02
Velo/Stack
ottobre 2026 · Innsbruck

Open Source (AGPL-3.0) · PIM e middleware

Il tuo PIM. Il tuo middleware VeloConnect.

Negozio Veloflott con biciclette negli archi ferroviari di Innsbruck
Veloflott Innsbruck · dal 2014

VeloStack è un PIM e middleware con licenza AGPL-3.0 per entrambi i lati del commercio specializzato di biciclette: per i rivenditori che portano i dati dei fornitori nel proprio gestionale — e per produttori e fornitori che pubblicano il proprio catalogo secondo uno standard. Uno strumento, due direzioni.

Tipo
Open Source (AGPL-3.0) · PIM e middleware
Per
Rivenditori · Produttori · Fornitori
Dal
2024, Veloflott GmbH
Versione
v0.4 · Beta

Per chi

Rivenditori

Porta i dati dei fornitori in modo pulito nel tuo gestionale. Invece di costruire un export proprietario per ogni produttore, parli VeloConnect + BIDEX una volta — e mappi i gruppi merceologici sulla struttura che hai già.

Produttori · Fornitori

Pubblica il tuo catalogo secondo uno standard: modelli con varianti, gruppi BIDEX, ID articolo conformi a EAN. I rivenditori lo integrano direttamente nel proprio gestionale e in altri ERP — senza dover mantenere un formato proprietario per ogni ERP.

§ 00

Panoramica

VeloStack e marketplace
Ricerca nel marketplace con modelli, taglie e colori
01 Marketplace: cerca, confronta, richiedi (dati di esempio)
Negozio Veloflott negli archi ferroviari di Innsbruck
02 Veloflott Innsbruck: qui nasce VeloStack
Ricambi e dettagli freno nello scaffale dell'officina
03 Dettaglio: uno standard, non una via speciale
§ 01

Funzionalità

Cosa fa VeloStack
  1. 01

    VeloConnect 1.1–1.6 + BIDEX

    Server e client per VeloConnect 1.1–1.6: TextSearch, GetItemDetails, Order, documenti (1.3), stock transmit (1.4) e sale transmit (1.6). BIDEX BikeData V1.6 come formato di export e import.

    // Protocollo
  2. 02

    Modello → Variante

    Articoli piatti del fornitore aggregati in modelli con varianti di taglia e colore. Raggruppamento locale via VariantParentNumber, fallback AI.

    // Raggruppamento
  3. 03

    Gruppi merceologici

    Due livelli: classificazione fornitore → codice BIDEX (globale) → tuo gruppo merceologico. Ogni rivenditore mantiene la propria struttura.

    // Mappatura
  4. 04

    Richieste taglia/colore

    Richieste ERP-proprietarie (GetVariantAttributes, GetItemAttribute) supportate — incluso VariantParentNumber e ID conformi a EAN.

    // ERP
  5. 05

    Dual-SKU

    SKU consumer e codici d'ordine B2B in parallelo. Le trade-SKU vengono risolte in SKU consumer tramite prefix match.

    // SKU
  6. 06

    Self-hosted

    FastAPI + PostgreSQL 15 (prod), SQLite (dev), nessuna dipendenza cloud. Funziona su qualsiasi VM Proxmox o host Docker. Nessun vendor lock-in.

    // Infra
  7. 07

    Multi-Tenant + OIDC

    Istanze separate per produttori e rivenditori con gestione identità propria. Ogni tenant riceve credenziali, dati e ruoli propri.

    // Architettura
  8. 08

    MCP Server (54 strumenti)

    54 strumenti per gestione catalogo, mappatura, sync, qualità e documenti. Streamable HTTP, authorization server OAuth 2.1, utilizzabile direttamente da Claude o qualsiasi client MCP.

    // AI
  9. 09

    Order Dispatch (7 canali)

    Invia ordini via VeloConnect, REST, email, CSV, Excel, PDF o noop; trasporto inline o SFTP. Audit trail con HMAC-SHA256 e endpoint di verifica.

    // Dispatch
  10. 10

    BIDEX come fonte di verità

    77 codici attributo e 386 valori (tra cui colori RAL, altezze telaio), 1.711 produttori sincronizzati, profili attributi per tenant e sync automatico del webservice BIDEX.

    // Anagrafiche
  11. 11

    Inventario, documenti ed ERP

    Locations, levels, movements, reservations e push webhook; DDT e fatture PDF; connettori per Shopware, Odoo, REST e IMAP.

    // Operatività
  12. 12

    REST API v1

    OpenAPI/Swagger, bearer token con scope read/write, OIDC JWT e tenant scoping automatico per integrazioni esterne a VeloConnect.

    // API
§ 02

Sorgente

Accesso su richiesta

VeloStack è distribuito con licenza AGPL-3.0-or-later. Il codice sorgente si trova attualmente in un repository privato; concediamo l'accesso a rivenditori, sviluppatori e partner ERP su richiesta.

Stato
Privato · Codice su richiesta
Stack
FastAPI · PostgreSQL · SQLAlchemy · Jinja2
Licenza
AGPL-3.0-or-later · licenza commerciale disponibile
Open source, AGPL-3.0.
Trecentomila varianti.
Uno standard.

// VeloStack · In produzione dal 2026

§ 03

Flusso

In tre passaggi
  1. 01

    Collega il fornitore

    Inserisci le credenziali VeloConnect o importa un export CSV/Excel. Sincronizzazione catalogo con filtro ModelYear.

  2. 02

    Raggruppa e mappa

    VariantParentNumber in locale. Codice BIDEX → gruppo merceologico per rivenditore.

  3. 03

    Interroga dal gestionale

    Il tuo gestionale interroga articoli, inventario e cataloghi via VeloConnect 1.1–1.6 — oppure usa il server MCP per la gestione basata su AI.

  4. 04

    Collega Odoo 20

    Odoo fornisce il fabbisogno dagli ordini di acquisto in bozza. VeloStack sceglie fornitore e canale, riscrive l'ordine confermato e aggiorna i prezzi fornitore — tramite API standard, senza codice Odoo.

Odoo è un marchio di Odoo S.A. VeloStack non è un prodotto ufficiale Odoo e non è affiliato a Odoo.