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

# Registrar recuento de inventario

> Registra las existencias contadas por ingrediente y bodega. Las cantidades son existencias finales, no incrementos. Conserva el recálculo histórico y generación de informe del flujo actual. Los recuentos existentes se listan en GET /tabs/{storeId}/audits. Requiere autorización admin y un usuario conectado; un token de integración sin usuario responde userRequired. Se aplican los mismos permisos y validaciones del formulario de inventario.



## OpenAPI

````yaml post /admin/inventory/stores/{storeId}/audits
openapi: 3.1.0
info:
  title: Justo API
  version: 3.0.0
servers:
  - url: https://api.service.getjusto.com/v3
    description: Production server
security: []
paths:
  /admin/inventory/stores/{storeId}/audits:
    post:
      summary: Registrar recuento de inventario
      description: >-
        Registra las existencias contadas por ingrediente y bodega. Las
        cantidades son existencias finales, no incrementos. Conserva el
        recálculo histórico y generación de informe del flujo actual. Los
        recuentos existentes se listan en GET /tabs/{storeId}/audits. Requiere
        autorización admin y un usuario conectado; un token de integración sin
        usuario responde userRequired. Se aplican los mismos permisos y
        validaciones del formulario de inventario.
      parameters:
        - in: path
          name: storeId
          required: true
          schema:
            type: string
          description: ID del local autorizado, obtenido de GET /ecommerce/stores.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/apiInventoryAuditInput'
      responses:
        '200':
          description: The OpenAPI spec
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      _id:
                        type: string
                        description: ID del registro creado, consultado o actualizado.
                      websiteId:
                        type: string
                        description: Marca propietaria del registro.
                      storeId:
                        type: string
                        description: Local propietario, para operaciones por local.
                    description: >-
                      Registro de inventario con los campos de su operación,
                      como estado, ingredientes, cantidades y costos. Las fechas
                      se devuelven en el formato del servicio Tabs.
        '400':
          description: Errors
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: 'false'
                  error:
                    type: object
                    properties:
                      error:
                        type: string
                        example: error
                      message:
                        type: string
                        example: The request has an error
components:
  schemas:
    apiInventoryAuditInput:
      type: object
      additionalProperties: false
      properties:
        comments:
          type:
            - string
            - 'null'
          description: Comentarios del recuento.
        date:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Fecha del recuento. Si se omite se usa la actual; no se permiten
            fechas futuras.
        stockRoomId:
          type:
            - string
            - 'null'
          description: >-
            ID de bodega de la marca. Se obtiene de GET
            /admin/inventory/stock-rooms.
        ingredientCategoryIds:
          type:
            - array
            - 'null'
          items:
            type: string
          description: >-
            Categorías de ingredientes incluidas; IDs de GET
            /admin/inventory/ingredient-categories.
        auditTypeId:
          type:
            - string
            - 'null'
          description: >-
            ID de tipo de recuento de GET
            /admin/inventory/stores/{storeId}/audit-types.
        auditTypeName:
          type:
            - string
            - 'null'
          description: >-
            Nombre del tipo de recuento. Cuando se envía auditTypeId, el
            servicio usa el nombre vigente.
        ingredients:
          type: array
          items:
            type: object
            additionalProperties: false
            properties:
              ingredientId:
                type:
                  - string
                  - 'null'
                description: >-
                  ID del ingrediente. Se obtiene de GET
                  /admin/inventory/ingredients o GET
                  /tabs/{websiteId}/ingredients.
              quantity:
                type:
                  - number
                  - 'null'
                description: >-
                  Cantidad en la conversión elegida; sin conversionName, en la
                  unidad base. Si el ingrediente se mide en kg y la conversión
                  "saco de 25 kg" tiene factor 25, envía quantity: 2 para
                  registrar 50 kg. No envíes 50 con esa conversión.
              ingredientName:
                type:
                  - string
                  - 'null'
                description: >-
                  Nombre del ingrediente; el servicio lo actualiza desde el
                  catálogo.
              conversionName:
                type:
                  - string
                  - 'null'
                description: Nombre exacto de una conversión configurada en el ingrediente.
              inConversionQuantity:
                type:
                  - number
                  - 'null'
                description: >-
                  Cantidad en la unidad base, calculada por el servicio como
                  quantity multiplicado por el factor de conversión. No es
                  necesario enviarla.
            required:
              - ingredientId
              - quantity
          description: >-
            Lista completa de cantidades contadas. Las cantidades reemplazan las
            existencias de los ingredientes incluidos; no son incrementos.
      required:
        - stockRoomId
        - ingredients
      example:
        stockRoomId: ti-str-ejemplo
        ingredients:
          - ingredientId: ti-ing-ejemplo
            quantity: 2
            conversionName: saco de 25 kg
        comments: Recuento de cierre

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.