CONSIGNOR HELP CENTER

Sidebar List

CONSIGNOR RETURN FORM

Please start by going to returns.consignor.com/setup in order to generate the code for your return form. This requires you to keep your API key for ShipmentServer and your ActorID handy. You can acquire

these from CONSIGNOR support.

Test or production? If you are generating a form for your testing environment, please use the API key and ActorID for the ShipmentServer QA server.

If you are generating a form for your production environment, please use the API key and ActorID for the ShipmentServer production server.

Please make certain that you do not use a testing form on your production website, as the return labels generated here will not be valid for customers. (You can avoid this by restricting your test form to your test domain, if you have a separate test domain - see below.)

Click “Next”.

Selecting return products

When you have entered the API key and ActorID, you will see a list of available products activated on this actor. Please check one or more products that your customers will be able to use when returning goods to you. Then click “Next”.

Selecting domain and form settings

Please enter the domain that your form should work on. This should be the exact domain including subdomain(s). That is, if the form should be embedded on shop.mydomain.com, please enter this whole domain, and not just mydomain.com.

If you check the checkbox Include a "Reason for return" field on the form, your form will be extended with an extra field where the customer can enter the return reason.

If you check the checkbox Receive email notifications for each return label, you will receive an email for each label that is generated. The email is a copy of the email to the customer, and it will be sent to the address that you enter in your contact info (step 3). The email will contain the return reason, if this field has been enabled on the form as described above. The email will also have the generated label attached as a PDF file.

Now click “Next”.

Using the script

Now your script will appear on the screen in the textbox at the bottom of the page. Copy the script (or keep the window open), as you will need to paste the script into your website at a suitable location.

Locate the page on your website where you want the form to appear. This might be a job for your webmaster/developer.

You must be able to edit the source code of this page in order to embed the form. The server side language of the page (i.e. PHP, .NET, Ruby, HTML only, or other) is not important, as the form script is pure javascript and will work in any type of page (since the form is generated client-side).

Insert the whole script on the chosen page.

Changing the language of the form The form is currently available in the following languages:

English (ENG)

Danish (DAN)

Norwegian (NOR)

Swedish (SWE)

Finnish (FIN)

To change the language, please observe the following line in the script that you just inserted into your own website:

Notice the “ENG” part in the src-attribute. Change this to one of the three-letter codes (i.e. “DAN”) that you see in the bullet list above. If you enter an invalid code, the language will default to English.

For webmasters: Notes about jQuery The form script uses the jQuery javascript library. The use of this library is very widespread, and thus, in many cases, jQuery will already be loaded on your website.

Our form script will check whether or not jQuery is present, and if it is not, it will be loaded.

Additionally, our form script uses the jQuery.noConflict() method to remove jQuery from the "$" variable. Thus, jQuery functions will be called on "jQuery" and not on "$". This means that our form should work alongside other libraries using "$" as top-level variable (for instance Prototype or MooTools).

For webmasters: Notes about CSS styling You may want to change the look of the return form - i.e. change the width, the font face, the background colours, or make other adjustments.

This can be done by adding CSS rules to the page after the default styles have been loaded. You can override the default CSS rules or add your own rules. Look for the place in the script that says:

If you need to see the default CSS, you can find the stylesheet here: http://returns.consignor.com/css/returnform.css. You could also inspect the form with for example Google Chrome’s inspector to see the default styles for each element.