`get_quote`

Una cotizacion, para el agente que la pidio, con el bloque pago

GET https://emporium.ultravioletadao.xyz/api/businesses/{slug}/quotes/{quote_id}

Por dónde se llega

API REST	Solo lectura	`GET https://emporium.ultravioletadao.xyz/api/businesses/{slug}/quotes/{quote_id}`
MCP	Solo lectura	`emporium_read_quote` POST https://emporium.ultravioletadao.xyz/mcp
CLI	Muy pronto
SDK de Python	Muy pronto
SDK de TypeScript	Muy pronto
SDK de Rust	Muy pronto

Vivo: se usa hoy, para leer y para escribir. Solo lectura: hoy se lee y no se escribe. Muy pronto: todavía no está.

Parámetros

Nombre	Dónde	Requerido	Esquema
`slug`	camino	sí	`string`
`quote_id`	camino	sí	`string`
`clave`	consulta	sí	`string`

El cuerpo de la petición

No lleva cuerpo.

Respuestas

`200`

Correcto

application/json

{
  "$ref": "#/components/schemas/CotizacionDelPedidor"
}

Cualquier otro status

Un error: en JSON, el sobre único, cuyo error.codigo es uno de una lista cerrada

application/json

{
  "$ref": "#/components/schemas/SobreDeError"
}

Esquemas

Los que nombra esta operación, tal cual están en components.schemas del contrato.

CodigoDeError

{
  "enum": [
    "dominio_invalido",
    "slug_ocupado",
    "tenant_no_encontrado",
    "tenant_no_publicado",
    "tenant_suspendido",
    "clave_invalida",
    "estado_no_permite",
    "ventana_no_cumplida",
    "metodo_invalido",
    "manifiesto_invalido",
    "categoria_prohibida",
    "terminos_no_aceptados",
    "canal_no_confirmado",
    "version_de_terminos_desconocida",
    "pedido_invalido",
    "faltan_datos",
    "respuesta_invalida",
    "firma_invalida",
    "enlace_vencido",
    "enlace_ya_usado",
    "demasiadas_peticiones",
    "parametro_invalido",
    "metodo_no_permitido",
    "firma_no_configurada",
    "correo_no_configurado",
    "terminos_no_configurados",
    "casa_no_configurada",
    "almacen_no_disponible",
    "error_interno",
    "paybox_no_configurado",
    "boveda_no_disponible",
    "sesion_requerida",
    "estado_oauth_invalido",
    "consentimiento_rechazado",
    "concesion_insegura",
    "paybox_no_responde",
    "paybox_rechazo",
    "sin_vinculo",
    "vinculo_revocado",
    "vinculo_vencido",
    "reconexion_requerida",
    "vinculo_ajeno",
    "renovacion_en_curso"
  ],
  "type": "string"
}

CotizacionDelPedidor

{
  "properties": {
    "comprometible": {
      "type": "boolean"
    },
    "cotizacion_id": {
      "type": "string"
    },
    "estado": {
      "$ref": "#/components/schemas/EstadoCotizacion"
    },
    "oferta_id": {
      "type": "string"
    },
    "oferta_no_disponible": {
      "type": [
        "string",
        "null"
      ]
    },
    "origen": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/OrigenCotizacion"
        },
        {
          "type": "null"
        }
      ]
    },
    "origen_del_estado": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/OrigenDelEstado"
        },
        {
          "type": "null"
        }
      ]
    },
    "pago": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/Pago"
        },
        {
          "type": "null"
        }
      ]
    },
    "pedida_en": {
      "type": "string"
    },
    "pedidor_es_operador": {
      "type": "boolean"
    },
    "respondida_en": {
      "type": [
        "string",
        "null"
      ]
    },
    "respuesta": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/RespuestaPublica"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "comprometible",
    "cotizacion_id",
    "estado",
    "oferta_id",
    "origen",
    "pago",
    "pedida_en",
    "pedidor_es_operador",
    "respondida_en",
    "respuesta"
  ],
  "type": "object"
}

CuerpoDelError

{
  "additionalProperties": false,
  "properties": {
    "codigo": {
      "$ref": "#/components/schemas/CodigoDeError"
    },
    "detalles": {
      "items": {
        "$ref": "#/components/schemas/Detalle"
      },
      "type": "array"
    },
    "mensaje": {
      "type": "string"
    },
    "peticion_id": {
      "type": "string"
    }
  },
  "required": [
    "codigo",
    "detalles",
    "mensaje",
    "peticion_id"
  ],
  "type": "object"
}

Detalle

{
  "additionalProperties": false,
  "properties": {
    "campo": {
      "type": "string"
    },
    "problema": {
      "type": "string"
    }
  },
  "required": [
    "campo",
    "problema"
  ],
  "type": "object"
}

EstadoCotizacion

{
  "enum": [
    "pendiente",
    "avisada",
    "respondida",
    "aceptada",
    "pagada",
    "confirmada",
    "vencida",
    "anulada"
  ],
  "type": "string"
}

MedioConMonto

{
  "properties": {
    "activo": {
      "type": [
        "string",
        "null"
      ]
    },
    "host": {
      "type": [
        "string",
        "null"
      ]
    },
    "moneda": {
      "type": "string"
    },
    "monto": {
      "type": "string"
    },
    "red": {
      "type": [
        "string",
        "null"
      ]
    },
    "referencia": {
      "type": "string"
    },
    "tipo": {
      "type": "string"
    },
    "url": {
      "type": "string"
    }
  },
  "required": [
    "host",
    "moneda",
    "monto",
    "referencia",
    "tipo",
    "url"
  ],
  "type": "object"
}

OrigenCotizacion

{
  "enum": [
    "afirmado_por_negocio"
  ],
  "type": "string"
}

OrigenDelEstado

{
  "enum": [
    "afirmado_por_negocio",
    "afirmado_por_pedidor"
  ],
  "type": "string"
}

Pago

{
  "properties": {
    "aviso": {
      "type": "string"
    },
    "medios": {
      "items": {
        "$ref": "#/components/schemas/MedioConMonto"
      },
      "type": "array"
    },
    "moneda": {
      "type": "string"
    },
    "monto": {
      "type": "string"
    },
    "origen": {
      "$ref": "#/components/schemas/OrigenCotizacion"
    },
    "referencia": {
      "type": "string"
    },
    "vence_en": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "aviso",
    "medios",
    "moneda",
    "monto",
    "origen",
    "referencia",
    "vence_en"
  ],
  "type": "object"
}

RespuestaPublica

{
  "properties": {
    "mensaje": {
      "type": [
        "string",
        "null"
      ]
    },
    "moneda": {
      "type": [
        "string",
        "null"
      ]
    },
    "monto": {
      "type": [
        "string",
        "null"
      ]
    },
    "precio_texto": {
      "type": [
        "string",
        "null"
      ]
    },
    "validez_horas": {
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "required": [
    "mensaje",
    "moneda",
    "monto",
    "precio_texto",
    "validez_horas"
  ],
  "type": "object"
}

SobreDeError

{
  "additionalProperties": false,
  "properties": {
    "error": {
      "$ref": "#/components/schemas/CuerpoDelError"
    }
  },
  "required": [
    "error"
  ],
  "type": "object"
}