Audiogon Inventory Management

Currently, only users who are part of our Dealer Program may opt-in to using our API, or have inventory management enabled for their account. Once your account is enabled, you will be able to navigate to Dashboard > Inventory Management to choose your settings, and access your credentials.

As part of Inventory Management, you may enable features to automate listing creation, order syncing and tracking notifications.

There are several considerations you should understand before beginning to develop, or making your switch to Inventory Management. If you have not read our Inventory Management Overview support article, we strongly encourage you to do so first.

Sending Audiogon Inventory

Once your account is enabled, you will be able to navigate to Dashboard > Inventory Management to choose your settings, and access your credentials. We support the following methods for sending and managing inventory on Audiogon:

API Push

To sync your inventory with Audiogon, please send a POST or GET request to the following endpoint:

https://audiogonstaging.com/api/v1/inventory_management/submit-inventory

with the following headers:

Content-Type: application/json
Authorization: Bearer {Your Unique Token}

API Pull

If we will be pulling the inventory from your system, you will provide us with the API Endpoint and the API Token for access.

See Audiogon's Inventory Import API for full schema.

FTP

For FTPs, you'll select the Protocol (FTPS or SFTP), and then provide the following details:

• FTP Host
• FTP Username
• FTP Password
• FTP Path

Please ensure the FTP path ends with a supported spreadsheet file extension (.xls, .xlsx, .csv).

File Download

Provide us with the direct URL to the file. It should be a supported spreadsheet file type (.xls, .xlsx, .csv).

Managing Inventory on Audiogon

For items with a quantity of more than 1, when a buyer commits to buy the item we decrease the quantity value by 1 on the Audiogon listing. Upon the next sync of your feed, we will update the quantity accordingly. Depending on your inventory sync method and interval setting, this could cause a mismatch.

e.g. You use an FTP method and after a fresh sync, an item with Quantity 4 is bought on Audiogon. Your resource sync interval is set to 4 hours. During that four hours, you sell 3 on your website—putting your actual inventory level at 0—while the Audiogon listing still shows 3.

Removing an item from your feed does not remove it from Audiogon. The listing will remain active until it expires. You may use a quantity value of -1 to immediately force end any active listing. Setting a product quantity to 0 treats the listing as "Out-of-Stock." See Inventory Management Overview for more details.

Order Syncing

Enable Order Syncing to have Audiogon send you notifications of when a listing is sold.

In-depth explanations of how Audiogon handles orders is found in the Inventory Management Overview support article. The information below assumes you have read and understand that, specifically regarding open/paid status.

We support the following methods for syncing Orders from Audiogon to your ecosystem.

API Pull

If we will be sending Order information via API, you will provide us with the API Endpoint and the API Token for access. We will send a POST request to the endpoint you supply immediately after a buyer commits to buy a listing.

FTP

Supply us with the FTP Orders Path. Please ensure the FTP path ends with "/". This is where we will add new order files when a buyer commits to buy an item on our side.

While FTP Inventory Sync is governed by your sync interval (hours) setting, FTP Orders are sent immediately.

ShipStation

You will use your ShipStation credentials, and set Audiogon up as a Custom Store.

We have outlined the process in-depth at Adding Audiogon as a Custom Store in ShipStation article.

Shipping Notifications

To alert Audiogon when you create a shipping label for an order, enable shipping notifications.

We support the following fields for tracking information.

We support the following methods for syncing Tracking information and Updating Order Statuses:

API Push

To update tracking information of your orders in Audiogon, please send a POST to the following endpoint

https://audiogonstaging.com/api/v1/inventory_management/trackings

with the following headers:

Authorization: {Unique Token}

Sample Request

https://audiogonstaging.com/api/v1/inventory_management/trackings?order_id=AG_ORDER_ID&number=1234&carrier=FEDEX&tracking_url=fedex.com/tracking=1234

https://audiogonstaging.com/api/v1/inventory_management/trackings?order_id=AG_ORDER_ID&number=1234&carrier=FEDEX&tracking_url=fedex.com/tracking=1234&complete=true