api-docs v5.45.0
API Docs
Billing_SOA
Billing SOA - Post
Create billing soa
POST /billing-soas
Headers
| 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 |
|---|---|---|
| facility | string |
|
| type | string |
Allowed values: organization,insurance-contract |
| externalSOAId | string |
optional |
| customer | string |
|
| template | string |
optional |
| LOANo | string |
optional |
| invoices | string[] |
optional |
| invoiceItems | string[] |
optional |
| startAt | number |
optional timestamp |
| endAt | number |
optional timestamp |
| preparedAt | number |
optional timestamp |
| receivedAt | number |
optional timestamp |
| paymentTerms | number |
optional |
| note | string |
optional |
| coveragePaymentMethod | string |
optional Allowed values: prepaid,postpaid |
| createdAt | number |
optional timestamp Default value: currentTime |
Examples
Example usage:
curl "https://yourdomain.com/billing-soas" \
-X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <your-api-token>" \
-d '{
"facility": "facility-id",
"type": "organization",
"customer": "customer-id"
}'
Parameters examples
json - Request-Example
{
"facility": "facility-id",
"type": "organization",
"customer": "customer-id"
}
Success response
Success response - Success 200
| Name | Type | Description |
|---|---|---|
| id | string |
|
| facility | string |
|
| type | string |
Allowed values: organization,insurance-contract |
| externalSOAId | string |
|
| customer | string |
|
| template | string |
|
| LOANo | string |
|
| invoices | string[] |
|
| invoiceItems | string[] |
|
| startAt | number |
timestamp |
| endAt | number |
timestamp |
| preparedAt | number |
timestamp |
| receivedAt | number |
timestamp |
| paymentTerms | number |
|
| note | string |
|
| coveragePaymentMethod | string |
Allowed values: prepaid,postpaid |
| createdAt | number |
timestamp Default value: currentTime |
| createdBy | string |
account uid |
| finalizedAt | number |
timestamp |
| finalizedBy | string |
account uid |
| customerType | string |
|
| customerSubtype | string |
Success response example
Success response example - Success-Response:
HTTP/1.1 200 OK
{
"id": "id-1",
"createdAt": 1564661697125,
"createdBy": "some-uid"
}
Billing SOA - Delete
Delete a specific billing soa. Can only delete finalized items
DELETE /billing-soas/:id
Headers
| 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-soas/<billing-soa-id>" \
-X DELETE \
-H "Authorization: Bearer <your-api-token>"
Success response
Success response - Success 200
| Name | Type | Description |
|---|---|---|
| id | string |
|
| facility | string |
|
| type | string |
Allowed values: organization,insurance-contract |
| externalSOAId | string |
|
| customer | string |
|
| template | string |
|
| LOANo | string |
|
| invoices | string[] |
|
| invoiceItems | string[] |
|
| startAt | number |
timestamp |
| endAt | number |
timestamp |
| preparedAt | number |
timestamp |
| receivedAt | number |
timestamp |
| paymentTerms | number |
|
| note | string |
|
| coveragePaymentMethod | string |
Allowed values: prepaid,postpaid |
| createdAt | number |
timestamp Default value: currentTime |
| createdBy | string |
account uid |
| finalizedAt | number |
timestamp |
| finalizedBy | string |
account uid |
| customerType | string |
|
| customerSubtype | string |
Success response example
Success response example - Success-Response:
HTTP/1.1 200 OK
{
"id": "id-1",
"createdAt": 1564661697125,
"createdBy": "some-uid"
}
Billing SOA - Find
Get list of billing soas
GET /billing-soas
Headers
| 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-soas" \
-X GET \
-H "Authorization: Bearer <your-api-token>"
Success response
Success response - Success 200
| Name | Type | Description |
|---|---|---|
| billingSOAs[] | object[] |
array of billingSOA |
| billingSOAs.id | string |
|
| billingSOAs.facility | string |
|
| billingSOAs.type | string |
Allowed values: organization,insurance-contract |
| billingSOAs.externalSOAId | string |
|
| billingSOAs.customer | string |
|
| billingSOAs.template | string |
|
| billingSOAs.LOANo | string |
|
| billingSOAs.invoices | string[] |
|
| billingSOAs.invoiceItems | string[] |
|
| billingSOAs.startAt | number |
timestamp |
| billingSOAs.endAt | number |
timestamp |
| billingSOAs.preparedAt | number |
timestamp |
| billingSOAs.receivedAt | number |
timestamp |
| billingSOAs.paymentTerms | number |
|
| billingSOAs.note | string |
|
| billingSOAs.coveragePaymentMethod | string |
Allowed values: prepaid,postpaid |
| billingSOAs.createdAt | number |
timestamp Default value: currentTime |
| billingSOAs.createdBy | string |
account uid |
| billingSOAs.finalizedAt | number |
timestamp |
| billingSOAs.finalizedBy | string |
account uid |
| billingSOAs.customerType | string |
|
| billingSOAs.customerSubtype | 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 SOA - Get
Get a specific billing soa
GET /billing-soas/:id
Headers
| 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-soas/<billing-soa-id>" \
-X GET \
-H "Authorization: Bearer <your-api-token>"
Success response
Success response - Success 200
| Name | Type | Description |
|---|---|---|
| id | string |
|
| facility | string |
|
| type | string |
Allowed values: organization,insurance-contract |
| externalSOAId | string |
|
| customer | string |
|
| template | string |
|
| LOANo | string |
|
| invoices | string[] |
|
| invoiceItems | string[] |
|
| startAt | number |
timestamp |
| endAt | number |
timestamp |
| preparedAt | number |
timestamp |
| receivedAt | number |
timestamp |
| paymentTerms | number |
|
| note | string |
|
| coveragePaymentMethod | string |
Allowed values: prepaid,postpaid |
| createdAt | number |
timestamp Default value: currentTime |
| createdBy | string |
account uid |
| finalizedAt | number |
timestamp |
| finalizedBy | string |
account uid |
| customerType | string |
|
| customerSubtype | string |
Success response example
Success response example - Success-Response:
HTTP/1.1 200 OK
{
"id": "id-1",
"createdAt": 1564661697125,
"createdBy": "some-uid"
}
Billing SOA - Patch
Update billing soa
PATCH /billing-soas/:id
Headers
| 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 |
|---|---|---|
| externalSOAId | string |
optional |
| template | string |
optional |
| LOANo | string |
optional |
| invoices | string[] |
optional |
| invoiceItems | string[] |
optional |
| startAt | number |
optional timestamp |
| endAt | number |
optional timestamp |
| preparedAt | number |
optional timestamp |
| receivedAt | number |
optional timestamp |
| paymentTerms | number |
optional |
| note | string |
optional |
| coveragePaymentMethod | string |
optional Allowed values: prepaid,postpaid |
| createdAt | number |
optional timestamp Default value: currentTime |
| finalize | boolean |
optional directive |
Examples
Example usage:
curl "https://yourdomain.com/billing-soas/<billing-soa-id>" \
-X PATCH \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <your-api-token>" \
-d '{
"note": "some note"
}'
Parameters examples
json - Request-Example
{
"note": "some note"
}
Success response
Success response - Success 200
| Name | Type | Description |
|---|---|---|
| id | string |
|
| facility | string |
|
| type | string |
Allowed values: organization,insurance-contract |
| externalSOAId | string |
|
| customer | string |
|
| template | string |
|
| LOANo | string |
|
| invoices | string[] |
|
| invoiceItems | string[] |
|
| startAt | number |
timestamp |
| endAt | number |
timestamp |
| preparedAt | number |
timestamp |
| receivedAt | number |
timestamp |
| paymentTerms | number |
|
| note | string |
|
| coveragePaymentMethod | string |
Allowed values: prepaid,postpaid |
| createdAt | number |
timestamp Default value: currentTime |
| createdBy | string |
account uid |
| finalizedAt | number |
timestamp |
| finalizedBy | string |
account uid |
| customerType | string |
|
| customerSubtype | string |
Success response example
Success response example - Success-Response:
HTTP/1.1 200 OK
{
"id": "id-1",
"createdAt": 1564661697125,
"createdBy": "some-uid"
}