Acumatica API - Endpoint Default 24 200 001Install

Summary

Insert or update a Service Order in Acumatica by specifying its details, including address, appointments, attributes, contact information, contract info, default staff, line item details, financial details, tax details, totals, prepayments, and other metadata.

Inputs

• Address — Specify the service order's address including Address Line1, Address Line2, City, Country, Postal Code, and State.
• Appointments — List of appointments related to the service order with fields like appointment number, confirmed status, scheduled start and end dates/times, service order type, and status.
• Attributes — Custom attributes for the service order, each with an attribute name, a value, optional reference note ID, and a flag indicating if it's required.
• Contact — Contact information for the service order including attention, company name, email, phone number, and phone type.
• Contract Info — Contract details such as contract period and service contract identifier.
• Default Staff — List of default staff assignments with details like comment, description, inventory ID, line number, service line reference, staff member ID, type, and related service order info.
• Details — Line item details with financial, inventory, billing, logistics, and equipment information for each service order detail line.
• Financial Details — Financial information such as billing customer, billing cycle, billing location, branch, commission flags, customer tax zone, run billing mode, salesperson, and tax calculation mode.
• Other Information — Additional metadata including batch number, description, document type, invoice number, issue reference number, and reference number.
• Prepayments — List of prepayments applied to the service order including application date, amount, cash account, currency, payment method, payment reference, status, and type.
• Tax Details — Tax line details including VAT status flags, record ID, associated service order info, taxable amount, tax amount, tax ID, rate, and type.
• Totals — Summary totals such as appointment total, billable total, estimated total, line total, prepayment amounts, service order unpaid balance, tax total, and VAT totals.
• Additional Fields — Other optional fields like appointment duration, appointments needed flag, billable total, branch location, currency, customer, customer order, date, default project task, description, estimated duration, external reference, hold status, last modified datetime, location, override flag, priority, problem description, project, service order number/type, severity, SLA datetime fields, status, supervisor, tax total, waiting for purchased items flag, and workflow stage.

Output shape

a single object representing the inserted or updated Service Order record

The operation returns the created or updated Service Order entity data from Acumatica. All input fields are optional but should be supplied as needed to define or update the service order. The request body is built by unwrapping fixed collections, wrapping values for Acumatica API compatibility, and stripping default/empty values to avoid errors.

Examples

Example 1: Create a new service order by specifying customer, contact, address, and appointment details.

Set fields for Address, Contact, Customer, Date, and one or more Appointments with scheduled dates and status.

Example 2: Update an existing service order's financial details and status.

Provide the ServiceOrderNbr, set Financial Details fields such as BillingCustomer and Salesperson, and update Additional Fields like Status and Priority.

Links

• n8n community nodes installation guide