CasperVend 2/Redeliveries: Difference between revisions

Latest revision as of 20:02, 18 April 2018

About the Redelivery System

The redelivery system has the unique feature of allowing global redelivery.

What this means is that any customer may use ANY merchant redelivery terminal (or the "redeliver" popup menu option via the vendor) to redeliver a copiable product from ANY other merchant.

Where's the Redelivery Terminal?

For convenience, there is a redelivery terminal included in both free and premium vendor crates. (In the fatpack crate, this will be in the "premium vendor" box within the fatpack crate.)

The redelivery terminal is both copy and transfer, so if you have affiliate/franchise packs, you can tuck a redelivery terminal in there.

Customising the Redelivery Terminal

Rez the CasperTech Redelivery Terminal on the ground.
Right-click > Edit > Contents > Pull the script from the terminal to your inventory.
Rez your desired redelivery object on the ground.
Right-click > Edit > Contents > Drag the redelivery script from your inventory into your desired object.

That's it! No additional script or website configuration is necessary!

Who Can Redeliver Products?

The person who received the product is the one who is able to claim redelivery, if it is marked copy on the website.

If a customer was gifted a copiable item, but for SL reasons it never arrived, that customer may claim redelivery without having to track down the person who sent it to them.

Setting Redelivery Options

One of the things the website asks for when you enter your product details is "product permissions". These settings do two things:

It gives information to the customer via the "Info" option so they know what to expect.
Controls whether the customer can collect a redelivery.

The website is unable to change permissions on any items in your dropbox, so it is essential that you set your permissions properly on both your products inworld as well as on the website.

All Purchases

All purchases will be shown on the redelivery page.

This does not mean that all products that are visible will be redeliverable.

The images below will illustrate the difference in the redelivery page listings between products marked copy and no-copy.

Product set COPY	Product set NO COPY

Allow Redelivery of Copiable Products

Log in to [CasperVend]
Click Products tab
Create your product as usual
On the permissions line, make sure "Copy" is ticked/checked
Click save

Prevent Redelivery of No-Copy Products

Log in to [CasperVend]
Click Products tab
Create your product as usual
On the permissions line, make sure "Copy" is NOT ticked/checked
Click save

Redelivery HUD and API Options

Since version 2.4 of the terminal, it's possible to customise the generation of redelivery URLs.

To customise the redelivery terminal, there are two options:

1. With the regular terminal (v2.4 or up), you can add a merchant UUID to the description in order to get it to generate a redelivery page for that MERCHANT. The format is:

MERCHANT:<user key>

for example

MERCHANT:d1cd5b71-6209-4595-9bf0-771bf689ce00

for the CasperTech store.

2. SCRIPTERS ONLY: Use the extra script added to the vendor packs as of 2017-11-12. The script is called "8) Redelivery Link Generator v2.4 for HUDs", and you can send a linked message to it as follows:

key user = "put the user's UUID here";
key merchant = "put the merchant's UUID here";
llMessageLinked( LINK_THIS, 0, "REDELIVER|"+(string)merchant, user );

Note that for security reasons, the URL is sent directly to the user. It's not possible to intercept the URL. The user must be on the same region as the script.

If you don't yet have v2.4, you need to get the latest version!

FAQ / Troubleshooting

Q. My customers aren't getting the product after purchase, and the redelivery terminal keeps giving them a "Failed: Couldn't find delivery box for item on SLIFE. This merchant may no longer be using CasperVend." message, when it is, and I am.

A1. Reset the dropboxes via the touch/popup menu. If that doesn't work, then manually Edit > "Reset scripts in selection".

A2. If you only have dropbox(es) on ONE sim/region, then we strongly recommend having a duplicate set on at least one other sim/region.

@@ Line 2: / Line 2: @@
    |__TOC__
    |}
