Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel3
outlinefalse
styledefault
typelist
printablefalse

...

Operation/Type of operation

Behavior

Examples

1

Any operation that creates a customer resource.

  • If business_entity_id is provided, the customer resource is created and linked to it.

  • If business_entity_id is not provided, the customer resource is created under the default business entity of the site.

2

Create a resource other than customer

 

  • If business_entity_id is provided, and it is the same as that linked to the target resource: the resource is created and linked to the business entity provided.

  • If business_entity_id is provided, and it is not the same as that linked to the target resource, a 404 Not Found response is sent because the resource cannot be found in the context of the business entity specified.

  • If business_entity_id is not provided, the resource is created and linked to the business entity of the target resource.

3

Update/delete a resource

  • If business_entity_id is provided, and it is the same as that linked to theresource, the operation proceeds successfully.

  • If business_entity_id is provided, and it is not the same as that linked to the resource, a 404 Not Found response is sent because the resource cannot be found in the context of the business entity specified.

  • If business_entity_id is not provided, the operation proceeds successfully.

4

List resources

  • If business_entity_id is provided, then only those resources linked to the business entity are returned since the context of the operation is now restricted to the business entity specified.

  • If business_entity_id is not provided,then all resources in the site are returned.

5

Retrieve a resource

  • If business_entity_id is provided, and it is the same as that linked to theresource, the resource is retrieved successfully.

  • If business_entity_id is provided, and it is not the same as that linked to the resource, a 404 Not Found response is sent because the resource cannot be found in the context of the business entity specified.

  • If business_entity_id is not provided, the resource is retrieved successfully.

Terminology

This section defines some useful terms for describing how business entities work.

...

1

resource_type[<operator>]

Status
colourPurple
titlestring filter

Filter business_entity_transfer resources based on resource_type.

Tip

Tip

Use this filter along with active_resource_id[<operator>] to retrieve the history of all the business entity transfers for a resource.

  • Supported operators : is

  • Example: resource_type[is] = "customer"

2

resource_id[<operator>]

Status
colourPurple
titlestring filter

Filter business_entity_transfer resources based on resource_id.

  • Supported operators : is

  • Example: resource_id[is] = "9bsvnHgsvmsI"

3

active_resource_id[<operator>]

Status
colourPurple
titlestring filter

Filter business_entity_transfer resources based on active_resource_id.

Tip

Tip

Use this filter along with resource_type[<operator>] to retrieve the history of all the business entity transfers for a resource.

  • Supported operators : is

  • Example: active_resource_id[is] = "8gsnbYfsMLds"

4

created_at[<operator>]

Status
colourPurple
titleunix time in seconds filter

Filter business_entity_transfer resources based on created_at.
Supported operators : after, before, on, between

Example → created_at[after] = "1702022464"

Returns

Attribute

Description

1

business_entity_transfer

Status
colourBlue
titlealways returned

Resource object representing business_entity_transfer.

2

next_offset

Status
colourPurple
titlestring
Status
titlemax chars=1000

This attribute is returned only if more resources are present. To fetch the next set of resources use this value
for the input parameter offset.