Crear varias categorías de insumo de una vez

Descripción

Registra hasta 100 categorías de insumo nuevas en una sola llamada.

Detalles

Valida todo el lote antes de guardar: si una sola categoría tiene un problema no se crea ninguna y la respuesta indica la posición y el campo de cada error. El nombre no puede repetirse ni en el catálogo ni dentro del lote. La descripción es opcional. Permite una prueba previa que valida sin guardar nada.

Permisos requeridos

recipes.module

Request

Nombre	Tipo	Requerido	Reglas
dryRun	bool	No	default:0
items	array	Sí	—
items[].ref	string	No	max:60
items[].name	string	Sí	min:2 max:100
items[].description	string	No	max:500

Ejemplo de request

curl -X POST https://restofy.pro/api/inventory-item-categories/create-categories \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "items": [
        {
            "name": "string"
        }
    ]
}'

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-11-02T19:00:57Z

HTTP 200

Request

{
    "items": [
        {
            "name": "Lácteos 6ae8d79f6068b",
            "ref": "lacteos"
        },
        {
            "name": "Lácteos 6ae8d79f6068e",
            "ref": "carnes",
            "description": "Res, cerdo y pollo"
        }
    ]
}

Response

{
    "success": true,
    "message": "Categorías creadas",
    "data": {
        "dryRun": false,
        "items": [
            {
                "index": 0,
                "ref": "lacteos",
                "categoryUuid": "61d4cfc9-683e-41ea-ba47-d3131fa7e769"
            },
            {
                "index": 1,
                "ref": "carnes",
                "categoryUuid": "ad3a9f28-fbc5-4c3f-a247-b9ff65622e94"
            }
        ]
    }
}

HTTP 400

Request

