Skip to main content

Shoptet

The Shoptet connection allows agents and workflows to work with data from the Shoptet e-shop. Siesta AI can read products, orders, customers, stock information, and invoices, and can create or modify selected records according to the connection permissions.

Quick Connection​

  1. In the Connections section, click on Add Connection.
  2. Select Shoptet.
  3. Choose the available authentication method for your e-shop.
  4. Grant the required permissions or insert a private API token.
  5. Name the connection and save it.

What the Connection Can Do​

  • Load information about the e-shop, currency, language, and configuration.
  • List products, load product details, and work with the catalog.
  • Create, modify, or delete a product if the connection has write permissions.
  • List orders, load order details, and change the order status.
  • Work with customers, stock items, and other e-commerce data according to available permissions.

Important Principles​

  • Use products by GUID, and orders by order code. Treat the order code as text, even if it looks like a number.
  • OAuth connections use a short-lived API access token. If it expires, Siesta AI must obtain a new token.
  • The private API token is a static token created in the e-shop administration. Treat it as sensitive information.
  • List operations are paginated. For larger e-shops, loading all data may require multiple API calls.
  • Shoptet uses rate limits. If the limit is exceeded or concurrent writes occur, the service may return an error, and the workflow should retry the action later.

Security and Permissions​

For typical analytical scenarios, use only read permissions. Enable write permissions only where the agent or workflow actually creates or modifies products and orders. For deletions or bulk changes, human confirmation is recommended.

The Shoptet connection is suitable for e-commerce reporting, order synchronization, catalog control, automated order processing, and working with customer data within the allowed permissions.

Technical Notes​

  • Implementation: Shoptet is documented as a configured API integration; exact implementation depends on the customer setup.
  • Authentication/scopes: depends on the Shoptet API token/app permissions granted for the e-shop.
  • Functions: expected functions depend on the configured API surface, such as reading products, orders, customers, stock, and creating or updating records where enabled.
  • Write behavior: e-commerce writes can affect storefront data and fulfillment, so restrict write actions and require confirmation.