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

catalog.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-10-09T02:12:12Z

HTTP 200

Request

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

Response

{
    "success": true,
    "message": "Categorías creadas",
    "data": {
        "dryRun": false,
        "items": [
            {
                "index": 0,
                "ref": "lacteos",
                "categoryUuid": "3398a9e1-b8f5-4b10-8c65-0026553f0ae8"
            },
            {
                "index": 1,
                "ref": "carnes",
                "categoryUuid": "71ecffd8-5582-43d0-9f67-0eb5afcbda44"
            }
        ]
    }
}

HTTP 400

Request

{
    "items": [
        {
            "name": "Verduras 0 6ac84d360b99c"
        },
        {
            "name": "Verduras 1 6ac84d360b99f"
        },
        {
            "name": "Verduras 2 6ac84d360b9a1"
        },
        {
            "name": "Verduras 3 6ac84d360b9a3"
        },
        {
            "name": "Verduras 4 6ac84d360b9a5"
        },
        {
            "name": "Verduras 5 6ac84d360b9a7"
        },
        {
            "name": "Verduras 6 6ac84d360b9a9"
        },
        {
            "name": "Verduras 7 6ac84d360b9ab"
        },
        {
            "name": "Verduras 8 6ac84d360b9ad"
        },
        {
            "name": "Verduras 9 6ac84d360b9af"
        },
        {
            "name": "Verduras 10 6ac84d360b9b1"
        },
        {
            "name": "Verduras 11 6ac84d360b9b3"
        },
        {
            "name": "Verduras 12 6ac84d360b9b5"
        },
        {
            "name": "Verduras 13 6ac84d360b9b7"
        },
        {
            "name": "Verduras 14 6ac84d360b9b9"
        },
        {
            "name": "Verduras 15 6ac84d360b9bb"
        },
        {
            "name": "Verduras 16 6ac84d360b9bd"
        },
        {
            "name": "Verduras 17 6ac84d360b9bf"
        },
        {
            "name": "Verduras 18 6ac84d360b9c1"
        },
        {
            "name": "Verduras 19 6ac84d360b9c3"
        },
        {
            "name": "Verduras 20 6ac84d360b9c5"
        },
        {
            "name": "Verduras 21 6ac84d360b9c7"
        },
        {
            "name": "Verduras 22 6ac84d360b9c9"
        },
        {
            "name": "Verduras 23 6ac84d360b9cb"
        },
        {
            "name": "Verduras 24 6ac84d360b9cd"
        },
        {
            "name": "Verduras 25 6ac84d360b9cf"
        },
        {
            "name": "Verduras 26 6ac84d360b9d1"
        },
        {
            "name": "Verduras 27 6ac84d360b9d3"
        },
        {
            "name": "Verduras 28 6ac84d360b9d5"
        },
        {
            "name": "Verduras 29 6ac84d360b9d7"
        },
        {
            "name": "Verduras 30 6ac84d360b9d9"
        },
        {
            "name": "Verduras 31 6ac84d360b9db"
        },
        {
            "name": "Verduras 32 6ac84d360b9dd"
        },
        {
            "name": "Verduras 33 6ac84d360b9df"
        },
        {
            "name": "Verduras 34 6ac84d360b9e1"
        },
        {
            "name": "Verduras 35 6ac84d360b9e3"
        },
        {
            "name": "Verduras 36 6ac84d360b9e5"
        },
        {
            "name": "Verduras 37 6ac84d360b9e7"
        },
        {
            "name": "Verduras 38 6ac84d360b9e9"
        },
        {
            "name": "Verduras 39 6ac84d360b9eb"
        },
        {
            "name": "Verduras 40 6ac84d360b9ed"
        },
        {
            "name": "Verduras 41 6ac84d360b9ef"
        },
        {
            "name": "Verduras 42 6ac84d360b9f1"
        },
        {
            "name": "Verduras 43 6ac84d360b9f3"
        },
        {
            "name": "Verduras 44 6ac84d360b9f5"
        },
        {
            "name": "Verduras 45 6ac84d360b9f7"
        },
        {
            "name": "Verduras 46 6ac84d360b9f9"
        },
        {
            "name": "Verduras 47 6ac84d360b9fb"
        },
        {
            "name": "Verduras 48 6ac84d360b9fd"
        },
        {
            "name": "Verduras 49 6ac84d360b9ff"
        },
        {
            "name": "Verduras 50 6ac84d360ba01"
        },
        {
            "name": "Verduras 51 6ac84d360ba03"
        },
        {
            "name": "Verduras 52 6ac84d360ba05"
        },
        {
            "name": "Verduras 53 6ac84d360ba07"
        },
        {
            "name": "Verduras 54 6ac84d360ba09"
        },
        {
            "name": "Verduras 55 6ac84d360ba0b"
        },
        {
            "name": "Verduras 56 6ac84d360ba0d"
        },
        {
            "name": "Verduras 57 6ac84d360ba0f"
        },
        {
            "name": "Verduras 58 6ac84d360ba11"
        },
        {
            "name": "Verduras 59 6ac84d360ba13"
        },
        {
            "name": "Verduras 60 6ac84d360ba15"
        },
        {
            "name": "Verduras 61 6ac84d360ba17"
        },
        {
            "name": "Verduras 62 6ac84d360ba19"
        },
        {
            "name": "Verduras 63 6ac84d360ba1b"
        },
        {
            "name": "Verduras 64 6ac84d360ba1d"
        },
        {
            "name": "Verduras 65 6ac84d360ba1f"
        },
        {
            "name": "Verduras 66 6ac84d360ba21"
        },
        {
            "name": "Verduras 67 6ac84d360ba23"
        },
        {
            "name": "Verduras 68 6ac84d360ba25"
        },
        {
            "name": "Verduras 69 6ac84d360ba27"
        },
        {
            "name": "Verduras 70 6ac84d360ba29"
        },
        {
            "name": "Verduras 71 6ac84d360ba2b"
        },
        {
            "name": "Verduras 72 6ac84d360ba2d"
        },
        {
            "name": "Verduras 73 6ac84d360ba2f"
        },
        {
            "name": "Verduras 74 6ac84d360ba31"
        },
        {
            "name": "Verduras 75 6ac84d360ba33"
        },
        {
            "name": "Verduras 76 6ac84d360ba35"
        },
        {
            "name": "Verduras 77 6ac84d360ba37"
        },
        {
            "name": "Verduras 78 6ac84d360ba39"
        },
        {
            "name": "Verduras 79 6ac84d360ba3b"
        },
        {
            "name": "Verduras 80 6ac84d360ba3d"
        },
        {
            "name": "Verduras 81 6ac84d360ba3f"
        },
        {
            "name": "Verduras 82 6ac84d360ba41"
        },
        {
            "name": "Verduras 83 6ac84d360ba43"
        },
        {
            "name": "Verduras 84 6ac84d360ba45"
        },
        {
            "name": "Verduras 85 6ac84d360ba47"
        },
        {
            "name": "Verduras 86 6ac84d360ba49"
        },
        {
            "name": "Verduras 87 6ac84d360ba4b"
        },
        {
            "name": "Verduras 88 6ac84d360ba4d"
        },
        {
            "name": "Verduras 89 6ac84d360ba4f"
        },
        {
            "name": "Verduras 90 6ac84d360ba51"
        },
        {
            "name": "Verduras 91 6ac84d360ba53"
        },
        {
            "name": "Verduras 92 6ac84d360ba55"
        },
        {
            "name": "Verduras 93 6ac84d360ba57"
        },
        {
            "name": "Verduras 94 6ac84d360ba59"
        },
        {
            "name": "Verduras 95 6ac84d360ba5b"
        },
        {
            "name": "Verduras 96 6ac84d360ba5d"
        },
        {
            "name": "Verduras 97 6ac84d360ba5f"
        },
        {
            "name": "Verduras 98 6ac84d360ba61"
        },
        {
            "name": "Verduras 99 6ac84d360ba63"
        },
        {
            "name": "Verduras 100 6ac84d360ba65"
        }
    ]
}

Response

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