Collegare l'API di Temu a Odoo: cosa si richiede, cosa si legge e cosa si scrive

«Temu ha un'API?» Sì. La domanda utile è un'altra: cosa bisogna richiedere per usarla, cosa si può leggere, cosa si può scrivere e cosa succede quando risponde di no. Queste quattro risposte decidono se l'integrazione regge un picco di ordini o cade il primo venerdì di saldi. Andiamo con ordine.

Le credenziali non sono un utente e una password

Temu funziona come qualsiasi marketplace serio: c'è un'applicazione registrata, con la sua chiave e il suo segreto, e c'è un'autorizzazione che il negozio concede a quell'applicazione. Ne esce un token che scade, e l'integrazione deve sapere quando e avvisare con margine per rinnovare l'autorizzazione prima che scada. In Odoo questo significa che il token vive in un parametro di sistema con permessi, non in un campo di testo che qualcuno ha incollato una volta e che nessuno ricorda. E significa che il giorno in cui il negozio revoca l'autorizzazione, la sincronizzazione deve fermarsi e avvisare, non continuare a fallire in silenzio per una settimana.

Quali famiglie di endpoint servono davvero

I nomi esatti cambiano tra le versioni dell'API; le famiglie no, e sono cinque. Elenco degli ordini per finestra temporale, per recuperare il nuovo senza chiedere tutto lo storico. Dettaglio dell'ordine, dove arrivano righe, variante, importi e imposte. Conferma di spedizione, con vettore e numero di tracciamento, che è l'unica cosa che Temu guarda per darti per adempiuto. Catalogo, per pubblicare e aggiornare le schede. E giacenze, a parte dal catalogo perché cambiano mille volte di più. Se un'integrazione copre solo le prime due, non è un'integrazione: è un importatore.

Il dettaglio di ogni famiglia è sviluppato nei due articoli collegati: importare gli ordini senza perdere dati e sincronizzare prodotti e prezzi.

La giacenza è la chiamata che si ripete di più

Un negozio con 2.000 riferimenti che reinvia tutta la giacenza ogni quindici minuti fa 192.000 scritture al giorno per cambiare, con un po' di fortuna, duecento valori. Questo non è sincronizzare: è consumare quota. La cosa giusta è inviare solo ciò che è cambiato dall'ultimo invio, raggruppato in lotti, e lanciare in più un aggiornamento immediato quando una vendita porta un riferimento vicino allo zero. La frequenza alta non evita la vendita in eccesso; il margine di sicurezza sì.

Limiti: l'API non è un database da interrogare a piacere

Ogni API di marketplace ha un tetto di chiamate per finestra di tempo, e prima o poi lo raggiungi. Ciò che separa un'integrazione sana da una rotta è cosa fa quando lo raggiunge. Un rifiuto per eccesso di chiamate non è un errore da ignorare e dimenticare: è un ordine di attendere. L'integrazione deve riprovare con attesa crescente, mettere in coda ciò che non è entrato e riprenderlo nel ciclo successivo senza duplicare nulla. Tutto questo vive in una coda di lavori, non in un ciclo dentro il cron. Quando quella coda si blocca, il sintomo è quello che raccontiamo in code bloccate in Odoo.

Registrare ogni chiamata non è paranoia: è l'unica prova

Quando un ordine non compare, o Temu dice di non aver ricevuto il numero di tracciamento, la discussione si vince con il registro o non si vince. Per ogni chiamata bisogna salvare: il momento esatto, l'endpoint, il corpo inviato, il codice e la risposta ricevuta, e l'identificativo dell'ordine o del riferimento interessato. Senza segreti né token in chiaro, e con una scadenza ragionevole perché la tabella non si mangi il disco. È la prima cosa che guardiamo quando verifichiamo un connettore fatto da altri, e la sua assenza è la causa della metà dei casi impossibili da diagnosticare, come quelli che descriviamo in errori frequenti con un'API di marketplace.

Cosa fa il nostro connettore (e cosa no)

Il connettore Temu per Odoo copre le cinque famiglie: importa gli ordini per finestra temporale, conferma le spedizioni con vettore e numero di tracciamento, pubblica prodotti e SKU e invia la giacenza per SKU, raggruppata per articolo. Il negozio si autorizza con il codice che emette Temu, e il connettore salva quando scade il token e mostra se la connessione è ancora attiva. Sincronizza tramite cron e webhook, salva la richiesta e la risposta di ogni conferma di spedizione e il contenuto di ogni webhook ricevuto, e se Temu porta un metodo a una versione nuova, ripete la chiamata con la versione nuova.

Quello che oggi non fa, detto chiaramente: non invia solo la giacenza cambiata, perché a ogni passata manda quella di tutti i riferimenti collegati; non ha una coda di lavori con attesa crescente e non registra tutte le chiamate. Un rifiuto per limite resta nel log del server e viene ritentato alla passata successiva del cron. Funziona su Odoo 17, 18 e 19. Se stai decidendo tra questo e un middleware sopra, il confronto è in middleware o connettore nativo: ci sono casi in cui la risposta giusta non siamo noi.

Domande frequenti

Link utili dentro FlexigoTech

Cosa facciamo su questo