NetSuite SuiteTalk invoice creation

Sure — if you want to create an Invoice in NetSuite SuiteTalk, you typically use the SOAP web services add operation with an Invoice record.

Basic idea

An invoice usually needs:

• a customer/entity
• at least one item line
• optionally terms, class, department, location, memo, etc.

Example SOAP request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:platformMsgs="urn:messages_2023_2.platform.webservices.netsuite.com"
                  xmlns:tranSales="urn:sales_2023_2.transactions.webservices.netsuite.com"
                  xmlns:platformCore="urn:core_2023_2.platform.webservices.netsuite.com">
  <soapenv:Header>
    <platformMsgs:passport>
      <platformMsgs:email>YOUR_EMAIL</platformMsgs:email>
      <platformMsgs:password>YOUR_PASSWORD</platformMsgs:password>
      <platformMsgs:account>YOUR_ACCOUNT_ID</platformMsgs:account>
      <platformMsgs:role internalId="3"/>
    </platformMsgs:passport>
  </soapenv:Header>

  <soapenv:Body>
    <platformMsgs:add>
      <platformMsgs:record xsi:type="tranSales:Invoice"
                           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <tranSales:entity internalId="123" type="customer"/>
        <tranSales:trandate>2026-10-11T00:00:00.000Z</tranSales:trandate>
        <tranSales:memo>Invoice created via SuiteTalk</tranSales:memo>

        <tranSales:itemList>
          <tranSales:item>
            <tranSales:item internalId="456" type="inventoryItem"/>
            <tranSales:quantity>2</tranSales:quantity>
            <tranSales:rate>100.00</tranSales:rate>
          </tranSales:item>
        </tranSales:itemList>
      </platformMsgs:record>
    </platformMsgs:add>
  </soapenv:Body>
</soapenv:Envelope>

Important notes

1. Authentication

NetSuite commonly uses:

• Token-Based Authentication (TBA) — preferred
• Passport auth — older / sometimes disabled
• NLAuth — legacy

2. Required fields

At minimum, you usually need:

• entity
• itemList with one or more invoice lines

Depending on your account settings, you may also need:

• subsidiary
• location
• class/department
• currency
• terms

3. Item line structure

Each line can reference:

• item (the product/service internal ID)
• quantity
• rate
• optionally amount, taxCode, description, etc.

Common errors

• INVALID_FLD_VALUE: wrong internal ID or wrong field type
• USER_ERROR: missing required fields
• PERMISSION_VIOLATION: role lacks access
• INSUFFICIENT_PERMISSION on subsidiary/customer/item

If you’re using SuiteScript or REST instead

If you want, I can also provide:

1. a SuiteTalk SOAP example with TBA
2. a cURL / Postman example
3. a SuiteScript 2.x invoice creation script
4. a REST Record API example

If you tell me your integration style and auth method, I can tailor the exact request.