creating bmc asset management web services-v7-20151201_0806

7/23/2019 Creating BMC Asset Management Web Services-V7-20151201_0806

1/51

BMC Software Confidential. BladeLogic Confidentia

BMC Asset Management version 8.1.01

URL:

Date: 01-Dec-2015 08:06

https://docs.bmc.com/docs/pages/viewpage.action?

pageId=599219853


2/51

Creating BMC Asset Management web services BMC Software Confidential. BladeLogic Confidential.

BMC Asset Management 8.1.01 Page of2 51

Table of Contents

1 AST_PurchaseRequisitionInterface_Create_WS ___________________________________________________ 51.1 Create_PurchaseRequisition _______________________________________________________________ 5

2 AST_PurchaseRequisition_QueryModify_WS _____________________________________________________ 12

2.1 Query_PurchaseRequisition ______________________________________________________________ 12

2.2 AST-PurchaseRequisitionInterface (Query) __________________________________________________ 12

2.3 Update_PurchaseRequisition _____________________________________________________________ 17

3 AST_PurchaseOrder_QueryModify_WS _________________________________________________________ 23

3.1 Query_PurchaseOrder __________________________________________________________________ 23

3.2 Update_PurchaseOrder __________________________________________________________________ 26

4 AST_PurchaseLineItem_QueryModify_WS _______________________________________________________ 30

4.1 Query_PurchaseLineItem ________________________________________________________________ 304.2 Update_PurchaseLineItem _______________________________________________________________ 34

5 AST_WorkInfoInterface_Create_WS ____________________________________________________________ 37

5.1 Create_WorkInfo _______________________________________________________________________ 37

6 AST_PurchaseOrder_WS and AST_PurchaseOrder_WS_noDate _____________________________________ 39

6.1 Update_PO_Confirmation ________________________________________________________________ 40

6.2 Get_Specific_PO _______________________________________________________________________ 40

6.3 Get_List_Of_New_POs __________________________________________________________________ 42

7 AST_PurchaseOrderInterface_WS _____________________________________________________________ 44

7.1 PO_Modify_Service _____________________________________________________________________ 44

7.2 PO_Query_Service _____________________________________________________________________ 45

7.3 PO_GetListofNewPO_Service _____________________________________________________________ 46

8 AST_CIUnavailabilityInterface_WS _____________________________________________________________ 48

8.1 GetListOfUnavailability function ____________________________________________________________ 48

9 Index ____________________________________________________________________________________ 49


3/51



In BMC Asset Management, you can use web services to query and update purchase requisitions, purchase line

items, purchase work information records, purchase orders, and purchase returns.

The following is a list of the interface forms available for BMC Asset Management. These interface forms are

described as used by web services in the sections that follow.

AST:PurchaseRequisitionInterface_Create creates a purchase requisition and related work information

record.

AST:PurchaseLineItemInterface_Create creates a purchase line item and related work information record A

purchase order can be created depending on the input status.

AST:WorkInfoInterface_Create creates a work information record for either purchase requisition or purchase

line item.

AST:PurchaseRequisitionInterface queries and modifies a purchase requisition.

AST:PurchaseOrderInterface queries and modifies a purchase order.

AST:PurchaseLineItemInterface queries and modifies a purchase line item.

The interface create forms can have the following sectional headers under which fields are grouped. Some fields

shown on the interface forms are not mapped in the web services because they are either set by workflow or system-

generated. Fields where values are input are described in the web service mapping tables.

Required Input Field Values Fields where a value must be input

Conditional Required Input Field Values Fields that may require a value depending on other fields which are

input

Optional Input Field Values Fields where a value can optionally be input

Fields Set through Workflow Fields that are set by workflow, and therefore do not require any input value

Fields Set through Workflow or Input Values Fields that can be set by workflow but also support the option of

inputting a valueChange Management Integration fields Fields that can be used if BMC Change Management is installed

PO Creation Field Values Fields that can be input if creating a Purchase Order

Reference Numbers Generated Fields that are generated as a result of the create operation

More operations are available via web services. The following is a list of the web services available for BMC Asset

Management. These web services are described in the topics in this section.

AST_PurchaseRequisitionInterface_Create_WS (see page 5)- supports the creation of parent purchase

requisitions and child purchase line items It also supports the creation of a work information record for parent

and child items. A purchase order can be created depending on the status of the purchase requisition and

purchase line items.

AST_PurchaseRequisition_QueryModify_WS (see page 12) queries and modifies purchase requisitions

and its work information records and purchase line items

AST_PurchaseOrder_QueryModify_WS (see page 23) queries and modifies purchase orders and its

purchase line items

AST_PurchaseLineItem_QueryModify_WS (see page 30) queries and modifies purchase line items and its

work information records and return records


4/51



AST_WorkInfoInterface_Create_WS (see page 37) supports the creation of work information records for

either a purchase requisition or purchase line item

Note

The following existing web services will be phased out as the functionality becomes available in the above

new web services.

AST_PurchaseOrder_WS (see page 39) updates and queries both purchase orders with the date included

and purchase order line items

AST_PurchaseOrder_WS_noDate (see page 39) updates and queries both purchase orders without the

date and purchase order line items

AST_PurchaseOrderInterface_WS (see page 44) updates and queries purchase orders with the date, but

without purchase order line items

AST_CIUnavailabilityInterface_WS (see page 48) queries for a list of Unavailability records that are related

to a CI.


5/51



1 AST_PurchaseRequisitionInterface_Create_WSThe purchase requisition create web service is a complex web service based on the PurchaseRequisitionCreate.xsd

file, which is also provided. This web service contains one operation.

Create_PurchaseRequisition (see page 5)

1.1 Create_PurchaseRequisitionThis operation lets you create parent purchase requisitions and child purchase line items. It also creates a work

