PUT
/
v1
/
retailers
/
{retailer_id}
/
proposals
/
{id}
/
complete
/
Mark a proposal as complete
curl --request PUT \
  --url https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/proposals/{id}/complete/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Eco-Friendly Tumbler Set",
  "status": "draft",
  "source": "console",
  "proposal_type": "new_product",
  "return_reason_detail": "Incorrect pricing on listed item.",
  "push_to_shopify": true,
  "end_at": "2025-06-30T23:59:59Z",
  "item_skipped_count": 3,
  "has_price_changes": false,
  "target_live_date": "2025-07-01T00:00:00Z",
  "start_at": "2025-05-01T00:00:00Z",
  "expires_at": "2025-07-31T23:59:59Z",
  "draft_proposed_at": "2025-04-20T12:00:00Z",
  "acknowledged_at": "2025-04-22T09:00:00Z",
  "proposed_at": "2025-04-23T10:00:00Z",
  "archived_at": "2025-08-01T10:00:00Z",
  "revised_at": "2025-04-25T15:00:00Z",
  "approved_at": "2025-05-01T10:00:00Z",
  "declined_at": "2025-05-02T12:00:00Z",
  "pricing_approved_at": "2025-05-03T14:00:00Z",
  "completed_at": "2025-05-05T16:00:00Z",
  "withdrawn_at": "2025-05-06T09:30:00Z",
  "withdraw_reason": "Vendor no longer supports product line."
}'
{
  "id": 101,
  "name": "Winter 2025 Collection Update",
  "status": "proposed",
  "source": "console",
  "proposal_type": "new_product",
  "recipient": "retailer_456",
  "sender": "supplier_123",
  "memos": "Initial draft submitted by merchandising team.",
  "created_by": "user_789",
  "connection": "integration_abc",
  "retailer": "Fashion Retail Co.",
  "brand": "FrostWear",
  "department": "Apparel",
  "return_reason": "Insufficient pricing justification",
  "return_reason_detail": "Missing supplier cost comparison documentation.",
  "products": "[{ product_id: 202, name: 'Arctic Parka' }]",
  "push_to_shopify": true,
  "shopify_template": "default_fashion_template",
  "export_platform_template": "standard_export_v1",
  "attachments": "[{ filename: 'lookbook.pdf' }]",
  "end_at": "2025-09-30T23:59:59Z",
  "issues_summary": "Missing product images for 3 items",
  "is_acknowledged": false,
  "item_approved_count": 5,
  "item_deleted_count": 0,
  "item_rejected_count": 1,
  "item_skipped_count": 2,
  "item_count": "10",
  "item_classified_count": "8",
  "item_ready_count": "6",
  "item_failed_count": "1",
  "action_required": "Upload missing product photos",
  "has_action": "yes",
  "has_revision": "true",
  "has_unresolved_issues": true,
  "has_price_changes": true,
  "collaborators": "user_789, user_321",
  "target_live_date": "2025-10-01T00:00:00Z",
  "start_at": "2025-04-01T00:00:00Z",
  "expires_at": "2025-06-01T00:00:00Z",
  "updated_at": "2025-04-22T15:30:00Z",
  "created_at": "2025-04-20T08:45:00Z",
  "draft_proposed_at": "2025-04-10T12:00:00Z",
  "acknowledged_at": "2025-04-15T09:30:00Z",
  "proposed_at": "2025-04-20T10:00:00Z",
  "archived_at": "2025-04-22T17:00:00Z",
  "revised_at": "2025-04-21T14:15:00Z",
  "approved_at": "2025-04-25T11:00:00Z",
  "declined_at": "2025-04-26T10:30:00Z",
  "pricing_approved_at": "2025-04-24T13:45:00Z",
  "completed_at": "2025-04-28T16:00:00Z",
  "withdrawn_at": "2025-04-27T08:00:00Z",
  "withdraw_reason": "The product line was discontinued by the supplier.",
  "tags": "seasonal,featured,high-priority"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
retailer_id
integer
required

The unique retailer ID. In the Dropship UI this is called the Merchant ID. To find your Merchant ID, click your merchant name in the top nav.

Example:

1001

​
id
integer
required

The unique identifier of the proposal. This ID is automatically generated when a proposal is created.

Body

application/json

Response

200 - application/json

Proposal details

The response is of type object.