1. REST API for Oracle Commerce Cloud December 2017
  2. Tasks
  3. Admin
  4. Report Filter Configuration

updateReportFilterConfiguration

put

/ccadmin/v1/reportFilterConfigurations/{id}

Update Report Filter Configuration. Update the existing filter configuration for the last run report

Request

Supported Media Types
  • application/json
Path Parameters
id
Type: string
Required: true
The Repository id of the filter configuration to be updated.
Body Parameter
Root Schema : updateReportFilterConfiguration_request
Nested Schema : FilterConfigurationsItem
Type: object
The Filter configurations which is to be updated
Nested Schema : billingCountries
Type: array
BillingCountries with all regions selected in the filter option
Nested Schema : billingRegions
Type: array
BillingRegions Codes of the regions selected in the filter option
Nested Schema : productIds
Type: array
Product Ids of the products selected in the filter option
Nested Schema : shippingCountries
Type: array
ShippingCountries with all regions selected in the filter option
Nested Schema : shippingRegions
Type: array
ShippingRegions Codes of the regions selected in the filter option
Nested Schema : siteIds
Type: array
Site Ids of the sites selected in the filter option

Response

Supported Media Types
  • application/json
200 Response
Following model is returned when operation succeeds.
Body
Root Schema : updateReportFilterConfiguration_response
Nested Schema : FilterConfigurationsItem
Type: object
The Filter configurations which is updated
Nested Schema : billingCountries
Type: array
BillingCountries with all regions selected in the filter option
Nested Schema : billingRegions
Type: array
BillingRegions Codes of the regions selected in the filter option
Nested Schema : productIds
Type: array
Product Ids of the products selected in the filter option
Nested Schema : shippingCountries
Type: array
ShippingCountries with all regions selected in the filter option
Nested Schema : shippingRegions
Type: array
ShippingRegions Codes of the regions selected in the filter option
Nested Schema : siteIds
Type: array
Site Ids of the sites selected in the filter option
Example application/json

{
    "reportingStartDate":null,
    "transactionCurrency":"USD",
    "billingRegions":[
        "US-AL",
        "US-AB"
    ],
    "reportingEndDate":null,
    "groupBy":null,
    "shippingCountries":[
        "AS"
    ],
    "timeFrame":"yesterday",
    "priceListGroups":[
        "UsDollar"
    ],
    "billingCountries":[
        "AS"
    ],
    "shippingRegions":[
    ],
    "metric":"grossRevenue",
    "productIds":[
    ],
    "repositoryId":"admin-orders",
    "context":"orders",
    "siteIds":[
        "siteUS"
    ],
    "links":[
        {
            "rel":"self",
            "href":"http://localhost:9080/ccadminui/v1/reportFilterConfiguration/admin-overview"
        }
    ]
}
Default Response
The error response. The following are the internal error codes thrown by this API when the request processing fails in Oracle Commerce Cloud: |Error Code|Description| |------------------|------------------| |94048|If some error while processing the endpoint action| |94007|If some input for filter configuration is not valid or not available when required.|
Body
Root Schema : errorModel
Type: object
Nested Schema : errors
Type: array
An optional list of errors if multiple errors were encountered
Nested Schema : items
Type: object

Examples

Sample Request:

{
  "reportingStartDate": "",
  "transactionCurrency": "USD",
  "billingRegions": [
    "US-AB",
    "US-AL"
  ],
  "reportingEndDate": "",
  "groupBy": "day",
  "shippingCountries": ["AS"],
  "timeFrame": "yesterday",
  "priceListGroups": ["UsDollar"],
  "billingCountries": ["AS"],
  "metric": "grossRevenue",
  "productIds": [],
  "shippingRegions": [
    "US-AB",
    "US-AL"
  ],
  "context": "orders",
  "siteIds": ["siteUS"]
}

Sample Response Payload returned by endpoint:

{
  "reportingStartDate": null,
  "transactionCurrency": "USD",
  "billingRegions": [
    "US-AL",
    "US-AB"
  ],
  "reportingEndDate": null,
  "groupBy": null,
  "shippingCountries": ["AS"],
  "timeFrame": "yesterday",
  "priceListGroups": ["UsDollar"],
  "billingCountries": ["AS"],
  "shippingRegions": [],
  "metric": "grossRevenue",
  "productIds": [],
  "repositoryId": "admin-orders",
  "context": "orders",
  "siteIds": ["siteUS"],
  "links": [{
    "rel": "self",
    "href": "http://localhost:9080/ccadminui/v1/reportFilterConfiguration/admin-overview"
  }]
}