information record for parent and child items if input values are supplied.

Recommendation

If you are creating a purchase requisition with a status higher than In Preparation, provide all the purchase

line items while using the Create_PurchaseRequisition operation.

The following table lists input values for the parent level of the Create_PurchaseRequisition operation and maps to the

AST:PurchaseRequisitionInterface_Create form.

Input field values

DB field on interfaceform

Displayed on web services Notes

zID_Action Action Required field "CREATE" is the only keyword supported and must be in uppercase

Status Status Required field Accepted status values: In Preparation, On Order, Partially Received,

Received, Closed, and Cancelled

Date Required DateRequired Required field

Description Description Required field

Justification Justification Required field

For_Company RequestedForCompany Required field

Requested_For_PersonID RequestedForPersonID Required if RequestedForFullName is not provided

For_Full Name RequestedForFullName Required if RequestedForPersonID is not provided

Login Name RequestedForLoginName

For_Phone RequestedForPhoneNumber

For_Department RequestedForDepartment


6/51



DB field on interface

form


Manager Name ManagerFullName By default this is the manager of the Requested For person, and is used as the first

approver by the provided process. If the status is In Preparation. then a value is

recommended. A Full Name other than the actual manager can be supplied.

Manager Login Name ManagerLoginName Login identifier of the value supplied for Manager Name

By_Company RequestedByCompany Required field

Requested_By_PersonID RequestedByPersonID Required if RequestedByFullName is not provided

By_Full Name RequestedByFullName Required if RequestedByPersonID is not provided

Requester Login Name RequestedByLoginName

By_Phone RequestedByPhoneNumber

By_Department RequestedByDepartment

Shipping Instructions ShippingInstructions

PRNumber PRNumber Available for storing external procurement system reference number

DataTags DataTags Hidden field that can store a tag identifier

Install Needed InstallNeeded Supported values are Yes or No

Cost Center CostCenter

Accounting Code AccountingCode

Project Number ProjectNumber

Budget Code BudgetCode

z1D_Activity_Type WorkInfoType Required if creating a work information record

z1D_ActivityDate_tab WorkInfoDate Required if creating a work information record

z1D_Communication

Source

WorkInfoSource Required if creating a work information record

z1D_Summary WorkInfoSummary Required if creating a work information record

z1D_Details WorkInfoNotes Required if creating a work information record

z1D_Secure_Log WorkInfoLocked Required if creating a work information record

z1D_View Access WorkInfoViewAccess Required if creating a work information record. Supported values are "Internal" or

"External."

z2AF_Act_Attachment_1

/attachmentName

WorkInfoAttachment1Name Optional if creating a work information record


/attachmentData

WorkInfoAttachment1Data Optional if creating a work information record


/attachmentOrigSize

WorkInfoAttachment1OrigSize Optional if creating a work information record


7/51




form



/attachmentName



/attachmentData



/attachmentOrigSize



/attachmentName



/attachmentData



/attachmentOrigSize


BillToAddr_Street BillToStreet Bill To fields are required and will be set based on Requested For.

BillToAddr_City Name+ BillToCity

BillToAddr_State Prov+ BillToStateProv

BillToAddr_Postal Code+ BillToPostalCode

BillToAddr_Country+ BillToCountry

ShipToAddr_Street ShipToStreet Ship To fields are required and will be set based on Requested For.

ShipToAddr_City Name+ ShipToCity

ShipToAddr_State Prov+ ShipToStateProv

ShipToAddr_Postal

Code+

ShipToPostalCode

ShipToAddr_Country+ ShipToCountry

Assigned Support

Company

SupportCompany Assigned field values can be automatically set by workflow if a Group Assignment General

event is defined.

Assigned Support

Organization

SupportOrganization

Assigned Group AssignedGroup

Assignee Assignee

TemplateInstanceID ChangeTemplateInstanceID Integration available if Change Management is installed. Specify the CHG Template ID

(FieldID 179) which can be found in the CHG:Template form. If value is supplied then

Installed Needed should be set to Yes.

The following table lists input values for the child level of the Create_PurchaseRequisition operation and maps to the

form.AST:PurchaseLineItemInterface_Create

Input field values


8/51



DB field on interface form Displayed on web services Notes

zID_Action Action Required field "CREATE" is the only keyword supported and must be in upper case.

Part Number PartNumber Required field

Short Description Description Required field

Status Status Required field Accepted status values: In Preparation, On Order, Partially Received,

Received, and Cancelled.

Asset Class ID AssetClassID Required field in the format of CI Keyword, for example BMC_COMPUTERSYSTEM.

Unit of Measure UnitOfMeasure

Required Qty* RequiredQty Required field

Total Received Qty TotalReceivedQty Required if auto receive is set to yes and CI Type is Software Class or if Status is

Received.

Unit Price/currencyValue UnitPriceAmount I f a value is provided, must provide the currency code. If Unit Pr ice is 0 and if the order

status is "In Preparation", then the Status of PLI will switch to Pending Pricing.

Unit Price/currencyCode UnitPriceCurrency Code 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

EstimatedPriceCurrencyCode Must provide a currency value if currency code is provided.

Actual Price/currencyValue ActualPriceAmount I f 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 Set to "Yes" if Tax Amount is supplied.

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 CI Type is Software Class.


2



3


Model ProductName Required if CI Type is Software Class.

Version Number ModelVersion


9/51




MarketVersion MarketVersion Required if CI Type is Software Class.

Manufacture Name+ Manufacturer Required if CI Type is Software Class.

Supplier Name+ SupplierName Required for most Status values. If Supplier is not filled in while In Preparation then the

Status will switch to Pending Pricing.

Date Required DateRequired Required field

Date Ordered DateOrdered Required if Status is On Order or greater.

