> ## 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.

# Sincronizar itens (bulk upsert)

> Insere ou atualiza múltiplos itens em uma única chamada. A reconciliação é feita por `external_item_id`.

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

<ParamField path="vendorId" type="string" required>UUID do vendor.</ParamField>

<ParamField body="items" type="object[]" required>
  Array de itens a sincronizar (máx. 200 por chamada).

  <Expandable title="campos do item">
    <ParamField body="external_item_id" type="string" required>Chave de reconciliação.</ParamField>
    <ParamField body="name" type="string" required>Nome do item.</ParamField>
    <ParamField body="base_unit_id" type="string" required>UUID da unidade de medida base.</ParamField>
    <ParamField body="unit_group_id" type="string" required>UUID do grupo de unidades.</ParamField>
    <ParamField body="metadata" type="object">Dados adicionais livres.</ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "items": [
      {
        "external_item_id": "tomate",
        "name": "Tomate",
        "base_unit_id": "unit_kg_01...",
        "unit_group_id": "ug_peso_01..."
      }
    ]
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "synced": 1,
    "created": 1,
    "updated": 0
  }
  ```
</ResponseExample>