The job profile is a collection of data about a job that includes: jobId, jobType, jobStatus, job creation time, job completion time, errorCount, percentComplete, and inputFileReferenceId (for upload jobs).
If upload job processing has finished, a new fileReferenceId is also returned.
The job profile returns data about the state of the Bulk Data Exchange job, but does not return information about the status of the processing for any data file that is sent with the job request or returned with the job response.
The date and time that job processing was completed. Use this with creationTime to determine the average processing time for your jobs. If job processing has not completed, this field will not be returned.
See the Field Index to learn which calls use completionTime.
The number of non-fatal (informational) errors that occurred during file processing (uploads or reports) after you sent the Bulk Data Exchange startUploadJobRequest call or the startDownloadJobRequest call.
See the Field Index to learn which calls use errorCount.
A unique ID that references the response file when the job created via createUploadJob or startDownloadJob completes. Pass the fileReferenceId into a File Transfer Service uploadFile or downloadFile call.
If a job has not completed processing, only the inputFileReferenceId (original fileReferenceId from the createUploadJobResponse) will be returned. Once the upload job has finished processing, a new fileReferenceId is assigned by the Bulk Data Exchange service and returned by the job status calls.
See the Field Index to learn which calls use fileReferenceId.
The inputFileReferenceId is a unique ID that references the input data file for a job that is created via createUploadJob. Preserves the original fileReferenceId value for an upload job. Once the data file has been uploaded and the upload job has finished processing, a new fileReferenceId is assigned by the Bulk Data Exchange Service for downloading the corresponding responses.
See the Field Index to learn which calls use inputFileReferenceId.
Each of the Bulk Data Exchange job types corresponds to a Merchant Data request or response with the same name. The requests or responses are included within a data file that will be uploaded or downloaded after the job is created. For instance, if you create an AddFixedPriceItem job, then the file you are going to upload must contain AddFixedPriceItem requests - one request for each item in your data file.
Each Bulk Data Exchange job can only have one job type per job. For example, if you are uploading a data file it can not have both AddFixedPriceItem requests and ReviseFixedPriceItem requests within the same data file.
The following value definitions describe the request or response associated with each job type.
For more information about creating and uploading Merchant Data files, see the Large Merchant Services User Guide.
Applicable values:
AddFixedPriceItem
Defines a single new fixed price item and lists it on a specified eBay site.
AddItem
Defines a single new item and lists it on a specified eBay site.
EndFixedPriceItem
Ends the specified item listing before the date and time at which it would normally end (per the listing duration).
EndItem
Ends the specified item listing before the date and time at which it would normally end (per the listing duration).
OrderAck
Request that acknowledges that an order has been received. Use the OrderAck request to acknowledge each line item in a SoldReport by order ID or line item ID.
After you send the first OrderAck call, future SoldReports will only contain unacknowledged orders or line items.
RelistFixedPriceItem
Enables a seller to take a single item (or a single multi-item listing) that ended without bidders or buyers and re-list it on a specified eBay site.
A listing may be re-listed with the same item properties as the original or the seller may change a number of the item's defining properties at re-listing time. The new listing will have a different item ID than the original one.
RelistItem
Enables a seller to take a single item (or a single multi-item listing) and re-list it on a specified eBay site.
ReviseFixedPriceItem
Enables a seller to change the properties of a currently active listing.
If the listing contains multiple items, you can revise most of the fields in the listing (except Title, currency, product ID, photo display type, variation details, duration, format, or eBay Giving Works charity), even after one of the items in the listing has been purchased. To revise multiple listings, include a ReviseFixedPriceItemRequest once for each item or listing in your data file, with new information for each item or listing.
ReviseInventoryStatus
Enables a seller to change the price and quantity of a currently active fixed-price listing. Inputs are the item IDs or SKUs of the listings being revised, and price and quantity that are being changed for each revision.
You can use SKU as input only for fixed-price listings that are managed by SKU (i.e., InventoryTrackingMethod is set to SKU). ItemID can be used in either case.
ReviseItem
Enables a seller to change the properties of a currently active listing.
SetShipmentTrackingInfo
Includes information about a specific item and the shipping information associated with it.
UploadSiteHostedPictures
Uploads a picture to EPS (eBay Picture Services) when you supply a URL in the ExternalPictureURL field (the location of the picture on an external web server). Unlike what the call name implies, you can only upload one picture per request.
VerifyAddFixedPriceItem
Acknowledges that the data for a single new fixed price item matches the schema and can be added without data errors.
VerifyAddItem
Enables a seller to specify the definition of a new item and submit the definition to eBay without creating a listing.
See the Field Index to learn which calls use jobType.
The percentage of your file that has been processed after sending the Bulk Data Exchange startUploadJobRequest call or the startDownloadJobRequest call.
See the Field Index to learn which calls use percentComplete.
This document was generated with a customized version of the apireferencedocs tool.
