Sales | Customer Group
Service to manage entities of type 'CustomerGroup'.
Overview
URL | api/{tenantKey}/{orgKey}/salesCore/customerGroups |
Methods Supported | GET, POST, PUT, DELETE |
All Operations
This service includes the following operations:
- GET:
- POST:
-
PUT:
- PUT Set IsActive CustomerGroup
- PUT Set CustomerGroupKey CustomerGroup
- PUT Set Description CustomerGroup
- PUT Set PaymentMethod CustomerGroup
- PUT Set PaymentTerm CustomerGroup
- PUT Set PartyTaxSchema CustomerGroup
- PUT Set PartyWithholdingTaxSchema CustomerGroup
- PUT Set DeliveryTerm CustomerGroup
- PUT Set SettlementDiscountPercent CustomerGroup
- PUT Set PriceList CustomerGroup
- PUT Set IsDefault CustomerGroup
- DELETE:
All Resources
This service uses the following resources:
GET CustomerGroups (odata)
Returns a page of the list of all the entity records available.
The following elements are optional:
opts | (ODataQueryOptions) OData query option. |
Response:
When successful, the response body contains the list of records available. See CustomerGroupResource. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
GET CustomerGroup by identifier
Returns the entity record that matches the specified identifier.
The following elements are required:
id | (string) The record identifier. |
Response:
When successful, the response body contains the entity record. See CustomerGroupResource. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
GET CustomerGroup by key
Returns the entity record that matches the specified key.
The following elements are required:
customerGroupKey | (string) The customer's group key. |
Response:
When successful, the response body contains the entity record. See CustomerGroupResource. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
POST CustomerGroups
Creates a new entity record.
The following elements are required:
customerGroupResource | (ApiCustomerGroupResource) The request body should contain the entity record that should be created. See ApiCustomerGroupResource. |
Response:
When successful, the response body contains the new entity record identifier. The resource header location property contains the URL for the new entity record. See ApiCustomerGroupResource. |
Response status codes:
201 | Created. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set CustomerGroupKey CustomerGroup
Updates the value of attribute 'CustomerGroupKey' in the specified entity record.
The following elements are required:
customerGroupKey | (string) The customer's group key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set DeliveryTerm CustomerGroup
Updates the value of attribute 'DeliveryTerm' in the specified entity record.
The following elements are required:
customerGroupKey | (string) The customer's group key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Description CustomerGroup
Updates the value of attribute 'Description' in the specified entity record.
The following elements are required:
customerGroupKey | (string) The customer's group key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set IsActive CustomerGroup
Updates the value of attribute 'IsActive' in the specified entity record.
The following elements are required:
customerGroupKey | (string) The customer's group key. |
value | (bool) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
PUT Set IsDefault CustomerGroup
Updates the value of attribute 'IsDefault' in the specified entity record.
The following elements are required:
customerGroupKey | (string) The customer's group key. |
value | (bool) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set PartyTaxSchema CustomerGroup
Updates the value of attribute 'PartyTaxSchema' in the specified entity record.
The following elements are required:
customerGroupKey | (string) The customer's group key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set PartyWithholdingTaxSchema CustomerGroup
Updates the value of attribute 'PartyWithholdingTaxSchema' in the specified entity record.
The following elements are required:
customerGroupKey | (string) The customer's group key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set PaymentMethod CustomerGroup
Updates the value of attribute 'PaymentMethod' in the specified entity record.
The following elements are required:
customerGroupKey | (string) The customer's group key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set PaymentTerm CustomerGroup
Updates the value of attribute 'PaymentTerm' in the specified entity record.
The following elements are required:
customerGroupKey | (string) The customer's group key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set PriceList CustomerGroup
Updates the value of attribute 'PriceList' in the specified entity record.
The following elements are required:
customerGroupKey | (string) The customer's group key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set SettlementDiscountPercent CustomerGroup
Updates the value of attribute 'SettlementDiscountPercent' in the specified entity record.
The following elements are required:
customerGroupKey | (string) The customer's group key. |
value | (decimal) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
DELETE CustomerGroup by identifier
Deletes the entity record that matches the specified identifier.
The following elements are required:
id | (string) The record identifier. |
Response:
When successful, the response body is empty. |
Response status codes:
204 | Deleted. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
DELETE CustomerGroup by key
Deletes the entity record that matches the specified key.
The following elements are required:
customerGroupKey | (string) The customer's group key. |
Response:
When successful, the response body is empty. |
Response status codes:
204 | Deleted. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
Resources
ApiCustomerGroupResource
The following elements are required:
customerGroupKey | (string) The customer's group key. |
isDefault | (bool) Is Default Customer Group. |
The following elements are optional:
description | (string) The customer's group description. |
paymentMethod | (string) The payment's method. Financial transfer method used by the entity responsible for paying a transaction. For example, cash, transfer or check payments. The default is defined on the customer party. |
paymentTerm | (string) The payment's term. Term specifying the manner in which a trade will be done. Generally, these terms specify a period in which the buyer can pay the due amount. They can also demand some money to be paid in advance, paid in cash at delivery, a 30 day or longer period, or other similar arrangements for deferred payment. |
partyTaxSchema | (string) The customer's party tax schema. The tax schema identifies the group of taxes a party is liable for. The tax schema is defined in the customer party. |
partyWithholdingTaxSchema | (string) The customer's party withholding tax schema. The withholding tax schema identifies the group of withholding taxes a party is liable for. The withholding tax schema is defined in the customer party. |
deliveryTerm | (string) The delivery's term. The conditions in a sales or transportation contract that specify the means of transportation. The default is defined on the customer party. |
settlementDiscountPercent | (decimal) The settlement's discount percentage. |
priceList | (string) The catalogued table values that sets the standard price for the products and goods traded by a specific entity. The default is inferred from the customer party if defined, otherwise from the sales setup. |
CustomerGroupResource
The following elements are required:
customerGroupKey | (string) The customer's group key. |
isDefault | (bool) Is Default Customer Group. |
The following elements are optional:
description | (string) The customer's group description. |
paymentMethod | (string) The payment's method. Financial transfer method used by the entity responsible for paying a transaction. For example, cash, transfer or check payments. The default is defined on the customer party.
(fk) Allowed value: the natural key of a record of type PaymentMethod. These records are accessibly through the PaymentMethods service. |
paymentTerm | (string) The payment's term. Term specifying the manner in which a trade will be done. Generally, these terms specify a period in which the buyer can pay the due amount. They can also demand some money to be paid in advance, paid in cash at delivery, a 30 day or longer period, or other similar arrangements for deferred payment.
(fk) Allowed value: the natural key of a record of type PaymentTerm. These records are accessibly through the PaymentTerms service. |
partyTaxSchema | (string) The customer's party tax schema. The tax schema identifies the group of taxes a party is liable for. The tax schema is defined in the customer party.
(fk) Allowed value: the natural key of a record of type PartyTaxSchema. These records are accessibly through the PartyTaxSchemas service. |
partyWithholdingTaxSchema | (string) The customer's party withholding tax schema. The withholding tax schema identifies the group of withholding taxes a party is liable for. The withholding tax schema is defined in the customer party.
(fk) Allowed value: the natural key of a record of type PartyWithholdingTaxSchema. These records are accessibly through the PartyWithholdingTaxSchemas service. |
deliveryTerm | (string) The delivery's term. The conditions in a sales or transportation contract that specify the means of transportation. The default is defined on the customer party.
(fk) Allowed value: the natural key of a record of type DeliveryTerm. These records are accessibly through the DeliveryTerms service. |
settlementDiscountPercent | (decimal) The settlement's discount percentage. |
priceList | (string) The catalogued table values that sets the standard price for the products and goods traded by a specific entity. The default is inferred from the customer party if defined, otherwise from the sales setup.
(fk) Allowed value: the natural key of a record of type PriceList. These records are accessibly through the PriceLists service. |