--- agentTools: projectIndex: https://docs.boostr.cl/llms.txt --- # 🔐 Búsqueda masiva Servicio que permite buscar en batch mas de un RUT Este servicio permite buscar más de un RUT masivamente en *batch*. Una vez se ejecuta el proceso se enviará el resultado a la URL indicada. El RUT puede venir en formato: * 11111111-1 * 11.111.111-1 > 📘 Restricciones > > La cantidad de RUT que puedes enviar, está estrechamente relacionada con el la cuota diaria asociada al Plan contratado. > > Como ejemplo: Si tu plan tiene una cuota diaria de 100 consultas, ese será tu limite de RUTs a enviar, si bien puedes enviar más (**el límite es 500**) una vez se consuma tu cuota no procesaremos los RUT restantes. Considera que utilizar este servicio también te consume una consulta de tu cuota diaria. ## Callback Este servicio envía los resultados en formato **JSON** a la URL que se indique en el atributo **callback** indicando por medio de **include** que quieres incluir las actividades económicas.\ El llamado a la URL indicada será vía POST con el siguiente formato: ```json Response { "status": "success", "job_id": "ae985a8d-deed-4d59-b293-d4345d6a51f2", "data": [ { "status": "success", "found": true, "document_number": 8008573, "dv": "7", "name": "CAROLINA MONTSERRAT TOHA MORALES", "activities": [ { "activity": "OTRAS ACTIVIDADES DE SERVICIOS DE APOYO A LAS EMPRESAS N.C.P.", "code": "829900", "category": "Segunda", "iva": "No", "date": "01-01-1993" } ], "first_name": "CAROLINA MONTSERRAT", "last_name": "TOHA", "second_last_name": "MORALES" }, { "status": "success", "found": true, "document_number": 15642007, "dv": "7", "name": "NICOLÁS COSTABAL GONZÁLEZ", "activities": [ { "activity": "ACTIVIDADES DE CONTABILIDAD, TENEDURIA DE LIBROS Y AUDITORIA; CONSULTO", "code": "692000", "category": "Segunda", "iva": "No", "date": "04-02-2008" } ], "first_name": "NICOLÁS", "last_name": "COSTABAL", "second_last_name": "GONZÁLEZ" }, { "status": "success", "found": true, "document_number": 16163631, "dv": "2", "name": "GABRIEL BORIC FONT", "activities": [ { "activity": "ACTIVIDADES DE ARTISTAS REALIZADAS DE FORMA INDEPENDIENTE: ACTORES, MU", "code": "900003", "category": "Segunda", "iva": "No", "date": "28-03-2019" } ], "first_name": "GABRIEL", "last_name": "BORIC", "second_last_name": "FONT" }, { "status": "success", "found": false, "document_number": 24748956, "dv": "8" } ] } ``` Si es que se obtiene una respuesta `status != 200` se reintentará máximo 3 veces. Luego de eso los resultados quedarán disponibles en [Consulta resultados](https://docs.boostr.cl/reference/rut-get-name-batch-status) para consultar vía API.\ Esta data se mantendrá por 24 horas, luego de eso se eliminará permanentemente. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "API", "version": "1.0" }, "servers": [ { "url": "https://api.boostr.cl/" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "name": "X-API-KEY", "in": "header" } } }, "security": [ { "sec0": [] } ], "paths": { "/rut/name.json": { "post": { "summary": "🔐 Búsqueda masiva", "description": "Servicio que permite buscar en batch mas de un RUT", "operationId": "rut-get-name-batch", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "documents", "callback_url" ], "properties": { "documents": { "type": "array", "description": "Listado de RUT que se quieren buscar, el RUT debe incluir el dígito verificador.", "items": { "type": "string" } }, "callback_url": { "type": "string", "description": "URL donde notificaremos el resultado de la búsqueda", "default": "https://strong-falcon-66.webhook.cool" }, "include": { "type": "array", "description": "Indica qué datos quieres, por ejemplo: activities o ia (si tu plan lo incluye)", "items": { "type": "string" } } } }, "examples": { "Petición Full": { "value": { "documents": [ "8008573-7", "16163631-2", "24748956-8", "15642007-7" ], "callback_url": "https://strong-falcon-66.webhook.cool", "include": [ "activities", "ia" ] } } } } } }, "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n\t\"status\": \"success\",\n\t\"data\": {\n \"job_id\": \"da44703a-0c2e-496b-91c7-9d5fc345b3a5\",\n \"total_documents\": 4,\n \"include\": [\n \"activities\", \n \"ia\"\n\t\t],\n \"callback_url\": \"https://strong-falcon-66.webhook.cool\"\n\t}\n}" } }, "schema": { "type": "object", "properties": { "status": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "job_id": { "type": "string", "example": "da44703a-0c2e-496b-91c7-9d5fc345b3a5" }, "total_documents": { "type": "integer", "example": 4, "default": 0 }, "include": { "type": "array", "items": { "type": "string", "example": "activities" } }, "callback_url": { "type": "string", "example": "https://strong-falcon-66.webhook.cool" } } } } } } } }, "400": { "description": "400", "content": { "application/json": { "examples": { "Faltan campos obligatorios": { "value": "{\n \"status\": \"error\",\n \"data\": \"\",\n \"code\": \"U-20\",\n \"message\": \"Faltan RUT o la URl Callback para procesar el batch.\"\n}" }, "Mas ruts del permitido": { "value": "{\n \"status\": \"error\",\n \"data\": \"\",\n \"code\": \"U-21\",\n \"message\": \"Enviaste mas RUTs del permitido, el limite es 500.\"\n}" } }, "schema": { "oneOf": [ { "title": "Faltan campos obligatorios", "type": "object", "properties": { "status": { "type": "string", "example": "error" }, "data": { "type": "string", "example": "" }, "code": { "type": "string", "example": "U-20" }, "message": { "type": "string", "example": "Faltan RUT o la URl Callback para procesar el batch." } } }, { "title": "Mas ruts del permitido", "type": "object", "properties": { "status": { "type": "string", "example": "error" }, "data": { "type": "string", "example": "" }, "code": { "type": "string", "example": "U-21" }, "message": { "type": "string", "example": "Enviaste mas RUTs del permitido, el limite es 500." } } } ] } } } }, "429": { "description": "429", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"status\": \"error\",\n \"data\": \"\",\n \"code\": \"RATELIMIT\",\n \"message\": \"429 Too Many Request\",\n \"details\": \"Superaste el límite máximo permitido.\"\n}" } }, "schema": { "type": "object", "properties": { "status": { "type": "string", "example": "error" }, "data": { "type": "string", "example": "" }, "code": { "type": "string", "example": "RATELIMIT" }, "message": { "type": "string", "example": "429 Too Many Request" }, "details": { "type": "string", "example": "Superaste el límite máximo permitido." } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": false, "proxy-enabled": false }, "x-readme-fauxas": true, "_id": "654e7dc803529d00186e828b:691de1d84462cddb9f4d3200" } ```