CasperVend 2/EasyVend

From CasperTech Wiki
Jump to navigation Jump to search
Most CT staff and other users *don't* use EasyVend on a normal basis! Be sure to file a support ticket AND specify that you're using EasyVend.

Introduction

EasyVend is an expansion pack for CasperVend that allows the easy migration of users from the now-defunct E2V vending system over to CasperVend.

Purpose of EasyVend

This expansion was created to assist people migrating in to CasperVend from E2V, another vendor system which was cut off and shut down in May 2018.

If you were NOT using E2V before it was shut down, you will find this expansion VERY frustrating, and VERY time consuming - you might want to start with the normal Quick Start instead!

What's in the box?

EasyVend Features

  • Drop-in replacement for E2V vendor scripts
  • Drop-in replacement for E2V store controller to support profit splits, sales, price groups
  • Drop-in replacement for E2V inventory server for remote delivery
  • Obeys E2V naming rules for item matching
  • Supports DropBox delivery, local vendor delivery and folder delivery
  • Automatically creates products in the CasperVend system
  • Web management not necessary with EasyVend
  • Splits and profit Sharing ARE supported

E2V Items NOT Used by EasyVend

You will NOT need to rez or use any of these items from the E2V vendor pack when converting to EasyVend:

  • Delivery Relay
  • Payments Object
  • Transaction Relay

EasyVend Limitations

  • NOT SUPPORTED: E2V's "partner" sharing feature (because you cannot share inventory servers in CasperVend)
  • NOT SUPPORTED: Group discounts (that's only supported with the full CasperVend)
  • CV Gift Cards: Accepted - will work with local/folder delivery as of version EasyVend v2.01
  • The EasyVend does not display textures - if you want automatic texture management use the full CasperVend
  • You can't manage what displays on the vendor from the web
  • You can't manage profit shares or store credit awards from the web
  • If you use local vendor or folder deliveries, customers will be unable to claim redeliveries using the automatically created products. However, you can edit the product on the web interface and designate a packaged version (and set "copy" perms to allow redelivery) for that product to use for redelivery.
  • Like E2V itself, EasyVend cannot be used as affiliate vendors

Where are the EasyVend Scripts?

Redeliver your PAID CasperVend pack - either "Premium" or "Fat Pack". EasyVend is NOT in the free commission vendors!

FatPack


  1. Rez your fresh FatPack crate
  2. Unpack your FatPack into your inventory
  3. Look for the "Premium Vendors" crate in inventory
  4. Rez the "Premium Vendors" crate
  5. Unpack to inventory
  6. Look for the EasyVend box, rez and unpack that

Premium Vendors


  1. Rez the fresh "Premium Vendors" crate
  2. Unpack to inventory
  3. Look for the EasyVend box, rez and unpack that

Debit Permissions

The E2V system did not ask for debit permissions from vendors (because that was handled by the Payment Server).

However, EasyVend does *NOT* use the Payment Server, so all EasyVend vendors ask for debit permissions when newly created, updated, or hard reset (right-click > edit > "reset scripts in selection").

The reason you will be getting debit permissions windows is because the new script does NOT remember any permissions that may (or may not have been) given to the old scripts. This is required by LSL. The same thing happens when an existing script is hard-reset (Such as if you're using Edit > Reset scripts). More information on debit permissions is here.

Sales Data Migration from E2V to CasperVend

Self-Hosted Migration

If you are a self-hosted E2V customer, and want to export your data, go here for information and instructions.

E2-Designs Hosted

To export your E2V sales data, provided the system is still up, you need to log in to E2V and go here then select what month sales data to export, and save it. Same with your credit history.

Convert Existing E2V Vendors to EasyVend

Migration Options on Ready Products

Products must be ready - as in, they must be packaged and in the dropbox, and/or in the vendors BEFORE resetting / changing the scripts to EasyVend. If the product is added after, the vendor will not work. (So reset them again, if you happened to add the products last.)

You may otherwise choose to replace the scripts in your existing vendors either manually (one at a time), or with the new MigrationBee

Manually Converting E2V Vendors

E2V Inventory Server


  1. Leave any notecards alone
  2. Drop 1 copy of the "CasperTech DropBox" into each "Storage Box" prim of the inventory server.
  3. Leave the smaller "Inventory Server" root prim empty

You may leave the E2V scripts in the Inventory Servers if you are running E2V and EasyVend side-by-side until E2V's cutoff date.

E2V Store Controller


  1. Leave the notecard there
  2. Drop in the "CasperVend2 EasyVend Store Controller" script

You may leave the E2V script(s) in the controller if you are running E2V and EasyVend side by side until E2V's cutoff date.

E2V Vendors


  1. Delete the E2V scripts from each E2V vendor
  2. Drop in the "CasperVend2 EasyVend" script
  3. Answer orange/yellow debit permissions popup

Using Migration Bee

E2V Inventory Server


  1. Leave any notecards alone
  2. Drop 1 copy of the "CasperTech DropBox" into each "Storage Box" prim of the inventory server.
  3. Leave the smaller "Inventory Server" root prim empty

You may leave the E2V scripts in the Inventory Servers if you are running E2V and EasyVend side-by-side until E2V's cutoff date.

E2V Store Controller


  1. Leave the notecard there
  2. Drop in the "CasperVend2 EasyVend Store Controller" script

You may leave the E2V script(s) in the controller if you are running E2V and EasyVend side by side until E2V's cutoff date.

E2V Vendors

Inside EasyVend v2.01 and later you will find the MigrationBee:

  1. Rez the "CasperVend2 Migration Bee E2V" on each sim/region you have E2V vendors
  2. Click it, you'll get a popup menu
  3. Select "Upgrade"
  4. WAIT while it goes around the sim/region swapping out the scripts in all your vendors
  5. ANSWER the debit perm windows as they come up
  6. Repeat on each sim/region you have vendors on

The MigrationBee will handle ALL of YOUR E2V vendors on that sim/region, and must be repeated on every other sim/region you have E2V vendors on.

Delivery Methods After Conversion

Redeliverable Delivery

Non-Redeliverable Delivery

Vendor Delivery - Packaged


Vendor Delivery - Folder


Sales & Discounts

Sales & Pricing

Discounts & Credits

Gifting

Gift Cards

Vending At Events

Creating New EasyVend Vendors

  1. Rez your vendor object
  2. The name of the vendor MUST MATCH the name of the inventory item, Except:
    • There may be additional text at the end
    • The word "vendor" at the end will be ignored
    • Inventory items may be named with multiple words, such as "mesh red boots"
  3. Edit the vendor's description field to indicate pricing and - if used - buyer rewards (loyalty rewards) and/or splits (see below)

Naming Suffix Rules

Suffixes are handled according to E2V rules, just without the use of notecards.

Your vendor's name must match the name of your product box in the Inventory Server. This match has to be exact, including punctuation, capitalization, and spacing. (The most common misnaming between vendors and boxes is extra spaces somewhere between words!)

There are two exceptions to this rule:

1) A vendor object may contain the word "vendor" at the very end of the name, separated by a space. This text will be ignored when matching the vendor to a product box. Thus "My Fancy Shoes Vendor" will actually deliver a product named "My Fancy Shoes" (your transactions will list this name, as well).

2) The Inventory Server supports the notion of "suffixes" which are a way to add extra text onto the end of a product box, yet not require that text on a vendor. For example, all of your product boxes might carry the text "(Wear to unpack)" on the end of them. But this text isn't helpful on a vendor or transaction listing. For example, using the suffixes feature, you can name your vendor "My Fancy Pants" and name your product box "My Fancy Pants (Wear to unpack)". Note also that if you use folder delivery mode in this example, the customer's folder will be named the same as the vendor - without the unsightly "(Wear to unpack)" which doesn't make much sense in a folder name.

