> ## Documentation Index > Fetch the complete documentation index at: https://developers.readyforcommerce.com/llms.txt > Use this file to discover all available pages before exploring further. # Actualizar los precios de un producto > Cambia el precio, el precio de comparación, el MAP, el MSRP y los costos en existencia, del proveedor y de respaldo de las variantes del producto que nombra por su id, como textos decimales en la moneda de cada variante como 19.99, null para quitar uno, con la versión en que se leyó el producto; un precio de comparación por debajo del precio, un precio por debajo del costo (el costo en existencia, o si no el del proveedor) y un MAP por encima del MSRP se rechazan cuando el cambio pone uno de sus precios, y la respuesta avisa de las otras reglas que los precios rompen. ## OpenAPI ````yaml /openapi/es.json patch /api/v1/orgs/{orgId}/catalog/products/{productId}/prices openapi: 3.1.0 info: title: API de Ready for Commerce version: 1.0.0 description: >- La referencia de cada operación de la API de Ready for Commerce. Todas las operaciones están en beta hasta el lanzamiento. servers: - url: https://app.readyforcommerce.com security: - apiKey: [] tags: - name: Credentials x-group: Credenciales description: >- La credencial que llama: su organización, sus permisos, sus límites y las llamadas que aún puede hacer. - name: Organization x-group: Organización description: 'Los ajustes de la organización: su nombre, su slug y su moneda.' - name: Billing x-group: Facturación description: >- La suscripción de la organización, la factura y el tope de cada módulo, y el uso del mes frente a su cuota gratuita. - name: Record types x-group: Tipos de registro description: >- Los tipos de registro que la credencial puede importar o exportar, con los campos y opciones de cada uno. - name: Imports x-group: Importaciones description: >- Para traer archivos CSV o Excel: subir o traer un archivo, inspeccionarlo y revisarlo, iniciar la importación y leer sus resultados. - name: Files x-group: Archivos description: El estado de un archivo subido, hasta que queda listo o rechazado. - name: Exports x-group: Exportaciones description: >- Para exportar a archivos CSV o Excel los registros que coinciden con un filtro; se guardan 14 días. - name: Export templates x-group: Plantillas de exportación description: >- Configuraciones de exportación guardadas con un nombre, para repetir la misma exportación. - name: Jobs x-group: Trabajos description: >- Las tareas largas corren como trabajos: su estado y su avance, sus mensajes, sus archivos para descargar o su cancelación. - name: Search x-group: Búsqueda description: >- Encuentra los registros de la organización por palabras, aunque lleven una errata, agrupados por tipo. - name: Version history x-group: Historial de versiones description: >- Las versiones de un registro, de la más nueva a la más antigua: compararlas y restaurar el registro a una de ellas. - name: Incidents x-group: Incidencias description: >- Los problemas de la organización que puedes ver: marcarlos como leídos o no leídos y resolverlos. - name: Notifications x-group: Notificaciones description: >- Tus notificaciones, de la más nueva a la más antigua: marcar una como leída o no leída, o todas como leídas. - name: Saved views x-group: Vistas guardadas description: >- La búsqueda, los filtros, el orden y las columnas de una tabla guardados con un nombre, tuyos o compartidos con la organización, y la vista con la que se abre cada tabla para ti. - name: Store connections x-group: Conexiones de tienda description: >- Las tiendas de la organización, conectadas con sus credenciales pegadas: listarlas, conectar una, reconectarla con credenciales nuevas o desconectarla. - name: Products x-group: Productos description: >- Los productos de la organización con sus opciones, variantes y precios: listarlos, leer uno, crear uno, cambiar el contenido, los precios o el estado de uno, duplicar uno como borrador, o eliminar uno. paths: /api/v1/orgs/{orgId}/catalog/products/{productId}/prices: patch: tags: - Products summary: Actualizar los precios de un producto description: >- Cambia el precio, el precio de comparación, el MAP, el MSRP y los costos en existencia, del proveedor y de respaldo de las variantes del producto que nombra por su id, como textos decimales en la moneda de cada variante como 19.99, null para quitar uno, con la versión en que se leyó el producto; un precio de comparación por debajo del precio, un precio por debajo del costo (el costo en existencia, o si no el del proveedor) y un MAP por encima del MSRP se rechazan cuando el cambio pone uno de sus precios, y la respuesta avisa de las otras reglas que los precios rompen. operationId: catalogUpdateProductPrices parameters: - schema: type: string format: uuid in: path name: orgId required: true - schema: type: string format: uuid in: path name: productId required: true requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProductPricesUpdateInput' responses: '200': description: Correcto content: application/json: schema: $ref: '#/components/schemas/ProductSaved' default: description: >- Un error, como `application/problem+json`: su `code` dice qué salió mal y `params` lleva sus valores content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/Problem' - properties: code: enum: - catalog.variant_unknown - catalog.price_invalid - catalog.price_out_of_range - catalog.compare_below_price - catalog.price_below_cost - catalog.map_above_msrp - core.version_conflict - core.bad_request - core.invalid_credential - core.forbidden - core.module_not_enabled - core.module_read_only - core.not_found - core.conflict - core.org_deletion_scheduled - core.payload_too_large - core.unsupported_media_type - core.validation_failed - core.rate_limited - core.surface_disabled - core.internal - core.unavailable components: schemas: ProductPricesUpdateInput: type: object properties: variants: type: array items: type: object properties: id: type: string format: uuid price: anyOf: - type: string maxLength: 40 - type: 'null' compareAt: anyOf: - type: string maxLength: 40 - type: 'null' map: anyOf: - type: string maxLength: 40 - type: 'null' msrp: anyOf: - type: string maxLength: 40 - type: 'null' onHandCost: anyOf: - type: string maxLength: 40 - type: 'null' supplierCost: anyOf: - type: string maxLength: 40 - type: 'null' fallbackCost: anyOf: - type: string maxLength: 40 - type: 'null' required: - id expectedVersion: type: integer minimum: 1 required: - variants - expectedVersion ProductSaved: type: object properties: id: type: string format: uuid title: type: string slug: type: string status: type: string enum: - draft - active - unlisted - archived condition: type: string enum: - new - open_box - new_with_defects - used - used_like_new - used_very_good - used_good - used_acceptable - refurbished - collectible_like_new - collectible_very_good - collectible_good - collectible_acceptable - for_parts_or_not_working productType: type: - string - 'null' descriptionHtml: description: >- The product's description in HTML, as it was saved; null when it has none. type: - string - 'null' metaTitle: type: - string - 'null' metaDescription: type: - string - 'null' version: type: integer createdAt: type: string format: date-time updatedAt: type: string format: date-time createdBy: type: object properties: type: type: string enum: - user - import - feed - integration - system - check - api_key - oauth_grant id: anyOf: - type: string format: uuid - type: 'null' required: - type - id additionalProperties: false updatedBy: type: object properties: type: type: string enum: - user - import - feed - integration - system - check - api_key - oauth_grant id: anyOf: - type: string format: uuid - type: 'null' required: - type - id additionalProperties: false options: type: array items: type: object properties: id: type: string format: uuid name: type: string position: type: integer values: type: array items: type: object properties: id: type: string format: uuid name: type: string position: type: integer required: - id - name - position additionalProperties: false required: - id - name - position - values additionalProperties: false variants: type: array items: type: object properties: id: type: string format: uuid optionValueIds: type: array items: type: string format: uuid identifiers: type: array items: type: object properties: type: type: string enum: - sku - gtin - isbn - mpn - custom value: type: string label: type: - string - 'null' required: - type - value - label additionalProperties: false currency: type: string enum: - AED - AFN - ALL - AMD - AOA - ARS - AUD - AWG - AZN - BAM - BBD - BDT - BHD - BIF - BMD - BND - BOB - BOV - BRL - BSD - BTN - BWP - BYN - BZD - CAD - CDF - CHE - CHF - CHW - CLF - CLP - CNY - COP - COU - CRC - 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 - MXV - 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 - SLE - SOS - SRD - SSP - STN - SVC - SYP - SZL - THB - TJS - TMT - TND - TOP - TRY - TTD - TWD - TZS - UAH - UGX - USD - USN - UYI - UYU - UYW - UZS - VED - VES - VND - VUV - WST - XAD - XAF - XCD - XCG - XOF - XPF - YER - ZAR - ZMW - ZWG price: type: - string - 'null' compareAt: type: - string - 'null' map: type: - string - 'null' msrp: type: - string - 'null' onHandCost: type: - string - 'null' supplierCost: type: - string - 'null' fallbackCost: type: - string - 'null' productWeight: anyOf: - type: object properties: value: type: number minimum: 0 unit: type: string enum: - g - kg - oz - lb - ct required: - value - unit additionalProperties: false - type: 'null' description: >- The product's own weight, a value with its unit (g, kg, oz, lb, ct); a value of 0 is saved as none. productLength: anyOf: - type: object properties: value: type: number minimum: 0 unit: type: string enum: - mm - cm - in - yd required: - value - unit additionalProperties: false - type: 'null' description: >- The product's own length, a value with its unit (mm, cm, in, yd); a value of 0 is saved as none. productWidth: anyOf: - type: object properties: value: type: number minimum: 0 unit: type: string enum: - mm - cm - in - yd required: - value - unit additionalProperties: false - type: 'null' description: >- The product's own width, a value with its unit (mm, cm, in, yd); a value of 0 is saved as none. productHeight: anyOf: - type: object properties: value: type: number minimum: 0 unit: type: string enum: - mm - cm - in - yd required: - value - unit additionalProperties: false - type: 'null' description: >- The product's own height, a value with its unit (mm, cm, in, yd); a value of 0 is saved as none. shippingWeight: anyOf: - type: object properties: value: type: number minimum: 0 unit: type: string enum: - g - kg - oz - lb - ct required: - value - unit additionalProperties: false - type: 'null' description: >- The weight it ships with, packed, a value with its unit (g, kg, oz, lb, ct); a value of 0 is saved as none. shippingLength: anyOf: - type: object properties: value: type: number minimum: 0 unit: type: string enum: - mm - cm - in - yd required: - value - unit additionalProperties: false - type: 'null' description: >- The length of its package, a value with its unit (mm, cm, in, yd); a value of 0 is saved as none. shippingWidth: anyOf: - type: object properties: value: type: number minimum: 0 unit: type: string enum: - mm - cm - in - yd required: - value - unit additionalProperties: false - type: 'null' description: >- The width of its package, a value with its unit (mm, cm, in, yd); a value of 0 is saved as none. shippingHeight: anyOf: - type: object properties: value: type: number minimum: 0 unit: type: string enum: - mm - cm - in - yd required: - value - unit additionalProperties: false - type: 'null' description: >- The height of its package, a value with its unit (mm, cm, in, yd); a value of 0 is saved as none. countryOfOrigin: description: >- The country it is made in, as its two-letter ISO 3166-1 code such as MX. type: - string - 'null' hsCode: description: Its Harmonized System customs code, its 6 to 13 digits alone. type: - string - 'null' trackInventory: type: boolean description: >- Whether its stock is tracked; a variant no longer tracked has none of its three stocks. onHandStock: anyOf: - type: integer minimum: 0 maximum: 2147483647 - type: 'null' description: >- The stock on hand, as the stores report it, for a tracked variant only. supplierStock: anyOf: - type: integer minimum: 0 maximum: 2147483647 - type: 'null' description: >- The stock at its supplier, as the supplier's feed reports it, for a tracked variant only. fallbackStock: anyOf: - type: integer minimum: 0 maximum: 2147483647 description: >- The stock it falls back on when it has none on hand or at its supplier, for a tracked variant only; one tracked without it has 0. - type: 'null' createdBy: type: object properties: type: type: string enum: - user - import - feed - integration - system - check - api_key - oauth_grant id: anyOf: - type: string format: uuid - type: 'null' required: - type - id additionalProperties: false updatedBy: type: object properties: type: type: string enum: - user - import - feed - integration - system - check - api_key - oauth_grant id: anyOf: - type: string format: uuid - type: 'null' required: - type - id additionalProperties: false required: - id - optionValueIds - identifiers - currency - price - compareAt - map - msrp - onHandCost - supplierCost - fallbackCost - productWeight - productLength - productWidth - productHeight - shippingWeight - shippingLength - shippingWidth - shippingHeight - countryOfOrigin - hsCode - trackInventory - onHandStock - supplierStock - fallbackStock - createdBy - updatedBy additionalProperties: false warnings: type: array items: type: object properties: code: type: string enum: - catalog.part_number_similar - catalog.compare_below_price - catalog.price_below_cost - catalog.price_below_map - catalog.price_above_msrp - catalog.map_above_msrp - catalog.cost_above_map - catalog.cost_above_msrp params: type: object propertyNames: type: string additionalProperties: type: - string - number required: - code - params additionalProperties: false required: - id - title - slug - status - condition - productType - descriptionHtml - metaTitle - metaDescription - version - createdAt - updatedAt - createdBy - updatedBy - options - variants - warnings additionalProperties: false Problem: type: object properties: type: type: string pattern: ^urn:rfc:problem:[\s\S]{0,}\.[\s\S]{0,}$ status: type: integer title: type: string code: type: string pattern: ^[\s\S]{0,}\.[\s\S]{0,}$ params: type: object propertyNames: type: string additionalProperties: {} requestId: type: string errors: type: array items: type: object properties: location: type: string pointer: type: string code: type: string params: type: object propertyNames: type: string additionalProperties: {} required: - location - pointer - code additionalProperties: false required: - type - status - code - requestId additionalProperties: false securitySchemes: apiKey: type: http scheme: bearer description: >- Una llave de API de la organización, enviada en cada llamada como `Authorization: Bearer `. La crea una persona de la organización en la aplicación, en **Ajustes › API y conexiones › Llaves de API**. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.