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.

Codariva ·

  1. Mikro ERPRecord principali e regole commerciali
  2. Servizio di integrazione autorizzatoMappatura, coda e verifica degli esiti
  3. Portale rivenditoriVisualizzazione autorizzata e richiesta di operazione
Architettura esemplificativa: prodotti, prezzi e stock passano dall'ERP al portale; le richieste d'ordine dal portale all'ERP. Titolarità e condizioni di accettazione si definiscono separatamente per ogni dato.

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 →