This documentation supports the 19.02 version of Asset Management.

To view the latest version, select the version from the Product version menu.

Update_PurchaseRequisition

This operation supports the update of an existing parent purchase requisition, and updates to related children purchase line items and work information records. The qualification entered determines which purchase requisitions are updated, only child records related to the parent can be updated. In addition children purchase line items and work information records can also be created.

The following table lists input values for the parent level of the Update_PurchaseRequisition operation and maps to the AST:PurchaseRequisitionInterface form.

Input field values

DB field on interface form

Displayed on web services

Notes

Qualification

AR System qualification required and is based on AST:PurchaseRequisitionInterface fields.

instanceId

InstanceID

Requisition ID

RequisitionID

Status

Status

Date Required

DateRequired

Description

Description

Justification

Justification

For_Company

RequestedForCompany

Requested_For_PersonID

RequestedForPersonID

For_Full Name

RequestedForFullName

Login Name

RequestedForLoginName

For_Phone

RequestedForPhoneNumber

For_Department

RequestedForDepartment

Manager Name

ManagerFullName

Manager Login Name

ManagerLoginName

By_Company

RequestedByCompany

Requested_By_PersonID

RequestedByPersonID

By_Full Name

RequestedByFullName

Requester Login Name

RequestedByLoginName

By_Phone

RequestedByPhoneNumber

By_Department

RequestedByDepartment

Shipping Instructions

ShippingInstructions

PRNumber

PRNumber

DataTags

DataTags

Install Needed

InstallNeeded

Cost Center

CostCenter

Accounting Code

AccountingCode

Project Number

ProjectNumber

Budget Code

BudgetCode

BillToAddr_Street

BillToStreet

BillToAddr_City Name+

BillToCity

BillToAddr_State Prov+

BillToStateProv

BillToAddr_Postal Code+

BillToPostalCode

BillToAddr_Country+

BillToCountry

ShipToAddr_Street

ShipToStreet

ShipToAddr_City Name+

ShipToCity

ShipToAddr_State Prov+

ShipToStateProv

ShipToAddr_Postal Code+

ShipToPostalCode

ShipToAddr_Country+

ShipToCountry

Assigned Support Company

SupportCompany

Assigned Support Organization

SupportOrganization

Assigned Group

AssignedGroup

Assignee

Assignee

TemplateInstanceID

ChangeTemplateInstanceID

The following table lists input values for the child level of the Update _PurchaseRequisition operation and maps to the AST:PurchaseRequisitionWorkLog form.

Input field values

DB field on form

Displayed on web services

Notes

InstanceId

WorkInfoInstanceId

Provides the work information Instance ID to be updated. If a new Instance ID is provided (one that is not in the database), a new work information record will be created.

PR Instance ID

SourceInstanceID

This is the foreign key, purchase requisition Instance ID, which the work information is linked to, and required if creating a new work information record.

Work Log Type

WorkInfoType

Required if creating a work information record. Supported values are: Detailed Clarification, Purchase Requisition Task, General Information, Email System,and Paging System.

Work Log Date

WorkInfoDate

Required if creating a work information record.

Communication Source

WorkInfoSource

Required if creating a work information record. Supported values are: Email, Fax, Phone, Voice Mail, Walk In, Pager, System Assignment, Web, and Other.

Description

WorkInfoSummary

Required if creating a work information record.

Detailed Description

WorkInfoNotes

Optional if creating a work information record.

Secure Work log

WorkInfoLocked

Required if creating a work information record. Supported values are "Yes" or "No."

View Access

WorkInfoViewAccess

Required if creating a work information record. Supported values are "Internal" or "Public."

z2AF Work Log01/attachmentName

WorkInfoAttachment1Name

Optional if creating a work information record.

z2AF Work Log01/attachmentData

WorkInfoAttachment1Data

Optional if creating a work information record.

z2AF Work Log01/attachmentOrigSize

WorkInfoAttachment1OrigSize

Optional if creating a work information record.

z2AF Work Log02/attachmentName

WorkInfoAttachment2Name

Optional if creating a work information record.

z2AF Work Log02/attachmentData

WorkInfoAttachment2Data

Optional if creating a work information record.

z2AF Work Log02/attachmentOrigSize

WorkInfoAttachment2OrigSize

Optional if creating a work information record.

z2AF Work Log03/attachmentName

WorkInfoAttachment3Name

Optional if creating a work information record.

z2AF Work Log03/attachmentData

WorkInfoAttachment3Data

Optional if creating a work information record.

z2AF Work Log03/attachmentOrigSize

WorkInfoAttachment3OrigSize

Optional if creating a work information record.

The following table lists input values for the child level of the Update_PurchaseRequisition operation and maps to the AST:PurchaseLineItem form.

Input field values

DB field on form

Displayed on web services

Notes

instanceId

InstanceID

Provide the purchase line item Instance ID to be updated. If a new Instance ID is provided, a purchase line item will be created.

Part Number

PartNumber

Required if creating a new purchase line item.

Description

Description

