Saltar al contenido principal
Envía automáticamente los datos de la oportunidad a tu sistema de facturación (Stripe, QuickBooks, Xero, etc.) cuando se gana una oportunidad.

​
Estructura del flujo de trabajo

  1. Disparador: Se actualiza un registro (Oportunidad)
  2. Filtro: Etapa = Cerrado ganado
  3. Search Record: Obtener detalles de la empresa
  4. Code (opcional): Formatear la carga útil
  5. HTTP Request: Enviar al sistema de facturación

​
Paso 1: Configurar el disparador

  1. Crear un nuevo flujo de trabajo
  2. Selecciona el disparador Record is Updated
  3. Elige Opportunity como objeto

​
Paso 2: Filtrar por Cerrado ganado

Añade una acción Filter para continuar solo cuando la oportunidad esté ganada:
ConfiguraciónValor
CampoEtapa
CondiciónIgual a
ValorCLOSED_WON (o el nombre de tu etapa)
El disparador se activa con cualquier actualización de una Oportunidad. El filtro garantiza que el flujo de trabajo solo continúe cuando la etapa cambie a Cerrado ganado.

​
Paso 3: Obtener detalles de la empresa

Es posible que el registro de Oportunidad no incluya todos los campos de Empresa que necesitas para la factura. Añade una acción Search Record:
ConfiguraciónValor
ObjetoEmpresa
Coincidir porID igual a {{trigger.object.companyId}}
Esto recupera el registro completo de Empresa con dirección de facturación, ID fiscal, etc.

​
Paso 4: Formatear la carga útil (opcional)

Si tu sistema de facturación exige un formato específico, añade una acción 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
      }
    }
  };
};

​
Paso 5: Enviar al sistema de facturación

Añade una acción HTTP Request:
ConfiguraciónValor
MétodoPOST
URLTu endpoint de API de facturación
EncabezadosAuthorization: Bearer YOUR_API_KEY
Cuerpo{{code.invoice}} o asigna los campos directamente

​
Ejemplo: Factura de 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

​
Ejemplo: Factura de QuickBooks

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

Body: {{code.invoice}}

​
Resumen completo del flujo de trabajo

PasoAcciónPropósito
1Disparador: Registro actualizadoSe activa cuando cambia cualquier Oportunidad
2FiltroProcede solo si la etapa = Cerrado ganado
3Search RecordObtener todos los detalles de Empresa para la facturación
4CódigoDar formato a los datos para la API de facturación
5Solicitud HTTPCrear la factura en el sistema externo

​
Consejos

  • Almacenar IDs externos: Guarda el ID de la factura devuelto por la API en la Oportunidad usando una acción Update Record
  • Gestión de errores: Añade una rama para enviar una notificación si la solicitud HTTP falla
  • Prueba primero: Utiliza el modo sandbox/pruebas de tu sistema de facturación antes de pasar a producción

​
Relacionado