Contabilità

Panoramica

Canali e integrazioni → Contabilità (/it/integrations/accounting) collega il tuo sistema contabile, così gli ordini pagati diventano fatture.

• Xero e QuickBooks Online — accedi con il tuo account Xero o Intuit. OrderInChat crea contatti e fatture tramite le API ufficiali di Xero e QuickBooks.
• Zoho Books — si collega tramite Zoho MCP. Copia il tuo Server URL da Zoho MCP (il tuo server → Connect). OrderInChat non ospita questo URL.

Se una scheda indica che il provider non è ancora configurato su OrderInChat, il team OrderInChat non lo ha ancora attivato per la piattaforma. Contatta il supporto.

Collegamento

1. Apri Canali e integrazioni → Contabilità.
2. Per Xero o QuickBooks, fai clic su Collegati con OAuth, accedi e approva l'accesso. Se approvi più di un'organizzazione Xero, scegli quella che riceve le fatture in Organizzazione Xero.
3. Per Zoho Books, apri Zoho MCP, scegli il tuo server, apri Connect e copia il Server URL. È unico per quel server e ha la forma https://….zohomcp.com/mcp/…/message. Altri data center usano mcp.zoho.eu, mcp.zoho.in, mcp.zoho.com.au o mcp.zoho.jp. Incolla l'URL, salvalo, poi fai clic su Collegati con OAuth. Tratta l'URL come una password.
4. Imposta le opzioni della fattura e fai clic su Salva impostazioni fattura:
   • Xero: stato della fattura (Bozza o Approvata) e il codice conto vendite — il codice del piano dei conti su ogni riga della fattura (spesso 200). Deve già esistere in quell'organizzazione Xero. Se lo lasci vuoto, OrderInChat invia 200.
   • QuickBooks: Prodotto/servizio per le righe della fattura — ogni riga usa questo prodotto o servizio. Lascia vuoto per usare "Sales"; se non esiste, OrderInChat lo crea come servizio sul tuo conto ricavi. QuickBooks Online non ha fatture in bozza.
   • Zoho Books: stato della fattura e ID organizzazione (Zoho Books → Settings → Organization Profile).
5. Attiva Attivo e, se vuoi, Crea fattura quando l'ordine è pagato.
6. Fai clic su Test. Per Xero e QuickBooks il messaggio mostra il nome dell'organizzazione o dell'azienda collegata.

Usa Disconnetti per rimuovere il collegamento. Per Xero e QuickBooks questo revoca anche l'accesso di OrderInChat nel tuo sistema contabile.

Sincronizzazione degli ordini pagati

Con la sincronizzazione automatica attiva, ogni ordine pagato crea una sola fattura nel tuo sistema contabile:

• Cliente: abbinato per e-mail, poi per nome; creato se non c'è corrispondenza.
• Righe: prodotti, spedizione, imposte e sconti sono righe separate, così il totale della fattura è uguale al totale dell'ordine. Non viene aggiunta alcuna imposta extra. In QuickBooks gli sconti compaiono come un'unica riga di sconto.
• Riferimento: in Xero il riferimento della fattura è il numero d'ordine. In QuickBooks il numero d'ordine diventa il numero della fattura quando i numeri di transazione personalizzati sono attivi, ed è sempre nella nota della fattura.
• Mai due volte: un ordine non riceve mai una seconda fattura. Un nuovo tentativo trova la fattura esistente e la riutilizza.
• Valuta: la valuta dell'ordine deve essere quella dell'organizzazione, oppure la multivaluta deve essere attiva nel tuo sistema contabile.
• Quando si attiva: i pagamenti con carta e i pagamenti che confermi tu sull'ordine (bonifico, contanti) creano entrambi la fattura. La sincronizzazione automatica si attiva al primo collegamento; disattivala per non creare nuove fatture.
• Zoho Books: sul tuo server Zoho MCP abilita list_contacts, create_contact, create_invoice, list_invoices (necessario perché un ordine non venga mai fatturato due volte) e mark_invoice_sent, più list_currencies per gli ordini in altre valute. Un cliente già fatturato in un'altra valuta riceve un secondo contatto chiamato "Nome (EUR)".
• QuickBooks Online è disponibile: le aziende QuickBooks reali possono collegarsi. Solo se la scheda QuickBooks mostra un badge Sandbox la piattaforma è nell'ambiente di prova di Intuit, dove possono collegarsi solo le aziende sandbox di Intuit.
• Collegamento sempre attivo: OrderInChat rinnova il collegamento almeno ogni 20 giorni, così non scade anche senza ordini. Se QuickBooks o Xero non accetta più l'autorizzazione (scaduta o revocata), la scheda mostra Riconnessione necessaria e il pulsante diventa Ricollega; ricollegandoti l'avviso sparisce. Un'interruzione temporanea del fornitore non chiede di ricollegarti: rinnovo e fattura vengono ritentati in automatico.

I problemi compaiono in Lavori di sincronizzazione fatture con il messaggio del sistema contabile (ad esempio un codice conto sconosciuto). Correggi la causa, poi fai clic su Riprova. Il nuovo tentativo parte subito e mostra il risultato; ogni attività rimanda al suo ordine.