Disabling Per-Invoice Reports for Child Accounts

Important: This is applicable only for reports for the “Provisioned orders” (default) data set.

Note: This feature is available from RDE version 1.4-135.

By default, RDE generates reports per invoice. The provider or reseller can turn this off for their direct child accounts without affecting indirect child accounts.

Important: The provider performs all REST API requests by providing the admin user's APS token. A reseller can do this for their resellers using OAuth credentials received from the provider.

For All Child Accounts

To disable per-invoice report generation for your child accounts, complete the following steps:

1. Get the provider's tenant ID by running the following request in a REST client:

   GET http://<MN_hostname>:8080/aps/2/resources/?implementing(http://www.odin.com/rde/tenant/2.1),eq(account.id,<Account_ID>)

   The response will be similar to the following:

   {
   	"reportType": "RESELLER"
   	"invoicesDisabledByParent": false
   	"aps": {
   		"modified": "2019-04-02T15:56:25Z"
   		"id": "<tenant_id>"
   		"type": "http://www.odin.com/rde/tenant/2.1"
   		"status": "aps:ready"
   		"revision": 22
       }
     "invoicesDisabledForResellers": false
   }

2. Disable the ability to generate per-invoice reports for all child accounts. To do this, run the following request specifying the tenant ID obtained in step 1:

   PUT http://<MN_hostname>:8080/aps/2/resources/<tenant_id>
   {
   	"invoicesDisabledForResellers": true
   }
   

As a result, the provider's child accounts will no longer be able to receive per-invoice reports.

For a Specific Child Account

To disable per-invoice report generation for a specific child account, complete the following steps:

1. Get the tenant ID of a child account by running the following request in a REST client of your choice:

   GET http://<MN_hostname>:8080/aps/2/resources/?implementing(http://www.odin.com/rde/tenant/2.1),eq(account.id,<Account_ID>)

   The response will be similar to the following:

   {
   	"reportType": "RESELLER"
   	"invoicesDisabledByParent": false
   	"aps": {
   		"modified": "2019-04-02T15:56:25Z"
   		"id": "<tenant_id>"
   		"type": "http://www.odin.com/rde/tenant/2.1"
   		"status": "aps:ready"
   		"revision": 22
       }
     "invoicesDisabledForResellers": false
   }

2. Disable the ability to generate per-invoice reports for this account. To do this, run the following request specifying the tenant ID obtained in step 1:

   PUT http://<MN_hostname>:8080/aps/2/resources/<tenant_id>
   {
   	"invoicesDisabledByParent": true
   }
   

As a result, generation of per-invoice reports will no longer be available to that account.