Biblioteca delle integrazioni
Come progettare un portale ordini B2B per rivenditori con Mikro ERP?
Introduzione alla progettazione di clienti, prodotti, ordini e autorizzazioni per usare i dati Mikro ERP in un portale rivenditori.
- Mikro ERPRecord principali e regole commerciali
- Servizio di integrazione autorizzatoMappatura, coda e verifica degli esiti
- Portale rivenditoriVisualizzazione autorizzata e richiesta di operazione
Un portale rivenditori non è soltanto un sito che mostra prodotti. Ogni rivenditore deve vedere prezzi, stock, ordini precedenti e autorizzazioni corretti. Nelle aziende che usano Mikro ERP, il primo passo non è copiare dati, ma stabilire in quale sistema vengono confermate le operazioni dei rivenditori.
Punti di partenza tecnici
La documentazione MikroAPI include gruppi di operazioni per conti cliente, stock e ordini: sono punti di accesso da esaminare per questi ambiti. Listini, sconti, autorizzazioni e annullamento degli ordini vanno verificati separatamente tramite endpoint appropriati e regole ERP.
Moduli principali del portale
Identità e ruolo del rivenditore: Un rivenditore non vede prezzi o ordini di un altro. Gli utenti sono associati a un rivenditore e, se necessario, a più filiali.
Catalogo: Mostra codice, descrizione, immagine, unità di vendita e condizioni di ordinabilità. Dati ERP e immagini del catalogo possono provenire da fonti diverse.
Carrello e preventivo: Prima dell'invio si valutano limite di credito, quantità minima, condizioni commerciali e disponibilità.
Storico ordini: La richiesta creata nel portale e l'ordine accettato nell'ERP possono avere stati differenti, da mostrare separatamente.
Modello dati esemplificativo
| Area | Fonte o decisione |
|---|---|
| Codice rivenditore | Associato al conto cliente ERP |
| Ruolo utente | Gestione degli accessi al portale |
| Codice prodotto | Record di magazzino ERP |
| Prezzo commerciale | Verificato secondo le regole di prezzo aziendali |
| Stato dell'ordine | Monitorato tramite eventi del portale e dell'ERP |
| Registri degli errori | Sistema di osservabilità tecnica |
Checklist prima del rilascio
- Definire un riferimento univoco che impedisca invii duplicati dello stesso ordine.
- Non comunicare “ricevuto” se la registrazione dell'ordine fallisce.
- Mostrare conto cliente e prezzo del rivenditore soltanto agli utenti autorizzati.
- Non conservare inutilmente token, password o dati personali nei log.
- Testare manutenzione, interruzioni di connessione e traffico intenso.
Soluzione pronta o portale su misura?
Una soluzione pronta può bastare per catalogo standard e ordini semplici. Un portale su misura può essere preferibile quando diventano complessi segmenti di rivenditori, personale sul campo, eccezioni commerciali, approvazioni automatiche e regole multimagazzino.
Cosa succede all'ordine se il collegamento ERP si interrompe?
Scenario di esempio: Il rivenditore invia due volte lo stesso carrello. Il portale genera prima il proprio numero e conserva una sola richiesta. Se la risposta ERP si perde, non ricrea il record alla cieca: cerca una corrispondenza tramite il riferimento ERP. Senza una ricerca affidabile o deduplicazione, l'operazione passa alla verifica umana. Il numero del portale, da solo, non garantisce l'assenza di duplicati nell'ERP.
| Fase | Informazione da mostrare al rivenditore |
|---|---|
| Richiesta salvata nel portale | Richiesta ricevuta; in attesa della conferma ERP |
| Controllo commerciale in attesa | In attesa di approvazione; non si afferma che lo stock sia riservato |
| Record ERP verificato | Riferimento ERP e stato verificato |
| Esito incerto | Verifica in corso; non ripetere l'ordine |
Prova questo flusso nella demo degli ordini rivenditori con dati esemplificativi. Pacchetto API disponibile, licenza, azienda/esercizio e autorizzazioni dell'utente di servizio devono essere verificati con il responsabile ERP.
Versione Mikro, servizio API e condizioni del pilota
Il punto di partenza è il servizio MikroAPI locale; non si presume che gli stessi endpoint esistano per JumpBulut o altre famiglie di prodotti. Occorrono famiglia ERP, versione/patch, versione MikroAPI, azienda ed esercizio. I documenti Mikro trattano separatamente installazione del servizio e licenza API Key: avere l'ERP installato non significa avere già accesso API. Indicazioni di installazione e accesso Mikro API.
Per il pilota servono: un responsabile ERP autorizzato, un'azienda di test separata dalla produzione, metodi accessibili per conti, stock e ordini, ambito dell'utente di servizio, regole di magazzino e listino, esito ERP atteso di un ordine campione. Se compare un avviso di licenza o MAG, segui prima la sequenza diagnostica degli errori di licenza MikroAPI.
Esempio di direzione dei dati: conti cliente, prodotti, stock disponibile e prezzi approvati vanno dall'ERP al portale; le nuove richieste d'ordine dal portale all'ERP. Modificare anagrafiche cliente o magazzino da entrambi i sistemi richiede un ambito separato con titolarità dei campi e risoluzione dei conflitti definite.
Fonti e verifica
I flussi esemplificativi sono proposte architetturali, non progetti cliente completati né dichiarazioni di partnership con i produttori. Verifica delle fonti tecniche: 17 ottobre 2026. Versione, licenza e autorizzazioni dell'installazione vanno verificate separatamente.
Adatta il flusso alla tua azienda
Consulta la guida alla pianificazione dell'integrazione ERP. Puoi approfondire il perimetro previsto per lo sviluppo di portali B2B; possiamo valutare insieme il tuo processo attuale.
Parliamo delle tue esigenze →