v1

latestOpenAPI 3.0.12026-07-267912192.3 MB
Vendors

Executes the Change action for the Vendors data object.

Changes an existing Vendor record.

post/direct/subscribers/{subscriber_code}/vista/ap/2/data/vendors/actions/change

Path parameters

subscriber_codestring required

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

Headers

X-Application-Keystring required

Used to authorize access to the Direct API.

Request body

APCointeger required

The AP Company you are working with.

SortNamestring

Optional.

Namestring nullable

Optional.

Typestring

Options: R-Regular, S-Supplier. Optional.

TempYN'Y' | 'N'

Optional.

Contactstring nullable

Optional.

Phonestring nullable

Optional.

Faxstring nullable

Optional.

EMailstring nullable

Optional.

URLstring nullable

Optional.

Customerinteger nullable

Reference to Customer if this Vendor is also a Customer. Key to ar/customers(CustGroup, Customer). CustGroup is determined based on supplied APCo. Optional.

TaxCodestring nullable

Default sales/use TaxCode for non-job transactions. Key to hq/tax_codes(TaxGroup, TaxCode) TaxGroup based on the Provided ARCo. Optional.

PayTermsstring nullable

Key to hq/payment_terms(PayTerms). Optional.

GLAcctstring nullable

Default account for expense transactions. Optional.

V1099YN'Y' | 'N'

US-Subject to 1099 reporting, AU- Subject to Taxable Payments Reporting, CA-Subject to T5018 reporting. Optional.

V1099Typestring nullable

US based APCo only. Optional. Input is ignored if $.V1099YN != Y.

V1099Boxinteger nullable

US based APCo only. Optional. Input is ignored if $.V1099YN != Y.

V1099AddressSeqinteger nullable

Reference to AddressSeq in the AdditionalAddresses array. Optional. Input is ignored if $.V1099YN != Y.

TaxIdstring nullable

[PROTECTED FIELD] US based APCo only. Optional.

Propstring nullable

US based APCo only. Proprietor name to be included on 1099 processing. Optional. Input is ignored if $.V1099YN != Y.

OverrideMinAmtYN'Y' | 'N'

US based APCo only. Override the minimum amount for a 1099 download. Optional. Input is ignored if $.V1099YN != Y.

ActiveYN'Y' | 'N'

Optional.

LastInvDatestring date nullable

Format: YYYY-MM-DD. Optional.

Notesstring nullable

Optional.

SeparatePayInvYN'Y' | 'N'

Optional.

MasterVendorinteger nullable

Optional.

APRefUnqOvr0 | 1 | 2 | 3 | 4

Override unique APRef Level. Options: 0-No Override, 1-By Vendor & Co, 2-By Vendor & Cross-Co, 3-By Master Vendor & Co, 4-By Master Vendor & Cross-Co. Optional.

PayInfoDelivMthd'N' | 'A' | 'E'

Options: N-None, A-Email Attachment, E-Email Notice. Optional.

CMAcctinteger nullable

Default CM Account. Optional.

PayControlstring nullable

Default PayControl for Invoices. Optional.

VendorAcctNumberstring nullable

[PROTECTED FIELD] Used with Viewpoint ePay. Optional.

SubcontractorYN'Y' | 'N'

Used with Viewpoint ePay. Optional.

Reviewerstring nullable

Key to hq/reviewers(Reviewer). Optional.

__custom_fieldsobject

This property will be added if there are any custom fields defined for this object in Vista. Each custom field will be a property of this object.

Response

Success

idstring
operationstring
statusstring