curl --request POST \
--url https://api.exowpee.com/v1/accounting/client/fixed-assets/{fixedAsset}/dispose \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"disposal_date": "2023-11-07T05:31:56Z",
"proceeds": 1,
"description": "<string>",
"defer_capital_gain": true,
"reinvestment_deadline": "2023-11-07T05:31:56Z"
}
'import requests
url = "https://api.exowpee.com/v1/accounting/client/fixed-assets/{fixedAsset}/dispose"
payload = {
"disposal_date": "2023-11-07T05:31:56Z",
"proceeds": 1,
"description": "<string>",
"defer_capital_gain": True,
"reinvestment_deadline": "2023-11-07T05:31:56Z"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
disposal_date: '2023-11-07T05:31:56Z',
proceeds: 1,
description: '<string>',
defer_capital_gain: true,
reinvestment_deadline: '2023-11-07T05:31:56Z'
})
};
fetch('https://api.exowpee.com/v1/accounting/client/fixed-assets/{fixedAsset}/dispose', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.exowpee.com/v1/accounting/client/fixed-assets/{fixedAsset}/dispose",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'disposal_date' => '2023-11-07T05:31:56Z',
'proceeds' => 1,
'description' => '<string>',
'defer_capital_gain' => true,
'reinvestment_deadline' => '2023-11-07T05:31:56Z'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.exowpee.com/v1/accounting/client/fixed-assets/{fixedAsset}/dispose"
payload := strings.NewReader("{\n \"disposal_date\": \"2023-11-07T05:31:56Z\",\n \"proceeds\": 1,\n \"description\": \"<string>\",\n \"defer_capital_gain\": true,\n \"reinvestment_deadline\": \"2023-11-07T05:31:56Z\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.exowpee.com/v1/accounting/client/fixed-assets/{fixedAsset}/dispose")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"disposal_date\": \"2023-11-07T05:31:56Z\",\n \"proceeds\": 1,\n \"description\": \"<string>\",\n \"defer_capital_gain\": true,\n \"reinvestment_deadline\": \"2023-11-07T05:31:56Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.exowpee.com/v1/accounting/client/fixed-assets/{fixedAsset}/dispose")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"disposal_date\": \"2023-11-07T05:31:56Z\",\n \"proceeds\": 1,\n \"description\": \"<string>\",\n \"defer_capital_gain\": true,\n \"reinvestment_deadline\": \"2023-11-07T05:31:56Z\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"owner_type": "<string>",
"code": "<string>",
"name": "<string>",
"description": "<string>",
"asset_account_id": "<string>",
"asset_account": {},
"depreciation_account_id": "<string>",
"depreciation_account": {},
"expense_account_id": "<string>",
"expense_account": {},
"acquisition_date": "2023-12-25",
"in_service_date": "2023-12-25",
"acquisition_cost": 123,
"salvage_value": 123,
"useful_life_months": 123,
"method": "<string>",
"fiscal_method": "<string>",
"fiscal_rate": 123,
"fiscal_useful_life_months": 123,
"fiscal_accumulated_depreciation": 123,
"status": "<string>",
"accumulated_depreciation": 123,
"net_book_value": 123,
"acquisition_journal_entry_id": "<string>",
"disposal_date": "2023-12-25",
"disposal_proceeds": 123,
"disposal_journal_entry_id": "<string>",
"currency_code": "<string>",
"currency_exponent": 123,
"created_by": "<string>",
"created_by_type": "<string>",
"version": 123,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{
"message": "<string>",
"errors": {}
}Dispose of a fixed asset (client account)
Client space, on the client’s own books. Records the sale or scrapping of an asset on a date, producing the gain or loss entry.
curl --request POST \
--url https://api.exowpee.com/v1/accounting/client/fixed-assets/{fixedAsset}/dispose \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"disposal_date": "2023-11-07T05:31:56Z",
"proceeds": 1,
"description": "<string>",
"defer_capital_gain": true,
"reinvestment_deadline": "2023-11-07T05:31:56Z"
}
'import requests
url = "https://api.exowpee.com/v1/accounting/client/fixed-assets/{fixedAsset}/dispose"
payload = {
"disposal_date": "2023-11-07T05:31:56Z",
"proceeds": 1,
"description": "<string>",
"defer_capital_gain": True,
"reinvestment_deadline": "2023-11-07T05:31:56Z"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
disposal_date: '2023-11-07T05:31:56Z',
proceeds: 1,
description: '<string>',
defer_capital_gain: true,
reinvestment_deadline: '2023-11-07T05:31:56Z'
})
};
fetch('https://api.exowpee.com/v1/accounting/client/fixed-assets/{fixedAsset}/dispose', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.exowpee.com/v1/accounting/client/fixed-assets/{fixedAsset}/dispose",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'disposal_date' => '2023-11-07T05:31:56Z',
'proceeds' => 1,
'description' => '<string>',
'defer_capital_gain' => true,
'reinvestment_deadline' => '2023-11-07T05:31:56Z'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.exowpee.com/v1/accounting/client/fixed-assets/{fixedAsset}/dispose"
payload := strings.NewReader("{\n \"disposal_date\": \"2023-11-07T05:31:56Z\",\n \"proceeds\": 1,\n \"description\": \"<string>\",\n \"defer_capital_gain\": true,\n \"reinvestment_deadline\": \"2023-11-07T05:31:56Z\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.exowpee.com/v1/accounting/client/fixed-assets/{fixedAsset}/dispose")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"disposal_date\": \"2023-11-07T05:31:56Z\",\n \"proceeds\": 1,\n \"description\": \"<string>\",\n \"defer_capital_gain\": true,\n \"reinvestment_deadline\": \"2023-11-07T05:31:56Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.exowpee.com/v1/accounting/client/fixed-assets/{fixedAsset}/dispose")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"disposal_date\": \"2023-11-07T05:31:56Z\",\n \"proceeds\": 1,\n \"description\": \"<string>\",\n \"defer_capital_gain\": true,\n \"reinvestment_deadline\": \"2023-11-07T05:31:56Z\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"owner_type": "<string>",
"code": "<string>",
"name": "<string>",
"description": "<string>",
"asset_account_id": "<string>",
"asset_account": {},
"depreciation_account_id": "<string>",
"depreciation_account": {},
"expense_account_id": "<string>",
"expense_account": {},
"acquisition_date": "2023-12-25",
"in_service_date": "2023-12-25",
"acquisition_cost": 123,
"salvage_value": 123,
"useful_life_months": 123,
"method": "<string>",
"fiscal_method": "<string>",
"fiscal_rate": 123,
"fiscal_useful_life_months": 123,
"fiscal_accumulated_depreciation": 123,
"status": "<string>",
"accumulated_depreciation": 123,
"net_book_value": 123,
"acquisition_journal_entry_id": "<string>",
"disposal_date": "2023-12-25",
"disposal_proceeds": 123,
"disposal_journal_entry_id": "<string>",
"currency_code": "<string>",
"currency_exponent": 123,
"created_by": "<string>",
"created_by_type": "<string>",
"version": 123,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{
"message": "<string>",
"errors": {}
}fixed_assets.dispose
Conditions
- The accounting module must be part of the organization’s plan.
- The asset must not already be disposed of.
- disposal_date and proceeds are required; proceeds is an integer of at least 0.
- A fiscal period of the book must cover the disposal date, otherwise the call fails for lack of a fiscal year.
- The disposal date cannot be before the acquisition date.
- The asset’s currency must match the currency of the fiscal year of the disposal date.
- No depreciation of the asset may be posted in a period that starts after the disposal period.
- Earlier periods must be depreciated first: the accumulated depreciation must reach the target of the latest earlier period. The disposal period itself takes no prorata.
- The disposal entry is refused when the disposal period is closed.
- reinvestment_deadline is required when defer_capital_gain is true, and deferral is refused unless proceeds exceed the net book value.
- Posts one entry in the miscellaneous-operations journal, dated the disposal date: it debits the asset’s depreciation account for the accumulated depreciation, debits the disposal net-book-value account (812 in the SYSCOHADA chart) for the remaining net book value, and credits the asset account for the acquisition cost. When proceeds are above zero it also debits the disposal receivable account (485) and credits the disposal proceeds account (822).
- Takes back any open derogatory depreciation provision of the asset with reversal entries.
- When defer_capital_gain is true, opens a reinvestment-gain fiscal event for the gain, expected to be reversed on reinvestment_deadline, with its own provision entry.
- Sets the asset to disposed, stores the disposal date, proceeds and entry, and increments its version.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Identifier of the fixed asset (27-character KSUID).
Query Parameters
Response mode. Default none; none answers 204 No Content.
none, resource Comma-separated JSON keys of the root resource (id is always rendered). Available: id, owner_type, code, name, description, asset_account_id, depreciation_account_id, expense_account_id, acquisition_date, in_service_date, acquisition_cost, salvage_value, useful_life_months, method, fiscal_method, fiscal_rate, fiscal_useful_life_months, fiscal_accumulated_depreciation, status, accumulated_depreciation, acquisition_journal_entry_id, disposal_date, disposal_proceeds, disposal_journal_entry_id, currency_code, currency_exponent, created_by, created_by_type, version, created_at, updated_at, net_book_value.
Comma-separated include paths, each optionally followed by its fields in parentheses: units(id,sku),units.uomUnit(id,name). Max depth 6, max 40 paths. Available: assetAccount, depreciationAccount, expenseAccount.
Body
Date of the sale or scrapping, ISO 8601. Required; a fiscal period of the book must cover it, it cannot be before the acquisition date, and its period must be open.
Amount received for the asset, an integer in minor units (divide by 10 to the power currency_exponent). Required; 0 for a scrapping.
x >= 0Free-text description of the disposal entry. Optional; defaults to 'Cession', the asset code and its name.
When true, a positive capital gain (proceeds minus net book value) is deferred until reinvested, through a reinvestment-gain fiscal event. Optional; treated as false when omitted. Refused when there is no gain.
Date by which the gain is expected to be reinvested, ISO 8601. Required when defer_capital_gain is true; stored as the event's expected reversal date.
Response
Resource (only with response=resource).
Identifier of the asset (27-character KSUID).
Kind of book that owns the asset; set by the server.
Asset number allocated by the server per book, in the form IM-000001.
Name of the asset.
Free-text description; null when none.
Identifier of the asset account (class 2) the cost is carried on.
The asset account, an object, present only with ?include=assetAccount and when the caller may retrieve accounting accounts.
Identifier of the accumulated depreciation account (class 28).
The depreciation account, an object, present only with ?include=depreciationAccount and when the caller may retrieve accounting accounts.
Identifier of the depreciation expense account (class 68).
The expense account, an object, present only with ?include=expenseAccount and when the caller may retrieve accounting accounts.
Date the asset was acquired, ISO 8601 date.
Date depreciation starts from, ISO 8601 date. The service month counts when its day is 15 or earlier.
Cost of the asset in minor units (divide by 10 to the power currency_exponent).
Residual value in minor units, below the cost; 0 when not sent. The depreciable base is cost minus salvage value.
Economic useful life in months, between 1 and 1200.
Economic depreciation method; always linear, set by the server.
Fiscal depreciation method, linear or declining; null when the asset follows its economic plan for tax too.
Rate of the declining fiscal method; null otherwise. Integer from 1 to 100000, used in the declining-balance computation: each month takes the larger of the remaining base times rate divided by 120000 and the remaining base spread over the months left.
Fiscal useful life in months; null without a fiscal plan.
Fiscal depreciation recorded so far, in minor units.
active while depreciation can still run, fully_depreciated once the depreciable base is reached, disposed after a sale or scrapping.
Economic depreciation posted so far, in minor units.
Acquisition cost minus accumulated depreciation, in minor units; computed by the server.
Identifier of the posted accounting entry that recorded the purchase, when linked; null otherwise.
Date of the disposal, ISO 8601 date; null until disposed.
Proceeds of the disposal in minor units; null until disposed.
Identifier of the disposal accounting entry; null until disposed.
Three-letter currency code, taken from the fiscal year of the in-service date.
Number of decimal places of the currency (0 for XOF). An amount in minor units divided by 10 to this power gives the amount in the currency.
Identifier of the member or agent account that registered the asset.
Kind of actor that registered the asset.
Counter starting at 1 and increased by every change, run, rollback or disposal.
Date and time the record was created (ISO 8601, UTC).
Date and time the record was last changed (ISO 8601, UTC).