Create or update an array of entitlement

put

https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/v1/entitlements

Request

There are no request parameters for this operation.

Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: array
Minimum Number of Items: 1
Maximum Number of Items: 50
Show Source
Nested Schema : EntitlementOracle
Type: object
Title: EntitlementOracle
Show Source
Nested Schema : associatedProducts
Type: array
Show Source
Nested Schema : benefits
Type: array
Show Source
Nested Schema : metrics
Type: array
Show Source
Nested Schema : pricelist
Type: array
Show Source
Nested Schema : ProjectRef
Type: object
Title: ProjectRef
Project Reference
Show Source
Nested Schema : EntitlementQuantityOracle
Type: object
Title: EntitlementQuantityOracle
A number and unit representing entitlement unit
Show Source
Nested Schema : TimePeriod
Type: object
Title: TimePeriod
The period for which the productOffering is valid
Show Source
Nested Schema : AssociatedProductsEntitlementsOracle
Type: object
Title: AssociatedProductsEntitlementsOracle
The products which are assosiated to entitlement, benefit or conditions
Show Source
Nested Schema : EntitlementsBenefitsOracle
Type: object
Title: EntitlementsBenefitsOracle
Entitlement benefits.
Show Source
Nested Schema : entitlementConditionsGroup
Type: array
Show Source
Nested Schema : productOfferingPrice
Type: array
Show Source
  • ProductOfferingPriceRefOracle
    Title: ProductOfferingPriceRefOracle
    ProductPriceOffering reference. An amount, usually of money, that is asked for or allowed when a ProductOffering is bought, rented, or leased
Nested Schema : products
Type: array
Show Source
Nested Schema : EntitlementConditionsGroupOracle
Type: object
Title: EntitlementConditionsGroupOracle
The group of the condition for the entitlement.The logical relationship between different groups is decided by the ???relationTypeInGroup???.
Show Source
Nested Schema : condition
Type: array
Show Source
Nested Schema : products
Type: array
Show Source
Nested Schema : EntitlementConditionOracle
Type: object
Title: EntitlementConditionOracle
Condition of the entitlement.
Show Source
Nested Schema : ProductOfferingPriceRefOracle
Title: ProductOfferingPriceRefOracle
ProductPriceOffering reference. An amount, usually of money, that is asked for or allowed when a ProductOffering is bought, rented, or leased
Match All
ProductPriceOffering reference. An amount, usually of money, that is asked for or allowed when a ProductOffering is bought, rented, or leased
ProductPriceOffering reference. An amount, usually of money, that is asked for or allowed when a ProductOffering is bought, rented, or leased
Show Source
Nested Schema : ProductOfferingPriceRef
Type: object
Title: ProductOfferingPriceRef
ProductPriceOffering reference. An amount, usually of money, that is asked for or allowed when a ProductOffering is bought, rented, or leased
Show Source
Nested Schema : ProductOfferingPriceRefOracle-allOf[1]
Type: object
Show Source
  • Allowed Values: [ "ALL", "ONE_TIME", "RECURRING", "USAGE" ]
    Bring in a open ended definition of alteration that specifies how price plan applicable to the offer
  • Used to indicate whether the referred price is the flat price for a bundle (true) or not(false).
Nested Schema : EntitlementMetricsOracle
Type: object
Title: EntitlementMetricsOracle
Entitlement Metrics
Show Source
Nested Schema : EntitlementMetricsQuantityOracle
Type: object
Title: EntitlementMetricsQuantityOracle
A number and unit representing entitlement metrics quantity
Show Source
  • A quantity of something, typically the total of a thing or things in number.
  • Allowed Values: [ "ENTL_MTCS_UNT_PRCT", "ENTL_MTCS_UNT_HRS", "ENTL_MTCS_UNT_MTS", "ENTL_MTCS_UNT_PNTS", "ENTL_MTCS_UNT_DAYS", "ENTL_MTCS_UNT_SCDS" ]
    The unit of measure for the quantity.
Nested Schema : PriceListRefOracle
Type: object
Title: PriceListRefOracle
Pricelist reference.
Show Source
Back to Top

Response

Supported Media Types

200 Response

