Create Payment Or Receipt
Testing
Testing Env
https://taccounting.vodoerp.com
Testing Env
https://taccounting.vodoerp.com
POST
/api/v5/payments-receipts
Last modified:2025-05-18 15:16:45
| Body | description |
|---|---|
| type | int type of the creation payment or receipts 1 => receipt, 2 => payment |
| currency_id | int the currency of the transaction |
| paid_received_type | int paid received type: 1 => cash or bank account, 2 => customer, 3 => supplier |
| parent_account_id | int required if paid_received_type is equal to 1 => cash or bank account account id of the parent of transaction you can find the account id from: https://vodoerp.apidog.io/get-all-chart-accounts-16878178e0 |
| payee_payer_type | string payee payer type 1 => customer, 2 => supplier, 3 => other |
| customer_payee_payer_id | int required if payee_payer_type is (1) the customer id of the payee payer you can find it from: https://vodoerp.apidog.io/get-all-cutsomers-16348963e0 |
| supplier_payee_payer_id | int required if payee_payer_type is (2) the supplier id of the payee payer you can find it from: https://vodoerp.apidog.io/get-all-cutsomers-16348963e0 |
| item_qty | array of int the quantity of item |
| item_price | array of int the price of item |
| account_id | array of int the account of item |
| item_tax_id | array of int the tax of item |
| created_date | date the creation date of the transaction it should be in Y-m-d 2024-04-04 |
| description | string the description of the transaction |
| tax_inclusive | string the tax inclusive should be 1 for inclusive or 0 un inclusive |
| advanced_payment | string the tax inclusive should be 1 for advance payment or 0 un advanve payment |
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://taccounting.vodoerp.com/api/v5/payments-receipts' \
--header 'user-token: ' \
--header 'secure-business-key: 4765066450c0bd66325.48403130' \
--header 'lang: en' \
--header 'Content-Type: application/json' \
--data-raw '{
"type": "1", // Receipt
"paid_received_type": 1, // cash_bank_account,
"parent_account_id": 11,
"payee_payer_type": 1,
"customer_payee_payer_id": 2627,
"item_qty": [2],
"item_price": [100],
"account_id": [32162],
// "item_tax_id": [22],
"tax_inclusive": true,
// "description": ""
}'Response Response Example
200 - Success
{
"status": true,
"message": "تم انشاء سند القبض بنجاح",
"data": {
"currency_id": 126,
"created_date": "2025-05-18",
"paid_received_type": 1,
"account_id": 11,
"status": "1",
"cleared_date": null,
"payee_payer_type": 1,
"payee_payer_id": 2627,
"description": null,
"tax_inclusive": true,
"total": 200,
"advanced_payment": 0,
"purchase_order_id": null,
"rate_value": 0,
"uuid": "df9c467e-5c49-48fa-ab7e-2a1151559543",
"business_id": 259,
"reference": 1165,
"type": "1",
"created_by": 999,
"updated_at": "2025-05-18T11:51:55.000000Z",
"created_at": "2025-05-18T11:51:55.000000Z",
"id": 1366,
"account": {
"id": 11,
"uuid": "ff85352b-0242-11f0-877b-fa163e094c0f",
"business_id": 259,
"currency_id": 126,
"type": "cash",
"name": "sasa hassan test",
"bank_account_name": "",
"code": "",
"credit_imit": 0,
"iban_num": "",
"address": "",
"started_balance": "",
"balance": null,
"representative_id": 0,
"POS_account": "0",
"main_account": 0,
"created_at": "2024-08-26T01:20:45.000000Z",
"updated_at": "2025-04-30T13:02:24.000000Z"
}
},
"errors": []
}Request
Header Params
user-token
string
required
Example:
{{user_token}}
secure-business-key
string
required
Example:
{{secure_business_key}}
lang
string
optional
Example:
{{lang}}
Body Params application/json