Connettore Amazon per Dolibarr: ordini, FBA, magazzino, tracciabilità e rendiconti

Collegate Dolibarr alla Selling Partner API di Amazon e fate circolare le informazioni nei due sensi. Gli ordini spediti da voi o da Amazon diventano ordini, spedizioni e fatture; le giacenze e i numeri di tracciabilità tornano verso Amazon; i rendiconti e i resi sono riportati riga per riga. Ogni scambio lascia una coda le cui righe in errore vengono rieseguite automaticamente. Una modalità di simulazione consente di configurare e mostrare tutto senza un account Amazon. 

A chi si rivolge? Venditori Amazon che gestiscono la propria attività in Dolibarr: marchi, distributori, rivenditori multipaese, operatori di e-commerce in FBM come in FBA, e gli integratori che li affiancano. Un marketplace o venti, un account venditore o più di uno, il principio resta lo stesso.

Account venditore e istanze

• Un account venditore contiene le credenziali di un'applicazione Amazon, la regione dell'API e i valori predefiniti: cliente di ripiego, commerciale, magazzino, banca, articolo di spedizione.
• Un'istanza collega questo account a un marketplace: è l'istanza a portare la valuta, i magazzini, il flusso di lavoro, la politica di giacenza e l'IVA.
• 23 marketplace installati con il loro identificativo reale, sulle tre regioni: America del Nord, Europa, Estremo Oriente.
• Più account venditore e tutte le istanze necessarie, ciascuna con le proprie impostazioni.
• Un test di connessione richiede un token e poi legge i marketplace dell'account, distinguendo un problema di credenziali da un problema di ruolo o di regione.

Importazione degli ordini

• Importazione degli ordini spediti dal venditore (FBM) e degli ordini spediti da Amazon (FBA), perché il fatturato risulti completo.
• L'acquirente, l'indirizzo di consegna, le righe, gli importi, l'IVA, le spese di spedizione e la finestra di spedizione vengono riportati.
• Il connettore riparte sempre dall'ultima sincronizzazione. Un ordine modificato su Amazon viene ripreso.
• Un ordine annullato viene chiuso senza creare nulla; un ordine in sospeso su Amazon viene lasciato da parte e poi ripreso automaticamente.
• Ricerca e filtri sul numero d'ordine, l'acquirente, la città, la tracciabilità, lo stato, il canale di spedizione e lo stato del flusso di lavoro.
• La scheda mostra a confronto ciò che proviene da Amazon e ciò che esiste in Dolibarr, con collegamenti diretti all'ordine, alla spedizione e alla fattura.

Un flusso di lavoro in dieci interruttori

• Dieci interruttori decidono, istanza per istanza, che cosa viene creato: creare il cliente, validare l'ordine, creare la spedizione, validarla, creare la fattura, validarla, registrare il pagamento, inviare la giacenza, inviare la tracciabilità.
• Una fase disattivata viene semplicemente saltata: l'ordine resta allo stadio raggiunto e si completa manualmente.
• Ogni fase superata viene scritta immediatamente: un'esecuzione interrotta riprende da dove si è fermata, mai dall'inizio.
• Un acquirente sconosciuto diventa un cliente oppure, a scelta, viene ricondotto al cliente di ripiego dell'account.
• Un ordine con una riga che porta un'offerta non associata viene messo in errore anziché creato in modo errato: si associa, si rilancia e riparte.
• Il pagamento viene registrato sul conto bancario dell'account venditore, con il numero d'ordine Amazon come riferimento.

Offerte e associazione ai prodotti

• Importazione delle offerte del venditore: SKU, ASIN, titolo, marca, codice a barre, prezzo, quantità, canale di spedizione e stato.
• Associazione automatica al prodotto Dolibarr tramite riferimento, codice a barre, attributo aggiuntivo Amazon SKU e infine descrizione.
• Una corrispondenza trovata soltanto sulla descrizione viene contrassegnata come dubbia anziché applicata in silenzio; più prodotti omonimi non danno luogo ad alcuna associazione.
• Associazione manuale direttamente nell'elenco, senza uscire dalla schermata, e pulsante «associa tutto ciò che è associabile».
• Un'offerta che non deve mai essere trattata viene impostata su ignorata; creazione automatica dei prodotti mancanti in opzione.
• La scheda prodotto di Dolibarr richiama le offerte Amazon a essa collegate.