Your request is successful and the resources have been created or updated.
Body ()
Root Schema : schema
Type: array
Show Source
Nested Schema : EntitlementOracle
Type: object
Title: EntitlementOracle
Show Source
Nested Schema : associatedProducts
Type: array
Show Source
Nested Schema : benefits
Type: array
Show Source
Nested Schema : metrics
Type: array
Show Source
Nested Schema : pricelist
Type: array
Show Source
Nested Schema : ProjectRef
Type: object
Title: ProjectRef
Project Reference
Show Source
Nested Schema : EntitlementQuantityOracle
Type: object
Title: EntitlementQuantityOracle
A number and unit representing entitlement unit
Show Source
Nested Schema : TimePeriod
Type: object
Title: TimePeriod
The period for which the productOffering is valid
Show Source
Nested Schema : AssociatedProductsEntitlementsOracle
Type: object
Title: AssociatedProductsEntitlementsOracle
The products which are assosiated to entitlement, benefit or conditions
Show Source
Nested Schema : EntitlementsBenefitsOracle
Type: object
Title: EntitlementsBenefitsOracle
Entitlement benefits.
Show Source
Nested Schema : entitlementConditionsGroup
Type: array
Show Source
Nested Schema : productOfferingPrice
Type: array
Show Source
  • ProductOfferingPriceRefOracle
    Title: ProductOfferingPriceRefOracle
    ProductPriceOffering reference. An amount, usually of money, that is asked for or allowed when a ProductOffering is bought, rented, or leased
Nested Schema : products
Type: array
Show Source
Nested Schema : EntitlementConditionsGroupOracle
Type: object
Title: EntitlementConditionsGroupOracle
The group of the condition for the entitlement.The logical relationship between different groups is decided by the ???relationTypeInGroup???.
Show Source
Nested Schema : condition
Type: array
Show Source
Nested Schema : products
Type: array
Show Source
Nested Schema : EntitlementConditionOracle
Type: object
Title: EntitlementConditionOracle
Condition of the entitlement.
Show Source
Nested Schema : ProductOfferingPriceRefOracle
Title: ProductOfferingPriceRefOracle
ProductPriceOffering reference. An amount, usually of money, that is asked for or allowed when a ProductOffering is bought, rented, or leased
Match All
ProductPriceOffering reference. An amount, usually of money, that is asked for or allowed when a ProductOffering is bought, rented, or leased
ProductPriceOffering reference. An amount, usually of money, that is asked for or allowed when a ProductOffering is bought, rented, or leased
Show Source
Nested Schema : ProductOfferingPriceRef
Type: object
Title: ProductOfferingPriceRef
ProductPriceOffering reference. An amount, usually of money, that is asked for or allowed when a ProductOffering is bought, rented, or leased
Show Source
Nested Schema : ProductOfferingPriceRefOracle-allOf[1]
Type: object
Show Source
  • Allowed Values: [ "ALL", "ONE_TIME", "RECURRING", "USAGE" ]
    Bring in a open ended definition of alteration that specifies how price plan applicable to the offer
  • Used to indicate whether the referred price is the flat price for a bundle (true) or not(false).
Nested Schema : EntitlementMetricsOracle
Type: object
Title: EntitlementMetricsOracle
Entitlement Metrics
Show Source
Nested Schema : EntitlementMetricsQuantityOracle
Type: object
Title: EntitlementMetricsQuantityOracle
A number and unit representing entitlement metrics quantity
Show Source
  • A quantity of something, typically the total of a thing or things in number.
  • Allowed Values: [ "ENTL_MTCS_UNT_PRCT", "ENTL_MTCS_UNT_HRS", "ENTL_MTCS_UNT_MTS", "ENTL_MTCS_UNT_PNTS", "ENTL_MTCS_UNT_DAYS", "ENTL_MTCS_UNT_SCDS" ]
    The unit of measure for the quantity.
Nested Schema : PriceListRefOracle
Type: object
Title: PriceListRefOracle
Pricelist reference.
Show Source

400 Response

Your request couldn't be processed because it contains missing or invalid information, such as a validation error on an input field, a missing required value, and so forth.
Body ()
Root Schema : schema
Type: array
Show Source
Nested Schema : Discriminator: @type
Type: object
Discriminator: @type

Discriminator Values

401 Response

Your request isn't authorized. The authentication credentials included with this request are missing or invalid.
Body ()
Root Schema : Error
Type: object
Title: Error
Show Source

404 Response

Your request includes a resource URI that doesn't exist.
Body ()
Root Schema : Error
Type: object
Title: Error
Show Source

405 Response

