Vol. 1 · Numero 01
Velo/Stack
Aprile 2026 · Innsbruck

Open Source · Server VeloConnect

Il tuo server VeloConnect.

VeloStack è un server VeloConnect open source 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 · Server VeloConnect
Per
Rivenditori · Produttori · Fornitori
Dal
2024, Veloflott GmbH

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 in TriData, Velo.Port e altri gestionali — senza dover mantenere un formato proprietario per ogni ERP.

§ 01

Funzionalità

Cosa fa VeloStack
  1. 01

    VeloConnect 1.5 + BIDEX

    Operazioni core e catalog complete: TextSearch, GetItemDetails, Order. Export BIDEX BikeData V1.6 per la gerarchia modello/varianti.

    // 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 + SQLite, 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 (34 strumenti)

    Gestione catalogo basata su AI, controlli qualità e mappatura BIDEX tramite Model Context Protocol. Utilizzabile direttamente da Claude o qualsiasi client MCP.

    // AI
  9. 09

    Order Dispatch (7 canali)

    Invia ordini via VeloConnect, REST, email, CSV, SFTP, WebDAV o S3. Audit trail integrato con HMAC-SHA256.

    // Dispatch
§ 02

Sorgente

Accesso su richiesta

VeloStack è open source, ma attualmente in un repository privato. Concediamo l'accesso al codice a rivenditori, sviluppatori e partner ERP su richiesta via email.

Stato
Privato · Solo su invito
Stack
FastAPI · PostgreSQL · SQLAlchemy · Jinja2
Licenza
AGPL-3.0 · licenza commerciale disponibile
Open source.
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.5 — oppure usa il server MCP per la gestione basata su AI.