Portal de Documentación de Logicware CRM

GET /external/units/stock?projectCode={code}&stageId={id}

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

{
  "succeeded": true,
  "message": "Unit stock retrieved successfully",
  "data": {
    "properties": [
      {
        "id": 1223,
        "stageId": 2,
        "stageName": "ETAPA 2",
        "blockName": "MZ E2",
        "unitTypeName": "Lote",
        "code": "E2-01",
        "description": "",
        "remarks": "",
        "orientation": null,
        "isCorner": false,
        "deliveryDate": "2026-03-15T00:00:00",
        "areaSqm": 108.00,
        "dimensions": {
          "front": 6.00,
          "right": 18.00,
          "left": 18.00,
          "back": 6.00
        },
        "leaflet": {
          "id": 45,
          "coordinates": "[[4494.956250190735,4861.089111394753],[4233.718328306151,4727.418198428964],[4427.331251144409,4381.952347764205],[4493.956251144409,4415.326717569711],[4535.581251144409,4435.7048303485735],[4579.956251144409,4458.9583823539015],[4625.456251144409,4482.455116800616],[4657.706251144409,4500.957943127436],[4664.706251144409,4505.330384155856],[4671.581251144409,4510.956243511984],[4680.581251144409,4519.957618481788],[4689.331251144409,4531.709413581255],[4696.331251144409,4547.086762488003],[4699.206251144409,4558.588519393864],[4700.331251144409,4566.089665202035],[4699.706251144409,4581.3419950119805],[4698.831251144409,4580.46686133436],[4697.956251144409,4591.093484562602],[4693.456251144409,4603.34535604928],[4680.206251144409,4623.22339244093],[4639.331251144409,4672.980992968459]]",
          "positionNumber": "E2-01"
        },
        "statuses": {
          "id": 1,
          "description": "Disponible",
          "background": "#22C55E"
        },
        "pricePerSqm": 520.93,
        "totalPrice": 56260.58,
        "currency": "PEN",
        "status": "Disponible",
        "createdAt": "2025-01-10T09:15:00",
        "updatedAt": null
      },
      {
        "id": 1224,
        "stageId": 2,
        "stageName": "ETAPA 2",
        "blockName": "MZ E2",
        "unitTypeName": "Lote",
        "code": "E2-02",
        "description": "Lote esquinero con vista panorámica",
        "remarks": "Ubicación privilegiada, frente a parque",
        "orientation": "Norte",
        "isCorner": true,
        "deliveryDate": "2026-03-15T00:00:00",
        "areaSqm": 120.00,
        "dimensions": {
          "front": 8.00,
          "right": 15.00,
          "left": 15.00,
          "back": 8.00
        },
        "leaflet": {
          "id": 46,
          "coordinates": "[[4210.456250190735,4283.321771497776],[4044.0424347401104,4641.575938349752],[3837.956251144409,4558.947344401862],[3989.3045545454693,4193.621062001607]]",
          "positionNumber": "E2-02"
        },
        "statuses": {
          "id": 2,
          "description": "Reservado",
          "background": "#F59E0B"
        },
        "pricePerSqm": 520.83,
        "totalPrice": 62500.00,
        "currency": "PEN",
        "status": "Reservado",
        "createdAt": "2025-01-10T09:15:00",
        "updatedAt": "2025-06-11T16:05:00"
      }
    ],
    "summary": {
      "total": 2
    }
  },
  "statusCode": 200
}

{
  "succeeded": false,
  "message": "projectCode is required",
  "data": null,
  "statusCode": 400
}

{
  "succeeded": false,
  "message": "stageId must be greater than 0",
  "data": null,
  "statusCode": 400
}

{
  "succeeded": true,
  "message": "No stock found for the specified project and stage",
  "data": {
    "properties": [],
    "summary": {
      "total": 0
    }
  },
  "statusCode": 200
}

GET /external/units/1245/files?expirationMinutes=120

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

{
  "succeeded": true,
  "message": "Unit files retrieved successfully",
  "data": [
    {
      "id": 301,
      "fileName": "plano-b15.pdf",
      "fileSize": 482913,
      "url": "https://cdn.logicwareperu.com/apiFilesCrm/units/plano-b15.pdf?sig=...",
      "createdAt": "2025-06-10T09:20:00"
    }
  ],
  "statusCode": 200
}

{
  "succeeded": false,
  "message": "Unit with id 1245 not found",
  "data": null,
  "statusCode": 404
}

{
  "succeeded": true,
  "message": "No files found for the specified unit",
  "data": [],
  "statusCode": 200
}

GET /external/projects

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

{
  "succeeded": true,
  "message": "Projects retrieved successfully",
  "data": [
    {
      "projectId": 1,
      "projectCode": "31125",
      "projectName": "VILLA ECO-SOSTENIBLE",
      "status": "Activo",
      "createdAt": "2025-11-03T23:32:57.41",
      "updatedAt": null
    }
  ],
  "statusCode": 200
}

{
  "succeeded": true,
  "message": "No projects found.",
  "data": [],
  "statusCode": 200
}

GET /external/stages?projectCode={code}

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

{
  "succeeded": true,
  "message": "Stages retrieved successfully",
  "data": [
    {
      "stageId": 1,
      "stageName": "Etapa 1",
      "projectCode": "LOGICWARE",
      "deliveryDate": "2025-06-30T00:00:00",
      "createdAt": "2025-01-10T09:15:00",
      "updatedAt": null
    },
    {
      "stageId": 2,
      "stageName": "Etapa 2",
      "projectCode": "LOGICWARE",
      "deliveryDate": "2026-03-15T00:00:00",
      "createdAt": "2025-01-10T09:15:00",
      "updatedAt": "2025-05-02T14:40:00"
    },
    {
      "stageId": 3,
      "stageName": "Etapa 3",
      "projectCode": "LOGICWARE",
      "deliveryDate": "2026-12-20T00:00:00",
      "createdAt": "2025-01-10T09:15:00",
      "updatedAt": null
    }
  ],
  "statusCode": 200
}

{
  "succeeded": false,
  "message": "projectCode is required",
  "data": null,
  "statusCode": 400
}

