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

# Criar transferência

> Move itens de um estabelecimento para outro.

<ParamField header="x-api-key" type="string" required>
  API key do BOH com escopo `inventory:write`.
</ParamField>

<ParamField path="vendorId" type="string" required>UUID do vendor.</ParamField>
<ParamField body="from_store_id" type="string">UUID do estabelecimento de origem.</ParamField>
<ParamField body="from_external_store_id" type="string">ID externo do estabelecimento de origem.</ParamField>
<ParamField body="to_store_id" type="string">UUID do estabelecimento de destino.</ParamField>
<ParamField body="to_external_store_id" type="string">ID externo do estabelecimento de destino.</ParamField>
<ParamField body="occurred_at" type="string">Quando ocorreu a transferência (ISO 8601).</ParamField>
<ParamField body="notes" type="string">Notas adicionais.</ParamField>

<ParamField body="lines" type="object[]" required>
  <Expandable title="campos da linha">
    <ParamField body="item_id" type="string">UUID do item.</ParamField>
    <ParamField body="external_item_id" type="string">ID externo do item.</ParamField>
    <ParamField body="quantity" type="number" required>Quantidade transferida.</ParamField>
    <ParamField body="unit_id" type="string" required>UUID da unidade.</ParamField>
  </Expandable>
</ParamField>

<ParamField body="external_user_id" type="string" required>Ator responsável.</ParamField>
<ParamField body="idempotency_key" type="string">Chave de idempotência.</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "from_external_store_id": "cozinha-principal",
    "to_external_store_id": "bar",
    "lines": [
      {
        "external_item_id": "tomate",
        "quantity": 2,
        "unit_id": "unit_kg_01..."
      }
    ],
    "external_user_id": "almoxarife_01"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": "tr_01...",
    "status": "COMPLETED"
  }
  ```
</ResponseExample>