ManoMano

ManoMano Seller API

This connector uses the ManoMano Partners API (https://partnersapi.manomano.com), the REST API for sellers on ManoMano (manomano.fr, .es, .it, .de and .co.uk): orders with acceptance, shipment and refunds, offer prices and stock, competitiveness, catalog lookups by EAN, ManoFulfillment stock and customer invoices.

Setup (about 5 minutes)

1. Sign in to the ManoMano Toolbox (https://toolbox.manomano.com) with a user that has the Admin role.
2. Open Settings > API keys, click Create API key, give it a name such as AnythingMCP and click Generate API key. Copy it at once: it is shown only once. Paste it into MANOMANO_API_KEY.
3. Put your seller contract id into MANOMANO_SELLER_CONTRACT_ID. It is a number shown in the Toolbox. ManoMano creates one contract per platform (country) and delivery mode, so a seller on several platforms has several contracts: one install covers one contract. Install the connector once per contract and name each install after it (for example ManoMano FR).
4. Install and run manomano_list_orders.

The key is sent in the x-api-key header and the connector identifies itself with x-thirdparty-name: AnythingMCP. The seller contract id is added to every call.

Order workflow: a new order is PENDING. manomano_accept_order moves it to PREPARATION; manomano_refuse_order declines it (REFUNDING, then REFUSED). Ship with manomano_ship_order (carrier, tracking number and URL, and the products in the parcel; once per parcel); the order becomes SHIPPED. manomano_refund_order refunds some or all products (REFUNDING, then REFUNDED). For the daily to-do list use manomano_list_orders with status=PENDING and status=PREPARATION. Read the order with manomano_get_order first: shipping and refunds need each product's seller_sku and quantity.

Writes: confirm first. manomano_accept_order, manomano_refuse_order, manomano_ship_order, manomano_refund_order, manomano_update_offers, manomano_unfreeze_offers, manomano_upsert_offers and manomano_upload_order_document act on the live marketplace. Before each call show the user what will change (order, products and quantities, tracking number, SKUs with old and new price or stock, the document) and wait for a yes. Refusals and refunds cannot be undone.

Prices and stock: manomano_update_offers changes the price, the stock or both of existing SKUs. By default the values are frozen: later product feed imports no longer overwrite them, until manomano_unfreeze_offers hands them back to the feed (or the update is sent with frozen_price / frozen_stock false). The update is applied asynchronously; check it with manomano_list_offers and the returned request_id (status IN PROGRESS, ERROR with the errors, or COMPLETED). manomano_upsert_offers creates or fully replaces offers and is installed switched off.

Competition: manomano_get_offer_competitiveness compares given SKUs with the best offer; manomano_list_competitiveness_changes lists what changed in a date range.

Invoices: manomano_list_invoice_requests lists the invoices customers asked for (3 working days after shipment to answer); manomano_upload_order_document uploads the PDF from a URL; manomano_get_order_documents lists what is already there.

Limits: the orders API allows about 250 requests an hour per API key and the offers API about 200 an hour; both answer 429 beyond that. Orders page at most 50 at a time. ManoMano's sandbox (partnersapi.sandbox.manomano.com) is not used by this connector.