{
    "items": [
        {
            "name": "Verduras 0 6ae8d7a108926"
        },
        {
            "name": "Verduras 1 6ae8d7a10892a"
        },
        {
            "name": "Verduras 2 6ae8d7a10892c"
        },
        {
            "name": "Verduras 3 6ae8d7a10892e"
        },
        {
            "name": "Verduras 4 6ae8d7a108930"
        },
        {
            "name": "Verduras 5 6ae8d7a108932"
        },
        {
            "name": "Verduras 6 6ae8d7a108934"
        },
        {
            "name": "Verduras 7 6ae8d7a108936"
        },
        {
            "name": "Verduras 8 6ae8d7a108938"
        },
        {
            "name": "Verduras 9 6ae8d7a10893a"
        },
        {
            "name": "Verduras 10 6ae8d7a10893c"
        },
        {
            "name": "Verduras 11 6ae8d7a10893e"
        },
        {
            "name": "Verduras 12 6ae8d7a108940"
        },
        {
            "name": "Verduras 13 6ae8d7a108942"
        },
        {
            "name": "Verduras 14 6ae8d7a108944"
        },
        {
            "name": "Verduras 15 6ae8d7a108946"
        },
        {
            "name": "Verduras 16 6ae8d7a108948"
        },
        {
            "name": "Verduras 17 6ae8d7a10894a"
        },
        {
            "name": "Verduras 18 6ae8d7a10894c"
        },
        {
            "name": "Verduras 19 6ae8d7a10894e"
        },
        {
            "name": "Verduras 20 6ae8d7a108950"
        },
        {
            "name": "Verduras 21 6ae8d7a108952"
        },
        {
            "name": "Verduras 22 6ae8d7a108954"
        },
        {
            "name": "Verduras 23 6ae8d7a108956"
        },
        {
            "name": "Verduras 24 6ae8d7a108958"
        },
        {
            "name": "Verduras 25 6ae8d7a10895a"
        },
        {
            "name": "Verduras 26 6ae8d7a108997"
        },
        {
            "name": "Verduras 27 6ae8d7a108999"
        },
        {
            "name": "Verduras 28 6ae8d7a10899b"
        },
        {
            "name": "Verduras 29 6ae8d7a10899d"
        },
        {
            "name": "Verduras 30 6ae8d7a10899f"
        },
        {
            "name": "Verduras 31 6ae8d7a1089a1"
        },
        {
            "name": "Verduras 32 6ae8d7a1089a3"
        },
        {
            "name": "Verduras 33 6ae8d7a1089a5"
        },
        {
            "name": "Verduras 34 6ae8d7a1089a7"
        },
        {
            "name": "Verduras 35 6ae8d7a1089a9"
        },
        {
            "name": "Verduras 36 6ae8d7a1089ab"
        },
        {
            "name": "Verduras 37 6ae8d7a108a37"
        },
        {
            "name": "Verduras 38 6ae8d7a108a3b"
        },
        {
            "name": "Verduras 39 6ae8d7a108a3d"
        },
        {
            "name": "Verduras 40 6ae8d7a108a3f"
        },
        {
            "name": "Verduras 41 6ae8d7a108a41"
        },
        {
            "name": "Verduras 42 6ae8d7a108a43"
        },
        {
            "name": "Verduras 43 6ae8d7a108a45"
        },
        {
            "name": "Verduras 44 6ae8d7a108a47"
        },
        {
            "name": "Verduras 45 6ae8d7a108a49"
        },
        {
            "name": "Verduras 46 6ae8d7a108a4b"
        },
        {
            "name": "Verduras 47 6ae8d7a108a4d"
        },
        {
            "name": "Verduras 48 6ae8d7a108a4f"
        },
        {
            "name": "Verduras 49 6ae8d7a108a51"
        },
        {
            "name": "Verduras 50 6ae8d7a108a53"
        },
        {
            "name": "Verduras 51 6ae8d7a108a55"
        },
        {
            "name": "Verduras 52 6ae8d7a108a57"
        },
        {
            "name": "Verduras 53 6ae8d7a108a59"
        },
        {
            "name": "Verduras 54 6ae8d7a108a5b"
        },
        {
            "name": "Verduras 55 6ae8d7a108a5d"
        },
        {
            "name": "Verduras 56 6ae8d7a108af0"
        },
        {
            "name": "Verduras 57 6ae8d7a108af7"
        },
        {
            "name": "Verduras 58 6ae8d7a108af9"
        },
        {
            "name": "Verduras 59 6ae8d7a108afb"
        },
        {
            "name": "Verduras 60 6ae8d7a108afd"
        },
        {
            "name": "Verduras 61 6ae8d7a108aff"
        },
        {
            "name": "Verduras 62 6ae8d7a108b01"
        },
        {
            "name": "Verduras 63 6ae8d7a108b03"
        },
        {
            "name": "Verduras 64 6ae8d7a108b05"
        },
        {
            "name": "Verduras 65 6ae8d7a108b8d"
        },
        {
            "name": "Verduras 66 6ae8d7a108b8f"
        },
        {
            "name": "Verduras 67 6ae8d7a108b91"
        },
        {
            "name": "Verduras 68 6ae8d7a108b93"
        },
        {
            "name": "Verduras 69 6ae8d7a108b95"
        },
        {
            "name": "Verduras 70 6ae8d7a108b97"
        },
        {
            "name": "Verduras 71 6ae8d7a108b99"
        },
        {
            "name": "Verduras 72 6ae8d7a108b9b"
        },
        {
            "name": "Verduras 73 6ae8d7a108b9d"
        },
        {
            "name": "Verduras 74 6ae8d7a108b9f"
        },
        {
            "name": "Verduras 75 6ae8d7a108ba1"
        },
        {
            "name": "Verduras 76 6ae8d7a108ba3"
        },
        {
            "name": "Verduras 77 6ae8d7a108ba5"
        },
        {
            "name": "Verduras 78 6ae8d7a108bdf"
        },
        {
            "name": "Verduras 79 6ae8d7a108be7"
        },
        {
            "name": "Verduras 80 6ae8d7a108be9"
        },
        {
            "name": "Verduras 81 6ae8d7a108beb"
        },
        {
            "name": "Verduras 82 6ae8d7a108bed"
        },
        {
            "name": "Verduras 83 6ae8d7a108bef"
        },
        {
            "name": "Verduras 84 6ae8d7a108bf1"
        },
        {
            "name": "Verduras 85 6ae8d7a108bf3"
        },
        {
            "name": "Verduras 86 6ae8d7a108bf5"
        },
        {
            "name": "Verduras 87 6ae8d7a108bf7"
        },
        {
            "name": "Verduras 88 6ae8d7a108bf9"
        },
        {
            "name": "Verduras 89 6ae8d7a108bfb"
        },
        {
            "name": "Verduras 90 6ae8d7a108bfd"
        },
        {
            "name": "Verduras 91 6ae8d7a108bff"
        },
        {
            "name": "Verduras 92 6ae8d7a108c01"
        },
        {
            "name": "Verduras 93 6ae8d7a108c03"
        },
        {
            "name": "Verduras 94 6ae8d7a108c05"
        },
        {
            "name": "Verduras 95 6ae8d7a108c07"
        },
        {
            "name": "Verduras 96 6ae8d7a108c09"
        },
        {
            "name": "Verduras 97 6ae8d7a108c0b"
        },
        {
            "name": "Verduras 98 6ae8d7a108c0d"
        },
        {
            "name": "Verduras 99 6ae8d7a108c0f"
        },
        {
            "name": "Verduras 100 6ae8d7a108c11"
        }
    ]
}

Response

{
    "success": false,
    "message": "El campo items no puede tener mas de 100 elementos.",
    "data": []
}