# Lista os itens de um inventário

Lista os itens de um inventário de um estoque.

Endpoint: GET /api/v3/stocks/{stockId}/inventories/{inventoryId}/items
Version: 3.0.0
Security: OAuth2

## Header parameters:

  - `CPlug-Company-Id` (number, required)
    Id da Empresa (Company).

Você pode localizar os IDs das empresas no _endpoint_ de listagem de empresas.
    Example: 12

## Path parameters:

  - `stockId` (integer, required)
    ID do estoque.
    Example: 1

  - `inventoryId` (integer, required)
    ID do inventário.
    Example: 1

## Query parameters:

  - `item_ids` (string)
    Filtra pelos IDs dos produtos. Pode passar mais de um ID numérico separado por virgula.
    Example: "1,2,3"

  - `inventory_item_ids` (string)
    Filtra pelos IDs dos inventários de produto. Pode passar mais de um ID numérico separado por virgula.
    Example: "10,20,30"

  - `page` (number)
    Indica a página da paginação.

  - `per_page` (number)
    Indica a quantidade de itens por página.

## Response 200 fields (application/json):

  - `data` (object)

  - `data.inventory_items` (array)
    Representa a lista dos itens do inventário do estoque.

  - `data.inventory_items.id` (integer)
    Identificador único do item do inventário de estoque na CPlug.
    Example: 1

  - `data.inventory_items.item` (object)
    Representa um Produto.

  - `data.inventory_items.item.id` (integer)
    Identificador único do produto.
    Example: 123

  - `data.inventory_items.item.name` (string)
    Nome do produto.
    Example: "Nome do produto"

  - `data.inventory_items.item.sku` (string)
    Código SKU do produto. 

Esse código deve ser único.

Exemplo: COD-CP-01
    Example: "COD-CP-01"

  - `data.inventory_items.item.unit_of_measure` (object)
    Unidade de medida do produto.

  - `data.inventory_items.item.unit_of_measure.id` (integer)
    Identificador único da unidade de medida.
    Example: 1

  - `data.inventory_items.item.unit_of_measure.name` (string)
    Nome da unidade de medida, exemplo "quilos".
    Example: "Kilos"

  - `data.inventory_items.item.unit_of_measure.abbreviation` (string)
    A abreviatura da unidade, exemplo "kg".
    Example: "kg"

  - `data.inventory_items.item.unit_of_measure.precision` (integer)
    Um número inteiro entre 0 e 6 que representa o número máximo de posições permitidas após o decimal em quantidades medidas com esta unidade.
Por exemplo:
  - se a precisão for 0, a quantidade pode ser 1, 2, 3, etc.
  - se a precisão for 1, a quantidade pode ser 0.1, 0.2, 0.3, etc.
  - se a precisão for 2, a quantidade pode ser 0.01, 0.02, 0.03, etc.
    Example: 1

  - `data.inventory_items.item.inventory_item_attributes` (array)
    Lista de atributos do produto com informações de estoque.

  - `data.inventory_items.item.inventory_item_attributes.id` (integer)
    Identificador único do atributo de um produto com informações de estoque.
    Example: 123

  - `data.inventory_items.item.inventory_item_attributes.attributes` (object)
    Lista de atributos do produto.

  - `data.inventory_items.item.inventory_item_attributes.attributes.id` (integer)
    Identificador único do atributo.
    Example: 123

  - `data.inventory_items.item.inventory_item_attributes.attributes.name` (string)
    Nome do atributo.
    Example: "Nome do atributo"

  - `data.inventory_items.item.inventory_item_attributes.attributes.options` (array)
    Lista de opções do atributo.

  - `data.inventory_items.item.inventory_item_attributes.attributes.options.id` (integer)
    Identificador único da opção.
    Example: 123

  - `data.inventory_items.item.inventory_item_attributes.attributes.options.name` (string)
    Nome da opção.
    Example: "Nome da opção"

  - `data.inventory_items.item.inventory_item_attributes.stock` (object)
    Informações do estoque.

  - `data.inventory_items.item.inventory_item_attributes.stock.unitary_cost` (object)
    Custo unitário do produto

  - `data.inventory_items.item.inventory_item_attributes.stock.unitary_cost.amount` (number, required)
    Valor expresso como um número decimal das principais unidades monetárias
    Example: 99.95

  - `data.inventory_items.item.inventory_item_attributes.stock.unitary_cost.currency` (string, required)
    Código de moeda de 3 letras conforme definido pela ISO-4217
    Example: "BRL"

  - `data.inventory_items.item.inventory_item_attributes.stock.previous_amount` (number,null)
    Quantidade anterior do produto.
    Example: 1

  - `data.inventory_items.item.inventory_item_attributes.stock.new_amount` (number,null)
    Nova quantidade do produto.
    Example: 10

  - `data.inventory_items.item.inventory_item_attributes.stock.can_replace_cost` (boolean)
    Se o custo unitário pode ser substituído.
    Example: true

  - `data.inventory_items.item.inventory_item_attributes.stock.balance` (object,null)
    Saldo do produto

  - `data.inventory_items.item.inventory_item_attributes.stock.balance.amount` (number)
    Saldo do produto.
    Example: 10

  - `data.inventory_items.item.inventory_item_attributes.stock.balance.type` (string,null)
    Se o saldo é positivo ou negativo.
    Enum: "positive", "negative"

  - `data.inventory_items.item.stock` (object)
    Informações do estoque do produto.

  - `data.inventory_items.created_at` (string)
    Data da criação do item do inventário de estoque.
    Example: "2020-01-01T09:00:00-03:00"

  - `data.inventory_items.updated_at` (string)
    Data da atualização do item do inventário de estoque.
    Example: "2020-01-01T09:00:00-03:00"

  - `meta` (object)
    Representa as informações de Metadado da paginação da listagem.

  - `meta.current_page` (integer, required)
    Página atual na paginação.
    Example: 1

  - `meta.last_page` (integer, required)
    Quantidade total de páginas.
    Example: 10

  - `meta.per_page` (integer, required)
    Quantidade de resultados por página.
    Example: 20

  - `meta.total` (integer, required)
    Quantidade total de itens.
    Example: 200

## Response 400 fields (application/json):

  - `code` (string, required)
    Código de erro.
    Example: "missing_headers"

  - `message` (string)
    Descrição do erro.
    Example: "error message"

  - `meta` (array)
    Dados adicionais sobre o erro.

## Response 422 fields (application/json):

  - `code` (string, required)
    Código de erro.
    Example: "uneditable_entity"

  - `message` (string)
    Descrição do erro.
    Example: "description error"

  - `meta` (array)
    Dados adicionais sobre o erro.

  - `meta.field` (string, required)
    Nome do campo no qual existe um erro de validação.
    Example: "name"

  - `meta.validations` (array)

  - `meta.validations.type` (string, required)
    Tipo da validação aplicada.
    Example: "Required"

  - `meta.validations.value` (array)
    Tipo de valor aplicável (esse campo pode ser vazio).


## Response 401 fields

## Response 404 fields