Biblioteca delle integrazioni
Integrazione stock Mikro ERP – WooCommerce: architettura e checklist
Aspetti di mappatura, sincronizzazione e gestione degli errori da considerare nel trasferimento dei dati di magazzino tra Mikro ERP e WooCommerce.
- Mikro ERPStock disponibile approvato
- Servizio di integrazione autorizzatoMappatura SKU/varianti e coda
- WooCommerceAggiornamento quantità sul prodotto corrispondente
Se lo stock mostrato al cliente nel negozio e-commerce differisce dallo stock reale nell'ERP, aumentano annullamenti, ritardi e correzioni manuali. Progettando l'integrazione tra Mikro ERP e WooCommerce, la prima decisione è stabilire quale sistema sia la fonte autorevole per lo stock. Questa guida non afferma che l'integrazione esista già: spiega come valutare una soluzione tecnica.
Accesso ai dati offerto dai sistemi
La documentazione ufficiale MikroAPI descrive l'elenco delle giacenze tramite StokListesiV2 e la creazione di record di magazzino tramite StokKaydetV2. La REST API WooCommerce consente invece lettura e aggiornamento dei prodotti. Sono punti di partenza per l'integrazione; occorre testare separatamente come ottenere la quantità disponibile per magazzino.
Flusso dei dati consigliato
Questa sezione riguarda il trasferimento stock dall'ERP al negozio. Se il progetto include anche ordini dal negozio all'ERP, pianificali come flusso distinto. Se le notifiche d'ordine non arrivano, la guida alla diagnosi dei webhook WooCommerce e alla riconciliazione degli ordini mancanti aiuta a distinguere la generazione dell'evento dall'accettazione ERP.
- Associa i prodotti sui due lati tramite uno SKU comune o una tabella di corrispondenza esplicita.
- Mappa codice prodotto, variante, unità, magazzino e stato attivo/inattivo.
- Definisci il calcolo dello stock disponibile nell'ERP: quantità fisica, riservata e ordini aperti vanno valutati separatamente.
- Scegli eventi o interrogazioni periodiche controllate per trasferire soltanto i record modificati.
- Registra gli esiti degli aggiornamenti WooCommerce; le operazioni fallite entrano nella coda dei tentativi.
- Individua SKU mancanti o discordanti con una riconciliazione a fine giornata.
Matrice di test pilota
| Scenario | Comportamento atteso |
|---|---|
| Nuovo SKU | Senza corrispondenza, entra nell'elenco da verificare |
| Prodotto con varianti | Codici di prodotto principale e varianti non vengono confusi |
| Ordini simultanei | Si considera lo stock riservato |
| Connessione interrotta | Si conserva l'ultima sincronizzazione riuscita |
| Lo stesso evento arriva due volte | L'operazione idempotente non esegue un doppio aggiornamento |
Decisioni progettuali più frequenti
Bidirezionale o unidirezionale? Se l'ERP è la fonte autorevole dello stock, riscriverlo da WooCommerce può creare incoerenze. Esistono più magazzini? La quantità mostrata nel negozio deve includere solo i magazzini abilitati alla vendita. Quanto spesso sincronizzare? Va misurato in base ai volumi e alla capacità API, senza promesse arbitrarie di “tempo reale”.
Quando serve un'integrazione su misura?
Un'azienda con un solo magazzino e un catalogo semplice può trovare sufficiente un connettore pronto. Listini speciali, stock per rivenditore, più magazzini, approvazioni o regole ERP particolari aumentano la necessità di progettazione.
Perché lo stock può essere errato anche sul prodotto corretto?
Scenario di esempio: Nell'ERP KOLİ-01 è una confezione, mentre nel negozio lo stesso prodotto si vende a pezzo. Associare soltanto il codice non basta: occorre stabilire i pezzi per confezione e l'unità da scaricare. Allo stesso modo, aggiornare lo stock del prodotto principale non aggiorna automaticamente la variante con giacenza autonoma.
| Dato | Fonte principale | Regola di trasferimento |
|---|---|---|
| Mappatura prodotti/SKU | Elenco di corrispondenze approvato | Un codice sconosciuto non crea automaticamente un prodotto |
| Quantità vendibile | Calcolo concordato nell'ERP | Si applicano magazzini selezionati e regole di prenotazione |
| Ordine del negozio (ambito aggiuntivo) | WooCommerce | Si segue l'accettazione ERP tramite riferimento esterno stabile |
| Annullamento o reso (ambito aggiuntivo) | Secondo le regole aziendali | Un evento ripetuto non incrementa lo stock due volte |
La sincronizzazione stock da sola non garantisce l'assenza di vendite oltre disponibilità. Va testato quando le vendite simultanee nel negozio e nell'ERP riservano la merce. Per una configurazione iniziale, consulta il modello Excel di magazzino e, per problemi di autorizzazione, la guida WooCommerce 401.
Quali versioni e accessi servono prima di collegare i sistemi?
Questo flusso è una proposta architetturale per un negozio con MikroAPI locale e REST API WooCommerce. Si registrano insieme famiglia/versione Mikro e servizio API, versioni WordPress/WooCommerce, struttura prodotti/varianti e plugin che gestiscono lo stock. Si verificano licenza Mikro API e campi del metodo stock utilizzato; sul lato WooCommerce, gli accessi necessari della chiave API associata all'utente. Requisiti di accesso MikroAPI; Autorizzazione WooCommerce.
Prima del pilota: prepara negozio e azienda di test, elenco di SKU/varianti campione, magazzini abilitati, calcolo delle prenotazioni e comportamento della vendita quando lo stock è in ritardo. Prima un confronto in sola lettura su pochi prodotti, poi aggiornamenti controllati nel negozio di test. In questa pagina non è stato collaudato alcun collegamento di un cliente reale.
Fonti e verifica
- Operazioni di magazzino MikroAPI
- Ambito della REST API WooCommerce
- Autenticazione della REST API WooCommerce
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 →