{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Catálogo de productos del comercio","description":"QRwey! API es un API que te permite intenciones de autofactura con QRs para ser leidos en la App de QRwey!.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"catálogo-de-productos-del-comercio","__idx":0},"children":["Catálogo de productos del comercio"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cada ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["comercio"]}," puede mantener un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["catálogo de productos"]}," reutilizable. Estos productos"," ","se identifican por su ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sku"]}," y guardan las claves del SAT (producto/servicio y unidad) junto con"," ","el precio unitario, de modo que puedan referenciarse al generar transacciones y facturas."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Todas las operaciones de este recurso pertenecen a la ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Gestión de Clientes"]}," y se autentican con"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer {{access_token}}"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"crear-productos","__idx":1},"children":["Crear productos"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Registra uno o más productos en el catálogo de un comercio. El cuerpo es una ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["lista"]},", por lo que"," ","puedes crear varios productos en una sola petición."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint","__idx":2},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /v1/qrs/merchants/{merchantId}/products\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host (DEV):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://api-dev.qrwey.com\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host (PROD):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://api.qrwey.com\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"headers-requeridos","__idx":3},"children":["Headers requeridos"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer {{access_token}}\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"path-params","__idx":4},"children":["Path params"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parámetro"},"children":["Parámetro"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ID del comercio (requerido)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"campos-de-createmerchantproductrequest","__idx":5},"children":["Campos de CreateMerchantProductRequest"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sku"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificador único de producto (SKU) para control interno del comercio (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["satProductServiceCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clave de Producto/Servicio según el catálogo del SAT (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Descripción del producto o servicio (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["satUnitCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clave de Unidad según el catálogo del SAT (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unitPrice"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Precio unitario del producto. Debe ser mayor a cero (requerido)"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev","__idx":6},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://api-dev.qrwey.com/v1/qrs/merchants/mer_4aca0361cfcd41c097663db44008fbb9/products\" \\\n  -H \"Authorization: Bearer {{access_token}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '[\n    {\n      \"sku\": \"GAS87\",\n      \"satProductServiceCode\": \"15101515\",\n      \"description\": \"Gasolina Magna\",\n      \"satUnitCode\": \"LTR\",\n      \"unitPrice\": 20.325\n    }\n  ]'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"respuesta","__idx":7},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"[\n  {\n    \"merchantProductId\": \"prod_9f3b2a17c4e84d6f8a1b2c3d4e5f6a7b\",\n    \"merchantId\": \"mer_4aca0361cfcd41c097663db44008fbb9\",\n    \"sku\": \"GAS87\",\n    \"satProductServiceCode\": \"15101515\",\n    \"satProductServiceDescription\": \"Gasolina\",\n    \"description\": \"Gasolina Magna\",\n    \"satUnitCode\": \"LTR\",\n    \"satUnitDescription\": \"Litro\",\n    \"unitPrice\": 20.325,\n    \"status\": \"ACTIVE\"\n  }\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"listar-productos","__idx":8},"children":["Listar productos"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Devuelve una lista paginada de los productos del catálogo de un comercio, con filtro opcional por"," ","SKU o descripción."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-1","__idx":9},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /v1/qrs/merchants/{merchantId}/products\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"headers-requeridos-1","__idx":10},"children":["Headers requeridos"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer {{access_token}}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"path-params-1","__idx":11},"children":["Path params"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parámetro"},"children":["Parámetro"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ID del comercio (requerido)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"query-params","__idx":12},"children":["Query params"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parámetro"},"children":["Parámetro"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Texto para filtrar por SKU o descripción del producto (opcional)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Número de página (default: 0)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["size"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Elementos por página (default: 20)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Campo y dirección de ordenamiento (ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAt,desc"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev-1","__idx":13},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api-dev.qrwey.com/v1/qrs/merchants/mer_4aca0361cfcd41c097663db44008fbb9/products?search=GAS&page=0&size=10\" \\\n  -H \"Authorization: Bearer {{access_token}}\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"respuesta-1","__idx":14},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"content\": [\n    {\n      \"merchantProductId\": \"prod_9f3b2a17c4e84d6f8a1b2c3d4e5f6a7b\",\n      \"merchantId\": \"mer_4aca0361cfcd41c097663db44008fbb9\",\n      \"sku\": \"GAS87\",\n      \"satProductServiceCode\": \"15101515\",\n      \"satProductServiceDescription\": \"Gasolina\",\n      \"description\": \"Gasolina Magna\",\n      \"satUnitCode\": \"LTR\",\n      \"satUnitDescription\": \"Litro\",\n      \"unitPrice\": 20.325,\n      \"status\": \"ACTIVE\"\n    }\n  ],\n  \"totalElements\": 1,\n  \"totalPages\": 1,\n  \"number\": 0,\n  \"size\": 10\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"campos-de-merchantproductresponse","__idx":15},"children":["Campos de MerchantProductResponse"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantProductId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificador único del producto en el catálogo"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ID del comercio dueño del producto"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sku"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificador interno del producto (SKU)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["satProductServiceCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clave de Producto/Servicio del SAT"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["satProductServiceDescription"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Descripción de la clave de Producto/Servicio del SAT"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Descripción del producto o servicio"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["satUnitCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clave de Unidad del SAT"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["satUnitDescription"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Descripción de la clave de Unidad del SAT"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unitPrice"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Precio unitario del producto"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Estatus del producto: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INACTIVE"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"obtener-producto-por-id","__idx":16},"children":["Obtener producto por ID"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-2","__idx":17},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /v1/qrs/merchants/{merchantId}/products/{merchantProductId}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"headers-requeridos-2","__idx":18},"children":["Headers requeridos"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer {{access_token}}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"path-params-2","__idx":19},"children":["Path params"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parámetro"},"children":["Parámetro"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ID del comercio (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantProductId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ID del producto del comercio (requerido)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev-2","__idx":20},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api-dev.qrwey.com/v1/qrs/merchants/mer_4aca0361cfcd41c097663db44008fbb9/products/prod_9f3b2a17c4e84d6f8a1b2c3d4e5f6a7b\" \\\n  -H \"Authorization: Bearer {{access_token}}\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"respuesta-2","__idx":21},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"merchantProductId\": \"prod_9f3b2a17c4e84d6f8a1b2c3d4e5f6a7b\",\n  \"merchantId\": \"mer_4aca0361cfcd41c097663db44008fbb9\",\n  \"sku\": \"GAS87\",\n  \"satProductServiceCode\": \"15101515\",\n  \"satProductServiceDescription\": \"Gasolina\",\n  \"description\": \"Gasolina Magna\",\n  \"satUnitCode\": \"LTR\",\n  \"satUnitDescription\": \"Litro\",\n  \"unitPrice\": 20.325,\n  \"status\": \"ACTIVE\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"actualizar-producto","__idx":22},"children":["Actualizar producto"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Actualiza los datos de un producto existente, incluyendo su estatus. El campo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantProductId"]}," ","debe enviarse también en el cuerpo de la petición."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-3","__idx":23},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"PUT /v1/qrs/merchants/{merchantId}/products/{merchantProductId}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"headers-requeridos-3","__idx":24},"children":["Headers requeridos"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer {{access_token}}\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"path-params-3","__idx":25},"children":["Path params"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parámetro"},"children":["Parámetro"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ID del comercio (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantProductId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ID del producto del comercio (requerido)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"campos-de-updatemerchantproductrequest","__idx":26},"children":["Campos de UpdateMerchantProductRequest"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantProductId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ID del producto que se actualiza (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sku"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificador interno del producto (SKU) (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["satProductServiceCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clave de Producto/Servicio del SAT (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Descripción del producto o servicio (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["satUnitCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clave de Unidad del SAT (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unitPrice"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Precio unitario del producto. Debe ser mayor a cero (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Estatus del producto: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INACTIVE"]}," (requerido)"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev-3","__idx":27},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X PUT \"https://api-dev.qrwey.com/v1/qrs/merchants/mer_4aca0361cfcd41c097663db44008fbb9/products/prod_9f3b2a17c4e84d6f8a1b2c3d4e5f6a7b\" \\\n  -H \"Authorization: Bearer {{access_token}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"merchantProductId\": \"prod_9f3b2a17c4e84d6f8a1b2c3d4e5f6a7b\",\n    \"sku\": \"GAS87\",\n    \"satProductServiceCode\": \"15101515\",\n    \"description\": \"Gasolina Magna\",\n    \"satUnitCode\": \"LTR\",\n    \"unitPrice\": 21.100,\n    \"status\": \"ACTIVE\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"respuesta-3","__idx":28},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"merchantProductId\": \"prod_9f3b2a17c4e84d6f8a1b2c3d4e5f6a7b\",\n  \"merchantId\": \"mer_4aca0361cfcd41c097663db44008fbb9\",\n  \"sku\": \"GAS87\",\n  \"satProductServiceCode\": \"15101515\",\n  \"satProductServiceDescription\": \"Gasolina\",\n  \"description\": \"Gasolina Magna\",\n  \"satUnitCode\": \"LTR\",\n  \"satUnitDescription\": \"Litro\",\n  \"unitPrice\": 21.100,\n  \"status\": \"ACTIVE\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"errores-comunes","__idx":29},"children":["Errores comunes"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Código"},"children":["Código"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Motivo"},"children":["Motivo"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Parámetros inválidos (SKU o claves del SAT faltantes, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unitPrice"]}," menor o igual a cero)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token inválido o expirado"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Producto o comercio no encontrado, o no pertenece a tu cuenta"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Consulta: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/error-handling"},"children":["Manejo de errores"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"buenas-prácticas","__idx":30},"children":["Buenas prácticas"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Mantén el ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sku"]}," consistente con tu sistema interno para conciliar inventario y facturación"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Usa claves del SAT válidas; consúltalas en ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/sat-catalogs"},"children":["Catálogos del SAT"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Marca como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INACTIVE"]}," los productos que dejes de vender en lugar de eliminarlos, para conservar su historial"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"qué-sigue","__idx":31},"children":["¿Qué sigue?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Administra los comercios: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/merchants"},"children":["Gestión de comercios"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Consulta transacciones: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/transactions"},"children":["Gestión de transacciones"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Vuelve al índice: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/customer-portal"},"children":["Gestión de Clientes"]}]}]}]},"headings":[{"value":"Catálogo de productos del comercio","id":"catálogo-de-productos-del-comercio","depth":1},{"value":"Crear productos","id":"crear-productos","depth":2},{"value":"Endpoint","id":"endpoint","depth":3},{"value":"Headers requeridos","id":"headers-requeridos","depth":3},{"value":"Path params","id":"path-params","depth":3},{"value":"Campos de CreateMerchantProductRequest","id":"campos-de-createmerchantproductrequest","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev","depth":3},{"value":"Respuesta","id":"respuesta","depth":3},{"value":"Listar productos","id":"listar-productos","depth":2},{"value":"Endpoint","id":"endpoint-1","depth":3},{"value":"Headers requeridos","id":"headers-requeridos-1","depth":3},{"value":"Path params","id":"path-params-1","depth":3},{"value":"Query params","id":"query-params","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev-1","depth":3},{"value":"Respuesta","id":"respuesta-1","depth":3},{"value":"Campos de MerchantProductResponse","id":"campos-de-merchantproductresponse","depth":3},{"value":"Obtener producto por ID","id":"obtener-producto-por-id","depth":2},{"value":"Endpoint","id":"endpoint-2","depth":3},{"value":"Headers requeridos","id":"headers-requeridos-2","depth":3},{"value":"Path params","id":"path-params-2","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev-2","depth":3},{"value":"Respuesta","id":"respuesta-2","depth":3},{"value":"Actualizar producto","id":"actualizar-producto","depth":2},{"value":"Endpoint","id":"endpoint-3","depth":3},{"value":"Headers requeridos","id":"headers-requeridos-3","depth":3},{"value":"Path params","id":"path-params-3","depth":3},{"value":"Campos de UpdateMerchantProductRequest","id":"campos-de-updatemerchantproductrequest","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev-3","depth":3},{"value":"Respuesta","id":"respuesta-3","depth":3},{"value":"Errores comunes","id":"errores-comunes","depth":2},{"value":"Buenas prácticas","id":"buenas-prácticas","depth":2},{"value":"¿Qué sigue?","id":"qué-sigue","depth":2}],"frontmatter":{"title":"Catálogo de productos del comercio","description":"Crear, listar, consultar y actualizar los productos del catálogo de un comercio en QRwey!","seo":{"title":"Catálogo de productos del comercio"}},"lastModified":"2026-06-17T05:34:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/merchant-products","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}