1. SuiteCloud Platform
  2. SuiteTalk Web Services
  3. SuiteTalk REST Web Services Records Guide
  4. REST Web Services Supported Records
  5. Cash Refund

Cash Refund

The cash refund record exposes a cash refund to REST web services. This record:

A cash refund transaction records the return of money to a customer who immediately paid for goods or services using cash, a check or a credit card. For details about this type of transaction, see Refunding a Cash Sale.

There are no prerequisites for using this record through REST web services.

Using this record requires you to specify an item line number that is 1-indexed.

The REST API Browser includes information about the field names and field types of the cash refund record and about the HTTP methods, request parameters, and operations available to this record.

For details, see the REST API Browser’s cash refund reference page.

For information about using the REST API Browser, see The REST API Browser.

This record has fields related to taxation features. To view the complete list of fields, go to Cash Refund in SuiteScript Records Browser.

Note:

REST web services do not support legacy tax features. To work with taxation through REST web services, you must have the SuiteTax feature enabled. For more information about using SuiteTax, see SuiteTax.

Record ID

The record ID for a cash refund REST record is CashRefund.

Usage Notes

To use the Choose Team and Update Customer fields in the Sales Team subtab, the Team Selling feature must be enabled. To enable Team Selling, go to Setup > Company > Enable Features > CRM. Check the Team Selling box, and then click Save.

The Multi-Partner Management Feature must also be enabled to use the Update Customer field in the Relationships subtab. An administrator can enable the Multi-Partner Management feature at Setup > Company > Setup Tasks > Enable Features. Click the CRM subtab, and then under Partners, check the Multi-Partner Management box. Click Save.

Code Samples

These samples show common use cases for cash refund.

            POST: https://demo123.suitetalk.api.netsuite.com/services/rest/record/v1/cashrefund
{ "account": { "id": "155", "refName": "660 US Bank USD" }, "currency": { "id": "1", "refName": "USA" }, "entity": { "id": "110", "refName": "Anonymous Customer" }, "item": { "items": [ { "item": { "id": "98" }, "quantity": 1 } ] }, "location": { "id": "6", "refName": "US ONLY LOCATION" }
}
GET: https://demo123.suitetalk.api.netsuite.com/services/rest/record/v1/cashrefund/318
PATCH: https://demo123.suitetalk.api.netsuite.com/services/rest/record/v1/cashrefund/318
{ "account": { "id": "155", "refName": "660 US Bank USD" }, "currency": { "id": "1", "refName": "USA" }, "entity": { "id": "110", "refName": "Anonymous Customer" }, "item": { "items": [ { "line": 1, "refName": "Custom", "rate": 49.95, "item": { "id": "98" }, "quantity": 2 } ] }, "location": { "id": "6", "refName": "US ONLY LOCATION" }
}
DELETE: https://demo123.suitetalk.api.netsuite.com/services/rest/record/v1/cashrefund/318

Setting the Sales Order's Sales Team Members to Match Sales Group 164

            "salesGroup": {
    "id": 164 }

Update the Customer's Partner Team to Match the Transaction Partners

            "syncPartnerTeams": true

Update the Customer's Sales Team to Match the Transaction Sales Team

            "syncSalesTeams": true

Related Topics

General Notices