{
  "succeeded": true,
  "message": "No stages found for the specified project",
  "data": [],
  "statusCode": 200
}

GET /external/stages/12/1/default/url?expirationMinutes=120

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

{
  "succeeded": true,
  "message": "Default stage plan signed URL generated successfully",
  "data": {
    "signedUrl": "https://cdn.logicwareperu.com/apiFilesCrm/stages/logicware-etapa1.png?sig=...",
    "expiresAtUtc": "2025-10-15T14:30:00Z"
  },
  "statusCode": 200
}

{
  "succeeded": false,
  "message": "Default stage plan not found for projectId 12 and stageId 1",
  "data": null,
  "statusCode": 404
}

GET /external/blocks?projectCode={code}

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

{
  "succeeded": true,
  "message": "Blocks retrieved successfully",
  "data": [
    {
      "blockId": 101,
      "blockName": "MZ A",
      "projectCode": "LOGICWARE",
      "deliveryDate": "2025-08-15T00:00:00",
      "createdAt": "2025-01-10T09:15:00",
      "updatedAt": null
    },
    {
      "blockId": 102,
      "blockName": "MZ B",
      "projectCode": "LOGICWARE",
      "deliveryDate": "2025-08-15T00:00:00",
      "createdAt": "2025-01-10T09:15:00",
      "updatedAt": "2025-04-18T11:22:00"
    },
    {
      "blockId": 103,
      "blockName": "MZ C",
      "projectCode": "LOGICWARE",
      "deliveryDate": "2026-02-28T00:00:00",
      "createdAt": "2025-01-10T09:15:00",
      "updatedAt": null
    }
  ],
  "statusCode": 200
}

{
  "succeeded": false,
  "message": "projectCode is required",
  "data": null,
  "statusCode": 400
}

{
  "succeeded": true,
  "message": "No blocks found for the specified project",
  "data": [],
  "statusCode": 200
}

GET /external/leads/{leadId}

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

{
  "succeeded": true,
  "message": "Lead retrieved successfully",
  "data": {
    "id": 12345,
    "documentNumber": "72845936",
    "firstName": "Carlos",
    "paternalSurname": "Mendoza",
    "maternalSurname": "Rivera",
    "fullName": "Carlos Mendoza Rivera",
    "phone": "+51987654321",
    "email": "carlos.mendoza@example.com",
    "createdAt": "2025-03-15T10:30:00",
    "firstEntryDate": "2025-03-15T10:30:00",
    "createdMonth": "March",
    "status": "Activo",
    "segmentName": "Nuevos",
    "projectName": "Residencial Vista Hermosa",
    "stageName": "Etapa 2",
    "quotationPortal": "WHATSAPP MANTRA",
    "acquisitionChannel": "Publicidad Digital",
    "entryChannel": "WhatsApp",
    "utmCampaign": "verano2025",
    "utmContent": "lotes-norte",
    "utmMedium": "social",
    "utmSource": "facebook",
    "utmTerm": "wpp",
    "seller": {
      "firstName": "Andrea",
      "paternalSurname": "Vargas",
      "maternalSurname": "Mendoza",
      "fullName": "Andrea Vargas Mendoza",
      "email": "andrea.vargas@inmobiliaria.com",
      "phone": "+51960859432"
    }
  },
  "statusCode": 200
}

POST /external/leads/create

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}
Content-Type: application/json

{
  "portalCode": "LOGICWAREBOT",
  "projectCode": "ALAMEDA2",
  "documentType": 1,
  "documentNumber": "12345678",
  "firstName": "Carlos",
  "paternalLastname": "Rodriguez",
  "maternalLastname": "Lopez",
  "email": "carlos.rodriguez@email.com",
  "phoneNumber": "+51987654321",
  "comments": "Interesado en departamentos de 3 dormitorios",
  "availabilityType": "1month",
  "preferredContactTime": "afternoon",
  "marketingConsent": "si",
  "interestedProperties": "Departamentos 3 dorm",
  "budgetRange": "150000-200000",
  "utmCampaign": "verano2025",
  "utmContent": "chat",
  "utmMedium": "social",
  "utmSource": "facebook",
  "utmTerm": "departamentos lima",
  "codSeller": 0,
  "emailSeller": "",
  "udfField1": null,
  "udfField2": null,
  "udfField3": null,
  "udfField4": null,
  "udfField5": null
}

{
  "succeeded": true,
  "message": "Lead created successfully",
  "data": {
    "leadId": 1523,
    "parentId": null,
    "assignedTo": "Maria Fernandez Torres",
    "createdAt": "2025-10-27T14:30:00"
  },
  "statusCode": 201
}

{
  "succeeded": true,
  "message": "Lead created successfully",
  "data": {
    "leadId": 1524,
    "parentId": 1523,
    "assignedTo": "Maria Fernandez Torres",
    "createdAt": "2025-10-27T15:05:00"
  },
  "statusCode": 201
}

{
  "succeeded": false,
  "message": "Validation failed",
  "errors": [
    "Full name is required",
    "Either Email or PhoneNumber must be provided."
  ],
  "data": null,
  "statusCode": 400
}

{
  "succeeded": false,
  "message": "Lead not found",
  "data": null,
  "statusCode": 404
}

GET /external/leads/{leadId}/tags

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

{
  "succeeded": true,
  "message": "Tags retrieved successfully",
  "data": {
    "lead": {
      "id": 73,
      "fullName": "MARISA ARAUJO",
      "phone": "+51998877661",
      "email": "51998877661@web.whatsapp.net"
    },
    "tags": [
      {
        "tagId": 1,
        "tagName": "RECONTACTO",
        "createdAt": "2025-12-03T10:19:09.057"
      }
    ]
  },
  "statusCode": 200
}

POST /external/leads/{leadId}/tags

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}
Content-Type: application/json

Body:
{
  "tagId": 2
}

{
  "succeeded": true,
  "message": "Tag created successfully",
  "data": {
    "tagId": 2,
    "tagName": "ETIQUETA 1",
    "createdAt": "2025-12-10T14:15:58.487"
  },
  "statusCode": 201
}

{
  "succeeded": false,
  "message": "The Lead does not exist.",
  "data": null,
  "statusCode": 400
}

