Droppery

Droppery

This connector uses the Droppery webshop API (https://platform.droppery.io/api/v1/webshop) of Droppery, the European dropshipping platform that connects webshops with suppliers: the supplier products connected to your shop with prices, stock and delivery times, a product's shipping rates per country, and your dropshipping orders with payment status and, per supplier, the shipping status, carrier and track and trace. Read-only.

Setup (about 2 minutes)

1. Sign in to the Droppery platform (platform.droppery.io) with your webshop account.
2. Open API token in the menu, create a token and copy it right away (it is shown once). Paste it into DROPPERY_API_TOKEN; it is sent as a Bearer token.
3. Install and run droppery_browse_products.

Products: droppery_browse_products lists the products of your connected suppliers, size per page (at most 100, Droppery refuses more with 422) starting at row start (0 for the first page); total is the number of products. Each row is cut to the fields an agent needs: id, name, brand, supplier, SKU, EAN, stock, supplier purchase price excluding VAT and the suggested retail price including VAT (both also as discounted price), tax rate, delivery days, visibility and pause flags, categories, attributes and variants. Droppery cannot search or filter this list; page through it. droppery_get_product reads one product by its Droppery id with the full description, images, dimensions and shipping_rates per country.

Orders: droppery_get_order_details reads one order by its Droppery order id, the number Droppery shows in its order list (e.g. 102057). It is not the webshop or marketplace order number (order_id in the answer); with that number Droppery answers 404 No query results for model [App\Models\Core\Order]. The answer has the order date, payment status (e.g. paid), shipping address, order lines (product id, customer price, quantity and refunded quantity, purchase price) and order_suppliers: per supplier the status (e.g. in_progress, shipped), carrier code, track and trace code and tracking link. The API has no order list: take the id from the Droppery platform or from the system that placed the order.

Prices: supplier_price_excl is what Droppery charges you excluding VAT; retail_price_incl is the supplier's suggested consumer price including VAT. Dropshipping orders are placed by your webshop integration; this connector does not place orders or move money.

Errors: 401 Unauthenticated. means a missing or revoked token. 404 means the id does not exist for your shop. 422 lists the invalid parameters (e.g. size over 100).