services/persons/{uid}/services/new (POST)

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
taskThe service task code such as TR for translation or RV for revision. To discover all task types, see settings/tasks/codesstring, Mandatory



commentsOptional 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
currencyThe currency. A three letter code such as EUR or USD. See this method to get all currencies: settings/currencies/codesstring, 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.



Copyright Wordbee - Buzzin' Outside the Box since 2008