{
  "succeeded": false,
  "message": "The tag does not exist.",
  "data": null,
  "statusCode": 400
}

{
  "succeeded": true,
  "message": "No tags found for the specified lead",
  "data": {
    "lead": {
      "id": 73,
      "fullName": "MARISA ARAUJO",
      "phone": "+51998877661",
      "email": "51998877661@web.whatsapp.net"
    },
    "tags": []
  },
  "statusCode": 200
}

{
  "succeeded": true,
  "message": "Activities retrieved successfully",
  "data": {
    "lead": {
      "id": 19902,
      "fullName": "Carlos Ramírez Torres",
      "phone": "+51928519178",
      "email": "carlos.ramirez@example.com"
    },
    "activities": [
      {
        "id": 40278,
        "activityType": "Llamada",
        "description": "Llamada",
        "notes": "<p>INTERACCIÓN 1 Y SEGUIMIENTO</p>",
        "scheduledAt": "2025-09-19T15:00:00",
        "status": "Vencida",
        "completedComments": null,
        "completedAt": null,
        "userCompleted": null,
        "createdAt": "2025-09-18T21:15:37.583",
        "updatedAt": null,
        "seller": {
          "firstName": "Ana",
          "paternalSurname": "Martínez",
          "maternalSurname": "Silva",
          "fullName": "Ana Martínez Silva",
          "email": "ana.martinez@inmobiliaria.com",
          "phone": "+51924212619"
        }
      },
      {
        "id": 39639,
        "activityType": "Llamada",
        "description": "Llamada",
        "notes": "Se ha creado la actividad Llamada con fecha de vencimiento 18/09/2025 a las 13:14",
        "scheduledAt": "2025-09-18T13:14:14.467",
        "status": "Completada",
        "completedComments": "Contacto establecido exitosamente",
        "completedAt": "2025-09-18T21:15:37.38",
        "userCompleted": "Ana Martínez Silva",
        "createdAt": "2025-09-18T11:14:14.467",
        "updatedAt": "2025-09-18T21:15:37.38",
        "seller": {
          "firstName": "Ana",
          "paternalSurname": "Martínez",
          "maternalSurname": "Silva",
          "fullName": "Ana Martínez Silva",
          "email": "ana.martinez@inmobiliaria.com",
          "phone": "+51924212619"
        }
      }
    ]
  },
  "statusCode": 200
}

POST /external/leads/{leadId}/activities

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}
Content-Type: application/json

Body:
{
  "activityType": 1,
  "levelInterest": 2,
  "description": "Llamar al cliente para confirmar interés en departamentos",
  "scheduledAt": "2025-10-20T15:00:00",
  "notes": "Cliente mencionó preferencia por zona norte, 3 dormitorios"
}

{
  "succeeded": true,
  "message": "Activity created successfully",
  "data": {
    "id": 40323,
    "activityType": "Llamada",
    "description": "Llamar al cliente para confirmar interés en departamentos",
    "notes": "Cliente mencionó preferencia por zona norte, 3 dormitorios",
    "scheduledAt": "2025-10-20T15:00:00",
    "status": "Pendiente",
    "completedComments": null,
    "completedAt": null,
    "userCompleted": null,
    "createdAt": "2025-10-05T22:08:05.69",
    "updatedAt": null,
    "seller": {
      "firstName": "María",
      "paternalSurname": "González",
      "maternalSurname": "Rojas",
      "fullName": "María González Rojas",
      "email": "maria.gonzalez@inmobiliaria.com",
      "phone": "+51960859432"
    }
  },
  "statusCode": 201
}

PUT /external/leads/{leadId}/activities/{activityId}

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}
Content-Type: application/json

Body:
{
  "levelInterest": 3,
  "description": "Seguimiento de propuesta enviada",
  "scheduledAt": "2025-10-15T16:00:00",
  "notes": "Cliente solicitó información adicional sobre financiamiento"
}

{
  "succeeded": true,
  "message": "Activity updated successfully",
  "data": {
    "id": 40322,
    "activityType": "Llamada",
    "description": "Seguimiento de propuesta enviada",
    "notes": "Cliente solicitó información adicional sobre financiamiento",
    "scheduledAt": "2025-10-15T16:00:00",
    "status": "Pendiente",
    "completedComments": null,
    "completedAt": null,
    "userCompleted": null,
    "createdAt": "2025-10-05T19:54:16.4",
    "updatedAt": "2025-10-05T22:10:45.827",
    "seller": {
      "firstName": "Roberto",
      "paternalSurname": "Vega",
      "maternalSurname": "López",
      "fullName": "Roberto Vega López",
      "email": "roberto.vega@inmobiliaria.com",
      "phone": "+51923634231"
    }
  },
  "statusCode": 200
}

{
  "succeeded": false,
  "message": "Conflict: Lead has an existing pending activity. Complete it before creating a new one.",
  "data": null,
  "statusCode": 409
}

{
  "succeeded": false,
  "message": "No action can be taken because the prospectus is closed.",
  "data": null,
  "statusCode": 409
}

{
  "succeeded": false,
  "message": "Cannot update a completed activity.",
  "data": null,
  "statusCode": 409
}

{
  "succeeded": true,
  "message": "Appointments retrieved successfully",
  "data": {
    "lead": {
      "id": 19985,
      "fullName": "Patricia Flores Gutiérrez",
      "phone": "+51906250790",
      "email": "patricia.flores@example.com"
    },
    "appointments": [
      {
        "id": 2601,
        "medium": "PRESENCIAL",
        "description": "<p>Cliente muy interesado para adquirir su casa</p>",
        "location": "Oficina Santa Isabel",
        "createdAt": "2025-09-18T19:58:33.14",
        "scheduledAt": "2025-09-27T19:57:00",
        "status": "Vencida",
        "completedComments": null,
        "completedAt": null,
        "userCompleted": null,
        "seller": {
          "firstName": "Jorge",
          "paternalSurname": "Salazar",
          "maternalSurname": "Cruz",
          "fullName": "Jorge Salazar Cruz",
          "email": "jorge.salazar@inmobiliaria.com",
          "phone": "+51924124093"
        }
      },
      {
        "id": 2599,
        "medium": "ZOOM",
        "description": "<p>Presentación virtual del proyecto residencial</p>",
        "location": null,
        "createdAt": "2025-09-15T14:30:00",
        "scheduledAt": "2025-09-20T16:00:00",
        "status": "Completada",
        "completedComments": "Cita exitosa, cliente solicitó cotización",
        "completedAt": "2025-09-20T17:15:00",
        "userCompleted": "Jorge Salazar Cruz",
        "seller": {
          "firstName": "Jorge",
          "paternalSurname": "Salazar",
          "maternalSurname": "Cruz",
          "fullName": "Jorge Salazar Cruz",
          "email": "jorge.salazar@inmobiliaria.com",
          "phone": "+51924124093"
        }
      }
    ]
  },
  "statusCode": 200
}