HTTP action specified in the request (DELETE, GET, POST, PUT) isn't supported for this request URI.
Body ()
Root Schema : Error
Type: object
Title: Error
Show Source

500 Response

The server encountered something unexpected that prevented it from completing the request.
Body ()
Root Schema : Error
Type: object
Title: Error
Show Source
Back to Top

Examples

The following example shows how to create or update an array of entitlements by submitting a put request on the REST resource using cURL.

cURL Command

curl -u username:password -X PUT \ 'https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/v1/entitlement' -H 'Content-Type: application/json' -D @entitlement_update_array.json | json_pp

Example of Request Body

The following shows an example of the request body in JSON format.

[
        {
            "id": "PS_111120",
            "name": "SalesEntitlement11",
            "description": "Entitlement-Bulk-Put",
            "version": "1.0",
            "lifecycleStatus": "In design",
            "@type": "EntitlementOracle",
            "project": {
                "id": "AutomationProject",
                "name": "AutomationProject"
                },
            "validFor": {
                "startDateTime": "2021-01-01T00:00:00.000Z"
                },
            "entitlementType": "ENTITLEMENT_PRICING",
            "quantity": {
                "amount": 11,
                "units": "ENTL_UNIT_ORDERS"
                },
            "priority": 1,
            "pricelist": [
                {
                    "id": "US_PRICE_LIST_Auto",
                    "name": "US_PRICE_LIST_Auto"
                }
            ],
            "associatedProducts": [
                {
                    "id": "Auto-PO-26112021",
                    "name": "Auto-PO-26112021",
                    "actionObjectType": "PRODUCT_OFFERING",
                    "@referredType": "ProductOfferingOracle"
                }
            ],
            "benefits": [
                {
                    "id": "Benefit0232d",
                    "name": "Benefit0224",
                    "description": "Benefit0224",
                    "products": [
                        {
                            "id": "Auto-PO-26112021",
                            "name": "Auto-PO-26112021",
                            "actionObjectType": "PRODUCT_OFFERING",
                            "@referredType": "ProductOfferingOracle"
                        }
                    ],
                    "priority": 1,
                    "benefitType": "ENTL_BFT_TYP_DSNT",
                    "productOfferingPrice": [
                    {
                        "id": "TestPOP2911",
                        "name": "TestPOP2911",
                        "@type": "ProductOfferingPriceRefOracle",
                        "appliesTo": "ALL",
                        "@referredType": "ProductOfferPriceAlterationOracle"
                    }
                ],
                    "schedule": "ENTL_BFT_SCDL_WEKLY",
                    "status": "ENTL_BFT_STS_ACTV",
                    "relationshipAmongGroup": "ENTL_BFT_CND_REL_ALL",
                    "entitlementConditionsGroup": [
                        {
                            "id": "ConditionGroup1",
                            "groupName": "ConditionGroup1",
                            "relationTypeInGroup": "AND",
                            "order": 1,
                            "status": "ENT_CND_STA_ACTV",
                            "conditionTiming": "ENT_CND_TMG_WEKLY",
                            "products": [
                            {
                                "id": "Common-PS-26112021",
                                "name": "Common-PS-26112021",
                                "actionObjectType": "PRODUCT_SPECIFICATION",
                                "@referredType": "ProductSpecificationOracle"
                            }
                            ],
                    "condition": [
                    {
                        "id": "condt-2621961148-1641464904",
                        "conditionType": "ENTL_COND_TYP_VOL",
                        "conditionValue": "100",
                        "unitOfMeasure": "ENT_CND_UOM_ORDRS",
                        "operator": "EQUALS"
                    }
                ]
            }
        ]
    }
    ]
    },
    {
        "id": "PS_111119",
        "name": "SalesEntitlement10",
        "description": "Entitlement-Bulk-Put",
        "version": "1.0",
        "lifecycleStatus": "In design",
        "@type": "EntitlementOracle",
        "project": {
            "id": "AutomationProject",
            "name": "AutomationProject"
            },
            "validFor": {
                "startDateTime": "2021-01-01T00:00:00.000Z"
                },
            "entitlementType": "ENTITLEMENT_PRICING",
            "quantity": {
                "amount": 11,
                "units": "ENTL_UNIT_ORDERS"
                },
            "priority": 1,
            "pricelist": [
                {
                    "id": "US_PRICE_LIST_Auto",
                    "name": "US_PRICE_LIST_Auto"
                }
            ],
                "associatedProducts": [
                    {
                        "id": "Auto-PO-26112021",
                        "name": "Auto-PO-26112021",
                        "actionObjectType": "PRODUCT_OFFERING",
                        "@referredType": "ProductOfferingOracle"
                    }
                    ],
         "benefits": [
         {
            "id": "Benefit0232d",
            "name": "Benefit0224",
            "description": "Benefit0224",
            "products": [
            {
                "id": "Auto-PO-26112021",
                "name": "Auto-PO-26112021",
                "actionObjectType": "PRODUCT_OFFERING",
                "@referredType": "ProductOfferingOracle"
            }
        ],
            "priority": 1,
            "benefitType": "ENTL_BFT_TYP_DSNT",
            "productOfferingPrice": [
            {
            "id": "TestPOP2911",
            "name": "TestPOP2911",
            "@type": "ProductOfferingPriceRefOracle",
            "appliesTo": "ALL",
            "@referredType": "ProductOfferPriceAlterationOracle"
            }
        ],
            "schedule": "ENTL_BFT_SCDL_WEKLY",
            "status": "ENTL_BFT_STS_ACTV",
            "relationshipAmongGroup": "ENTL_BFT_CND_REL_ALL",
            "entitlementConditionsGroup": [
            {
            "id": "ConditionGroup1",
            "groupName": "ConditionGroup1",
            "relationTypeInGroup": "AND",
            "order": 1,
            "status": "ENT_CND_STA_ACTV",
            "conditionTiming": "ENT_CND_TMG_WEKLY",
            "products": [
            {
            "id": "Common-PS-26112021",
            "name": "Common-PS-26112021",
            "actionObjectType": "PRODUCT_SPECIFICATION",
            "@referredType": "ProductSpecificationOracle"
            }
        ],
        "condition": [
        {
        "id": "condt-2621961148-1641464904",
        "conditionType": "ENTL_COND_TYP_VOL",
        "conditionValue": "100",
        "unitOfMeasure": "ENT_CND_UOM_ORDRS",
        "operator": "EQUALS"
        }
      ]
    }
    ]
    }
    ]
    }
]

