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

فهرست فاکتورها

فاکتورهایم را چطور بخوانم؟

۱ دقیقه مطالعهبه‌روزرسانی ۲۴ آبان ۱۴۰۵
پاسخ کوتاه

dorna_invoices فاکتورهایتان را از جدیدترین فهرست می‌کند. با invoiceId یک فاکتور را با ردیف‌هایش می‌خوانید.

  • dorna_invoices
  • فقط خواندنی
فهرست مطالب
  1. پارامترها
  2. خروجی
  3. مثال
  4. دسترسی و تأیید

پارامترها

فیلدنوعتوضیح
invoiceIdرشته (شناسه)همین یک فاکتور را با ردیف‌هایش برمی‌گرداند.
campaignIdرشته (شناسه)فقط فاکتورهای این کمپین.
projectIdرشته (شناسه)فقط فاکتورهای این پروژه.
fromرشتهآغاز بازه‌ی تاریخ، به شکل YYYY-MM-DD.
toرشتهپایان بازه‌ی تاریخ، به شکل YYYY-MM-DD.
limitعدد صحیح، 1 تا 50تعداد ردیف‌های برگشتی، از جدیدترین.

خروجی

بدون invoiceId: شماره، نوع، تاریخ صدور، کمپین مربوط، جمع جزء، تخفیف، مالیات و مبلغ نهایی، دونات خریداری‌شده و جمع پرداخت‌شده و پرداخت‌نشده؛ قابل فیلتر با کمپین، پروژه و بازه‌ی تاریخ. با invoiceId: ردیف‌ها، افزونه‌ها و بسته‌های دونات. مبلغ‌ها به ریال‌اند (۱۰ ریال = ۱ تومان).

مثال

از دستیار بخواهید: فاکتورهای خرداد را با کمپین‌هایم تطبیق بده.

دستیار ابزار را این‌طور صدا می‌زند:

{
  "name": "dorna_invoices",
  "arguments": {
    "invoiceId": "64f1a2b3c4d5e6f7a8b9c0d1",
    "campaignId": "64f1a2b3c4d5e6f7a8b9c0d1"
  }
}

نتیجه چیزی شبیه این است (مقدارها نمونه‌اند):

{
  "total": 3,
  "paid": {
    "count": 1,
    "amountRials": 11880000
  },
  "unpaid": {
    "count": 1,
    "amountRials": 11880000
  },
  "invoices": [
    {
      "id": "64f1a2b3c4d5e6f7a8b9c0d1",
      "number": "INV-1405-0042",
      "kind": "purchase",
      "campaignId": "64f1a2b3c4d5e6f7a8b9c0d1",
      "issuedAt": "2026-11-01T09:30:00.000Z",
      "subtotalRials": 12000000,
      "discountRials": 1200000,
      "vatRials": 1080000,
      "totalRials": 11880000,
      "donuts": 40
    }
  ]
}

دسترسی و تأیید

فقط خواندنی: این ابزار هیچ چیزی را در حساب شما تغییر نمی‌دهد.

ابزارهای مرتبط: dorna_list_transactions dorna_campaigns

هنوز سؤالی دارید؟

این راهنما را در دستیار هوش مصنوعی خودتان باز کنید و سؤالتان را بپرسید.

ChatGPTClaudeGemini
این راهنما مفید بود؟