> ## 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 fornecedores (bulk upsert)

> Insere ou atualiza múltiplos fornecedores em uma única chamada.

<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="suppliers" type="object[]" required>
  Array de fornecedores a sincronizar.

  <Expandable title="campos do fornecedor">
    <ParamField body="external_supplier_id" type="string" required>Chave de reconciliação.</ParamField>
    <ParamField body="name" type="string" required>Nome do fornecedor.</ParamField>
    <ParamField body="metadata" type="object">Dados adicionais livres.</ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "suppliers": [
      {
        "external_supplier_id": "fornecedor-fresco",
        "name": "Fornecedor Fresco Ltda."
      }
    ]
  }
  ```
</RequestExample>

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