API

Production APIs

POST production/resource-groups

Creates a new production resource group

HTTP method POST
URI https://api.rambase.net/production/resource-groups
Supported formats Xml, Html, Json (ex. $format=json)
Successful HTTP status code 201
API resource identifier 3355, version 15

The following body must be added to the request. Mouse over fieldnames for description and other useful information about the fields. Note that fields in bold are required/mandatory.

Format:
1
<ProductionResourceGroup>
2
     <Name
Name

Required/mandatory field

Name of production resource group

>
{String}</Name>
3
     <AllowManHours
AllowManHours

True if man hours can be added to the work log of work order operations

Default value: false

This field is optional.

>
{Boolean}</AllowManHours>
4
     <AllowMultipleOperators
AllowMultipleOperators

True if multiple operators can work with one work order operation.

Default value: false

This field is optional.

>
{Boolean}</AllowMultipleOperators>
5
     <CalculateCostByPlannedHours
CalculateCostByPlannedHours

(RW) Value = 1: Operation cost is calculated based on planned operation hours. Value = 0 (default): Operation cost is calculated by logged hours.

Default value: false

This field is optional.

>
{Boolean}</CalculateCostByPlannedHours>
6
     <ShortName
ShortName

Shortname for resource group.

This field is optional.

>
{String}</ShortName>
7
     <Description
Description

Description of production resource group

This field is optional.

>
{String}</Description>
8
     <Type
Type

Defines the CLASS of the resource group

Applicable domain values can be found here

This field is optional.

>
{String}</Type>
9
     <EstimatedHourlyRate
EstimatedHourlyRate

This field is optional.

>
10
          <Setup
Setup

Estimated rate per hour for operations setup step, given in system currency.

Minimum value: 0

This field is optional.

>
{Decimal}</Setup>
11
          <Processing
Processing

Estimated rate per hour for operations main step, given in system currency.

Minimum value: 0

This field is optional.

>
{Decimal}</Processing>
12
          <CleanUp
CleanUp

Estimated rate per hour for operations post step, given in system currency.

Minimum value: 0

This field is optional.

>
{Decimal}</CleanUp>
13
     </EstimatedHourlyRate>
14
</ProductionResourceGroup>
1
{
2
     "productionResourceGroup": {
3
          "name
Name

Required/mandatory field

Name of production resource group

":
"{String}",
4
          "allowManHours
AllowManHours

True if man hours can be added to the work log of work order operations

Default value: false

This field is optional.

":
"{Boolean}",
5
          "allowMultipleOperators
AllowMultipleOperators

True if multiple operators can work with one work order operation.

Default value: false

This field is optional.

":
"{Boolean}",
6
          "calculateCostByPlannedHours
CalculateCostByPlannedHours

(RW) Value = 1: Operation cost is calculated based on planned operation hours. Value = 0 (default): Operation cost is calculated by logged hours.

Default value: false

This field is optional.

":
"{Boolean}",
7
          "shortName
ShortName

Shortname for resource group.

This field is optional.

":
"{String}",
8
          "description
Description

Description of production resource group

This field is optional.

":
"{String}",
9
          "type
Type

Defines the CLASS of the resource group

Applicable domain values can be found here

This field is optional.

":
"{String}",
10
          "estimatedHourlyRate
EstimatedHourlyRate

This field is optional.

":
{
11
               "setup
Setup

Estimated rate per hour for operations setup step, given in system currency.

Minimum value: 0

This field is optional.

":
"{Decimal}",
12
               "processing
Processing

Estimated rate per hour for operations main step, given in system currency.

Minimum value: 0

This field is optional.

":
"{Decimal}",
13
               "cleanUp
CleanUp

Estimated rate per hour for operations post step, given in system currency.

Minimum value: 0

This field is optional.

":
"{Decimal}"
14
          }
15
     }
16
}

The query string is placed after the resource URL, seperated with a questionmark (?). The query string is composed of a series of query parameters with values. See the page about query parameters on how to use these parameters.

$access_token String, optional After successful login you get an access token which needs to be provided in all API requests. Even though it is possible to pass this token as query parameter, we recommended passing it using the HTTP request header as described in Authorization. Note that all access tokens have an expiration time.
$db String, optional Set the database/company for the request
$useMinimumVersion Integer, optional Used to run a new version of an API resource when your API client is running a deprecated API resource. See the Breaking changes page for more information.
$showDomainDescriptions Boolean, optional Set to "true" to include domain descriptions for fields using domain values. See the Domain values page for more information. Default value is false.
$lang String, optional Specifies the language used in the response, following the 3-letter ISO-639-1 [lll]

Read more about filters and sorting on how to use filter parameters and named filters.

Read more about filters and sorting on how to use sortable parameters

