To create a new service for a person/user.
Note that person-level services are only supported for inhouse users and client users. The latter allow to assign work to users at the client.
URL
(POST) /api/services/persons/{uid}/services/new
PARAMETERS
URL parameters are:
|
uid |
The ID of a user/person. This must be an inhouse user or a user attached to a client. |
Integer, Mandatory |
The body must include a JSON object with the properties below.
|
src |
The source language code of the service. The special code "*" is a placeholder for any language: The service can be used for any source language. To discover all languages see settings/languages |
string, Mandatory |
|
trg |
The target language code of the service. The special code "*" is a placeholder for any language: The service can be used for any source language. |
string, Mandatory |
|
task |
The service task code such as TR for translation or RV for revision. To discover all task types, see settings/tasks/codes |
string, Mandatory |
|
|
|
|
|
comments |
Optional internal comments (never visible to external users or unauthorized internals). |
string?, Optional |
|
rating |
Optional rating from 0 (not set) to 6 (best). Default if not specified: 3 |
int, Optional |
|
|
|
|
|
unit |
The unit that will be costed. Such as WD (words) or CH (characters). See this API to obtain a list of all units: Price units |
string, Mandatory |
|
unitsCount |
Indicates the number of units (unit) that the service amount includes. In most cases this will be 1, but not in all: Examples: "20 cents per 1 word", "20 cents per 15 characters", etc. Default if not specified: 1 |
int, Optional |
|
currency |
The currency. A three letter code such as EUR or USD. See this method to get all currencies: settings/currencies/codes |
string, Mandatory |
|
amount |
Optional service amount. Services can be defined without an amount (null value). Default if not specified: null |
decimal?, Optional |
|
|
|
|
|
leadHours |
Used for deadline calculation. Defines the number of hours upon transmission of a request until the time in hours the work typically starts. Default if not specified: 0 (no lead time) |
int, Optional |
|
unitsPerDay |
Used for deadline calculation. Defines the number of units the service provider can do in a work day. Default if not specified: 0 (not specified) |
int, Optional |
RESULTS
The method returns the updated service.
The properties are the same as described here: services/persons/{uid}/services/{svcid}
ACCESS RIGHTS
See Services.