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

# Preview a stock count

> Takes the body of `POST /stocks/count` without `notes` and returns, per item, the system quantity, the counted
quantity converted to the product's base unit and the difference the count would record. Nothing is written.
Items without any quantity field are skipped, as the count skips them.



## OpenAPI

````yaml post /v1/stocks/count/preview
openapi: 3.1.0
info:
  title: Flextell API
  version: 0.0.1
  description: >-
    Flextell REST API referansı. Kimlik doğrulama, scope ve istek kuralları için
    API sekmesindeki rehberlere bakın.
servers:
  - url: https://app.flextell.ai/api
    description: Üretim
security:
  - oauth2: []
  - bearer: []
paths:
  /v1/stocks/count/preview:
    post:
      tags:
        - Stock
      summary: Preview a stock count
      description: >-
        Takes the body of `POST /stocks/count` without `notes` and returns, per
        item, the system quantity, the counted

        quantity converted to the product's base unit and the difference the
        count would record. Nothing is written.

        Items without any quantity field are skipped, as the count skips them.
      operationId: stock.countPreview
      parameters:
        - name: X-Tenant
          in: header
          required: true
          description: >-
            Tenant identifier. Send the Tenant ID in the `X-Tenant` header to
            scope API requests to a specific tenant.
          schema:
            type: number
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StockCountPreviewRequest'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: string
                  data:
                    type: object
                    properties:
                      items:
                        type: array
                        items:
                          type: object
                          properties:
                            product_id:
                              type: integer
                            system_quantity:
                              type: number
                            counted_quantity:
                              type: number
                            difference:
                              type: number
                          required:
                            - product_id
                            - system_quantity
                            - counted_quantity
                            - difference
                    required:
                      - items
                required:
                  - success
                  - data
        '401':
          $ref: '#/components/responses/AuthenticationException'
        '403':
          $ref: '#/components/responses/AuthorizationException'
        '422':
          $ref: '#/components/responses/ValidationException'
        '428':
          description: >-
            Mandatory setup is incomplete. Finish the setup wizard first;
            `data.next_step` names the step to continue with.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    examples:
                      - false
                  error_code:
                    type: string
                    enum:
                      - SETUP_REQUIRED
                    examples:
                      - SETUP_REQUIRED
                  message:
                    type: string
                    examples:
                      - Complete the required setup steps to continue.
                  data:
                    type: object
                    properties:
                      next_step:
                        type:
                          - string
                          - 'null'
                        examples:
                          - clinic_info
                    required:
                      - next_step
                required:
                  - success
                  - error_code
                  - message
                  - data
components:
  schemas:
    StockCountPreviewRequest:
      type: object
      properties:
        warehouse_id:
          type: integer
          description: Filter by warehouse ID.
          minimum: 1
        items:
          type: array
          description: List of items.
          items:
            type: object
            properties:
              product_id:
                type: integer
                description: The items.*.product ID.
                minimum: 1
              boxes:
                type:
                  - integer
                  - 'null'
                description: The items.*.boxes.
                minimum: 0
                maximum: 9999999999
              inner_units:
                type:
                  - integer
                  - 'null'
                description: The items.*.inner units.
                minimum: 0
                maximum: 9999999999
              base_units:
                type:
                  - number
                  - 'null'
                description: The items.*.base units.
            required:
              - product_id
          minItems: 1
          maxItems: 500
      required:
        - warehouse_id
        - items
      title: StockCountPreviewRequest
  responses:
    AuthenticationException:
      description: Unauthenticated
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Error overview.
            required:
              - message
    AuthorizationException:
      description: Authorization error
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Error overview.
            required:
              - message
    ValidationException:
      description: Validation error
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Errors overview.
              errors:
                type: object
                description: A detailed description of each field that failed validation.
                additionalProperties:
                  type: array
                  items:
                    type: string
            required:
              - message
              - errors
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://app.flextell.ai/oauth/authorize
          tokenUrl: https://app.flextell.ai/oauth/token
          scopes:
            '*': all
    bearer:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.