Manage offer (create or edit with automatic status determination)

Create or edit offers with full field validation including custom data fields. Status is automatically determined based on validation results and account capabilities. Status field is prohibited in request - it will be set automatically.

Automatic status determination:

• Gold marketplace: Always set to Active if validation passes
• Account marketplace:
  • If data field validation fails → Need Details
  • If MULTIPLE credential system and no active credentials → Not Active
  • If all validations pass → On Review (for moderation)

Operation type (add/edit):

• Operation type is determined automatically by presence of ‘id’ field in offer object
• If ‘id’ is present → edit operation (only provided fields will be updated)
• If ‘id’ is missing → add operation (all required fields must be provided)

Edit existing offers or create new ones. Each offer is validated and processed separately. Results are returned as an array with status for each offer.

POST /api/shop/marketplace/offers/{productId}/manage

Error

A valid request URL is required to generate request examples

200

{
  "result": {
    "message": "ok",
    "received": 3,
    "successfully": 2,
    "results": [
      {
        "id": 335838,
        "status": "ok",
        "message": "Failed to process offer"
      }
    ]
  }
}

Authorizations

Authorization · string · header · required

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

Path Parameters

productId · integer · required

Product currency marketplace ID

Example:

13

Body

application/json

product_currency_offers · object[] · required

Array of offers to create or update. If an offer object contains 'id', it will be updated. If 'id' is missing, a new offer will be created.

Show child attributes

guarantee_delivery_time · string · required

Guaranteed delivery time (e.g., '1 hour', '24 hours', '3 days')

Maximum string length: 255

Example:

"1"

Response

200

application/json

Success

result · object

Show child attributes