Merchants
- Overview
- Plan Your Dropship Implementation
- Dropship Integrations
- Merchant Best Practices
- Integrations
- Orders
- Products
- Suppliers
- Reports
- Settings
- Support
Merchant API Endpoints
- Authentication in Dropship
- Carriers
- Compliance Reports
- Connection Invites
- Inventory
- Invoices
- Orders
- Products
- Proposals
- Returns
- Shipments
- Webhooks
Suppliers
- Overview
- Getting Started
- Integrations
- Orders
- Products
- Reports
- Settings
Proposals
Mark a proposal as complete
PUT
/
v1
/
retailers
/
{retailer_id}
/
proposals
/
{id}
/
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
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
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
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
.
Was this page helpful?
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"
}
Assistant
Responses are generated using AI and may contain mistakes.