doorax.nl

resolve_certificate_code

## Use when A customer sent a photo of a security card / certificate, or typed its code, and you need to know which model to reorder. Read the code off the card and pass it verbatim; never derive a model from a code yourself. A card can show other printed boxes next to the code, such as a generation marker (e.g. "G2"). Those do not belong to the code: leave them out, pass only the code itself. Pass `brand` whenever the card shows one (M&C, ABUS, DOM, NEMEF, EVVA). It is how a wrong reading gets caught: if the code resolves to models of another brand, `brand_conflict` comes back true and you must not answer from this result. Pass `reorder_type` only when the customer already said whether they need a cylinder (1) or keys (2). ## What it does Normalises the code (strips spaces and punctuation, uppercases) and matches it against the reorder code patterns of the webshop, the same list the shop's own reorder filter uses. Returns the candidate models plus the matching reorder products. ## Returns - `code`: the normalised code. - `models`: candidate models, most often one. Several means the code alone cannot tell them apart; the model name printed on the card decides, otherwise ask the customer. - `products`: reorder products per candidate model, with `url`, `brand` and `reorder_type` (1 = cylinder, 2 = keys). More than one product of the same `reorder_type` can come back for a single model, for example a sluitplan variant next to the regular version, or two different SKG levels, and they are genuinely different products. This tool never picks between them; ask the customer which one matches their situation instead of guessing. - `brand_conflict`: true when `brand` was given and none of the products carry it. Candidates are matched by name, so a `products` entry can belong to a model whose name only resembles the resolved model (e.g. a "+" variant of it). Have the customer confirm the exact product before ordering; never just take the first one. An empty `models` means the…

Input schema

{
  "properties": {
    "code": {
      "description": "The code as printed or stamped on the card, verbatim.",
      "type": "string"
    },
    "brand": {
      "description": "Brand shown on the card (M&C, ABUS, DOM, NEMEF, EVVA), for the conflict check.",
      "type": [
        "string",
        "null"
      ]
    },
    "reorder_type": {
      "description": "1 = cylinder, 2 = keys. Omit when unknown.",
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "type": "object",
  "required": [
    "code"
  ]
}