> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yafacture.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener producto



## OpenAPI

````yaml https://rest.yafacture.com/openapi-facturacion.json get /productos/{productoId}
openapi: 3.0.0
info:
  title: Yafacture
  description: Yafacture API
  version: '1.0'
  contact:
    name: Yafacture
    url: https://yafacture.com
    email: hola@yafacture.com
servers:
  - url: https://rest.yafacture.com
security: []
tags: []
paths:
  /productos/{productoId}:
    get:
      tags:
        - Productos
      summary: Obtener producto
      operationId: ProductosController_controllerGetById
      parameters:
        - name: productoId
          required: true
          in: path
          schema:
            type: string
        - name: cols
          required: true
          in: query
          schema:
            type: string
      responses:
        '200':
          description: Producto encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductosDto'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Forbidden resource
                  error:
                    type: string
                    example: Forbidden
                  statusCode:
                    type: integer
                    format: int32
                    example: 403
                required:
                  - message
                  - error
                  - statusCode
      security:
        - x-api-key: []
        - bearer: []
components:
  schemas:
    ProductosDto:
      type: object
      properties:
        _id:
          type: string
          description: Identificador único del producto
        emisorId:
          type: string
          description: Identificador único del producto
        noIdentificacion:
          type: string
          description: SKU (Stock Keeping Unit) del producto
          maxLength: 100
          default: ''
        claveProdServ:
          type: string
          description: Número de identificación del producto
          default: ''
        claveUnidad:
          type: string
          description: Clave de producto o servicio según catálogo del SAT
          default: ''
        descripcion:
          type: string
          description: Clave de unidad de medida según catálogo del SAT
        descuento:
          type: number
          description: Descuento aplicado al producto
          default: 0
          minimum: 0
        precio:
          type: number
          description: Precio unitario del producto
          minimum: 0
        precio2:
          type: number
          description: Precio alternativo 2
          default: 0
          minimum: 0
        precio3:
          type: number
          description: Precio alternativo 3
          default: 0
          minimum: 0
        inventario:
          type: number
          description: Cantidad en inventario
          default: 0
        reservado:
          type: number
          description: Cantidad de inventario reservado
          default: 0
        objetoImp:
          type: string
          description: Objeto de impuesto según catálogo del SAT
          default: '02'
        iva:
          type: string
          enum:
            - noAplica
            - masIva
            - desglosar
            - desglosarIvaDesglosarIsr
            - masIvaFrontera
            - desglosarFrontera
            - exento
            - noAplicaMenosIsr
            - noAplicaDesglosarIsr
            - tasa0
          description: Tasa de IVA aplicada
          default: masIva
        sku:
          type: string
          description: Identificador sku 1 del emisor
          default: ''
          maxLength: 100
        codigoEan:
          type: string
          description: Identificador sku 2 del emisor
          default: ''
          maxLength: 100
        codigoAsin:
          type: string
          description: Identificador sku 3 del emisor
          default: ''
          maxLength: 100
        codigoMl:
          type: string
          description: Identificador sku 3 del emisor
          default: ''
          maxLength: 100
        codigoAmazon:
          type: string
          description: Identificador sku 4 del emisor
          default: ''
          maxLength: 100
        thumbnail:
          type: string
          description: Imagen en miniatura del producto
          default: ''
        imagenes:
          description: Listado de imágenes de producto
          default: []
          type: array
          items:
            type: string
        resumen:
          type: string
          description: Resumen o descripción corta del producto
          default: ''
        atributos:
          description: Atributos adicionales del producto
          default: []
          type: array
          items:
            type: string
        origen:
          type: string
          enum:
            - app
            - api
            - upload
            - download
            - mercadolibre
            - mercadopago
            - autofactura
            - transferencia
          description: Origen del registro (app, api, importación, etc.)
          default: app
        fecha:
          format: date-time
          type: string
          description: Fecha del registro
          default: '2026-05-17T02:51:34.367Z'
        status:
          type: boolean
          description: Estado activo/inactivo del producto
          default: true
      required:
        - _id
        - emisorId
        - noIdentificacion
        - claveProdServ
        - claveUnidad
        - descripcion
        - descuento
        - precio
        - precio2
        - precio3
        - inventario
        - reservado
        - objetoImp
        - iva
        - sku
        - codigoEan
        - codigoAsin
        - codigoMl
        - codigoAmazon
        - thumbnail
        - imagenes
        - resumen
        - atributos
        - origen
        - fecha
        - status
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        X-API-Key authentication header for the development token generated in
        Yafacture
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````