prestashop_bridge_v1

What This Skill Does

The PrestaShop Bridge V1 is a specialized interface designed for AI agents to interact with PrestaShop 9 store environments securely. It provides a robust, asynchronous contract that ensures stability when performing high-frequency e-commerce operations. Unlike standard REST APIs, this bridge implements strict request signing using HMAC-SHA256, OAuth2 authentication, and idempotency guarantees, ensuring that AI-driven requests do not result in duplicate transactions or unintended data corruption. The skill separates read operations, which are synchronous, from write operations, which are handled through a durable job-queue system backed by MySQL. This ensures that even if a write request is accepted with a 202 status code, the AI agent can monitor progress via the status polling endpoint to confirm successful business completion.

Installation

To integrate this skill into your OpenClaw agent, execute the following command in your terminal:

clawhub install openclaw/skills/skills/ansz089/prestashop-bridge-v1

Ensure your agent environment has access to the required credentials for OAuth2 client_credentials flow, specifically the client ID and secret, to authorize against the /oauth/token endpoint.

Use Cases

• Inventory Management: Automatically adjust stock levels or update prices for hundreds of products in response to external market fluctuations.
• Order Fulfillment: Update order statuses and attach tracking numbers to customer purchases without human intervention.
• Bulk Catalog Imports: Efficiently synchronize product catalogs from external suppliers using the batch import feature with native idempotency control.
• Automated Reporting: Querying product details and current order states to generate data-driven insights for store managers.

Example Prompts

1. "Check the current stock status for product ID 5021 and if it is below 5 units, update the price to $29.99."
2. "Update the status of order 8842 to 'Shipped' and include the tracking number TRK99002211."
3. "Batch import these 20 new items from my catalog into the store, ensuring all items are marked for reindexing."

Tips & Limitations

• Write Latency: Always remember that a 202 Accepted response indicates the job is queued, not finished. Use get_job_status to verify final outcomes.
• Idempotency: Always provide a unique X-Request-ID for every write operation to prevent double-processing.
• Constraints: When using import_products, limit your batches to a maximum of 50 items and ensure the total payload remains under 10MB.
• Compression: For large payloads, ensure your agent enables gzip compression to optimize network transit, especially for payloads exceeding 32KB.