Si tu empresa necesita integrar la gestión de créditos con sistemas externos —como un ERP, software de RRHH propio u otras herramientas— ahora puedes hacerlo directamente a través de la API de Buk. Esto te permite consultar y asignar créditos de forma masiva y automatizada, sin depender de la plataforma para cada operación.
💡 ¿Aún no usas la API de Buk? Antes de continuar, te recomendamos revisar este artículo donde explicamos cómo acceder y autenticarte: Cómo usar la API de Buk (aquí el link al artículo)
¿Qué puedes hacer con estos endpoints?
Con los endpoints disponibles puedes realizar dos acciones principales:
- Consultar créditos V2 asignados a tus colaboradores.
- Asignar créditos V2 de forma masiva directamente desde tu sistema externo.
Endpoints disponibles
1. Consultar créditos — GET /api/v1/assigns
Usa este endpoint para obtener la lista de créditos V2 asignados a colaboradores. La respuesta incluye todos los campos del modelo de créditos V2:
| Campo | Descripción |
| fecha_primera | Fecha de la primera cuota |
| numero_cuotas | Número total de cuotas |
| numero_identificador | Identificador único del crédito |
| monto_total | Monto total del crédito |
| moneda | Moneda del crédito |
| tipo_credito | Tipo de crédito |
| cuota_inicio_cobro | Número de cuota desde la cual comienza el cobro |
| estado | Estado del crédito: aprobado, pendiente o rechazado |
¿Dónde encontrar la documentación técnica? Todo el detalle de los campos a recibir están en apidocs. Accede desde el URL de tu empresa: empresa.buk.pe/apidocs → sección "Items" → método GET.
2. Asignar créditos de forma masiva — POST /api/v1/employees/:id/payment_data/:period_id
Usa este endpoint para que en un mismo request puedas asignar uno o varios créditos a un colaborador en un mismo periodo.
Campos requeridos por registro:
| Campo | Descripción |
| fecha_primera_cuota (obligatorio) | Fecha de la primera cuota |
| monto_total (obligatorio) | Monto total del crédito |
| numero_cuotas (obligatorio) | Número de cuotas |
| credit_number (opcional) | número identificador del crédito |
| credit_institution (opcional) | institución que otorga el crédito |
Consideraciones importantes:
- Procesa hasta 25 registros por request en una transacción atómica: si uno falla, se revierten todos.
- Requiere que el período contable esté abierto al momento de la solicitud.
¿Dónde encontrar la documentación técnica? Todo el detalle de los campos a recibir están en apidocs.
Accede desde el URL de tu empresa: empresa.buk.pe/apidocs → sección "Sincronización datos de pago" → método POST.