همگام‌سازی خودکار محصولات Pipedrive با Stripe

همگام‌سازی خودکار محصولات Pipedrive با Stripe

این Workflow محصولات جدید اضافه شده در Pipedrive را با Stripe همگام‌سازی می‌کند و رکوردهای محصول و قیمت مربوطه را به طور خودکار در حساب Stripe شما ایجاد می‌کند. این امر تضمین می‌کند که کاتالوگ Stripe شما با لیست محصولات Pipedrive به‌روز می‌ماند و ورود دستی داده‌ها و خطاهای احتمالی را حذف می‌کند.

دسته‌بندی‌ها: فروش، مدیریت محصول

Axeto.ai n8n Catalog: https://axeto.ai/n8n

---

نمای کلی Workflow

این Workflow برای انجام کارهای زیر طراحی شده است:

1. تشخیص محصولات جدید Pipedrive: با اضافه شدن یک محصول جدید در Pipedrive، Workflow فعال می‌شود.

2. آماده‌سازی داده‌های محصول: جزئیات مربوط به محصول را از Pipedrive استخراج و قالب‌بندی می‌کند.

3. ایجاد محصول در Stripe: یک ورودی محصول جدید در Stripe با استفاده از داده‌های Pipedrive ایجاد می‌کند.

4. پیوند دادن شناسه محصول Stripe: شناسه محصول Stripe تازه ایجاد شده را با داده‌های محصول اصلی Pipedrive مرتبط می‌کند.

5. پردازش قیمت‌های محصول: اطلاعات قیمت‌گذاری مرتبط با محصول Pipedrive را جدا می‌کند.

6. ایجاد قیمت‌ها در Stripe: ورودی‌های قیمت جداگانه در Stripe برای هر نقطه قیمتی محصول، که به محصول Stripe پیوند داده شده است، ایجاد می‌کند.

---

تشریح گره به گره

۱. فعال‌ساز: هنگام ایجاد محصول (Pipedrive)

• هدف: هر زمان که محصول جدیدی در Pipedrive اضافه شود، Workflow را آغاز می‌کند.
• نوع گره: Pipedrive Trigger
• پیکربندی:

* Action: added

* Object: product

• اعتبارنامه‌ها: نیاز به اعتبارنامه معتبر API Pipedrive دارد.
• خروجی: داده‌های محصول Pipedrive تازه ایجاد شده را منتشر می‌کند.

۲. آماده‌سازی داده‌های محصول (Function Item)

• هدف: شیء current را از payload فعال‌ساز Pipedrive استخراج و مسطح می‌کند و دسترسی به جزئیات محصول را آسان‌تر می‌سازد.
• نوع گره: Function Item
• کد:

```javascript

item = item.current;

return item;

```

• ورودی: داده‌های محصول Pipedrive را از فعال‌ساز دریافت می‌کند.
• خروجی: یک شیء JSON واحد حاوی جزئیات اصلی محصول Pipedrive (مانند name, description, prices).

۳. ایجاد محصول در Stripe (HTTP Request)

• هدف: درخواستی را به API Stripe ارسال می‌کند تا محصول جدیدی ایجاد شود.
• نوع گره: HTTP Request
• پیکربندی:

* HTTP Method: POST

* URL: https://api.stripe.com/v1/products

* Authentication: کلید API Stripe (از طریق اعتبارنامه‌ها پیکربندی شده است).

* Query Parameters:

* name: از فیلد name محصول Pipedrive نگاشت شده است ({{$json["name"]}}).

* description: از فیلد description محصول Pipedrive نگاشت شده است. در صورت عدم وجود توضیحات، از یک فضای خالی به عنوان مقدار پیش‌فرض استفاده می‌کند ({{$json["description"] || ' '}}).

• اعتبارنامه‌ها: نیاز به اعتبارنامه معتبر API Stripe دارد.
• ورودی: داده‌های محصول Pipedrive آماده شده از گره قبلی.
• خروجی: پاسخ از Stripe، شامل شناسه محصول تازه ایجاد شده.

۴. استخراج شناسه محصول Stripe (Set)

• هدف: شناسه منحصر به فرد محصولی که به تازگی در Stripe ایجاد شده است را جدا و ذخیره می‌کند.
• نوع گره: Set
• پیکربندی:

* Set Field:

* Name: StripeCreatedProductId

* Value: Expression: {{$json["id"]}} (شناسه id را از پاسخ API Stripe استخراج می‌کند).

* Options: Keep Only Set را فعال کنید تا تمام داده‌های دیگر از پاسخ Stripe حذف شوند و فقط شناسه محصول باقی بماند.

• ورودی: پاسخ API Stripe از گره "ایجاد محصول در Stripe".
• خروجی: شیء حاوی فقط StripeCreatedProductId.

۵. ادغام داده‌ها (Merge)

• هدف: داده‌های محصول اصلی Pipedrive را با شناسه محصول Stripe تازه به دست آمده ترکیب می‌کند. این تضمین می‌کند که شناسه Stripe برای مراحل بعدی ایجاد قیمت در دسترس باشد.
• نوع گره: Merge
• پیکربندی:

