Request acquisition
request_acquisitionPrepare the purchase of one artwork, or of an album sold only as one set, for a named buyer: it shows the catalogue price (never negotiated, before taxes), the taxes for this buyer, the amount to transfer, the licence (private collection and professional display together), how payment works and what happens next, and returns a confirmation code. Nothing is reserved at this step. Show the details and the licence to the buyer, and only if they agree, call confirm_acquisition with the code. It can be completed only for a private buyer in mainland Spain or the Balearic Islands; a business or professional buyer in mainland Spain or the Balearic Islands; a business buyer in another EU country, with a valid EU VAT number; a business buyer in the United Kingdom, Switzerland, Liechtenstein or Norway, registered for VAT there; a business buyer in the United States; a private buyer in another EU country (VAT of their country, declared by the studio through the EU One-Stop Shop). Any other buyer cannot buy here yet, including a buyer in an EU territory with its own tax rules (such as Åland, the Azores, Madeira or the French overseas departments), or in Greenland or the Faroe Islands, which are outside the EU (not set up yet); a buyer in the Canary Islands (IGIC, not set up yet); a buyer in Ceuta or Melilla (IPSI, not set up yet); a buyer outside the EU (taxes of their country, not set up yet): do not tell them they can, prepare nothing, and pass them on to the studio with request_inquiry. The studio does not sell at all to a buyer in Russia or Belarus (EU sanctions): say so, and do not pass it on.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"artwork": "<artwork>",
"buyer_name": "<buyer_name>",
"buyer_email": "<buyer_email>",
"buyer_country": "<buyer_country>",
"buyer_type": "<buyer_type>"
},
"name": "request_acquisition"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| artwork | Yes | Artwork identifier, or its exact name. An album sold only as one set (such as Splendor) is bought by its name or identifier. | |
| agent_name | No | The agent buying on behalf of the buyer | |
| buyer_name | Yes | Who buys: the invoice and the certificate of authenticity go in this name | |
| buyer_type | Yes | Always given: ask the buyer whether they buy as a private person or as a business, and never assume it. person: a private buyer. company: a business or professional buying for its activity (a Spanish one withholds income tax; one in another EU country, the United Kingdom, Switzerland, Liechtenstein or Norway is invoiced without Spanish VAT, with a valid VAT number of its country) | |
| buyer_email | Yes | ||
| buyer_tax_id | No | Required for a company, and for a private buyer in Spain (their DNI or NIE: a Spanish invoice must show it). A company gives its tax ID; outside Spain, its VAT number (EU VAT number, UK VAT number, Swiss UID with MWST, Liechtenstein VAT number or Norwegian organisation number), or the EIN of a US company | |
| buyer_address | No | Required for a company (its registered address: every invoice shows it) and for a private buyer in Spain or in another EU country. In Latin letters, as for international post | |
| buyer_country | Yes | Two-letter country code (ISO 3166-1), such as ES, DE or US | |
| buyer_name_latin | No | Only when buyer_name is written in another alphabet (Greek, Cyrillic, Chinese…): the same name in Latin letters, exactly as in the passport, or as the company is registered. The invoice and the certificate use it | |
| payment_currency | No | EUR, the default: a SEPA transfer from an account in the buyer's name in the SEPA area. USD only for a business in the United States with no such account: the euro total plus the costs of receiving US dollars, which the buyer pays, at today's European Central Bank rate. | |
| buyer_postal_code | No | Required for a buyer in Spain (the Canary Islands, Ceuta and Melilla have their own taxes) and for a buyer in another EU country, private or business (some territories have their own, such as Åland, the Azores, Madeira or the French overseas departments) |