Revisamos el Coche

Traduce lo que ha dicho la persona («un Golf», «una furgoneta») a un tipo de vehículo del catálogo y devuelve las revisiones disponibles. Si no se puede saber con seguridad de qué vehículo habla, NO elige: devuelve la lista para que preguntes cuál es.

{
  "type": "object",
  "properties": {
    "tipo_vehiculo": {
      "type": "string",
      "description": "Lo que ha dicho la persona sobre su vehículo, tal cual."
    }
  },
  "required": [
    "tipo_vehiculo"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

El precio de la revisión para ese vehículo, esos informes y esa provincia. Es el mismo número que enseña la web: no lo calcules tú ni lo redondees.

{
  "type": "object",
  "properties": {
    "tipo_vehiculo_id": {
      "type": "integer"
    },
    "tipo_informe_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "minItems": 1
    },
    "provincia": {
      "type": "string",
      "description": "La provincia por su nombre (\"Pontevedra\", \"A Coruña\"). Usa esto si no te ha dado el id la plataforma; no inventes ids."
    },
    "provincia_id": {
      "type": "integer"
    },
    "ciudad_id": {
      "type": "integer"
    },
    "token_perito": {
      "type": "string",
      "description": "Solo si se pregunta por el precio de un perito concreto."
    }
  },
  "required": [
    "tipo_vehiculo_id",
    "tipo_informe_ids"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Los peritos que cubren esa provincia y ese tipo de vehículo, con su valoración y su precio. Los que están de vacaciones no salen.

{
  "type": "object",
  "properties": {
    "tipo_vehiculo_id": {
      "type": "integer"
    },
    "provincia": {
      "type": "string",
      "description": "La provincia por su nombre (\"Pontevedra\", \"A Coruña\"). Usa esto si no te ha dado el id la plataforma; no inventes ids."
    },
    "provincia_id": {
      "type": "integer"
    }
  },
  "required": [
    "tipo_vehiculo_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Si ese perito está disponible entre esas dos fechas. Aviso: la plataforma no tiene agenda por horas, así que esto dice si está o no ausente. La fecha concreta se acuerda después con el perito. No prometas una hora.

{
  "type": "object",
  "properties": {
    "token_perito": {
      "type": "string"
    },
    "desde": {
      "type": "string",
      "description": "AAAA-MM-DD"
    },
    "hasta": {
      "type": "string",
      "description": "AAAA-MM-DD"
    }
  },
  "required": [
    "token_perito",
    "desde",
    "hasta"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

El estado de una solicitud ya hecha. Hacen falta la referencia y el correo con el que se creó: con la referencia sola no se abre.

{
  "type": "object",
  "properties": {
    "token_reserva": {
      "type": "string"
    },
    "email": {
      "type": "string",
      "format": "email"
    }
  },
  "required": [
    "token_reserva",
    "email"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Da de alta la solicitud de revisión. Es la ÚNICA herramienta que crea algo. Antes de llamarla tienes que haberle dicho a la persona, en voz alta, qué va a contratar —vehículo, informe, provincia y precio— y haber recibido un sí. Ese mismo texto va en `resumen_confirmado`. Si lo dejas vacío, no se crea nada: se te devuelve el resumen para que lo leas.

{
  "type": "object",
  "properties": {
    "nombre": {
      "type": "string"
    },
    "apellidos": {
      "type": "string"
    },
    "email": {
      "type": "string",
      "format": "email"
    },
    "telefono": {
      "type": "string",
      "minLength": 9,
      "maxLength": 9,
      "description": "Nueve dígitos, como pide el formulario."
    },
    "tipo_vehiculo_id": {
      "type": "integer"
    },
    "tipo_informe_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "minItems": 1
    },
    "pais_id": {
      "type": "integer"
    },
    "provincia": {
      "type": "string",
      "description": "La provincia por su nombre (\"Pontevedra\", \"A Coruña\"). Usa esto si no te ha dado el id la plataforma; no inventes ids."
    },
    "provincia_id": {
      "type": "integer"
    },
    "ciudad": {
      "type": "string",
      "description": "La ciudad donde está el coche, tal cual la dice la persona. No inventes un id: la plataforma la busca en la provincia y, si no la encuentra, te devuelve parecidas para preguntar."
    },
    "ciudad_id": {
      "type": "integer",
      "description": "Solo si la plataforma te ha dado ya el id de esa ciudad."
    },
    "movimiento_vehiculo": {
      "type": "integer",
      "minimum": 0,
      "description": "Kilómetros de desplazamiento extra que pide la persona, si los hay. Si no lo sabe, no lo mandes: vale 0."
    },
    "autorizacion_vendedor": {
      "type": "boolean"
    },
    "informacion_vendedor": {
      "type": "string"
    },
    "acepta_condiciones": {
      "type": "boolean"
    },
    "modo_seleccion": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2,
      "description": "1 = que le propongan peritos. 2 = un perito concreto."
    },
    "token_perito": {
      "type": "string"
    },
    "resumen_confirmado": {
      "type": "string",
      "description": "Lo que le has leído a la persona y ha aceptado. Sin esto no se crea nada."
    },
    "clave_idempotencia": {
      "type": "string",
      "description": "Para no duplicar. Si reintentas la MISMA solicitud, manda la misma clave."
    }
  },
  "required": [
    "nombre",
    "apellidos",
    "email",
    "telefono",
    "tipo_vehiculo_id",
    "tipo_informe_ids",
    "autorizacion_vendedor",
    "informacion_vendedor",
    "acepta_condiciones",
    "modo_seleccion"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}