* Mode: mergeByIndex (داده‌های ورودی را بر اساس ترتیب/شاخص آنها ادغام می‌کند).

• ورودی‌ها:

* Main Input: داده‌های محصول Pipedrive آماده شده (از گره ۲).

* Additional Input: شیء حاوی StripeCreatedProductId (از گره ۴).

• خروجی: شیء داده ادغام شده حاوی جزئیات محصول Pipedrive و StripeCreatedProductId.

۶. تفکیک قیمت‌ها (Item Lists)

• هدف: آرایه قیمت‌های مرتبط با محصول Pipedrive را به موارد جداگانه تبدیل می‌کند. این امر ضروری است زیرا هر قیمت باید به طور جداگانه در Stripe ایجاد شود.
• نوع گره: Item Lists
• پیکربندی:

* Field to split out: prices (این فرض می‌کند که داده‌های محصول Pipedrive شما شامل آرایه prices است).

* Include fields: StripeCreatedProductId (این تضمین می‌کند که شناسه محصول Stripe به هر مورد قیمت جداگانه منتقل می‌شود).

• ورودی: شیء داده ادغام شده حاوی جزئیات محصول و شناسه محصول Stripe (از گره ۵).
• خروجی: موارد متعدد، که هر مورد نشان‌دهنده یک قیمت واحد از محصول Pipedrive به همراه StripeCreatedProductId است.

۷. ایجاد رکوردهای قیمت در Stripe (HTTP Request)

• هدف: ورودی‌های قیمت جداگانه در Stripe برای هر نقطه قیمتی محصول ایجاد می‌کند.
• نوع گره: HTTP Request
• پیکربندی:

* HTTP Method: POST

* URL: https://api.stripe.com/v1/prices

* Authentication: کلید API Stripe (از طریق اعتبارنامه‌ها پیکربندی شده است).

* Query Parameters:

* currency: از واحد پول مورد قیمت نگاشت شده است (مانند {{$json["prices"].currency}}).

unit_amount: از قیمت مورد قیمت نگاشت شده است، ضرب در ۱۰۰ برای تبدیل به کوچکترین واحد پول (مانند سنت) ({{$json["prices"].price 100}}).

* product: از StripeCreatedProductId که از گره‌های قبلی منتقل شده است نگاشت شده است ({{$json["StripeCreatedProductId"]}}).

• اعتبارنامه‌ها: نیاز به اعتبارنامه معتبر API Stripe دارد.
• ورودی: هر مورد قیمت جداگانه تولید شده توسط گره "تفکیک قیمت‌ها".
• خروجی: پاسخ API Stripe برای هر ایجاد قیمت.

---

جدول خلاصه

---

ساخت Workflow از ابتدا

1. افزودن فعال‌ساز Pipedrive:

* نام گره: On Product Created

* نوع: Pipedrive Trigger

* پیکربندی: Action را روی added و Object را روی product تنظیم کنید.

* اعتبارنامه‌های Pipedrive را تنظیم کنید.

2. افزودن گره Function Item:

* نام گره: Prepare Product Data

* نوع: Function Item

* اتصال از: On Product Created

* کد:

```javascript

item = item.current;

return item;

```

3. افزودن گره HTTP Request (ایجاد محصول Stripe):

* نام گره: Create Product in Stripe

* نوع: HTTP Request

* اتصال از: Prepare Product Data

* پیکربندی:

* Method: POST

* URL: https://api.stripe.com/v1/products

* Authentication: Stripe API Key (اعتبارنامه‌ها را پیکربندی کنید).

* Query Parameters:

* name: {{$json["name"]}}

* description: {{$json["description"] || ' '}}

4. افزودن گره Set (استخراج شناسه Stripe):

* نام گره: Extract Stripe Product ID

* نوع: Set

* اتصال از: Create Product in Stripe

* پیکربندی:

* یک فیلد اضافه کنید: Name: StripeCreatedProductId, Value: {{$json["id"]}}

* Keep Only Set را فعال کنید.

5. افزودن گره Merge:

* نام گره: Merge Data

* نوع: Merge

* اتصال از:

* Main Input: Prepare Product Data

* Additional Input: Extract Stripe Product ID

* پیکربندی: Mode را روی mergeByIndex تنظیم کنید.

6. افزودن گره Item Lists:

* نام گره: Split Prices

* نوع: Item Lists

* اتصال از: Merge Data

* پیکربندی:

* Field to split out: prices

* Include fields: StripeCreatedProductId

7. افزودن گره HTTP Request (ایجاد قیمت Stripe):

* نام گره: Create Price Records in Stripe

* نوع: HTTP Request

* اتصال از: Split Prices

* پیکربندی:

* Method: POST

* URL: https://api.stripe.com/v1/prices

* Authentication: Stripe API Key (اعتبارنامه‌ها را پیکربندی کنید).

* Query Parameters:

* currency: {{$json["prices"].currency}}

unit_amount: {{$json["prices"].price 100}}

* product: {{$json["StripeCreatedProductId"]}}