Getting StartedAPI Reference
API Reference

Executes the Change action for the Purchase Order Batch Entries data object.

post
https://api.xchange.trimble.com/connect/v1/direct/subscribers//vista/po/2/data/po_batch_entries/actions/add_change

Adds an existing purchase order transaction to an purchase order batch, in order to update it.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The code of the subscriber that you are making this request for.

Body Params
integer
required

Key to po/po_batches(Co, Mth, BatchId).

__purchase_orders_key
required

Provide the key of the po/po_header object to edit in this batch entry.

integer | null

Key to ap/vendors(VendorGroup, Vendor). VendorGroup value is defaulted based on the Co value.

string | null

Optional. If omitted, null will be defaulted.

date

Format: YYY-MM-DD. Optional. If omitted, it will be defaulted to the current date.

string | null

Person placing the order. Optional. If omitted, null will be defaulted.

string | null

Expected Date. Format: YYY-MM-DD. Optional. If omitted, null will be defaulted.

integer

Options: 0-Open, 1-Complete, 2-Close. Optional. If omitted, 0 will be defaulted.

integer | null

Key to jc/jobs(JCCo, Job). Optional. If omitted, null will be defaulted.

string | null

Key to jc/jobs(JCCo, Job). Optional. If omitted, null will be defaulted. Default Job for this Purchase order. The shipping location will be defaulted based on this Job as well as the Job on the Line types if not overridden.

integer | null

Key to in/locations(INCo, Loc). Optional. If omitted, null will be defaulted.

string | null

Key to in/locations(INCo, Loc). Optional. If omitted, null will be defaulted. Default Inventory Location for this Purchase order. The shipping location can be defaulted based on this Location as well as the Loc on the Line types if not overridden.

string | null

Key as found in PO Shipping Locations application.

ShipAddress
object

Optional. If omitted, each property will be defaulted as noted on the property.

integer | null

Override Vendor's standard Payment Address. Key to AdditionalAddresses array in ap/vendors(VendorGroup, Vendor, AdditionalAddresses.Seq). VendorGroup value is defaulted based on the Co value. Optional. If omitted, null will be defaulted.

integer | null

Override Vendor's standard Purchasing Address. Key to AdditionalAddresses array in ap/vendors(VendorGroup, Vendor, AdditionalAddresses.Seq). VendorGroup value is defaulted based on the Co value. Optional. If omitted, null will be defaulted.

string | null

Key to hq/hold_codes(HoldCode). Optional. If omitted, will be defaulted based on Vista defaulting logic.

string | null

Key to hq/payment_terms(PayTerms). Optional. If omitted, will be defaulted based on Vista defaulting logic.

string | null

Key to hq/compliance_groups(CompGroup). Optional. If omitted, null will be defaulted.

string | null
integer | null

Optional. If omitted, null will be defaulted.

integer | null

Optional. If omitted, null will be defaulted.

string
enum

Prevent Auto Close from final invoice. Optional. If omitted, N will be defaulted.

Allowed:
__custom_fields
object

Add properties to this object with the property name matching the user defined field name in Vista for each user defined field you need to set.

boolean | null

Disable Vista Validations

LineItems
array

Use this array to Add, Replace, Change, or Remove PO lines. Specify the TransType and ItemType to establish the rules for the rest of the line input. You can not use the TransType = Change to change the ItemType. If you need to modify the line type and keep the same POItem value, then you must use the TransType = Replace. If you do not need to keep the same POItem, you can do a TransType = Remove, and a second __TransType = Add.

LineItems
Headers
string
required

Used to authorize access to the Direct API.

Responses

401

You have not provided a proper X-Application-Key in the header of this request.

403

The X-Application-Key provided is valid but the key does not have access to this resource.

404

The object with the given ID was not found OR a subscriber with the given URL was not found.

Updated about 1 month ago

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 month ago