نمای کلی

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

 اهمیت این موضوع در امور مالیاتی مشهود و راه حل آن بسیار ضروری است.

در این شرایط کسب و کار می تواند نوعی فاکتور با قوانین تسهیم فروش بین کسب و کارهای ذینفع صادر نماید. ظاهراً خریدار تغییری را احساس نخواهد کرد و یک فاکتور تجمیعی را پرداخت می کند ولی در عمل، به تعداد ذینفعان با مبلغ تسهیمی فاکتور صادر شده و مبالغ مستقیماً پس از پرداخت به حساب صنفی آنها منتقل می شود.

** چند کسب وکار میتوانند در فروش یک محصول یا خدمت ، باهم مشارکت داشته باشند

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

از آن پس فروشنده می تواند ، با مجوزی که از کسب وکار دارد  ، به فروش اقدام نماید

بعد از فروش محصول سهم هر کسب وکار دخیل در فروش ، به حسابش واریز میشود.

clasor

قوانین زیر در تسهیم وجود دارند:

* فاکتورهای تسهیمی شامل یک فاکتور برای نمایش به مشتری، یک فاکتور برای صادر کننده فاکتور و تعدادی فاکتور برای سایر ذینفعان است.

بنابراین لازم است جمع فاکتورهای ذینفعان با فاکتور قابل نمایش به مشتری، برابر باشد. در غیر این صورت هنگام صدور فاکتور خطا دریافت می کنید.

* لازم است کسب و کارهای ذینفع قبلاً اجازه صدور فاکتور توسط کسب و کار دیگر را به او داده باشند.

* پرداخت فاکتورهای زیرمجموعه به صورت جداگانه امکانپذیر نیست و کل فاکتور تسهیم یکجا پرداخت می شود.

 

علاوه بر موارد بالا فاکتورهای تسهیمی از قوانین فاکتور عادی نیز تبعیت می کنند:

فاکتوری که با پارامتر verificationNeeded ثبت شده است باید پس از پرداخت کاربر توسط کسب و کار صادرکننده تایید شود. در غیر این صورت پس از مدت یک ساعت مبلغ پرداخت شده به حساب کاربر مرجوع می شود.

فاکتور پس از بسته شدن قابل تسویه می باشد و دیگر قابل لغو نیست.

لغو فاکتور قبل از بسته شدن امکان پذیر است و اگر پرداخت شده باشد مبلغ آن به کاربر مرجوع می شود.

در صورتی که پرداخت امن اعلام شده باشد، لغو و یا تایید فاکتور فقط توسط مشتری امکان پذیر است.

 

dealer  : A - کسب و کار واسط (ایجاد کننده ی فاکتور تسهیمی ) / معامله گر / فروشنده / دلال

shareholder  :B -  کسب وکار سودبرنده /  ذینفع / سهام دار

customer  : C  - مشتری نهایی / پرداخت کننده ی فاکتور


ایجاد دسترسی و مجوز فروش 

از طرف کسب وکار سود برنده ،برای کسب  وکار فروشنده ( معامله گر):

در صورتی که بخشی از فروش شما به کسب و کار دیگری تعلق دارد و میخواهید فاکتور به نام همان کسب و کار ثبت شود،

لازم است آن کسب و کار (ذینفع ) ، به کسب و کار شما اجازه صدور فاکتور به عنوان معامله گر(فروشنده ) را داده باشد.

برای این منظور کسب و کار ذینفع یا کارگزار او، با استفاده از توکن که در اختیار دارد، و  با استفاده از سرویس زیر به کسب کار دیگر اجازه صدور فاکتور می دهد.

به این معنی که کسب وکار شمارا به عنوان کسبوکار فروشنده ( واسطه / معامله گر) خود ثبت می نماید .

بعداز آن کسب وکار فروشنده ، میتواند فاکتورهایی با نام کسب وکار ( سهام دار/ ذینفع ) صادر کند.

 

افزودن کسب و کار واسط

شناسه سرویس : 29827 (  سندباکس: 39323  )

توضیحات

اجازه ثبت فاکتور به فروشنده  : بوسیله ی این سرویس ، کسب وکار سودبرنده ، میتواند کسب وکار فروشنده  ( واسط ) برای خود مشخص نماید.

به این معنی که کسب وکار واسط میتواند ، فاکتورهایی را با نام و مشخصات کسب وکار سودبرنده صادر نماید ،

 

پارامترهای ورودی

نام پارامتر

نوع

توضیحات

