Hook up your own application with The Machine's functionality.

item.edit

This method let you edit the item with the given id.

You call this method with the following URL:

Parameters

Parameters are the data you will pass with the call.

api_token

Your secret identifier. You find your API Token under Account Overview in the Account section.

Rules: Required

id

The ID of the item.

Rules: Required.

description (optional)

The description of the item.

Rules: None.

qty (optional)

The quantity for the item.

Rules: Can only include numeric characters.

kind (optional)

The kind of the item.

Rules: Must be set to a supported kind. The supported kinds are "hour", "day", "service" and "product".

price (optional)

The price for the item.

Rules: Can only include numeric characters.

get (optional)

If this parameter is set the result sent back will be the edited item in XML data rather than the success message.

Rules: If parameter is used it must be set to "true". Otherwise it will be ignored.

Return Values

This is the result that will be passed back to you when you have sent a call.

Success

Success: Item edited.

The item was successfully edited.

If you have set the get parameter to "true" you will rather get the edited item in XML sent back to you. Like this:

<?xml version="1.0" encoding="utf-8"?>
<method request="item.get">
    <item>
        <id>204420</id>
        <description>Office Combo Kit</description>
        <qty>2</qty>
        <kind>products</kind>
        <price>349.00</price>
        <total>349.00</total>
    </item>
</method>
Error

Error: No data passed.

No data was passed to the method.

Error: API Token is invalid.

The API Token parameter is missing or is incorrectly entered.

Error: ID is invalid.

The ID parameter is missing or is incorrectly entered.

Error: Qty is invalid.

The Qty parameter is incorrectly entered.

Error: Kind is invalid.

The Kind parameter is incorrectly entered.

Error: Price is invalid.

The Price parameter is incorrectly entered.

Example

The example below is strictly a demonstration of the method and it's parameters. Methods should never be posted from a HTML form. They should be posted directly from your server script.

<form action="http://machine_id.invoicemachine.com/api/item.edit" method="post">
    <input type="hidden" name="api_token" value="c86cea54c71sbb05a5f8297bed641944">
    <input type="hidden" name="id" value="204420">
    <input type="hidden" name="qty" value="2">
</form>