api-docs v5.116.0
API Docs
Table of contents
Billing_Expense
Billing Expense - Delete
Delete a specific billing expense
DELETE /billing-expenses/:id
Headers - Header
Name | Type | Description |
---|---|---|
Authorization | string |
key to place the API token to using the grant 'Bearer' |
Header examples
Authorization-Example
{
"Authorization": "Bearer <your-api-token>"
}
Examples
Example usage:
curl "https://yourdomain.com/billing-expenses/<billing-expense-id>" \
-X DELETE \
-H "Authorization: Bearer <your-api-token>"
Success response
Success response - Success 200
Name | Type | Description |
---|---|---|
id | string |
|
createdAt | Date |
timestamp |
createdBy | string |
account uid |
expensedAt | Date |
timestamp |
facility | String |
|
type | String |
payment-negation, payment-negation-void, payment-negation-return |
expenseMethod | string |
|
reason | String |
|
amountCurrency | String |
|
amount | Number |
|
metadata | Object |
|
billingItem | string |
|
billingInvoice | string |
|
billingPayment | string |
|
billingItemCommission | string |
Success response example
Success response example - Success-Response:
HTTP/1.1 200 OK
{
"id": "id-1",
"createdAt": 1564661697125,
"createdBy": "some-uid"
}
Billing Expense - Find
Get list of billing expenses
GET /billing-expenses
Headers - Header
Name | Type | Description |
---|---|---|
Authorization | string |
key to place the API token to using the grant 'Bearer' |
Header examples
Authorization-Example
{
"Authorization": "Bearer <your-api-token>"
}
Examples
Example usage:
curl "https://yourdomain.com/billing-expenses" \
-X GET \
-H "Authorization: Bearer <your-api-token>"
Success response
Success response - Success 200
Name | Type | Description |
---|---|---|
billingExpenses[] | object[] |
array of billingExpense |
billingExpenses.id | string |
|
billingExpenses.createdAt | Date |
timestamp |
billingExpenses.createdBy | string |
account uid |
billingExpenses.expensedAt | Date |
timestamp |
billingExpenses.facility | String |
|
billingExpenses.type | String |
payment-negation, payment-negation-void, payment-negation-return |
billingExpenses.expenseMethod | string |
|
billingExpenses.reason | String |
|
billingExpenses.amountCurrency | String |
|
billingExpenses.amount | Number |
|
billingExpenses.metadata | Object |
|
billingExpenses.billingItem | string |
|
billingExpenses.billingInvoice | string |
|
billingExpenses.billingPayment | string |
|
billingExpenses.billingItemCommission | string |
Success response example
Success response example - Success-Response:
HTTP/1.1 200 OK
[
{
"id": "id-1",
"createdAt": 1564661697125,
"createdBy": "some-uid"
},
{
"id": "id-2",
"createdAt": 1564661697125,
"createdBy": "some-uid"
}
]
Billing Expense - Get
Get a specific billing expense
GET /billing-expenses/:id
Headers - Header
Name | Type | Description |
---|---|---|
Authorization | string |
key to place the API token to using the grant 'Bearer' |
Header examples
Authorization-Example
{
"Authorization": "Bearer <your-api-token>"
}
Examples
Example usage:
curl "https://yourdomain.com/billing-expenses/<billing-expense-id>" \
-X GET \
-H "Authorization: Bearer <your-api-token>"
Success response
Success response - Success 200
Name | Type | Description |
---|---|---|
id | string |
|
createdAt | Date |
timestamp |
createdBy | string |
account uid |
expensedAt | Date |
timestamp |
facility | String |
|
type | String |
payment-negation, payment-negation-void, payment-negation-return |
expenseMethod | string |
|
reason | String |
|
amountCurrency | String |
|
amount | Number |
|
metadata | Object |
|
billingItem | string |
|
billingInvoice | string |
|
billingPayment | string |
|
billingItemCommission | string |
Success response example
Success response example - Success-Response:
HTTP/1.1 200 OK
{
"id": "id-1",
"createdAt": 1564661697125,
"createdBy": "some-uid"
}
Billing Expense - Patch
Update billing expense
PATCH /billing-expenses/:id
Headers - Header
Name | Type | Description |
---|---|---|
Authorization | string |
key to place the API token to using the grant 'Bearer' |
Header examples
Authorization-Example
{
"Authorization": "Bearer <your-api-token>"
}
Parameters - Parameter
Name | Type | Description |
---|---|---|
expensedAt | number |
optional timestamp |
type | string |
Allowed values: payment-negation,payment-negation-void,payment-negation-return |
expenseMethod | string |
optional |
reason | string |
optional |
amountCurrency | string |
optional Default value: PHP |
amount | number |
|
metadata | object |
optional |
billingItem | string |
optional |
billingInvoice | string |
optional |
billingPayment | string |
optional |
billingItemCommission | string |
optional |
createdAt | number |
optional timestamp Default value: currentTime |
Examples
Example usage:
curl "https://yourdomain.com/billing-expenses/<billing-expense-id>" \
-X PATCH \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <your-api-token>" \
-d '{
"reason": "some reason"
}'
Parameters examples
json
- Request-Example
{
"reason": "some reason"
}
Success response
Success response - Success 200
Name | Type | Description |
---|---|---|
id | string |
|
createdAt | Date |
timestamp |
createdBy | string |
account uid |
expensedAt | Date |
timestamp |
facility | String |
|
type | String |
payment-negation, payment-negation-void, payment-negation-return |
expenseMethod | string |
|
reason | String |
|
amountCurrency | String |
|
amount | Number |
|
metadata | Object |
|
billingItem | string |
|
billingInvoice | string |
|
billingPayment | string |
|
billingItemCommission | string |
Success response example
Success response example - Success-Response:
HTTP/1.1 200 OK
{
"id": "id-1",
"createdAt": 1564661697125,
"createdBy": "some-uid"
}
Billing Expense - Post
Create billing expense
POST /billing-expenses
Headers - Header
Name | Type | Description |
---|---|---|
Authorization | string |
key to place the API token to using the grant 'Bearer' |
Header examples
Authorization-Example
{
"Authorization": "Bearer <your-api-token>"
}
Parameters - Parameter
Name | Type | Description |
---|---|---|
expensedAt | number |
optional timestamp |
facility | string |
|
type | string |
Allowed values: payment-negation,payment-negation-void,payment-negation-return |
expenseMethod | string |
optional |
reason | string |
optional |
amountCurrency | string |
optional Default value: PHP |
amount | number |
|
metadata | object |
optional |
billingItem | string |
optional |
billingInvoice | string |
optional |
billingPayment | string |
optional |
billingItemCommission | string |
optional |
createdAt | number |
optional timestamp Default value: currentTime |
Examples
Example usage:
curl "https://yourdomain.com/billing-expenses" \
-X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <your-api-token>" \
-d '{
"facility": "facility-id",
"type": "payment-negation",
"amount": 1000
}'
Parameters examples
json
- Request-Example
{
"facility": "facility-id",
"type": "payment-negation",
"amount": 1000
}
Success response
Success response - Success 200
Name | Type | Description |
---|---|---|
id | string |
|
createdAt | Date |
timestamp |
createdBy | string |
account uid |
expensedAt | Date |
timestamp |
facility | String |
|
type | String |
payment-negation, payment-negation-void, payment-negation-return |
expenseMethod | string |
|
reason | String |
|
amountCurrency | String |
|
amount | Number |
|
metadata | Object |
|
billingItem | string |
|
billingInvoice | string |
|
billingPayment | string |
|
billingItemCommission | string |
Success response example
Success response example - Success-Response:
HTTP/1.1 200 OK
{
"id": "id-1",
"createdAt": 1564661697125,
"createdBy": "some-uid"
}