ContainerLatino México

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.

México: código postal de cinco dígitos, con sus ceros iniciales; teléfono nacional de 10 dígitos o +52 y 10 dígitos. Puedes declarar la entidad federativa con su clave INEGI en entidadFederativa; el código postal no la asigna automáticamente. Las cotizaciones se preparan en MXN. La recepción externa depende de la configuración de la nueva fuente mexicana.

Cómo utilizarla

Consulta GET /mx/api/agents/v1/devis para leer el esquema JSON, los valores admitidos, los campos obligatorios y un ejemplo.
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 /mx/api/agents/v1/devis y Content-Type: application/json.

Consentimiento quotbox-marketplace-v1: Acepto que ContainerLatino trate mi solicitud y ponga mi proyecto y mis datos de contacto a disposición de un máximo de 5 profesionales registrados en Quotbox para que puedan responder con cotizaciones. 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.

Duración y datos del proyecto

Para rentar, o para describir un campamento completo en compra, indica dureeMois de 1 a 120 meses o dureeDemandee, un texto de hasta 120 caracteres con días, semanas o fechas. Usa una sola forma; puedes escribir por confirmar si la duración todavía no se conoce. No conviertas una renta de siete días en un mes ficticio. Comprar una caseta unitaria no requiere duración.

Los datos de la obra son facultativos. chantier.effectifTotal describe el total del proyecto; effectifHommes y effectifFemmes describen personas presentes al mismo tiempo. Si se declaran los tres, la suma simultánea no puede superar el total. Un dato ausente queda por precisar y un cero declarado sigue siendo cero. mobile y travauxSalissants aceptan únicamente valores booleanos; omítelos si no se conocen. No se calculan aquí cantidades legales de equipamiento.

Puedes conservar la zona de la consulta mediante zoneOrigine, una de las ocho zonas publicadas en el esquema. Es un contexto de búsqueda: el municipio, la entidad federativa y el código postal de entrega se declaran por separado. Los campos facultativos desconocidos se omiten; los valores null, tipos incorrectos, controles y Unicode mal formado se rechazan.

Respuestas

200: Quotbox ha confirmado la recepción de la solicitud, también cuando el mismo envío ya se recibió. La disponibilidad para profesionales depende de la fuente y del alcance configurados.
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. Los datos de contacto pueden ser consultados por un máximo de 5 profesionales registrados, conforme al consentimiento.

El contrato GET informa si la configuración local de recepción está presente. Ese dato no confirma una conexión real ni que el Lead sea visible o esté disponible para profesionales elegibles.