salesorderep

type BulkDeleteSalesOrdersEndpoint struct{}

type BulkDeleteSalesOrdersRequest struct {
	// IDs of the sales orders to delete.
	SalesOrderIDs []string `json:"sales_order_ids" validate:"required"`
}

type CheckoutSalesOrderEndpoint struct{}

type CheckoutSalesOrderRequest struct {
	// Sales order ID.
	SalesOrderID string `path:"id" validate:"required"`
	// Email address to send the checkout link to.
	Email string `json:"email" validate:"required,email"`
}

type CheckoutSalesOrderResponse struct {
	// Resource type identifier.
	Object constants.ObjectType `json:"object" validate:"required,enum=checkout_sales_order"`
	// URL of the hosted payment page where the customer completes the checkout.
	CheckoutURL string `json:"checkout_url" validate:"required"`
}

type CloseSalesOrderEndpoint struct{}

type CloseSalesOrderRequest struct {
	// Sales order ID.
	SalesOrderID string `path:"id" validate:"required"`
}

type CreateProductionRunEndpoint struct{}

type CreateProductionRunRequest struct {
	// Sales order ID.
	SalesOrderID string `path:"id" validate:"required"`
}

type CreateSalesOrderEndpoint struct{}

type CreateSalesOrderLineEndpoint struct{}

type CreateSalesOrderLineInput struct {
	// ID of the product being ordered.
	ProductID string `json:"product_id" validate:"required"`
	// Quantity ordered.
	Quantity apirequest.QuantityInput `json:"quantity" validate:"required"`
	// SKU recorded on the line.
	//
	// Defaults to the product's SKU when omitted.
	ProductSKU field.Optional[string] `json:"product_sku,omitzero" validate:"omitempty,max=255"`
	// Description recorded on the line.
	//
	// Defaults to the product's description when omitted.
	ProductDescription field.Optional[string] `json:"product_description,omitzero"`
	// Unit price override.
	//
	// Honored only for internal users; for customer accounts it is ignored and the price is calculated server-side.
	UnitPrice field.Optional[apirequest.RateInput] `json:"unit_price,omitzero"`
}

type CreateSalesOrderLineRequest struct {
	// Sales order ID.
	SalesOrderID string `path:"id" validate:"required"`
	// ID of the product being ordered.
	ProductID string `json:"product_id" validate:"required"`
	// The product SKU recorded on the line.
	ProductSKU string `json:"product_sku" validate:"required,max=255"`
	// The product description recorded on the line.
	ProductDescription field.Optional[string] `json:"product_description,omitzero"`
	// Quantity ordered.
	//
	// The unit must belong to the product's unit group.
	Quantity apirequest.QuantityInput `json:"quantity" validate:"required"`
	// Unit price override.
	//
	// When omitted, the line is priced server-side from the product's pricing rules (customer price, unit-conversion and volume discounts, account-price overrides) — the same pricing applied when the order is created. An explicit value is honored only for internal users. The unit cost is always resolved from the product and never taken from the request.
	UnitPrice field.Optional[apirequest.RateInput] `json:"unit_price,omitzero"`
}

