API

RamBase REST APIs

PUT production/resources/{productionResourceId}

PUT method for Production/Resource

HTTP method PUT
URI https://api.rambase.net/production/resources/{productionResourceId}
Supported formats Xml, Html, Json (ex. $format=json)
- URI parameter {productionResourceId} Production resource identifier
Integer, minimum 100000
Custom fields Custom fields supported
Successful HTTP status code 200
API resource identifier 3297, version 29

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
<ProductionResource
ProductionResource

This field is optional.

>
2
     <Name
Name

Name of production resource

This field is optional.

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

Short name of production resource

This field is optional.

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

Description of production resource

This field is optional.

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

Defines the CLASS of the resource.

Applicable domain values can be found here

This field is optional.

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

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

This field is optional.

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

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

This field is optional.

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

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

This field is optional.

>
{Boolean}</CalculateCostByPlannedHours>
9
     <AssignToRestrictedStockLocations
AssignToRestrictedStockLocations

If is set to 1 then the program will check if the production work order are assigned to goods reception items in the restricted stock locations. If not then a “swap” in assignments is done to a goods reception item which has enough goods in the restricted stock locations. If this can not be done then an error message is displayed.

This field is optional.

>
{Boolean}</AssignToRestrictedStockLocations>
10
     <WorkOrderOperationGrouping
WorkOrderOperationGrouping

This field is optional.

>
11
          <AllowGrouping
AllowGrouping

Allows resource to use work order operation grouping

This field is optional.

>
{Boolean}</AllowGrouping>
12
          <DistributeHours
DistributeHours

If set to 1 the time logged on the operation is distributed on all woo's.

This field is optional.

>
{Boolean}</DistributeHours>
13
     </WorkOrderOperationGrouping>
14
     <HourlyRates
HourlyRates

This field is optional.

>
15
          <Setup
Setup

Rate per hour for operations setup step.

Minimum value: 0

This field is optional.

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

Rate per hour for operations step

Minimum value: 0

This field is optional.

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

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

Minimum value: 0

This field is optional.

>
{Decimal}</CleanUp>
18
     </HourlyRates>
19
     <ProductionResourceGroup
ProductionResourceGroup

This field is optional.

>
20
          <ProductionResourceGroupId
ProductionResourceGroupId

Production resource group identifier

Minimum value: 100000

This field is optional.

>
{Integer}</ProductionResourceGroupId>
21
     </ProductionResourceGroup>
22
     <Condition
Condition

This field is optional.

>
23
          <Code
Code

A number which indicates production resource state, 0=OK, 10=warning, 20=stopped

Applicable domain values can be found here

This field is optional.

>
{Integer}</Code>
24
          <Note
Note

A description which explains a reason for setting production resource state

This field is optional.

>
{String}</Note>
25
     </Condition>
26
</ProductionResource>
1
{
2
     "productionResource
ProductionResource

This field is optional.

":
{
3
          "name
Name

Name of production resource

This field is optional.

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

Short name of production resource

This field is optional.

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

Description of production resource

This field is optional.

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

Defines the CLASS of the resource.

Applicable domain values can be found here

This field is optional.

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

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

This field is optional.

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

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

This field is optional.

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

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

This field is optional.

":
"{Boolean}",
10
          "assignToRestrictedStockLocations
AssignToRestrictedStockLocations

If is set to 1 then the program will check if the production work order are assigned to goods reception items in the restricted stock locations. If not then a “swap” in assignments is done to a goods reception item which has enough goods in the restricted stock locations. If this can not be done then an error message is displayed.

This field is optional.

":
"{Boolean}",
11
          "workOrderOperationGrouping
WorkOrderOperationGrouping

This field is optional.

":
{
12
               "allowGrouping
AllowGrouping

Allows resource to use work order operation grouping

This field is optional.

":
"{Boolean}",
13
               "distributeHours
DistributeHours

If set to 1 the time logged on the operation is distributed on all woo's.

This field is optional.

":
"{Boolean}"
14
          },
15
          "hourlyRates
HourlyRates

This field is optional.

":
{
16
               "setup
Setup

Rate per hour for operations setup step.

Minimum value: 0

This field is optional.

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

Rate per hour for operations step

Minimum value: 0

This field is optional.

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

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

Minimum value: 0

This field is optional.

":
"{Decimal}"
19
          },
20
          "productionResourceGroup
ProductionResourceGroup

This field is optional.

":
{
21
               "productionResourceGroupId
ProductionResourceGroupId

Production resource group identifier

Minimum value: 100000

This field is optional.

":
"{Integer}"
22
          },
23
          "condition
Condition

This field is optional.

":
{
24
               "code
Code

A number which indicates production resource state, 0=OK, 10=warning, 20=stopped

Applicable domain values can be found here

This field is optional.

":
"{Integer}",
25
               "note
Note

A description which explains a reason for setting production resource state

This field is optional.

":
"{String}"
26
          }
27
     }
28
}

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.
$showCustomFields Boolean, optional Set to "true" to include custom fields. Default value is false.

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. Fields colored in grey is expandable fields.

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

Format:
1
1

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