Skip to main content

Fixed assets

Dimension type AST

Find​

Web service type: Method driven

Resource location: /webservices/finder.asmx?wsdl

Method​

public Message[] Search(
	string type, // Finder type, See Finder type.
	string pattern, // The search pattern. May contain wildcards * and ?
	int field, // Fields to search through, see Search fields.
	int firstRow, // First row to return, usefull for paging
	int maxRows, // Maximum number of rows to return, usefull for paging
	string[][] options, // See options below
	out FinderData data) // Search results

Finder type​

DIM

Search fields​

Field IDFields searched
0code and name
1code
2name

The method will return an array containing validation messages. If there are no errors, then the data parameter will contain the actual search result.

Options

OptionTypeDescription
office«office code»Restricts to the office.
levelenumeration: 1, 2, 3, 4, 5, 6Specifies the dimension level. Normally the level of fixed assets is level 3.
sectionfinancialsRestricts to financial or time & expenses dimensions.
dimtypeASTShows the fixed assets dimensions.
modifiedsincestring yyyyMMddHHmmss or yyyyMMddRestricts to dimensions modified after, on or at the specified date (and time).
group«group code»Specifies the dimension group (wildcards allowed).

Read​

Web service type: XML Web Services

XML​

Below example reads the settings of the fixed asset (AST) dimension EXAMPLE.

<read>
    <type>dimensions</type>
    <office>001</office>
    <dimtype>AST</dimtype>
    <code>EXAMPLE</code>
</read>

Create/Update/Delete​

If the dimension is not found it will be automatically created, otherwise it is updated. Set dimension/header/@status to deleted for deleting a dimension.

Root​

XML structure
<dimension>
    <financials></financials>
    <fixedassets></fixedassets>
    <groups></groups>
    <banks></banks>
</dimension>

Element name: dimension

NameDescription
dimensionContains information general to the dimension.
financialsContains the financial settings of the dimension.
fixedassetsContains the fixed asset settings of the dimension.
groupsContains the dimension groups the dimension is part of.
banksNot in use.

Dimension​

XML structure
<dimension>
    <office></office>
    <type></type>
    <code></code>
    <name></name>
    <shortname></shortname>
    <beginperiod></beginperiod>
    <beginyear></beginyear>
    <endperiod></endperiod>
    <endyear></endyear>
</dimension>

Element name: dimension

Property nameValueDescription
@statusactive
deleted
hide		For creating and updating status may be left empty. For deleting deleted should be used. In case a dimension that is used in a transaction is deleted, its status has been changed into hide. Hidden dimensions can be activated by using active.
officecodeOffice code.
typecodeDimension type. See Dimension type.
Dimension type of fixed assets is AST.
codecodeDimension code, must be compliant with the mask of the AST Dimension type.
uidstringUnique identification of the dimension.
Read-only attribute.
namestring(80)Name of the dimension.
shortnameNot in use.
inusetrue
false		Indicates whether the fixed asset is used in a financial transaction or not.
Read-only attribute.
behaviournormal
system
template		Determines the behaviour of dimensions.
Read-only attribute.
touchedintegerCount of the number of times the dimension settings are changed.
Read-only attribute.
beginperiodNot in use.
beginyearNot in use.
endperiodNot in use.
endyearNot in use.
websiteNot in use.
cocnumberNot in use.
vatnumberNot in use.
editdimensionnameNot in use.

Financials​

XML structure
<financials>
    <substitutionlevel></substitutionlevel>
    <substitutewith></substitutewith>
</financials>

Element name: financials

Property nameValueDescription
matchtypenotmatchable
matchable		The matchable value of the balance account.
Read-only attribute.
accounttypecodeFixed value inherit.
Read-only attribute.
subanalysetrue
false
maybe		Is subanalyses needed.
Read-only attribute.
duedaysNot in use.
levelintegerSpecifies the dimension level. Normally the level of fixed assets is level 3.
Read-only attribute.
payavailableNot in use.
meansofpaymentNot in use.
paycodeNot in use.
ebillingNot in use.
ebillmailNot in use.
substitutionlevelDimension level of the cost center.
substitutewithDimension code of the cost center.
relationsreferenceNot in use.
vattypeNot in use.
vatcodestring(16)Default VAT code.
vatobligatoryNot in use.
performancetypeNot in use.
collectmandateNot in use.
collectionschemaNot in use.

