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.

Codariva ·

  1. Mikro ERPStock disponibile approvato
  2. Servizio di integrazione autorizzatoMappatura SKU/varianti e coda
  3. WooCommerceAggiornamento quantità sul prodotto corrispondente
Ambito principale esemplificativo: la quantità disponibile approvata in Mikro ERP passa tramite il servizio di integrazione al prodotto/variante WooCommerce corrispondente. Trasferimento di ordini e resi è una fase collegata da pianificare separatamente.

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.

  1. Associa i prodotti sui due lati tramite uno SKU comune o una tabella di corrispondenza esplicita.
  2. Mappa codice prodotto, variante, unità, magazzino e stato attivo/inattivo.
  3. Definisci il calcolo dello stock disponibile nell'ERP: quantità fisica, riservata e ordini aperti vanno valutati separatamente.
  4. Scegli eventi o interrogazioni periodiche controllate per trasferire soltanto i record modificati.
  5. Registra gli esiti degli aggiornamenti WooCommerce; le operazioni fallite entrano nella coda dei tentativi.
  6. 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

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 →