Name Matching


Your vendor's name must match the name of your product box in the Inventory Server. This match has to be exact, including punctuation, capitalization, and spacing. (The most common misnaming between vendors and boxes is extra spaces somewhere between words!)

There are two exceptions to this rule:

1) A vendor object may contain the word "vendor" at the very end of the name, separated by a space. This text will be ignored when matching the vendor to a product box. Thus "My Fancy Shoes Vendor" will actually deliver a product named "My Fancy Shoes" (your transactions will list this name, as well).

2) The Inventory Server supports the notion of "suffixes" which are a way to add extra text onto the end of a product box, yet not require that text on a vendor. For example, all of your product boxes might carry the text "(Wear to unpack)" on the end of them. But this text isn't helpful on a vendor or transaction listing. For example, using the suffixes feature, you can name your vendor "My Fancy Pants" and name your product box "My Fancy Pants (Wear to unpack)". Note also that if you use folder delivery mode in this example, the customer's folder will be named the same as the vendor - without the unsightly "(Wear to unpack)" which doesn't make much sense in a folder name.

About the Description Field


The description field may contain:

  1. Pricing (or name of price group, as defined in controller's settings notecard)
  2. Pricing + loyalty/buyer rewards
  3. Pricing + loyalty/buyer rewards + splits

Remember, any rewards or splits that are not being used need to be explicitly defined instead of being left blank.

Important Note


Please remember that scripts cannot automatically detect when a prim's name or description changes. So any time you make a change to the prim name or description, you must also click > get popup > reset the vendor script. You can do this easily by selecting "Reset" from the vendor's popup menu.

Converting from EasyVend to regular CasperVend

Troubleshooting