Zum Hauptinhalt springen
Deal-Daten automatisch an Ihr Rechnungsstellungssystem senden (Stripe, QuickBooks, Xero usw.) wenn eine Opportunity gewonnen wird.

​
Workflow-Struktur

  1. Auslöser: Datensatz wird aktualisiert (Opportunity)
  2. Filter: Phase = Closed Won
  3. Datensatz suchen: Unternehmensdetails abrufen
  4. Code (optional): Nutzlast formatieren
  5. HTTP-Anfrage: An Rechnungsstellungssystem senden

​
Schritt 1: Auslöser einrichten

  1. Erstellen Sie einen neuen Workflow
  2. Wählen Sie den Auslöser Datensatz wird aktualisiert aus
  3. Wählen Sie Opportunity als Objekt

​
Schritt 2: Nach Closed Won filtern

Fügen Sie eine Filter-Aktion hinzu, damit nur fortgefahren wird, wenn der Deal gewonnen wurde:
EinstellungWert
FeldPhase
BedingungGleich
WertCLOSED_WON (oder der Name Ihrer Phase)
Der Auslöser wird bei jeder Opportunity-Aktualisierung ausgelöst. Der Filter stellt sicher, dass der Workflow nur fortgesetzt wird, wenn die Phase auf Closed Won geändert wird.

​
Schritt 3: Unternehmensdetails abrufen

Der Opportunity-Datensatz enthält möglicherweise nicht alle Unternehmensfelder, die Sie für die Rechnung benötigen. Fügen Sie eine Datensatz suchen-Aktion hinzu:
EinstellungWert
ObjektUnternehmen
Abgleichen anhandID entspricht {{trigger.object.companyId}}
Dadurch wird der vollständige Unternehmensdatensatz mit Rechnungsadresse, Steuernummer usw. abgerufen.

​
Schritt 4: Nutzlast formatieren (optional)

Wenn Ihr Rechnungsstellungssystem ein bestimmtes Format erwartet, fügen Sie eine Code-Aktion hinzu: 
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
      }
    }
  };
};

​
Schritt 5: An Rechnungsstellungssystem senden

Fügen Sie eine HTTP-Anfrage-Aktion hinzu:
EinstellungWert
MethodePOST
URLIhr API-Endpunkt für die Rechnungsstellung
HeaderAuthorization: Bearer YOUR_API_KEY
Inhalt{{code.invoice}} oder Felder direkt zuordnen

​
Beispiel: Stripe-Rechnung

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

​
Beispiel: QuickBooks-Rechnung

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

Body: {{code.invoice}}

​
Vollständige Workflow-Zusammenfassung

SchrittAktionZweck
1Auslöser: Datensatz aktualisiertWird ausgelöst, wenn sich eine beliebige Opportunity ändert
2FilterNur fortfahren, wenn Phase = Closed Won
3Datensatz suchenVollständige Unternehmensdetails für die Rechnungsstellung abrufen
4CodeDaten für die Rechnungsstellungs-API formatieren
5HTTP-AnfrageRechnung im externen System erstellen

​
Tipps

  • Externe IDs speichern: Speichern Sie die von der API zurückgegebene Rechnungs-ID mithilfe einer Datensatz aktualisieren-Aktion in der Opportunity
  • Fehlerbehandlung: Fügen Sie einen Zweig hinzu, um eine Benachrichtigung zu senden, wenn die HTTP-Anfrage fehlschlägt
  • Zuerst testen: Verwenden Sie den Sandbox-/Testmodus Ihres Rechnungsstellungssystems, bevor Sie live gehen

​
Verwandt