+<!-- redelivery -->
-== '''<span style="color:#00528c">Redelivery Terminal</span>''' ==
+[[File:German_flag.gif]] [[CasperVend 2/Redeliveries/DE | Schaue hier in Deutsch!]]
-CasperVend includes a redelivery terminal in every vendor pack. This allows the customer to redeliver any COPIABLE products themselves, without having to wait for your intervention. All you need to do is rez this out on your store parcel at a location your customers can access.
-This redelivery terminal has the unique feature of letting customers redeliver copiable products from ANY redelivery terminal on the grid - not just the one in the store the product came from. This makes it fast and convenient for all customers.
-You '''will''' need to mark "copy" ON THE WEBSITE in order for customers to be able to redeliver that product. Otherwise, the website will assume no-copy and prevent redeliveries.
+== '''<span style="color:#00528c">About the Redelivery System </span>''' ==
-The redelivery terminal is usable by whoever RECEIVED the copiable product. So if a customer was gifted an item, but it never arrived, the giftee/recipient is the one who should use the redelivery terminal.
-== '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' ==
+The redelivery system has the unique feature of allowing global redelivery.
-: '''Q. My customers aren't getting the product after purchase, and the redelivery terminal keeps giving them a "Failed: Couldn't find delivery box for item on SLIFE. This merchant may no longer be using CasperVend." message, when it is, and I am.'''
-:: '''A.''' Reset / resync the DropBox(es). Use the touch menu first - if that doesn't work, then manually Edit > Reset scripts in selection to get them to actually reset.
-: '''Q. Does anyone  know if the redelivery  system is down?'''
+What this means is that any customer may use ANY merchant redelivery terminal (or the "redeliver" popup menu option via the vendor) to redeliver a copiable product from ANY other merchant.
-:: '''A1.''' Make sure the redelivery terminal is up to date
-:: '''A2.''' If the customer is not seeing the product they say they purchased, make sure there's actually a record of THAT avi purchasing the product (and not an alt)
-: '''Q. Does the redelivery terminal redeliver no-copy/transfer items? If so, is there a way to prevent that from happening? '''
+=== Where's the Redelivery Terminal? ===
-:: '''A.''' Casper Warden writes: "When you set up a product on caspervend, it asks you what the perms are.  If you select no copy, then the product won't be redelivered. So it's not the perms of the actual items that count, but the perms that you choose on the website. Otherwise the system wont know - or care - what perms you have."
+----
+For convenience, there is a redelivery terminal included in both free and premium vendor crates. (In the fatpack crate, this will be in the "premium vendor" box within the fatpack crate.)
-&nbsp;
+The redelivery terminal is both copy and transfer, so if you have affiliate/franchise packs, you can tuck a redelivery terminal in there.
+=== Customising the Redelivery Terminal ===
+----
+:# Rez the CasperTech Redelivery Terminal on the ground.
+:# Right-click > Edit > Contents > Pull the script from the terminal to your inventory.
+:# Rez your desired redelivery object on the ground.
+:# Right-click > Edit > Contents > Drag the redelivery script from your inventory into your desired object.
+That's it! No additional script or website configuration is necessary!
+== '''<span style="color:#00528c">Who Can Redeliver Products? </span>''' ==
+The person who '''received''' the product is the one who is able to claim redelivery, if it is marked copy on the website.
+If a customer was gifted a copiable item, but for SL reasons it never arrived, that customer may claim redelivery without having to track down the person who sent it to them.
+== '''<span style="color:#00528c">Setting Redelivery Options </span>''' ==
+One of the things the website asks for when you enter your product details is "product permissions". These settings do two things:
+:# It gives information to the customer via the "Info" option so they know what to expect.
+:# Controls whether the customer can collect a redelivery.
+The website is unable to change permissions on any items in your dropbox, so it is essential that you set your permissions properly on both your products inworld '''as well as''' on the website.
+=== All Purchases ===
+----
+All purchases will be shown on the redelivery page.
+This does '''not''' mean that all products that are visible will be redeliverable.
+The images below will illustrate the difference in the redelivery page listings between products marked copy and no-copy.
+{| class="wikitable"
+|-
+! '''Product set COPY'''
+! '''Product set NO COPY'''
+|-
+| [[File:RedeliveryPage-Copy.png]]
+| [[File:RedeliveryPage-NoCopy.png]]
+|}
+=== Allow Redelivery of Copiable Products ===
+----
+:# Log in to [CasperVend]
+:# Click Products tab
+:# Create your product as usual
+:# On the permissions line, make sure "Copy" is ticked/checked
+:# Click save
+[[File:Redelivery-WebsiteCopy.png|450px]]
+=== Prevent Redelivery of No-Copy Products ===
+----
+:# Log in to [CasperVend]
+:# Click Products tab
+:# Create your product as usual
+:# On the permissions line, make sure "Copy" is '''NOT''' ticked/checked
+:# Click save
+[[File:Redelivery--WebsiteNoCopy.png|450px]]
+== '''<span style="color:#00528c">Redelivery HUD and API Options </span>''' ==
+Since version 2.4 of the terminal, it's possible to customise the generation of redelivery URLs.
+To customise the redelivery terminal, there are two options:
+: 1. With the regular terminal (v2.4 or up), you can add a merchant UUID to the description in order to get it to generate a redelivery page for that MERCHANT. The format is:
+:: MERCHANT:<user key>
+:: for example
+:: MERCHANT:d1cd5b71-6209-4595-9bf0-771bf689ce00
+:: for the CasperTech store.
+: 2. '''SCRIPTERS ONLY:''' Use the extra script added to the vendor packs as of 2017-11-12. The script is called "8) Redelivery Link Generator v2.4 for HUDs", and you can send a linked message to it as follows:
+:: <syntaxhighlight lang="lsl">key user = "put the user's UUID here";
+key merchant = "put the merchant's UUID here";
+llMessageLinked( LINK_THIS, 0, "REDELIVER|"+(string)merchant, user );</syntaxhighlight>
+: Note that for security reasons, the URL is sent directly to the user. It's not possible to intercept the URL. The user must be on the same region as the script.
+If you don't yet have v2.4, you need to '''[[Updating#How_to_Get_the_Latest_Version | get the latest version!]]'''
+== '''<span style="color:#00528c">FAQ / Troubleshooting </span>''' ==
+:'''Q. My customers aren't getting the product after purchase, and the redelivery terminal keeps giving them a "Failed: Couldn't find delivery box for item on SLIFE. This merchant may no longer be using CasperVend." message, when it is, and I am.'''
+:: '''A1.''' Reset the dropboxes via the touch/popup menu. If that doesn't work, then manually Edit > "Reset scripts in selection".
+:: '''A2.''' If you only have dropbox(es) on ONE sim/region, then we strongly recommend having a '''[[CasperVend_2/DropBoxes#When_Possible.2C_Have_Duplicate_DropBox.28es.29 | duplicate set]]''' on at least one other sim/region.