---
title: "POST /pos/batch"
method: POST
path: "/pos/batch"
tags: ["pos"]
---

# POST /pos/batch

`POST /pos/batch`

Batches multiple POS-related calls in a single request.

## Request body

- PosCustomBatchRequest
  - `entries` PosCustomBatchRequestEntry[] — The request entries to be processed in the batch.
    - `targetMerchantId` string, uint64 — The ID of the account for which to get/submit data.
    - `method` string — The method of the batch entry. Acceptable values are: - "`delete`" - "`get`" - "`insert`" - "`inventory`" - "`sale`"
    - `merchantId` string, uint64 — The ID of the POS data provider.
    - `storeCode` string — The store code. This should be set only if the method is `delete` or `get`.
    - `store` PosStore — Store resource.
      - `storeName` string — The merchant or store name.
      - `websiteUrl` string — The website url for the store or merchant.
      - `gcidCategory` string[] — The business type of the store.
      - `matchingStatus` string — Output only. The matching status of POS store and Google Business Profile store. Possible values are: - "`matched`": The POS store is successfully matched with the Google Business Profile store. - "`failed`": The POS store is not matched with the Google Business Profile store. See matching_status_hint for further details. Note that there is up to 48 hours propagation delay for changes in Merchant Center (e.g. creation of new account, accounts linking) and Google Business Profile (e.g. store address update) which may affect the matching status. In such cases, after a delay call [pos.list](https://developers.google.com/shopping-content/reference/rest/v2.1/pos/list) to retrieve the updated matching status.
      - `placeId` string — The Google Place Id of the store location.
      - `storeAddress` string — Required. The street address of the store.
      - `kind` string — Identifies what kind of resource this is. Value: the fixed string "`content#posStore`"
      - `matchingStatusHint` string — Output only. The hint of why the matching has failed. This is only set when matching_status=failed. Possible values are: - "`linked-store-not-found`": There aren't any Google Business Profile stores available for matching. Connect your Merchant Center account with the Google Business Profile account. Or add a new Google Business Profile store corresponding to the POS store. - "`store-match-not-found`": The provided POS store couldn't be matched to any of the connected Google Business Profile stores. Merchant Center account is connected correctly and stores are available on Google Business Profile, but POS store location address does not match with Google Business Profile stores' addresses. Update POS store address or Google Business Profile store address to match correctly. - "`store-match-unverified`": The provided POS store couldn't be matched to any of the connected Google Business Profile stores, as the matched Google Business Profile store is unverified. Go through the Google Business Profile verification process to match correctly.
      - `storeCode` string — Required. A store identifier that is unique for the given merchant.
      - `phoneNumber` string — The store phone number.
    - `inventory` PosInventory — The absolute quantity of an item available at the given store.
      - `price` Price
        - `value` string — The price represented as a number.
        - `currency` string — The currency of the price.
      - `timestamp` string — Required. The inventory timestamp, in ISO 8601 format.
      - `targetCountry` string — Required. The CLDR territory code for the item.
      - `kind` string — Identifies what kind of resource this is. Value: the fixed string "`content#posInventory`"
      - `quantity` string, int64 — Required. The available quantity of the item.
      - `contentLanguage` string — Required. The two-letter ISO 639-1 language code for the item.
      - `pickupSla` string — Optional. Expected date that an order will be ready for pickup relative to the order date. Must be submitted together with `pickupMethod`. For accepted attribute values, see the [local product inventory feed specification](https://support.google.com/merchants/answer/3061342).
      - `itemId` string — Required. A unique identifier for the item.
      - `pickupMethod` string — Optional. Supported pickup method for this offer. Unless the value is "not supported", this field must be submitted together with `pickupSla`. For accepted attribute values, see the [local product inventory feed specification](https://support.google.com/merchants/answer/3061342).
      - `storeCode` string — Required. The identifier of the merchant's store. Either a `storeCode` inserted through the API or the code of the store in a Business Profile.
      - `gtin` string — Global Trade Item Number.
    - `sale` PosSale — The change of the available quantity of an item at the given store.
      - `contentLanguage` string — Required. The two-letter ISO 639-1 language code for the item.
      - `kind` string — Identifies what kind of resource this is. Value: the fixed string "`content#posSale`"
      - `quantity` string, int64 — Required. The relative change of the available quantity. Negative for items returned.
      - `targetCountry` string — Required. The CLDR territory code for the item.
      - `price` Price
        - `value` string — The price represented as a number.
        - `currency` string — The currency of the price.
      - `timestamp` string — Required. The inventory timestamp, in ISO 8601 format.
      - `gtin` string — Global Trade Item Number.
      - `saleId` string — A unique ID to group items from the same sale event.
      - `storeCode` string — Required. The identifier of the merchant's store. Either a `storeCode` inserted through the API or the code of the store in a Business Profile.
      - `itemId` string — Required. A unique identifier for the item.
    - `batchId` integer — An entry ID, unique within the batch request.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/content.md) · [All operations](https://skmtc.net/google/apis/content/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/content/revisions/1033388fc86f/schema)