type CreateSalesOrderRequest struct {
	// ID of the customer account the order is for.
	BuyerAccountID string `json:"buyer_account_id" validate:"required"`
	// The customer's own purchase order number, for cross-referencing.
	//
	// Must be unique among your orders for this customer.
	CustomerPurchaseOrderNumber field.Optional[string] `json:"customer_purchase_order_number,omitzero" validate:"omitempty,max=255"`
	// Free-form note about the order.
	Note field.Optional[string] `json:"note,omitzero"`
	// ID of the carrier that will ship the order.
	//
	// Falls back to the customer's default carrier; the order is rejected when neither is available.
	CarrierID field.Optional[string] `json:"carrier_id,omitzero" validate:"omitempty"`
	// ID of the carrier service level the order ships on.
	//
	// Falls back to the customer's default service level, but only when `carrier_id` is also omitted — supplying a carrier without a service level leaves the service level unset.
	ServiceLevelID field.Optional[string] `json:"service_level_id,omitzero" validate:"omitempty"`
	// Who is billed for freight.
	//
	// - `sender`: the sender pays for shipping.
	// - `third_party`: a third party pays for shipping, using the carrier billing account number.
	CarrierBillingType field.Optional[constants.CarrierBillingType] `json:"carrier_billing_type,omitzero" validate:"omitempty"`
	// Carrier billing account number charged when `carrier_billing_type` is `third_party`.
	CarrierBillingAccountNumber field.Optional[string] `json:"carrier_billing_account_number,omitzero" validate:"omitempty,max=255"`
	// Fulfillment priority used to rank the order on the shop floor.
	PriorityCode constants.PriorityCode `json:"priority_code" validate:"required"`
	// ID of the account user to credit as the order's sales rep.
	//
	// When omitted, a rep is assigned automatically: the customer's default sales rep first, then the sales territory matching the ship-to postal code, then the ship-to state. No rep is assigned when the customer is commission-exempt or every ordered product belongs to a commission-exempt product line.
	SalesRepID field.Optional[string] `json:"sales_rep_id,omitzero" validate:"omitempty"`
	// ID of the shipping terms for the order.
	//
	// Falls back to the customer's default shipping term; the order is rejected when neither is available.
	ShippingTermID field.Optional[string] `json:"shipping_term_id,omitzero" validate:"omitempty"`
	// ID of the payment terms for the order.
	//
	// Falls back to the customer's default payment term; the order is rejected when neither is available.
	PaymentTermID field.Optional[string] `json:"payment_term_id,omitzero" validate:"omitempty"`
	// The order-level discount to apply, given as either its ID or its unique code.
	//
	// The discount is realized as an extra negative-priced line on the order rather than as a separate total.
	OrderDiscountID field.Optional[string] `json:"order_discount_id,omitzero" validate:"omitempty"`
	// Date delivery is promised to the customer.
	//
	// The order's ship-by date is worked back from this: the goods have to reach the customer on a day they receive, so transit and both operating calendars are subtracted from it. Mutually exclusive with lead_time_override_days and ship_by_override_date.
	PromisedAt field.Optional[time.Time] `json:"promised_at,omitzero"`
	// Days between this order being issued and it being due to ship, replacing the customer's standing lead time for this order alone.
	//
	// Already a ship lead time, so no carrier transit is subtracted from it. Mutually exclusive with promised_at and ship_by_override_date.
	LeadTimeOverrideDays field.Optional[int32] `json:"lead_time_override_days,omitzero" validate:"omitempty,gte=0,lte=3650"`
	// The exact date the order is due to ship, bypassing transit and the customer's receiving days.
	//
	// Still moved back to the nearest earlier day the plant ships on, since a date nobody can ship on is not a deadline. Mutually exclusive with promised_at and lead_time_override_days.
	ShipByOverrideDate field.Optional[time.Time] `json:"ship_by_override_date,omitzero"`
	// Bill-to address ID.
	//
	// Must reference an existing address on the order's owner or buyer account.
	BillToAddressID string `json:"bill_to_address_id" validate:"required"`
	// Ship-to address ID.
	//
	// Must reference an existing address on the order's owner or buyer account.
	ShipToAddressID string `json:"ship_to_address_id" validate:"required"`
	// The line items to put on the order.
	//
	// The freight line, and the discount line when `order_discount_id` is supplied, are added on top of these automatically.
	Lines []CreateSalesOrderLineInput `json:"lines" validate:"required,min=1,dive"`
	// Users who should receive order acknowledgement emails for this order.
	//
	// Each must be a user on the customer's account.
	AcknowledgementEmailContacts []SalesOrderEmailContactInput `json:"acknowledgement_email_contacts,omitzero"`
	// Users who should receive invoice emails for this order.
	//
	// Each must be a user on the customer's account.
	InvoiceEmailContacts []SalesOrderEmailContactInput `json:"invoice_email_contacts,omitzero"`
}

type DeleteSalesOrderEndpoint struct{}

type DeleteSalesOrderLineEndpoint struct{}

type DeleteSalesOrderLineRequest struct {
	// Sales order ID.
	SalesOrderID string `path:"id" validate:"required"`
	// Sales order line ID.
	SalesOrderLineID string `path:"line_id" validate:"required"`
}

type DeleteSalesOrderRequest struct {
	// Sales order ID.
	SalesOrderID string `path:"id" validate:"required"`
}

type IssueSalesOrderEndpoint struct{}

type IssueSalesOrderRequest struct {
	// Sales order ID.
	SalesOrderID string `path:"id" validate:"required"`
	// Whether to notify the customer.
	//
	// When `true`, an order acknowledgement email with a PDF of the order is sent to the acknowledgement contacts on the order and the order's `acknowledgment_status` becomes `sent`. An order with no acknowledgement contacts sends nothing and leaves its `acknowledgment_status` unchanged.
	NotifyCustomer bool `json:"notify_customer"`
}

