new_listing: Create a new Marketplace listing

In Pascallio/discogsAPI: API for connecting with Discogs

Description

Create a new Marketplace listing

Usage

new_listing(
  listing_id,
  release_id,
  condition,
  price,
  status,
  token,
  options = list(),
)

Arguments

listing_id	The ID of the listing you are fetching
release_id	Integer value representing a valid release ID
condition	The condition of the release you are posting. See Details
price	The price of the item (in the seller’s currency).
status	The status of the listing. See Details
token	Token object obtained from authorize() or a string containing your personal access token
options	(optional) Parameters, see Details

Details

Create a Marketplace listing. Authentication is required; the listing will be added to the authenticated user’s Inventory.

Condition

Condition must be one of the following:

• Mint(M)

• Near Mint (NM or M-)

• Very Good Plus (VG+)

• Very Good (VG)

• Good Plus (G+)

• Good (G)

• Fair (F)

• Poor (P)

Status

Defaults to For Sale. Options are:

• For Sale (the listing is ready to be shown on the Marketplace)

• Draft (the listing is not ready for public display).

Parameters

Below are optional parameters that can be provided to the options argument

sleeve_condition

The condition of the sleeve of the item you are posting. Must be one of the following:

• Mint(M)

• Near Mint (NM or M-)

• Very Good Plus (VG+)

• Very Good (VG)

• Good Plus (G+)

• Good (G)

• Fair (F)

• Poor (P)

• Generic

• Not Graded

• No Cover

comments

Any remarks about the item that will be displayed to buyers.

allow_offers

Whether or not to allow buyers to make offers on the item. Defaults to False.

external_id

A freeform field that can be used for the seller’s own reference. Information stored here will not be displayed to anyone other than the seller. This field is called “Private Comments” on the Discogs website.

location

A freeform field that is intended to help identify an item’s physical storage location. Information stored here will not be displayed to anyone other than the seller. This field will be visible on the inventory management page and will be available in inventory exports via the website.

weight

The weight, in grams, of this listing, for the purpose of calculating shipping. Set this field to auto to have the weight automatically estimated for you.

format_quantity

The number of items this listing counts as, for the purpose of calculating shipping. This field is called “Counts As” on the Discogs website. Set this field to auto to have the quantity automatically estimated for you.

Examples

token <- authorize("key", "secret")
edit_listing(1, 10, "Near Mint (NM or M-)", 10.30, "For Sale", token)

edit_listing(13, 112301, "Near Mint (NM or M-)", 12.30, "Draft", token, options=list("weight" = 400))

Pascallio/discogsAPI documentation built on Dec. 31, 2020, 3:27 p.m.