Estimated Receiving Date DateToReceive

LicenseCertificateType CertificatePurchaseType Required if Software Contract ID is used

Software Contract ID SoftwareContractID Either SoftwareContractID or Cert ificate ID is required if CI Type is Software Class.

LicenseTypeGUID LicenseType Required if Software Contract ID is used. 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.

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 Available for storing external procurement system reference number.

PO Number PONumber Available for storing external purchase order reference number.

Quote Number QuoteNumber

QuoteDesc QuoteInfo

Data Tags Data Tags Hidden field that can store a tag identifier.

Cost Center CostCenter Required if Software Contract ID is used.




Attachment1

/attachmentName

PLIAttachment1Name

Attachment1

/attachmentData

PLIAttachment1Data

Attachment1

/attachmentOrigSize

PLIAttachment1OrigSize

Notes to Purchasing NotesToPurchasing

Notes to Supplier NotesToSupplier

Notes EnterNotes

zID_Activity_Type WorkInfoType Required if creating a work information record.


10/51




zID_ActivityDate_Tab WorkInfoDate Required if creating a work information record.

zID_CommunicationSource WorkInfoSource Required if creating a work information record.

zID_Summary WorkInfoSummary Required if creating a work information record.

zID_Detailes WorkInfoNotes Required if creating a work information record.


/attachmentName

WorkInfoAttachment1Name Optional if creating a work information record.


/attachmentData

WorkInfoAttachment1 Data Optional if creating a work information record.


/attachmentOrigSize

WorkInfoAttachment1

OrigSize

Optional if creating a work information record.


/attachmentName

WorkInfoAttachment2 Name Optional if creating a work information record.


/attachmentData



/attachmentOrigSize

WorkInfoAttachment2

OrigSize



/attachmentName

WorkInfoAttachment3 Name Optional if creating a work information record.


/attachmentData



/attachmentOrigSize

WorkInfoAttachment3

OrigSize


zID_Secure_Log WorkInfoLocked Required if creating a work information record.

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

"External."

Buyer Name BuyerName Will be stored in the Purchase Order if one is generated.

OrderConfirmationTypeCode ConfirmationCode Will be stored in the Purchase Order if one is generated.

Payment Terms PaymentTerms Will be stored in the Purchase Order if one is generated.

Freight Terms FreightTerms Will be stored in the Purchase Order if one is generated.

Ship Via ShipVia Will be stored in the Purchase Order if one is generated.

Shipping Options ShippingOptions Will be stored in the Purchase Order if one is generated.

The following table lists output values for the parent level of the Create_PurchaseRequisition operation from the AST:

form.PurchaseRequisitionInterface_Create

Output field values


11/51




form

Displayed on web

services

Notes

instanceId InstanceID Unique identifier generated for each purchase

requisition.

Requisition ID RequisitionID Unique visible Requisition ID system generated.

The following table lists output values for the child level of the Create_PurchaseRequisition operation from the AST:

form.PurchaseLineItemInterface_Create

Output field values


form

Displayed on web

services

Notes

instanceId InstanceID Unique identifier generated for each line

item.


12/51



2 AST_PurchaseRequisition_QueryModify_WSThis is a complex web service based on the file, which is provided with thePurchaseRequisitionQueryModify.xsd

application. This web service supports two operations, which are query and modify.

Query_PurchaseRequisition (see page 12)

AST-PurchaseRequisitionInterface (Query) (see page 12)

Update_PurchaseRequisition (see page 17)

2.1 Query_PurchaseRequisitionThis operation supports a qualification to query for parent requisitions. It will also return related children purchase line

items and work information records for each purchase requisition found, based on the qualification entered.

Depending on how general the qualification is, startRecord and maxLimit can be used to determine how many records

should be shown at a time.

The following table lists input values for the parent level of the Query_PurchaseRequisition operation against AST:

PurchaseRequisitionInterface form.

Input field values


form

Displayed on web

services

Notes

Qualification AR System qualification

required.

startRecord

maxLimit

2.2 AST-PurchaseRequisitionInterface (Query)The following table lists output values for the parent level of the Query_PurchaseRequisition operation and maps to

the AST:PurchaseRequisitionInterface form.

Output field values


instanceId InstanceID Returns unique instance ID of the purchase

requisition.

Requisition ID RequisitionID Returns unique visible Requisition ID.


13/51




Status Status

Date Required DateRequired

Description Description

Justification Justification

For_Company RequestedForCompany

For_Full Name RequestedForFullName



Manager Name ManagerFullName

Manager Login Name ManagerLoginName

By_Company RequestedByCompany

Requested_By_PersonID RequestedByPersonID

By_Full Name RequestedByFullName





PRNumber PRNumber

DataTags DataTags

Install Needed InstallNeeded





BillToAddr_Street BillToStreet





ShipToAddr_Street ShipToStreet


14/51






ShipToAddr_Postal Code+ ShipToPostalCode


Assigned Support Company SupportCompany

Assigned Support

Organization

SupportOrganization


Assignee Assignee

Change Template ChangeTemplateName

TemplateInstanceID ChangeTemplateInstanceID

The following table lists output values for the child level of the Query_PurchaseRequisition operation and maps to the

AST:PurchaseRequisitionWorkLog form.

Output field values


InstanceId WorkInfoInstanceId The unique Instance ID for the work information record.

PR Instance ID SourceInstanceID This is the foreign key, purchase requisition Instance ID, which the work information

record is linked to.

Work Log Type WorkInfoType

Work Log Date WorkInfoDate

Communication Source WorkInfoSource

Description WorkInfoSummary

Detailed Description WorkInfoNotes

Secure Work log WorkInfoLocked

View Access WorkInfoViewAccess

z2AF Work Log01

