Tamio

Update a physical product

POST https://api.tamio.com/v2/products/physical/update/{uuid}

Path Parameters

uuid string*

Product UUID

Body Parameters

tax_category string*

Tax category classification UUID for the product

languages LanguageContent*
pricing_model array of PricingModelEntry*
JSON
{ "pricing_model": [ { "id": "660e8400-e29b-41d4-a716-446655440001", "currency": "EUR", "price": 2999, "acquisition_price": 1200, "recommended_seller_price": 3499, "billing_cycle": "month", "interval": 1 } ] }
id string

Pricing model entry UUID

currency string
price integer
acquisition_price integer

Cost/acquisition price for margin calculation (smallest unit)

recommended_seller_price integer

Recommended retail price (smallest unit)

billing_cycle string

Only present for billing plan products

dayweekmonthyear
interval integer

Only present for billing plan products

stock integer

Current stock quantity available

unlimited_stock boolean

Whether the product has unlimited stock

stock_limit_warning integer

Threshold at which low stock warnings are triggered

min_units integer

Minimum units a customer can purchase in one order

max_units integer

Maximum units a customer can purchase in one order

weight number

Total weight of the product in kilograms

net_weight number

Net weight of the product excluding packaging in kilograms

dimensions object
JSON
{ "dimensions": { "height": 0, "width": 0, "length": 0 } }
height number
width number
length number
on_sale boolean

Whether the product is currently marked as on sale

buyable boolean

Whether the product is available for purchase

shown boolean

Whether the product is visible on the storefront

sample boolean

Whether the product is a free sample

discount_allowed boolean

Whether discounts can be applied to this product

reviews_allowed boolean

Whether customer reviews are enabled for this product

exclude_from_feed boolean

Whether to exclude the product from external feeds like Google Shopping

hide_if_no_stock boolean

Whether to hide the product when it is out of stock

allow_negative_stock boolean

Whether to allow orders even when stock falls below zero

whitelist array of string
google_category integer
release_date string
expiry_date string
new_from string
new_to string
sku string
ean string
upc string
isbn string
gtin string
mpn string
asin string
hscode string
brand string
model string
condition string
newlike-newnew-with-tagsnew-without-tagsrefurbishedused-excellent
packaging_type string
boxpalletenvelope
country_of_origin string
related_products array of string
gallery array of string
variations object
custom_fields array of CustomFieldInput
JSON
{ "custom_fields": [ { "language": "string", "name": "string", "type": "dropdown", "required": false, "values": [], "range_from": "string", "range_to": "string" } ] }
language string*
name string*
type string*
dropdownradio-buttonscheckboxestextfieldtextareadate-picker
required boolean*
values array of string
range_from string
range_to string
custom_attributes array of CustomAttributeValue
JSON
{ "custom_attributes": [ { "id": "00000000-0000-0000-0000-000000000000", "values": { "text": {}, "link": {}, "image": "00000000-0000-0000-0000-000000000000" } } ] }
id string*
values object*
JSON
{ "values": { "text": {}, "link": {}, "image": "00000000-0000-0000-0000-000000000000" } }
text object
link object
image string
stock_breakdown array of object
JSON
{ "stock_breakdown": [ { "warehouse": "00000000-0000-0000-0000-000000000000", "stock": 0 } ] }
warehouse string*
stock integer*
packs array of object
JSON
{ "packs": [ { "label": {}, "stock": 0, "multiples": false } ] }
label object*
stock integer*
multiples boolean*

Responses

200 Product operation successful

Product operation successful

