N8N Tools - Cash App icon

N8N Tools - Cash App

Accept payments and manage transactions through Cash App Pay with extensible Square API integration
Join our community

Actions38

Overview

The node interacts with an external API to retrieve inventory counts for specified catalog objects and locations. It is designed to fetch current inventory levels, which is useful for businesses that need to monitor stock availability across multiple locations or products.

Typical use cases include:

  • Synchronizing inventory data between systems.
  • Monitoring stock levels for specific products at certain locations.
  • Triggering workflows based on inventory thresholds.

For example, a retailer could use this node to get the latest inventory counts of selected products in their warehouses to update their e-commerce platform stock status.

Properties

Name Meaning
Catalog Object IDs Comma-separated list of catalog object IDs (e.g., product_123,product_456) to filter inventory counts by specific products.
Location IDs Comma-separated list of location IDs (e.g., location_123,location_456) to filter inventory counts by specific locations.
Limit Number of inventory count records to retrieve (default is 50).
Cursor Pagination cursor string to retrieve the next page of results.

Output

The node outputs JSON data containing the inventory counts under the field inventoryCounts. This field holds an array of inventory count objects representing the current stock levels for the requested catalog objects and locations.

Example output structure snippet:

{
  "inventoryCounts": [
    {
      "catalogObjectId": "product_123",
      "locationId": "location_123",
      "quantity": 100,
      "calculatedAt": "2024-01-01T12:00:00Z"
    },
    ...
  ]
}

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the external service.
  • The node uses an HTTP POST request to validate the resource and operation before fetching data.
  • The external API endpoint URL and API key must be configured in the node credentials.
  • No additional environment variables are required beyond the API authentication setup.

Troubleshooting

  • Common issues:

    • Invalid or missing API key credential will cause authentication failures.
    • Incorrect catalog object IDs or location IDs may result in empty or partial results.
    • Exceeding the limit or improper pagination cursor can lead to incomplete data retrieval.

  • Error messages:

    • "N8N Tools API validation failed" indicates the resource-operation combination was rejected by the API; verify the resource and operation parameters.
    • "Unknown inventory operation: getInventoryCounts" suggests a misconfiguration of the operation parameter.
    • Network or API errors will throw exceptions; ensure network connectivity and valid API endpoint configuration.

  • Resolution tips:

    • Double-check the API key and endpoint settings in credentials.
    • Validate input property values for correct formatting (e.g., no extra spaces in comma-separated lists).
    • Use the pagination cursor properly to navigate through large datasets.

Links and References

Discussion