type ListSalesOrdersEndpoint struct{}

type ListSalesOrdersRequest struct {
	apiresource.PaginationRequest
	// Restricts results to orders in any of these lifecycle statuses.
	StatusCodes []constants.SalesOrderStatusCode `query:"status_codes"`
	// Restricts results to orders that have at least one line for any of these inventory items.
	ItemIDs []string `query:"item_ids"`
	// Restricts results to orders that have at least one line whose product belongs to any of these product lines.
	ProductLineIDs []string `query:"product_line_ids"`
	// Restricts results to orders placed by any of these customers.
	CustomerIDs []string `query:"customer_ids"`
	// Restricts results to orders placed by customers belonging to any of these account groups.
	CustomerGroupIDs []string `query:"customer_group_ids"`
	// Restricts results to orders credited to any of these sales reps.
	//
	// These are account user IDs, matching the `sales_rep` on the order.
	SalesRepIDs []string `query:"sales_rep_ids"`
	// Earliest order creation date to include, in `YYYY-MM-DD` format.
	StartDate *string `query:"starts_at"`
	// Latest order creation date to include, in `YYYY-MM-DD` format.
	//
	// Compared against the creation timestamp at the start of that day, so orders created later on the end date itself are excluded; pass the following day to include them.
	EndDate *string `query:"ends_at"`
	// Earliest ship-by date to include, in `YYYY-MM-DD` format. Inclusive of the date itself.
	ShipByAfter *string `query:"ship_by_after"`
	// Latest ship-by date to include, in `YYYY-MM-DD` format. Inclusive of the date itself.
	ShipByBefore *string `query:"ship_by_before"`
	// Restricts results to orders that are, or are not, past their ship-by date.
	//
	// An order is past due when it is still `issued` and its ship-by date has passed. A fulfilled order that shipped late is not past due — it is delivered, and how late it was is a delivery-performance question rather than a backlog one.
	PastDue *bool `query:"past_due"`
}

type OpenSalesOrderEndpoint struct{}

type OpenSalesOrderRequest struct {
	// Sales order ID.
	SalesOrderID string `path:"id" validate:"required"`
}

type QuoteSalesOrderCommitmentEndpoint struct{}

type QuoteSalesOrderCommitmentRequest struct {
	// An existing order to preview against. Its customer, ship-to address, carrier, and service level are used, and the commitment fields below replace whatever it currently carries.
	//
	// Omit it to preview an order that has not been created yet, supplying the parts directly.
	SalesOrderID field.Optional[string] `json:"sales_order_id,omitzero" validate:"omitempty"`
	// The buying account, used to resolve its lead time and receiving days.
	BuyerAccountID field.Optional[string] `json:"buyer_account_id,omitzero" validate:"omitempty"`
	// The ship-to address, which decides the destination timezone and the lane transit is quoted on.
	ShipToAddressID field.Optional[string] `json:"ship_to_address_id,omitzero" validate:"omitempty"`
	// Carrier for the shipment.
	CarrierID field.Optional[string] `json:"carrier_id,omitzero" validate:"omitempty"`
	// Service level for the shipment, which the lane's transit estimate is keyed on.
	ServiceLevelID field.Optional[string] `json:"service_level_id,omitzero" validate:"omitempty"`
	// When the order would be issued. Defaults to now, since a lead time is measured from issue and an order built today but issued next week commits to next week's date.
	IssuedAt field.Optional[time.Time] `json:"issued_at,omitzero"`
	// Date delivery would be promised to the customer.
	PromisedAt field.Optional[time.Time] `json:"promised_at,omitzero"`
	// Days between issue and the order being due to ship, in place of the customer's standing lead time.
	LeadTimeOverrideDays field.Optional[int32] `json:"lead_time_override_days,omitzero" validate:"omitempty,gte=0,lte=3650"`
	// The exact date the order would be due to ship.
	ShipByOverrideDate field.Optional[time.Time] `json:"ship_by_override_date,omitzero"`
}

