General -- beYou Vendors

The local market page on the beYou website is designed to allow ALL beYou Citizens (regular & Lil'b) to sell such items as fresh produce (i.e. fruits, vegetables, herbs & flowers), some crafting items (eg. paints, tools, textiles, etc.) and prepared foods (i.e. prep dishes, dry goods, other user-made grocery items).

Items can be located by using the search bar on the page, or by using the filter categories on the left side of the page to locate either your favorite seller or a specific item.

The filters on the left side of the page also work in conjunction with the search bar results so as to streamline your search for a specific seller's items.

**NOTE**: Beginning November 6, 2021 vendors have been converted to no longer use crates or the old market scanners.  To update your items, please read the announcement page to see what you should be sending in for updating.

**WARNING: If you are rezzing on private land with no intention of selling, rez your vendors at least 10 meters away from your parcel or sim borders. Because vendors require you to be within a certain distance, this may help prevent the potential for items you want to keep from being purchased without your permission.**

## Requirements/Restrictions

* No level requirement.
* Items must be in your assets to sell them.
* You may only rezz (1) of each of the new vendor types per item per sim (example: (1) bY Buttermilk Vendor-P & (1) bY Buttermilk Vendor-A on sim #1, sim #2 and so on...depending on where you sell your items).
* If you are beYou dead, your vendors will not work and you won't be able to sell your goods.

## Asset Storage & Selling Explained

All items you are able to sell will be stored in your assets (aka your beYou account). To see what is in your assets, simply login to https://www.beyouworld.com/me and you will see your assets on your profile.

**VERY IMPORTANT**: Because everything is now stored in your assets, the expiration countdown on consumeable/perishable items beings IMMEDIATELY. You have 30 days in which to use, sell or otherwise transfer an asset to keep it from expiring. You will also have an option on your vendors to use the 'all' button to refresh some of your expiring items. To find out more about refreshing, please read the sections marked Refreshing Harvests & Refreshing Expirations below.

Because all of the items we sell are asset based (meaning come from your beYou account), you will no longer be able to hold items in your SL inventory. What this means is that if you have a vendor rezzed and you produce an item it will ***automatically*** increase the amount of available items on our rezzed vendor (and subsequently on your markets page) on the next purchase from that vendor.

**NOTE**: If you have a limit set on a vendor (see below), then only the amount set by the limit will be visible to your customer, nothing more until you reset or change it.

### Packagers

All packagers available will allow you to sell or gift assets from your inventory to other beYou citizens by retrieving vendors from each type of packager. To find out how to use each packager, visit our Packager category where you can find link to how to use each packager available.

## Safety

**WARNING**: **If you are rezzing on private land with no intention of selling, rez your vendors at least 10 meters away from your parcel or sim borders. Because vendors require you to be within a certain distance, this may help prevent the potential for items you want to keep from being purchased without your permission.**

beYou Vendors have a security measure included that prevents anyone from buying from your vendors if they're more than 5 meters away from your items. What this means is that unless your vendor is within 5 meters of the person, they can't even cam to it and buy from you. It is very important to consider the following when setting up your vendors:

1. Unlist your vendors. Step-by-step instructions are below.
2. If you have zero desire to sell anything at all, change your market preference in your profile.
3. Unlist your vendors. Step-by-step instructions are below.
4. Position personal vendors 10 meters or more from your parcel or sim borders. Vendors require you to be within 5 meters of them in order to be used. So position them as far away from your borders as possible
5. Unlist your vendors. Step-by-step instructions are below.
6. Security orbs on personal property are your friends. Use them. If your land doesn't allow orbs but allows ban lines, put up your ban lines.
7. Unlist your vendors. Step-by-step instructions are below.
8. Use the Vendor-A vendors. You can make those invisible and place them over objects you may find are only identifiable to you. Make your vendors blend in with your surroundings.
9. Once you finish refreshing a vendor or buying just for yourself, pull it into your SL inventory. Make a folder just for your unlisted vendors so you aren't leaving them out.
10. Did we mention unlisting your vendors? Really it's an extra step but it works!

Now .... onto vendor types!

#top

## Vendor Types

You may rez one Vendor-P and one Vendor-A at the same time for the same product on the same sim. The last vendor you rez and set up will be the one whose price will show on the local market page.

### Regular Vendors

Unless there's special options/instructions for vendors, you will be able to choose from two types of vendors you can use to sell your items:

* Vendor-P - The P stands for (Prim) and this is the item we provide that looks just like what you're selling.
* Vendor-A - The A stands for (Alpha) and this is for you to rez over your own prim if you choose to change the way it looks.

### Harvest Vendors

These items work just like the regular vendors with one exception: conversion vs refreshing on purchase. When using a harvest vendor you can refresh your expirations (by choosing all) or convert/store actual uses by choosing a quantity. More on this is below under purchasing methods.

You can get a harvest vendor by using either the composter or the farmer's scale.

#### Owner Options

Unlike other vendors, your harvests require conversion in order to be used. Because of this, there are two options to be used as an owner of a harvest vendor:

##### Using (Storing) Harvests

In order to use your harvests for activities such as cooking or crafting, you must first convert, also known as store, your crops from a harvest to a useable item. Once stored, fruit and vegetable harvests drop the word harvest and are their normal name for use. Once an herb is converted (stored), it drops the word harvest from the end and is then considered a fresh herb.

To do this:

1. Click the vendor.
2. Choose a quantity (**not** 'All') to purchase.
3. Pay yourself.

Once you've chosen a specific quantity and purchased from your own vendor, your harvest will be converted to a stored and useable asset.

For example: You have 5 uses of avocado but would like to use 1 to cook with. You will click your avocado harvest vendor, choose 1 (for qty), then pay yourself. That use will convert from *beYou Avocado Harvest* to *beYou Avocado*, which means it's ready to be used to cook with or consume. Again, do **NOT** choose ALL when trying to convert/store your harvests as a useable item.

##### Refreshing Harvests

In the event that your harvest is close to expiration and you still want to be able to use it (or sell it) without turning it into fertilizer, you may extend its life by doing the following:

1. Click the vendor.
2. Choose ALL from the menu.
3. Pay yourself.

By doing this, your harvests' expiration date will reset and you will have an additional 30 days in which to either use or sell your harvests.

#top

## Vendor Setup

Unless you've changed your markets options under preference in your account options on your profile, vendors will appear on the local markets page immediately.

You may rez one Vendor-P and one Vendor-A at the same time for the same product on the same sim. The last vendor you rez and set up will be the one whose price will show on the local market page.

To set up your market vendors:

### Initial Vendor Setup

1. Get the vendor of your choice from the packager of your choice.
2. Pick where you'd like your vendor to be sold.
3. Rezz the vendor. On rez, the vendor will appear RED.  This is normal.
4. When the sale price window pops up (upper right of screen), add Sale Price per use (remember this is PER USE, not total available). Click submit.
5. On the bottom right of your screen, you will be asked to accept debit permissions. Click allow.

Once you've finished your initial setup, your vendor will lose its red color overlay and unless you've changed your seller preferences under account options, the vendor will appear on the local markets page immediately. At this point, your vendor will sell each use for 1L and only one at a time.  If you'd like to change this, please follow the Owner options below.

### Owner Options

Once you've set up your vendor and accepted debit permissions, you will be able to use the following options to finish setting up your vendor. To continue/finalize setup:

* Limit - allows you to set a limit as to how many of an item is available for purchase via the markets page.  You may set your limited amount of uses between 1 and 100 (meaning max is 99). Once that limit is reached, no one will be able to purchase beyond that amount from the vendor until you reset it and set a new limit. if someone tries, their money will be automatically refunded.
	+ For example: if you have 50 uses of bY Buttermilk and only want to sell 10, then you'd use the limit button to set the limit to 10, which means that the other 40 uses are yours to use and not risk selling out of your assets.
* Menu Qty - allows you to sell your items in various quantities for customers to choose from. While the quantity of what you sell is up to you, it is recommended that you sell more than one of an item so as to accommodate bulk shoppers. Bulk shoppers will pass your vendor(s) by if they have to purchase an item one use at a time.
	+ Menu1(1) - customer can buy 1 use per purchase.
	+ Menu2(1,2,4,5) - customers can buy a choice of 1, 2, 4, or 5 uses per purchase.
	+ Menu3(1,2,4,5,8,10) - customers can buy a choice of 1, 2, 4, 5, 8, or 10 uses per purchase.
	+ Menu4(1,2,4,5,8,10,25) - customers can buy a choice of 1, 2, 4, 5, 8, 10. or 25 uses per purchase.
	+ Menu5(1,2,4,5,8,10,25,50,100) - customers can buy a choice of 1, 2, 4, 5, 8, 10, 25, 50 or 100 uses per purchase.
* Reset - restarts the whole pricing process and sets everything back to default, meaning no discounts or limits and default menu choice.
* Resize - allows you to resize the vendor for better viewing. Please note that increasing the size also may increase your land impact so be aware of and monitor your land impact before resizing.
	+ Once in resize mode, you have 2 minutes to resize the vendor then the mode will turn off.
	+ When in resizing mode, you can click the middle area of each face to resize width, height, length, or the corners to close out of resizing mode.
	+ Clicking the center will decrease size while outside the arrows will increase.
* Alpha - Alpha will turn the vendor transparent or back visible.
* Disc - Disc will allow you to set a discount for purchases of 5 or more quantities - add a number from 1 to 100 and that will be the percent discount off (-10% example) the single sale price you set.
* *All* - The all option allows you to purchase all of your assets for that item again.
* *Various numbers* - numbers matching your menu qty choice will appear so that you as an owner can purchase in those amounts for yourself (see refreshing expirations).

**IMPORTANT**: If you have vendors rezzed in multiple locations for different prices, the last vendor rezzed will be the price that appears in the listing on the local markets page.

#top

#### Quantity Updates

Asset quantities in vendors only update when the vendor is used. If you increase your assets on an item you're selling and would like to have the most up to date amount showing as available, you will need to buy ALL to yourself (which also restarts you expiration date countdown) so that the new amount shows.

#### Special Feature Tips

##### Setting Limits

If you have a limit set on your vendor and someone tries to purchase that item and it's over the limit, they will be refunded automatically. The vendor will not disappear, so make sure you restock! If you have no limit set and the item sells out, the vendor will disappear.

#### Discounts

The discount feature only applies to purchases made of 4 or more. When you set a discount, you're choosing to set a "percent off" of each use you are selling. For example: if you're selling hammers and you have 50, you could setup the vendor to sell each for 20L (just for example this price is arbitrary). If you don't set a discount every time someone makes a purchase regardless of the amount it will be 20L each. If you set a discount, for let's say 50% (meaning that you click the discount button and enter the number 50 during your vendor setup), then when someone makes a purchase of 4 or more from your vendor they will be charged 10L each instead of 20L per use. This will automatically adjust the price when they go to pay.

In addition, you may now set the limit for discounts to 100. Prior to 12/17/2021 you could only set it to 99.

#### Selling Out of an Asset

Once you sell out of any given asset, the vendor will disappear. You will see the following message once all assets of an item are sold out.

* [01:05] beYou Ginkgo Cut (Vendor-P): Deleting beYou Ginkgo Cut (Vendor-P) as it went over its sell limit or no more assets found for this item.

### Changing Prices

You can change the prices on active beYou Vendors one of two ways:

1. If available, click the vendor and then the reset button. Doing this will allow you to not only change the price of your vendor, but change other limitations as well.
2. If a reset button isn't available, pull the active vendor into your inventory. Wait about 5-10 seconds, then re-rezz the vendor. This will cause the unit to reset and you will start from scratch.

## Adding Images

For every new item placed on the local markets page (that you haven't sold ever before), you may want to add your own image to it in order to be more easily identifiable when people are searching for your items.

To add an image to your market item:

* Under the markets menu, choose Local Markets and choose one of your items (make sure it has your name).
* Click the image button.
* Click browse and choose an image from your hard drive. Your image must be 220 x 160 or smaller. Click 'Save Changes'.

Once an item has expired it will disappear both inworld and from the local markets page.

#top

## Market Listing Preferences

There are now two ways to list/unlist your vendors.

### Profile Preferences

If you don't want your vendors to appear on the local markets page, you must change your markets setting under your beYou profile's preferences.

This is an all-or-nothing option, meaning you can't pick and choose which vendors are visible.

To update your preferences:

1. Login to www.beyouworld.com & go to your beYou profile page.
2. Click the blue Account Options button & choose preferences.
3. Go to Markets & click the button to turn it on or off. You can do this as much as you like (no time limit between changes).
4. Click save changes.

If you leave vendors out and turn it off they will stay up for a little while. If you turn off vendor listing preferences and don't rez any more vendors, the ones on the markets page will only disappear if you either pick them up or they will vanish from the market 3 hrs after turning off the preference. If you turn off your preferences and have items already for sale showing on the markets page, then the next vendor you rez will delete all vendors from the markets page.

### Individual Vendor Options

Effective: 12/17/2021

This change affects new vendors only. To take advantage of this change you will need to delete your old vendor and rezz a new one.

The "UnList" option on the vendors provides a "one off" un-listing for your individual vendor being used. If you have a vendor that you do not wish to show up on the local markets page but have other vendors that you DO wish to show up, you will have to use the UnList option to unlist that specific vendor. To do this:

1. Click the vendor.
2. Choose unlist.

Once you choose this option, you will see "*Name of item (Vendor-P or Vendor-A, whichever one you're using): This vendor will no longer list on the markets page.*" in your nearby chat. This only affects the vendor chosen, not the entire product being sold.

Once you unlist a vendor, the option can **not** be changed (while rezzed). In order to relist an item onto the market page, you will have to delete the unlisted vendor, then rez a new one and set it up again to enable the listing for that vendor on the local market page.

**PRO TIP**: If you create an unlisted vendor for personal use and bring it back into your inventory, it will remain unlisted the next time you rez that same vendor inworld. Be sure to double check though just in case.

#top

## Vendor Removal

Vendors will periodically check themselves throughout the day and will auto-terminate (delete) when your assets fall to 0. You may also manually delete a vendor to remove it entirely from the local market page.

## Vendor Refunds

Refund transactions will no longer post to your market transactions on your beYou profile. All assets will be automatically adjusted.

## Purchasing From Vendors

The new market vendors work the same as the beYou seed vendors at the main sim. To purchase an item from a new vendor:

1. Click the vendor.
2. Choose your qty. NOTE: Owners will also see the option 'all', which allows them to purchase their entire amount of assets again.
3. Choose 'myself' (for you) or ‘gift’ (for someone else).
4. If choosing the gift option, you will need to do the following to access your friend's UUID number to place into the submission box:
	* Open your friend's profile.
	* Directly under your friend's user and/or display name is a field called Key. Highlight that entire number and copy it.
	* Paste that number into the blue (or whatever color your viewer uses) submission box.
	* Click submit.
	* Say yes to confirm.
5. Once the following message is stated in local "Please right click and pay the vendor and this item will be delivered to  [Name of Person]", you may then right-click the vendor and pay it.
6. Once the vendor receives your payment, you will receive the following two messages in local:
	* [01:32] "Name of beYou item sold" (Vendor-P): Please wait while your transaction processes...
	* [01:33] "Name of beYou item sold" (Vendor-P): Your gift has been delivered to [Name of Person]

The purchased item(s) will be added to the recipient's assets.

**IMPORTANT**: Once a menu is clicked, you have a 10-20 second window before the vendor menu resets. If this happens you have to start over.

### Refreshing Expirations

If you have a surplus of an item in your assets and it (your asset item) is close to expiring, then you will need to refresh your items. Depending on the item you need to refresh, you will need to use the proper packager(s) in order to retrieve the vendor in order to do that. For a list of packagers, visit the packager category page. It will list most packagers we have in beYou with links on how to use each if necessary.

To refresh your expirations:

1. Click the vendor.
2. Choose ALL from the menu.
3. Pay yourself.

The life cycle of the asset will reset for another 30 days. You will need to use the packager that coincides with what ever item you're trying to refresh. For a list of packagers, visit the Packagers category. Then click on the provided link(s) to learn about each one.

## Troubleshooting

* **RED VENDOR SYNDROME**: If your vendor is when you rez it (or turns red while rezzed), delete it and get a new vendor from the correct packager.

## Vendor Update Q&A

Questions regarding the update from 12/17/2021:

Q: Will my existing vendors be automatically updated?

A: No. Any existing vendor that has not been replaced as of **12/17/2021** will not show these new features. If you have existing vendors and want to use the features described below you MUST send yourself a new one and delete the one you have out. This update will not force a change for everyone, only the users who pick up new vendors going forward.

Q: Will my existing vendors still work?

A: Yes, you are not required to do anything if you do not want to. All existing vendors will still work.

## Reminders

* Unless you have changed your markets setting under account options on your beYou profile, all vendors, regardless of location, will appear automatically on the local markets page.
* Price your items PER USE, not for a total amount available.
* If you run out of an item, the vendor will disappear.
* Out of respect for group rules, please do not advertise or continually reference your store in beYou World Group chat. Not only is it subtle advertising (vs blatant 'come check out my store') it's inconsiderate and against the rules of the group charter.

#top