POST /external/leads/{leadId}/appointments

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}
Content-Type: application/json

Body:
{
  "scheduledAt": "2025-10-18T17:30:00",
  "mediumType": "P",
  "medium": "PRESENCIAL",
  "location": "Oficina de ventas - Sede Central",
  "meetingUrl": null,
  "notes": "Cliente interesado en departamentos de 3 dormitorios"
}

{
  "succeeded": true,
  "message": "Appointment created successfully",
  "data": {
    "id": 2614,
    "medium": "PRESENCIAL",
    "description": "Cliente interesado en departamentos de 3 dormitorios",
    "location": "Oficina de ventas - Sede Central",
    "createdAt": "2025-10-05T22:32:24.077",
    "scheduledAt": "2025-10-18T17:30:00",
    "status": "Pendiente",
    "completedComments": null,
    "completedAt": null,
    "userCompleted": null,
    "seller": {
      "firstName": "Andrea",
      "paternalSurname": "Vargas",
      "maternalSurname": "Mendoza",
      "fullName": "Andrea Vargas Mendoza",
      "email": "andrea.vargas@inmobiliaria.com",
      "phone": "+51960859432"
    }
  },
  "statusCode": 201
}

PUT /external/leads/{leadId}/appointments/{appointmentId}

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}
Content-Type: application/json

Body:
{
  "scheduledAt": "2025-10-20T15:00:00",
  "mediumType": "D",
  "medium": "MEET",
  "location": null,
  "meetingUrl": "https://meet.google.com/xyz-abcd-efg",
  "notes": "Cambio a modalidad virtual por solicitud del cliente"
}

{
  "succeeded": true,
  "message": "Appointment updated successfully",
  "data": {
    "id": 2613,
    "medium": "MEET",
    "description": "Cambio a modalidad virtual por solicitud del cliente",
    "location": null,
    "createdAt": "2025-10-05T21:39:22.367",
    "scheduledAt": "2025-10-20T15:00:00",
    "status": "Pendiente",
    "completedComments": null,
    "completedAt": null,
    "userCompleted": null,
    "seller": {
      "firstName": "Luis",
      "paternalSurname": "Morales",
      "maternalSurname": "Ríos",
      "fullName": "Luis Morales Ríos",
      "email": "luis.morales@inmobiliaria.com",
      "phone": "+51960859432"
    }
  },
  "statusCode": 200
}

{
  "succeeded": false,
  "message": "The lead already has a pending appointment scheduled for 18/10/2025 17:30. You must complete the existing appointment (Successful/Failed) before creating a new one.",
  "data": null,
  "statusCode": 409
}

{
  "succeeded": false,
  "message": "The lead is not in a valid status to update appointments",
  "data": null,
  "statusCode": 409
}

{
  "succeeded": false,
  "message": "Cannot update a completed or finalized appointment",
  "data": null,
  "statusCode": 409
}

{
  "succeeded": true,
  "message": "Notes retrieved successfully",
  "data": {
    "lead": {
      "id": 8869,
      "fullName": "Carmen Rodríguez Vargas",
      "phone": "+51924156656",
      "email": "carmen.rodriguez@example.com"
    },
    "notes": [
      {
        "id": 38,
        "title": "Actualización de preferencias",
        "content": "Cliente confirma interés en zona norte, prefiere lotes con vista al parque",
        "createdAt": "2025-10-05T21:58:03.7",
        "updatedAt": "2025-10-05T21:58:49.54",
        "createdBy": "Roberto Vega López"
      },
      {
        "id": 37,
        "title": "Primera llamada",
        "content": "Contacto inicial exitoso, cliente solicita información sobre proyecto residencial",
        "createdAt": "2025-10-04T15:30:22.45",
        "updatedAt": null,
        "createdBy": "Ana Martínez Silva"
      }
    ]
  },
  "statusCode": 200
}

POST /external/leads/{leadId}/notes

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}
Content-Type: application/json

Body:
{
  "Title": "Seguimiento importante",
  "Content": "Cliente interesado en lotes de 150m², consultar disponibilidad en Manzana C. Solicita información sobre financiamiento directo."
}

{
  "succeeded": true,
  "message": "Note created successfully",
  "data": {
    "id": 39,
    "title": "Seguimiento importante",
    "content": "Cliente interesado en lotes de 150m², consultar disponibilidad en Manzana C. Solicita información sobre financiamiento directo.",
    "createdAt": "2025-10-05T22:41:25.9579501-05:00",
    "updatedAt": null,
    "createdBy": "Ana Martínez Silva"
  },
  "statusCode": 201
}

PUT /external/leads/{leadId}/notes/{noteId}

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}
Content-Type: application/json

Body:
{
  "Title": "Seguimiento actualizado",
  "Content": "Cliente decidió por lote esquinero en Manzana D, coordinar visita para esta semana"
}

{
  "succeeded": true,
  "message": "Notes updated successfully",
  "data": {
    "id": 34,
    "title": "Seguimiento actualizado",
    "content": "Cliente decidió por lote esquinero en Manzana D, coordinar visita para esta semana",
    "createdAt": "2025-10-05T11:26:08.197",
    "updatedAt": "2025-10-05T22:42:47.3860893-05:00",
    "createdBy": "Roberto Vega López"
  },
  "statusCode": 200
}

{
  "succeeded": false,
  "message": "Validation failed",
  "errors": [
    "The Title field is required.",
    "The Content field is required."
  ],
  "data": null,
  "statusCode": 400
}