Example of Response Body

The following shows an example of the response body in JSON format.

[
    {
    "lastUpdate": "2022-05-04T07:30:47.232Z",
    "lastUpdatedBy": "booth",
    "created": "2022-05-04T07:30:47.000Z",
    "createdBy": "booth",
    "id": "PS_111120",
    "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/v1/entitlements/PS_111120",
    "name": "SalesEntitlement11",
    "description": "Entitlement-Bulk-Put",
    "@type": "EntitlementOracle",
    "version": "1.0",
    "validFor": {
        "startDateTime": "2021-01-01T00:00:00.000Z"
        },
    "project": {
        "id": "AutomationProject",
        "name": "AutomationProject",
        "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v4/project/AutomationProject"
        },
    "lifecycleStatus": "In design",
    "entitlementType": "ENTITLEMENT_PRICING",
    "priority": 1,
    "quantity": {
        "amount": 11,
        "units": "ENTL_UNIT_ORDERS"
        },
    "pricelist": [
        {
        "id": "US_PRICE_LIST_Auto",
        "name": "US_PRICE_LIST_Auto",
        "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/pricelist/US_PRICE_LIST_Auto"
        }
    ],
    "associatedProducts": [
        {
            "id": "Auto-PO-26112021",
            "name": "Auto-PO-26112021",
            "actionObjectType": "PRODUCT_OFFERING",
            "@referredType": "ProductOfferingOracle"
        }
    ],
    "benefits": [
        {
            "id": "Benefit0232d",
            "name": "Benefit0224",
            "description": "Benefit0224",
            "priority": 1,
            "benefitType": "ENTL_BFT_TYP_DSNT",
            "status": "ENTL_BFT_STS_ACTV",
            "schedule": "ENTL_BFT_SCDL_WEKLY",
            "relationshipAmongGroup": "ENTL_BFT_CND_REL_ALL",
            "products": [
            {
                "id": "Auto-PO-26112021",
                "name": "Auto-PO-26112021",
                "actionObjectType": "PRODUCT_OFFERING",
                "@referredType": "ProductOfferingOracle"
            }
        ],
        "productOfferingPrice": [
        {
            "id": "TestPOP2911",
            "name": "TestPOP2911",
            "@referredType": "ProductOfferPriceAlterationOracle",
            "@type": "ProductOfferingPriceRefOracle",
            "appliesTo": "ALL"
        }
    ],
        "entitlementConditionsGroup": [
        {
            "id": "ConditionGroup1",
            "groupName": "ConditionGroup1",
            "relationTypeInGroup": "AND",
            "order": 1,
            "status": "ENT_CND_STA_ACTV",
            "conditionTiming": "ENT_CND_TMG_WEKLY",
            "condition": [
            {
                "id": "condt-2621961148-1641464904",
                "unitOfMeasure": "ENT_CND_UOM_ORDRS",
                "conditionValue": "100",
                "conditionType": "ENTL_COND_TYP_VOL",
                "operator": "EQUALS"
            }
        ],
        "products": [
            {
                "id": "Common-PS-26112021",
                "name": "Common-PS-26112021",
                "actionObjectType": "PRODUCT_SPECIFICATION",
                "@referredType": "ProductSpecificationOracle"
            }
        ]
    }
    ]
}
]
},
    {
        "lastUpdate": "2022-05-04T07:26:35.229Z",
        "lastUpdatedBy": "booth",
        "created": "2022-05-04T07:02:32.000Z",
        "createdBy": "booth",
        "id": "PS_111119",
        "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/v1/entitlements/PS_111119",
        "name": "SalesEntitlement10",
        "description": "Entitlement-Bulk-Put",
        "@type": "EntitlementOracle",
        "version": "1.0",
        "validFor": {
            "startDateTime": "2021-01-01T00:00:00.000Z"
            },
        "project": {
            "id": "AutomationProject",
            "name": "AutomationProject",
            "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/productCatalogManagement/v4/project/AutomationProject"
            },
        "lifecycleStatus": "In design",
        "entitlementType": "ENTITLEMENT_PRICING",
        "priority": 1,
        "quantity": {
            "amount": 11,
            "units": "ENTL_UNIT_ORDERS"
            },
        "pricelist": [
            {
                "id": "US_PRICE_LIST_Auto",
                "name": "US_PRICE_LIST_Auto",
                "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/pricelist/US_PRICE_LIST_Auto"
            }
        ],
        "associatedProducts": [
            {
                "id": "Auto-PO-26112021",
                "name": "Auto-PO-26112021",
                "actionObjectType": "PRODUCT_OFFERING",
                "@referredType": "ProductOfferingOracle"
             }
        ],
        "benefits": [
             {
                "id": "Benefit0232d",
                "name": "Benefit0224",
                "description": "Benefit0224",
                "priority": 1,
                "benefitType": "ENTL_BFT_TYP_DSNT",
                "status": "ENTL_BFT_STS_ACTV",
                "schedule": "ENTL_BFT_SCDL_WEKLY",
                "relationshipAmongGroup": "ENTL_BFT_CND_REL_ALL",
                "products": [
                {
                    "id": "Auto-PO-26112021",
                    "name": "Auto-PO-26112021",
                    "actionObjectType": "PRODUCT_OFFERING",
                    "@referredType": "ProductOfferingOracle"
                }
                ],
                "productOfferingPrice": [
                {
                    "id": "TestPOP2911",
                    "name": "TestPOP2911",
                    "@referredType": "ProductOfferPriceAlterationOracle",
                    "@type": "ProductOfferingPriceRefOracle",
                    "appliesTo": "ALL"
                }
                ],
                "entitlementConditionsGroup": [
                {
                    "id": "ConditionGroup1",
                    "groupName": "ConditionGroup1",
                    "relationTypeInGroup": "AND",
                    "order": 1,
                    "status": "ENT_CND_STA_ACTV",
                    "conditionTiming": "ENT_CND_TMG_WEKLY",
                    "condition": [
                    {
                    "id": "condt-2621961148-1641464904",
                    "unitOfMeasure": "ENT_CND_UOM_ORDRS",
                    "conditionValue": "100",
                    "conditionType": "ENTL_COND_TYP_VOL",
                    "operator": "EQUALS"
                    }
                ],
                "products": [
                {
                    "id": "Common-PS-26112021",
                    "name": "Common-PS-26112021",
                    "actionObjectType": "PRODUCT_SPECIFICATION",
                    "@referredType": "ProductSpecificationOracle"
                }
            ]
        }
    ]
    }
]
}
]
Back to Top