Offers
Sync Offer by Offer ID
Overview
Login
- Access
Merchants
- Merchant
- Configuration
- Onboarding
- Explore
Catalog
- Offers
- SKUs
- Categories
- Collections
- Currencies
Orders & Checkout
- Carts
- Cart Items
- Cart Customer
- Cart Discounts
- Cart Shipping
- Cart Pricing
- Cart Payment
- Cart Completion
- Orders
- Order Refunds
- Order Cancellations
- Transfers
Payments
- Payout Accounts
- Distributions
- Transfers
Events
- Webhooks
- Webhook Events
- Webhook Headers
Apps
- Merchant/App Installs
- Commission Rates
Operations
- Connection
Relay
- Shipping
Ecom Syncs
- Offers
Offers
Sync Offer by Offer ID
POST
/
sync
/
offers
/
{offer_id}
curl --request POST \
--url https://sandbox-api.violet.io/v1/sync/offers/{offer_id}
{
"id": 123,
"product_id": "<string>",
"external_id": "<string>",
"external_url": "<string>",
"name": "<string>",
"description": "<string>",
"source": "OTHER",
"seller": "Foot Locker",
"vendor": "Nike",
"merchant_id": 123,
"available": true,
"visible": true,
"min_price": 123,
"max_price": 123,
"currency": "<string>",
"external_currency": "<string>",
"source_category_name": "<string>",
"metadata": [
{
"version": 123,
"type": "STRING",
"external_type": "<string>",
"key": "<string>",
"value": {},
"external_id": "<string>",
"source": "INTERNAL"
}
],
"variants": [
{
"id": 123,
"product_variant_id": "<string>",
"external_id": "<string>",
"name": "<string>",
"visual": true,
"values": [
{
"id": 123,
"product_variant_value_id": "<string>",
"external_id": "<string>",
"name": "<string>",
"sku_ids": [
123
],
"display_order": 123
}
],
"display_order": 123
}
],
"skus": [
{
"id": 123,
"offer_id": 123,
"merchant_id": 123,
"external_id": "<string>",
"name": "<string>",
"asin": "<string>",
"gtin": "<string>",
"upc": "<string>",
"ean": "<string>",
"isbn": "<string>",
"in_stock": true,
"qty_available": 123,
"inventory_tracked": true,
"sale_price": 123,
"retail_price": 123,
"currency": "<string>",
"external_currency": "<string>",
"presented_currency": "<string>",
"taxable": true,
"tax_type": "DEFAULT",
"albums": [
{
"id": 123,
"parent_id": 123,
"type": "OFFER",
"name": "<string>",
"media": [
{
"id": 123,
"album_id": 123,
"external_id": "<string>",
"cloud_id": "<string>",
"url": "<string>",
"source_url": "<string>",
"type": "IMAGE",
"display_order": 123,
"alt_text": "<string>",
"primary": true
}
],
"primary_media": {
"id": 123,
"album_id": 123,
"external_id": "<string>",
"cloud_id": "<string>",
"url": "<string>",
"source_url": "<string>",
"type": "IMAGE",
"display_order": 123,
"alt_text": "<string>",
"primary": true
}
}
],
"variant_values": [
{
"variant": "<string>",
"value": "<string>"
}
],
"type": "PHYSICAL",
"status": "UNAVAILABLE",
"date_created": "2023-11-07T05:31:56Z",
"date_last_modified": "2023-11-07T05:31:56Z",
"sku_dimensions": {
"sku_id": 123,
"weight": 123,
"height": 123,
"width": 123,
"length": 123,
"type": "SKU"
},
"shipping_dimensions": {
"sku_id": 123,
"weight": 123,
"height": 123,
"width": 123,
"length": 123,
"type": "SKU"
},
"metadata": [
{
"version": 123,
"type": "STRING",
"external_type": "<string>",
"key": "<string>",
"value": {},
"external_id": "<string>",
"source": "INTERNAL"
}
],
"display_order": 123
}
],
"albums": [
{
"id": 123,
"parent_id": 123,
"type": "OFFER",
"name": "<string>",
"media": [
{
"id": 123,
"album_id": 123,
"external_id": "<string>",
"cloud_id": "<string>",
"url": "<string>",
"source_url": "<string>",
"type": "IMAGE",
"display_order": 123,
"alt_text": "<string>",
"primary": true
}
],
"primary_media": {
"id": 123,
"album_id": 123,
"external_id": "<string>",
"cloud_id": "<string>",
"url": "<string>",
"source_url": "<string>",
"type": "IMAGE",
"display_order": 123,
"alt_text": "<string>",
"primary": true
}
}
],
"type": "PHYSICAL",
"status": "UNAVAILABLE",
"publishing_status": "NOT_PUBLISHED",
"date_created": "2023-11-07T05:31:56Z",
"date_last_modified": "2023-11-07T05:31:56Z",
"date_last_consolidated": "2023-11-07T05:31:56Z",
"three_d_enabled": false,
"three_d_resource": "<string>",
"commission_rate": 123,
"currency_symbol": "<string>",
"presented_currency": "<string>",
"default_image_url": "<string>",
"subscription_status": "NOT_SUBSCRIBED",
"external_data": {},
"collections": [
{
"id": 123,
"external_id": "<string>",
"merchant_id": 123,
"parent_id": 123,
"name": "<string>",
"handle": "<string>",
"description": "<string>",
"status": "INACTIVE",
"type": "CUSTOM",
"media": {
"source_url": "<string>",
"alt": "<string>",
"height": 123,
"width": 123,
"date_created": "2023-11-07T05:31:56Z"
},
"date_created": "2023-11-07T05:31:56Z",
"date_last_modified": "2023-11-07T05:31:56Z"
}
],
"shipping": {
"message": "<string>",
"methods": [
{
"external_id": "<string>",
"name": "<string>",
"price": {
"amount": 123,
"currency": "USD"
},
"regions": {
"countries": [
"US"
]
},
"conditions": [
{
"price": {
"amount": 123,
"currency": "USD"
},
"weight": {
"value": 123,
"unit": "INCHES"
},
"type": "TOTAL_PRICE",
"operator": "LESS_THAN_OR_EQUAL_TO"
}
]
}
]
},
"tags": [
"<string>"
]
}
Resync an existing Offer in the Violet system using the offer_id
.
If a merchant is configured to sync shipping data this will also refresh the shipping data on the Offer.
This endpoint should not be used programatically. It performs calls to the external commerce platform and consumes rate limits. Abuse of this endpoint can result in the failure of other interactions with the merchants system.
Path Parameters
The ID of an Offer in the Violet system.
Response
200
application/json
successful operation
Product Offer
Was this page helpful?
curl --request POST \
--url https://sandbox-api.violet.io/v1/sync/offers/{offer_id}
{
"id": 123,
"product_id": "<string>",
"external_id": "<string>",
"external_url": "<string>",
"name": "<string>",
"description": "<string>",
"source": "OTHER",
"seller": "Foot Locker",
"vendor": "Nike",
"merchant_id": 123,
"available": true,
"visible": true,
"min_price": 123,
"max_price": 123,
"currency": "<string>",
"external_currency": "<string>",
"source_category_name": "<string>",
"metadata": [
{
"version": 123,
"type": "STRING",
"external_type": "<string>",
"key": "<string>",
"value": {},
"external_id": "<string>",
"source": "INTERNAL"
}
],
"variants": [
{
"id": 123,
"product_variant_id": "<string>",
"external_id": "<string>",
"name": "<string>",
"visual": true,
"values": [
{
"id": 123,
"product_variant_value_id": "<string>",
"external_id": "<string>",
"name": "<string>",
"sku_ids": [
123
],
"display_order": 123
}
],
"display_order": 123
}
],
"skus": [
{
"id": 123,
"offer_id": 123,
"merchant_id": 123,
"external_id": "<string>",
"name": "<string>",
"asin": "<string>",
"gtin": "<string>",
"upc": "<string>",
"ean": "<string>",
"isbn": "<string>",
"in_stock": true,
"qty_available": 123,
"inventory_tracked": true,
"sale_price": 123,
"retail_price": 123,
"currency": "<string>",
"external_currency": "<string>",
"presented_currency": "<string>",
"taxable": true,
"tax_type": "DEFAULT",
"albums": [
{
"id": 123,
"parent_id": 123,
"type": "OFFER",
"name": "<string>",
"media": [
{
"id": 123,
"album_id": 123,
"external_id": "<string>",
"cloud_id": "<string>",
"url": "<string>",
"source_url": "<string>",
"type": "IMAGE",
"display_order": 123,
"alt_text": "<string>",
"primary": true
}
],
"primary_media": {
"id": 123,
"album_id": 123,
"external_id": "<string>",
"cloud_id": "<string>",
"url": "<string>",
"source_url": "<string>",
"type": "IMAGE",
"display_order": 123,
"alt_text": "<string>",
"primary": true
}
}
],
"variant_values": [
{
"variant": "<string>",
"value": "<string>"
}
],
"type": "PHYSICAL",
"status": "UNAVAILABLE",
"date_created": "2023-11-07T05:31:56Z",
"date_last_modified": "2023-11-07T05:31:56Z",
"sku_dimensions": {
"sku_id": 123,
"weight": 123,
"height": 123,
"width": 123,
"length": 123,
"type": "SKU"
},
"shipping_dimensions": {
"sku_id": 123,
"weight": 123,
"height": 123,
"width": 123,
"length": 123,
"type": "SKU"
},
"metadata": [
{
"version": 123,
"type": "STRING",
"external_type": "<string>",
"key": "<string>",
"value": {},
"external_id": "<string>",
"source": "INTERNAL"
}
],
"display_order": 123
}
],
"albums": [
{
"id": 123,
"parent_id": 123,
"type": "OFFER",
"name": "<string>",
"media": [
{
"id": 123,
"album_id": 123,
"external_id": "<string>",
"cloud_id": "<string>",
"url": "<string>",
"source_url": "<string>",
"type": "IMAGE",
"display_order": 123,
"alt_text": "<string>",
"primary": true
}
],
"primary_media": {
"id": 123,
"album_id": 123,
"external_id": "<string>",
"cloud_id": "<string>",
"url": "<string>",
"source_url": "<string>",
"type": "IMAGE",
"display_order": 123,
"alt_text": "<string>",
"primary": true
}
}
],
"type": "PHYSICAL",
"status": "UNAVAILABLE",
"publishing_status": "NOT_PUBLISHED",
"date_created": "2023-11-07T05:31:56Z",
"date_last_modified": "2023-11-07T05:31:56Z",
"date_last_consolidated": "2023-11-07T05:31:56Z",
"three_d_enabled": false,
"three_d_resource": "<string>",
"commission_rate": 123,
"currency_symbol": "<string>",
"presented_currency": "<string>",
"default_image_url": "<string>",
"subscription_status": "NOT_SUBSCRIBED",
"external_data": {},
"collections": [
{
"id": 123,
"external_id": "<string>",
"merchant_id": 123,
"parent_id": 123,
"name": "<string>",
"handle": "<string>",
"description": "<string>",
"status": "INACTIVE",
"type": "CUSTOM",
"media": {
"source_url": "<string>",
"alt": "<string>",
"height": 123,
"width": 123,
"date_created": "2023-11-07T05:31:56Z"
},
"date_created": "2023-11-07T05:31:56Z",
"date_last_modified": "2023-11-07T05:31:56Z"
}
],
"shipping": {
"message": "<string>",
"methods": [
{
"external_id": "<string>",
"name": "<string>",
"price": {
"amount": 123,
"currency": "USD"
},
"regions": {
"countries": [
"US"
]
},
"conditions": [
{
"price": {
"amount": 123,
"currency": "USD"
},
"weight": {
"value": 123,
"unit": "INCHES"
},
"type": "TOTAL_PRICE",
"operator": "LESS_THAN_OR_EQUAL_TO"
}
]
}
]
},
"tags": [
"<string>"
]
}