Fixed Assets​

XML structure
<fixedassets>
    <residualvalue></residualvalue>
    <stopvalue></stopvalue>
    <method></method>
    <beginperiod></beginperiod>
    <purchasedate></purchasedate>
    <selldate></selldate>
    <freetext1></freetext1>
    <freetext2></freetext2>
    <freetext3></freetext3>
    <freetext4></freetext4>
    <freetext5></freetext5>
    <nrofperiods></nrofperiods>
    <percentage></percentage>
    <lastdepreciation></lastdepreciation>
    <status></status>
    <translines>
        <...>
    </translines>
</fixedassets>

Element name: fixedassets

Property nameValueDescription
@lockedtrue
false		If the locked property of an element is set to true, it is not possible to change its value. The value of elements with the locked property set to false can be changed.
residualvaluemoneyThe residual value of the asset at the end of the depreciation duration.
stopvaluemoneyThe value future depreciation should stop at.
methodcodeThe asset method. See Asset methods.
beginperiodstringPeriod in YYYY/PP format. The period from which the depreciation to begin.
purchasedatedateThe purchase date of the asset.
selldatedateThe date the asset is sold.
freetext1stringFree text field 1 as set on the asset method.
freetext2stringFree text field 2 as set on the asset method.
freetext3stringFree text field 3 as set on the asset method.
freetext4stringFree text field 4 as set on the asset method.
freetext5stringFree text field 5 as set on the asset method.
nrofperiodsintegerThe number of periods over which the asset should be depreciated.
percentageintegerThe depreciation percentage.
lastdepreciationstringPeriod in YYYY/PP format. The period of the last depreciation of the asset.
statusToBeActivated
Active
Inactive
Sold		The status of the asset.
translinesnodeThe transactions of the purchase of the asset.

Transaction lines​

XML structure
<translines>
    <transline></transline>
</translines>

Element name: translines

Property nameDescription
translineThe transaction of the purchase of the asset.

Transaction line​

XML structure
<transline>
    <code></code>
    <number></number>
    <line></line>
    <amount></amount>
    <period></period>
    <dim1></dim1>
    <dim2></dim2>
    <dim3></dim3>
    <dim4></dim4>
    <dim5></dim5>
    <dim6></dim6>
</transline>

Element name: transline

Property nameValueDescription
codecodeTransaction type code.
numberintegerTransaction number.
lineintergerTransaction line number.
amountmoneyTransaction line amount.
periodstringPeriod in YYYY/PP format. Period of the transaction.
dim1stringDimension 1 of the tranaction line.
dim2stringDimension 2 of the tranaction line.
dim3stringDimension 3 of the tranaction line.
dim4stringDimension 4 of the tranaction line.
dim5stringDimension 5 of the tranaction line.
dim6stringDimension 6 of the tranaction line.

Groups​

XML structure
<groups>
    <group></group>
</groups>

Element name: groups

Property nameValueDescription
groupstring(16)Sets the dimension group. See Dimension group.

Banks​

Element name: banks

Not in use.

Example​

<dimension>
    <office>001</office>
    <type>AST</type>
    <name>John Deere 7000</name>
    <financials>
        <substitutionlevel>2</substitutionlevel>
        <substitutewith>00000</substitutewith>
    </financials>
    <fixedassets>
        <residualvalue>2500.00</residualvalue>
        <stopvalue>0.00</stopvalue>
        <method>MACHINE-5</method>
        <beginperiod>2014/01</beginperiod>
        <purchasedate>20140101</purchasedate>
        <freetext1>SN-89377433</freetext1>
        <nrofperiods>60</nrofperiods>
    </fixedassets>
    <groups>
        <group>E.0.0000</group>
    </groups>
</dimension>