Skip to main content
PUT
La Pyme SDK

Authorizations

Authorization
string
header
required

Incluí tu API key en el header Authorization con el prefijo Bearer.

Headers

X-Request-Id
string

ID opcional de la solicitud para trazabilidad. Si se omite, el servidor genera uno.

Required string length: 1 - 255
Idempotency-Key
string

Clave estable obligatoria al actualizar un combo existente, aunque se omita product_type. Reutilizala solo para reintentar exactamente la misma actualización.

Required string length: 1 - 255

Path Parameters

product_id
string<uuid>
required

ID del producto

Body

application/json
handle
string

Identificador del producto en el catálogo; se normaliza al guardar.

Minimum string length: 1
name
string
Required string length: 1 - 255
description
string | null
Maximum string length: 500
category_id
string<uuid> | null
visibility
enum<string>
Available options:
both,
sales,
purchases,
system
image_url
string | null

External product image URL reference. La Pyme displays it best effort and does not copy, ingest, or host the image.

Maximum string length: 2000
product_type
enum<string>
Available options:
product,
service,
kit,
combo
sku
string
Required string length: 1 - 100
supplier_sku
string | null
Maximum string length: 100
barcode
string | null
Maximum string length: 100
unit_of_measure
enum<string>
default:07
Available options:
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
30,
31,
32,
33,
34,
35,
36,
37,
41,
47,
48,
49,
50,
51,
52,
53,
54,
55,
61,
62,
63,
97,
98,
99,
00,
01,
02,
03,
04,
05,
06,
07,
08,
09
currency
enum<string>
Available options:
ARS,
USD
ars_reference_exchange_rate
number | null
Required range: x > 0
cost
integer
Required range: x >= 0
price
integer | null

Precio manual en centavos. En combos existentes, omitilo para conservar el precio guardado.

Required range: x >= 0
promotional_price
integer | null
Required range: x >= 0
markup_percentage
number | null

Markup percentage used to calculate the sale price from cost and organization rounding rules. The price adds the product's IVA rate only when the organization's sales prices include IVA. Mutually exclusive with price; send null to switch back to manual pricing.

Required range: 0 <= x <= 10000
tax_rate_id
integer
is_exempt
boolean
default_supplier_id
string<uuid> | null
default_sales_account_id
string<uuid> | null
default_purchase_account_id
string<uuid> | null
warehouse_stocks
object[]
is_active
boolean
pricing_mode
enum<string>
Available options:
automatic,
manual
price_adjustment_percentage
number | null
Required range: -100 <= x <= 10000
components
object[]

Solo para combos existentes. Omití la clave para conservar la composición; enviarla reemplaza todos los componentes.

Minimum array length: 1

Response

Producto actualizado exitosamente

request_id
string
required
data
object
required
warnings
any[]
required