# Loyverse AI integration on Definable

> Loyverse is a point-of-sale (POS) system designed for small businesses, offering features like sales management, inventory tracking, and customer engagement tools.

## What this connects

Loyverse is a point-of-sale (POS) system designed for small businesses, offering features like sales management, inventory tracking, and customer engagement tools.

Vendor: https://loyverse.com/

## Tools available

**58** tools available. First 12:

- `LOYVERSE_CREATE_OR_UPDATE_CATEGORY` — Create or Update Category — Tool to create a new category or update an existing one. If the ID field is provided, the category will be updated; otherwise, a new category is created.
- `LOYVERSE_CREATE_OR_UPDATE_CUSTOMER` — Create or Update Customer — Tool to create a new customer or update an existing one in Loyverse. Use when you need to add customer records or modify customer information. If the 'id' field is provided, it will update the existing customer; otherwise, it creates a new customer.
- `LOYVERSE_CREATE_OR_UPDATE_DISCOUNT` — Create or Update Discount — Tool to create or update a single discount. Use when creating new discounts or modifying existing ones. Supports FIXED_PERCENT (percentage-based), FIXED_AMOUNT (fixed amount), and VARIABLE discount types.
- `LOYVERSE_CREATE_OR_UPDATE_ITEM` — Create or Update Item — Tool to create a new item or update an existing one in Loyverse inventory. Include the item ID to update an existing item, or omit it to create a new one.
- `LOYVERSE_CREATE_OR_UPDATE_MODIFIER` — Create or Update Modifier — Tool to create or update a single modifier with options. If an ID is included in the request, it will update the existing modifier; otherwise, it creates a new one.
- `LOYVERSE_CREATE_OR_UPDATE_POS_DEVICE` — Create or Update POS Device — Tool to create a new POS device or update an existing one. If the request includes an ID, it updates the device; otherwise, it creates a new one.
- `LOYVERSE_CREATE_OR_UPDATE_SUPPLIER` — Create or Update Supplier — Tool to create a new supplier or update an existing one in Loyverse. Use when you need to register suppliers before purchases or modify supplier information. If the 'id' field is provided, it will update the existing supplier; otherwise, it creates a new supplier.
- `LOYVERSE_CREATE_OR_UPDATE_TAX` — Create or Update Tax — Tool to create or update a single tax. If the ID field is provided, the tax will be updated; otherwise, a new tax is created. Use when setting up tax rates for stores.
- `LOYVERSE_CREATE_OR_UPDATE_VARIANT` — Create or Update Variant — Tool to create or update a single item variant in Loyverse. Use when you need to add product variations (like size, color) or modify existing variant details. If variant_id is provided, it updates the existing variant; otherwise, it creates a new one. Note: The parent item must have option names defined before variants can be created.
- `LOYVERSE_CREATE_OR_UPDATE_WEBHOOK` — Create or Update Webhook — Tool to create a new webhook subscription or update an existing one in Loyverse. Use when you need to subscribe to events like items.update, inventory.update, receipts.create, customers.update, or shifts.create. If the 'id' field is provided, it will update the existing webhook; otherwise, it creates a new webhook.
- `LOYVERSE_CREATE_RECEIPT` — Create Receipt — Tool to create a sales receipt with line items and payments. Use when you need to record a sale transaction in Loyverse.
- `LOYVERSE_CREATE_REFUND` — Create Refund — Tool to create a refund receipt for a sales receipt. Use when you need to process a refund for items from a previous sale. Only supports refunds for receipts paid by a single payment method (not integrated payments).

## Auth

Auth schemes: `API_KEY`.

## How agents use Loyverse

Inside a Definable workflow, Loyverse is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Loyverse** — the Researcher (GPT-5.5) pulls context from Loyverse (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Loyverse** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Loyverse (create record, post message, draft email).
- **Designer / Engineer → Distributor → Loyverse** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Loyverse (attach file, open PR comment, post status).

The Verifier checks every Loyverse call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- ecommerce — https://definable.ai/apps/category/ecommerce/
- payment processing — https://definable.ai/apps/category/payment-processing/

## Related

- HTML page: https://definable.ai/apps/loyverse/
- Same category (ecommerce): https://definable.ai/apps/category/ecommerce/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt