API del SOAP de Chile: validar un certificado contra el registro de las aseguradoras
PlacApi expone /api/soap-cl, una API REST que valida el seguro obligatorio de un vehículo chileno contra el registro que mantienen las aseguradoras. Pide dos datos —la patente y los últimos cuatro dígitos de la póliza— porque el registro los cruza y sin los dos no responde: no es una consulta por patente, es la verificación de un certificado que ya se tiene. Devuelve si el par existe en el registro, si además sigue vigente, la aseguradora que lo emitió y el periodo de vigencia, y cuando el par existe entrega también el certificado completo.
Qué problema resuelve
El SOAP es el documento que más se falsifica de la carpeta de un vehículo chileno, porque se compra en minutos, vale poco y casi nadie lo verifica: se mira que el papel exista y que las fechas cuadren. Quien recibe un vehículo en consignación, lo arrienda, lo financia o lo asegura necesita saber si ese certificado concreto está en el registro de las aseguradoras, y no tiene forma de comprobarlo dentro de su propio sistema. Este endpoint convierte esa comprobación en una llamada REST que se puede disparar en el momento en que el documento se carga.
Para quién sirve
Arrendadoras y empresas de leasing, aseguradoras y corredores que reciben documentación de terceros, compraventas que reciben vehículos en consignación, operadores de flota que verifican la carpeta de unidades subcontratadas, y equipos de cumplimiento que auditan documentos cargados por proveedores.
Datos requeridos
- placa — la patente chilena de seis caracteres, en cualquiera de los tres formatos vigentes (BBCB01, AA1234, BBB010). Se aceptan guiones y puntos. El request acepta patente como alias del campo.
- poliza — los últimos cuatro dígitos de la póliza SOAP. También se acepta el número completo: se toman sus cuatro últimos dígitos.
- refresh — opcional: salta la caché y vuelve a preguntarle al registro. Una consulta refrescada con datos cobra.
Fuentes y cobertura
- Registro del seguro obligatorio de las aseguradoras chilenasRegistro sectorial que cruza la patente con los últimos dígitos de la póliza. Devuelve la aseguradora emisora, el número de póliza, el folio, el periodo de vigencia, la prima y la ficha del vehículo asegurado.
Por qué pide la póliza: es una verificación, no una consulta
La pregunta «¿este vehículo tiene SOAP vigente?» no se puede responder en Chile con la patente sola, y no es una limitación de este endpoint: es cómo está construido el registro. Se comprobó enviando la patente con la póliza vacía, con espacios, con un dígito y con cuatro dígitos inventados, en las dos variantes del formulario, y en todos los casos el registro contesta que no consta certificado. El cruce lo exige el servidor.
Eso cambia para qué sirve el endpoint. No es «dame el SOAP de esta patente»; es «este certificado que tengo en la mano, ¿está en el registro y hasta cuándo vale?». El caso de uso es el de quien ya recibió un documento y necesita comprobarlo, no el de quien parte de cero con una patente.
Es una diferencia que conviene tener clara antes de diseñar la pantalla que lo va a usar: el formulario tiene que pedir dos datos, y el flujo natural es el de cargar un documento, no el de buscar un vehículo.
El hallazgo valioso es el negativo
En casi toda consulta vehicular, la respuesta útil es la positiva. Aquí es al revés. Que el registro reconozca el par patente-póliza confirma lo que ya se suponía; que no lo reconozca es lo que delata un certificado falso, y es exactamente el hallazgo por el que se hace la verificación.
El contrato lo refleja en el status: es ok con certificado vigente, warn cuando el par existe pero el periodo ya venció, e info cuando el registro no reconoce el par. Ese info no es un error ni una consulta fallida, y por eso cobra igual que las otras dos: es el resultado de una verificación que sí se ejecutó.
Un cliente que trate info como «no se encontró, reintentar» va a esconder el único caso que justificaba la llamada. La lectura correcta es mostrarlo como lo que es: ese certificado no consta en el registro de las aseguradoras.
De paso entrega el dígito verificador de la patente
Cuando el par existe, la respuesta trae un campo que no tiene que ver con el seguro: el dígito verificador de la patente. Está ahí porque el detalle de multas chileno lo exige, y conseguirlo por separado es un paso más en la integración.
Quien ya validó el SOAP de un vehículo puede encadenar la consulta de multas sin volver a resolver ese dato. No cambia el precio de ninguna de las dos llamadas; simplemente evita un viaje intermedio en el flujo de verificación completa de una unidad.
¿Cómo validar el SOAP de un vehículo chileno por API?
Con una llamada POST a /api/soap-cl enviando la patente en el campo placa y los últimos cuatro dígitos de la póliza en el campo poliza, y la API key en el header x-api-key. También se acepta el número de póliza completo: se toman sus cuatro últimos dígitos.
¿Por qué hay que enviar la póliza y no basta la patente?
Porque el registro chileno cruza los dos datos y sin ellos no responde. Se probó con la póliza vacía, con espacios, con un dígito y con cuatro dígitos inventados, en las dos variantes del formulario, y siempre contesta que no consta certificado. El endpoint es una verificación de un certificado conocido, no una búsqueda por patente.
Ejemplo de solicitud
POST https://placapi.com/api/soap-cl. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.
curl -X POST 'https://placapi.com/api/soap-cl' \
-H 'x-api-key: pk_live_TU_CLAVE' \
-H 'content-type: application/json' \
-d '{"placa":"BBCB01","poliza":"1234"}'Ejemplo de respuesta
Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).
{
"source": "soat",
"status": "ok",
"data": {
"pais": "CL",
"placa": "BBCB01",
"poliza": "1234",
"encontrado": true,
"vigente": true,
"digitoVerificador": "2",
"aseguradora": "COMPAÑIA DE SEGUROS GENERALES",
"numeroPoliza": "70591234",
"folio": "9821871234",
"vigenciaInicio": "2026-04-01",
"vigenciaFin": "2027-03-31",
"tipo": "AUTOMOVIL",
"marca": "CHEVROLET",
"linea": "CORSA",
"modelo": 2006,
"numeroMotor": "7H5071910",
"prima": 7990
},
"mode": "live",
"cost": 1
}Explicación campo por campo
| Campo | Tipo | Descripción |
|---|---|---|
| status | string | ok con certificado vigente, warn si el par existe pero el periodo ya venció, info si el registro no reconoce el par. Las tres cobran. |
| data.encontrado | boolean | Si el registro reconoce el par patente-póliza. En false es el hallazgo que delata un certificado falso. |
| data.vigente | boolean | Si además del par existir, el periodo de vigencia cubre la fecha de hoy. |
| data.aseguradora | string | null | Compañía que emitió el certificado. |
| data.numeroPoliza | string | null | Número completo de la póliza según el registro. |
| data.folio | string | null | Folio del certificado. |
| data.vigenciaInicio | string (fecha) | null | Inicio del periodo cubierto. |
| data.vigenciaFin | string (fecha) | null | Fin del periodo cubierto. Es la fecha sobre la que se calculan los avisos de renovación. |
| data.prima | number | null | Prima del seguro en pesos chilenos. |
| data.digitoVerificador | string | null | Dígito verificador de la patente. Es el dato que exige el detalle de multas chileno, y viene de regalo con la validación. |
| data.tipo, marca, linea, modelo, numeroMotor | string | number | null | Ficha del vehículo asegurado según el registro. Sirve para comprobar que la póliza cubre el vehículo que se tiene delante y no otro. |
| mode | string | live si se consultó el registro en ese momento; cache si vino de caché. Un hit de caché no cobra crédito. |
Tiempo de respuesta
Mediana de 8,5 segundos, medida el 5 de septiembre de 2026 sobre tres consultas en vivo (6,5, 8,5 y 9,5 segundos). Es con diferencia el endpoint más rápido del bloque chileno —toca un solo registro— y el único del bloque que se puede llamar dentro de un flujo web sin que la espera resulte incómoda, aunque conviene igual hacerlo de forma asíncrona al cargar el documento.
Precio y cobro
1 crédito por consulta con datos, desde 349 COP. El precio por crédito baja por volumen: 349 COP desde 30, 249 COP desde 1.000, 149 COP desde 5.000, 139 COP desde 10.000, 119 COP desde 20.000, 99 COP desde 50.000. Los créditos se compran por adelantado (mínimo 30 = 10.470 COP), no vencen y no hay mensualidad. El mismo precio aplica por la web y por API. Solo se cobra cuando la consulta devuelve datos; por API, las consultas sin resultado (404) tienen 10 gratis al mes por cada tipo de respuesta sin datos y después cobran igual.
Caché y actualización
Por patente y póliza a la vez, veinticuatro horas. Compartir la caché por patente sola serviría el certificado de una póliza por el de otra, que es justo el error que este endpoint existe para evitar. Un hit de caché no cobra. Con refresh en true se vuelve a preguntarle al registro, y esa consulta, si trae datos, cobra.
Seguridad y privacidad
La placa y el documento se usan solo para ejecutar la consulta; el resultado queda en caché temporal. No se almacenan datos de tarjetas (los pagos los procesa Wompi). Ver privacidad y seguridad.
Limitaciones y posibles errores
- No responde «¿esta patente tiene SOAP?». Sin los últimos cuatro dígitos de la póliza el registro contesta que no consta certificado, así que el endpoint sirve para verificar un documento que ya se tiene, no para descubrir uno que no se conoce.
- Chile no tiene un registro público de pólizas vigentes consultable por patente sola. Cualquier servicio que prometa eso está prometiendo algo que la fuente no entrega.
- Una póliza mal transcrita se ve exactamente igual que un certificado falso: las dos devuelven encontrado en false. Antes de reportar un documento como no válido conviene reintentar con el número tomado del papel.
- No devuelve datos del asegurado. La legislación chilena de protección de datos personales trata esa información como personal y PlacApi no la publica en ningún país.
- Un par que el registro no reconoce es una respuesta válida y cobra 1 crédito: es el hallazgo que se vino a comprar. Lo que no cobra es un fallo de la fuente, que devuelve data en null y reembolsa el crédito reservado.
Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.
Otras preguntas frecuentes
¿Se puede saber si una patente tiene SOAP vigente sin conocer la póliza?
+
No en Chile. No existe un registro público de pólizas vigentes consultable por patente sola, y por eso PlacApi no ofrece ese endpoint: preferimos no prometer un dato que la fuente no entrega.
¿Qué significa que el registro no reconozca el par?
+
Que ese certificado no consta. Es el resultado por el que se hace la verificación —es lo que delata un documento falso— y llega con status info, no como error. Antes de reportarlo conviene reintentar con el número tomado del papel, porque una póliza mal transcrita produce la misma respuesta.
¿Cobra si el certificado no aparece?
+
Sí, 1 crédito. La consulta se ejecutó contra el registro y devolvió el dato que se vino a buscar. Lo que no cobra es un fallo de la fuente o de la salida de red, que devuelve data en null y reembolsa el crédito reservado.
¿Para qué sirve el dígito verificador que devuelve?
+
Es el dato que exige el detalle de multas chileno. Quien valida el SOAP de un vehículo y después consulta sus multas se ahorra un paso intermedio de la integración.
Seguir explorando
Última revisión: 5 de septiembre de 2026 · Versión de la API: v1 · Fuentes y metodología