/attachmentName

WorkInfoAttachment1Name

z2AF Work Log01

/attachmentData

WorkInfoAttachment1Data

z2AF Work Log01

/attachmentOrigSize

WorkInfoAttachment1OrigSize



15/51




z2AF Work Log02

/attachmentName

z2AF Work Log02

/attachmentData


z2AF Work Log02

/attachmentOrigSize


z2AF Work Log03

/attachmentName


z2AF Work Log03

/attachmentData


z2AF Work Log03

/attachmentOrigSize


The following table lists output values for the child level of the Update_Requisition operation and maps to the AST:

PurchaseLineItem form.

Output field values


instanceId InstanceID Returns unique identifier, purchase line item Instance

ID.

Part Number PartNumber


Status Status

Asset Class CIType


Required Qty* RequiredQty

Total Received Qty TotalReceivedQty

Unit Price/currencyValue UnitPriceAmount

Unit Price/currencyCode UnitPriceCurrencyCode

Estimated Price/currencyValue EstimatedPriceAmount

Estimated P rice/currencyCode EstimatedPriceCurrencyCode

Actual Price/currencyValue ActualPriceAmount

Actual Price/currencyCode ActualPriceCurrencyCode

Taxable Taxable

Tax Amount/currencyValue TaxAmount


16/51




Tax Amount/currencyCode TaxCurrencyCode

Shipping & Handling

/currencyValue

ShippingAndHandlingAmount

Shipping & Handling

/currencyCode

ShippingAndHandlingCurrency

Code

Product Categorization Tier 1 ProductTier1



Model ProductName


MarketVersion MarketVersion

Manufacture Name+ Manufacturer

Supplier Name+ SupplierName

Requisition ID RequisitionID

Order ID OrderID


QuoteDesc QuoteInfo

PRNumber PRNumber

PO Number PONumber

Data Tags Data Tags


Date Ordered DateOrdered




LicenseCertificateType CertificatePurchaseType

Software Contract ID SoftwareContractID

zID_LicenseType LicenseType

zID_CertificateID CertificateID




17/51






Attachment1/attachmentName PLIAttachment1Name

Attachment1/attachmentData PLIAttachment1Data

Attachment1/attachmentOrigSize PLIAttachment1OrigSize

Audit Trail ReadNotes

2.3 Update_PurchaseRequisitionThis 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 workinformation 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


Qualification AR System qualification required and is based on AST:PurchaseRequisitionInterface

fields.

instanceId InstanceID


Status Status



Justification Justification

For_Company RequestedForCompany

Requested_For_PersonID RequestedForPersonID

For_Full Name RequestedForFullName

Login Name RequestedForLoginName



Manager Name ManagerFullName


18/51




Manager Login Name ManagerLoginName

By_Company RequestedByCompany

Requested_By_PersonID RequestedByPersonID

By_Full Name RequestedByFullName





PRNumber PRNumber

DataTags DataTags

Install Needed InstallNeeded













ShipToAddr_Postal Code+ ShipToPostalCode


Assigned Support Company SupportCompany

Assigned Support

Organization

SupportOrganization


Assignee Assignee

TemplateInstanceID ChangeTemplateInstanceID


19/51



The following table lists input values for the child level of the Update _PurchaseRequisition operation and maps to the


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


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


z2AF Work Log02

/attachmentData


z2AF Work Log02

/attachmentOrigSize


z2AF Work Log03

/attachmentName


z2AF Work Log03

/attachmentData


z2AF Work Log03

/attachmentOrigSize


The following table lists input values for the child level of the Update_PurchaseRequisition operation and maps to the

AST:PurchaseLineItem form.


20/51



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


Actual Price

/currencyValue

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

Actual Price

/currencyCode

ActualPriceCurrency

Code


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


Product Categorization

Tier 1

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


21/51




services

Notes


Tier 2



Tier 3


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


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 theCertificateID 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


QuoteDesc QuoteInfo

Data Tags Data Tags

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




Attachment1

/attachmentName

PLIAttachment1Name


22/51




services

Notes

Attachment1

/attachmentData

PLIAttachment1Data

Attachment1

/attachmentOrigSize

PLIAttachment1OrigSize



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

PurchaseRequisitionInterface form.

Output field values


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


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:


Output field values


form

Displayed on web

services

Notes

InstanceId InstanceID Unique identifier for each updated or added purchase line

item.


23/51



3 AST_PurchaseOrder_QueryModify_WSThis is a complex web service based on the file, which is provided with thePurchaseOrderQueryModify.xsd

application. This web service contains the following two operations:

Query_PurchaseOrder (see page 23)

Update_PurchaseOrder (see page 26)

3.1 Query_PurchaseOrderThis operation supports a qualification to query for purchase orders. It will also return related children purchase line

items for each purchase order found, based on the qualification entered. Depending on how general the qualification

is, startRecord and maxLimit can be used to determine how many records should be shown at a time.

The following table lists input values for the Query_PurchaseOrder operation against the parent AST:

PurchaseOrderInterface form.

Input field values


form

Displayed on web

services

Notes

Qual ification AR System qualification required and is based on AST:PurchaseOrderInterface

fields.

startRecord

maxLimit

The following table lists output values for the parent level of the Query_PurchaseOrder operation and maps to the

AST:PurchaseOrderInterface form.

Output field values


Order ID OrderID Returns unique system-generated Order

ID.

Status Status

PO Number PONumber


Payment Terms PaymentTerms

Buyer Buyer


24/51




Requested By+ RequestedBy



Tax Rate TaxRate



Shipping & Handling

/currencyValue


Shipping & Handling

/currencyCode

ShippingAndHandlingCurrency

Code



BillToAddr_State/Prov BillToStateProv

BillToAddr_Postal Code BillToPostalCode