scProductId

String

شناسه سرویس 29798

scApiKey

String

این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید.

data

String

رشته حاوی اطلاعات فاکتورها json

delegatorId               

String

شناسه تفویض کنندگان، ترتیب اولویت را مشخص می کند

delegationHash          

String

کد تفویض برای اشاره به یک تفویض مشخصر

forceDelegation         

String

پرداخت فقط از طریق تفویض

پارامتر های خروجی 

نام پارامتر

نوع

توضیحات

hasError

true/false

در صورت وقوع خطا در فراخوانی سرویس true خواهد بود

referenceNumber

string

جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. توصیه می شود این پارامتر را برای هر درخواست ذخیره کنید.

result

 

.پاسخ نهایی سرویس

مقادیر خروجی

business

 

 مشخصات کسب وکار سود برنده

dealer

 

مشخصات کسب وکار واسط / فروشنده

enable

true/false

وضعیت فعال / غیرفعال بودن واسطه گر

allProductAllow

true/false

وضعیت دسترسی به تمام محصولات

 

نمونه درخواست

json

 

نمونه پاسخ

json

 

 

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

توکن کسب­­وکاری وارد نشده است

78

  کسب و کار با این " _ " شناسه یافت نشد.

227

تایم اوت سرویس اصلی

378

ارسال پاسخ از سرویس اصلی به پلتفرم با مشکل مواجه شده است

 

 

 

 

 

 

 

 

لیست کسب و کارهای واسط

شناسه سرویس :  29828 (  سندباکس:  39324 )

  توضیحات :

برای دریافت یا جستجوی لیست تمام کسب و کارهایی که به آنها مجوز معامله و صدور فاکتور داده اید، از سرویس زیر استفاده نمایید:

* توجه داشته باشید در صورتی که شناسه کسب و کار را اشتباه وارد کنید، با اررور "شناسه کسب و کار یافت نشد" مواجه نخواهید شد بلکه در فایل خروجی هیچ مقداری دریافت نخواهید کرد. (با hasError": false")

پارامترهای ورودی

نام پارامتر

نوع

توضیحات

scProductId

29828

شناسه سرویس  : 29828 (  سندباکس:  39324 )

scApiKey

کلید فراخوانی سرویس

این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید.

dealerBizId

 

فیلتر براساس شناسه یک کسب و کار واسط  

enable

true/false

 

size

default: 50

pagination size,

offset

[default: 0]

pagination offset,

پارامتر های خروجی 

نام پارامتر

نوع

توضیحات

hasError

true/false

در صورت وقوع خطا در فراخوانی سرویس true خواهد بود

referenceNumber

string

جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. توصیه می شود این پارامتر را برای هر درخواست ذخیره کنید.

result

 

پاسخ نهایی سرویس

مقادیر خروجی

business

 

 مشخصات کسب وکار سود برنده

dealer

 

مشخصات کسب وکار واسط / فروشنده

enable

true/false

وضعیت فعال / غیرفعال بودن واسطه گر

allProductAllow

true/false

وضعیت دسترسی به تمام محصولات

 نمونه درخواست

 

json

 

 

نمونه پاسخ

 

 

 

 

json

 

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

توکن کسب­­وکاری وارد نشده است

78

  کسب و کار با این " _ " شناسه یافت نشد.

227

تایم اوت سرویس اصلی

378

ارسال پاسخ از سرویس اصلی به پلتفرم با مشکل مواجه شده است

 

 

 

فعال‌سازی کسب‌وکاری واسط

شناسه سرویس : 29829 (  سندباکس: 39325  )

  توضیحات

برای فعالسازی و غیر فعالسازی مجوز معامله گران، به ترتیب از سرویس های زیر استفاده نمایید:

پارامترهای ورودی

نام پارامتر

نوع

توضیحات

scProductId

29829

شناسه سرویس

scApiKey

کلید فراخوانی سرویس

این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید.

dealerBizId

 

شناسه کسب و کار واسط

پارامترهای خروجی

نام پارامتر

نوع

توضیحات

hasError

true/false

در صورت وقوع خطا در فراخوانی سرویس true خواهد بود

referenceNumber

string

جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. توصیه می شود این پارامتر را برای هر درخواست ذخیره کنید.

result

 

.پاسخ نهایی سرویس

مقادیر خروجی

business

 

 مشخصات کسب وکار سود برنده

dealer

 

مشخصات کسب وکار واسط / فروشنده

enable

true/false

