---
title: "Registrar recuento de inventario"
method: POST
path: "/admin/inventory/stores/{storeId}/audits"
---

# Registrar recuento de inventario

`POST /admin/inventory/stores/{storeId}/audits`

## Request

- Base URL: `https://api.service.getjusto.com/v3`
- URL: `https://api.service.getjusto.com/v3/admin/inventory/stores/{storeId}/audits`
- Auth: none declared

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.

## Path parameters

- `storeId` string, required

## Request body

- ApiInventoryAuditInput
  - `comments` string, nullable: Comentarios del recuento.
  - `date` string, date-time, nullable: Fecha del recuento. Si se omite se usa la actual; no se permiten fechas futuras.
  - `stockRoomId` string, nullable, required: ID de bodega de la marca. Se obtiene de GET /admin/inventory/stock-rooms.
  - `ingredientCategoryIds` string[], nullable: Categorías de ingredientes incluidas; IDs de GET /admin/inventory/ingredient-categories.
  - `auditTypeId` string, nullable: ID de tipo de recuento de GET /admin/inventory/stores/{storeId}/audit-types.
  - `auditTypeName` string, nullable: Nombre del tipo de recuento. Cuando se envía auditTypeId, el servicio usa el nombre vigente.
  - `ingredients` object[], required: Lista completa de cantidades contadas. Las cantidades reemplazan las existencias de los ingredientes incluidos; no son incrementos.
    - `ingredientId` string, nullable, required: ID del ingrediente. Se obtiene de GET /admin/inventory/ingredients o GET /tabs/{websiteId}/ingredients.
    - `quantity` number, nullable, required: 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` string, nullable: Nombre del ingrediente; el servicio lo actualiza desde el catálogo.
    - `conversionName` string, nullable: Nombre exacto de una conversión configurada en el ingrediente.
    - `inConversionQuantity` number, nullable: Cantidad en la unidad base, calculada por el servicio como quantity multiplicado por el factor de conversión. No es necesario enviarla.

## Response `200`

The OpenAPI spec

- object
  - `success` boolean
  - `data` object: 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.
    - `_id` string: ID del registro creado, consultado o actualizado.
    - `websiteId` string: Marca propietaria del registro.
    - `storeId` string: Local propietario, para operaciones por local.

## Other responses

- `400`: Errors

## Changes

- **2026-10-31** `4ad06bd631ce`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getjusto/apis/justo-api/changes/admin/inventory/stores/:storeId/audits/post.md)

---

[API](https://skmtc.dev/getjusto/apis/justo-api.md) - [All operations](https://skmtc.dev/getjusto/apis/justo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getjusto/apis/justo-api/revisions/c810bd8246fd?raw)