create_order

Prepares an order of this configured watch for the user. ONLY call it when the user explicitly asked you to order it and agreed to share their name, email and delivery address with B.R.M (user_consent=true). B.R.M then emails the user a summary with a 'Confirm my order' button; the order is placed ONLY after the user confirms it there (link valid 72 h), choosing card, interest-free instalments (Alma under EUR 2,000, Pledg from EUR 2,000, where available), a 20% deposit (watch from EUR 3,000) or bank transfer (EUR only), and pays B.R.M himself on B.R.M's secure payment page — no card or bank details go through this tool, and you never pay or commit the user. Relay message_for_user to the user. Do NOT say the order is placed, do NOT ask for payment details, NEVER promise a delivery date. The price is computed by B.R.M for the delivery country (currency and VAT follow the delivery country). Limited to a few orders per day per email. Pass an idempotency_key to make retries safe.

destructive

Argument	Type	Description
lang	string
customer*	object
user_consent*	boolean
configuration*	object
idempotency_key	string
shipping_address*	object

Input schema (JSON)

{
  "type": "object",
  "required": [
    "configuration",
    "customer",
    "shipping_address",
    "user_consent"
  ],
  "properties": {
    "lang": {
      "enum": [
        "fr",
        "en",
        "de",
        "es",
        "it",
        "nl",
        "pt",
        "ja",
        "ko",
        "zh",
        "ar",
        "hi"
      ],
      "type": "string",
      "default": "en"
    },
    "customer": {
      "type": "object",
      "required": [
        "email",
        "first_name",
        "last_name"
      ],
      "properties": {
        "email": {
          "type": "string",
          "format": "email",
          "maxLength": 200
        },
        "phone": {
          "type": "string",
          "maxLength": 30
        },
        "last_name": {
          "type": "string",
          "maxLength": 60
        },
        "first_name": {
          "type": "string",
          "maxLength": 60
        }
      },
      "additionalProperties": false
    },
    "user_consent": {
      "type": "boolean",
      "const": true
    },
    "configuration": {
      "type": "object",
      "required": [
        "model"
      ],
      "properties": {
        "model": {
          "type": "string",
          "description": "model_id from list_models, e.g. 'v6-44-sa'."
        },
        "options": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 40,
          "description": "option_id values from describe_model. Unset components keep their default."
        },
        "engraving": {
          "type": "string",
          "maxLength": 24,
          "description": "Optional engraving text (not priced, not rendered)."
        }
      },
      "additionalProperties": false
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 80
    },
    "shipping_address": {
      "type": "object",
      "required": [
        "line1",
        "postal_code",
        "city",
        "country"
      ],
      "properties": {
        "city": {
          "type": "string",
          "maxLength": 80
        },
        "line1": {
          "type": "string",
          "maxLength": 120
        },
        "line2": {
          "type": "string",
          "maxLength": 120
        },
        "region": {
          "type": "string",
          "maxLength": 60
        },
        "country": {
          "type": "string",
          "pattern": "^[A-Za-z]{2}$",
          "description": "ISO-3166 alpha-2, e.g. 'US'."
        },
        "postal_code": {
          "type": "string",
          "maxLength": 16
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

create_share_link

Returns configurator_url (opens this exact watch in the configurator on brm-chronographes.com, where the user can adjust it and add it to the basket; this is the link meant for the user) and preview_url (a public presentation page with rotation, shared by every identical configuration). Idempotent. Sharing is not ordering.

Argument	Type	Description
lang	string
view	integer
configuration*	object

Input schema (JSON)

{
  "type": "object",
  "required": [
    "configuration"
  ],
  "properties": {
    "lang": {
      "enum": [
        "fr",
        "en",
        "de",
        "es",
        "it",
        "nl",
        "pt",
        "ja",
        "ko",
        "zh",
        "ar",
        "hi"
      ],
      "type": "string",
      "default": "en"
    },
    "view": {
      "type": "integer",
      "default": 0,
      "maximum": 29,
      "minimum": 0
    },
    "configuration": {
      "type": "object",
      "required": [
        "model"
      ],
      "properties": {
        "model": {
          "type": "string",
          "description": "model_id from list_models, e.g. 'v6-44-sa'."
        },
        "options": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 40,
          "description": "option_id values from describe_model. Unset components keep their default."
        },
        "engraving": {
          "type": "string",
          "maxLength": 24,
          "description": "Optional engraving text (not priced, not rendered)."
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

describe_model

Components, options (option_id, name, surcharge_eur, is_default), mutual exclusions (exclusive_group) and dependencies (depends_on: the component only exists if one of these options is selected). option_id values are opaque identifiers; name is the label to use with the user.

read-only

Argument	Type	Description
lang	string
model*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "model"
  ],
  "properties": {
    "lang": {
      "enum": [
        "fr",
        "en",
        "de",
        "es",
        "it",
        "nl",
        "pt",
        "ja",
        "ko",
        "zh",
        "ar",
        "hi"
      ],
      "type": "string",
      "default": "en"
    },
    "model": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_order_status

Returns only the state of the order: awaiting_customer_confirmation, confirming, confirmed_awaiting_payment, paid, expired, cancelled, confirmation_email_failed or needs_assistance. No customer data. Pass the order_id returned by create_order, or the idempotency_key you used.

read-only

Argument	Type	Description
order_id	string
idempotency_key	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "maxLength": 60
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 80
    }
  },
  "additionalProperties": false
}

list_models

Returns the configurable watch models with base price (EUR incl. French VAT), diameter and a rendered picture of the default configuration.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

quote_configuration

Price in the billing currency of the DELIVERY country (the currency cannot be chosen), with the tax regime: French VAT inside the EU, 0% VAT outside the EU (duties payable by the buyer). Indicative and non-binding; the checkout on brm-chronographes.com is authoritative.

read-only

Argument	Type	Description
lang	string
country*	string	ISO-3166 alpha-2, e.g. 'US'.
configuration*	object
display_currency	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "configuration",
    "country"
  ],
  "properties": {
    "lang": {
      "enum": [
        "fr",
        "en",
        "de",
        "es",
        "it",
        "nl",
        "pt",
        "ja",
        "ko",
        "zh",
        "ar",
        "hi"
      ],
      "type": "string",
      "default": "en"
    },
    "country": {
      "type": "string",
      "description": "ISO-3166 alpha-2, e.g. 'US'."
    },
    "configuration": {
      "type": "object",
      "required": [
        "model"
      ],
      "properties": {
        "model": {
          "type": "string",
          "description": "model_id from list_models, e.g. 'v6-44-sa'."
        },
        "options": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 40,
          "description": "option_id values from describe_model. Unset components keep their default."
        },
        "engraving": {
          "type": "string",
          "maxLength": 24,
          "description": "Optional engraving text (not priced, not rendered)."
        }
      },
      "additionalProperties": false
    },
    "display_currency": {
      "type": "string",
      "maxLength": 3
    }
  },
  "additionalProperties": false
}

render_configuration

Composes the photographic rendering of the configured watch (JPEG). view 0 is the three-quarter view; 30 views (0-29) rotate the watch by 12° each.

read-only

Argument	Type	Description
view	integer
width	integer
configuration*	object

Input schema (JSON)

{
  "type": "object",
  "required": [
    "configuration"
  ],
  "properties": {
    "view": {
      "type": "integer",
      "default": 0,
      "maximum": 29,
      "minimum": 0
    },
    "width": {
      "type": "integer",
      "default": 900,
      "maximum": 1600,
      "minimum": 300
    },
    "configuration": {
      "type": "object",
      "required": [
        "model"
      ],
      "properties": {
        "model": {
          "type": "string",
          "description": "model_id from list_models, e.g. 'v6-44-sa'."
        },
        "options": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 40,
          "description": "option_id values from describe_model. Unset components keep their default."
        },
        "engraving": {
          "type": "string",
          "maxLength": 24,
          "description": "Optional engraving text (not priced, not rendered)."
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

submit_request

Sends the user's request to the B.R.M team: 'appointment' (private visit of the manufacture — a booking link is returned), 'quote' (personalised quote by email), or 'special_request' (anything the configurator does not offer; the workshop checks feasibility). Requires the user's explicit agreement to share their email and be contacted (user_consent=true). The message cannot be recalled once sent. Never an order, never a payment. Limited to a few requests per day.

destructive

Argument	Type	Description
kind*	string
lang	string
contact*	object
country	string
message*	string	What the user wants, in their words, precise enough for the workshop.
user_consent*	boolean
configuration	object
idempotency_key	string

Input schema (JSON)

validate_configuration

Resolves defaults, exclusions and dependencies; returns valid=false with errors (unknown_option, dependency_unmet) and warnings (exclusive_conflict) that can be fixed, plus the resolved list of selections and total EUR price.

read-only

Argument	Type	Description
lang	string
configuration*	object

Input schema (JSON)

{
  "type": "object",
  "required": [
    "configuration"
  ],
  "properties": {
    "lang": {
      "enum": [
        "fr",
        "en",
        "de",
        "es",
        "it",
        "nl",
        "pt",
        "ja",
        "ko",
        "zh",
        "ar",
        "hi"
      ],
      "type": "string",
      "default": "en"
    },
    "configuration": {
      "type": "object",
      "required": [
        "model"
      ],
      "properties": {
        "model": {
          "type": "string",
          "description": "model_id from list_models, e.g. 'v6-44-sa'."
        },
        "options": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 40,
          "description": "option_id values from describe_model. Unset components keep their default."
        },
        "engraving": {
          "type": "string",
          "maxLength": 24,
          "description": "Optional engraving text (not priced, not rendered)."
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

B.R.M Chronographes - Watch Configurator

Try it

create_order Destructive

B.R.M Chronographes - Watch Configurator

Try it

create_order Destructive

Tools (9)