{
  "succeeded": false,
  "message": "Lead not found",
  "data": null,
  "statusCode": 404
}

{
  "succeeded": true,
  "message": "No notes found for the specified lead",
  "data": {
    "lead": {
      "id": 8869,
      "fullName": "Carmen Rodríguez Vargas",
      "phone": "+51924156656",
      "email": "carmen.rodriguez@example.com"
    },
    "notes": []
  },
  "statusCode": 200
}

GET /external/catalogs/tags

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

{
  "succeeded": true,
  "message": "Tags retrieved successfully",
  "data": [
    {
      "id": 1,
      "name": "RECONTACTO"
    },
    {
      "id": 2,
      "name": "ETIQUETA 1"
    },
    {
      "id": 3,
      "name": "ETIQUETA 2"
    }
  ],
  "statusCode": 200
}

GET /external/clients/sales?startDate={startDate}&endDate={endDate}&pageNumber={pageNumber}&pageSize={pageSize}

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

X-Total-Count: 8
X-Page-Number: 1
X-Page-Size: 500
X-Max-Page-Size: 500

{
  "succeeded": true,
  "message": "Client sales data retrieved successfully",
  "pageNumber": 1,
  "pageSize": 500,
  "totalRecords": 8,
  "totalPages": 1,
  "data": [
    {
      "documentNumber": "12345678",
      "fullName": "JUAN CARLOS GARCIA LOPEZ",
      "firstName": "JUAN CARLOS",
      "paternalSurname": "GARCIA",
      "maternalSurname": "LOPEZ",
      "phone": "+51987654321",
      "email": "jgarcia@email.com",
      "gender": "Masculino",
      "birthDate": "1985-05-15T00:00:00",
      "address": "AV. PRINCIPAL 123",
      "department": "LIMA",
      "province": "LIMA",
      "district": "MIRAFLORES",
      "documents": [
        {
          "proformaId": 1001,
          "correlative": "202510-000000123",
          "status": "En Proceso Separación",
          "startDate": "2025-10-15T10:30:00",
          "endDate": null,
          "proformaStartDate": "2025-10-15T10:20:00",
          "separationStartDate": "2025-10-15T10:30:00",
          "separationEndDate": null,
          "saleStartDate": null,
          "saleEndDate": null,
          "seller": "MARIA FERNANDEZ TORRES",
          "project": "RESIDENCIAL VERDE",
          "stage": "ETAPA 1",
          "units": [
            {
              "unitNumber": "B-15",
              "unitArea": 85.50,
              "basePrice": 45000.00,
              "unitPrice": 42000.00,
              "discountPercentage": 6.67,
              "discount": 3000.00,
              "total": 42000.00
            }
          ],
          "financing": {
            "financingType": "Financiado",
            "currency": "PEN",
            "initialInstallments": 2,
            "financingInstallments": 24,
            "totalInstallments": 26,
            "reservationAmount": 500.00,
            "downPayment": 4200.00,
            "amountToFinance": 37300.00,
            "totalPaid": 500.00,
            "totalPending": 41500.00
          }
        }
      ]
    },
    {
      "documentNumber": "87654321",
      "fullName": "ANA LUCIA MARTINEZ SILVA",
      "firstName": "ANA LUCIA",
      "paternalSurname": "MARTINEZ",
      "maternalSurname": "SILVA",
      "phone": "+51912345678",
      "email": "amartinez@email.com",
      "gender": "Femenino",
      "birthDate": "1990-08-22T00:00:00",
      "address": "CALLE LAS FLORES 456",
      "department": "AREQUIPA",
      "province": "AREQUIPA",
      "district": "CAYMA",
      "documents": [
        {
          "proformaId": 1002,
          "correlative": "202510-000000124",
          "status": "Venta",
          "startDate": "2025-10-10T14:15:00",
          "endDate": "2025-10-18T16:00:00",
          "proformaStartDate": "2025-10-10T14:00:00",
          "separationStartDate": "2025-10-10T14:15:00",
          "separationEndDate": "2025-10-18T15:45:00",
          "saleStartDate": "2025-10-18T15:45:00",
          "saleEndDate": "2025-10-18T16:00:00",
          "seller": "CARLOS MENDOZA RUIZ",
          "project": "MIRADOR DEL SUR",
          "stage": "ETAPA 2",
          "units": [
            {
              "unitNumber": "C-08",
              "unitArea": 72.00,
              "basePrice": 38500.00,
              "unitPrice": 35000.00,
              "discountPercentage": 9.09,
              "discount": 3500.00,
              "total": 35000.00
            }
          ],
          "financing": {
            "financingType": "Contado",
            "currency": "USD",
            "initialInstallments": 1,
            "financingInstallments": 0,
            "totalInstallments": 1,
            "reservationAmount": 0.00,
            "downPayment": 35000.00,
            "amountToFinance": 0.00,
            "totalPaid": 35000.00,
            "totalPending": 0.00
          }
        }
      ]
    }
  ],
  "statusCode": 200
}

{
  "succeeded": false,
  "message": "Date range cannot exceed 1 year (365 days)",
  "data": null,
  "statusCode": 400
}

{
  "succeeded": true,
  "message": "No client sales found for the specified date range",
  "pageNumber": 1,
  "pageSize": 500,
  "totalRecords": 0,
  "totalPages": 0,
  "data": [],
  "statusCode": 200
}

GET /external/clients/{documentNumber}/sales

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

GET /external/clients/12345678/sales

Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
X-Subdomain: miempresa

