v1

latestOpenAPI 3.1.0Proprietary2026-07-22134294785.0 KB

API

Actualizar producto

Actualiza un producto y devuelve el detalle persistido.

put/api/v1/products/{product_id}

Path parameters

product_idstring uuid required

ID del producto

Headers

X-Request-Idstring

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

Request body

namestring

descriptionstring nullable

category_idstring uuid nullable

visibility'both' | 'sales' | 'purchases'

image_urlstring nullable

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

product_type'product' | 'service' | 'combo' | 'kit'

skustring

barcodestring nullable

unit_of_measure'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'PES' | 'DOL'

costinteger

priceinteger

Manual sale price in cents. Mutually exclusive with markup_percentage; send price for manual pricing or markup_percentage for markup pricing.

promotional_priceinteger nullable

markup_percentagenumber nullable

Markup percentage used to calculate the sale price from cost, tax, and organization rounding rules. Mutually exclusive with price; send null to switch back to manual pricing.

tax_rate_idinteger

is_exemptboolean

default_supplier_idstring uuid nullable

default_sales_account_idstring uuid nullable

default_purchase_account_idstring uuid nullable

is_activeboolean

Response

Producto actualizado exitosamente

request_idstring required