Veepee Pink Connect

Veepee Pink Connect

This connector uses Pink Connect (https://api.pink-connect.com/v4), the seller API of the Veepee group marketplaces (Veepee and Privalia, e.g. Veepee Italy and Privalia Italy): orders with lines, shipping and billing data, delivery details and refunds, your offers per sales channel, customer messages (notifications), return requests and the carrier list. Replying to customers, writing to them about an order and moving return requests are included but installed switched off.

Setup

1. Get the API token of your Pink Connect seller account from Veepee (shown in the Pink Connect portal at www.pink-connect.com, or sent by your Veepee marketplace contact).
2. Paste it into PINK_CONNECT_TOKEN; it is sent as a Bearer token.
3. Install and run pink_connect_list_carriers.

Sales channels: each marketplace country site is a shop channel with a numeric id (shopChannelId, e.g. one for Veepee Italy and one for Privalia Italy). Every order carries shopChannelId and shopChannelName; read them from pink_connect_list_orders first. pink_connect_list_offers needs a channel id.

Orders: pink_connect_list_orders returns the oldest orders first, so for recent ones always set updated_from (orders changed since then, e.g. 2026-10-01T00:00:00), optionally updated_to. Filter one channel with shop_channel_id, or find one order by the marketplace's order number with marketplace_code and marketplace_order_code together. limit is at most 100 (default 20); page with offset. An order is about 2 KB, so keep pages small. Each order has status (e.g. SHIPPED, CANCELLED), orderLines with GTIN, SKU, price, tax rate, quantity and a status count per line (e.g. {"Shipped": 1}), shippingInformation and billingInformation, deliveryDetails (carrier, tracking number and URL, shipping date), refunds and requestedShippingMethod. pink_connect_get_order reads one order by its Pink Connect orderId (not the marketplace order number).

Offers: pink_connect_list_offers lists your listings on one channel: GTIN, SKU, name, brand, selling and recommended price, discount and its dates, stock, price list and marketplaceStatus (in Spanish, e.g. "Producto Publicado"), 50 per page by default.

Customer messages: pink_connect_list_notifications lists messages between customers and you (from CUSTOMER or SELLER, status READ or UNREAD) with subject, text, dates and attachments; filter by order_id or by update date. Without a filter Pink Connect scans the whole history and can take half a minute, so pass a date or an order. pink_connect_get_notification reads one message. pink_connect_reply_notification answers an existing message and pink_connect_create_order_message starts a new conversation on an order (use it only when there is none yet). Write in the customer's language.

Returns: pink_connect_list_return_requests lists return requests with order and line, GTIN, SKU, quantity, reason (e.g. PRODUCT_DAMAGED, SIZE_DONT_FIT, INCORRECT_PRODUCT), type (e.g. HOMEPICKUP), request date and status: PENDING, PROCESSING, REJECTED, COMPLETE or CANCELLED. pink_connect_update_return_request moves one: PENDING to PROCESSING (accepted) or REJECTED, PROCESSING to COMPLETE (goods received). It does not refund; refunds are handled outside this connector.

Writes: switched off. pink_connect_reply_notification, pink_connect_create_order_message and pink_connect_update_return_request reach real customers and are installed switched off; an admin turns them on deliberately. Before each call show the user the order, the message text or the return and its new status, and wait for a yes.

Errors: 401 means a wrong or expired token. 400 Invalid page size (max 100) means a limit above 100. 422 messages are in Spanish (e.g. "Canal de Venta no puede estar vacío": the channel id is missing). A wrong path or unknown id answers an HTML 404 page.