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 |
|---|---|
| RetrieveProductRequest | Aggregate |
| RetrieveProductRequest@ServiceVersionNumber | Attribute |
| RetrieveProductRequest. TransactionDetail | Aggregate, Optional Records information necessary to process this request. |
| RetrieveProductRequest. TransactionDetail. ApplicationTransactionID | string up to 64 chars., Optional A number assigned by the calling application to uniquely identify this request. |
| RetrieveProductRequest. TransactionDetail. 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. |
| RetrieveProductRequest. TransactionDetail. 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. |
| END: RetrieveProductRequest. TransactionDetail | /Aggregate |
| RetrieveProductRequest. RetrieveProductRequestDetail | Aggregate, Required |
| RetrieveProductRequest. RetrieveProductRequestDetail. ArchiveDetail | Aggregate, Required |
| RetrieveProductRequest. RetrieveProductRequestDetail. ArchiveDetail. PortfolioAssetID | long, Required |
| END: RetrieveProductRequest. RetrieveProductRequestDetail. ArchiveDetail | /Aggregate |
| END: RetrieveProductRequest. RetrieveProductRequestDetail | /Aggregate |
| END: RetrieveProductRequest | /Aggregate |
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. |
- © Dun & Bradstreet, Inc. 2019 – 2024. All rights reserved.