--- updatedAt: 2026-04-17T03:23:37.000Z agentTools: projectIndex: https://api-docs.shippedsuite.com/llms.txt --- # /v1/bigcommerce/product_offers Calculates Return Protection and Warranty fees for a given product # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Shipped Suite API", "description": "API provides access to Shipped Suite functions", "contact": { "name": "Steven Ou", "email": "steven@invisiblecommerce.com" }, "version": "v1" }, "servers": [ { "url": "//api.shippedsuite.com/" } ], "security": [ { "secretKey": [] } ], "tags": [ { "name": "Product Offers", "description": "Operations about Product Offers" } ], "paths": { "/v1/bigcommerce/product_offers": { "post": { "tags": [ "Product Offers" ], "description": "Calculates Return Protection and Warranty fees for a given product", "operationId": "postV1BigcommerceProductOffers", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/postV1BigcommerceProductOffers" } } }, "required": true }, "responses": { "201": { "description": "Calculates Return Protection and Warranty fees for a given product", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReturnOffer" } } } } }, "security": [ { "publicOrSecretKey": [] } ], "x-codegen-request-body-name": "postV1BigcommerceProductOffers" } } }, "components": { "schemas": { "Money": { "required": [ "currency", "formatted", "subunits" ], "type": "object", "properties": { "currency": { "type": "object", "description": "Currency", "allOf": [ { "$ref": "#/components/schemas/Currency" } ] }, "subunits": { "type": "integer", "description": "The value in the currency's smallest unit", "format": "int32", "example": 4000 }, "formatted": { "type": "string", "description": "Formatted representation", "example": "€40,00" } } }, "Currency": { "required": [ "decimal_mark", "iso_code", "name", "subunit_to_unit", "symbol", "symbol_first", "thousands_separator" ], "type": "object", "properties": { "decimal_mark": { "type": "string", "description": "Symbol use to separate decimals", "example": "." }, "symbol": { "type": "number", "description": "Currency symbol" }, "symbol_first": { "type": "boolean", "description": "Whether to display the symbol before or after the number", "example": true }, "thousands_separator": { "type": "string", "description": "Symbol used to separate each thousand units", "example": "," }, "subunit_to_unit": { "type": "integer", "description": "The number of subunits to a unit", "format": "int32", "example": 100 }, "iso_code": { "type": "string", "description": "The ISO code for the Currency", "example": "USD" }, "name": { "type": "string", "description": "The full name of the Currency", "example": "USD" } }, "description": "Currency model" }, "postV1BigcommerceProductOffers": { "required": [ "external_variant_id" ], "type": "object", "properties": { "external_variant_id": { "type": "string", "description": "The ID of the Variant in the external platform", "example": "88399874034" }, "price": { "type": "number", "description": "The price of the variant, if dynamic pricing is being used", "format": "double", "example": 123.94 }, "currency": { "type": "string", "description": "The display currency the order value is in.", "example": "JPY", "enum": [ "AED", "AFN", "ALL", "AMD", "ANG", "AOA", "ARS", "AUD", "AWG", "AZN", "BAM", "BBD", "BDT", "BGN", "BHD", "BIF", "BMD", "BND", "BOB", "BRL", "BSD", "BTN", "BWP", "BYN", "BYR", "BZD", "CAD", "CDF", "CHF", "CLF", "CLP", "CNY", "COP", "CRC", "CUC", "CUP", "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EGP", "ERN", "ETB", "EUR", "FJD", "FKP", "GBP", "GEL", "GHS", "GIP", "GMD", "GNF", "GTQ", "GYD", "HKD", "HNL", "HTG", "HUF", "IDR", "ILS", "INR", "IQD", "IRR", "ISK", "JMD", "JOD", "JPY", "KES", "KGS", "KHR", "KMF", "KPW", "KRW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LYD", "MAD", "MDL", "MGA", "MKD", "MMK", "MNT", "MOP", "MRU", "MUR", "MVR", "MWK", "MXN", "MYR", "MZN", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB", "RWF", "SAR", "SBD", "SCR", "SDG", "SEK", "SGD", "SHP", "SKK", "SLE", "SLL", "SOS", "SRD", "SSP", "STD", "STN", "SVC", "SYP", "SZL", "THB", "TJS", "TMT", "TND", "TOP", "TRY", "TTD", "TWD", "TZS", "UAH", "UGX", "USD", "UYU", "UZS", "VES", "VND", "VUV", "WST", "XAF", "XAG", "XAU", "XBA", "XBB", "XBC", "XBD", "XCD", "XDR", "XOF", "XPD", "XPF", "XPT", "XTS", "YER", "ZAR", "ZMK", "ZMW", "BCH", "BTC", "JEP", "GGP", "IMP", "XFU", "GBX", "CNH", "USDC", "EEK", "GHS", "HRK", "LTL", "LVL", "MRO", "MTL", "TMM", "JPY", "ZWD", "ZWL", "ZWN", "ZWR", "VEF" ] }, "exchange_rate": { "type": "number", "description": "The exchange rate used between the storefront default currency and the order display currency.", "format": "double", "example": 146.23807692 }, "customer": { "type": "object", "properties": { "external_customer_id": { "type": "string", "description": "The ID of the Customer in the external platform", "example": "764008273" }, "email": { "type": "string", "description": "The email address of the customer", "example": "john@doe.com" } } } }, "description": "Calculates Return Protection and Warranty fees for a given product" }, "ReturnOffer": { "required": [ "details", "external_variant_id", "offered_at", "price", "price_with_currency", "storefront_name", "storefront_subdomain", "title", "type" ], "type": "object", "properties": { "storefront_subdomain": { "type": "string", "description": "Storefront Subdomain the Offer is valid for", "example": "ic-development" }, "storefront_name": { "type": "string", "description": "Name of Storefront the Offer is valid for", "example": "IC Development" }, "external_variant_id": { "type": "string", "description": "The ID of the Variant in the external platform", "example": "23947090934" }, "type": { "type": "string", "description": "The type of Product Offer", "example": "return" }, "title": { "type": "string", "description": "The title for the Product Offer", "example": "return" }, "price": { "type": "number", "description": "The price for the Product Offer", "example": 20 }, "price_with_currency": { "type": "object", "description": "The price of the Product Offer, with currency information", "allOf": [ { "$ref": "#/components/schemas/Money" } ] }, "offered_at": { "type": "string", "description": "The date and time the Offer was generated. RFC 3339. ", "format": "date-time" }, "details": { "type": "object", "description": "Details of the terms of the Return Offer", "allOf": [ { "$ref": "#/components/schemas/ReturnOfferDetails" } ] } }, "description": "ReturnOffer model" }, "ReturnOfferDetails": { "required": [ "return_policy_url", "return_window" ], "type": "object", "properties": { "return_window": { "type": "integer", "description": "Return window, in days", "format": "int32", "example": 14 }, "return_policy_url": { "type": "string", "description": "Link to the Storefront return policy", "example": "https://www.samplestore.com/returns" } } } }, "securitySchemes": { "publicOrSecretKey": { "type": "apiKey", "name": "Authorization", "in": "header" }, "secretKey": { "type": "apiKey", "name": "Authorization", "in": "header" } } }, "x-original-swagger-version": "2.0" } ```