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

# Atualizar níveis de reposição (upsert)

> Insere ou atualiza níveis de reposição em massa.

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

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

<ParamField body="par_levels" type="object[]" required>
  <Expandable title="campos do nível de reposição">
    <ParamField body="item_id" type="string">UUID do item.</ParamField>
    <ParamField body="external_item_id" type="string">ID externo do item.</ParamField>
    <ParamField body="store_id" type="string">UUID do estabelecimento.</ParamField>
    <ParamField body="external_store_id" type="string">ID externo do estabelecimento.</ParamField>
    <ParamField body="supplier_id" type="string">UUID do fornecedor preferido.</ParamField>
    <ParamField body="external_supplier_id" type="string">ID externo do fornecedor.</ParamField>
    <ParamField body="par_quantity" type="number" required>Quantidade alvo de estoque.</ParamField>
    <ParamField body="unit_id" type="string" required>UUID da unidade.</ParamField>
    <ParamField body="reorder_point" type="number">Quantidade mínima antes de repor.</ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "par_levels": [
      {
        "external_item_id": "tomate",
        "external_store_id": "loja-principal",
        "par_quantity": 20,
        "unit_id": "unit_kg_01...",
        "reorder_point": 5
      }
    ]
  }
  ```
</RequestExample>

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