Getting StartedAPI Reference
API Reference

Executes the Add action for the Import Estimate Materials V2 data object.

post
https://{apiHost}/connect/v1/direct/subscribers//vista/pm/2/data/imp_est_materials_v2/actions/add

Adds a single staged material row to PM Import Estimate Materials.

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

Schema for adding a single staged material row to PM Import Estimate Materials (PMWM).

integer
required
1 to 255

PM company. Key to pm/projects(PMCo, Project).

string
required
length ≤ 10

Import ID grouping staged estimate rows for a single import/upload workflow.

integer
required

Line sequence within the import. Key component with PMCo and ImportId.

string | null

Contract item assigned to the material line.

integer
required

Phase group. Key to jc/cost_types(PhaseGroup, CostType).

string
required
length ≤ 20

Project phase for the material line.

integer
required

Cost type for the material line.

integer
required

Material group. Key to hq/materials(MatlGroup, Material).

string | null

Material code.

string | null

Material description.

integer
required

Vendor group.

integer | null

Vendor number.

string | null

Unit of measure.

string
required
^[-+]?[0-9]{1,9}(?:.[0-9]{0,3})?$

Material units (numeric(12,3)).

string
required
^[-+]?[0-9]{1,11}(?:.[0-9]{0,5})?$

Unit cost.

string
required
length ≤ 1

Equipment / cost / material flag (E, C, or M).

string
required
^[-+]?[0-9]{1,10}(?:.[0-9]{0,2})?$

Material amount.

string | null

Imported contract item code from the source estimate file.

string | null

Imported phase code from the source estimate file.

string | null

Imported cost type from the source estimate file.

string | null

Imported material code from the source estimate file.

string | null

Imported vendor code from the source estimate file.

string | null

Imported unit of measure from the source estimate file.

string | null

Imported misc field 1 from the source estimate file.

string | null

Imported misc field 2 from the source estimate file.

string | null

Imported misc field 3 from the source estimate file.

string | null

Material line notes.

string | null

Material option flag.

string | null

Received flag.

string | null

Inventory location.

integer | null

Tax group.

string | null

Tax code.

integer | null

Tax type.

string | null

Send/interface flag.

integer | null

Material sales company.

string | null

Quote reference.

integer | null

Inventory company.

integer | null

Supplier number.

string | null
[0-9a-fA-F]{8}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{12}

Attachment group ID.

__custom_fields
object

Present when custom fields are defined for PMWM in Vista.

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 3 hours ago

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

Updated about 3 hours ago