Solicitud de póliza

Con un scoring aprobado, es imprescindible subir el contrato de arrendamiento antes de solicitar la póliza, ya que este documento es un requisito fundamental para continuar con el proceso.

Una vez cumplido este paso, podremos proceder con la solicitud de creación de la póliza. El resultado de esta operación nos confirma que el proyecto de póliza ha sido correctamente guardado en la aseguradora. Recuerda que, si bien este proceso es paralelo a la subida de documentación, suele ser una práctica recomendada realizarla después de cargar los documentos necesarios.

Request

📌 Recuerda que Avalsito dispone de varios entornos. Para más información, consulta 🔍 Enviroment .

Solicitamos la póliza :

1- En Authorization comprobamos los parámetros.

2- Con una solicitud tipo ‘Post’ apuntaremos a la URL del entorno necesario.

3- Indicaremos en el Body la estructura de datos requerida en formato JSON.

4- Código cURL.

⚠️ Es imprescindible que el Contrato de arrendamiento esté cargado antes de continuar con el proceso.

1. Authorization (Postman)

Key	Value	Requirement	DataType
Auth Type	Bearer Token	Required	parameter
Token	access_token	Required	String *

(*)access_token lo introduciremos en Postman sin comillas, a pesar de ser un String.

2. Enter URL (Postman)

Key	Value
URL	{baseURL}
Method	Post
Content-Type	raw

3. Body (Postman)

Variable	Description	Requirement	DataType
userName	Nombre de usuario	Required	String
password	Contraseña de usuario	Required	String
ContractingId	Identificador de operación	Required	String
DateBegining	Fecha inicio de póliza	Required	String
ContractStartDate	Fecha inicio del contrato de arrendamiento	Required	DateTime
LeaseContract*	Identificador del usuario	Required	String
Payer*	Identificador del emisor del pago	Required	Int
owner	Propietario del inmueble	Required	Owner

🔷userName: Identificación del usuario que realiza la solicitud (diferente al usuario vinculado a la compañía), proporcionada por el equipo de IT de Avalisto.

🔷password: Clave de acceso vinculada al usuario, también suministrada por el equipo de IT de Avalisto.

🔷ContractingId: Identificador de la operación, requerido para continuar con las acciones relacionadas, proporcionado en él Response de Scoring Request.

🔷DateBegining: Fecha en la que inicia la póliza, esta NO debe ser anterior a la fecha en la que se hace la solicitud.

🔷ContractStartDate: Fecha de inicio del contrato de arrendamiento, esta podrá ser anterior a la fecha en la que se hace la solicitud.

🔄 *LeaseContract es la referencia para la póliza que el cliente utiliza en su sistema. Con esta información, Avalisto permite relacionar los identificadores de ambas partes para una gestión más eficiente.

👉 *Payer es obligatorio y, salvo comunicación expresa, su valor será 8.

3.1 Owner

Variable	Description	Requirement	DataType
Person	Datos del propietario	Required	Person

3.1.1 Person

Variable	Description	Requirement	DataType
Id*	Id del propietario	Required	Int
address	Datos Dirección del propietario	Required	Address
personalData	Información personal del propietario	Required	PersonalData

👉 *Id es obligatorio y, salvo comunicación expresa, su valor será 0.

3.1.2 Address

Variable	Description	Requirement	DataType
fullAddress	Calle, número, piso	Required	String
zipCode	Código postal	Required	String
town	Población	Required	String
province	Provincia	Required	String
additionalInfo*	Información adicional del propietario	Required	String

🔷 fullAddress: Todos los datos de la description son obligatorios, importante separar cada uno de ellos por una coma (Ejemplo en la estructura JSON).

🔷 zipCode: El Código postal debe corresponder a la zona seleccionada, si comienza con un 0 este nunca debe omitirse.

🔷 town: Población.

🔷 province: Provincia.

🔷 additionalInfo: Añada si lo desea información adicional referente a la dirección, si NO desea añadir nada, el campo debe contener valor null.

3.1.3 personalData

Variable	Description	Requirement	DataType
documentNumber	Número de documento	Required	String
documentType	Tipo de documento	Required	String
email	Email de contacto	Required	String
fullName	Nombre y apellidos	Required	String
firstName	Nombre	Required	String
lastName	Apellidos	Required	String
phones	Teléfonos de contacto	Required	String [ ]

🔷 documentNumber: Números y letras del documento.

🔷 documentType: El tipo de documento será NIF, NIE o CIF; este formato debe coincidir con el documentNumber.

documentNumber(00000000T) + documentType(CIF) = Error.

documentNumber(00000000T) + documentType(NIF) = Válido.

🔷 email: Email de contacto.

🔷 fullName: firstName + lastName, sin comas.

🔷 firstName: Nombre.

🔷 lastName: Apellidos.

🔷 phones: Array para tantos teléfonos de contacto como queramos.

4. Código cURL

curl --location 'https://api.avalisto.com/api/requestPolicy' \
--header 'Authorization: Bearer D4pWQm1fpIAaAZvtiJAuoLUiciRugow-uqXzEPcvdnmHpurmnfNBRbaVr1IC9L7kxaRjpHePK9nCSJarwC-TMm5BXw2J3nl2Y5-m7n2PkqF5J3bGqRUx-mc4PJ6PQhcdlLqzIggQCvJaMG1hodnEIoWFk1KjAtzY0_z8BUH74oE1_DUUFJFPgnaeTVghNOsSRufzChs2GjcQYhtmwJr1no5v_l6J7GybDpLFQ1C7DwrHAfPcA0B6xyk2-fKdCNvX8j1HTFMR4szxyU2mSnbyyz1tvDRz6-izZ8q5VrA3qMFpnFL_YBnkaajGFgRAYQcf' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userName": "userDocuavalistocom",
    "password": "passwordDocu",
    "ContractingId": 0000,
    "DateBegining": "11/03/2025",
    "Payer": 8,
    "owner":
     {
        "person":
        {
            "Id": 0,
            "address":
            {
                "fullAddress": "Calle Santa Teresa de Jesús, 62,1ºb",
                "zipCode": "28909",
                "town": "Getafe",
                "province": "Madrid",
                "additionalInfo": null
            },
            "personalData":
            {
                "documentNumber": "00000000M",
                "documentType": "NIF",
                "email": "emailDocu@avalisto.com",
                "fullName": "NombreDocu Apellido1Docu Apellido2Docu",
                "firstName": "NombreDocu",
                "lastName": "Apellido1Docu Apellido2Docu",
                "phones":
                [
                    "666555444"
                ]
            }
        }
    }
}'

Response

📌 Una respuesta exitosa nos devolverá

---

✅ 200 OK.       Request successful. The server has responded as required

---

El Body de respuesta será en formato JSON con la siguiente estructura:

{
    "Message": "Póliza solicitada correctamente",
    "Errors": null
}

🔷 “Message”: Resolución de la operación.

🔷 “Errors”: Muestra errores sin interrumpir la operación.

 

❌ Error: Si la solicitud no prosperó, consulta el apartado ⚠️ Errores para más información.

  Avalisto emplea códigos de respuesta HTTP estándar para señalar el éxito o fracaso de una solicitud a la API.

El Body de respuesta será en formato JSON con la siguiente estructura:

{
    "Message": null,
    "Errors":
     [
        {
            "Code": "EE600",
            "Message": "Error requesting policy"
}
    ]
}