refurbed

The marketplace refurbed offers renewed products at a reduced price that are more sustainable than new products. This includes for example mobile phones, laptops, tablets or smartwatches.

Open beta phase

The refurbed integration is currently in the open beta phase. If you want to register, send an email to seller@refurbed.com.

1. Becoming a seller at refurbed

Send an email to seller@refurbed.com in order to register as a seller so you can offer your products on refurbed. Afterwards, you will receive your access data that are required for the setup in PlentyONE.

2. Frequency of data exchange

After you have set up refurbed in PlentyONE, data is exchanged with the market in the intervals described in Table 1.

Table 1. Frequency of data exchange
Data Interval

Order import

every 15 minutes

Import returns

hourly

3. Setting up the data exchange

In order for the interface to successfully carry out the order import and the import of returns, at least the settings in the following table are required.

Table 2. Mandatory settings for refurbed
Settings section Settings

Order import

Basic settings for the market

  • The account has been connected via the Connect button by entering the token.

  • The toggle button Active for activating the account has been activated.

  • The toggle button Order import has been activated.

  • An AfterShip carrier has been selected.

Import returns

Basic settings for the market

  • The account has been connected via the Connect button by entering the token.

  • The toggle button Active for activating the account has been activated.

  • The toggle button Import returns has been activated.

  • An AfterShip carrier has been selected.

4. Workflow of an order

  • Your items are listed on refurbed.

  • Customers place an order on refurbed.

  • The order is imported in PlentyONE and already contains all data.
    Note: Orders with differential taxation are imported with a VAT rate of 0%
    Tip: You can optionally accept or reject orders via event procedure. If you don’t use an event procedure, orders are accepted automatically.

  • The order is shipped.

  • The shipping confirmation must be sent to refurbed by event procedure.

  • The invoice must be uploaded to refurbed via event procedure.
    → The invoice is sent to the customer via event procedure.

Further notes on the order process:

  • In order to send items, make sure that a package number exists on the order.

  • If you want to have different serial numbers for specific items, create two separate delivery orders.

  • Even if an order is split into several delivery orders, you can only create an invoice for a complete order.

  • If a return label exists, you can find it in the Notes section of the respective order.

  • If your customer has provided a private VAT ID, you can find it in the Additional information (Name 4) field in the Addresses section of the respective order.

4.1. Workflow of a return

  • Your items are listed on refurbed.

  • Customers place an order on refurbed.

  • The order is imported in PlentyONE and already contains all data.
    Note: Orders with differential taxation are imported with a VAT rate of 0%
    Tip: You can optionally accept or reject orders via event procedure. If you don’t use an event procedure, orders are accepted automatically.

  • The order is shipped.

  • The shipping confirmation must be sent to refurbed by event procedure.

  • The invoice must be uploaded to refurbed via event procedure.
    → The invoice is sent to the customer via event procedure.

  • Customers can return the entire order or individual items.

  • The return is imported into PlentyONE.
    Note: To import returns, you must activate the toggle button Import Returns in the basic settings and select an AfterShip carrier.

  • You must provide the customer with a return label or coordinate the return via email.

  • Customers send the return to you.

  • Once you have received the return, the return must be reported to refurbed by event procedure.

  • The refund is initiated.

  • When the refund amount is sent to refurbed, a debit payment for the refund amount is added to the order in PlentyONE.
    Note: You can find the payment under Orders » Orders » [Open order] in the Assigned payments section. Click on the Payment ID to view the payment details. The payment contains:

    • the refunded Amount,

    • the Status,

    • the Received on date,

    • and in the Reason for payment field, the Order ID or, in the case of a partial return, the Order Item ID.

5. Setting up refurbed in PlentyONE

Set up refurbed in PlentyONE in order to sell your items on the marketplace. To do so, proceed as described in the following chapters.

5.1. Creating an account

In order to offer items on refurbed, you first need an account. To create an account, proceed as follows.

Creating an account:

  1. Go to Setup » Markets » refurbed » Settings.

  2. On the left, click on Add account (add).
    → The Add account window opens.

  3. Select a Client from the drop-down list.

  4. Enter a name.

  5. Afterwards, click on add Create.
    → The account is created and added to the overview.

In order to connect an existing refurbed account, you need the token that has been provided by refurbed. To do so, proceed as follows.

Connecting an account:

  1. Go to Setup » Markets » refurbed » Settings.

  2. Click on the account that you would like to connect.
    → The account opens. At the top right, click on Connect (refresh).
    → The Add credentials window opens. Enter the token that you received from refurbed. Click on Connect (refresh).
    → The account is connected.

5.3. Carrying out the basic settings

Once you have created the account for refurbed, you can carry out the basic settings. To do so, proceed as follows.