BillToAddr_Country BillToCountry



ShipToAddr_State/Prov ShipToStateProv

ShipToAddr_Postal Code ShipToPostalCode

ShipToAddr_Country ShipToCountry

Freight Terms FreightTerms

Ship Via ShipVia

Shipping Options ShippingOption

OrderConfirmation Type Code OrderConfirmationTypeCode

WebServiceOrder WebServiceOrder

The following table lists output values for the child level of the Query_PurchaseOrder operation and maps to the AST:


Output field values


instanceId InstanceID Returns unique identifier, purchase line item Instance

Id.


25/51






Status Status

Asset Class CIType

RequestedForCompany RequesterCompany

Unit of Measure ProductUnitOfMeasureCode

Required Qty* RequiredQty





Estimated P rice/currencyCode EstimatedPriceCurrencyCode



Taxable Taxable



Shipping & Handling

/currencyValue

ShippingAndHandling Amount

Shipping & Handling

/currencyCode

ShippingAndHandling

CurrencyCode

Product Categorization Tier 1 Tier1



Model ProductName



Manufacture Name+ Manufacturer



Order ID OrderID


26/51





QuoteDesc QuoteInfo










Attachment1/attachmentName DetailsAttachment1Name

Attachment1/attachmentData DetailsAttachment1Data

Attachment1/attachmentOrigSize DetailsAttachment1OrigSize


LicenseCertificateType PurchaseType

Software Contract ID SoftwareContractID


zID_CertificateID CertificateID

3.2 Update_PurchaseOrderThis operation supports the update of a purchase order plus updates to existing purchase line items. The qualification

entered determines which purchase order is updated. Only child records related to the parent can be updated.

The following table lists the input values for the parent level of the Update_PurchaseOrder operation and maps to the

AST:PurchaseOrderInterface form.

Input field values


Qualification AR System qualification required, and is based on AST:PurchaseOrderInterface

fields.

Order ID OrderID


27/51





Status Status

PO Number PONumber Available for storing external purchase order reference number.

Payment Terms PaymentTerms

Buyer Buyer

Requested By+ RequestedBy


Tax Rate TaxRate

Tax Amount/currencyValue TaxAmount Must provide currency value if currency code provided.

Tax Amount/currencyCode TaxCurrencyCode Must provide currency code if currency value provided.

Shipping & Handling/currencyValue

ShippingAndHandling Amount Must provide currency value if currency code provided.

Shipping & Handling

/currencyCode

ShippingAndHandling

CurrencyCode

Must provide currency code if currency value provided.



BillToAddr_State/Prov BillToStateProv

BillToAddr_Postal Code BillToPostalCode

BillToAddr_Country BillToCountry



ShipToAddr_State/Prov ShipToStateProv

ShipToAddr_Postal Code ShipToPostalCode

ShipToAddr_Country ShipToCountry

Freight Terms FreightTerms

Ship Via ShipVia


OrderConfirmation Type Code OrderConfi rmationType Code

WebServiceOrder WebServiceOrder

The following table lists input values for the child level of the Update_PurchaseOrder operation and maps to the AST:



28/51



Input field values

DB field on interface form Displayed on web

services

Notes

instanceId InstanceID Provide the purchase line item Instance ID to be

updated.

Unit Price/currencyValue UnitPriceAmount Must provide currency value if currency code provided.

Unit Price/currencyCode UnitPriceCurrencyCode Must supply currency code if currency value provided.

Taxable Taxable


QuoteDesc QuoteInfo

EstimatedReceivingDate DateToReceive









Attachment1/attachmentOrigSize

DetailsAttachment1OrigSize


The following table lists output values for the parent level of the Update_PurchaseOrder operation from the AST:


Output field values


form

Displayed on web

services

Notes

instanceId InstanceID Unique identifier for each updated purchaseorder.

The following table lists output values for the child level of the Update_PurchaseOrder operation from the AST:


Output field values


29/51




form

Displayed on web

services

Notes

instanceId InstanceID Unique identifier for each updated purchase line

item.


30/51



4 AST_PurchaseLineItem_QueryModify_WSThis is a complex web service based on the PurchaseLineItemQueryModify.xsd file, which is provided with the

application. This web service contains the following two operations:

Query_PurchaseLineItem (see page 30)

Update_PurchaseLineItem (see page 34)

4.1 Query_PurchaseLineItemThe query operation supports a qualification to query for purchase line items. It will also return related children work

information and return records for each purchase line item found, based on the qualification entered. Depending on

how general the qualification is, startRecord and maxLimit can be used to determine how many records should be

shown at a time.

The following table lists input values for the Query_PurchaseLineItem operation against the parent AST:

PurchaseLineItemInterface form.

Input field values


form

Displayed on web

services

Notes

Qualification AR System qualif icat ion required and is based on AST:PurchaseLineItemInterface

fields.

startRecord

maxLimit

The following table lists output values for the parent level of the Query_PurchaseLineItem operation and maps to the

AST:PurchaseLineItemInterface form.

Output field values


InstanceID InstanceID Returns unique identifier, purchase line item Instance

Id.


Description ItemDescription

Status ItemStatus

Asset Class CIType


31/51




RequestedFor_Company RequesterCompany


Required Qty RequiredQty






Estimated Price/currencyCode EstimatedPriceCurrencyCode



Taxable Taxable



ShippingAndHandling

/currencyValue


ShippingAndHandling

/currencyCode

ShippingAndHandling

CurrencyCode




ProductName Model

ModelVersion VersionNumber


Manufacturer ManufacturerName+

SupplierName Supplier Name+

RequisitionID Requisition ID

OrderID Order ID

QuoteNumber Quote Number

QuoteDesc QuoteInfo

PRNumber PRNumber


