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

# Obter pedido sugerido

> Gera uma sugestão de pedido com base nos níveis de reposição e estoque atual.

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

<ParamField path="vendorId" type="string" required>UUID do vendor.</ParamField>
<ParamField query="store_id" type="string">Filtrar por estabelecimento.</ParamField>
<ParamField query="supplier_id" type="string">Filtrar por fornecedor.</ParamField>

<ResponseField name="lines" type="object[]">Linhas sugeridas com item, quantidade sugerida e fornecedor.</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "lines": [
      {
        "item_id": "itm_01...",
        "item_name": "Tomate",
        "supplier_id": "sup_01...",
        "current_stock": 3.5,
        "reorder_point": 5,
        "par_quantity": 20,
        "suggested_quantity": 16.5,
        "unit_id": "unit_kg_01..."
      }
    ]
  }
  ```
</ResponseExample>