تسهیم در فروش
خدمتدهنده
بازارچه پادیوم
نمای کلی
در مواردی ممکن است کسب و کار اقدام به فروش محصولات کسب و کار دیگر نماید یا به هر دلیلی بخشی از مبلغ دریافتی به یک یا چند کسب و کار دیگر تعلق داشته باشد.
اهمیت این موضوع در امور مالیاتی مشهود و راه حل آن بسیار ضروری است.
در این شرایط کسب و کار می تواند نوعی فاکتور با قوانین تسهیم فروش بین کسب و کارهای ذینفع صادر نماید. ظاهراً خریدار تغییری را احساس نخواهد کرد و یک فاکتور تجمیعی را پرداخت می کند ولی در عمل، به تعداد ذینفعان با مبلغ تسهیمی فاکتور صادر شده و مبالغ مستقیماً پس از پرداخت به حساب صنفی آنها منتقل می شود.
** چند کسب وکار میتوانند در فروش یک محصول یا خدمت ، باهم مشارکت داشته باشند
کسب وکار میتواند یک کسب وکار دیگر را به عنوان فروشنده ی محصول یا خدمت خود انتخاب کند.
از آن پس فروشنده می تواند ، با مجوزی که از کسب وکار دارد ، به فروش اقدام نماید
بعد از فروش محصول سهم هر کسب وکار دخیل در فروش ، به حسابش واریز میشود.
قوانین زیر در تسهیم وجود دارند:
* فاکتورهای تسهیمی شامل یک فاکتور برای نمایش به مشتری، یک فاکتور برای صادر کننده فاکتور و تعدادی فاکتور برای سایر ذینفعان است.
بنابراین لازم است جمع فاکتورهای ذینفعان با فاکتور قابل نمایش به مشتری، برابر باشد. در غیر این صورت هنگام صدور فاکتور خطا دریافت می کنید.
* لازم است کسب و کارهای ذینفع قبلاً اجازه صدور فاکتور توسط کسب و کار دیگر را به او داده باشند.
* پرداخت فاکتورهای زیرمجموعه به صورت جداگانه امکانپذیر نیست و کل فاکتور تسهیم یکجا پرداخت می شود.
علاوه بر موارد بالا فاکتورهای تسهیمی از قوانین فاکتور عادی نیز تبعیت می کنند:
فاکتوری که با پارامتر 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 | وضعیت دسترسی به تمام محصولات |
نمونه درخواست
نمونه پاسخ
خطاهای معمول در پلتفرم | |
کد خطا | توضیح |
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 | وضعیت دسترسی به تمام محصولات |
نمونه درخواست
نمونه پاسخ
خطاهای معمول در پلتفرم | |
کد خطا | توضیح |
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 | وضعیت دسترسی به تمام محصولات |
نمونه درخواست
نمونه پاسخ
خطاهای معمول در پلتفرم | |
کد خطا | توضیح |
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 | وضعیت دسترسی به تمام محصولات |
نمونه درخواست
نمونه پاسخ
خطاهای معمول در پلتفرم
کد خطا | توضیح |
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 | وضعیت دسترسی به تمام محصولات |
نمونه درخواست
نمونه پاسخ
خطاهای معمول در پلتفرم
کد خطا | توضیح |
21 | توکن کسبوکاری وارد نشده است |
78 | کسب و کار با این " _ " شناسه یافت نشد. |
227 | تایم اوت سرویس اصلی |
378 | ارسال پاسخ از سرویس اصلی به پلتفرم با مشکل مواجه شده است |
صدور و کاهش فاکتور تسهیمی
کسب و کار معامله گر که لازم است فاکتور تسهیمی صادر نماید باید از جانب کسب و کارهای سهیم دارای مجوز صدور فاکتور باشد. همچنین در این سرویس امکان برای یک کسب وکار با ایجاد فاکتور تسهیمی برای چند صنف مختلف با توجه به رشته json، در نظر گرفته شده است. سپس می تواند با استفاده از سرویس زیر تسهیم فروش انجام دهد:
صدور فاکتور تسهیمی
شناسه سرویس :29798 ( سندباکس: 39293 )
توضیحات
یک فاکتور تسهیمی شامل 3 بخش اصلی می باشد.
mainInvoice
subInvoices
customerInvoiceItemVOs
* mainInvoice :
فاکتور اصلی ، اطلاعات مربوط به سهم فروشنده از فروش ، و همینطور محل واریز درآمد به حساب تفصیلی کسب وکار فروشنده در این بخش قرار میگیرد.
* subInvoices :
فاکتور و سهم سایر ذینفعان از فروش ، در این بخش قرار میگیرد، که به صورت یک آرایه از چند Object فاکتور ، وارد میشود. که دراین قسمت شناسه کسب وکار ،ذینفع و سود برنده از این فروش ، به همراه محل واریز ( حساب تفصیلی آن کسب وکار ) و همینطور میزان سهمی که از فروش می برد ، آورده میشود .
* customerInvoiceItemVOs :
اطلاعات فاکتور نهایی که به مشتری نمایش داده میشود در این بخش می آید ، که مبلغ فاکتور ، حاصل مجموع بخشهای فاکتور اصلی و سایر سود برندگان از فروش است .این فاکتور به مشتری نشان داده میشود ، و تنها این فاکتور است ، که قابل پرداخت خواهد بود .
ساختار فاکتور تسهیمی
توجه داشته باشید که در مقادیر بالا معادله زیر باید برقرار باشد:
سهم فروشنده + (سهم سایر سودبرندگان ) = مبلغ پرداختی توسط کاربر در فاکتور
* دقت شود که پارامتر 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
خطاهای معمول در پلتفرم
کد خطا | توضیح |
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 | {} |
|
ساختار فاکتور تسهیمی اولیه که ایجاد شده است و قصد کاهش آن را داریم.
پارامتر خروجی
نام پارامتر | نوع | توضیحات |
hasError | true/false | در صورت وقوع خطا در فراخوانی سرویس true خواهد بود |
referenceNumber | string | جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. توصیه می شود این پارامتر را برای هر درخواست ذخیره کنید. |
result |
| .پاسخ نهایی سرویس |
نمونه درخواست کاهش فاکتور
نمونه پاسخ
خطاهای معمول در پلتفرم
کد خطا | توضیح |
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 |
| .پاسخ نهایی سرویس |
نمونه درخواست:
نمونه پاسخ:
خطاهای معمول در پلتفرم
کد خطا | توضیح |
21 | توکن کسبوکاری وارد نشده است |
78 | کسب و کار با این " _ " شناسه یافت نشد. |
227 | تایم اوت سرویس اصلی |
378 | ارسال پاسخ از سرویس اصلی به پلتفرم با مشکل مواجه شده است |