refund_invoice
Testing Env
https://taccounting.vodoerp.com
Testing Env
https://taccounting.vodoerp.com
POST
/api/v4/credit_note/pos/{invoice_id}
Last modified:2025-04-06 12:28:16
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://taccounting.vodoerp.com/api/v4/credit_note/pos/' \
--header 'secure-business-key: 4765066450c0bd66325.48403130' \
--header 'platform-key: 1234567' \
--header 'platform: web' \
--header 'Accept-Language: ar' \
--header 'apikey: efe2db322a53' \
--header 'userToken: 425889726d580780d94cb542c9bb683318f41ce13a8749fd092b43075a4107ce' \
--form 'description="credit note Desc"' \
--form 'discount_type="0"' \
--form 'item_id[]=""' \
--form 'item_price[]="100"' \
--form 'item_qty[]="1"' \
--form 'item_discount[]=""' \
--form 'item_desc[]="item1_desc"' \
--form 'employee_id[]=""' \
--form 'pos_session_id="8511111"' \
--form 'pos_id="181"'
Response Response Example
{
"status": true,
"message": "تم إنشاء المرتجع على الفاتورة بنجاح",
"data": {
"uuid": "3e1cd387-8319-4e31-aa40-fb4974ba7215",
"user_id": 40935,
"currency_id": 126,
"business_id": 256,
"reference": 22,
"invoice_id": 121052,
"admin_invoice_id": "",
"created_date": "2025-03-27",
"description": "credit note Desc",
"description_type": "",
"billing_address": "",
"tax_inclusive": "0",
"discount": null,
"deduct_type": "",
"deduct_value": "",
"total": 500,
"total_without_deduct": 500,
"note": "",
"amount_total": 500,
"tax_amount_total": 65.2173913043478279405462672002613544464111328125,
"pos_session_id": "392",
"representative_id": 598,
"created_by": null,
"rate_value": 0,
"updated_at": "2025-03-27T13:29:26.000000Z",
"created_at": "2025-03-27T13:29:26.000000Z",
"id": 1458,
"invoice": {
"id": 121052,
"uuid": "eb0625c9-6a93-4244-aeda-e498ba766b51",
"user_id": 40935,
"branch_id": 0,
"business_id": 256,
"currency_id": 126,
"reference": 256,
"sales_order_id": null,
"ecomm_order_id": 0,
"order_number": null,
"quote_number": 0,
"due_date": null,
"created_date": "2025-03-26",
"description": "",
"invoice_status_days": 0,
"invoice_status": null,
"billing_address": "",
"rounding": "0",
"rounding_value": "0",
"tax_inclusive": "0",
"discount": null,
"total_amount_word": "0",
"total": 7850,
"credit_amount": 1804.347826086999930339516140520572662353515625,
"payment_amount": 1608.695652174000088052707724273204803466796875,
"receipt_amount": 7850,
"expenses_amount": null,
"jornal_entries_amount": null,
"amount_total": 6826.08695652169990353286266326904296875,
"tax_amount_total": 1023.9130434782999827802996151149272918701171875,
"total_without_deduct": "7850",
"due_balalnce": -195.652173913040002162233577109873294830322265625,
"qty_due_balance": -6,
"hide_due_date": "0",
"deduct_type": "",
"deduct_value": 0,
"payment_fees": 0,
"early_discount_type": "",
"early_discount_value": 0,
"early_discount_days": 0,
"custom_title": "",
"note": "",
"bank_id": 0,
"representative_id": 598,
"pos_session_id": 452,
"created_by": 598,
"invoice_type": null,
"reservation_invoice_id": null,
"column_type": "sales_invoices",
"rate_value": 0,
"created_at": "2025-03-26T14:52:04.000000Z",
"updated_at": "2025-03-27T13:29:26.000000Z",
"all_items": [
{
"id": 216361,
"invoice_id": 121052,
"business_id": null,
"sort": 0,
"item_id": 3025,
"ecommerce_item_attributes_id": "",
"bocklet_id": null,
"bocklet_barcode": null,
"coupon_id": null,
"coupon_barcode": null,
"item_kind": "0",
"build_id": null,
"build_item": 0,
"ecommerce_item_id": null,
"ecommerce_item_unit_name_ar": null,
"ecommerce_item_unit_name_en": null,
"ecommerce_item_unit_id": null,
"hidden": 0,
"description": "The iPhone 15 and iPhone 15 Plus are smartphones developed and marketed by Apple. They are the seventeenth generation of iPhones, succeeding the iPhone 14 and iPhone 14 Plus.",
"qty": "2",
"unit_price": 2608.69565217389981626183725893497467041015625,
"amount": 5217.3913043477996325236745178699493408203125,
"different_currency_amount": null,
"different_currency_id": 0,
"discount": "0",
"account_id": 31721,
"fixedAsset_id": null,
"intangibleAsset_id": null,
"capitalAccount_id": null,
"specialAccount_id": null,
"customer_id": null,
"supplier_id": null,
"customer_invoice_id": null,
"supplier_invoice_id": null,
"employee_id": null,
"tax_id": "185",
"division_id": null,
"tax_amount": 782.6086956521700130906538106501102447509765625,
"column_type": "sales_invoices",
"created_at": "2025-03-26T14:52:04.000000Z",
"updated_at": "2025-03-26T14:52:04.000000Z"
},
{
"id": 216362,
"invoice_id": 121052,
"business_id": null,
"sort": 0,
"item_id": 2945,
"ecommerce_item_attributes_id": "",
"bocklet_id": null,
"bocklet_barcode": null,
"coupon_id": null,
"coupon_barcode": null,
"item_kind": "0",
"build_id": null,
"build_item": 0,
"ecommerce_item_id": null,
"ecommerce_item_unit_name_ar": null,
"ecommerce_item_unit_name_en": null,
"ecommerce_item_unit_id": null,
"hidden": 0,
"description": "For a radiant and beautiful hair look, try Kevin Murphy Shimmer Me Blonde 100ml This perfect spray is specially designed for blonde hair",
"qty": "1",
"unit_price": 1304.347826086999930339516140520572662353515625,
"amount": 1304.347826086999930339516140520572662353515625,
"different_currency_amount": null,
"different_currency_id": 0,
"discount": "0",
"account_id": 31627,
"fixedAsset_id": null,
"intangibleAsset_id": null,
"capitalAccount_id": null,
"specialAccount_id": null,
"customer_id": null,
"supplier_id": null,
"customer_invoice_id": null,
"supplier_invoice_id": null,
"employee_id": null,
"tax_id": "185",
"division_id": null,
"tax_amount": 195.652173913040002162233577109873294830322265625,
"column_type": "sales_invoices",
"created_at": "2025-03-26T14:52:06.000000Z",
"updated_at": "2025-03-26T14:52:06.000000Z"
},
{
"id": 216363,
"invoice_id": 121052,
"business_id": null,
"sort": 0,
"item_id": 2944,
"ecommerce_item_attributes_id": "",
"bocklet_id": null,
"bocklet_barcode": null,
"coupon_id": null,
"coupon_barcode": null,
"item_kind": "0",
"build_id": null,
"build_item": 0,
"ecommerce_item_id": null,
"ecommerce_item_unit_name_ar": null,
"ecommerce_item_unit_name_en": null,
"ecommerce_item_unit_id": null,
"hidden": 0,
"description": "Enjoy vibrant and shiny blonde hair with Kevin Murphy Blonde Angel Colour Enhancing Treatment 250ml This treatment enhances color and maintains its brightness while deeply nourishing and hydrating your hair.",
"qty": "1",
"unit_price": 86.9565217391299967175655183382332324981689453125,
"amount": 86.9565217391299967175655183382332324981689453125,
"different_currency_amount": null,
"different_currency_id": 0,
"discount": "0",
"account_id": 31627,
"fixedAsset_id": null,
"intangibleAsset_id": null,
"capitalAccount_id": null,
"specialAccount_id": null,
"customer_id": null,
"supplier_id": null,
"customer_invoice_id": null,
"supplier_invoice_id": null,
"employee_id": null,
"tax_id": "185",
"division_id": null,
"tax_amount": 13.043478260869999729720802861265838146209716796875,
"column_type": "sales_invoices",
"created_at": "2025-03-26T14:52:08.000000Z",
"updated_at": "2025-03-26T14:52:08.000000Z"
},
{
"id": 216364,
"invoice_id": 121052,
"business_id": null,
"sort": 0,
"item_id": 2943,
"ecommerce_item_attributes_id": "",
"bocklet_id": null,
"bocklet_barcode": null,
"coupon_id": null,
"coupon_barcode": null,
"item_kind": "0",
"build_id": null,
"build_item": 0,
"ecommerce_item_id": null,
"ecommerce_item_unit_name_ar": null,
"ecommerce_item_unit_name_en": null,
"ecommerce_item_unit_id": null,
"hidden": 0,
"description": "Give your blonde hair the perfect care with **Kevin Murphy Blonde Angel Wash 1000ml This luxurious shampoo enhances blonde color brilliance and gently cleanses, leaving your hair soft and full of life. With a blend of nourishing ingredients",
"qty": "1",
"unit_price": 130.43478260870000440263538621366024017333984375,
"amount": 130.43478260870000440263538621366024017333984375,
"different_currency_amount": null,
"different_currency_id": 0,
"discount": "0",
"account_id": 31627,
"fixedAsset_id": null,
"intangibleAsset_id": null,
"capitalAccount_id": null,
"specialAccount_id": null,
"customer_id": null,
"supplier_id": null,
"customer_invoice_id": null,
"supplier_invoice_id": null,
"employee_id": null,
"tax_id": "185",
"division_id": null,
"tax_amount": 19.565217391303999505680621950887143611907958984375,
"column_type": "sales_invoices",
"created_at": "2025-03-26T14:52:11.000000Z",
"updated_at": "2025-03-26T14:52:11.000000Z"
},
{
"id": 216365,
"invoice_id": 121052,
"business_id": null,
"sort": 0,
"item_id": 2941,
"ecommerce_item_attributes_id": "",
"bocklet_id": null,
"bocklet_barcode": null,
"coupon_id": null,
"coupon_barcode": null,
"item_kind": "0",
"build_id": null,
"build_item": 0,
"ecommerce_item_id": null,
"ecommerce_item_unit_name_ar": null,
"ecommerce_item_unit_name_en": null,
"ecommerce_item_unit_id": null,
"hidden": 0,
"description": "Indulge your hair with luxury using Kevin Murphy Treatment Elixir Flacon 50ml. This elixir deeply moisturizes and nourishes your hair, enhancing its shine and softness. Perfect for repairing damaged hair and restoring its vitality with every use.",
"qty": "1",
"unit_price": 86.9565217391299967175655183382332324981689453125,
"amount": 86.9565217391299967175655183382332324981689453125,
"different_currency_amount": null,
"different_currency_id": 0,
"discount": "0",
"account_id": 31627,
"fixedAsset_id": null,
"intangibleAsset_id": null,
"capitalAccount_id": null,
"specialAccount_id": null,
"customer_id": null,
"supplier_id": null,
"customer_invoice_id": null,
"supplier_invoice_id": null,
"employee_id": null,
"tax_id": "185",
"division_id": null,
"tax_amount": 13.043478260869999729720802861265838146209716796875,
"column_type": "sales_invoices",
"created_at": "2025-03-26T14:52:13.000000Z",
"updated_at": "2025-03-26T14:52:13.000000Z"
},
{
"id": 216366,
"invoice_id": 121052,
"business_id": null,
"sort": 0,
"item_id": 2942,
"ecommerce_item_attributes_id": "",
"bocklet_id": null,
"bocklet_barcode": null,
"coupon_id": null,
"coupon_barcode": null,
"item_kind": "0",
"build_id": null,
"build_item": 0,
"ecommerce_item_id": null,
"ecommerce_item_unit_name_ar": null,
"ecommerce_item_unit_name_en": null,
"ecommerce_item_unit_id": null,
"hidden": 0,
"description": "Give your blonde hair exceptional care with Kevin Murphy Blonde Angel Treatment. Its rich formula deeply hydrates enhances natural color and adds an irresistible shine Ideal for blonde or grey-dyed hair available in a1000ml size for long-lasting stunning results ensuring",
"qty": "1",
"unit_price": 0,
"amount": 0,
"different_currency_amount": null,
"different_currency_id": 0,
"discount": "0",
"account_id": 31627,
"fixedAsset_id": null,
"intangibleAsset_id": null,
"capitalAccount_id": null,
"specialAccount_id": null,
"customer_id": null,
"supplier_id": null,
"customer_invoice_id": null,
"supplier_invoice_id": null,
"employee_id": null,
"tax_id": "0",
"division_id": null,
"tax_amount": 0,
"column_type": "sales_invoices",
"created_at": "2025-03-26T14:52:16.000000Z",
"updated_at": "2025-03-26T14:52:16.000000Z"
}
]
}
},
"errors": []
}
Request
Header Params
secure-business-key
string
required
Example:
4765066450c0bd66325.48403130
platform-key
string
required
Example:
1234567
platform
string
required
Example:
web
Accept-Language
string
required
Example:
ar
apikey
string
required
Example:
efe2db322a53
userToken
string
required
Example:
425889726d580780d94cb542c9bb683318f41ce13a8749fd092b43075a4107ce
Body Params multipart/form-data
description
string
required
Example:
credit note Desc
discount_type
string
required
Example:
0
item_id[]
string
required
item_price[]
string
required
Example:
100
item_qty[]
string
required
Example:
1
item_discount[]
string
required
item_desc[]
string
required
Example:
item1_desc
employee_id[]
string
required
visa_amount
string
optional
Example:
10
cash_amount
string
optional
Example:
0
customer_amount
string
optional
pos_session_id
string
required
Example:
8511111
pos_id
string
required
Example:
181