وضعیت فعال / غیرفعال بودن واسطه گر

allProductAllow

true/false

وضعیت دسترسی به تمام محصولات

 

نمونه درخواست

 

 

json

 

 

 

نمونه پاسخ

 

json

 

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

توکن کسب­­وکاری وارد نشده است

78

  کسب و کار با این " _ " شناسه یافت نشد.

227

تایم اوت سرویس اصلی

378

ارسال پاسخ از سرویس اصلی به پلتفرم با مشکل مواجه شده است

 

غیر فعال سازی کسب و کار واسط

شناسه سرویس : 29830 (  سندباکس:    39326 )

توضیحات

برای غیر فعالسازی مجوز معامله گران، به ترتیب از سرویس های زیر استفاده نمایید:

پارامترهای ورودی

نام پارامتر

نوع

توضیحات

scProductId

29830

شناسه سرویس

scApiKey

کلید فراخوانی سرویس

این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید.

dealerBizId

 

شناسه کسب و کار واسط

پارامترهای خروجی 

نام پارامتر

نوع

توضیحات

hasError

true/false

در صورت وقوع خطا در فراخوانی سرویس true خواهد بود

referenceNumber

string

جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. توصیه می شود این پارامتر را برای هر درخواست ذخیره کنید.

result

 

.پاسخ نهایی سرویس

مقادیر خروجی

business

 

 مشخصات کسب وکار سود برنده

dealer

 

مشخصات کسب وکار واسط / فروشنده

enable

true/false

وضعیت فعال / غیرفعال بودن واسطه گر

allProductAllow

true/false

وضعیت دسترسی به تمام محصولات

 

نمونه درخواست

json

 

نمونه پاسخ

json

 

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

توکن کسب­­وکاری وارد نشده است

78

  کسب و کار با این " _ " شناسه یافت نشد.

227

تایم اوت سرویس اصلی

378

ارسال پاسخ از سرویس اصلی به پلتفرم با مشکل مواجه شده است

 

لیست کسب و کارهایی که واسط آن هستید

شناسه سرویس : 29831 (  سندباکس: 39327  )

توضیحات

کسب وکار فروشنده ( / واسط / معامله گر ) میتواند با استفاده از توکن خود ،

لیست کسب وکارهایی که واسط آنها است ، را دریافت کنید.

پارامترهای ورودی

نام پارامتر

نوع

توضیحات

scProductId

29831

شناسه سرویس

scApiKey

کلید فراخوانی سرویس

این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید.

dealingBusinessId

 

شناسه کسب و کار سود برنده که به کسب وکار شمامجوز صدور فاکتور داده است .   

enable

[true/fasle]

نمایش مجوز ها و دسترسی هایی که توسط کسب وکار سود برنده ، فعال یا غیرفعال است .

offset

[paginatiion offset]

 

size

[pagination size]

 

پارامتر های خروجی

نام پارامتر

نوع

توضیحات

hasError

true/false

در صورت وقوع خطا در فراخوانی سرویس true خواهد بود

referenceNumber

string

جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. توصیه می شود این پارامتر را برای هر درخواست ذخیره کنید.

result

[{},{}]

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

مقادیر خروجی

business

 

 مشخصات کسب وکار سود برنده ( کسب وکاری که به شما دسترسی داده است )

dealer

 

مشخصات کسب وکار واسط / فروشنده

enable

true/false

وضعیت فعال / غیرفعال بودن واسطه گر

allProductAllow

true/false

وضعیت دسترسی به تمام محصولات

 

نمونه درخواست

json

 

نمونه پاسخ

json

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

توکن کسب­­وکاری وارد نشده است

78

  کسب و کار با این " _ " شناسه یافت نشد.

227

تایم اوت سرویس اصلی

378

ارسال پاسخ از سرویس اصلی به پلتفرم با مشکل مواجه شده است

 

صدور و کاهش فاکتور تسهیمی

کسب و کار معامله گر که لازم است فاکتور تسهیمی صادر نماید باید از جانب کسب و کارهای سهیم دارای مجوز صدور فاکتور باشد. همچنین در این سرویس امکان برای یک کسب وکار با ایجاد فاکتور تسهیمی برای چند صنف مختلف با توجه به رشته json، در نظر گرفته شده است. سپس می تواند با استفاده از سرویس زیر تسهیم فروش انجام دهد:

صدور فاکتور تسهیمی

شناسه سرویس :29798 (  سندباکس: 39293 )

توضیحات

