Acumatica API - Endpoint Default 23 200 001 icon

Acumatica API - Endpoint Default 23 200 001

Interact with Acumatica Endpoint Default/23.200.001

Actions478

Service Order → Insert/Update

AI-generated

Summary

Insert or update a Service Order

Inputs

  • address — Composite address fields (AddressLine1, AddressLine2, City, Country, PostalCode, State)
  • appointments — Array of appointment details (AppointmentNbr, Confirmed, ScheduledStartDate/Time, ScheduledEndDate/Time, ServiceOrderType, Status)
  • attributes — Array of attribute entries (Attribute, RefNoteID with nested Value, Required, Value)
  • contact — Contact information (Attention, CompanyName, Email, Phone1, Phone1Type)
  • contractInfo — Contract details (ContractPeriod, ServiceContract)
  • defaultStaff — Array of staff line items (Comment, Description, InventoryID, LineNbr, ServiceLineRef, ServiceOrderNbr, ServiceOrderType, StaffMemberID, Type)
  • details — Array of detail lines (Account, Amount, AppointmentAmount, AppointmentCount, AppointmentDuration, ... etc.)
  • financialDetails — Financial metadata (BillingCustomer, BillingCycle, Branch, Commissionable, CustomerTaxZone, ... )
  • otherInformation — Miscellaneous fields (BatchNumber, Description, DocumentType, InvoiceNbr, IssueReferenceNbr, ReferenceNbr)
  • prepayments — Array of prepayment entries (ApplicationDate, AppliedtoOrders, AvailableBalance, CashAccount, Currency, PaymentAmount, PaymentMethod, PaymentRef, ReferenceNbr, SourceAppointmentNbr, Status, Type)
  • taxDetails — Array of tax details (IncludeinVATExemptTotal, PendingVAT, RecordID, ReverseVAT, ServiceOrderNbr, ServiceOrderType, StatisticalVAT, TaxableAmount, TaxAmount, TaxID, TaxRate, TaxType)
  • totals — Aggregated totals (AppointmentTotal, BillableTotal, EstimatedTotal, LineTotal, PrepaymentApplied, PrepaymentReceived, PrepaymentRemaining, ServiceOrderBillableUnpaidBalance, ServiceOrderTotal, ServiceOrderUnpaidBalance, TaxTotal, VATExemptTotal, VATTaxableTotal)
  • additionalFields — Flexible key‑value pairs for extra data (AppointmentDuration, AppointmentsNeeded, BillableTotal, BranchLocation, Currency, Customer, Date, DefaultProjectTask, Description, EstimatedDuration, ExternalReference, Hold, LastModifiedDateTime, Location, Override, Priority, Problem, Project, ServiceOrderNbr, ServiceOrderTotal, ServiceOrderType, Severity, SLA, SLATime, Status, Supervisor, TaxTotal, WaitingforPurchasedItems, WorkflowStage)

Output shape

a single Service Order record (upsert result)

returns the created or updated Service Order object; optional fields may be omitted; errors are indicated by HTTP status rather than a body

Examples

Example 1: Create a new Service Order with address and one appointment

Populate Address fields, add an Appointment entry under Appointments, then execute the node

Example 2: Update an existing Service Order by providing its ServiceOrderNbr and modifying financial details

Set ServiceOrderNbr (within AdditionalFields), adjust FinancialDetails, then run the node

Links

Discussion