پیش‌فاکتور را از سیستم فروش به رستاک بفرستید

وب‌سرویس فاکتور سند فروش سبک رستاک است با اقلام و نوع invoice. مناسب وقتی پیشنهاد در سیستم دیگر قطعی می‌شود و باید در CRM هم سند باشد.

وب‌سرویس توسعه‌دهندگان

وب‌سرویس فاکتورها چه مشکلی را حل می‌کند

شماره سند را خودتان نسازید؛ رستاک خودکار می‌گذارد. بدنه شامل type، title، تاریخ، وضعیت و آرایه items است.

ماشین‌حساب تخفیف بازارچه سند نمی‌سازد؛ این API سند می‌سازد. حسابداری رسمی و دارایی نیست.

فلسفه وجودی

چرا اسناد مالی سبک باید مستقیماً از طریق وب‌سرویس در CRM ثبت شوند؟

بسیاری از کسب‌وکارها برای پیش‌فاکتورهای چابک و توافق‌های سریع فروشگاهی یا فرم‌های سفارش اختصاصی نیازی به نرم‌افزارهای پیچیده حسابداری ندارند. اما عدم ثبت این پیش‌فاکتورها در CRM باعث می‌شود تیم فروش از مبالغ قطعی‌شده مشتری بی‌اطلاع بماند. وب‌سرویس فاکتورهای رستاک اقلام، تعداد، قیمت واحد و شماره سند را به‌طور ساختاریافته در پرونده مشتری بایگانی می‌کند.

سناریوهای واقعی

جریان‌های کاری و سناریوهای محتمل استفاده

چطور کسب‌وکارهای واقعی از وب‌سرویس فاکتورها در عملیات روزمره استفاده می‌کنند؟

1

صدور خودکار پیش‌فاکتور پس از ثبت سفارش در پورتال نمایندگی

سیستم پورتال اقلام سفارش داده شده را با متد POST به /api/v1/invoices می‌فرستد و شماره سند خودکار دریافت می‌کند.

2

تغییر وضعیت فاکتور به "پرداخت‌شده" پس از تایید تراکنش بانکی

درگاه پرداخت یا سیستم مالی پس از دریافت وجه، وضعیت سند را در رستاک به paid تغییر می‌دهد تا کارشناس متوجه تسویه شود.

3

دریافت سوابق پیش‌فاکتورها برای پیگیری تسویه

ربات مالی با متد GET لیست فاکتورهای پرداخت‌نشده با وضعیت draft را خوانده و موعد پیگیری را یادآوری می‌کند.

برای چه کسی است

برنامه‌نویس که بعد از تأیید پیشنهاد باید پیش‌فاکتور در رستاک ثبت شود.

نمونه کاربرد

  • ساخت پیش‌فاکتور از فروشگاه یا فرم سفارش
  • خواندن وضعیت draft برای پیگیری
  • به‌روزرسانی اقلام قبل از ارسال به مشتری

چرا این ابزار

  • اقلام با تعداد و قیمت واحد
  • شماره خودکار
  • جدا از شماره‌گذار اسناد بازارچه
  • CRUD روی همان فاکتور پنل

چطور از وب‌سرویس فاکتورها استفاده کنید

1

کلید و پلن

وب‌سرویس PRO +.

2

POST با items

حداقل یک قلم با description و unit_price.

3

id را نگه دارید

برای PUT بعدی و نمایش در پنل.

محدودیت صادقانه

برای اینکه با ابزار دیگری اشتباه گرفته نشود.

مالیات پیچیده، خزانه و اتصال بانکی ندارد. تاریخ نمونه میلادی است؛ منطق پنل را رعایت کنید.

آدرس و احراز هویت

پایه REST: https://rastakcrm.ir/api/v1 — هدر Authorization: Bearer rstk_…

  • متدها: GET، POST، PUT، DELETE
  • لیست/اصل: https://rastakcrm.ir/api/v1/invoices
  • یک رکورد: https://rastakcrm.ir/api/v1/invoices/{id}
  • پلن PRO +؛ کلید از بخش توسعه‌دهندگان پنل

نمونه بدنه ساخت (JSON)

{
    "type": "invoice",
    "title": "فاکتور خدمات مشاوره",
    "issue_date": "2026-08-16",
    "status": "draft",
    "items": [
        {
            "description": "مشاوره فروش",
            "quantity": 2,
            "unit_price": 1500000
        }
    ]
}

نمونه curl

list

curl -X GET \
  "https://rastakcrm.ir/api/v1/invoices" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json"

create

curl -X POST \
  "https://rastakcrm.ir/api/v1/invoices" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "invoice",
    "title": "فاکتور خدمات مشاوره",
    "issue_date": "2026-08-16",
    "status": "draft",
    "items": [
        {
            "description": "مشاوره فروش",
            "quantity": 2,
            "unit_price": 1500000
        }
    ]
}'

get

curl -X GET \
  "https://rastakcrm.ir/api/v1/invoices/12" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json"

update

curl -X PUT \
  "https://rastakcrm.ir/api/v1/invoices/12" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "invoice",
    "title": "فاکتور خدمات مشاوره",
    "issue_date": "2026-08-16",
    "status": "draft",
    "items": [
        {
            "description": "مشاوره فروش",
            "quantity": 2,
            "unit_price": 1500000
        }
    ]
}'

delete

curl -X DELETE \
  "https://rastakcrm.ir/api/v1/invoices/12" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json"

سوالات متداول درباره وب‌سرویس فاکتورها

فیلد type در نمونه invoice است؛ مقادیر مجاز همان انواع پنل است.

شماره سند خودکار ساخته می‌شود.

منبع جدا؛ ربط را در برنامه خودتان با idها نگه دارید اگر فیلد ارتباط در مدل باشد.

این REST داده JSON است؛ چاپ از پنل است.

PRO +.

کلید را از پنل توسعه‌دهندگان بگیرید

این صفحه مستند عمومی است. ساخت توکن بعد از ورود و پلن PRO + در منوی توسعه‌دهندگان است.

ایجاد حساب