Carrying out the basic settings:

  1. Go to Setup » Markets » refurbed » Settings.

  2. Click on the account for which you want to carry out the basic settings.
    → The detail view of the account opens.

  3. Carry out the settings. Pay attention to the information given in Table 3.

  4. Save (save) the settings.

Table 3. Basic settings for refurbed
Settings section Settings

General

Active

Activate (toggle_on) the account in order to enable the data exchange with refurbed.

Orders

Order import

Activate the order import (toggle_on) to import orders from refurbed in PlentyONE.
For the order import, can optionally select a start date and start time. This is especially helpful if you have used the refurbed plugin before and now want to change to the marketplace integration. By using these settings, you can import your orders starting from the time of the change.

Importing returns

Activate the import of returns (toggle_on) to import returns from refurbed in PlentyONE.
In the Status for confirmed refunds field, you can optionally select a status for orders that have been refunded.

Shipping region

AfterShip carrier

Select an AfterShip carrier from the drop-down list.

5.4. (De)activating an account

In order to activate or deactivate an account, proceed as follows.

(De)activating an account:

  1. Go to Setup » Markets » refurbed » Settings.
    → The available accounts are displayed.

  2. Click on the account that you want to activate or deactivate.
    → The account settings open.

  3. Activate the toggle button Active (toggle_on) in order to activate the account.
    Or: Deactivate the toggle button Active (toggle_off) in order to deactivate the account.
    → The account is activated or deactivated.

5.5. Deleting an account

In order to delete an account, proceed as follows. Note that only inactive accounts that do not have any orders connected can be deleted.

Deleting an account:

  1. Go to Setup » Markets » refurbed » Settings.
    → The available accounts are displayed.

  2. On the right of the account’s column that you want to delete, click on Delete account (delete).
    Or: At the top of the account’s detail view, click on Delete account (delete).
    → The window Delete account opens.

  3. Click on Delete (delete) in order to confirm the deletion.
    → The account is deleted.

5.6. Activating the order referrer

Go to Setup » Orders » Order referrer to activate the order referrer. This ensures that orders are assigned to the correct sales channel.

What is an order referrer?

An order referrer tags an order with the sales channel on which the order was generated. Sales channels can be e.g. your online shop or markets on which you sell your items. Each sales channel has an individual order referrer. Some order referrers are available by default in your PlentyONE system. Further order referrers are added e.g. if you install a new plugin. For further information about the order referrer, see the page Order referrer of the PlentyONE manual.

Activating the order referrer for refurbed:

  1. Go to Setup » Orders » Order referrer.

  2. Click Search (search).

  3. In the list, navigate to the option refurbed with the ID 183.

  4. On the right of the referrer’s line, click on Edit (edit).
    → The window Edit referrer opens.

  5. Activate the option Visible in selection (toggle_on).

  6. Click on Save (save).
    → The referrer is active.

Change to new referrer required for plugin users

If you are already using the refurbed plugin and you want to change to the marketplace integration, it is required to use the new referrer.

5.7. Tracking returns

You can assign an IMEI number (International Mobile Equipment Identity) (for smartphones) or a serial number (for items in any other category) to each item. This number allows you to track shipped items and identify your returns. To do so, enter the IMEI number or the serial number in the item data record and allow the item to be scanned during picking. The IMEI number or serial number is then automatically assigned to the order.

Entering serial numbers:

  1. Go to Item » Items » [Open item].
    → The data record opens.

  2. At the top in the toolbar, click More (more_vert).
    → A drop-down list with further options appears.

  3. Click Item serial numbers (123).
    → The Item serial numbers window opens.

  4. Click Add an item serial number (add).
    → The input field for the serial number opens.

  5. Enter the IMEI or serial number under Serial number.
    Note: IMEI numbers must have 15 digits.

  6. Click NEXT.
    → A summary of the input is displayed.

  7. Click CREATE SERIAL NUMBER.
    → The IMEI or serial number is saved and you can track your return.

  8. Click CLOSE.

Enable your warehouse employee to scan the serial number of the item by activating the function in the item data record.

Making it possible to scan an item:

  1. Go to Item » Items » [Open item].
    → The data record opens.

  2. Select the setting Yes for the option Serial number in the Settings section.

  3. Save (save) the settings.

To track your return by serial number, go to Orders » Orders and search the order using the Serial number filter. If the serial number filter is not displayed, you can add it in the editing mode.

Note: Whenever a return from refurbed is imported in PlentyONE, the tracking URL of the returned item will be attached as an order note, too.

6. Automating order processing