Magazzino nei due sensi

• Invio della giacenza ad Amazon con cinque metodi: quantità fissa, giacenza reale, giacenza virtuale, giacenza reale meno un margine, percentuale della giacenza reale.
• Un limite massimo facoltativo e un tempo di gestione dichiarato accompagnano ogni invio.
• Un'anteprima mostra, offerta per offerta, la quantità che verrebbe inviata: la regola si verifica prima di essere attivata.
• Nell'altro senso, l'inventario detenuto da Amazon viene letto e riportato in un magazzino dedicato, tramite movimento di magazzino: la giacenza di Dolibarr diventa completa.
• I numeri di tracciabilità delle spedizioni validate tornano verso Amazon: l'ordine risulta così spedito e il pagamento al venditore viene attivato.

Rendiconti e resi

• Importazione dei movimenti finanziari di Amazon, raggruppati per periodo: vendite, IVA, commissioni, costi FBA, rimborsi e abbonamento.
• Cinque totali per rendiconto – saldo, vendite, costi, rimborsi, altro – e il dettaglio riga per riga, collegato agli ordini noti.
• La risposta alla domanda dei contabili: perché il bonifico di Amazon non corrisponde al fatturato.
• Importazione dei resi dei clienti gestiti da Amazon: identificativo, ordine, SKU, stato della merce, motivo, centro di gestione.
• Un reso rivendibile rientra in giacenza con un clic, tramite un movimento nel magazzino di Amazon.

Code e riesecuzione

• Ogni scambio apre una coda con una riga per ciascun record riportato e il relativo contenuto trasmesso.
• Una riga in errore conserva il proprio contenuto e il proprio motivo: si corregge la causa, poi si rieseguono gli errori senza richiedere nulla ad Amazon.
• Stati chiari: in corso, terminata, parziale, in errore, nulla da fare. Avanzamento, durata e origine – manuale, pianificata, automatica, riesecuzione.
• Nove attività pianificate installate: ordini, flusso di lavoro, tracciabilità, giacenze, inventario Amazon, offerte, rendiconti, resi, manutenzione.
• Uno script a riga di comando avvia le stesse elaborazioni per uno scheduler esterno o per un recupero.
• Un registro delle chiamate conserva l'operazione, il codice HTTP, la durata e un estratto della richiesta e della risposta.

Sicurezza e dati personali

• Le tre credenziali Amazon sono memorizzate cifrate e non vengono mai più mostrate in chiaro.
• Esse non compaiono mai nel registro: la chiamata che scambia il token ne registra soltanto la natura. Il registro può essere aperto a un supporto tecnico.
• Una credenziale lasciata vuota durante una modifica conserva il valore registrato; ogni modifica invalida il token in cache.
• I dati degli acquirenti vengono cancellati automaticamente dopo un termine che stabilite voi, come Amazon richiede. Gli importi e i documenti contabili sono conservati.
• Sette permessi separati: consultare, creare, eliminare, sincronizzare, eseguire il flusso di lavoro, consultare il registro, configurare.
• La modalità di simulazione genera localmente ordini, offerte, inventario, movimenti finanziari e resi a partire dai vostri prodotti: nulla esce dal server e il risultato è riproducibile.

Informazioni tecniche

• Compatibile con Dolibarr 16 e successivi (testato su 23.x), PHP da 7.4 a 8.4, MySQL/MariaDB, multi-società.
• Moduli richiesti: Prodotti, Ordini, Fatture, Terzi. Magazzino, Spedizioni, Banche e Progetti vengono utilizzati se attivi.
• Installazione tramite il caricamento di moduli standard, nessuna modifica al core di Dolibarr.
• 13 tabelle dedicate, client SP-API completo con paginazione, ripresa in caso di limitazione di frequenza, flussi e report compressi.
• 5 lingue: francese, inglese, spagnolo, tedesco, italiano. Documentazione PDF inclusa, supporto NextGestion.

Demo del modulo Amazon Connector
Login : demo
Password : demo