getAssignments

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.

Input parameters

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

Response

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:

Field nameTypeDescription
attributeNameStringAttribute name
attributeTypeStringAttribute type
attributeValueStringAttribute value