services/pricelists/{plid}/services/{svcid}

Gets full details of a price list service.

A service is typically a source language, target language, type of work and some unit price information.

URL

(GET) /api/services/pricelists/{plid}/services/{svcid}

PARAMETERS

URL parameters are:

plid	The price list ID	Integer, Mandatory
svcid	The service ID	Integer, Mandatory

RESULTS

The service properties are:

id		string
svcid	The unique service ID.	int
plid	The unique price list ID.	int
id	A unique identifier that concatenates price list ID and service ID. The format is: C{price list ID}-{service ID} : For master, client or supplier company price list services P{price list ID}-{service ID} : For services assigned to internal workers This ID is redundant. We show it in Wordbee Translator for convenience for the user.
cid	The company which owns the price list to which this service is attached. Internal and client price lists are always owned by the master company ("My company"): The master company provides the services to clients! Supplier price lists are always owned by supplier companies. The supplier companies provide services to the master company ("My company") and which then resells services to its clients.	int
pid	If the service is assigned to a specific person and not a company, then this is the person's unique ID.	int?
inherited	True if this service is inherited from the parent price list or explicitly defined in the present price list. Please check inheritance options in this API method: services/pricelists/{plid}	bool
disabled	Boolean. If true then this service is currently disabled.	bool

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
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
srct	The source language title	string
trgt	The target language title	string
task	The service task code such as TR for translation or RV for revision. To discover all task types, see settings/tasks/codes	string
taskt	The task print title, such as "Translation", "Revision", etc.	string

code	An optional product code. Empty string if no code.	string
comments	Optional internal comments (never visible to external users or unauthorized internals)	string?
rating	A user defined service rating from 0 (not set) to 6 (best).	int
ratingManager	The average rating given by managers and over the past weeks. This information is automatically populated from the Wordbee business analytics tools and the rating features. 0 means no data available. 1 is the lowest and 6 the highest rating.	decimal

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
unitt	The unit print title.	string
unitsCount	Indicates the number of units (unit) that the service amount includes. In most cases this will be 1, but not in all, see below: Examples: "20 cents per 1 word", "20 cents per 15 characters", etc.	int
amount	The service amount. It can be null if no amount is specified.	decimal?
amountt	A user friendly text with the service price. Null if amount is null. For example: "EUR 0.01 per Word" "USD 0.2 per 50 Characters"	string?
currency	The three letter currency code such as EUR or USD.	string
currencySymbol	The currency symbol such as $.	string

	Deadline calculation
leadHours	Used for deadline calculation. Defines the number of hours upon transmission of a request until the time in hours the work typically starts. 0 if not set or no lead time.	int
unitsPerDay	Used for deadline calculation. Defines the number of units the service provider can do in a work day. 0 if not set or no lead time.	int

	Discounts
discountMode	Defines how discounts are calculated for this specific service: No : No discounts PriceList : The discounts defined in the price list do apply Custom : The service defines its own specific discounts All the below properties apply to Custom mode only.	string
discountModeType	A numeric value for the discount mode. This can be disregarded.	int?
discountPretrans100	Optional. Discount for 100% pretranslations. A value between 0 and 100. Applicable only if mode is "Custom".	decimal?
discountPretrans110	Optional. Discount for 110% (perfect) pretranslations. A value between 0 and 100. Applicable only if mode is "Custom".	decimal?
discountPretransMT	Optional. Discount for machine translations. A value between 0 and 100. Applicable only if mode is "Custom".	decimal?
discountPretransFuzzy	Optional. Discount for fuzzy pretranslations, i.e. pretranslations at below 100% leveraging similarity. A value between 0 and 100. Applicable only if mode is "Custom".	decimal?
discountMatch1 discountMatch2 ... discountMatch6	Optional. Discount for fuzzy (untranslated) matches or repetitions. The respective fuzzy interval (1 to 6) must be defined in the price list.	decimal?

	Backup service
backupServiceId	Optional service ID that shall be used by a manager if the present service is not available. Typically the backup service points to a price list of an alternative supplier.	int?
backupPriceListId	The price list of the backup service, see above.	int?

	Custom fields
cfser	An array with all the service level custom fields. The array elements each have these properties: id: The custom field ID composed of the field domain (always 9) and the sequential number of the custom field value: The value Example: CODE `"cfser": [ { "id": "9-1", "value": "Alpha" }, { "id": "9-6", "value": "No" } ]` See this API to obtain a list of all defined custom fields: settings/customfields	object[]
cfser1, cfser2...	Custom fields as separate properties. Note that these properties contain the raw unprocessed custom field values, whereas cfser are prepared for display. For example, a boolean custom field will contain null/"" in cfser1 but show "No" in cfser (if the field is mandatory).

	Changes
changeUserId	The user who created or last updated this service.	int
changeDate	Date of last change of this service.	datetime

	Price list
pricelist	The price list to which the service belongs. See this page for property details: services/pricelists/{plid}	object

EXAMPLES

The following example is for a manager user accessing a job which is proposed to him/her. As a manager, the user has management level actions as well.

CODE

{
    "id": "C549-1025",
    "svcid": 1025,
    "plid": 549,
    "cid": 540,
    "pid": null,
    "inherited": false,
    "disabled": false,
    "src": "en",
    "trg": "*",
    "srct": "English (en)",
    "trgt": "(Any language)",
    "task": "RV",
    "taskt": "Revision",
    "code": "mycode2",
    "comments": "my comments",
    "rating": 2,
    "ratingManager": 0.00,
    "unit": "WD",
    "unitt": "Word(s)",
    "currency": "EUR",
    "currencySymbol": "€",
    "unitsCount": 1,
    "amount": null,
    "amountText": null,
    "leadHours": 20,
    "unitsPerDay": 6000,
    "discountMode": "Custom",
    "discountModeType": null,
    "discountPretrans100": 40.123400,
    "discountPretrans110": null,
    "discountPretransMT": null,
    "discountPretransFuzzy": 3.000000,
    "discountMatch1": 4.000000,
    "discountMatch2": 5.000000,
    "discountMatch3": 6.000000,
    "discountMatch4": 7.000000,
    "discountMatch5": 0.000000,
    "discountMatch6": null,
    "backupServiceId": 1024,
    "backupPriceListId": 549,
    "changeUserId": 562,
    "changeDate": "2021-06-22T10:43:21.02Z",
    "cfser": [
        {
            "id": "9-1",
            "value": null
        },
        {
            "id": "9-2",
            "value": "No"
        }
    ],
    "cfser1": null,
    "cfser2": "No",
    "pricelist": { ... }
}

ACCESS RIGHTS

See Services.