Set up event procedures to automatically inform refurbed about changes to the order status. The following event procedures are available for refurbed:

  • Automatically inform refurbed that the order was confirmed. (How?)

  • Automatically inform refurbed that the items have been shipped. (How?)

  • Automatically inform refurbed that the order was cancelled. (How?)

  • Automatically upload invoices to refurbed. (How?)

  • Automatically inform refurbed that the order was rejected. (How?)

  • Automatically inform refurbed that the order was refunded. (How?)

6.1. Send order confirmation to refurbed

Set up an event procedure to automatically inform refurbed about the order confirmation.

Setting up an event procedure

  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 4.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 4.

  7. Select the setting Active ().

  8. Save () the settings.

Note: The selected statuses and filters in Table 4 only serve as an example. Select filters and statuses for the event procedure which best suit your workflow.

Table 4. Event procedure to send an order confirmation to refurbed
Setting Option Selection

Event

Order change: Status change

Select a status, for example [5] Cleared for shipping.

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

refurbed

Procedure

Plugins

refurbed: Send order confirmation to refurbed

6.2. Send shipping confirmation to refurbed

Set up an event procedure to automatically send shipping confirmations to refurbed.

Setting up an event procedure

  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 5.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 5.

  7. Select the setting Active ().

  8. Save () the settings.

Note: The selected statuses and filters in Table 5 only serve as an example. Select filters and statuses for the event procedure which best suit your workflow.

Table 5. Event procedure to send a shipping confirmation to refurbed
Setting Option Selection

Event

Order change: Status change

Select a status, for example [7] Outgoing items booked.

Filter 1

Order > Order type

Order and Delivery order

Filter 2

Order > Referrer

refurbed

Procedure

Plugins

refurbed: Send shipping confirmation to refurbed

6.3. Send order cancellation to refurbed

Set up an event procedure to automatically inform refurbed about the cancellation of an order.

Setting up an event procedure

  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 6.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 6.

  7. Select the setting Active ().

  8. Save () the settings.

Note: The selected statuses and filters in Table 6 only serve as an example. Select filters and statuses for the event procedure which best suit your workflow.

Table 6. Event procedure to send order cancellations to refurbed
Setting Option Selection

Event

Order change: Status change

Select an event, e.g. [8.1] Cancelled by customer.

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

refurbed

Procedure

Plugins

refurbed: Send order cancellation to refurbed

6.4. Send invoice to refurbed

Set up an event procedure to automatically upload invoices to refurbed.

Setting up an event procedure

  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 7.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 7.

  7. Select the setting Active ().

  8. Save () the settings.

Note: The selected statuses and filters in Table 7 only serve as an example. Select filters and statuses for the event procedure which best suit your workflow.

Table 7. Event procedure to send invoices to refurbed
Setting Option Selection

Event

Order change: Invoice generated

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

refurbed

Procedure

Plugins

refurbed: Send invoice to refurbed

6.5. Send order rejection to refurbed

Set up an event procedure to automatically inform refurbed about the rejection of an order.

Setting up an event procedure

  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 8.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 8.

  7. Select the setting Active ().

  8. Save () the settings.

Note: The selected statuses and filters in Table 8 only serve as an example. Select filters and statuses for the event procedure which best suit your workflow.

Table 8. Event procedure to send an order rejection to refurbed
Setting Option Selection

Event

Order change: Status change

Select an event, e.g. [8] Cancelled.

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

refurbed

Procedure

Plugins

refurbed: Send order rejection to refurbed

6.6. Send refund to refurbed

Set up an event procedure to automatically inform refurbed of a refund.
Note: A refund is not carried out automatically and should therefore always be used in combination with the order cancellation event procedure. In case you only want to refund part of an order, this needs to be done per order item.
Note: When the refund amount is sent to refurbed, a debit payment for the refund amount is added to the order in PlentyONE.

Setting up an event procedure

  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 9.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 9.

  7. Select the setting Active ().

  8. Save () the settings.

Note: The selected statuses and filters in Table 9 only serve as an example. Select filters and statuses for the event procedure which best suit your workflow.

Table 9. Event procedure to send a refund to refurbed
Setting Option Selection

Event

Order change: Status change

Select a status, e.g. [9.6] Return Accepted.

Filter 1

Order > Order type

Order / Return / Credit note

Filter 2

Order > Referrer

refurbed

Procedure

Plugins

refurbed: Send refund to refurbed

7. Viewing the data log

Error reports of the export are logged in the Data » Log menu. In order to view the data log and search for specific errors, proceed as follows.

Viewing the data log:

  1. Go to Data » Log.
    → The data log overview opens.

  2. At the top, click on Filter (tune).

  3. For the Identifier filter, select the option refurbed.
    Tip: For a more detailed search, you can additionally use the Integration filter in order to search for a specific path.

  4. Click Search (search).
    → The error reports are shown according to the filter settings.