{
  "succeeded": true,
  "message": "Client sales data retrieved successfully",
  "data": {
    "documentNumber": "12345678",
    "fullName": "ROBERTO CARLOS MENDEZ VARGAS",
    "firstName": "ROBERTO CARLOS",
    "paternalSurname": "MENDEZ",
    "maternalSurname": "VARGAS",
    "phone": "+51998765432",
    "email": "rmendez@email.com",
    "gender": "Masculino",
    "birthDate": "1982-11-08T00:00:00",
    "address": "JR. LOS PINOS 789",
    "department": "CUSCO",
    "province": "CUSCO",
    "district": "WANCHAQ",
    "documents": [
      {
        "proformaId": 2001,
        "correlative": "202509-000000567",
        "status": "Separación",
        "startDate": "2025-09-20T11:30:00",
        "endDate": "2025-09-25T14:20:00",
        "proformaStartDate": "2025-09-20T11:15:00",
        "separationStartDate": "2025-09-20T11:30:00",
        "separationEndDate": "2025-09-25T14:20:00",
        "saleStartDate": null,
        "saleEndDate": null,
        "seller": "PATRICIA GOMEZ RIOS",
        "project": "CIUDAD JARDÍN",
        "stage": "ETAPA 3",
        "units": [
          {
            "unitNumber": "E-22",
            "unitArea": 68.00,
            "basePrice": 36500.00,
            "unitPrice": 33850.00,
            "discountPercentage": 7.26,
            "discount": 2650.00,
            "total": 33850.00
          }
        ],
        "financing": {
          "financingType": "Financiado",
          "currency": "PEN",
          "initialInstallments": 1,
          "financingInstallments": 48,
          "totalInstallments": 49,
          "reservationAmount": 200.00,
          "downPayment": 3385.00,
          "amountToFinance": 30265.00,
          "totalPaid": 3585.00,
          "totalPending": 30265.00
        }
      }
    ]
  },
  "statusCode": 200
}

{
  "succeeded": true,
  "message": "No sales data found for client with document number: 12345678",
  "data": null,
  "statusCode": 200
}

GET /external/clients/{documentNumber}/sales/{saleId}

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

GET /external/clients/02865709/sales/259

Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
X-Subdomain: miempresa

{
  "succeeded": true,
  "message": "Sale detail retrieved successfully",
  "data": {
    "proformaId": 259,
    "correlative": "202603-000000111",
    "status": "Ventas",
    "startDate": "2022-09-22T17:12:46",
    "endDate": "2022-09-22T17:12:46",
    "proformaStartDate": "2022-09-22T15:58:11",
    "separationStartDate": "2022-09-22T17:12:37",
    "separationEndDate": "2022-09-22T17:12:37",
    "saleStartDate": "2022-09-22T17:12:46",
    "saleEndDate": "2022-09-22T17:12:46",
    "seller": "ANDRES GARCIA JUAREZ",
    "project": "LIMA VERDE",
    "stage": "ETAPA 1",
    "client": {
      "documentNumber": "00000002",
      "fullName": "ROBERTO QUEVEDO JUAREZ",
      "firstName": "ROBERTO",
      "paternalSurname": "QUEVEDO",
      "maternalSurname": "JUAREZ",
      "phone": "+51987654321",
      "email": "correo@hotmail.com"
    },
    "units": [
      {
        "unitNumber": "L-01",
        "unitArea": 189.86,
        "basePrice": 140686.26,
        "unitPrice": 140686.26,
        "discountPercentage": 0.0,
        "discount": 0.0,
        "total": 140686.26
      }
    ]
  },
  "statusCode": 200
}

{
  "succeeded": false,
  "message": "No sale found for document 02865709 with id 25922",
  "data": null,
  "statusCode": 404
}

GET /external/payment-schedules/{correlative}

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

GET /external/payment-schedules/202510-000000123

Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
X-Subdomain: miempresa

{
  "succeeded": true,
  "message": "Payment schedule retrieved successfully",
  "data": {
    "scheduleId": 501,
    "proformaId": 1001,
    "correlative": "202510-000000123",
    "productPrice": 42000.00,
    "initialFeePercentage": 10.00,
    "initialGross": 4200.00,
    "reservationAmount": 500.00,
    "netInitial": 3700.00,
    "numberInitialInstallments": 2,
    "downPaymentInitial": 1850.00,
    "dateBeginInitial": "2025-11-01T00:00:00",
    "tea": 12.50,
    "tem": 0.99,
    "numberFinancingInstallments": 24,
    "amountToFinance": 37300.00,
    "downPaymentFinancing": 1621.83,
    "dateBeginFinancing": "2026-01-01T00:00:00",
    "totalPrincipal": 37300.00,
    "totalInterest": 5412.00,
    "totalPayment": 42712.00,
    "totalPaid": 3850.00,
    "totalPending": 38862.00,
    "overdueCuotas": 1,
    "installmentCount": 26,
    "paymentFrequency": "MONTHLY",
    "firstPaymentDate": "2025-11-01T00:00:00",
    "currency": "PEN",
    "createdBy": "MARIA FERNANDEZ TORRES",
    "createdAt": "2025-10-15T10:30:00",
    "installments": [
      {
        "scheduleDetId": 5001,
        "scheduleId": 501,
        "label": "Cuota Inicial",
        "installmentNumber": 1,
        "dueDate": "2025-11-01T00:00:00",
        "balance": 42000.00,
        "principal": 1850.00,
        "interest": 0.00,
        "payment": 1850.00,
        "paidPrincipal": 1850.00,
        "paidInterest": 0.00,
        "paidPenalty": 0.00,
        "totalPaidAmount": 1850.00,
        "remainingBalance": 40150.00,
        "status": "PAID",
        "paymentDate": "2025-10-28T14:30:00"
      },
      {
        "scheduleDetId": 5002,
        "scheduleId": 501,
        "label": "Cuota Inicial",
        "installmentNumber": 2,
        "dueDate": "2025-12-01T00:00:00",
        "balance": 40150.00,
        "principal": 1850.00,
        "interest": 0.00,
        "payment": 1850.00,
        "paidPrincipal": 1850.00,
        "paidInterest": 0.00,
        "paidPenalty": 0.00,
        "totalPaidAmount": 1850.00,
        "remainingBalance": 38300.00,
        "status": "PAID",
        "paymentDate": "2025-11-29T16:45:00"
      },
      {
        "scheduleDetId": 5003,
        "scheduleId": 501,
        "label": "Saldo a Financiar",
        "installmentNumber": 3,
        "dueDate": "2026-01-01T00:00:00",
        "balance": 38300.00,
        "principal": 1552.17,
        "interest": 69.66,
        "payment": 1621.83,
        "paidPrincipal": 150.00,
        "paidInterest": 0.00,
        "paidPenalty": 25.00,
        "totalPaidAmount": 175.00,
        "remainingBalance": 36747.83,
        "status": "PARTIAL",
        "paymentDate": "2026-01-15T10:20:00"
      },
      {
        "scheduleDetId": 5004,
        "scheduleId": 501,
        "label": "Saldo a Financiar",
        "installmentNumber": 4,
        "dueDate": "2026-02-01T00:00:00",
        "balance": 36747.83,
        "principal": 1567.52,
        "interest": 54.31,
        "payment": 1621.83,
        "paidPrincipal": 0.00,
        "paidInterest": 0.00,
        "paidPenalty": 0.00,
        "totalPaidAmount": 0.00,
        "remainingBalance": 36747.83,
        "status": "OVERDUE",
        "paymentDate": null
      },
      {
        "scheduleDetId": 5005,
        "scheduleId": 501,
        "label": "Saldo a Financiar",
        "installmentNumber": 5,
        "dueDate": "2026-03-01T00:00:00",
        "balance": 35180.31,
        "principal": 1582.98,
        "interest": 38.85,
        "payment": 1621.83,
        "paidPrincipal": 0.00,
        "paidInterest": 0.00,
        "paidPenalty": 0.00,
        "totalPaidAmount": 0.00,
        "remainingBalance": 35180.31,
        "status": "PENDING",
        "paymentDate": null
      }
    ],
    "nextInstallmentDue": {
      "scheduleDetId": 5004,
      "scheduleId": 501,
      "label": "Saldo a Financiar",
      "installmentNumber": 4,
      "dueDate": "2026-02-01T00:00:00",
      "balance": 36747.83,
      "principal": 1567.52,
      "interest": 54.31,
      "payment": 1621.83,
      "status": "OVERDUE"
    }
  },
  "statusCode": 200
}