type QuoteSalesOrderCommitmentResponse struct {
	// Resource type identifier.
	Object constants.ObjectType `json:"object" validate:"required,enum=sales_order_commitment_quote"`
	// The date the order would be due to ship, or null when no rule resolves one.
	ShipByDate *time.Time `json:"ship_by_date"`
	// That date at the plant's pickup cutoff — the moment freight would have to be tendered by. Null when the shipping calendar carries no cutoff.
	ShipByCutoffAt *time.Time `json:"ship_by_cutoff_at"`
	// Calendar days between issue and the ship-by date.
	LeadTimeDays *int32 `json:"lead_time_days"`
	// Which rule produced the date.
	LeadTimeSource *constants.LeadTimeSource `json:"lead_time_source"`
	// Days the carrier needs to cover the lane. Null when the lane has never been quoted and the service level carries no default, or when no service level was supplied to quote one on.
	TransitDays *int32 `json:"transit_days"`
	// Where the transit estimate came from.
	TransitSource *constants.TransitSource `json:"transit_source"`
	// When freight leaving on the ship-by date would reach the customer: transit walked forward from it and landed on a day their dock receives. Null whenever `transit_days` is, since an arrival with no journey behind it would just be the ship date wearing a different name.
	//
	// Reported for every basis, including the ones that do not use transit to decide the ship-by date. An order committed on a lead time has the same journey ahead of it; it simply was not worked backwards from.
	EstimatedDeliveryDate *time.Time `json:"estimated_delivery_date"`
	// Days the receiving and shipping calendars pulled the date back, beyond what transit accounted for.
	CalendarAdjustmentDays int32 `json:"calendar_adjustment_days"`
	// The derivation in order, one entry per rule that moved the date.
	Steps []apiresource.CommitmentQuoteStep `json:"steps"`
}

type QuoteSalesOrderFreightEndpoint struct{}

type QuoteSalesOrderFreightRequest struct {
	// Sales order ID.
	SalesOrderID string `path:"id" validate:"required"`
}

type QuoteSalesOrderFreightResponse struct {
	// Resource type identifier.
	Object constants.ObjectType `json:"object" validate:"required,enum=sales_order_freight_quote"`
	// Estimated freight unit price.
	UnitPrice *apiresource.ComputedRate `json:"unit_price"`
}

type QuoteSalesOrderLineInput struct {
	// ID of the product to price.
	ProductID string `json:"product_id" validate:"required"`
	// Quantity ordered.
	//
	// The unit must belong to the product's unit group.
	Quantity apirequest.QuantityInput `json:"quantity" validate:"required"`
}

type QuoteSalesOrderPricesEndpoint struct{}

type QuoteSalesOrderPricesRequest struct {
	// ID of the customer account the prices are for.
	BuyerAccountID string `json:"buyer_account_id" validate:"required"`
	// Lines to price.
	Lines []QuoteSalesOrderLineInput `json:"lines" validate:"required,min=1,dive"`
}

type QuoteSalesOrderPricesResponse struct {
	// Resource type identifier.
	Object constants.ObjectType `json:"object" validate:"required,enum=sales_order_price_quote"`
	// Priced lines, in the same order as the request.
	Lines *apiresource.List[QuotedSalesOrderLine] `json:"lines"`
}

type QuotedSalesOrderLine struct {
	// Resource type identifier.
	Object constants.ObjectType `json:"object" validate:"required,enum=sales_order_price_quote_line"`
	// The product priced.
	Product *apiresource.Product `json:"product"`
	// Calculated unit price.
	UnitPrice *apiresource.ComputedRate `json:"unit_price"`
}

type ReorderSalesOrderLinesEndpoint struct{}

type ReorderSalesOrderLinesRequest struct {
	// Sales order ID.
	SalesOrderID string `path:"id" validate:"required"`
	// The order's product-line IDs in the desired display order.
	//
	// Every product line on the order must be listed exactly once. The automatically generated discount and freight lines are kept at the bottom of the list and must not be included.
	LineIDs []string `json:"line_ids" validate:"required,min=1,dive,required"`
}

type RetrieveSalesOrderEndpoint struct{}

type RetrieveSalesOrderRequest struct {
	// Sales order ID.
	SalesOrderID string `path:"id" validate:"required"`
}

type SalesOrderEmailContactInput struct {
	// ID of the account user who should receive the notification.
	AccountUserID string `json:"account_user_id" validate:"required"`
}

