missing api functions - very urgend !!!

[klaus.schneider]

Hello other API users, please give me feedback... is this only my problem or need this functions every others.

If a seller sold thousends of items every month is it not reasonalbe to do all this steps manually over the webinterface !!!

1) Missing functions to manage items:

setItemAsConfirmed(token, id_item)

this function will be need to confirm a orderd item as available.

Effekt: customer see this item with a "confirmed sign"

Normaly all listed items are available, but in a few cases item is sold otherwise or item is damaged and so on...

setItemAsPaid(token, id_item)

this function will be need to sign a ordered item with paied symbol (seller has received the payment)

setItemAsShipped(token, id_item, shipment_info)

this function will be need to sign a ordered item with shipped symbol (seller has shipped the item)

Parameter "ship-info" is the pace to give the buyer the shipment information (shipment details, date, shipment number, carrier)

alternative you can give the function seperate parameters for:

shipment_date

shipment_number

shipment_carrier

shipment_comment

archiveItem(token, id_item)

this function will be need to archive closed items

getMyarchivedFixedPriceItems(token, startingItem, numberOfItems)

this function will be need to get the archived fixed price items.

getMyarchivedAuctionItems(token, startingItem, numberOfItems)

this function will be need to get the archived auction items.

deleteArchivedItemFinaly(token, id_item)

this function will be need to delete archived items finaly.

deleteArchivedItemFinaly(token, id_item)

this function will be need to delete archived items finaly.

cancelSaleOfSoldItemFinaly(token, id_item, ratingValue, comment)

this function will be need to cancel a sold item (expl. not paid) and give feedback.

　

2) Missing functions to manage the order process:

a new notificaten type is needed (Curl_Buyer_Request_Invoice)

this notification signals the seller, a buyer will get his invoice

getMyUninvoicedBuyers(token)

this function will be need to get a list of buyer nicknames and buyerIDs with available uninvoiced items.

getMyUninvoicedItemsFromBuyer(token, buyer_nickname, buyer_id)

this function will be need to get a list if uninvoiced itemIDs (only the IDs !!!) from the spezified buyer (alternate search by buyer_id or buyer_nickname - one of both is obligated)

createInvoice(token, buyer_nickname or buyer_id, item_Id_List, shipment_cost, payment_cost, other_cost, invoice_comment)

this function create a invoice for the specified buyer with the given item IDs and sets the spcified parameters.

this function is available for all items there are not marked for paid from the buyer.

so the seller can overwrite the actuell invoice if the buyer buys another items after create the first invoice.

if the buyer marked this invoice as paid overwriten is no more possible.

to get the as paid from buyer marked items, the function

getMyMarkedAsPaidItemsFromBuyer(token, buyer_nickname, buyer_id)

is needed. this allows the seller workflow to know the payment from this items is on the way.

[klaus.schneider]

UPDATE to MISSING functions:

 

a new notificaten type is needed (Curl_Buyer_Marked_Invoice_As_Paid)

this notification signals the seller, a buyer has start the payment of an invoice.

3) Missing functions for notifications:

changeNotificationSetting(token, id_notification, notificationType, destination)

is needed to change a deaktivated notification.... the problem with the actuell handling is the old/deaktivated settings are always received with getNotificationSettings.

Sometimes you have a lot of old settings and this confused and creates a problem with buffer overflow !

Alternative you can provide a function to delete settings

deleteNotificationSetting(token, id_notification)

or optional a 2nd parameter for getNotificationSettings to select only the active Settings.

[SammlerKalle]

Oh yes. Especially something like 'createInvoice' I'm missing very much. To do this on the 'normal' website ist very uncomfortable (too much clicks, wrong/old items in the list, no shipping-cost automatically). With an Api-Function there is no extra-work for a seller with sending the invoices.

[Sébastien Verspecht]

Completely agree.

More, for each function like setXXX(), it could be useful to have an associated function to read actual value.

Like this, a buyer could set an item as shipped trough web interface and read it after trough API (especially useful for retrocompatibily).

[Sébastien Verspecht]

@Delcampe:

Can we expect some changes and new functions soon?

It's very frustating to have to encode twice same infos for little things.

By example, if I want to use setFeedback function, I have to be sure that buyer has already paid for his item.

And as I can't get this info encoded trough website (and can't use an API function to do that), I've to encode it onDelcampe's website and on my admin panel to be able to let automatic's feedbacks...

[Quentin Terwinghe]

Dear Sébastien Verspecht,

Your request has been considered by the Delcampe Technical Team. Unfortunately, in the short term, we can not act on it. Your request will be analyzed in the coming months and a solution will be find.

We stay at your disposal for any further information.

Kind regards.

Quentin from Delcampe Technical Team

[DisplayName]

Dear Quentin from Delcampe Technical Team,

setting the shipping status by API, just create it like setBuyerRating (item/1234/buyer/rating).

syntax : item/:id/buyer/shipping?token=:TOKEN

mandatory data array:

$postData = array(
   'timeStamp' => '2016-01-15T15:52:01+00:00'
);

Same with mark as paid.

All sellers will thank you to save a lot of time, and all buyers will thank as well, they will have the shipping status in their account, and so they have a better experience on delcampe.

[Jan Bludau]

that is a very good list of the next level delcampe API! :-)

we need this stuff especially OrderManagement