# YoPrint for developers

> Build on YoPrint, the shop-management app for print shops. Build with the YoPrint API, or connect an AI app through MCP.

Web page: https://developer.yoprint.com/

## Choose your path

**Build with the API**

Create a personal API key in **Profile**, then send HTTPS requests to read and change your team's data. It comes with the Pro plan or higher. Make your first call in under five minutes.

[Start the quickstart](https://developer.yoprint.com/start/quickstart.md) or browse the [API reference](https://developer.yoprint.com/reference.md): every operation, with its request, answer, rules and errors.

**Connect an AI app (MCP)**

Add YoPrint to Claude, Claude Code, ChatGPT or Cursor with one address, sign in, pick your team, and choose whether the app may make changes. It works as you, within your role. AI apps work on every team whose plan includes API access (Pro or higher).

[How AI apps work](https://developer.yoprint.com/ai-apps.md)

## What you can build

**Order intake**

Turn orders from your website, store or forms into YoPrint quotes and sales orders, with their line items.

[Quote to payment](https://developer.yoprint.com/guides/quote-to-payment.md)

**Customer sync**

Keep customers and contacts in step with your CRM or accounting system.

[Create and sync customers](https://developer.yoprint.com/guides/customers-and-contacts.md)

**Production views**

Read jobs, tasks and statuses for shop-floor screens, schedules and reports.

[Schedule and track production](https://developer.yoprint.com/guides/jobs-and-production.md)

**Event-driven workflows**

React when an order is created, a payment arrives or a job changes status.

[Receive events with webhooks](https://developer.yoprint.com/guides/webhooks.md)

**Shipping automation**

Build shipments, compare rates and buy labels.

[Ship an order](https://developer.yoprint.com/guides/shipping.md)

**No-code automations**

Connect YoPrint to other apps with Zapier, without writing code.

[Zapier and no-code](https://developer.yoprint.com/guides/zapier-and-no-code.md)

## Understand the shop first

YoPrint's API follows how a print shop works: a quote becomes a sales order, the shop makes and ships it, and its invoices are paid. [How YoPrint works](https://developer.yoprint.com/how-yoprint-works.md) explains each record, with diagrams.

**Quotes and sales orders**

One record with a type: draft, publish, convert, statuses and approvals. [Read more](https://developer.yoprint.com/how-yoprint-works/quotes-and-sales-orders.md)

**Invoices and payments**

What an invoice bills, deposits, payments and the balance. [Read more](https://developer.yoprint.com/how-yoprint-works/invoices-and-payments.md)

## Learn the rules once

The full list of operations is in the [API reference](https://developer.yoprint.com/reference.md). These pages prevent most integration bugs:

- [Authentication](https://developer.yoprint.com/concepts/authentication.md): one header, `Authorization: Bearer YOUR_API_KEY`.
- [IDs](https://developer.yoprint.com/concepts/ids.md): use the `id` field, never the document number.
- [Money and quantities](https://developer.yoprint.com/concepts/money-and-quantities.md): decimal pairs (`value` ÷ 10^`dp`: `1250` with `dp` 2 is 12.50) and older thousandths fields (`300000` is 300.00).
- [Retries and duplicates](https://developer.yoprint.com/concepts/retries-and-duplicates.md): creates aren't idempotent.
- [What a write also does](https://developer.yoprint.com/concepts/side-effects.md): emails, webhooks and money.
- [Errors](https://developer.yoprint.com/concepts/errors.md): every common error code, what it means and what to do.

Stuck? [Get help](https://developer.yoprint.com/start/support.md) says what to send support. [Changes and deprecations](https://developer.yoprint.com/start/changes.md) lists what changed in the API and which operations to move off.