Webhook WooCommerce e Sellsy

A cosa servono i webhook?

I webhook consentono a Order Invoicer di essere notificato immediatamente quando si verifica un evento (nuovo ordine, aggiornamento di un prodotto, fattura pagata in Sellsy, ecc.). Integrano le sincronizzazioni periodiche (attività pianificate) già in atto.

Senza webhook funzionanti, alcune azioni potrebbero richiedere più tempo per essere prese in carico.

---

WooCommerce

Cosa viene configurato per lei

Quando salva la connessione al suo negozio (URL + chiavi API WooCommerce), Order Invoicer crea o aggiorna automaticamente i webhook necessari sul suo sito.

Vengono utilizzati i seguenti topic:

• Ordini: creazione, aggiornamento, eliminazione
• Prodotti: creazione, aggiornamento, eliminazione

Ogni webhook punta a un URL di consegna gestito da Order Invoicer (un gateway sicuro). Non deve copiarlo manualmente.

Altri plugin o strumenti

Se dispone già di webhook WooCommerce per lo stesso topic ma che puntano a un altro URL (un altro strumento, Zapier, ecc.), Order Invoicer non li elimina. Solo i webhook di Order Invoicer (con lo stesso URL di consegna del nostro) vengono riparati o deduplicati durante i controlli automatici.

Verificare che sia tutto a posto

1. In Order Invoicer, apra il suo connettore
2. Vada su Impostazioni (o Configurazione)
3. La scheda del suo negozio (e-commerce)
4. Esamini la sezione Webhook: ogni topic dovrebbe trovarsi nello stato OK

Lì vedrà anche i topic mancanti, inattivi o con un URL errato (un'altra integrazione sullo stesso topic).

WooCommerce: registro di consegna vuoto

In WooCommerce, la schermata Webhook → Registro di consegna (o equivalente) mostra una voce solo dopo che un evento è stato inviato. Se ha appena installato i webhook e nessun ordine o prodotto è cambiato, il registro potrebbe rimanere vuoto: questo è normale.

Per testare: crei o aggiorni un ordine / un prodotto, quindi controlli di nuovo.

Risoluzione dei problemi WooCommerce

• Permalink di WordPress: utilizzi una struttura diversa da "Semplice" se la REST API o i webhook non funzionano.
• Plugin di sicurezza / firewall: potrebbero bloccare le chiamate in entrata; aggiunga un'eccezione se necessario.
• L'URL del negozio in Order Invoicer: deve corrispondere al negozio (inclusa una sottocartella https://site.com/boutique se è questa la sua configurazione). Una discrepanza http / https viene di solito gestita, ma l'URL salvato deve restare quello corretto.
• In caso di dubbio, la sezione Webhook nella pagina del connettore riassume lo stato reale lato API.

---

Sellsy

Cosa viene configurato per lei

Quando collega Sellsy (OAuth) su un connettore, Order Invoicer registra un webhook sul suo account Sellsy: una singola voce per account, che punta alla stessa infrastruttura sicura utilizzata per WooCommerce.

I tipi di evento (fattura, preventivo, articolo, pagamento, ecc.) seguono la configurazione prevista da Order Invoicer. Non deve spuntare manualmente ogni casella in Sellsy se segue il nostro flusso di installazione.

Verificare che sia tutto a posto

1. Apra il connettore
2. Impostazioni / Configurazione
3. La scheda Fatturazione (Sellsy)
4. La sezione Webhook: può verificare se il webhook è presente, attivo e se ogni evento richiesto è conforme.

Errori lato Sellsy

Se gli eventi non vengono più inviati o se l'applicazione segnala un problema di autenticazione sul webhook:

• Ricolleghi Sellsy (OAuth) da Order Invoicer per rinnovare i token di accesso.
• Si assicuri che l'utente connesso disponga dei diritti appropriati in Sellsy (si consiglia un amministratore).

---

Ha bisogno di aiuto?

Per un connettore WooCommerce + Sellsy, consulti anche la documentazione generale.
Contatto: contact@orderinvoicer.com.