32/51




PO Number PONumber

Data Tags DataTags










Attachment1/attachmentName PLIAttachmentName

Attachment1/attachmentData PLIAttachmentData

Attachment1/attachmentOrigSize PLIAttachmentOrigSize


License Certificate Type CertificatePurchaseType

Software Contract ID Software Contract ID


zID_LicenseCertificateID CertificateID

The following table lists output values for the child level of the Query_PurchaseLineItem operation and maps to the


Output field values


InstanceId WorkInfoInstanceID The unique Instance ID for the work information record.

Purchase Line Item Instance ID SourceInstanceID This is the foreign key, purchase line item Instance ID, which the work information

record is linked to.

Work Log Type WorkInfoType

Work Log Date WorkInfoDate

Communication Source WorkInfoSource

Description WorkInfoSummary


33/51




Detailed Description WorkInfoNotes

Secure Work Log WorkInfoLocked

View Access WorkInfoViewAccess

z2AF Work Log01

/attachmentName


z2AF Work Log01

/attachmentData


z2AF Work Log01

/attachmentOrigSize


z2AF Work Log02

/attachmentName


z2AF Work Log02

/attachmentData


z2AF Work Log02

/attachmentOrigSize


z2AF Work Log03

/attachmentName


z2AF Work Log03

/attachmentData


z2AF Work Log03

/attachmentOrigSize


The following table lists output values for the child level of the Query_PurchaseLineItem operation and maps to the

AST:PurchaseReturn form.

Output field values


form

Displayed on web

services

Notes

Instanceid InstanceID Returns unique identifier.

Line Item Instance ID LineItemInstanceID Purchase line item Instance

ID.

Type Type

RMA Number RMANumber

Quantity to Return QuantityToReturn

Reason for Return ReasonForReturn

Replacement Received ReplacementReceived


34/51



4.2 Update_PurchaseLineItemThis operation supports the update of an existing purchase line item, and updates to related children work information

and return records. The qualification entered determines which purchase line items are updated. Only child records

related to the parent can be updated. In addition, children work information and return records can also be created.

The following table lists the input values for the parent level of the Update_PurchaseLineItem operation and maps to

the AST:PurchaseLineItemInterface form.

Input field values

DB field on interface form Displayed on web

services

Notes

Qualification AR System qualification

required.



Taxable Taxable


QuoteDesc QuoteInfo










Attachment1

/attachmentOrigSize

DetailsAttachment1OrigSize


The following table lists input values for the child level of the Update_PurchaseLineItem operation and maps to the


Input field values


35/51




InstanceId WorkInfoInstanceID If a new Instance ID is provided (one that is not in the database), a new work information record

will be created. If existing instance Id is provided the matching work information record will be

updated.

Purchase Line Item

Instance ID

SourceInstanceID This is the foreign key, purchase line item Instance ID, which the work information record is

linked to. 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 Submit

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 Required 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 creat ing a work information record. Supported values are: "Internal" or "Public."

z2AF Work Log01

/attachmentName


z2AF Work Log01

/attachmentData


z2AF Work Log01

/attachmentOrigSize


z2AF Work Log02

/attachmentName


z2AF Work Log02

/attachmentData


z2AF Work Log02

/attachmentOrigSize


z2AF Work Log03

/attachmentName


z2AF Work Log03

/attachmentData


z2AF Work Log03

/attachmentOrigSize


The following table lists input values for the child level of the Update_PurchaseLineItem operation and maps to the

form.AST:PurchaseReturn

Input field values


36/51



DB field on

form

Displayed on web

services

Notes

Instanceid Instanceid If a new Instance ID is provided, a purchase return will be created and this is the typical usage. If existing

Instance ID is provided updates can be made.

Line Item

Instance ID

LineItem InstanceID Purchase line item Instance Id is required.

Type Type Required field "Replace" and "Return."

RMA Number RMANumber Required field

Quantity to

Return

QuantityToReturn Required field

Reason for

Return

ReasonForReturn Required field

The following table lists output values for the parent level of the Update_PurchaseLineItem operation from the AST:

PurchaseLineItemInterface form.

Output field values

DB field on

form

Displayed on web

services

Notes

InstanceId InstanceID Unique identifier for each updated purchase line

item.

The following table lists output values for the child level of the Update_PurchaseLineItem operation from the AST:

PurchaseRequisitionWorkLog form.

Output field values

DB field on

form

Displayed on web

services

Notes

InstanceId WorkInfoInstanceID Unique identi fier for each updated or added work information

record.

The following table lists output values for the child level of the Update_PurchaseLineItem operation from the AST:

PurchaseReturn form.

Output field values

DB field on

form

Displayed on web

services

Notes

Instanceid ReturnsInstanceID Unique identifier for each updated or added purchase

return.


37/51



5 AST_WorkInfoInterface_Create_WSThis is a simple web service. It contains one operation and supports the creation of a work information record for

either a purchase requisition or purchase line item.

Create_WorkInfo (see page 37)

5.1 Create_WorkInfoThe following table describes the input field values for this function.

Input field values

DB field on form Displayed on webservices

Notes

zID_Action zID_Action Required field with two keywords supported; "CREATEPR" to create a work information for purchase

requisition and "CREATEPLI" to create a work information record for a purchase line item.

SourceInstanceID SourceInstanceID Required field Provide either the purchase requisition Instance Id or the purchase line item Instance

Id.

Work Log Type Work_Log_Type Required for creating a work information record. Supported values are Detailed Clarification,

Purchase Requisition Task, General Information, Email System and Paging System.

Description Description Required for creating a work information record.

Secure Work Log Secure_Work_Log Required for creating a work information record. Supported values are "Yes" or "No."

View Access View_Access Required for creating a work information record. Supported values are "Internal" or "Publ ic."