یک فاکتور تسهیمی شامل  3 بخش اصلی می باشد.
 mainInvoice

  subInvoices

customerInvoiceItemVOs

 

* mainInvoice :

فاکتور اصلی ، اطلاعات مربوط به سهم فروشنده از فروش ، و همینطور محل واریز درآمد به حساب تفصیلی کسب وکار فروشنده در این بخش قرار میگیرد.

* subInvoices :

فاکتور و سهم سایر  ذینفعان از فروش ،  در این بخش قرار میگیرد، که به صورت یک آرایه از چند Object فاکتور  ، وارد میشود. که دراین قسمت شناسه کسب وکار ،ذینفع و سود برنده از این فروش ، به همراه محل واریز ( حساب تفصیلی آن کسب وکار ) و همینطور میزان سهمی که از فروش می برد ، آورده میشود .  

*  customerInvoiceItemVOs :

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

ساختار فاکتور تسهیمی

json

توجه داشته باشید که در مقادیر بالا معادله زیر باید برقرار باشد:
سهم فروشنده + (سهم سایر سودبرندگان ) = مبلغ پرداختی توسط کاربر در فاکتور

* دقت شود که پارامتر billNumber باید برای کسب وکار یونیک باشد .
* اگر فاکتور ، بدون تایید پرداخت ایجاد شود ، شما
برای پرداخت فاکتور تسهیمی توسط مشتری لازم است، شناسه customerInvoice جهت پرداخت ارسال گردد.
سایر فاکتورهای متصل قابل پرداخت نیستند.
همچنین سایر کسب و کارهای ذینفع فقط فاکتور مربوط به خود را خواهند دید که قابل پرداخت نمی باشند.

برای پرداخت فاکتور می توانید مقدار result -> customerInvoice -> id را با انواع روش های پرداخت ارسال نمایید.
یا از مقدار result -> customerInvoice-> uniqueNumber برای پرداخت پیشرفته استفاده نمایید

برای تایید فاکتور یا لغو فاکتور یا بستن فاکتور، مقدار result -> customerInvoice -> id را بفرستید.

با توجه به اینکه در فاکتور تسهیمی، آدرس کاربر در خروجی subinvoiceها قابل مشاهده نمی‌باشد، جهت دسترسی هر کسب و کار به آدرس کاربر، امکان ارسال addressId برای subInvoiceها نیز  فراهم گردیده است.

در صورتی که addressId در subInvoice ارسال گردد، آدرس کاربر در خروجی subInvoice فاکتور قابل مشاهده خواهد بود.

 

پارامترهای ورودی

نام پارامتر

نوع

توضیحات

scProductId

29798

شناسه سرویس

scApiKey

کلید فراخوانی سرویس

این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید.

data

 

رشته حاوی اطلاعات فاکتورها json

delegatorId                

 

شناسه تفویض کنندگان، ترتیب اولویت را مشخص می کند

delegationHash          

 

کد تفویض برای اشاره به یک تفویض مشخصر

forceDelegation         

 

پرداخت فقط از طریق تفویض

پارامتر های خروجی 

نام پارامتر

نوع

توضیحات

hasError

true/false

در صورت وقوع خطا در فراخوانی سرویس true خواهد بود

referenceNumber

string

جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. توصیه می شود این پارامتر را برای هر درخواست ذخیره کنید.

result

 

.پاسخ نهایی سرویس

نمونه data

json

 

نمونه درخواست

json

 

نمونه پاسخ

json





نمونه پاسخ:

 

json

 

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

توکن کسب­­وکاری وارد نشده است

78

  کسب و کار با این " _ " شناسه یافت نشد.

227

تایم اوت سرویس اصلی

378

ارسال پاسخ از سرویس اصلی به پلتفرم با مشکل مواجه شده است

 

کاهش فاکتور تسهیمی

شناسه سرویس : 29805 (  سندباکس:     39300 )
توضیحات

- در فاکتور تسهیمی نیز مانند فاکتور عادی با لغو شدن، کل مبلغ فاکتور و با کاهش، قسمتی از مبلغ به مشتری بازگردانده می شود.
- ولی در فاکتور تسهیمی برای کاهش لازم است کل سهم ها مجدداً اعلام شوند تا مبلغی که کسر می شود از حساب درست برداشته شود.
- فاکتور نباید وارد وضعیت بسته شده برود.
* کارمزد این کاهش و بازگرداندن وجه ، (که در زمان ایجاد این مستند 6000 ریال است ) از آن حساب تفصیلی ، که فروشنده در فاکتور برای دریافت وجه این فاکتور معرفی کرده است
برداشته میشود.  در نتیجه به میزان موجودی قابل برداشت در این حساب توجه داشته باشید
که علاوه بر وجهی که باید بازگردانده شود ، میزان 6000 ریال نیز ، جهت کارمزد این عمل از حساب تفصیلی برداشت میشود.

 

