---
title: "Registrar merma"
method: POST
path: "/admin/inventory/stores/{storeId}/waste-incidents"
---

# Registrar merma

`POST /admin/inventory/stores/{storeId}/waste-incidents`

## Request

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

Descuenta ingredientes o componentes de recetas, calcula costos y registra al usuario que realiza la operación. Requiere ambas listas completas; usa [] para la lista sin elementos. Las mermas existentes se listan en GET /tabs/{storeId}/waste-incidents. 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

- ApiInventoryWasteInput
  - `comments` string, nullable: Comentarios de la merma.
  - `categoryId` string, nullable: Categoría obtenida de GET /admin/inventory/waste-categories.
  - `issueDate` string, date-time, nullable: Fecha de emisión. Si se omite al crear, se usa la fecha actual.
  - `ingredients` object[], required: Lista completa de ingredientes desperdiciados. Usa [] si solo hay recetas.
    - `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.
    - `stockRoomId` string, nullable: ID de bodega de la marca. Se obtiene de GET /admin/inventory/stock-rooms.
    - `unitCost` number, nullable: Costo unitario; el servicio calcula el costo vigente.
    - `totalCost` number, nullable: Costo total; el servicio calcula el costo vigente.
  - `recipes` object[], required: Lista completa de recetas desperdiciadas. Usa [] si solo hay ingredientes.
    - `recipeId` string, nullable, required: ID de receta obtenido de GET /tabs/{websiteId}/recipes.
    - `quantity` number, nullable, required: Cantidad desperdiciada de la receta.
    - `recipeName` string, nullable: Nombre de la receta; el servicio lo actualiza.
    - `unitCost` number, nullable: Costo unitario; el servicio lo calcula.
    - `totalCost` number, nullable: Costo total; el servicio lo calcula.

## 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/waste-incidents/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)