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

# Bulk price & stock

> Up to 100 changes per call. Each line uses `id`, `external_id` or `barcode` (or `addon_id` / `addon_external_id`), and reports its own result.



## OpenAPI

````yaml POST /items/batch
openapi: 3.1.0
info:
  title: XFaster Partner API
  version: '1.0'
  description: >
    Receive XFaster orders in your POS, send their status back, and keep the
    menu, stock and prices in sync.

    One API key per store, or one integrator key for all your stores (it names
    the store in X-XFaster-Store). Money is in agorot (integers, VAT included).
    Times are ISO 8601 with the Israel offset.
servers:
  - url: https://staging2.xfaster.net/api/partner/v1
    description: Sandbox (test keys, xfp_test_…)
  - url: https://apps.xfaster.net/api/partner/v1
    description: Live (live keys, xfp_live_…)
security:
  - apiKey: []
  - apiKey: []
    storeHeader: []
tags:
  - name: Store
  - name: Orders
  - name: Menu
  - name: Market
  - name: Reports
  - name: Sandbox
paths:
  /items/batch:
    post:
      tags:
        - Menu
      summary: Update many items
      description: >-
        Up to 100 changes per call. Each line uses `id`, `external_id` or
        `barcode` (or `addon_id` / `addon_external_id`), and reports its own
        result.
      operationId: batchItems
      parameters:
        - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - changes
              properties:
                changes:
                  type: array
                  minItems: 1
                  maxItems: 100
                  items:
                    type: object
                    properties:
                      id:
                        type: integer
                      external_id:
                        type: string
                      barcode:
                        type: string
                      addon_id:
                        type: integer
                      addon_external_id:
                        type: string
                      available:
                        type: boolean
                      price:
                        type: integer
                      sale_price:
                        type:
                          - integer
                          - 'null'
                      stock:
                        type: integer
            example:
              changes:
                - barcode: '7290000066318'
                  price: 590
                  stock: 40
                - external_id: BURG-SMASH
                  available: false
                - addon_external_id: ADD-CHEDDAR
                  available: false
      responses:
        '200':
          description: One result per line
          content:
            application/json:
              example:
                results:
                  - ok: true
                  - ok: true
                  - ok: false
                    error:
                      code: not_found
                      message: No item of this store matches this change.
components:
  parameters:
    IdempotencyKey:
      name: Idempotency-Key
      in: header
      description: >-
        Any unique string. Repeating a request with the same key within 24 hours
        returns the first answer instead of acting twice.
      schema:
        type: string
        example: 5f0c3d1e-8b6a-4e1f-9c2d-7a1b0e4f6d21
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        The store's API key (xfp_test_… on the sandbox, xfp_live_… on live).
        XFaster creates it and shows it once. An integrator key (one key for a
        POS company) also sends X-XFaster-Store.
    storeHeader:
      type: apiKey
      in: header
      name: X-XFaster-Store
      description: >-
        Integrator keys only: the XFaster store id this request is for. It must
        be linked to your key (else 403 store_not_linked); without it 400
        store_header_required. Store keys don't send it.

````

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