# Criar grupo de itens

Cria um grupo de itens dentro de um projeto.
Para recuperar grupos de itens para a construção de um catálogo, use o ponto de extremidade do lado do cliente Obter lista de grupos de itens.

Endpoint: POST /v2/project/{project_id}/admin/items/groups
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    ID de projeto. Você pode encontrar esse parâmetro na sua Conta de Distribuidor, próximo ao nome do projeto e na barra de endereços do navegador ao trabalhar com um projeto. O URL tem o seguinte formato: https://publisher.xsolla.com//projects/.
    Example: 44056

## Request fields (application/json):

  - `external_id` (string, required)
    ID externo do grupo de itens. Só pode conter caracteres alfanuméricos, hífens e sublinhados.
    Example: "weapons"

  - `name` (object,null, required)
    Objeto com traduções para a descrição do item. Aceita valores em um dos dois formatos: códigos de idioma minúsculos de duas letras (por exemplo, en) ou códigos de localidade de cinco caracteres (por exemplo, en-US). Embora ambos os formatos sejam aceitos, as respostas retornam códigos de idioma minúsculos de duas letras. Quando ambas as opções para o mesmo idioma são fornecidas (por exemplo, en e en-US), o último valor fornecido é armazenado. Você pode encontrar a lista completa de idiomas suportados na [documentação](/pt/doc/shop-builder/references/supported-languages/).

  - `description` (object,null)
    Objeto com traduções para a descrição do item. Aceita valores em um dos dois formatos: códigos de idioma minúsculos de duas letras (por exemplo, en) ou códigos de localidade de cinco caracteres (por exemplo, en-US). Embora ambos os formatos sejam aceitos, as respostas retornam códigos de idioma minúsculos de duas letras. Quando ambas as opções para o mesmo idioma são fornecidas (por exemplo, en e en-US), o último valor fornecido é armazenado. Você pode encontrar a lista completa de idiomas suportados na [documentação](/pt/doc/shop-builder/references/supported-languages/).

  - `iconUrl` (string,null)
    URL da imagem do grupo de itens.

  - `isEnabled` (boolean)
    Se o grupo de itens fica ativado no catálogo.
    Example: true

  - `order` (integer)
    Ordem de exibição do grupo de itens no catálogo. Quanto maior o valor, mais baixa a posição do grupo na lista. Se os valores forem iguais, os grupos serão organizados por data de criação, com os mais novos sendo exibidos mais alto.
    Example: 1

## Response 201 fields (application/json):

  - `external_id` (string)
    ID de grupo de itens externo especificado durante a criação.
    Example: "weapons"

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Status de resposta HTTP.

  - `errorCode` (integer)
    Código de erro.

  - `errorMessage` (string)
    Descrição de erro curta.

  - `transactionId` (string)
    ID de solicitação. O ID usado para rastrear e associar entradas de registros a essa solicitação ou operação específica. Esse ID pode ser útil para encontrar problemas, realizar depurações e auditorias.

## Response 422 fields (application/json):

  - `statusCode` (integer, required)
    Status de resposta HTTP.
    Example: 422

  - `errorCode` (integer, required)
    Código de erro.
    Example: 1102

  - `errorMessage` (string, required)
    Descrição de erro curta.
    Example: "[0401-1102]: Unprocessable Entity. The property `property_name` is required"

  - `transactionId` (string, required)
    ID de solicitação. O ID usado para rastrear e associar entradas de registros a essa solicitação ou operação específica. Esse ID pode ser útil para encontrar problemas, realizar depurações e auditorias.
    Example: "x-x-x-x-transactionId-mock-x-x-x"

  - `errorMessageExtended` (array)
    Dados de erro de validação. Contém uma matriz de erros a nível de propriedade descrevendo quais campos falharam a validação e o porquê.

  - `errorMessageExtended.property` (string)
    Nome do campo que falhou a validação.
    Example: "external_id"

  - `errorMessageExtended.message` (string)
    Mensagem de erro da validação para o campo.
    Example: "The property external_id is required"