ContainerLatino Argentina
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.
Argentina: código postal tradicional de cuatro dígitos o CPA completo de ocho caracteres. Teléfono nacional de diez dígitos con código de área, sin 0 ni 15; +54 para fijo o +54 9 para celular. Puedes declarar la provincia o CABA con su código INDEC en entidadFederativa. La letra de un CPA completo debe coincidir con la provincia; el código de cuatro dígitos no la determina. Las cotizaciones se preparan en ARS. La recepción externa requiere una fuente argentina configurada y verificada.
Cómo utilizarla
- Consulta GET /ar/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 /ar/api/agents/v1/devisyContent-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.