Update refund in NetSuite
Accounting API · write, waits for approval · 100% field coverage
Your agent can update refund in NetSuite through Apideck's Accounting API, the same call it makes for every Accounting app. It changes data in the customer's NetSuite account, so it stops with the exact request until a person approves it. Apideck adds the customer's NetSuite credentials, so no token ever reaches the agent.
The call
PATCH https://unify.apideck.com/accounting/refunds/{id}
Headers: x-apideck-service-id: netsuite, plus your app id and the customer's consumer id. Apideck MCP tool: accounting-refunds-update. Agent operation id: unified.accounting.refundsUpdate.
| Parameter | In | Description |
|---|---|---|
| id · required | path | ID of the record you are acting upon. |
Body fields
| Field | Type | Description |
|---|---|---|
| number | string | Reference number for the refund. |
| customer | object | The customer this entity is linked to. |
| company_id | string | The company ID the transaction belongs to |
| currency | string | Indicates the associated currency for an amount of money. Values correspond to [ISO 4217](https://en.wikipedia.org/wiki/ |
| currency_rate | number | Currency Exchange Rate at the time entity was recorded/generated. |
| tax_inclusive | boolean | Amounts are including tax |
| sub_total | number | Subtotal amount, normally before tax. |
| total_amount · required | number | The total amount of the transaction or record |
| total_tax | number | Total tax amount applied to this transaction. |
| refund_date | string | The date of the refund - YYYY-MM-DDThh:mm:ss.sTZD |
| status | string | Status of refund. Maps to: QBO (limited status), NetSuite CashRefund status, Sage Intacct state (draft/posted/voided), Z |
| type | string | Type of refund. `refund_receipt` for itemized refunds with product/service lines and payment (QBO RefundReceipt; also Ne |
| payment_method | string | Payment method used for the transaction, such as cash, credit card, bank transfer, or check |
| payment_method_reference | string | Optional reference message returned by payment method on processing |
| payment_method_id | string | A unique identifier for an object. |
| account | object | |
| line_items | array | Line items for itemized refunds (type: refund_receipt or sale_refund). Used when the refund includes product/service det |
| allocations | array | Allocations linking refund to existing documents (invoices, credit notes, overpayments). Used for credit_note_refund and |
| tax_code | string | Applicable tax id/code override if tax is not supplied on a line item basis. |
| discount_percentage | number | Discount percentage applied to this refund. |
| discount_amount | number | Discount amount applied to this refund. |
| note | string | Optional note to be associated with the refund. |
| customer_memo | string | Customer memo |
| reference | string | Optional reference message for the refund. |
| billing_address | object | |
| shipping_address | object | |
| department | object | |
| location | object | |
| tracking_categories | array | A list of linked tracking categories. |
| custom_fields | array | |
| row_version | string | A binary value used to detect updates to a object and prevent data conflicts. It is incremented each time an update is m |
More for refunds in NetSuite
Update refund in other Accounting apps
The same call works for each of these; only the service id changes.