# Cria, atualiza e remove itens de um inventário

Cria, atualiza e remove itens de um inventário de um estoque.

Funcionamento:
  1. Se passar um item que está no inventário, ele será removido.
  2. Se não passar um item que não está no inventário, ele será adicionado.
  3. Para remover um atributo de um item, basta preencher o campo removed_inventory_product_attribute_ids
  4. Se adicionar um atributo de um item que não está no produto de um inventário, ele será adicionado.

Endpoint: PUT /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

  - `Idempotency-Key` (string, required)
    UUID aleatório gerado por você. Nós utilizamos esse header para evitar duplicidade de registros, ou seja, caso você não tenha recebido a resposta de alguma requisição e mandar o mesmo UUID, nós não duplicaremos o registro.

## Path parameters:

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

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

## Request fields (application/json):

  - `inventory_items` (array)
    Lista de itens do inventário.

  - `inventory_items.id` (integer)
    Identificador único do item do inventário.
    Example: 123

  - `inventory_items.item` (object)
    Item do inventário.

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

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

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

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

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

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

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

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

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

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

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

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

  - `inventory_items.item.inventory_item_attributes.attributes.option_ids` (array)
    Lista de identificadores únicos das opções.
    Example: [456]

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

  - `inventory_items.removed_inventory_item_attribute_ids` (array)
    Lista de identificadores únicos dos atributos do produto que serão removidos (inventory_item_attributes.*.id).
    Example: [123]

## 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 204 fields

## Response 401 fields

## Response 404 fields