{
  "succeeded": false,
  "message": "Payment schedule not found for correlative: 202510-000000123",
  "data": null,
  "statusCode": 404
}

POST /external/payment-schedules/{paymentScheduleId}/installments/{installmentId}/payments

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}
Content-Type: application/json

Body:
{
  "ProformaId": 271,
  "PaymentMethod": "TRANSFER",
  "PaymentDate": "2026-04-02",
  "ReferenceNumber": "000000245",
  "Notes": "Pago realizado vía transferencia bancaria BCP"
}

{
  "succeeded": true,
  "message": "Payment created successfully",
  "data": {
    "paymentId": 107,
    "paymentNumber": "PAY-271-20260402-00107",
    "message": "Installment payment registered successfully (no penalty)"
  },
  "statusCode": 201
}

{
  "succeeded": false,
  "message": "The specified installment does not exist or is inactive",
  "data": null,
  "statusCode": 404
}

{
  "succeeded": false,
  "message": "Cannot register payments while a refinancing request is pending approval. Approve or reject it first.",
  "data": null,
  "statusCode": 409
}

{
  "succeeded": false,
  "message": "The installment is already fully paid",
  "data": null,
  "statusCode": 409
}

POST /external/payment-schedules/{paymentScheduleId}/installments/{installmentId}/payments/{paymentId}/reversals

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}
Content-Type: application/json

Body:
{
  "ReasonCode": "DUPLICATE_PAYMENT",
  "Notes": "Por motivos de pago duplicado registrado el 02/04/2026"
}

{
  "succeeded": true,
  "message": "Payment reversal processed successfully",
  "data": {
    "reversalId": 2,
    "paymentId": 107,
    "reversalNumber": "REV-PAY-271-20260402-00107-20260402-003",
    "message": "Payment reversed successfully"
  },
  "statusCode": 200
}

{
  "succeeded": false,
  "message": "The specified payment does not exist or is inactive",
  "data": null,
  "statusCode": 404
}

{
  "succeeded": false,
  "message": "The payment has already been reversed",
  "data": null,
  "statusCode": 409
}

{
  "succeeded": false,
  "message": "Cannot reverse a payment that already has an associated receipt or invoice",
  "data": null,
  "statusCode": 409
}

{
  "succeeded": false,
  "message": "The reversal would create an inconsistency: later installments have already been paid",
  "data": null,
  "statusCode": 409
}

GET /external/catalogs/activity-types

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

{
  "succeeded": true,
  "message": "Activity types retrieved successfully",
  "data": [
    {
      "id": 1,
      "name": "Llamada",
      "isActive": true,
      "createdAt": "2025-03-15T10:30:00"
    },
    {
      "id": 2,
      "name": "Correo Electrónico",
      "isActive": true,
      "createdAt": "2025-03-15T10:30:00"
    },
    {
      "id": 4,
      "name": "WhatsApp",
      "isActive": true,
      "createdAt": "2025-03-15T10:30:00"
    }
  ],
  "statusCode": 200
}

{
  "succeeded": false,
  "message": "No activity types found",
  "data": null,
  "statusCode": 404
}

GET /external/catalogs/interest-levels

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

{
  "succeeded": true,
  "message": "Interest levels retrieved successfully",
  "data": [
    {
      "id": 1,
      "name": "Alto",
      "isActive": true,
      "createdAt": "2025-03-15T10:30:00"
    },
    {
      "id": 2,
      "name": "Medio",
      "isActive": true,
      "createdAt": "2025-03-15T10:30:00"
    },
    {
      "id": 3,
      "name": "Bajo",
      "isActive": true,
      "createdAt": "2025-03-15T10:30:00"
    }

  ],
  "statusCode": 200
}

{
  "succeeded": false,
  "message": "No interest levels found",
  "data": null,
  "statusCode": 404
}

GET /external/catalogs/financing-types?includeConditionalPayments={true|false}

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

{
  "succeeded": true,
  "message": "Financing types retrieved successfully",
  "data": [
    {
      "id": 1,
      "name": "Financiado",
      "requiresBankApproval": false,
      "isActive": true,
      "createdAt": "2024-07-19T05:04:07.273",
      "conditionalPayments": []
    },
    {
      "id": 3,
      "name": "Contado",
      "requiresBankApproval": false,
      "isActive": true,
      "createdAt": "2025-01-05T22:42:34.05",
      "conditionalPayments": []
    },
    {
      "id": 4,
      "name": "Hipotecario",
      "requiresBankApproval": true,
      "isActive": false,
      "createdAt": "2025-01-05T22:42:44.863",
      "conditionalPayments": []
    }
  ],
  "statusCode": 200
}

