Deal-Daten automatisch an Ihr Rechnungsstellungssystem senden (Stripe, QuickBooks, Xero usw.) wenn eine Opportunity gewonnen wird.
Workflow-Struktur
- Auslöser: Datensatz wird aktualisiert (Opportunity)
- Filter: Phase = Closed Won
- Datensatz suchen: Unternehmensdetails abrufen
- Code (optional): Nutzlast formatieren
- HTTP-Anfrage: An Rechnungsstellungssystem senden
Schritt 1: Auslöser einrichten
- Erstellen Sie einen neuen Workflow
- Wählen Sie den Auslöser Datensatz wird aktualisiert aus
- 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:
| Einstellung | Wert |
|---|
| Feld | Phase |
| Bedingung | Gleich |
| Wert | CLOSED_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:
| Einstellung | Wert |
|---|
| Objekt | Unternehmen |
| Abgleichen anhand | ID entspricht {{trigger.object.companyId}} |
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:
| Einstellung | Wert |
|---|
| Methode | POST |
| URL | Ihr API-Endpunkt für die Rechnungsstellung |
| Header | Authorization: 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
| Schritt | Aktion | Zweck |
|---|
| 1 | Auslöser: Datensatz aktualisiert | Wird ausgelöst, wenn sich eine beliebige Opportunity ändert |
| 2 | Filter | Nur fortfahren, wenn Phase = Closed Won |
| 3 | Datensatz suchen | Vollständige Unternehmensdetails für die Rechnungsstellung abrufen |
| 4 | Code | Daten für die Rechnungsstellungs-API formatieren |
| 5 | HTTP-Anfrage | Rechnung 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
