Second Hand

This documentation aims to guide developers in implementing Second Hand functionality on a website.

In this documentation, you will find instructions on how to add Second Hand to your website, as well as code examples to help you get started.

SearchEngine

To perform a search exclusively on our second-hand catalog, you are required to explicitly add the DBS catalog number to your "searchEngine" query using the following syntax: "(AND DBS:00000)". This will limit the results of your search to second-hand items only.

Conversely, if you prefer to exclude our second-hand catalog from your search, you can do so using the following syntax: "(AND NOT DBS:00000)". This will exclude the search results related to second-hand items.

It is important to note that the DBS catalog number must be replaced by the corresponding number provided in our second-hand catalog.

Select

AddtoCart

The Web Service for adding an item to the shopping cart remains the same, except that a "secondHandFictif" field has been added. This field will take as value the EAN of Medialog. To find this EAN, there are two possibilities: either by using the following Web Service “infoSecondHand” with the "eanf" field, or by using the "dbpGroup" of the SearchEngine response.

Cart lines - Add Product

Update | Remove

make sure you have added the dbp parameter in the update and remove see this link

https://titelive.atlassian.net/wiki/spaces/MW/pages/3348660240/Cart+lines+-+Add+Product#Update-product

infoSecondHand

The Web Service provided at this URL allows you to check the real-time stock in the bookstore to verify the availability of a second-hand product. It is recommended to use it in verification of the SearchEngine search, as the data provided by the latter is only generated every 24 hours. By using this Web Service, you can ensure that stock information is accurate and up-to-date. An ordered item is removed when it is processed in the ERP (Medialog)

The Web Service uses the actual (new) EAN of the article in the "ean" field.

Example

https://wsmedia.tlsecure.com/api/json/00000/product/infoSecondHand?ean=9789076174112

Request

HTTP Verb : GET
URL : http://{WS_URL}/api/{returnType}/{domainCode}/product/infoSecondHand?ean=

The parameter {ean} can be separate by a coma to get many ean in the same WebService Example:https://wsmedia.tlsecure.com/api/json/0/product/infoSecondHand?ean=9789065391124,9789025752095,9789089982087

Parameters	Location	Type	Required
token	Header	String(26)	v
ean	Params	String(26)	v
image	QueryParams	Boolean
shop	QueryParams	Integer

Response

Variables	Description
ean	ISBN-13
stock	Stock physique in the shop
available	(Stock physique in the shop) substract (Stock in order or reserved)
order	quantity order to provider
known	If the product is known in MediaLog
price	Price in MediaLog
headGroup	The first level for the ranking
group	The second level for the ranking
category	The third level for the ranking
message	Fields that describe the state for example
rating	Assessment of the state in the form of a rating
eanf	Ean create in medialog

Success

{
    "response": {
        "success": true,
        "code": 0,
        "message": "product retrieved",
        "object": {
            "shops": {
                "shop": [
                    {
                        "id": 16,
                        "name": "TiteLive Benelux",
                        "addressLine1": "Rue terre ├á briques 6",
                        "postcode": "7500",
                        "city": "Tournai",
                        "country": 1,
                        "phone": "015 45 16 12",
                        "email": "mediaweb@titelive.be",
                        "defaultShop": true,
                        "product": [
                            {
                                "ean": 9789076174112,
                                "origin": "MEDIALOG",
                                "known": 1,
                                "price": 10.0,
                                "headGroup": "2DEHANDS BOEKEN",
                                "group": "2DEHANDS BOEKEN",
                                "category": "91",
                                "message": "",
                                "rating": 3,
                                "eanf": 2100000003860
                            },
                            {
                                "ean": 9789076174112,
                                "origin": "MEDIALOG",
                                "stock": 1,
                                "available": 1,
                                "known": 1,
                                "price": 20.0,
                                "headGroup": "2DEHANDS BOEKEN",
                                "group": "2DEHANDS BOEKEN",
                                "category": "91",
                                "message": "goeie staat",
                                "rating": 5,
                                "eanf": 2100000010615
                            }
                        ]
                    }
                ]
            }
        }
    }
}

Codelist

Code	Success	Message
0	v	order has ben set to status X
1		domaincode malformed
2		connexion error
3		token empty
4		no token with that key
5		invalid token
9		{param} not {type} {(or undefined)}
10		ean not exist
11		configuration to mediaLog not exist
99		uncatched exception