Skip to content

Update NetSuite integration reference with payment details#1769

Open
pj-simpson wants to merge 1 commit intomainfrom
netsuite-payments-credit-notes
Open

Update NetSuite integration reference with payment details#1769
pj-simpson wants to merge 1 commit intomainfrom
netsuite-payments-credit-notes

Conversation

@pj-simpson
Copy link
Collaborator

Added section on payments and credit note allocation for NetSuite integration.

We do not support paying the full value of an invoice off with a credit note. Fails with an internal NetSuite error being returned:

 "validation": {
    "errors": [
      {
        "itemId": "Payment",
        "message": "Error from NetSuite: 400 BadRequest; {\"error\" : {\"code\" : \"INVALID_FLD_VALUE\", \"message\" : \"{\\\"type\\\":\\\"error.SuiteScriptError\\\",\\\"name\\\":\\\"INVALID_FLD_VALUE\\\",\\\"message\\\":\\\"Value 0.0 outside of valid min/max range for field payment\\\",\\\"id\\\":\\\"\\\",\\\"stack\\\":[\\\"Error\\n    at RecordInvoker.setValue (suitescript/resources/javascript/record/serverRecordService.js:463:5)\\n    at NetSuiteObject.thenableFunction() (suitescript/resources/javascript/record/proxy.js:115:24)\\n    at setRecordValues (/SuiteBundles/Bundle 391485/capplink_record_api.restlet.js:153:21)\\n    at createRecord (/SuiteBundles/Bundle 391485/capplink_record_api.restlet.js:110:3)\\n    at Object.post (/SuiteBundles/Bundle 391485/capplink_record_api.restlet.js:75:18)\\\"],\\\"cause\\\":{\\\"type\\\":\\\"internal error\\\",\\\"code\\\":\\\"INVALID_FLD_VALUE\\\",\\\"details\\\":\\\"Value 0.0 outside of valid min/max range for field payment\\\",\\\"userEvent\\\":null,\\\"stackTrace\\\":[\\\"Error\\n    at RecordInvoker.setValue (suitescript/resources/javascript/record/serverRecordService.js:463:5)\\n    at NetSuiteObject.thenableFunction() (suitescript/resources/javascript/record/proxy.js:115:24)\\n    at setRecordValues (/SuiteBundles/Bundle 391485/capplink_record_api.restlet.js:153:21)\\n    at createRecord (/SuiteBundles/Bundle 391485/capplink_record_api.restlet.js:110:3)\\n    at Object.post (/SuiteBundles/Bundle 391485/capplink_record_api.restlet.js:75:18)\\\"],\\\"notifyOff\\\":false},\\\"notifyOff\\\":false,\\\"userFacing\\\":true}\"}}",
        "validatorName": "Payment"
      }
      
      ```

Please see old work item 76858 on ADO for background; not something we wanted to prioritize supporting. 

Added section on payments and credit note allocation for NetSuite integration.
@vercel
Copy link

vercel bot commented Feb 18, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
codat-docs Ready Ready Preview, Comment Feb 18, 2026 10:34am

Request Review

- The `depositedRecordRefs` array in the Transfer must specify either `payments`, `directIncomes`, or `journalEntries`.
- All transactions in the `depositedRecordRefs` array must share the same currency.

## Payments and Credit Note Allocation

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[Google.Headings] 'Payments and Credit Note Allocation' should use sentence-style capitalization.


## Payments and Credit Note Allocation

Codat does not support paying the __full__ value of an Invoice with a Credit Note, for NetSuite connected companies. Push operations which attempt to allocate funds from a Credit Note, paying off the entire value of an Invoice will fail with an error message from the NetSuite system: *"...Value 0.0 outside of valid min/max range for field payment..."*

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[Google.Contractions] Use 'doesn't' instead of 'does not'.


## Payments and Credit Note Allocation

Codat does not support paying the __full__ value of an Invoice with a Credit Note, for NetSuite connected companies. Push operations which attempt to allocate funds from a Credit Note, paying off the entire value of an Invoice will fail with an error message from the NetSuite system: *"...Value 0.0 outside of valid min/max range for field payment..."*

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[Google.Will] Avoid using 'will'.


## Payments and Credit Note Allocation

Codat does not support paying the __full__ value of an Invoice with a Credit Note, for NetSuite connected companies. Push operations which attempt to allocate funds from a Credit Note, paying off the entire value of an Invoice will fail with an error message from the NetSuite system: *"...Value 0.0 outside of valid min/max range for field payment..."*

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[Google.Ellipses] In general, don't use an ellipsis.


## Payments and Credit Note Allocation

Codat does not support paying the __full__ value of an Invoice with a Credit Note, for NetSuite connected companies. Push operations which attempt to allocate funds from a Credit Note, paying off the entire value of an Invoice will fail with an error message from the NetSuite system: *"...Value 0.0 outside of valid min/max range for field payment..."*

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[Google.Ellipses] In general, don't use an ellipsis.

@github-actions
Copy link

Link check results for preview deployment (https://codat-docs-git-netsuite-payments-credit-notes-codat.vercel.app):

[]

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

Comments