Retrieve assignments.
Assignments module is an Erply feature for repair workshops. There are two different configurations: appliance repair and vehicle repair. API call getAppliances lists your appliance/vehicle database.
This API call returns error 1006 if assignment module is not enabled on this account.
| Parameter name | Description | Possible value | Required |
|---|---|---|---|
| assignmentID | Assignment ID. | integer | |
| applianceID | Appliance ID. | integer | |
| vehicleID | Vehicle ID. | integer | |
| number | Assignment number. | string | |
| customerName | Customer name. | string | |
| applianceSerialNumber | Appliance serial number. | string | |
| vehicleVin | Vehicle vin. | string | |
| searchAttributeName | Name of attribute to search from. Both "searchAttributeName" and "searchAttributeValue" have to be specified. Error 1030 will be returned if value is an array. | string | |
| searchAttributeValue | Attribute value to search for. Error 1030 will be returned if value is an array. | string | |
| changedSince | Retrieve only items that have been added or modified since the specified timestamp. Use it to keep a local database in sync with Erply. | Integer (Unix timestamp) | |
| recordsOnPage | Number of records API should return. By default 20, at most 100. | integer | |
| pageNo | API returns at most recordsOnPage items at a time. To retrieve the next recordsOnPage items, send a new request with pageNo incremented by one. By default, API returns "page 1". | integer |
| Field name | Type | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| assignmentID | integer | ID of assignment. | ||||||||||||
| assignmentNumber | integer | Number of assignment. | ||||||||||||
| groupID | integer | Assignment group | ||||||||||||
| groupName | string | |||||||||||||
| warehouseID | integer | Location, workshop or store. Location field has been added to assignments in Erply version 2013. | ||||||||||||
| createdUnixTime | integer | Unix timestamp. Timestamp (date and time) of when the assignment was created. | ||||||||||||
| receivedUnixTime | integer | Unix timestamp. Timestamp (date and time) of when the appliance/vehicle was brought in for repair. | ||||||||||||
| sourceQuoteID | integer | ID of a sales quote this assignment is based on. To get quotes via API, see getSalesDocuments. | ||||||||||||
| completed | Integer (1 or 0) | |||||||||||||
| bookerEmployeeID | integer | Salesperson ID who booked time for repair. | ||||||||||||
| bookerEmployeeName | string | Salesperson name who booked time for repair. | ||||||||||||
| receiverEmployeeID | integer | Salesperson ID who received the appliance/vehicle from customer. | ||||||||||||
| receiverEmployeeName | string | Salesperson name who received the appliance/vehicle from customer. | ||||||||||||
| returnedByEmployeeID | integer | Salesperson ID who returned the appliance/vehicle to the customer. | ||||||||||||
| returnedByEmployeeName | string | Salesperson name who returned the appliance/vehicle to the customer. | ||||||||||||
| commentsOnWorkDone | string | |||||||||||||
| commentsOnWorkLeftUndone | string | |||||||||||||
| applianceID | integer | ID of appliance. Appliance-specific attribute. Available only if appliance module is enabled on your account. | ||||||||||||
| applianceName | string | Name of appliance. Appliance-specific attribute. Available only if appliance module is enabled on your account. | ||||||||||||
| applianceSerialNumber | string | Serial number of appliance. Appliance-specific attribute. Available only if appliance module is enabled on your account. | ||||||||||||
| applianceStartDateOfWarranty | ISO date (yyyy-mm-dd) | Start date of warranty. Appliance-specific attribute. Available only if appliance module is enabled on your account. | ||||||||||||
| applianceEndDateOfWarranty | ISO date (yyyy-mm-dd) | End date of warranty. Appliance-specific attribute. Available only if appliance module is enabled on your account. | ||||||||||||
| customerID | integer | Customer ID. | ||||||||||||
| customerName | string | Customer name. | ||||||||||||
| customerEmail | string | Customer e-mail address. | ||||||||||||
| contactPerson | string | Contact person name. | ||||||||||||
| contactPersonPhone | string | Contact phone. | ||||||||||||
| vehicleID | integer | ID of vehicle. Vehicle-specific attribute. Available only if vehicle module is enabled on your account. | ||||||||||||
| vehicleLicencePlate | string | Licence plate of vehicle. Vehicle-specific attribute. Available only if vehicle module is enabled on your account. | ||||||||||||
| vehicleStartDateOfWarranty | ISO date (yyyy-mm-dd) | Start date of warranty. Vehicle-specific attribute. Available only if vehicle module is enabled on your account. | ||||||||||||
| vehicleEndDateOfWarranty | ISO date (yyyy-mm-dd) | End date of warranty. Vehicle-specific attribute. Available only if vehicle module is enabled on your account. | ||||||||||||
| vehicleHasAntiTheftBolts | Integer (1 or 0) | Vehicle-specific attribute. Available only if vehicle module is enabled on your account. | ||||||||||||
| testDrive | Integer (1 or 0) | Vehicle-specific attribute. Available only if vehicle module is enabled on your account. | ||||||||||||
| addWasherFluid | Integer (1 or 0) | Vehicle-specific attribute. Available only if vehicle module is enabled on your account. | ||||||||||||
| replaceWindshieldWipers | Integer (1 or 0) | Vehicle-specific attribute. Available only if vehicle module is enabled on your account. | ||||||||||||
| includedServiceBook | Integer (1 or 0) | Vehicle-specific attribute. Available only if vehicle module is enabled on your account. | ||||||||||||
| checkExtinguisher | Integer (1 or 0) | Vehicle-specific attribute. Available only if vehicle module is enabled on your account. | ||||||||||||
| replaceAirFilter | Integer (1 or 0) | Vehicle-specific attribute. Available only if vehicle module is enabled on your account. | ||||||||||||
| checkBodyWarranty | Integer (1 or 0) | Vehicle-specific attribute. Available only if vehicle module is enabled on your account. | ||||||||||||
| vehicleMileage | integer | Vehicle-specific attribute. Available only if vehicle module is enabled on your account. | ||||||||||||
| customerComments | array | Each array element contains a string comment attribute. | ||||||||||||
| assignmentRows | array | The item has the following attributes: productID - Integer - ID of the product serviceID - Integer - ID of the service itemName - String - custom name for product or service (if it was set) price - Decimal amount - Decimal discount - Decimal firstEmployeeID - Integer secondEmployeeID - Integer thirdEmployeeID - Integer firstEmployeeTime - Decimal secondEmployeeTime - Decimal thirdEmployeeTime - Decimal. |
||||||||||||
| lastModified | Unix timestamp. | |||||||||||||
| attributes | array | Additional attributes. Each item looks like this:
|