Přejít na hlavní obsah
Automaticky odesílejte data o obchodních případech do vašeho fakturačního systému (Stripe, QuickBooks, Xero atd.). když je příležitost vyhrána.

​
Struktura pracovního postupu

  1. Spouštěč: Záznam je aktualizován (Příležitost)
  2. Filtr: Stav = Uzavřeno – vyhráno
  3. Vyhledat záznam: Získat podrobnosti o společnosti
  4. Kód (volitelné): Formátovat payload
  5. Požadavek HTTP: Odeslat do fakturačního systému

​
Krok 1: Nastavení spouštěče

  1. Vytvořte nový pracovní postup
  2. Vyberte spouštěč Záznam je aktualizován
  3. Vyberte jako objekt Příležitost

​
Krok 2: Filtrování na Uzavřeno – vyhráno

Přidejte akci Filtr, aby se pokračovalo pouze tehdy, když je obchodní případ vyhraný:
NastaveníHodnota
PoleFáze
PodmínkaRovná se
HodnotaCLOSED_WON (nebo název vašeho stavu)
Spouštěč se vyvolá při jakékoli aktualizaci Příležitosti. Filtr zajistí, že pracovní postup bude pokračovat pouze tehdy, když se stav změní na Uzavřeno – vyhráno.

​
Krok 3: Získat podrobnosti o společnosti

Záznam Příležitosti nemusí obsahovat všechna pole Společnosti, která potřebujete pro fakturu. Přidejte akci Vyhledat záznam:
NastaveníHodnota
ObjektSpolečnost
Shoda podleID se rovná {{trigger.object.companyId}}
Tímto získáte úplný záznam Společnosti s fakturační adresou, daňovým ID atd.

​
Krok 4: Formátování payloadu (volitelné)

Pokud váš fakturační systém očekává specifický formát, přidejte akci Kód: 
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
      }
    }
  };
};

​
Krok 5: Odeslání do fakturačního systému

Přidejte akci Požadavek HTTP:
NastaveníHodnota
MetodaPOST
URLKoncový bod API vašeho fakturačního systému
ZáhlavíAuthorization: Bearer YOUR_API_KEY
Tělo{{code.invoice}} nebo namapujte pole přímo

​
Příklad: Faktura ve 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

​
Příklad: Faktura v QuickBooks

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

Body: {{code.invoice}}

​
Shrnutí kompletního pracovního postupu

KrokAkceÚčel
1Spouštěč: Záznam aktualizovánSpustí se při jakékoli změně Příležitosti
2FiltrPokračujte pouze pokud Stav = Uzavřeno – vyhráno
3Vyhledat záznamZískejte úplné podrobnosti o Společnosti pro fakturaci
4KódNaformátujte data pro fakturační API
5HTTP požadavekVytvořte fakturu v externím systému

​
Tipy

  • Ukládejte externí ID: Uložte ID faktury vrácené API zpět do Příležitosti pomocí akce Aktualizovat záznam
  • Zpracování chyb: Přidejte větev pro odeslání upozornění, pokud požadavek HTTP selže
  • Nejprve testujte: Použijte sandbox/test režim vašeho fakturačního systému před ostrým spuštěním

​
Související