> ## 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 Transferência de Estoque

> Desconta o estoque físico de um depósito base e transfere logicamente para outro depósito.

### Body

<ParamField body="fromWarehouseId" type="string" required>Obrigatório - Origem.</ParamField>
<ParamField body="toWarehouseId" type="string" required>Obrigatório - Destino.</ParamField>
<ParamField body="notes" type="string">Observações logísticas.</ParamField>

<ParamField body="items" type="array" required>
  <Expandable>
    <ParamField body="productId" type="string" required>ID do produto</ParamField>
    <ParamField body="quantity" type="number" required>Qtde a ser remetida/transferida</ParamField>
  </Expandable>
</ParamField>

### Response

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "2d9b68a1-ce29-4786-9ac0-1a6f8b5f3a11",
    "status": "COMPLETED",
    "message": "Transferência realizada com sucesso"
  }
  ```
</ResponseExample>


## OpenAPI

````yaml post /inventory/transfers
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/transfers:
    post:
      tags:
        - Stock Transfers
      summary: Criar transferência de estoque entre depósitos
      operationId: StockTransferController_create
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateStockTransferDto'
      responses:
        '201':
          description: Transferência realizada com sucesso
        '400':
          description: Estoque insuficiente ou depósitos inválidos
        '404':
          description: Produto ou depósito não encontrado
      security:
        - bearer: []
components:
  schemas:
    CreateStockTransferDto:
      type: object
      properties:
        productId:
          type: string
          description: ID do produto
        fromWarehouseId:
          type: string
          description: ID do depósito de origem
        toWarehouseId:
          type: string
          description: ID do depósito de destino
        quantity:
          type: number
          description: Quantidade a transferir
        notes:
          type: string
          description: Observações
      required:
        - productId
        - fromWarehouseId
        - toWarehouseId
        - quantity

````