Status Status Required for creating a work information record.

Work Log Submit

Date

Work_Log_Submit_Date Required for creating a work information record.

Submitter Submitter Required for creating a work information record.

Assigned To Assigned_To Optional for creating a work information record.

Short Description Short_Description Required for creating a work information record.

Assignee Groups Assignee_Groups

Vendor Assignee

Groups

Vendor_Assignee_Groups

Requisition ID Requisition_ID Set using workflow.

PRNumber PRNumber Set using workflow.

Data Tags Data Tags Optional for creating a work information record.


38/51




services

Notes

Notes Notes Optional for creating a work information record.

Work Log Submitter Work_Log_Submitter Optional for creating a work information record.

z2AF Work Log01

/attachmentName

WorkInfoAttachment1

Name

Optional for creating a work information record.

z2AF Work Log01

/attachmentData

WorkInfoAttachment1

Data


z2AF Work Log01

/attachmentOrigSize

WorkInfoAttachment1

OrigSize


z2AF Work Log02

/attachmentName

WorkInfoAttachment2

Name


z2AF Work Log02

/attachmentData

WorkInfoAttachment2

Data


z2AF Work Log02

/attachmentOrigSize

WorkInfoAttachment2

OrigSize


z2AF Work Log03

/attachmentName

WorkInfoAttachment3

Name


z2AF Work Log03

/attachmentData

WorkInfoAttachment3

Data


z2AF Work Log03

/attachmentOrigSize

WorkInfoAttachment3

OrigSize


Number of

Attachments

Number_of_Attachments Optional for creating a work information record.

Communication

Source

Communication_Source Recommended for creating a work information record.

Work Log Date Work_Log_Date Recommended for creating a work information record.

The following table lists output values for the AST:WorkInfoInterface_Create form.

Output field values

DB field on

form

Displayed on web

services

Notes

InstanceID InstanceID Unique identifier generated for a work informationrecord.


39/51



6 AST_PurchaseOrder_WS and

AST_PurchaseOrder_WS_noDateThis section describes the inputs and outputs for the following web services:

AST_PurchaseOrder_WS

AST_PurchaseOrder_WS_noDate

Note

With a few noted exceptions, these web services share the same mapping structure. See the columnNotes

in the following tables for details about the exceptions.

The qualifications across these two web services differ from each other as described in the following table:

Qualifications

Web service Qualifications

AST_PurchaseOrder_WS This function has a value of 1 (Yes) for the WebServiceOrder field on the AST:PurchaseOrder form. For the

Get_List_Of_New_Pos functions, you must set the OrderConfirmationTypeCode field to null on the AST:

PurchaseOrder form.

AST_PurchaseOrder_WS_noDate This function has a value of 0 (No) for the WebServiceOrder field on the AST:PurchaseOrder form. For theGet_List_Of_New_Pos functions, you must set the OrderConfirmationTypeCode field to null on the AST:

PurchaseOrder form.

Note

The and fields appear on the Tracking tab of theWebServiceOrder OrderConfirmationTypeCode AST:

form.PurchaseOrder

For details of the related functions, see:

Update_PO_Confirmation (see page 40)

Get_Specific_PO (see page 40)

Get_List_Of_New_POs (see page 42)


40/51



6.1 Update_PO_ConfirmationUse the Update_PO_Confirmation function to update information about a specific purchase order and its set of line

items. The following table describes the field values required to use this function.

Input field values

Field DB name on form Displayed on web services Notes

N/A POID Qualification to search on

Supplier Name+ Supplier Used in AST_ PurchaseOrder_ WS qualification only

PO Number PONumber

Freight Terms Freight Terms

Ship Via ShipVia


currencyValue ShippingCost.

MonetaryAmount

Shipping & Handling field on AST: PurchaseOrder

currencyCode ShippingCost.CurrencyCode Shipping & Handling field on AST: PurchaseOrder

Tax Rate TaxRate

OrderConfirmationTypeCode OrderConfirmationTypeCode

AST:PurchastLineItem getListValues Line items are a subset of a purchase order. A one-to-many relationship is defined for line

items to purchase orders.

instanceId ItemID

currencyValue UnitPrice.MonetaryAmount

currencyCode UnitPrice.CurrencyCode

6.2 Get_Specific_POThis function returns the values of a specific purchase order and its line items.

Input field values

Displayed on web

services

Notes

PONumber Qualification on which to

search

Supplier


41/51



The following table lists the output field values.

Output field values


POID

PONumber

POStatus

DateOrdered

Supplier

Buyer

NotesToSupplier

FreightTerms

ShipVia

ShippingOption

ShippingCost.MonetaryAmount

ShippingCost.CurrencyCode

TotalPrice.MonetaryAmount

TotalPrice.CurrencyCode

BillingTo.AddressLine1

BillingTo.AddressCity

BillingTo.AddressState

Bill ingTo.AddressPostalCode

BillingTo.AddressCountry

ShippingTo.AddressLine1

ShippingTo.AddressCity

ShippingTo.AddressState

ShippingTo.

AddressPostalCode

ShippingTo.AddressCountry

Item Line items on a purchase order. It has a one-to-many relationship with purchase

order.

ItemID

PartNumber


42/51




ItemDescription

ItemStatus

Quantity

ProductUnitOfMeasureCode

UnitPrice.MoneteryAmount

UnitPrice.CurrencyCode

QuoteNumber

Taxable

6.3 Get_List_Of_New_POsThis function returns the values for a list of purchase orders and its line items.

Input field values

Displayed on web

services

Supplier


Output field values


POID

PONumber

POStatus

DateOrdered Only displayed in the AST_PurchaseOrder_WS web service

Supplier

Buyer

NotesToSupplier

FreightTerms

