Crear Apoderado

POST

/api/integrations/v1/apoderados

Crea un nuevo apoderado asociado a la organización autenticada.

El campo sucursalId es obligatorio y debe corresponder a una sucursal perteneciente a la organización autenticada.

El sistema identifica automáticamente el área jurídica configurada para la sucursal y asocia el apoderado a dicha área.

El rol de Apoderado se asigna automáticamente.

La firma HTML del apoderado también es generada automáticamente por el sistema utilizando el nombre, tarjeta profesional, teléfono y correo suministrados.

Requiere autenticación mediante API Integration.

Solicitud

Autorización

JWT Bearer

Agregar el parámetro

Authorization

a Encabezados

Ejemplo:

Authorization: ********************

Parámetros del Body application/json

Ejemplos

Respuestas

🟢201

application/json

Created

Body

🟠400

🟠401

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location 'https://localhost:7001/api/integrations/v1/apoderados' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "sucursalId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "nombre": "string",
  "documento": "string",
  "telefono": "string",
  "correo": "string",
  "tarjetaProfesional": "string"
}'

Ejemplo de Respuesta

201 - Éxito

{
    "success": true,
    "data": {
        "id": "62667a89-fa89-403e-8970-569e66f58cd2",
        "areaId": "fef3d904-e7cb-4bb0-b7d6-7c3fb01a1ae4",
        "nombre": "FRANCY LILIANA LOZANO MEJIA",
        "documento": "327326",
        "telefono": "333627367285",
        "correo": "test@cobrando.com",
        "tarjetaProfesional": "209392",
        "pieFirmaPersonalizada": "<div style=\"\r\n  font-family: 'Times New Roman', serif;\r\n  color: #000000;\r\n  text-align: left;\r\n  margin: 20px 0;\r\n  padding: 15px;\r\n\">\r\n\r\n  <div style=\"font-size: 16px; font-weight: bold; margin-bottom: 5px;\">\r\n    FRANCY LILIANA LOZANO MEJIA\r\n  </div>\r\n\r\n    <div style=\"font-size: 12px; margin-bottom: 3px;\">\r\n    T.P No: 327326\r\n  </div>\r\n\r\n    <div style=\"font-size: 12px; margin-bottom: 3px;\">\r\n    Tel: 333627367285\r\n  </div>\r\n\r\n    <div style=\"font-size: 12px; margin-bottom: 3px;\">\r\n    Email: testdico@cobrando.com\r\n  </div>\r\n</div>",
        "activo": true,
        "createdAt": "2026-10-13T16:10:38.839382+00:00",
        "updatedAt": "2026-10-13T16:10:38.839382+00:00"
    },
    "message": "",
    "layer": "",
    "statusCode": 201
}

Modificado en 2026-10-13 16:15:50

listar Apoderados

Listar Clientes