generic
متد AccountingReport
این متد برای دریافت تراکنش (آرتیکل) های حسابداری مربوط به حساب کاربری شما استفاده می گردد و کاربرد آن برای مغایرت گیری می باشد.
این متد حداکثر 1000 عدد رکورد (تراکنش یا همان آرتیکل) خروجی می دهد. در صورتی که بازه تاریخی درخواست شما بزرگ باشد و سیستم بیش از 1000 عدد رکورد برگشت دهد، می بایست Id آخرین رکورد که این متد خروجی داده است را بدست آورده و مجددا یک درخواست جدید ارسال نمایید که LastRecordId آن، Id آخرین رکورد قبلی باشد.
تفاوت ورژن فعلی با ورژن قبلی این متد این است که در خروجی response model فیلد YourLocalInventoryPnr اضافه شده است.
API Endpoint
POST https://{SupplierWebsiteUrl}/api/Partners/Generic/AccountingReport/V2
Request Parameters
Usernamestring
required
نام کاربری
Passwordstring
required
رمز عبور به صورت MD5 شده
FromDatestring
required
تاریخ شروع برای فیلتر کردن آرتیکل های حسابداری با فرمت yyyy-MM-dd میلادی.
ToDatestring
required
تاریخ پایان برای فیلتر کردن آرتیکل های حسابداری با فرمت yyyy-MM-dd میلادی.
LastRecordIdstring
optional
این فیلد برای بدست آوردن 1000 عدد رکورد بعدی استفاده می گردد.
بدین صورت که هر عددی را به عنوان مقدر این فیلد ارسال نمایید، سیستم 1000 رکورد بعدی را خروجی میدهد.
برای اولین درخواستی که ارسال میفرمایین، این فیلد باید null باشد و در صورتی که بیش از 1000 رکورد برگشت داده شد، می بایست Id آخرین رکورد جواب قبلی را داخل این فیلد گذاشته و مجددا یک درخواست جدید ارسال نمایید.
Sample Request
{
"Username": "testdev1",
"Password": "25f9e794323b453885f5181f1b624d0b",
"FromDate": "2022-11-25",
"ToDate": "2022-11-28",
"LastRecordId": null
}
Response Parameters
RemainingBalanceFromPastComplex type
مانده از قبل
RemainingBalanceFromPast.Debitnumber
مجموع کل بدهکاری شما تا قبل از تاریخ FromDate که در Request ارسال نموده اید
RemainingBalanceFromPast.Creditnumber
مجموع کل بستانکاری شما تا قبل از تاریخ FromDate که در Request ارسال نموده اید
RemainingBalanceFromPast.Balancenumber
مجموع کل بالانس (تفاوت بدهکاری و بستانکاری) شما تا قبل از تاریخ FromDate که در Request ارسال نموده اید
ArticleListComplex type
لیست تراکنش (آرتیکل) های حسابداری که در حساب شما منظور شده است
ArticleList.Idnumber
شناسه یکتا مربوط به یک آرتیکل
در صورتی که تعداد رکوردها بیش از 1000 عدد باشد، از این فیلد برای ارسال یک درخواست جدید و با قرار دادن مقدار آن در فیلد LastRecordId استفاده خواهد شد.
ArticleList.Datestring
تاریخ ثبت تراکنش به صورت میلادی و با فرمت yyyy-MM-dd
ArticleList.Descstring
شرح تراکنش
لطفا توجه داشته باشید که سپهر ممکن است بدون اطلاع قبلی فرمت شرح تراکنش را تغییر دهد. بنابراین در صورتی که شما قصد Parse کردن این شرح توسط regex یا روش های مشابه را دارید، ریسک این تغییر را در نظر داشته باشید.
ArticleList.Debitnumber
مبلغ بدهکاری که بابت این تراکنش در حساب شما منظور شده است.
ArticleList.Creditnumber
مبلغ بستانکاری که بابت این تراکنش در حساب شما منظور شده است.
ArticleList.YourLocalInventoryPnrstring
رفرنس سیستم داخلی شما در زمان فراخوانی متد Book آن را به سیستم تامین کننده ارسال کرده اید.
Sample Response
{
"RemainingBalanceFromPast": {
"Debit": 3720501129,
"Credit": 3602875224,
"Balance": 0
},
"ArticleList": [
{
"Id": 638070,
"Date": "2022-11-26",
"Desc": "فروش هتل _ يک تخته پرزيدنت ميراژ _ 2 شب ورود 01/10/05 _ ALI SHABANI _ MARYAM SALAMI _ رفرنس V2N7FV _ واچر 215267",
"Debit": 30352140,
"Credit": 0,
"YourLocalInventoryPnr": "954a1632-7c5a-4bbc-9d1b-16533610e674"
},
{
"Id": 638110,
"Date": "2022-11-27",
"Desc": "فروش هتل _ يک تخته پرزيدنت ميراژ _ 2 شب ورود 01/09/25 _ SINA KAZEMI YAZDI _ MARYAM SALAMI _ رفرنس L5Y24Y _ واچر 215278",
"Debit": 30788140,
"Credit": 0,
"YourLocalInventoryPnr": "e4c302c6-b15b-421f-8aa2-86b97b3ef2ce"
},
{
"Id": 638149,
"Date": "2022-11-27",
"Desc": "فروش هتل _ يک تخته پرزيدنت ميراژ _ 1 شب ورود 01/09/07 _ AKBAR KABIRI _ ASQAR SAQIRI _ رفرنس V325A5 _ واچر 215284",
"Debit": 16350000,
"Credit": 0,
"YourLocalInventoryPnr": "84fb0ad5-87a1-4c02-bcf7-00d0fbff7cb5"
},
{
"Id": 638157,
"Date": "2022-11-27",
"Desc": "استرداد استرداد هتل _ يک تخته پرزيدنت ميراژ _ 1 شب ورود 01/09/07 _ AKBAR KABIRI _ ASQAR SAQIRI _ رفرنس V325A5 _ واچر 215284",
"Debit": 0,
"Credit": 11350000,
"YourLocalInventoryPnr": null
},
{
"Id": 638163,
"Date": "2022-11-27",
"Desc": "واريز اينترنتي توسط درگاه بانک پاسارگاد _ تست ادمين1",
"Debit": 0,
"Credit": 183766185,
"YourLocalInventoryPnr": null
}
]
}