Retrieve Product {data products}
This operation -- included in all data and report product services (listed below)-- provides access to the product request archive. Assets may also be retrieved by using the Portfolio:RetrievePortfolioAsset operation.
Service | Request | Response* |
---|---|---|
Assessment Product Service | RetrieveProduct() | same as OrderProduct() |
Contact Product Service | RetrieveProduct() | same as OrderProduct() |
Compliance Verification Service | RetrieveProduct() | same as OrderProduct() |
Custom Product Service | RetrieveProduct() | same as OrderProduct() |
Financial Product Service | RetrieveProduct() | same as OrderProduct() |
Firmographic Product Service | RetrieveProduct() | same as OrderProduct() |
Industry Product Service | RetrieveProduct() | same as OrderProduct() |
Linkage Product Service | RetrieveProduct() | same as OrderProduct() |
News and Media Service | RetrieveProduct() | same as OrderProduct() |
Public Record Service | RetrieveProduct() | same as OrderProduct() |
SBRI Product Service | RetrieveProduct() | same as OrderProduct() |
Trade Detail Product Service | RetrieveProduct() | same as OrderProduct() |
*The response data field names will be prefixed with "RetrieveProductResponse.RetrieveProductResponseDetail" instead of "OrderProductResponse.OrderProductResponseDetail".
Request Parameters
The following parameters are accepted by this operation; however, the requirements for a specific request may differ based the product being requested.
Name | Characteristics |
---|---|
ApplicationTransactionID | string up to 64 chars., Optional A number assigned by the calling application to uniquely identify this request. |
TransactionTimestamp | DateTimestamp, Optional The date and time when this request was created. When the request is from an intermediary, such as a workflow manager or service bus, this is the date and time when the message was sent to the D&B function, i.e., the date and time when the xml document was created by the requesting intermediary. |
SubmittingOfficeID | string up to 64 chars., Optional A number that identifies the system or the software application from where this request originated. / A number used to uniquely identfy the D&B business segment or delivery channel from where this request originated. |
{assetID} | long, Required |
Response Data Fields
Refer to the respective OrderProduct operation for each service. For example, a request from Assessment:RetrieveProduct() will return the same response as Assessment:OrderProduct(). The response items, however, will be prefixed with "RetrieveProductResponse.RetrieveProductResponseDetail" instead of "OrderProductResponse.OrderProductResponseDetail".
Response Codes & Error Handling
Successful service requests will return a CM000 response code in the TransactionResult ResultID field. Otherwise, one of the D&B Direct standard response codes will be returned.
This operation may return the following response codes: CM001, CM002, CM003, CM004, CM005, CM006, PT001, and SC001-SC009.
Operation-specific supplemental response code explanations:
PT001 | No Portfolio asset not found for given portfolio asset identifier or investigation tracking ID or asset removed from archive. |