Overview

This node interacts with the EasyShopper API to manage shopping lists and also integrates with the OpenFoodFacts API to lookup product information by barcode. It supports operations such as adding items to a shopping list, scanning barcodes to add products, looking up product details from OpenFoodFacts by barcode, retrieving all shopping list items, removing items, and clearing the entire list. This node is useful for automating grocery shopping workflows, inventory management, or integrating product lookup features into applications.

Use Case Examples

1. Add a product to a shopping list by specifying its name, quantity, and category.
2. Scan a product barcode to add the product directly to the shopping list using EasyShopper's database.
3. Lookup detailed product information from the OpenFoodFacts database by providing a GTIN/EAN barcode.
4. Retrieve all items currently in the shopping list for review or processing.

Properties

Output

JSON

• success - Indicates if the operation was successful
• found - Indicates if the product was found in the OpenFoodFacts database (only for lookupBarcode operation)
• barcode - The barcode number used in the operation
• productName - Name of the product (from OpenFoodFacts or user input)
• brands - Brand names of the product (from OpenFoodFacts)
• categories - Categories of the product (from OpenFoodFacts)
• imageUrl - URL of the product image (from OpenFoodFacts)
• nutritionGrade - Nutrition grade of the product (from OpenFoodFacts)
• product - Detailed product information object
• response - Full API response from EasyShopper or OpenFoodFacts
• barcodeType - Type of barcode detected (for scanBarcode operation)
• storeGuid - Identifier for the store in EasyShopper system
• itemGuid - Unique identifier for the shopping list item in EasyShopper
• quantity - Quantity of the product added to the shopping list
• category - Category of the product, can be auto-detected using AI
• note - Optional note or description for the product
• itemsCount - Number of items in the shopping list (for getItems operation)
• items - Array of shopping list items (for getItems operation)
• removed - Indicates if an item was successfully removed
• cleared - Indicates if the shopping list was successfully cleared
• itemsDeleted - Number of items deleted when clearing the list
• authenticated - Indicates successful authentication (for auth login operation)
• token - Authentication token received after login
• deviceId - Unique device identifier used for authentication

Dependencies

• EasyShopper API (requires API key credential)
• OpenFoodFacts public API (no authentication required)

Troubleshooting

• If the product is not found in the OpenFoodFacts database, the node throws an error indicating the product was not found. Verify the barcode is correct and exists in the OpenFoodFacts database.
• API request failures to EasyShopper may occur due to invalid or missing API credentials. Ensure the API key credential is correctly configured.
• Network issues or rate limiting from OpenFoodFacts API may cause lookup failures. Retry or check API availability.
• When removing or updating items, ensure the item GUID is correct to avoid errors.

Links

• OpenFoodFacts API Documentation - Official documentation for the OpenFoodFacts product database API.
• EasyShopper API Documentation - Documentation for EasyShopper API endpoints and usage (hypothetical link).