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

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

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

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

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

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

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

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

نمونه کاربرد

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

چرا این ابزار

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

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

1

کلید و پلن

وب‌سرویس حرفه‌ای.

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}
  • پلن حرفه‌ای یا سازمانی؛ کلید از بخش توسعه‌دهندگان پنل

نمونه بدنه ساخت (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 است؛ چاپ از پنل است.

حرفه‌ای یا سازمانی.

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

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

ایجاد حساب