json

 

مقدار id در تمام بخش های اطلاعات ارسالی باید مطابق با شناسه های فاکتور اصلی باشد، در غیر این صورت خطا رخ می دهد. در فاکتور اصلاح شده نیز شرایط زیر لازم است برقرار باشد.
the share of dealer + the share of shareholder = the price to be payed by customer

پارامتر ورودی

نام پارامتر

نوع

توضیحات

scProductId

29805

این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید.

scApiKey

کلید فراخوانی سرویس

حاوی JSON فاکتور تسهیمی که تغییر کرده و مقدار ان کاهش پیدا کرده .

data

{}

 

ساختار فاکتور تسهیمی اولیه که ایجاد شده است و قصد کاهش آن را داریم. 

json

 

پارامتر خروجی

نام پارامتر

نوع

توضیحات

hasError

true/false

در صورت وقوع خطا در فراخوانی سرویس true خواهد بود

referenceNumber

string

جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. توصیه می شود این پارامتر را برای هر درخواست ذخیره کنید.

result

 

.پاسخ نهایی سرویس

نمونه درخواست کاهش فاکتور

json

 

نمونه پاسخ

json

 

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

توکن کسب­­وکاری وارد نشده است

78

  کسب و کار با این " _ " شناسه یافت نشد.

227

تایم اوت سرویس اصلی

378

ارسال پاسخ از سرویس اصلی به پلتفرم با مشکل مواجه شده است

 

 

 

 

 

 

json

نمونه پاسخ

 

json

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

توکن کسب­­وکاری وارد نشده است

78

  کسب و کار با این " _ " شناسه یافت نشد.

227

تایم اوت سرویس اصلی

378

ارسال پاسخ از سرویس اصلی به پلتفرم با مشکل مواجه شده است

 

کاهش فاکتور و بازگشت بلافاصله وجه

شناسه سرویس : 29806 (  سندباکس: 39301)

  توضیحات

در صورتی که می خواهید بلافاصله بعد از کاهش فاکتور، مبلغ برگشتی به شماره شبا کاربر منتقل گردد، از سرویس زیر با همان فرمت data بالا، استفاده نمایید:
* کارمزد این کاهش و بازگرداندن وجه ، (که در زمان ایجاد این مستند 6000 ریال است ) از آن حساب تفصیلی ، که فروشنده در فاکتور برای دریافت وجه این فاکتور معرفی کرده است
برداشته میشود.  در نتیجه به میزان موجودی قابل برداشت در این حساب توجه داشته باشید
که علاوه بر وجهی که باید بازگردانده شود ، میزان 6000 ریال نیز ، جهت کارمزد این عمل از حساب تفصیلی برداشت میشود.

پارامترهای ورودی

نام پارامتر

نوع

توضیحات

scProductId

29806

شناسه سرویس

scApiKey

کلید فراخوانی سرویس

این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید.

data

{}

حاوی JSON فاکتور تسهیمی :

مقدار id در تمام بخش های اطلاعات ارسالی باید مطابق با شناسه های فاکتور اصلی باشد، در غیر این صورت خطا رخ می دهد. در فاکتور اصلاح شده نیز شرایط زیر لازم است برقرار باشد.

the share of dealer + the share of shareholder = the price to be payed by customer 

پارامتر های خروجی

نام پارامتر

نوع

توضیحات

hasError

true/false

در صورت وقوع خطا در فراخوانی سرویس true خواهد بود

referenceNumber

string

جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. توصیه می شود این پارامتر را برای هر درخواست ذخیره کنید.

result

 

.پاسخ نهایی سرویس

نمونه درخواست:

json

 

نمونه پاسخ:

json

 

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

توکن کسب­­وکاری وارد نشده است

78

  کسب و کار با این " _ " شناسه یافت نشد.

227

تایم اوت سرویس اصلی

378

ارسال پاسخ از سرویس اصلی به پلتفرم با مشکل مواجه شده است

 

 

 

 

 

Clasor npm package version 2.1.4
به پادیوم قدرت داده اند:
pasargad
fanap
pod