المحاسبة (قريبا) | مطورو AurMap

المحاسبةقريبا

لأنظمة المحاسبة: اقرأ مبيعات كل تاجر يوما بيوم لكل فرع، والاسترجاعات والتحويلات البنكية، بأرقام تطابق ما يصل حساب التاجر.

قريباواجهة الشركاء لم تفتح بعد. هذه الوثائق لتخطط لربطك من الآن، والعناوين والمفاتيح تصدر عند الإطلاق.سجل كمطور ←

نقاط النهاية والصلاحيات

الطلب	الصلاحية
`GET /accounting/daily`	`accounting:read`
`GET /accounting/orders`	`accounting:read`
`GET /accounting/payouts`	`accounting:read`
`GET /accounting/payouts/{payout_id}`	`accounting:read`

لمن هذه الصفحة

لأنظمة المحاسبة والفواتير. يربطك التاجر على مستوى merchant بصلاحية accounting:read، فترى كل فروعه. انظر الربط.

هذه المجموعة قريبا.

اليوم المحاسبي

اليوم يحسب بالمنطقة الزمنية لكل فرع.
يبقى اليوم open حتى يغلق صباح اليوم التالي، ثم يصبح closed ويصلك accounting.day_closed.
اليوم المغلق لا يتغير أبدا. أي استرجاع متأخر أو تصحيح يظهر في adjustments في اليوم الذي حدث فيه، مع رقم الطلب الأصلي وتاريخه.

المبيعات اليومية

GET /accounting/daily?merchant_id={merchant_id}&date={YYYY-MM-DD}

bash

aurmap GET '/v1/accounting/daily?merchant_id=mer_5r8k2d&date=2026-10-13'

json

{
  "merchant_id": "mer_5r8k2d",
  "date": "2026-10-13",
  "currency": "SAR",
  "status": "closed",
  "places": [
    {
      "place_id": "plc_9q3w7e",
      "timezone": "Asia/Riyadh",
      "orders": { "completed": 42, "cancelled": 3, "rejected": 1 },
      "gross_sales_minor": 186450,
      "discounts_minor": 4000,
      "refunds_minor": 5405,
      "net_sales_minor": 177045,
      "tax_minor": 23093,
      "by_payment_method": { "card": 151200, "cash": 25845 },
      "adjustments": []
    }
  ]
}

الحقل	الوصف
`gross_sales_minor`	قيمة الطلبات المكتملة قبل الخصم
`discounts_minor`	الخصومات
`refunds_minor`	ما استرجع للعملاء في هذا اليوم
`net_sales_minor`	صافي المبيعات
`tax_minor`	الضريبة ضمن المبيعات
`by_payment_method`	صافي المبيعات حسب طريقة الدفع
`aurmap_fees_minor`	عدد صحيح بالهللة
`aurmap_fees_tax_minor`	عدد صحيح بالهللة
`cash_fees_due_minor`	عدد صحيح بالهللة
`payable_to_merchant_minor`	ما يستحقه التاجر عن هذا اليوم
`adjustments[]`	تصحيحات تخص أياما سابقة

const day = await aurmap('GET', `/v1/accounting/daily?merchant_id=${merchantId}&date=2026-10-13`);
for (const p of day.places) postJournal(p.place_id, day.date, p);

php

$day = aurmap('GET', "/v1/accounting/daily?merchant_id={$merchantId}&date=2026-10-13");
foreach ($day['places'] as $p) {
    post_journal($p['place_id'], $day['date'], $p);
}

الطلبات سطرا سطرا

GET /accounting/orders?merchant_id=&date=&cursor= يرجع سطرا لكل طلب بالأعمدة نفسها، للمطابقة التفصيلية.

التحويلات

GET /accounting/payouts?merchant_id=&from=&to= وGET /accounting/payouts/{payout_id}

json

{
  "payout_id": "pay_3t9w1z",
  "merchant_id": "mer_5r8k2d",
  "period": { "from": "2026-10-07", "to": "2026-10-13" },
  "amount_minor": 1012340,
  "currency": "SAR",
  "status": "paid",
  "paid_at": "2026-10-14T09:12:00Z",
  "bank_reference": "TRX-20261014-55821",
  "iban_last4": "4410",
  "days": ["2026-10-07", "2026-10-08", "2026-10-09", "2026-10-10", "2026-10-11", "2026-10-12", "2026-10-13"]
}

الحالات: scheduled وpaid وfailed. ويصلك payout.created وpayout.paid.