{
  "succeeded": true,
  "message": "Financing types retrieved successfully",
  "data": [
    {
      "id": 1,
      "name": "Financiado",
      "requiresBankApproval": false,
      "isActive": true,
      "createdAt": "2024-07-19T05:04:07.273",
      "conditionalPayments": [
        {
          "code": "CUOTA_BALON",
          "name": "C. Balón 1",
          "currency": "PEN",
          "amount": 3000.00,
          "validFrom": "2025-09-03T00:00:00",
          "validTo": null,
          "isActive": true,
          "createdAt": "2025-09-03T01:35:06.533"
        },
        {
          "code": "CUOTA_BUEN_PAGADOR",
          "name": "B. Pagador",
          "currency": "PEN",
          "amount": 3000.00,
          "validFrom": "2025-09-03T00:00:00",
          "validTo": null,
          "isActive": true,
          "createdAt": "2025-09-03T01:35:18.847"
        }
      ]
    },
    {
      "id": 3,
      "name": "Contado",
      "requiresBankApproval": false,
      "isActive": true,
      "createdAt": "2025-01-05T22:42:34.05",
      "conditionalPayments": []
    },
    {
      "id": 6,
      "name": "Techo Propio",
      "requiresBankApproval": false,
      "isActive": true,
      "createdAt": "2025-09-07T02:21:26.493",
      "conditionalPayments": []
    }
  ],
  "statusCode": 200
}

{
  "succeeded": true,
  "message": "No financing types found",
  "data": [],
  "statusCode": 200
}

GET /external/catalogs/financing-parameters

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

{
  "succeeded": true,
  "message": "Financing parameters retrieved successfully",
  "data": [
    {
      "projectCode": "VERDE2024",
      "projectName": "RESIDENCIAL VERDE",
      "reservationAmount": 500.00,
      "initialFeePercent": 10.00,
      "financedBalancePercent": 90.00,
      "isActive": true,
      "createdAt": "2024-01-15T10:30:00"
    },
    {
      "projectCode": "MIRADOR2024",
      "projectName": "MIRADOR DEL SUR",
      "reservationAmount": 750.00,
      "initialFeePercent": 15.00,
      "financedBalancePercent": 85.00,
      "isActive": false,
      "createdAt": "2024-03-20T14:15:00"
    },
    {
      "projectCode": "JARDIN2023",
      "projectName": "CIUDAD JARDÍN",
      "reservationAmount": 300.00,
      "initialFeePercent": 20.00,
      "financedBalancePercent": 80.00,
      "isActive": false,
      "createdAt": "2023-11-08T09:45:00"
    },
    {
      "projectCode": "PLAZA2022",
      "projectName": "PLAZA CENTRAL",
      "reservationAmount": 1000.00,
      "initialFeePercent": 25.00,
      "financedBalancePercent": 75.00,
      "isActive": false,
      "createdAt": "2022-06-12T16:20:00"
    }
  ],
  "statusCode": 200
}

{
  "succeeded": true,
  "message": "No financing parameters found.",
  "data": [],
  "statusCode": 200
}

GET /external/catalogs/reversal-reason-codes

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

{
  "succeeded": true,
  "message": "Reversal reason codes retrieved successfully",
  "data": [
    { "code": "ADMIN_ERROR",          "description": "Error administrativo" },
    { "code": "AMOUNT_ERROR",         "description": "Error en el monto registrado" },
    { "code": "CLIENT_REQUEST",       "description": "Solicitud del cliente" },
    { "code": "DUPLICATE_PAYMENT",    "description": "Pago duplicado" },
    { "code": "FRAUD_DETECTED",       "description": "Fraude detectado" },
    { "code": "INSUFFICIENT_FUNDS",   "description": "Fondos insuficientes" },
    { "code": "METHOD_ERROR",         "description": "Error en el método de pago" },
    { "code": "OPERATION_CANCELLED",  "description": "Cancelación de operación" },
    { "code": "OTHER",                "description": "Otros motivos" },
    { "code": "SYSTEM_ERROR",         "description": "Error del sistema" }
  ],
  "statusCode": 200
}

{
  "succeeded": false,
  "message": "No reversal reason codes found",
  "data": null,
  "statusCode": 404
}

GET /external/contracts/sales/{saleId}

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

GET /external/contracts/sales/123

Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
X-Subdomain: miempresa

{
  "succeeded": true,
  "message": "Sale contracts retrieved successfully",
  "data": {
    "proformaId": 123,
    "correlative": "202512-000000020",
    "contracts": [
      {
        "contractId": 6,
        "contractStatus": "draft"
      }
    ]
  },
  "statusCode": 200
}

{
  "succeeded": true,
  "message": "Sale contracts retrieved successfully",
  "data": {
    "proformaId": 59,
    "correlative": "202512-000000026",
    "contracts": []
  },
  "statusCode": 200
}

{
  "succeeded": false,
  "message": "No sale found with id 592",
  "data": null,
  "statusCode": 404
}

GET /external/contracts/{contractId}/download-url?expirationMinutes={expirationMinutes}

Headers:
Authorization: Bearer {accessToken}
X-Subdomain: {su-subdomain}

GET /external/contracts/6/download-url?expirationMinutes=120

Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
X-Subdomain: miempresa

{
  "succeeded": true,
  "message": "Contract download URL generated successfully",
  "data": {
    "contractId": 1,
    "url": "https://cdn.logicwareperu.com/signatures/files/.../signed_20260319_090620.pdf?X-Cdn-Algorithm=HMACSHA256&X-Cdn-Date=20260321T084313Z&X-Cdn-Expires=3600&X-Cdn-Nonce=...&X-Cdn-Signature=...",
    "expiresAt": "2026-03-21T09:43:13.637322Z"
  },
  "statusCode": 200
}

{
  "succeeded": false,
  "message": "Contract with id 222 not found",
  "data": null,
  "statusCode": 404
}