Required if creating a new purchase line item.

Status

Status

Required if creating a new purchase line item.

Asset Class ID

AssetClassID

Required if creating a new purchase line item in the format of CI Keyword. For example, BMC_COMPUTERSYSTEM.

Asset Class

AssetClass

Required if creating a new purchase line item in the format of Proper Name of CI.

RequestedFor_Company

RequestedForCompany

Required if creating a new purchase line item.

Unit of Measure

UnitOfMeasure

Required if creating a new purchase line item.

Required Qty*

RequiredQty

Required if creating a new purchase line item.

Received Qty

ReceivedQty

Unit Price/currencyValue

UnitPriceAmount

If a value is provided, must provide the currency code.

Unit Price/currencyCode

UnitPriceCurrencyCode

Must provide a currency value if currency code is provided.

Estimated Price/currencyValue

EstimatedPriceAmount

If a value is provided, must provide the currency code.

Estimated Price/currencyCode

EstimatedPriceCurrency Code

Must provide a currency value if currency code is provided.

Actual Price/currencyValue

ActualPriceAmount

If a value is provided, must provide the currency code.

Actual Price/currencyCode

ActualPriceCurrency Code

Must provide a currency value if currency code is provided.

Taxable

Taxable

Supported values are "Yes" or "No".

Tax Amount/currencyValue

TaxAmount

If a value is provided, must provide the currency code.

Tax Amount/currencyCode

TaxCurrencyCode

Must provide a currency value if currency code is provided.

Tax Rate

TaxRate

If Taxable = "Yes", must provide rate.

Shipping & Handling/currencyValue

ShippingAndHandling Amount

If a value is provided, must provide the currency code.

Shipping & Handling/currencyCode

ShippingAndHandling CurrencyCode

Must provide a currency value if currency code is provided.

Product Categorization Tier 1

ProductTier1

Required if creating a new purchase line item, and CI Type is Software Class.

Product Categorization Tier 2

ProductTier2

Required if creating a new purchase line item, and CI Type is Software Class.

Product Categorization Tier 3

ProductTier3

Required if creating a new purchase line item, and CI Type is Software Class.

Model

ProductName

Required if creating a new purchase line item, and CI Type is Software Class.

Version Number

ModelVersion

MarketVersion

MarketVersion

Required if creating a new purchase line item, and CI Type is Software Class.

Manufacture Name+

Manufacturer

Required if creating a new purchase line item, and CI Type is Software Class.

Supplier Name+

SupplierName

Required if creating a new purchase line item.

Date Required

DateRequired

Required if creating a new purchase line item.

Date Ordered

DateOrdered

Required if creating a new purchase line item, CI Type is Software Class, and Auto receive is set to "Yes" or if Status is On Order or higher.

Estimated Receiving Date

DateToReceive

LicenseCertificateType

CertificatePurchaseType

Required if creating a new purchase line item, and Software Contract ID is provided.

Software Contract ID

SoftwareContractID

Either SoftwareContractID or Certificate ID is required if creating a new line, and CI Type is Software Class.

zID_LicenseType

LicenseType

Required if Software Contract ID is provided. Need to provide the license type GUID. In order to get this, user must go to the interface form and use the drop down box to select the type. The GUID will be displayed when type is selected. This value is the value used.

zID_CertificateID

CertificateID

Either SoftwareContractID or Certificate ID is required if CI Type is Software Class. If the CertificateID is specified, it must be a valid Certificate ID and should not be related to another purchase line item.

PRNumber

PRNumber

PO Number

PO]Number

Quote Number

QuoteNumber

QuoteDesc

QuoteInfo

Data Tags

Data Tags

Cost Center

CostCenter

Required if creating a new purchase line item, and Software Contract ID is provided.

Accounting Code

AccountingCode

Project Number

ProjectNumber

Budget Code

BudgetCode

Attachment1/attachmentName

PLIAttachment1Name

Attachment1/attachmentData

PLIAttachment1Data

Attachment1/attachmentOrigSize

PLIAttachment1OrigSize

Notes to Purchasing

NotesToPurchasing

Notes to Supplier

NotesToSupplier

The following table lists output values for the parent level of the Update_PurchaseRequisition operation from the AST:PurchaseRequisitionInterface form.

Output field values

DB field on interface form

Displayed on web services

Notes

InstanceId

InstanceID

Unique identifier for each updated purchase requisition.

Requisition ID

RequisitionID

Unique visible Requisition ID for each updated purchase requisition.

The following table lists output values for the child level of the Update_PurchaseRequisition operation from the AST:PurchaseRequisitionWorkLog form.

Output field values

DB field on interface form

Displayed on web services

Notes

InstanceId

InstanceID

Unique identifier for each updated or added work information record.

The following table lists output values for the child level of the Update_PurchaseRequisition operation from the AST:PurchaseLineItem form.

Output field values

DB field on interface form

Displayed on web services

Notes

InstanceId

InstanceID

Unique identifier for each updated or added purchase line item.

Was this page helpful? Yes No Submitting... Thank you

Comments