type SalesOrderSvc interface {
	ListSalesOrders(ctx context.Context, req *ListSalesOrdersRequest) (*apiresource.List[apiresource.SalesOrder], *apierror.APIError)
	GetSalesOrder(ctx context.Context, req *RetrieveSalesOrderRequest) (*apiresource.SalesOrder, *apierror.APIError)
	CreateSalesOrder(ctx context.Context, req *CreateSalesOrderRequest) (*apiresource.SalesOrder, *apierror.APIError)
	UpdateSalesOrder(ctx context.Context, req *UpdateSalesOrderRequest) (*apiresource.SalesOrder, *apierror.APIError)
	DeleteSalesOrder(ctx context.Context, req *DeleteSalesOrderRequest) (*apiresource.EmptyResource, *apierror.APIError)
	BulkDeleteSalesOrders(ctx context.Context, req *BulkDeleteSalesOrdersRequest) (*apiresource.EmptyResource, *apierror.APIError)
	IssueSalesOrder(ctx context.Context, req *IssueSalesOrderRequest) (*apiresource.SalesOrder, *apierror.APIError)
	UnissueSalesOrder(ctx context.Context, req *UnissueSalesOrderRequest) (*apiresource.SalesOrder, *apierror.APIError)
	CloseSalesOrder(ctx context.Context, req *CloseSalesOrderRequest) (*apiresource.SalesOrder, *apierror.APIError)
	OpenSalesOrder(ctx context.Context, req *OpenSalesOrderRequest) (*apiresource.SalesOrder, *apierror.APIError)
	CheckoutSalesOrder(ctx context.Context, req *CheckoutSalesOrderRequest) (*CheckoutSalesOrderResponse, *apierror.APIError)
	QuoteSalesOrderPrices(ctx context.Context, req *QuoteSalesOrderPricesRequest) (*QuoteSalesOrderPricesResponse, *apierror.APIError)
	QuoteSalesOrderFreight(ctx context.Context, req *QuoteSalesOrderFreightRequest) (*QuoteSalesOrderFreightResponse, *apierror.APIError)
	QuoteSalesOrderCommitment(ctx context.Context, req *QuoteSalesOrderCommitmentRequest) (*QuoteSalesOrderCommitmentResponse, *apierror.APIError)
	CreateSalesOrderProductionRun(ctx context.Context, req *CreateProductionRunRequest) (*apiresource.ProductionRun, *apierror.APIError)
	CreateSalesOrderLine(ctx context.Context, req *CreateSalesOrderLineRequest) (*apiresource.SalesOrderLine, *apierror.APIError)
	UpdateSalesOrderLine(ctx context.Context, req *UpdateSalesOrderLineRequest) (*apiresource.SalesOrderLine, *apierror.APIError)
	DeleteSalesOrderLine(ctx context.Context, req *DeleteSalesOrderLineRequest) (*apiresource.EmptyResource, *apierror.APIError)
	ReorderSalesOrderLines(ctx context.Context, req *ReorderSalesOrderLinesRequest) (*apiresource.EmptyResource, *apierror.APIError)
}

type SalesOrderSvcConfig struct {
	// CoreClient (required) is the core-service sales gRPC client.
	CoreClient pb.CoreSalesServiceClient
}

type UnissueSalesOrderEndpoint struct{}

type UnissueSalesOrderRequest struct {
	// Sales order ID.
	SalesOrderID string `path:"id" validate:"required"`
}

type UpdateSalesOrderEndpoint struct{}

type UpdateSalesOrderLineEndpoint struct{}

type UpdateSalesOrderLineRequest struct {
	// Sales order ID.
	SalesOrderID string `path:"id" validate:"required"`
	// Sales order line ID.
	SalesOrderLineID string `path:"line_id" validate:"required"`
	// SKU recorded on the line.
	ProductSKU field.Optional[string] `json:"product_sku,omitzero" validate:"omitempty,max=255"`
	// Description recorded on the line.
	ProductDescription field.Clearable[string] `json:"product_description,omitzero"`
	// New quantity ordered on the line.
	Quantity field.Optional[apirequest.QuantityInput] `json:"quantity,omitzero" validate:"omitempty"`
	// Price charged per unit.
	//
	// Rounded to the nearest cent.
	UnitPrice field.Optional[apirequest.RateInput] `json:"unit_price,omitzero" validate:"omitempty"`
	// Internal cost per unit, used to derive line profitability.
	//
	// Rounded to the nearest cent.
	UnitCost field.Optional[apirequest.RateInput] `json:"unit_cost,omitzero" validate:"omitempty"`
}