status integer
product Product
400 Bad request. Possible `error_code` values:
401 Missing or invalid API key
/products/physical/update/{uuid}
1const response = await fetch("https://api.tamio.com/v2/products/physical/update/{uuid}", {
2 method: "POST",
3 headers: {
4 "Authorization": "Bearer YOUR_API_KEY",
5 "Content-Type": "application/json"
6 },
7 body: JSON.stringify({
8 "tax_category": "123e4567-e89b-12d3-a456-426614174000",
9 "languages": "...",
10 "pricing_model": [
11 {
12 "id": "660e8400-e29b-41d4-a716-446655440001",
13 "currency": "EUR",
14 "price": 2999,
15 "acquisition_price": 1200,
16 "recommended_seller_price": 3499,
17 "billing_cycle": "month",
18 "interval": 1
19 }
20 ],
21 "stock": 100,
22 "unlimited_stock": false,
23 "stock_limit_warning": 10,
24 "min_units": 1,
25 "max_units": 50,
26 "weight": 1.5,
27 "net_weight": 1.2,
28 "dimensions": {
29 "height": 0,
30 "width": 0,
31 "length": 0
32 },
33 "on_sale": false,
34 "buyable": true,
35 "shown": true,
36 "sample": false,
37 "discount_allowed": true,
38 "reviews_allowed": true,
39 "exclude_from_feed": false,
40 "hide_if_no_stock": true,
41 "allow_negative_stock": false,
42 "whitelist": [],
43 "google_category": 0,
44 "release_date": "string",
45 "expiry_date": "string",
46 "new_from": "string",
47 "new_to": "string",
48 "sku": "string",
49 "ean": "string",
50 "upc": "string",
51 "isbn": "string",
52 "gtin": "string",
53 "mpn": "string",
54 "asin": "string",
55 "hscode": "string",
56 "brand": "string",
57 "model": "string",
58 "condition": "new",
59 "packaging_type": "box",
60 "country_of_origin": "string",
61 "related_products": [],
62 "gallery": [],
63 "variations": {},
64 "custom_fields": [
65 {
66 "language": "string",
67 "name": "string",
68 "type": "dropdown",
69 "required": false,
70 "values": [],
71 "range_from": "string",
72 "range_to": "string"
73 }
74 ],
75 "custom_attributes": [
76 {
77 "id": "00000000-0000-0000-0000-000000000000",
78 "values": {
79 "text": {},
80 "link": {},
81 "image": "00000000-0000-0000-0000-000000000000"
82 }
83 }
84 ],
85 "stock_breakdown": [
86 {
87 "warehouse": "00000000-0000-0000-0000-000000000000",
88 "stock": 0
89 }
90 ],
91 "packs": [
92 {
93 "label": {},
94 "stock": 0,
95 "multiples": false
96 }
97 ]
98 })
99});
100const data = await response.json();
Responses
{
  "status": 200,
  "product": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "object": "product",
    "name": "Premium Widget",
    "description": "High-quality premium widget with advanced features",
    "seo_title": "Premium Widget | Buy Online",
    "seo_description": "Shop the Premium Widget — built to last with advanced features.",
    "classification": "Tangible Goods",
    "is_moss_product": false,
    "created": 1700000000,
    "updated_unix": 1700100000,
    "currency": "EUR",
    "type": "physical_product",
    "pricing_model": [
      {
        "id": "660e8400-e29b-41d4-a716-446655440001",
        "currency": "EUR",
        "price": 2999,
        "acquisition_price": 1200,
        "recommended_seller_price": 3499,
        "billing_cycle": "month",
        "interval": 1
      }
    ],
    "price": 2999,
    "stock": 150,
    "has_variations": true,
    "has_notes": false,
    "sample": false,
    "release_date": "2024-06-01T00:00:00Z",
    "release_date_unix": 1717200000,
    "expiry_date": "2025-12-31T23:59:59Z",
    "expiry_date_unix": 1767225599,
    "new_from": "2024-06-01T00:00:00Z",
    "new_from_unix": 1717200000,
    "new_to": "2024-09-01T00:00:00Z",
    "new_to_unix": 1725148800,
    "exclude_from_feed": false,
    "google_category": 5322,
    "in_stock": true,
    "unlimited_stock": false,
    "min_units": 1,
    "max_units": 100,
    "stock_limit_warning": 10,
    "allow_negative_stock": false,
    "on_sale": true,
    "discount_allowed": true,
    "reviews_allowed": true,
    "hide_if_no_stock": false,
    "shown": true,
    "buyable": true,
    "custom_fields": [],
    "whitelist": [
      "[email protected]"
    ],
    "additional_information": {
      "brand": "WidgetCorp",
      "model": "WX-3000",
      "asin": "B09V3KXJPB",
      "upc": "012345678905",
      "mpn": "WX3K-BLK",
      "isbn": "978-3-16-148410-0",
      "ean": "4006381333931",
      "gtin": "00012345678905",
      "sku": "WDG-PRM-001",
      "hscode": "8471.30",
      "condition": "new",
      "country_of_origin": "DE",
      "packaging_type": "box",
      "detailed_description": "string",
      "nshift_parcel_amount": 1,
      "nshift_quick_id": "string",
      "parcels": {}
    },
    "weight": 2.5,
    "net_weight": 2.1,
    "dimensions": {
      "length": 30,
      "width": 20,
      "height": 10
    },
    "packs": [
      {
        "id": "770e8400-e29b-41d4-a716-446655440002",
        "label": {
          "en": "6-Pack",
          "de": "6er-Pack"
        },
        "stock": 50,
        "multiples": true
      }
    ],
    "stock_breakdown": [
      {
        "warehouse": "880e8400-e29b-41d4-a716-446655440003",
        "stock": 75
      }
    ],
    "delivery_type": "file",
    "license_type": "autogenerated",
    "delivery_url": "https://downloads.example.com/premium-widget",
    "number_of_downloads": 5,
    "licenses": [
      "XXXX-YYYY-ZZZZ-1111",
      "XXXX-YYYY-ZZZZ-2222"
    ],
    "digital_files": [],
    "billing_cycle": "month",
    "interval": 1,
    "trial_period": 14,
    "descriptor": "ACME PREMIUM",
    "retries": 2,
    "cancel_action": "cancel",
    "cancel_behaviour": "end_of_period",
    "has_stripe_price": true,
    "charge_shipping_during_trial": false,
    "is_customer_product": false,
    "clients": [
      {
        "id": "990e8400-e29b-41d4-a716-446655440004",
        "name": "Acme Corp",
        "email": "[email protected]"
      }
    ],
    "gallery": [
      {
        "public_url": "https://pub.ox31.com/uploads/product-image-abc123.jpg",
        "alt_text": "Premium Widget front view",
        "asset_id": "aa0e8400-e29b-41d4-a716-446655440005"
      }
    ],
    "has_image": true,
    "languages": {
      "en": {
        "title": "Premium Widget",
        "description": "High-quality premium widget",
        "slug": "premium-widget"
      },
      "de": {
        "title": "Premium-Widget",
        "description": "Hochwertiges Premium-Widget",
        "slug": "premium-widget"
      }
    },
    "variations": {
      "options": [
        {
          "name": "Size",
          "values": [
            "Small",
            "Medium",
            "Large"
          ]
        }
      ],
      "variants": [
        {
          "id": "bb0e8400-e29b-41d4-a716-446655440006",
          "stock": 25,
          "options": {
            "en": {
              "size": "Large",
              "color": "Blue"
            }
          },
          "stock_breakdown": []
        }
      ]
    },
    "invoices": 342,
    "customers": 198,
    "subscriptions": 45,
    "lifetime_revenue": 1025000,
    "related_products": [
      "cc0e8400-e29b-41d4-a716-446655440007",
      "dd0e8400-e29b-41d4-a716-446655440008"
    ]
  }
}