action squareup_retrieve_inventory_physical_count {
  label: "RetrieveInventoryPhysicalCount"
  description: "Returns the [InventoryPhysicalCount](https://developer.squareup.com/reference/square_2021-08-18/objects/InventoryPhysicalCount)\nobject with the provided `physical_count_id`."
  provider: squareup
  method: GET
  path: "/v2/inventory/physical-counts/{physical_count_id}"
  encoding: json
  input: {
    type: "object"
    properties: {
      physical_count_id: {
        type: "string"
      }
    }
    required: ["physical_count_id"]
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      count: {
        type: "object"
        description: "Represents the quantity of an item variation that is physically present\nat a specific location, verified by a seller or a seller's employee. For example,\na physical count might come from an employee counting the item variations on\nhand or from syncing with an external system."
        properties: {
          catalog_object_id: {
            type: "string"
            description: "The Square-generated ID of the\n[CatalogObject](https://developer.squareup.com/reference/square_2021-08-18/objects/CatalogObject) being tracked."
          }
          catalog_object_type: {
            type: "string"
            description: "The [type](https://developer.squareup.com/reference/square_2021-08-18/enums/CatalogObjectType) of the\n[CatalogObject](https://developer.squareup.com/reference/square_2021-08-18/objects/CatalogObject) being tracked. Tracking is only\nsupported for the `ITEM_VARIATION` type."
          }
          created_at: {
            type: "string"
            description: "An RFC 3339-formatted timestamp that indicates when the physical count is received."
          }
          employee_id: {
            type: "string"
            description: "The Square-generated ID of the [Employee](https://developer.squareup.com/reference/square_2021-08-18/objects/Employee) responsible for the\nphysical count."
          }
          id: {
            type: "string"
            description: "A unique Square-generated ID for the\n[InventoryPhysicalCount](https://developer.squareup.com/reference/square_2021-08-18/objects/InventoryPhysicalCount)."
          }
          location_id: {
            type: "string"
            description: "The Square-generated ID of the [Location](https://developer.squareup.com/reference/square_2021-08-18/objects/Location) where the related\nquantity of items is being tracked."
          }
          occurred_at: {
            type: "string"
            description: "A client-generated RFC 3339-formatted timestamp that indicates when\nthe physical count was examined. For physical count updates, the `occurred_at`\ntimestamp cannot be older than 24 hours or in the future relative to the\ntime of the request."
          }
          quantity: {
            type: "string"
            description: "The number of items affected by the physical count as a decimal string.\nThe number can support up to 5 digits after the decimal point."
          }
          reference_id: {
            type: "string"
            description: "An optional ID provided by the application to tie the\n[InventoryPhysicalCount](https://developer.squareup.com/reference/square_2021-08-18/objects/InventoryPhysicalCount) to an external\nsystem."
          }
          source: {
            type: "object"
            description: "Provides information about the application used to generate a change."
            properties: {
              application_id: {
                type: "string"
                description: "Read-only Square ID assigned to the application. Only used for\n[Product](https://developer.squareup.com/reference/square_2021-08-18/enums/Product) type `EXTERNAL_API`."
              }
              name: {
                type: "string"
                description: "Read-only display name assigned to the application\n(e.g. `\"Custom Application\"`, `\"Square POS 4.74 for Android\"`)."
              }
              product: {
                type: "string"
                description: "Read-only [Product](https://developer.squareup.com/reference/square_2021-08-18/enums/Product) type for the application."
              }
            }
          }
          state: {
            type: "string"
            description: "The current [inventory state](https://developer.squareup.com/reference/square_2021-08-18/enums/InventoryState) for the related\nquantity of items."
          }
        }
      }
      errors: {
        type: "array"
        description: "Any errors that occurred during the request."
        items: {
          type: "object"
          description: "Represents an error encountered during a request to the Connect API.\n\nSee [Handling errors](https://developer.squareup.com/docs/build-basics/handling-errors) for more information."
          required: ["category", "code"]
          properties: {
            category: {
              type: "string"
              description: "The high-level category for the error."
            }
            code: {
              type: "string"
              description: "The specific code of the error."
            }
            detail: {
              type: "string"
              description: "A human-readable description of the error for debugging purposes."
            }
            field: {
              type: "string"
              description: "The name of the field provided in the original request (if any) that\nthe error pertains to."
            }
          }
        }
      }
    }
  }
}