Available validation webhooks
Depending on your use case you might want to listen to different webhooks. At this moment there are 2 available for a validation.
- "validation.ready" it's triggered once every piece of information is gathered so you have the full validation object.
- "validation.ready_without_legal_cases" it's triggered once every job is done except for legal cases. This is because corporation with huge amounts of legal cases can take a while to be ready. We've seen some companies take a little more than 1 hour to retrieve 1000+ legal cases. This webhook is perfect if you need a more consistent and faster response. It takes less than 20 seconds for 90% of cases
How webhooks work?
Once the validation is ready we'll POST you the validation object to the url provided. It is extremely important that you return a response with http code 200 so we know you received it correctly.
In case we don't get the 200 response, we'll retry up to 20 times using exponential times between each retry. If we never get a 200 response after the 20th retry, we'll discard the webhook.
This is the body of the post we'll send to you:
note that this example response was trimmed for demonstration purposes. You can check the full validation object here
{
"type": "validation.ready",
"validation": {
"id": "val_fe0e26bcce7c671a",
"entity_validation_id": "bval_f5c7bb362a1faa0a",
"entity_name": "PLUTTO SPA",
"entity_tin": "77447361-0",
"entity_country": "CL",
"status": "created",
"created_at": "2022-10-20T13:15:39.623Z",
"contact_email": "[email protected]",
"suggested_manager_name": null,
"webhook_url": "https://yoursite.com/some-webhook-path",
"entity": {
"id": "bsn_a6058b75987582ae",
"created_at": "2022-10-20T13:15:39.410Z",
"name": "PLUTTO SPA",
"tin": "77447361-0",
"status": "active",
"country": "CL",
"legal_cases": {
"total_count": 0,
"last_case": null
},
"tax_office_data": {
"has_activity_initiation": true,
"activity_initiation_date": "2021-09-27",
"can_tax_in_foreign_money": false,
"is_small_enterprise": true,
"activities": [
{
"code": "582000",
"date": "2021-10-04",
"name": "EDICION DE PROGRAMAS INFORMATICOS",
"exempt": false,
"category": 1
},
{
"code": "620200",
"date": "2021-09-27",
"name": "ACTIVIDADES DE CONSULTORIA DE INFORMATICA Y DE GESTION DE INSTALACIONE",
"exempt": false,
"category": 1
},
{
"code": "631100",
"date": "2021-10-04",
"name": "PROCESAMIENTO DE DATOS, HOSPEDAJE Y ACTIVIDADES CONEXAS",
"exempt": false,
"category": 1
},
{
"code": "661903",
"date": "2021-10-04",
"name": "EMPRESAS DE ASESORIA Y CONSULTORIA EN INVERSION FINANCIERA; SOCIEDADES",
"exempt": false,
"category": 1
}
]
},
"formation": {
"country": "CL",
"company_type": "spa",
"constitution_date": "2021-08-27",
"date_of_document": null,
"registry": null,
"duration": null,
"activity_description": "El objeto de la sociedad será la creación, desarrollo, implementación, distribución, licenciamiento, explotación y comercialización de todo tipo de software y plataformas tecnológicas; la prestación de asesorías, consultorías y servicios en el área de operaciones, computacional y tecnológica a través de todo tipo de soportes y/o medios tecnológicos; la inversión en toda clase de bienes y productos tecnológicos, para cualquier uso: la adquisición, enajenación, administración, inversión y explotación de bienes muebles e inmuebles, incluyendo patentes, marcas, licencias, permisos y cualquier otro derecho de propiedad industrial; y, en general, ejecutar los actos y celebrar los contratos necesarios al fin indicado, al desarrollo de su actividad y a la inversión de los fondos disponibles de la sociedad.",
"administration": {
"administration_type": "Administración, representación y uso razón social: Antonia San Martín Sola",
"managers": [
{
"name": "ANTONIA SAN MARTIN SOLA",
"tin": "",
"person_id": "per_ff8a5b69b9b10c89",
"faculties": [...]
}
],
"sii_representatives": [...]
},
"equity": {
"total_amount": 1000000,
"total_shares": 10000,
"currency": "CLP",
"shares_type": null,
"shareholders": [...]
}
},
"addresses": [...]
},
"files": [...]
}
}