BricoBravo

BricoBravo

This connector uses the BricoBravo Seller Hub API (https://sellerhub.bricobravo.com/api), the API for sellers on BricoBravo, the Italian DIY, home and garden marketplace: orders with items, totals, customer and shipping address, and the shipping confirmation with courier and tracking. BricoBravo runs its own seller hub, not Mirakl. Confirming shipment is included but installed switched off.

Setup

1. Get the API token of your shop from BricoBravo (in the Seller Hub at sellerhub.bricobravo.com, or from BricoBravo seller support).
2. Paste it into BRICOBRAVO_API_TOKEN. It is sent in the sh-token header (not as Bearer).
3. Install and run bricobravo_search_orders.

Orders: bricobravo_search_orders lists orders with id_order (the Seller Hub order id), vtex_id_order (the marketplace order number, e.g. 1234460505385-01), status, total, creation_date (YYYY-MM-DD HH:MM:SS, Italian time), acquired, items (EAN, product code, name, price, list price, quantity), invoice_info and shipping_info (customer and receiver name, e-mail, phone, street, number, postcode, city, province, country). Status: 0 paid (to ship), 1 completed, 2 to be refunded, 3 refunded.

• Keep all true (the default): otherwise BricoBravo only lists orders not yet acquired by an order management system, so orders your other tools already imported would be missing.
• Filter by creation time with start_datetime and end_datetime in the compact form YYYYMMDDHHMMSS (e.g. 20261001000000).
• The answer is data (the orders) and pagination with total_data (orders matching) and pages. Pages hold per_page orders (default 100); page with page from 1.

bricobravo_get_order_details reads one order by its id_order number and returns it in data. An unknown id, or the marketplace number (vtex_id_order) instead of id_order, still answers HTTP 200 but with an errors list and no data: check for it.

Shipping (switched off): bricobravo_mark_shipped confirms the shipment of an order with the courier, tracking number and tracking URL; called again on a shipped order it replaces the tracking data (e.g. after a second dispatch). Courier codes: dhl, gls-italy, italy-sda, tnt-it, brt-it, ups, fedex, poste-italiane, dpd, liccardi-express, kuehne-nagel, fercam, dachser, raben-group, dbschenker-se, other. For a split shipment separate several tracking numbers and URLs with commas. If an order management system already confirms your shipments, use this only for corrections. It acts on a real customer order and is installed switched off: show the user the order, courier and tracking and wait for a yes. Read the order again with bricobravo_get_order_details afterwards.

Errors: 401 token NOT valid means a wrong or revoked token. A wrong path answers 404 The route ... could not be found.