ShipVia

ShippingOption

ShippingCost.MonetaryAmount


43/51




ShippingCost.CurrencyCode

BillingTo.AddressLine1

BillingTo.AddressCity

BillingTo.AddressState

Bill ingTo.AddressPostalCode

BillingTo.AddressCountry

ShippingTo.AddressLine1

ShippingTo.AddressCity

ShippingTo.AddressState

ShippingTo.

AddressPostalCode

ShippingTo.AddressCountry

OrderConfirmationTypeCode

Item Line item for purchase order. It has a one-to-many relationship with purchase

order.

ItemID

PartNumber

ItemDescription

ItemStatus

Quantity

ProductUnitOfMeasureCode

UnitPrice.MoneteryAmount

UnitPrice.CurrencyCode

QuoteNumber

Taxable


44/51



7 AST_PurchaseOrderInterface_WSThe purchase order interface web service lets you modify and query purchase order records through an interface

form. The AST_PurchaseOrder_WS and AST_PurchaseOrder_WS_noDateweb services also perform these

functions, but interact directly with the AST:PurchaseOrder form.

PO_Modify_Service (see page 44)

PO_Query_Service (see page 45)

PO_GetListofNewPO_Service (see page 46)

7.1 PO_Modify_ServiceThis function updates a purchase order by way of the AST:PurchaseOrderInterface form. You cannot update the line

items for a purchase.

Input field values


form

Displayed on web

services

Notes

N/A POID A qualification to search

on

N/A Supplier Used for qualification

Requisition ID Requisition_ID

PO Number PONumber


Status Status

WebServiceOrder

Buyer Buyer

Date Ordered Date_Ordered

Payment Terms Payment_Terms

Tax Rate Tax_Rate

BillToAddr_City_Name+ BillToAddr_City_Name

BillToAddr_Country BillToAddr_Country

BillToAddr_PostalCode+ BillToAddr_PostalCode

BillToAddr_State/Prov BillToAddr_State_Prov


45/51




form

Displayed on web

services

Notes

ShipToAddr_Street ShipToAddr_Street

ShipToAddr_City_Name+ ShipToAddr_City_Name

ShipToAddr_Country ShipToAddr_Country

ShipToAddr_PostalCode+ ShipToAddr_PostalCode

ShipToAddr_State/Prov ShipToAddr_State_Prov

ShipToAddr_Street ShipToAddr_Street

7.2 PO_Query_ServiceThe PO_Query_Service function returns a specific purchase order by way of the AST:PurchaseOrderInterface form.

Note

A query cannot return line item values for a purchase order.

Input field values

Displayed on web

services

Notes

Order_ID Used as a

qualification


Output field values

Displayed on web services

Order_ID

PO_Number

Status

Supplier_Name

Buyer

Notes_to_Supplier

Freight_Terms

Payment_terms


46/51




ShippingVia

ShippingOptions

OrderConfirmationTypeCode

BillToAddr_City_Name+

BillToAddr_Country

BillToAddr_PostalCode+

BillToAddr_State/Prov

ShipToAddr_Street

ShipToAddr_City_Name+

ShipToAddr_Country

ShipToAddr_PostalCode+

ShipToAddr_State/Prov

ShipToAddr_Street

7.3 PO_GetListofNewPO_ServiceThe PO_GetListofNewPO_Service function returns a group of purchase orders by way of the AST:


Note

This function cannot return the line item values for a purchase order.

Input field values

Displayed on web

services

Notes

Qualification A valid AR System

qualification


Output field values


Order_ID


47/51




PO_Number

Status

Supplier_Name

Notes_to_Supplier

Buyer

Date_Ordered

Freight_Terms

Payment_Terms

OrderConformationTypeCode

ShipVia

Shipping_Options

BillToAddr_City_Name

BillToAddr_Country

BillToAddr_PostalCode

BillToAddr_State/Prov

ShipToAddr_Street

ShipToAddr_City_Name

ShipToAddr_Country

ShipToAddr_PostalCode

ShipToAddr_State/Prov

ShipToAddr_Street


48/51



8 AST_CIUnavailabilityInterface_WSThe AST_CIUnavailabilityInterface_WS allows for a user to query for a list of unavailability records that are associated

with a CI.

GetListOfUnavailability function (see page 48)

8.1 GetListOfUnavailability functionThe GetListOfUnavailability function returns a list of unavailable CIs by the way of the AST: CI Unavailablity join form.

Input field values

Displayed on webservices

Notes

Qualification A valid AR System

qualification


Output field values

Displayed on web

services

ActualEndDate

ActualStartDate

CIName

CIReconID

CrossReferenceID

Description

ScheduledEndDate

ScheduledStartDate

UnavailabilityClass

UnavailabilityStatus

UnavailabilityType


49/51



Index

AAst Purchaserequisitioninterface Query 12

CCreate Purchaserequisition 5

Create Workinfo 37

GGet List Of New Pos 42

Getlistofunavailability 48

Get Specific Po 40

PPo Getlistofnewpo Service 46

Po Modify Service 44

Po Query Service 45

QQuery Purchaselineitem 30

Query Purchaseorder 23

Query Purchaserequisition 12

RReference , , , , , , , , , , , , , , , , , , , , ,3 5 5 12 12 12 17 23 30 30 34 37 37 39 40 42 44 44 45 46 48

48


50/51



UUpdate Po Confirmation 40

Update Purchaselineitem 34

Update Purchaseorder 26

Update Purchaserequisition 17

WWeb Services , , , , , , , , , , , , , , , , , , , ,3 5 5 12 23 23 26 30 30 34 37 37 39 40 40 42 44 44 45 46

,48 48


51/51

Creating BMC Asset Mana

creating bmc asset management web services-v7-20151201_0806

Documents