Requesting this resource will yield the following response. Mouse over fieldnames (or fieldgroups) for descriptions and other useful information about the fields.

Please note that some fields may be removed from the response, based on user roles/duties/permissions.

Format:
1
<ProductionResourceGroup>
2
     <ProductionResourceGroupId
ProductionResourceGroupId

Production resource group identifier

>
{Integer}</ProductionResourceGroupId>
3
     <Status
Status

Status of production resource group

Possible domain values can be found here

>
{Integer}</Status>
4
     <CreatedAt
CreatedAt

Date and time of creation

>
{Datetime}</CreatedAt>
5
     <Name
Name

Name of production resource group

>
{String}</Name>
6
     <ShortName
ShortName

Shortname for resource group.

>
{String}</ShortName>
7
     <Description
Description

Description of production resource group

>
{String}</Description>
8
     <Type
Type

Defines the CLASS of the resource group

Possible domain values can be found here

>
{String}</Type>
9
     <AllowManHours
AllowManHours

True if man hours can be added to the work log of work order operations

>
{Boolean}</AllowManHours>
10
     <AllowMultipleOperators
AllowMultipleOperators

True if multiple operators can work with one work order operation.

>
{Boolean}</AllowMultipleOperators>
11
     <CalculateCostByPlannedHours
CalculateCostByPlannedHours

(RW) Value = 1: Operation cost is calculated based on planned operation hours. Value = 0 (default): Operation cost is calculated by logged hours.

>
{Boolean}</CalculateCostByPlannedHours>
12
     <EstimatedHourlyRate>
13
          <Currency
Currency

Three character code following the ISO 4217 standard

>
{String}</Currency>
14
          <Setup
Setup

Estimated rate per hour for operations setup step, given in system currency.

>
{Decimal}</Setup>
15
          <Processing
Processing

Estimated rate per hour for operations main step, given in system currency.

>
{Decimal}</Processing>
16
          <CleanUp
CleanUp

Estimated rate per hour for operations post step, given in system currency.

>
{Decimal}</CleanUp>
17
     </EstimatedHourlyRate>
18
</ProductionResourceGroup>
1
{
2
     "productionResourceGroup": {
3
          "productionResourceGroupId
ProductionResourceGroupId

Production resource group identifier

":
"{Integer}",
4
          "status
Status

Status of production resource group

Possible domain values can be found here

":
"{Integer}",
5
          "createdAt
CreatedAt

Date and time of creation

":
"{Datetime}",
6
          "name
Name

Name of production resource group

":
"{String}",
7
          "shortName
ShortName

Shortname for resource group.

":
"{String}",
8
          "description
Description

Description of production resource group

":
"{String}",
9
          "type
Type

Defines the CLASS of the resource group

Possible domain values can be found here

":
"{String}",
10
          "allowManHours
AllowManHours

True if man hours can be added to the work log of work order operations

":
"{Boolean}",
11
          "allowMultipleOperators
AllowMultipleOperators

True if multiple operators can work with one work order operation.

":
"{Boolean}",
12
          "calculateCostByPlannedHours
CalculateCostByPlannedHours

(RW) Value = 1: Operation cost is calculated based on planned operation hours. Value = 0 (default): Operation cost is calculated by logged hours.

":
"{Boolean}",
13
          "estimatedHourlyRate": {
14
               "currency
Currency

Three character code following the ISO 4217 standard

":
"{String}",
15
               "setup
Setup

Estimated rate per hour for operations setup step, given in system currency.

":
"{Decimal}",
16
               "processing
Processing

Estimated rate per hour for operations main step, given in system currency.

":
"{Decimal}",
17
               "cleanUp
CleanUp

Estimated rate per hour for operations post step, given in system currency.

":
"{Decimal}"
18
          }
19
     }
20
}

List of available operations/actions for this resource.
See the operations documentation for more information about API operations.

Possible error codes the response might return:

Error 106127 HTTP 404 Resource Hour Rate not found
Error 101079 HTTP 400 Mismatch in size of revision parameters
Error 103379 HTTP 400 Update not allowed on active resource.
Error 103424 HTTP 400 Not a valid resource to update.
Error 100924 HTTP 400 Please remove all members before changing category
Error 103374 HTTP 400 Name for resource must be unique.
Error 103435 HTTP 400 You can only add a member that has an active status
Error 104093 HTTP 400 Cannot add resource group as member of resource group.
Error 104092 HTTP 404 Resource group does not exist.
Error 104541 HTTP 400 You cannot disable this setting when production resource has got at least one active work order operation group
Error 105799 HTTP 400 You cannot disable this setting when distirbute time on grouping is active
Error 105783 HTTP 400 You cannot enable this setting when production resource allowgrouping is not set
Error 104370 HTTP 400 Rate value should be greater or equal to zero