LIVE-API - HowTo

1. Security - Protect your Live-API from unauthorized access

Please always keep your API key secret. With this key all your offers can be changed or deleted. You can always generate a new API key or block access to the API.

2. Login to the SELLER API

With your API key you can identify yourself at our interface. For all calls you make, you must submit your API key. All information you transmit or receive is encrypted using SSL.

The API is usually returned via XML. You transfer information to the API using different parameters.

In PHP, a login AND adding a new offer look as follows:

$api_key = "125418pc6c238c153be417e3c84a288af76e994e6ad1033";

$ean = "4012020068522";
$price = "3999";
$price_cs = "39,90";
$comment = "Das hier ist mein Verkäuferkommentar";
$offer_id = "Harry Lager 12";
$condition = "200";
$count = 3;
$delivery_time = "c";

$request = 'ident='.$api_key.'&'ean='.$ean.'&condition='.$condition.'&price='.$price.'&delivery_time='.$delivery_time.'&price_cs='.$price_cs.'&count='.$count.'&comment='.urlencode($comment).'&offer_id='.urlencode($offer_id);
$sXMLResponse = file_get_contents('https://www.jeedoo.com/seller-api/insert?'.$request);

3. Add, change and delete offers

To edit offers, the Seller API responds to 2 commands.

"INSERT" - This instruction allows you to re-create an offer or modify an existing proposal.

"DELETE" - Use this statement to delete an offer

Example:

http://www.jeedoo.com/seller-api/insert?$parameter...
http://www.jeedoo.com/seller-api/delete?$parameter...

4. Submit offer information

4.1 General information on the API
In order for the API to accurately allocate your offer, it is necessary to know which item you want to offer for sale and in what condition.

The article is identified by the EAN number / UPC code.

4.1.1 Condition of your offered goods
You can hire new and used items for sale. You can create offers (used and new) under an article.

4.1.2 Transmission of data
The transmission of your offer information must encoded in UTF-8 format as well as in the case of text fields url_encoded.

4.2 In the case of a change or a new creation of an offer
Changing or recreating offers is done with the same call: "INSERT". In doing so, a possibly already existing data record is overwritten completely or otherwise newly created.

5. Add a new offer, change an offer

The following parameters are required to create a new proposal.

parameter	required entry	description
ean	yes	UPC CODE
ident	yes	your API-key
condition	yes	The condition of your item. The value "100" must be set for a new product. For used goods "200", "300", "400" or "500".
price_cs	yes	Your selling price excl. shipping costs. Please use the format 12.95
delivery_time	yes	Your indication of the delivery period. The following values are allowed: A> stock, immediate delivery B and c> Delivery within 7 days D and e> Delivery within 14 days F> Delivery within 21 days
comment	not	Your seller-comment on the article.
offer_id	not	Can be your warehouse number or your item number. This field is used with us as SKU or warehouse number.
count	not	The number of available items. If this field is empty, number 1 is automatically accepted.
price	not	The selling price excl. shipping costs in cent. So at 10,95 EUR would be the correct value here: 1095 - If you do not set the mandatory price_cs, you must have set price.

6. Deleting an offer

Deleting an offer basically works like adding. The difference is that you only need to pass the EAN number and pass the DELETE command to your API call instead of the INSERT command.

If you have an UPC used for an used product as well as new, and you also pass your offer_id, only the entry with the offer_id will be deleted. 

7. Get your orders

You can use the API to collect orders, which are approved by us and that have to send out.

The call is as follows:

https://www.jeedoo.com/seller-api/sales_export?time_from=2013-11-01&time_to=2013-11-02&ident=API-KEY

You will receive your orders in the self-explanatory CSV format.

8. Please report the shipment of the goods

Call the Seller API with the command: mark_unit_sent.

Give us "id_unit" and "order_number". The respective articles of this order are then marked as shipped. Contact us, if you want an automatic positive evaluation of your customer. We will gladly arrange this for you.

Optionally you can send us the shipping service provider as well as a shipment number. Please submit:

"Identcode" -> transmission number
"Carrier" -> shipping company.

"Carrier" must be handed over as an integer. See the following list:

Shipping Company
DHL -> 1
Post AG -> 2
GLS -> 3
DPD -> 4
UPS -> 5
FedEx -> 6
Hermes -> 7
E-mail -> 99
Other -> 100