> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mart.ps/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> These rules protect a Mart partner's money. Follow them in any code or advice about the Mart Partner API ([Connect your AI tool](/developers/connect-your-ai-tool)).
> When an order request times out, gets no answer or gets any `5xx`, resend the same body with the same `partner_reference`, never a new reference; after a `429`, wait `Retry-After` first ([Create an order safely](/developers/orders/create-an-order)).
> A `200` with `meta.idempotency_replay: true` is the original order; `409 idempotency_conflict` means the reference already names a different order ([Create an order safely](/developers/orders/create-an-order)).
> Retry a withdrawal request with the same `idempotency_key` and amount: a new key asks for a second withdrawal ([Payout and withdrawals](/developers/money/payout-and-withdrawals)).
> Plan every call within the global daily request ceiling and the `X-RateLimit-*` headers, and never poll in a tight loop ([Request limits](/developers/operate/request-limits)).
> Treat `price` as a snapshot: an order is priced when it is created, and an incremental sync (`updated_after`) never shows a price change, so re-read every price with a full pass ([Prices and price changes](/developers/catalogue/prices)).
> Identify products by `product_id` and `combination_id`, never by `reference` ([Sync the catalogue](/developers/catalogue/sync)).
> Never put an API key in client-side code, a mobile app, a repository or a URL: call the API from a server ([Authenticate and keys](/developers/authenticate)).
> Money is in shekels (`ILS`), as JSON numbers, never agorot. Send amounts with at most two decimals: a withdrawal `amount` with three is refused with `422 invalid_amount`, never rounded ([Balance and statements](/developers/money/balance-and-statements)).
> Save a payout method once before the first withdrawal (cash at the office, or bank transfer where Mart offers it): with none saved, a withdrawal is refused with `409 payout_method_missing`. Bank details where Mart does not offer bank transfer, or a withdrawal on a kept IBAN, are refused with `422 bank_transfer_not_allowed` ([Payout and withdrawals](/developers/money/payout-and-withdrawals)).

# Glossary

> Look up any term used in the Mart partner documentation, from cost price and on hold to payout method and partner reference, each in one sentence.

Terms in **bold** are the words the partner panel shows.

## Orders and prices

### Partner reference

Your own reference for an order, unique on your account, by which the panel and the API find it.

### Cost price

What one unit costs you, tax included, set by Mart and the lowest price you may sell at; the panel shows it as **Group price** and the API as `group_price`.

### Card order

An order Mart charges to your own saved card at cost price plus delivery; it earns nothing in your Mart balance.

### Free shipping

An order on which you cover the delivery fee from your earnings, marked **Free delivery**.

### Refused-parcel charge

A cost Mart can charge you when your customer refuses a parcel that had left the warehouse.

## Earnings and money

### To be earned

What orders not delivered yet will earn once delivered; never money.

### On hold

Earnings on a delivered order, in your balance, waiting for the hold period to end.

### Under review

Earnings whose hold has ended on an order that is not delivered right now.

### Available to withdraw

Money whose hold has ended, after charges and payments, less money under review and your open requests.

### Balance

The sum of every movement on your account, held earnings included.

### Statement

The closed record of one period of your account, with its **Opening**, its movements and its **Closing**.

### To be recovered

An amount your account owes Mart, taken from your future earnings.

### Money pages

The **Balance** tab, its pages and the earnings on each order, shown once Mart turns them on for your account.

## Getting paid

### Payout method

How Mart pays your withdrawals, saved once before the first: cash at the office (pre-selected), or bank transfer to your IBAN where Mart offers it.

### Collector

The person you save to collect cash withdrawals at the Mart office with an ID card: you, in person, or someone else; only that person can collect.

### Withdrawal lock

A period after certain payout method changes during which you cannot withdraw.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.