Easily upload a new buy guide.

Warning: Uploading a new buy guide will replace all of your existing bids. If you simply want to modify some of your existing bids, please refer to the Bid APIs.

1. Create your buy guide

Create a .csv file that contains all of the ISBNs that you are looking to buy through the ValoreBooks marketplace, how many of each ISBN you are looking for, and the price you are willing to pay for each ISBN. There are four headers that are required in the upload file: isbn, quantity, price, and expirationDate. All other headers will be ignored.

Example:

isbn,quantity,price,expirationDate
9780321694331,20,75.75,2018-06-02T04:00:00Z
9780321775658,80,150.00,2018-06-02T04:00:00Z

2. Upload your buy guide

Please upload your guide to the bid-upload directory of your Amazon Web Services S3 bucket.

One of the easiest ways to place a file onto S3 is through the use of the AWS Command Line Interface (CLI). You can copy a file to S3 using a command similar to this:

$ aws s3 cp <guide>.csv s3://valore-buyers/<buyer-id>/bid-upload/<guide>.csv

For the test environment use S3 bucket valore-buyers-test/<buyer-id>/bid-upload/ instead.

The CLI commands assume your credentials are configured.

3. View upload results

Once we have finished processing your upload request, you will receive a notification on your SQS queue with your Buy Guide Upload Results.

Interpreting your results

After you upload your new buy guide, you will be able to instantly see if that upload file was PROCESSED, PROCESSED WITH ERRORS, PARTIALLY PROCESSED, or NOT PROCESSED.

If there were errors with the uploaded file, you can review these errors in your S3 bucket. A new error file will be placed here that contains all the rows on the uploaded file that could not be successfully processed.

s3://valore-buyers/<buyer-id>/bid-upload/errors/<guide>.csv

All bids processed without error will be automatically put live in the ValoreBooks marketplace.