Jump to

• Request
• Response
• Examples

Create inventories

post

/rest/ofscCore/v1/inventories

This operation creates inventories.

Request

Body ()

Root Schema : Create Inventory Request

Type: object

Title: Create Inventory Request

The schema of the request body parameters.

Show Source

• activityId: integer
  Title: Activity ID

  The unique identifier of the activity in Oracle Field Service.
• inventoryType: string
  Title: Inventory Type

  The type of the inventory as defined in Oracle Field Service. The inventory type can be serialized or non-serialized. If serialized, then it has a serial number. If non-serialized, then it does not have a serial number.
• quantity: number
  Title: Quantity

  The quantity of the inventory.
• resourceId: string
  Title: Resource ID

  The unique identifier of the resource in Oracle Field Service.
• serialNumber: string
  Title: Serial Number

  The unique serial number of the inventory.
• status: string
  Title: Status

  Allowed Values: [ "customer", "resource", "installed", "deinstalled" ]

  The status of the inventory. For example, if 'customer' is returned, then it indicates that the inventory is at the customer's site.

{
    "title":"Create Inventory Request",
    "description":"The schema of the request body parameters.",
    "type":"object",
    "properties":{
        "resourceId":{
            "type":"string",
            "description":"The unique identifier of the resource in Oracle Field Service.",
            "title":"Resource ID"
        },
        "status":{
            "type":"string",
            "enum":[
                "customer",
                "resource",
                "installed",
                "deinstalled"
            ],
            "description":"The status of the inventory. For example, if 'customer' is returned, then it indicates that the inventory is at the customer's site.",
            "title":"Status"
        },
        "serialNumber":{
            "type":"string",
            "description":"The unique serial number of the inventory.",
            "title":"Serial Number"
        },
        "quantity":{
            "type":"number",
            "description":"The quantity of the inventory.",
            "title":"Quantity"
        },
        "inventoryType":{
            "type":"string",
            "description":"The type of the inventory as defined in Oracle Field Service. The inventory type can be serialized or non-serialized. If serialized, then it has a serial number. If non-serialized, then it does not have a serial number.",
            "title":"Inventory Type"
        },
        "activityId":{
            "type":"integer",
            "description":"The unique identifier of the activity in Oracle Field Service.",
            "title":"Activity ID"
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

201 Response

This section describes the 201 status response for this operation.

Body ()

Root Schema : inventory

Type: object

Show Source

• status: string
  Title: Status

  Allowed Values: [ "customer", "resource", "installed", "deinstalled" ]

  The status of the specified inventory. For example, if 'customer' is returned, then it indicates that the inventory is at the customer's site.

{
    "allOf":[
        {
            "$ref":"#/definitions/inventoryWithoutStatus"
        }
    ],
    "properties":{
        "status":{
            "type":"string",
            "enum":[
                "customer",
                "resource",
                "installed",
                "deinstalled"
            ],
            "description":"The status of the specified inventory. For example, if 'customer' is returned, then it indicates that the inventory is at the customer's site.",
            "title":"Status"
        }
    }
}

Match All

Show Source

• object Inventory
  Title: Inventory

  The inventory that is installed or deinstalled at the customer's site during an activity.

{
    "allOf":[
        {
            "$ref":"#/definitions/inventoryWithoutStatus"
        }
    ],
    "properties":{
        "status":{
            "type":"string",
            "enum":[
                "customer",
                "resource",
                "installed",
                "deinstalled"
            ],
            "description":"The status of the specified inventory. For example, if 'customer' is returned, then it indicates that the inventory is at the customer's site.",
            "title":"Status"
        }
    }
}

Nested Schema : Inventory

Type: object

Title: Inventory

The inventory that is installed or deinstalled at the customer's site during an activity.

Show Source

• activityId: integer
  Title: Activity ID

  The activity ID to which the inventory is assigned.

  If the status for the inventory is set to resource, then the activity ID is not returned.

• exchangedInventoryId: integer
  Title: Exchanged Inventory ID

  The inventory ID that is returned when the resource exchanges an inventory with another resource.
• inventoryId: integer
  Title: Inventory ID

  The unique identifier of the inventory in Oracle Field Service.
• inventoryType: string
  Title: Inventory Type

  The inventory type specified in the request.
• quantity: number
  Title: Quantity

  The quantity of inventory specified in the request.
• resourceId: string
  Title: Resource ID

  The resource ID to which the inventory is assigned or the resource ID to which the activity (that has the inventory assigned to it) is assigned.
• serialNumber: string
  Title: Serial Number

  The serial number specified in the request.

{
    "title":"Inventory",
    "description":"The inventory that is installed or deinstalled at the customer's site during an activity.",
    "type":"object",
    "properties":{
        "resourceId":{
            "type":"string",
            "description":"The resource ID to which the inventory is assigned or the resource ID to which the activity (that has the inventory assigned to it) is assigned.",
            "title":"Resource ID"
        },
        "serialNumber":{
            "type":"string",
            "description":"The serial number specified in the request.",
            "title":"Serial Number"
        },
        "exchangedInventoryId":{
            "type":"integer",
            "description":"The inventory ID that is returned when the resource exchanges an inventory with another resource. ",
            "title":"Exchanged Inventory ID"
        },
        "quantity":{
            "x-nullable":true,
            "type":"number",
            "description":"The quantity of inventory specified in the request.",
            "title":"Quantity"
        },
        "inventoryType":{
            "x-nullable":true,
            "type":"string",
            "description":"The inventory type specified in the request.",
            "title":"Inventory Type"
        },
        "inventoryId":{
            "type":"integer",
            "description":"The unique identifier of the inventory in Oracle Field Service.",
            "title":"Inventory ID"
        },
        "activityId":{
            "type":"integer",
            "description":"The activity ID to which the inventory is assigned. <p>If the status for the inventory is set to resource, then the activity ID is not returned.</p>",
            "title":"Activity ID"
        }
    }
}

Default Response

This section describes the default error response for this operation.

Body ()

Root Schema : Error

Type: object

Show Source

• detail: string
  The detailed description of this error.
• status: string
  The HTTP status code of this error.
• title(required): string
  The brief description of this error.
• type(required): string
  The URL of the web page containing more details about this error.

{
    "properties":{
        "type":{
            "type":"string",
            "description":"The URL of the web page containing more details about this error."
        },
        "title":{
            "type":"string",
            "description":"The brief description of this error."
        },
        "status":{
            "type":"string",
            "description":"The HTTP status code of this error."
        },
        "detail":{
            "type":"string",
            "description":"The detailed description of this error."
        }
    },
    "required":[
        "type",
        "title"
    ]
}

Back to Top

Examples

The following example shows how to create inventory by submitting a POST request on the REST resource.

Example of Request Header

The following shows an example of the request header.

POST /rest/ofscCore/v1/inventories HTTP/1.0
Authorization: Basic c29hcEB5YW1hdG86MQ==
Host: etadev1f
Accept: */*

Example of Request Body

The following shows an example of the request body.

{
  "inventoryType": "NORMAL",
  "resourceId": "44001"
}

Example of Response Header

The following shows an example of the response header.

HTTP/1.1 201 Created
Server: nginx/1.6.2
Date: Fri, 24 Jul 2015 08:35:48 GMT
ContentType:
application/json; charset=utf8
Connection: close

Example of Response Body

The following example shows the contents of the response body in JSON format:

{
"inventoryId": 21258546,
"status": "provider",
"inventoryType": "NORMAL",
"quantity": 1,
"resourceId": "44001",
"links": [
{
"rel": "canonical",
"href": "https://etadev1f/rest/ofscCore/v1/inventories/21258546"
},
{
"rel": "describedby",
"href": "https://etadev1f/rest/ofscCore/v1/metadatacatalog/inventories"
}
]
}

Back to Top