> ## 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. # Crear un producto > Crea un producto con sus opciones y sus variantes, cada variante una combinación de los valores de las opciones con sus identificadores: SKU, GTIN, ISBN, número de pieza (mpn) y códigos propios con su etiqueta, con el dígito de control del GTIN y del ISBN verificado y cada SKU, GTIN e ISBN único en la organización. Cada variante también puede llevar su precio, precio de comparación, MAP, MSRP y costos como textos decimales en la moneda de la organización, lo que necesita el permiso de editar precios, y se rechaza cuando rompen una regla de precios, como un precio de comparación por debajo del precio. La respuesta trae el producto y los avisos del guardado, como un número de pieza que se distingue del de otro producto solo en la puntuación, como guiones o espacios, o un precio por debajo del MAP. ## OpenAPI ````yaml /openapi/es.json post /api/v1/orgs/{orgId}/catalog/products 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: post: tags: - Products summary: Crear un producto description: >- Crea un producto con sus opciones y sus variantes, cada variante una combinación de los valores de las opciones con sus identificadores: SKU, GTIN, ISBN, número de pieza (mpn) y códigos propios con su etiqueta, con el dígito de control del GTIN y del ISBN verificado y cada SKU, GTIN e ISBN único en la organización. Cada variante también puede llevar su precio, precio de comparación, MAP, MSRP y costos como textos decimales en la moneda de la organización, lo que necesita el permiso de editar precios, y se rechaza cuando rompen una regla de precios, como un precio de comparación por debajo del precio. La respuesta trae el producto y los avisos del guardado, como un número de pieza que se distingue del de otro producto solo en la puntuación, como guiones o espacios, o un precio por debajo del MAP. operationId: catalogCreateProduct parameters: - schema: type: string format: uuid in: path name: orgId required: true requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProductCreateInput' responses: '201': description: Creado 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.no_variants - catalog.option_without_values - catalog.option_repeated - catalog.option_value_repeated - catalog.variant_option_values - catalog.variant_repeated - catalog.variant_limit - catalog.slug_empty - catalog.slug_taken - catalog.identifier_invalid - catalog.identifier_repeated - catalog.identifier_taken - catalog.price_invalid - catalog.price_out_of_range - catalog.compare_below_price - catalog.price_below_cost - catalog.map_above_msrp - catalog.measure_out_of_range - catalog.hs_code_invalid - catalog.country_invalid - catalog.stock_untracked - core.usage_limit_reached - core.idempotency_in_progress - core.idempotency_mismatch - 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: ProductCreateInput: type: object properties: title: type: string minLength: 1 maxLength: 300 slug: type: string minLength: 1 maxLength: 200 status: default: draft type: string enum: - draft - active - unlisted - archived condition: default: new 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 maxLength: 100 descriptionHtml: type: string description: >- The product's description in HTML, which keeps paragraphs, headings, lists and task lists, quotes, code blocks, images, tables, rules, line breaks, links, bold, italic, underline, strikethrough, subscript, superscript, text colour, highlight, alignment, and YouTube, Vimeo or video embeds. Anything else, such as a script, an event attribute or another site's frame, is removed and its text kept; a description left with nothing is saved as none. metaTitle: type: string maxLength: 200 metaDescription: type: string maxLength: 300 options: default: [] type: array items: type: object properties: name: type: string minLength: 1 maxLength: 150 values: type: array items: type: string minLength: 1 maxLength: 150 required: - name - values variants: type: array items: type: object properties: optionValues: type: array items: type: string minLength: 1 maxLength: 150 identifiers: default: [] type: array items: oneOf: - type: object properties: type: type: string enum: - sku - gtin - isbn - mpn examples: - sku value: type: string required: - type - value additionalProperties: false - type: object properties: type: type: string const: custom value: type: string label: type: string minLength: 1 maxLength: 50 required: - type - value - label additionalProperties: false price: type: string maxLength: 40 compareAt: type: string maxLength: 40 map: type: string maxLength: 40 msrp: type: string maxLength: 40 onHandCost: type: string maxLength: 40 supplierCost: type: string maxLength: 40 fallbackCost: type: string maxLength: 40 productWeight: description: >- The product's own weight, a value with its unit (g, kg, oz, lb, ct); a value of 0 is saved as none. type: object properties: value: type: number minimum: 0 unit: type: string enum: - g - kg - oz - lb - ct examples: - g required: - value - unit additionalProperties: false productLength: description: >- The product's own length, a value with its unit (mm, cm, in, yd); a value of 0 is saved as none. type: object properties: value: type: number minimum: 0 unit: type: string enum: - mm - cm - in - yd examples: - mm required: - value - unit additionalProperties: false productWidth: description: >- The product's own width, a value with its unit (mm, cm, in, yd); a value of 0 is saved as none. type: object properties: value: type: number minimum: 0 unit: type: string enum: - mm - cm - in - yd examples: - mm required: - value - unit additionalProperties: false productHeight: description: >- The product's own height, a value with its unit (mm, cm, in, yd); a value of 0 is saved as none. type: object properties: value: type: number minimum: 0 unit: type: string enum: - mm - cm - in - yd examples: - mm required: - value - unit additionalProperties: false shippingWeight: 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. type: object properties: value: type: number minimum: 0 unit: type: string enum: - g - kg - oz - lb - ct examples: - g required: - value - unit additionalProperties: false shippingLength: description: >- The length of its package, a value with its unit (mm, cm, in, yd); a value of 0 is saved as none. type: object properties: value: type: number minimum: 0 unit: type: string enum: - mm - cm - in - yd examples: - mm required: - value - unit additionalProperties: false shippingWidth: description: >- The width of its package, a value with its unit (mm, cm, in, yd); a value of 0 is saved as none. type: object properties: value: type: number minimum: 0 unit: type: string enum: - mm - cm - in - yd examples: - mm required: - value - unit additionalProperties: false shippingHeight: description: >- The height of its package, a value with its unit (mm, cm, in, yd); a value of 0 is saved as none. type: object properties: value: type: number minimum: 0 unit: type: string enum: - mm - cm - in - yd examples: - mm required: - value - unit additionalProperties: false countryOfOrigin: type: string maxLength: 100 description: >- The country it is made in, as its two-letter ISO 3166-1 code such as MX, in any case. hsCode: type: string maxLength: 100 description: >- Its Harmonized System customs code: 6 to 13 digits, once every other character, such as dots, spaces and hyphens, is removed. trackInventory: type: boolean description: >- Whether its stock is tracked; a variant no longer tracked has none of its three stocks. fallbackStock: 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. required: - optionValues required: - title - variants 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.