Genera un preventivo o una fattura da Twenty

Invia automaticamente i dati dell’opportunità al tuo sistema di fatturazione (Stripe, QuickBooks, Xero, ecc.) quando un’opportunità è chiusa come vinta.

Struttura del flusso di lavoro

Trigger: Il Record è Aggiornato (Opportunità)
Filtro: Fase = Closed Won
Search Record: Recupera i dettagli dell’azienda
Code (opzionale): Formatta il payload
HTTP Request: Invia al sistema di fatturazione

Passaggio 1: Configura il trigger

Crea un nuovo flusso di lavoro
Seleziona il trigger Record is Updated
Scegli Opportunity come oggetto

Passaggio 2: Filtra per Closed Won

Aggiungi un’azione Filtro per proseguire solo quando l’opportunità è chiusa come vinta:

Impostazione	Valore
Campo	Fase
Condizione	Uguale a
Valore	`CLOSED_WON` (o il nome della tua fase)

Il trigger si attiva a ogni aggiornamento di un’Opportunità. Il filtro garantisce che il flusso di lavoro prosegua solo quando la fase cambia in Closed Won.

Passaggio 3: Ottieni i dettagli dell’azienda

Il record Opportunity potrebbe non includere tutti i campi dell’azienda necessari per la fattura. Aggiungi un’azione Search Record:

Impostazione	Valore
Oggetto	Azienda
Corrispondenza per	ID uguale a `{{trigger.object.companyId}}`

Questo recupera il record completo dell’azienda con indirizzo di fatturazione, partita IVA, ecc.

Passaggio 4: Formatta il payload (opzionale)

Se il tuo sistema di fatturazione richiede un formato specifico, aggiungi un’azione Code:

export const main = async (params: {
  opportunity: any;
  company: any;
}): Promise<object> => {
  const { opportunity, company } = params;

  return {
    invoice: {
      // Customer info from Company
      customer_name: company.name,
      customer_email: company.email || "",
      billing_address: {
        line1: company.address?.street || "",
        city: company.address?.city || "",
        postal_code: company.address?.postalCode || "",
        country: company.address?.country || ""
      },
      tax_id: company.taxId || null,

      // Invoice details from Opportunity
      amount: opportunity.amount,
      currency: opportunity.currency || "USD",
      description: `Invoice for ${opportunity.name}`,
      due_days: 30,

      // Reference back to Twenty
      metadata: {
        opportunity_id: opportunity.id,
        company_id: company.id
      }
    }
  };
};

Passaggio 5: Invia al sistema di fatturazione

Aggiungi un’azione HTTP Request:

Impostazione	Valore
Metodo	POST
URL	L’endpoint API del tuo sistema di fatturazione
Intestazioni	`Authorization: Bearer YOUR_API_KEY`
Corpo	`{{code.invoice}}` o mappa direttamente i campi

Esempio: Fattura Stripe

POST https://api.stripe.com/v1/invoices
Headers:
  Authorization: Bearer sk_live_xxx
  Content-Type: application/x-www-form-urlencoded

Body:
  customer: {{company.stripeCustomerId}}
  collection_method: send_invoice
  days_until_due: 30

Esempio: Fattura QuickBooks

POST https://quickbooks.api.intuit.com/v3/company/{realmId}/invoice
Headers:
  Authorization: Bearer YOUR_ACCESS_TOKEN
  Content-Type: application/json

Body: {{code.invoice}}

Riepilogo completo del flusso di lavoro

Passaggio	Azione	Scopo
1	Trigger: Record Updated	Si attiva a ogni modifica di un’Opportunità
2	Filtro	Procedi solo se Fase = Closed Won
3	Search Record	Ottieni tutti i dettagli dell’azienda per la fatturazione
4	Codice	Formatta i dati per l’API di fatturazione
5	Richiesta HTTP	Crea la fattura in un sistema esterno

Suggerimenti

Memorizza gli ID esterni: Salva l’ID della fattura restituito dall’API nell’Opportunity utilizzando un’azione Update Record
Gestione degli errori: Aggiungi un ramo per inviare una notifica se la richiesta HTTP non riesce
Prima prova: Usa la modalità sandbox/test del tuo sistema di fatturazione prima di andare in produzione

Correlati

Generare un PDF da Twenty — allegare i PDF generati ai record
Trigger dei flussi di lavoro
Azioni dei flussi di lavoro
Automazioni Closed Won

Panoramica

Modello dati

Migrazione dei dati

Calendario & Email

Flussi di Lavoro

AI

Disposizione

Cruscotti

Autorizzazioni & Accesso

Fatturazione

Impostazioni

Legale

Genera un preventivo o una fattura da Twenty

Struttura del flusso di lavoro

Passaggio 1: Configura il trigger

Passaggio 2: Filtra per Closed Won

Passaggio 3: Ottieni i dettagli dell’azienda

Passaggio 4: Formatta il payload (opzionale)

Passaggio 5: Invia al sistema di fatturazione

Esempio: Fattura Stripe

Esempio: Fattura QuickBooks

Riepilogo completo del flusso di lavoro

Suggerimenti

Correlati

​Struttura del flusso di lavoro

​Passaggio 1: Configura il trigger

​Passaggio 2: Filtra per Closed Won

​Passaggio 3: Ottieni i dettagli dell’azienda

​Passaggio 4: Formatta il payload (opzionale)

​Passaggio 5: Invia al sistema di fatturazione

​Esempio: Fattura Stripe

​Esempio: Fattura QuickBooks

​Riepilogo completo del flusso di lavoro

​Suggerimenti

​Correlati

Struttura del flusso di lavoro

Passaggio 1: Configura il trigger

Passaggio 2: Filtra per Closed Won

Passaggio 3: Ottieni i dettagli dell’azienda

Passaggio 4: Formatta il payload (opzionale)

Passaggio 5: Invia al sistema di fatturazione

Esempio: Fattura Stripe

Esempio: Fattura QuickBooks

Riepilogo completo del flusso di lavoro

Suggerimenti

Correlati