type UpdateSalesOrderRequest struct {
	// Sales order ID.
	SalesOrderID string `path:"id" validate:"required"`
	// The customer's own purchase order number, for cross-referencing.
	CustomerPurchaseOrderNumber field.Clearable[string] `json:"customer_purchase_order_number,omitzero" validate:"omitempty,max=255"`
	// Free-form note about the order.
	Note field.Clearable[string] `json:"note,omitzero"`
	// ID of the carrier that will ship the order.
	CarrierID field.Optional[string] `json:"carrier_id,omitzero" validate:"omitempty"`
	// ID of the carrier service level the order ships on.
	ServiceLevelID field.Clearable[string] `json:"service_level_id,omitzero" validate:"omitempty"`
	// Who is billed for freight.
	//
	// - `sender`: the sender pays for shipping.
	// - `third_party`: a third party pays for shipping, using the carrier billing account number.
	CarrierBillingType field.Clearable[constants.CarrierBillingType] `json:"carrier_billing_type,omitzero" validate:"omitempty"`
	// Carrier billing account number charged when `carrier_billing_type` is `third_party`.
	CarrierBillingAccountNumber field.Clearable[string] `json:"carrier_billing_account_number,omitzero" validate:"omitempty,max=255"`
	// New fulfillment priority for the order.
	PriorityCode field.Optional[constants.PriorityCode] `json:"priority_code,omitzero" validate:"omitempty"`
	// ID of the account user to credit as the order's sales rep.
	SalesRepID field.Clearable[string] `json:"sales_rep_id,omitzero" validate:"omitempty"`
	// ID of the shipping terms for the order.
	ShippingTermID field.Optional[string] `json:"shipping_term_id,omitzero" validate:"omitempty"`
	// ID of the payment terms for the order.
	PaymentTermID field.Optional[string] `json:"payment_term_id,omitzero" validate:"omitempty"`
	// ID of the order-level discount recorded on the order.
	//
	// Changing this does not add, reprice, or remove the order's discount line; adjust that line directly.
	OrderDiscountID field.Clearable[string] `json:"order_discount_id,omitzero" validate:"omitempty"`
	// Billing address ID.
	//
	// Re-points the order to an existing address. To change an address's contents, use the update-address endpoint.
	BillingAddressID field.Optional[string] `json:"billing_address_id,omitzero" validate:"omitempty"`
	// Shipping address ID.
	//
	// Re-points the order to an existing address. To change an address's contents, use the update-address endpoint.
	ShippingAddressID field.Optional[string] `json:"shipping_address_id,omitzero" validate:"omitempty"`
	// Acknowledgment status of the order.
	//
	// Set to `sent` to mark the acknowledgement as sent without emailing the customer, or `not_sent` to reset it.
	AcknowledgmentStatus field.Optional[constants.AcknowledgmentStatus] `json:"acknowledgment_status,omitzero" validate:"omitempty"`
	// Date delivery is promised to the customer.
	PromisedAt field.Clearable[time.Time] `json:"promised_at,omitzero"`
	// Days between this order being issued and it being due to ship, replacing the customer's standing lead time for this order alone. Mutually exclusive with promised_at and ship_by_override_date; clear one to switch to another.
	LeadTimeOverrideDays field.Clearable[int32] `json:"lead_time_override_days,omitzero" validate:"omitempty,gte=0,lte=3650"`
	// The exact date the order is due to ship, bypassing transit and the customer's receiving days. Mutually exclusive with promised_at and lead_time_override_days.
	ShipByOverrideDate field.Clearable[time.Time] `json:"ship_by_override_date,omitzero"`
	// Moves the order to a different customer account.
	//
	// Existing lines keep the prices they were created with; they are not re-priced against the new customer.
	CustomerID field.Optional[string] `json:"customer_id,omitzero" validate:"omitempty"`
	// Replaces the acknowledgement email contacts on the order.
	//
	// An empty list clears all contacts; omitting the field leaves existing contacts untouched.
	AcknowledgementEmailContacts field.Optional[[]SalesOrderEmailContactInput] `json:"acknowledgement_email_contacts,omitzero"`
	// Replaces the invoice email contacts on the order.
	//
	// An empty list clears all contacts; omitting the field leaves existing contacts untouched.
	InvoiceEmailContacts field.Optional[[]SalesOrderEmailContactInput] `json:"invoice_email_contacts,omitzero"`
}