> ## Documentation Index
> Fetch the complete documentation index at: https://docs.domsoftware.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar Entrada Manual

> Injeta saldo de produtos rapidamente dentro de um depósito específico e insere a nota da origem dessa entrada.

### Body

<ParamField body="warehouseId" type="string" required>ID do Depósito centralizador</ParamField>
<ParamField body="notes" type="string">Nota descrevendo o motivo da entrada</ParamField>

<ParamField body="items" type="array" required>
  Lista dos produtos recebidos:

  <Expandable>
    <ParamField body="productId" type="string" required>UUID do produto</ParamField>
    <ParamField body="quantity" type="number" required>Saldo a somar</ParamField>
    <ParamField body="unitCost" type="number">Preço de custo para revaloração (opcional)</ParamField>
  </Expandable>
</ParamField>

### Response

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "e4b6d4e8-8e6d-41da-abdb-8fc358a9e7f1",
    "message": "Entrada criada e estoque atualizado."
  }
  ```
</ResponseExample>


## OpenAPI

````yaml post /inventory/entries/manual
openapi: 3.0.0
info:
  title: Hub Marketplace API
  description: API for managing marketplace listings and keys
  version: '1.0'
  contact: {}
servers: []
security: []
tags:
  - name: listings
    description: ''
paths:
  /inventory/entries/manual:
    post:
      tags:
        - Inventory Entries
      summary: Entrada manual de estoque
      operationId: InventoryEntryController_createManualEntry
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateManualEntryDto'
      responses:
        '201':
          description: Entrada criada e estoque atualizado
        '400':
          description: Dados inválidos
        '404':
          description: Produto ou depósito não encontrado
      security:
        - bearer: []
components:
  schemas:
    CreateManualEntryDto:
      type: object
      properties:
        productId:
          type: string
          description: ID do produto
        warehouseId:
          type: string
          description: ID do depósito destino
        quantity:
          type: number
          description: Quantidade a ser adicionada
        unitGrossPrice:
          type: number
          description: Preço bruto unitário
        discount:
          type: number
          description: Desconto total
        freight:
          type: number
          description: Frete total
        insurance:
          type: number
          description: Seguro total
        otherExpenses:
          type: number
          description: Outras despesas
        supplierId:
          type: string
          description: ID do fornecedor
        companyId:
          type: string
          description: ID da empresa (CNPJ)
        notes:
          type: string
          description: Observações
      required:
        - productId
        - warehouseId
        - quantity
        - unitGrossPrice

````