ContainerLatino Colombia

API de cotizaciones para agentes IA

Cualquier asistente puede preparar y enviar una solicitud de cotización con el permiso de la persona interesada. No hace falta registrarse ni crear una clave API.

Colombia: código postal de seis dígitos, con sus ceros iniciales; celular de 10 dígitos que empieza por 3 o teléfono fijo con 60, indicativo regional y siete dígitos. El prefijo +57 es opcional. Puedes declarar el departamento o Bogotá D.C. con su código DANE en entidadFederativa; debe coincidir con el prefijo del código postal. Las cotizaciones se preparan en COP. La recepción externa depende de la configuración de la nueva fuente colombiana.

Cómo utilizarla

Consulta GET /co/api/agents/v1/devis para leer el esquema JSON, los valores admitidos, los campos obligatorios, un ejemplo y el estado de configuración local en disponibilidad. Este GET no verifica el servicio externo.
Recoge los datos del proyecto y presenta a la persona el texto de consentimiento que devuelve la API.
Después de recibir su autorización, envía un objeto JSON con POST /co/api/agents/v1/devis y Content-Type: application/json.

Consentimiento quotbox-marketplace-v1: Acepto que ContainerLatino registre y trate mi solicitud y, cuando la conexión con Quotbox esté operativa y se confirme su recepción, ponga mi proyecto y mis datos de contacto a disposición de un máximo de 5 profesionales seleccionados en Quotbox para que puedan responder con cotizaciones. El registro local no confirma un envío a proveedores. Esta solicitud no me inscribe en campañas publicitarias.

El agente debe incluir consentement: true y consentimientoQuotboxAgente: "quotbox-marketplace-v1"solo después de obtener ese consentimiento. El teléfono del ejemplo es un marcador: usa el número real facilitado por la persona interesada. La URL privada de Quotbox se utiliza únicamente en el servidor.

Respuestas

200: Quotbox ha creado un Lead para los profesionales inscritos.
202: la solicitud está guardada y su entrega a Quotbox sigue pendiente. Conserva la referencia; no crees otra solicitud.
422: faltan datos o hay campos inválidos.
429: se ha alcanzado un límite de solicitudes; consulta Retry-After.

También pueden devolverse 400 para JSON ilegible, 413 para un cuerpo demasiado grande, 415 para otro tipo de contenido y 503 cuando la recepción no está disponible. Solo después de una recepción confirmada en Quotbox, los datos de contacto pueden ser consultados por un máximo de 5 profesionales seleccionados para esta solicitud, conforme al consentimiento.