Item Supply Plan Help Topic in SuiteTalk Web Services 2023.2

TL;DR Opening

Starting in NetSuite 2023.2, the Item Supply Plan help topic has been introduced in SuiteTalk Web Services. This enhancement enables developers to seamlessly access and manage the item supply plan through REST API, improving integration capabilities and operational efficiency.

What's New

The latest update includes detailed information about the Item Supply Plan record, which is essential for demand planning. This record, identified by the ID itemsupplyplan, is not a subrecord, but it does contain a subrecord called itemsupplyplanorder. With this addition, users can manage item supply plans more effectively through SuiteTalk Web Services.

Prerequisites

Before using the item supply plan record through REST web services, ensure that the Demand Planning feature is enabled in your NetSuite account.

Accessing the Item Supply Plan

To access the item supply plan in NetSuite, navigate to:

• Path: Transactions > Demand Planning > Generate Item Supply Plan (Administrator).

Record ID

• Record ID: itemsupplyplan

Code Samples

The following code samples highlight common use cases for interacting with the item supply plan via REST APIs:

Get (Retrieve an Item Supply Plan)

GET {{COMPANY_URL}}/services/rest/record/v1/itemsupplyplan/{itemsupplyplanId}

Patch (Update an Existing Item Supply Plan)

PATCH {{COMPANY_URL}}/services/rest/record/v1/itemsupplyplan/{itemsupplyplanId}
Body:
{
  "memo": "Added new plan order line",
  "order": {
    "items": [
      {
        "links": [],
        "ordercreated": false,
        "orderdate": "2025-05-14",
        "orderlineid": 0,
        "ordertype": {
          "id": "PurchOrd",
          "refName": "Purchase Order"
        },
        "quantity": 10.0,
        "receiptdate": "2025-05-23"
      },
      {
        "orderdate": "2025-05-14",
        "ordertype": "PurchOrd",
        "quantity": 20.0,
        "receiptdate": "2025-05-24"
      }
    ]
  }
}

Post (Create a New Item Supply Plan)

POST {{COMPANY_URL}}/services/rest/record/v1/itemsupplyplan
Body:
{
  "item": {
    "id": "3869"
  },
  "location": {
    "id": "4009"
  },
  "memo": "Memo",
  "order": {
    "items": [
      {
        "orderdate": "2025-05-14",
        "ordertype": "PurchOrd",
        "quantity": 10.0,
        "receiptdate": "2025-05-23"
      }
    ]
  },
  "subsidiary": {
    "id": "1"
  }
}

Put (Create with External ID)

PUT {{COMPANY_URL}}/services/rest/record/v1/itemSupplyPlan/eid:{{planExternalId}}
Body:
{
  "item": {
    "id": "199"
  },
  "location": {
    "id": "6"
  },
  "memo": "Memo",
  "order": {
    "items": [
      {
        "orderdate": "2025-05-14",
        "ordertype": "PurchOrd",
        "quantity": 10.0,
        "receiptdate": "2025-05-23"
      }
    ]
  },
  "subsidiary": {
    "id": "1"
  }
}

Who This Affects

This enhancement primarily impacts the following roles and modules:

• Administrators: Required for enabling the feature.
• Developers: Important for integrating demand planning functionalities via API.
• Supply Chain Managers: Streamlines the order management process through better data accessibility.

Key Takeaways

• The Item Supply Plan help topic was added in NetSuite 2023.2 for SuiteTalk Web Services.
• Access records through a structured REST API for better item supply management.
• Enable the Demand Planning feature before integration for full functionality.
• Use the provided code samples for common CRUD operations related to item supply plans.