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

# Registrar Balanço de Contagem

> Sobrescreve a quantidade física do produto após um evento fiscal ou auditoria in-loco. O sistema computará as diferenças como correções (+ ou -) no ledger do inventário.

### Path

<ParamField path="productId" type="string" required>UUID do item auditado.</ParamField>

### Body

<ParamField body="warehouseId" type="string" required>Galpão referente ao balanço.</ParamField>
<ParamField body="countedQuantity" type="number" required>O total físico exato reportado manual/lido. A aplicação tratará a matemática (old\_qtd - counted\_qtd = diff).</ParamField>
<ParamField body="notes" type="string">Súmula explicativa do inventariante.</ParamField>

### Response

<ResponseExample>
  ```json Response theme={null}
  {
    "message": "Balanço registrado com sucesso"
  }
  ```
</ResponseExample>


## OpenAPI

````yaml post /inventory/product/{productId}/count
openapi: 3.0.0
info:
  title: Hub Marketplace API
  description: API for managing marketplace listings and keys
  version: '1.0'
  contact: {}
servers: []
security: []
tags:
  - name: listings
    description: ''
paths:
  /inventory/product/{productId}/count:
    post:
      tags:
        - Inventory
      summary: Registrar balanço físico (Inventory Count)
      operationId: InventoryController_registerPhysicalCount
      parameters:
        - name: productId
          required: true
          in: path
          schema:
            type: string
      responses:
        '201':
          description: Balanço registrado com sucesso
      security:
        - bearer: []
components: {}

````