API - Project Manage / Add Item


Resource:
/acumulus/stable/projects/projectitem_manage.php
Since API:
Authentication:
API user
Communication:
Basic submit, including below structure

Submit

<?xml version="1.0" encoding="UTF-8"?>
<myxml>
    ...
    <projectitem>
        <projectid></projectid>
        <projectitemid></projectitemid>
        <projectitemnature></projectitemnature>
        <projectitemname></projectitemname>
        <projectitemstartdate></projectitemstartdate>
        <projectitemenddate></projectitemenddate>
        <projectitemprice></projectitemprice>
        <projectitemminutes></projectitemminutes>
        <projectitemquantity></projectitemquantity>
        <projectitemvatrate></projectitemvatrate>
        <projectitemnotes></projectitemnotes>
        <projectitemstatus></projectitemstatus>
        <projectitementryid></projectitementryid>
        <projectitemdelete></projectitemdelete>
    </projectitem>
</myxml>

projectid mandatory
Unique numeric identifier for project.

projectitemid mandatory / non mandatory
Unique numeric identifier for project item. Leave empty when adding a new projectitem to a project or include when updating or deleting a current project item.

projectitemnature
Numeric identifier for the nature or type of item. Defaults to 2.

Option
Description
1
Product
2
Service at an hourly rate DEFAULT
3
Service at a fixed price

projectitemname
Descriptive name for the item within the project.

projectitemstartdate
Start date of the item. Mainly useful with billable services or for tracking applied effort. Use YYYY-MM-DD format.

projectitemenddate
End date of the item. Mainly useful with billable services or for tracking applied effort. Use YYYY-MM-DD format.

projectitemprice
Price of the item. Up to 4 decimals.

projectitemminutes
Amount of minutes.

projectitemquantity
Amount of items.

projectitemvatrate
Applicable VAT percentage for the project item. Within range of 0 to 100. Use -1 when VAT is not applicable. Up to 2 decimals.

projectitemnotes
Internal notes applicable to the item.

projectitemstatus
Numeric identifier for the status of the item.

Option
Description
1
Planned
2
Completed
3
Cancelled
4
Active

projectitementryid
Reference an entryid associated with an already available invoice allowing to mark the item as billed. Please note that this is only a mark and not a trigger in any way.

projectitemdelete
Numeric value to indicate deletion. Defaults to 0.

Option
Description
0
Do not delete item DEFAULT
1
Delete item

Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
    ...
    <projectitem>
        <projectitemid></projectitemid>
        <projectitemproc></projectitemproc>
    </projectitem>
</response>

projectitemid
Added or altered project item identifier.

projectitemproc
Action executed. Usually either updated, added or deleted.