# JTL Developer Documentation

- [Cloud (3829 pages)](https://developer.jtl-software.com/_llms/cloud.md): Documentation for Cloud.
- [Marketplace Channels (104 pages)](https://developer.jtl-software.com/_llms/marketplace-channels.md): Documentation for Marketplace Channels.

## Legal

### Legal

- [API Licence Terms](https://developer.jtl-software.com/legal/api_licence_terms.md): Terms governing the access and usage of JTL-APIs by Users.

## Schema (LLM)

### GraphQL Schema

- [GraphQL Schema Reference (v2.2)](https://developer.jtl-software.com/cloud/api-reference/erp/v2.2/graphql-schema.md): Complete GraphQL SDL schema for the JTL ERP API v2.2. Indexed for AI tools (MCP, llms.txt) to enable accurate query and mutation assistance.
- [GraphQL Schema Reference (v2.1)](https://developer.jtl-software.com/cloud/api-reference/erp/v2.1/graphql-schema.md): Complete GraphQL SDL schema for the JTL ERP API v2.1. Indexed for AI tools (MCP, llms.txt) to enable accurate query and mutation assistance.
- [GraphQL Schema Reference (v2.0)](https://developer.jtl-software.com/cloud/api-reference/erp/v2.0/graphql-schema.md): Complete GraphQL SDL schema for the JTL ERP API v2.0. Indexed for AI tools (MCP, llms.txt) to enable accurate query and mutation assistance.

## Vouchers

### Guides

#### Vouchers

- [Vouchers API Quickstart](https://developer.jtl-software.com/vouchers/guides/quickstart.md): Set up a client, get credentials, and run through the full voucher lifecycle.
- [Vouchers API Error Codes](https://developer.jtl-software.com/vouchers/guides/error-codes.md): Error response format and validation error codes for the Vouchers API.
- [Vouchers API Changelog](https://developer.jtl-software.com/vouchers/guides/changelog.md): Version history and breaking changes for the Vouchers API.

### API Reference

#### Overview

- [Vouchers API](https://developer.jtl-software.com/vouchers/api-reference.md): Create, manage, and redeem vouchers in JTL Voucher Cloud.

#### Endpoints

##### Vouchers

- [Get a list of vouchers](https://developer.jtl-software.com/vouchers/api-reference/vouchers/get-a-list-of-vouchers.md): This call will give you a paginated list of vouchers.
- [Create a new voucher](https://developer.jtl-software.com/vouchers/api-reference/vouchers/create-a-new-voucher.md): Use this call to create a new voucher
- [Recharge a voucher](https://developer.jtl-software.com/vouchers/api-reference/vouchers/recharge-a-voucher.md): Use this call to recharge a voucher. This can be used for example for customer cards. Please note that this call is not used for cancelations of previously charges.
- [Get a voucher](https://developer.jtl-software.com/vouchers/api-reference/vouchers/get-a-voucher.md): Use this call to get a specific single voucher. Please note that you wont get the vouchers secret properties *code* and *pin* (use the vouchers/{id}/complete call instead).
- [Delete a voucher](https://developer.jtl-software.com/vouchers/api-reference/vouchers/delete-a-voucher.md): A voucher can only be deleted when it has no charges yet.
- [Update a voucher](https://developer.jtl-software.com/vouchers/api-reference/vouchers/update-a-voucher.md): Due to security restrictions only the sku and batch property can be updated on inactive vouchers
- [Get a complete voucher](https://developer.jtl-software.com/vouchers/api-reference/vouchers/get-a-complete-voucher.md): Use this call to get a voucher with its secret properties *code* and *pin*.
- [Set the status for a voucher](https://developer.jtl-software.com/vouchers/api-reference/vouchers/set-the-status-for-a-voucher.md): This call is used to activate or deactivate a specific voucher.
- [Get a list of voucher charges](https://developer.jtl-software.com/vouchers/api-reference/vouchers/get-a-list-of-voucher-charges.md): This call will give you a paginated list of voucher charges.
- [Get a charge of a voucher](https://developer.jtl-software.com/vouchers/api-reference/vouchers/get-a-charge-of-a-voucher.md): Use this call to get a specific charge of a voucher.

##### Reservations

- [Set the reservation for a specific voucher](https://developer.jtl-software.com/vouchers/api-reference/reservations/set-the-reservation-for-a-specific-voucher.md): This call temporary reserves an amount on a specific voucher, that can later be charged. A reservation expires after 30 minutes or in case a new one is requested for this voucher.
- [Charge a specific voucher reservation](https://developer.jtl-software.com/vouchers/api-reference/reservations/charge-a-specific-voucher-reservation.md): Charges the previously created temporary reservation on a voucher.

##### Charges

- [Refund a specific voucher charge](https://developer.jtl-software.com/vouchers/api-reference/charges/refund-a-specific-voucher-charge.md): This call is used to (partial) refund a specific charge that was previously done on a voucher (for example if a customer returns goods to the store).

##### Clients

- [Connects a client](https://developer.jtl-software.com/vouchers/api-reference/clients/connects-a-client.md): Exchanges temporary pin for full oauth client credentials
- [Disconnects a client](https://developer.jtl-software.com/vouchers/api-reference/clients/disconnects-a-client.md): Disconnects the client from the voucher cloud and resets all credentials

## Build with AI

### AI Tools

- [Build with AI](https://developer.jtl-software.com/build-with-ai.md): Connect the JTL documentation to your AI coding tools so they can answer questions and generate code across every JTL product

## Help

### Resources

- [Support](https://developer.jtl-software.com/help/support.md): Developer resources, support channels, and community spaces for building on the JTL Cloud Platform.
- [Service Status](https://developer.jtl-software.com/help/status-page.md): Check the operational status of the JTL services that Cloud Apps depend on.
- [Changelog](https://developer.jtl-software.com/help/changelog.md): Platform releases, API changes, SDK updates, and developer-facing improvements for the JTL Platform.

## Other

- [JTL Developer Blog](https://developer.jtl-software.com/blog/index.md): News, tutorials, and insights from the JTL developer team on building apps and integrations for JTL Cloud.
- [Turn your ERP Integration into a JTL Cloud App](https://developer.jtl-software.com/blog/posts/turn-your-wawi-integration-into-a-cloud-app.md): Stop rebuilding the same ERP integration for every client. Package it as one JTL Cloud App, start with a private app and grow to the JTL App Store.
- [What are JTL Cloud Apps?](https://developer.jtl-software.com/blog/posts/what-are-jtl-cloud-apps.md): Cloud Apps are web apps you host that run alongside ERPs and use JTL APIs and webhooks. Learn what you can build and how they differ from extensions.
- [Wawi Integration](https://developer.jtl-software.com/cloud/guides/erp-integration/wawi-integration.md): Integrate with JTL-Wawi ERP system
- [JTL Developer Platform](https://developer.jtl-software.com/index.md): Build apps for 50,000+ JTL merchants. From first idea to live in the App Store.

## OpenAPI Specs

- [token-exchange](/openapi/account-service/token-exchange.json)
- [2.2](/openapi/erp/2.2.json)
- [2.1](/openapi/erp/2.1.json)
- [2.0](/openapi/erp/2.0.json)
- [1.5](/openapi/erp/1.5.json)
- [1.4](/openapi/erp/1.4.json)
- [1.3](/openapi/erp/1.3.json)
- [1.2](/openapi/erp/1.2.json)
- [1.1](/openapi/erp/1.1.json)
- [1.0](/openapi/erp/1.0.json)
- [channel](/openapi/marketplace-channels/channel.json)
- [seller](/openapi/marketplace-channels/seller.json)
- [public](/openapi/marketplace-channels/public.json)
- [auth](/openapi/marketplace-channels/auth.json)
- [voucher](/openapi/vouchers/voucher.json)

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [Cloud (3829 pages)](https://developer.jtl-software.com/_llms/cloud.md): Documentation for Cloud.
- [Cloud / API Reference (3767 pages)](https://developer.jtl-software.com/_llms/cloud/api-reference.md): Documentation for Cloud / API Reference.
- [Cloud / API Reference / ERP (JTL-Wawi) (3763 pages)](https://developer.jtl-software.com/_llms/cloud/api-reference/erp-jtl-wawi.md): Documentation for Cloud / API Reference / ERP (JTL-Wawi).
- [Cloud / API Reference / ERP (JTL-Wawi) / v2.2 (446 pages)](https://developer.jtl-software.com/_llms/cloud/api-reference/erp-jtl-wawi/v2-2.md): Documentation for Cloud / API Reference / ERP (JTL-Wawi) / v2.2.
- [Cloud / API Reference / ERP (JTL-Wawi) / v2.2 / REST API (444 pages)](https://developer.jtl-software.com/_llms/cloud/api-reference/erp-jtl-wawi/v2-2/rest-api.md): Documentation for Cloud / API Reference / ERP (JTL-Wawi) / v2.2 / REST API.
- [Cloud / API Reference / ERP (JTL-Wawi) / v2.2 / REST API / wawi (175 pages)](https://developer.jtl-software.com/_llms/cloud/api-reference/erp-jtl-wawi/v2-2/rest-api/wawi.md): Documentation for Cloud / API Reference / ERP (JTL-Wawi) / v2.2 / REST API / wawi.
- [Cloud / API Reference / ERP (JTL-Wawi) / v2.1 (442 pages)](https://developer.jtl-software.com/_llms/cloud/api-reference/erp-jtl-wawi/v2-1.md): Documentation for Cloud / API Reference / ERP (JTL-Wawi) / v2.1.
- [Cloud / API Reference / ERP (JTL-Wawi) / v2.1 / REST API (440 pages)](https://developer.jtl-software.com/_llms/cloud/api-reference/erp-jtl-wawi/v2-1/rest-api.md): Documentation for Cloud / API Reference / ERP (JTL-Wawi) / v2.1 / REST API.
- [Cloud / API Reference / ERP (JTL-Wawi) / v2.1 / REST API / wawi (171 pages)](https://developer.jtl-software.com/_llms/cloud/api-reference/erp-jtl-wawi/v2-1/rest-api/wawi.md): Documentation for Cloud / API Reference / ERP (JTL-Wawi) / v2.1 / REST API / wawi.
- [Cloud / API Reference / ERP (JTL-Wawi) / v2.0 (312 pages)](https://developer.jtl-software.com/_llms/cloud/api-reference/erp-jtl-wawi/v2-0.md): Documentation for Cloud / API Reference / ERP (JTL-Wawi) / v2.0.
- [Cloud / API Reference / ERP (JTL-Wawi) / v1.5 (469 pages)](https://developer.jtl-software.com/_llms/cloud/api-reference/erp-jtl-wawi/v1-5.md): Documentation for Cloud / API Reference / ERP (JTL-Wawi) / v1.5.
- [Cloud / API Reference / ERP (JTL-Wawi) / v1.4 (469 pages)](https://developer.jtl-software.com/_llms/cloud/api-reference/erp-jtl-wawi/v1-4.md): Documentation for Cloud / API Reference / ERP (JTL-Wawi) / v1.4.
- [Cloud / API Reference / ERP (JTL-Wawi) / v1.3 (459 pages)](https://developer.jtl-software.com/_llms/cloud/api-reference/erp-jtl-wawi/v1-3.md): Documentation for Cloud / API Reference / ERP (JTL-Wawi) / v1.3.
- [Cloud / API Reference / ERP (JTL-Wawi) / v1.2 (487 pages)](https://developer.jtl-software.com/_llms/cloud/api-reference/erp-jtl-wawi/v1-2.md): Documentation for Cloud / API Reference / ERP (JTL-Wawi) / v1.2.
- [Cloud / API Reference / ERP (JTL-Wawi) / v1.1 (230 pages)](https://developer.jtl-software.com/_llms/cloud/api-reference/erp-jtl-wawi/v1-1.md): Documentation for Cloud / API Reference / ERP (JTL-Wawi) / v1.1.
- [Cloud / API Reference / ERP (JTL-Wawi) / v1.0 (459 pages)](https://developer.jtl-software.com/_llms/cloud/api-reference/erp-jtl-wawi/v1-0.md): Documentation for Cloud / API Reference / ERP (JTL-Wawi) / v1.0.
- [Marketplace Channels (104 pages)](https://developer.jtl-software.com/_llms/marketplace-channels.md): Documentation for Marketplace Channels.
- [Marketplace Channels / API Reference (97 pages)](https://developer.jtl-software.com/_llms/marketplace-channels/api-reference.md): Documentation for Marketplace Channels / API Reference.