1. Asientos
Talentify API
  • Introducción
    • Referencia API
    • Entidades incapacidad
      GET
  • Autentificación
    • Autentificación
      • Token
      • Cuenta
  • Administración
    • Seguridad
      • Grupo
        • Grupos
        • Registrar grupo
        • Actualizar grupo
        • Ver grupo
        • Eliminar grupo
        • Actualizar usuarios
        • Mostrar usuarios
        • Actualizar permisos
        • Mostrar permisos
      • Permisos
        • Listar permisos
      • Usuarios
        • Usuarios
        • Registrar usuario
        • Buscador
        • Ver usuario
        • Actualizar usuario
        • Eliminar usuario
      • Auditoría
        • Listado paginado
        • Detalle
      • Seguridad
        • Grupo
        • Permisos
        • Usuarios
        • Auditoría
    • Base
      • Ubicacion
        • Generar código
        • Ubicaciones
        • Registrar Ubicaciones
        • Actualizar ubicación
        • Ver ubicación
        • Division política
        • Eliminar Ubicaciones
      • UnidadNegocio
        • Logo
          • Mostrar logo
          • Subir logo
        • Registrar unidad
    • Presupuesto
      • Departamento
        • Catálogo
        • Registrar
        • Actualizar
        • Consultar
        • Eliminar
      • Centros de costo
        • Catálogo
        • Registrar
        • Actualizar
        • Consultar
        • Eliminar
      • Divisiones
        • Catálogo
        • Registrar
        • Actualizar
        • Consultar
        • Eliminar
      • Secciones
        • Cuenta contables
          • Consultar
          • Conceptos
          • Registrar
          • Actualizar
        • Catálogo
        • Registrar
        • Actualizar
        • Consultar
        • Eliminar
    • Expedientes
      • Persona
        • Catálogo de personas
        • Ver persona
        • Personal
        • Buscador
        • Ausencias
        • Registrar persona
        • Actualizar persona
        • Eliminar Personas
      • Horarios
        • Horario según día
        • Horarios aplicados
        • Ver horario aplicado
        • Aplicar horario
        • Eliminar horario
      • Cuentas bancarias
        • Cuentas
        • Ver cuenta
        • Agregar cuenta
        • Eliminar cuenta
      • Beneficios
        • Beneficios
        • Ver beneficio
        • Agregar beneficio
        • Eliminar beneficio
      • Foto
        • Mostrar foto
        • Subir foto
      • Contraseña
        • Asignar contraseña
      • Familiares
        • Familiares
        • Agregar familiar
        • Eliminar familiar
      • Plan de vacaciones
        • Ver plan
        • Actualizar plan
      • Situación
        • Ver situación laboral
      • Personal
        • Personal a cargo
      • Tiempo laborado
        • Tiempo
        • Historial de marcas
      • Archivos
        • Archivos
        • Cargar archivo
        • Descargar archivo
        • Eliminar archivo
      • Cumpleaños
      • Reconocimiento
        • Mostrar imágenes
        • Mostrar imagen
        • Subir imágenes
        • Eliminar imagen
      • Tipo-Marca
        • Tipos de marca
        • Modificar tipo marca
      • Próximos cumpleaños
      • Estados civiles
    • Acciones de personal
      • Solicitudes base
        • Apercibimiento
        • Aumento salarial
        • Constancia salarial
        • Contratación
        • Embargo
        • Incapacidad
        • Licencia de maternidad
        • Licencia de paternidad
        • Permiso con goce
        • Permiso Cumpleaños
        • Licencia Matrimonio
        • Permiso Personal
        • Permiso sin goce
        • Recontratación
        • Reversión de vacación
        • Sanción salarial
        • Tiempo extra
        • Vacación
        • Terminacion
      • Acciones
        • Tipos
        • Tipos Ausencias
        • Ver acción
        • Catálogo
        • Aprobar acción
        • Rechazar acción
        • Reversar acción
        • Eliminar acción
        • Imprimir acción (.pdf)
        • Buscar
        • Descargar adjunto
      • Plantillas
        • Plantillas
        • Ver plantilla
        • Actualizar plantilla
        • Subir imagen
      • Previsualización
        • Incapacidad
        • Maternidad
        • Paternidad
    • TiempoLaborado
      • Feriado
        • Lista de feriados
        • Registrar feriado
        • Actualizar feriado
        • Ver feriado
        • Eliminar Feriados
      • HorarioAplicado
        • HorariosAplicados
        • Registrar HorariosAplicados
        • Actualizar HorariosAplicados
        • Ver HorariosAplicados
        • Eliminar HorariosAplicados
      • Horarios
        • Programación
          • Asignar horario masivo
          • Programar horario en una fecha
        • Horarios
          • Horarios por día
          • Listar horarios
          • Registrar horario
          • Ver horario
          • Actualizar horario
          • Eliminar horario
        • TiempoLaborado
      • Jornada
        • Jornadas
        • Ver jornada
        • Registrar jornada
        • Actualizar jornada
        • Eliminar Jornadas
      • Tiempo extraordinario
        • Calcular
        • Catálogo
      • Marcas
        • API de Jefaturas
          • Tiempo laborado
            • Marcas
              • Marcas
              • Detalle de marca
        • Incidencias
          • Incidencias
          • Sancionar
        • Reporte
        • Comentar marca
        • Aprobar/Rechazar marca
        • Actualizar comentario
        • Eliminar comentario
      • Rol
        • Registrar rol
        • Editar rol
      • Tablero Asistencia
        • Listado
    • Puestos
      • Puesto
        • Puestos
        • Registrar Puestos
        • Homologación
        • Actualizar Puestos
        • Ver puesto
        • Eliminar Puestos
      • Posicion
        • Posiciones
        • Registrar posición
        • Ver posición
        • Actualizar posición
        • Eliminar posición
        • Posiciones ejercicidas
      • Puestos
        • Puesto
        • Posicion
    • Planilla
      • Paquete Salarial
        • Cargos automáticos
          • Catálogo
          • Registrar cargo
          • Ver cargo
          • Actualizar cargo
          • Eliminar cargo
          • Cuotas del cargo
        • Planilla
        • Catálogo
        • Ver paquete
        • Actualizar paquete
        • Eliminar concepto aplicado
        • Actualizar concepto
        • Agregar concepto
        • Salario bruto
      • Conceptos salariales
        • Clasificación
        • Afectaciones
        • Opciones
        • Conceptos
        • Ver concepto
        • Registrar concepto
        • Actualizar concepto
        • Eliminar concepto
        • Ver concepto
        • Actualizar concepto
        • Eliminar concepto
      • Salario
        • Por hora
          • Horas
          • Incluir horas
          • Quitar horas
        • Descarga de boletas masivas
        • Detalle
        • Historia
        • Incluir concepto
        • Eliminar concepto
        • Recalcular periodo
        • Envío de boleta
        • Descarga de boleta
        • Cálculo por hora
        • Cálculo por unidad
      • Nóminas
        • Nominas
        • Registrar nómina
        • Actualizar nómina
        • Ver nómina
        • Catálogo salarial
        • Eliminar Nominas
      • Periodos
        • Periodo
          • Extraordinarios
            • Registrar
            • Eliminar
          • Periodos
          • Registrar
          • Actualizar
          • Ver
          • Eliminar
          • Calcular periodo
          • Abrir periodo
          • Acciones por persona
          • Cerrar periodo
        • Aplicación masiva
          • Personas
          • Conceptos
          • Crear proceso
          • Ver proceso
          • Eliminar proceso
          • Aplicar concepto
        • Aguinaldo
          • Asignar salario bruto
          • Eliminar salario bruto
        • Calendario
          • Completar periodos
        • Planilla
          • Periodos
            • Periodo
              • Extraordinarios
            • Aguinaldo
            • Calendario
      • Cuenta Contable
        • CuentasContables
        • Registrar CuentasContables
        • Actualizar CuentasContables
        • Ver CuentasContables
        • Eliminar CuentasContables
      • RangosRenta
        • RangosRenta
        • Registrar RangosRenta
        • Actualizar RangosRenta
        • Ver RangosRenta
        • Eliminar RangosRenta
      • Bancos
        • Bancos
        • Registrar banco
        • Actualizar Bancos
        • Ver Bancos
        • Eliminar Bancos
        • Constantes
      • Boletas de pago
        • Catálogo de envíos
        • Iniciar envío
      • Pago por unidad
        • Escalas
          • Escalas
          • Ver escala
          • Crear escala
          • Editar escala
          • Eliminar escala
        • Rangos
          • Rangos de escala
          • Crear rango
          • Editar rango
          • Eliminar rango
    • Ausencias
      • Vacaciones
        • Catálogo de saldos
        • Información general
        • Actualizar información
        • Carga de días
        • Solicitudes
        • Actividad reciente
      • Planes de vacaciones
        • Escalas
          • Registrar escala
          • Ver escala
          • Editar escala
          • Eliminar escala
        • Catálogo de planes
        • Ver plan
        • Registrar plan
        • Actualizar plan
        • Eliminar plan
      • Permisos
        • Solicitudes
      • Incapacidades
        • Solicitudes
    • Indicadores económicos
      • Tipo de cambio
    • Validaciones
      • Base
        • Identificación disponible
      • Expedientes
        • Identificación disponible
    • Estadísticas
      • Generales
        • Todas
    • Pagos
      • Órdenes
        • Catálogo
        • Ver orden
      • Verificación
        • Verificar orden
    • Importación
      • Planilla
        • Conceptos del periodo
          • Registrar proceso
          • Ver proceso
          • Existe proceso
          • Ver proceso con 1 filtro
          • Ver proceso con N filtros
          • Actualizar concepto
          • Aplicar cambios
        • Cargas salarios brutos
      • Tiempo laborado
        • Marcas
          • Cargar marcas
          • Ver marcas cargadas
          • Sancionar Marcas
          • Marcas
    • Archivos
      • Salarios
        • BAC Credomatic
          • Descargar (.txt)
          • Previsualizar
        • Salarios por entidad bancaria
        • Detalle del mes Real(.xlsx)
        • Banco BCR (.txt)
        • Banco Davivienda (.txt)
        • Banco BCT (.txt)
        • Resumen del mes(.xlsx)
        • Cuentas Bancarias(.xlsx)
        • Resumen del periodo (.xlsx)
        • Detalle del periodo (.xlsx)
        • Detalle del mes proyeccion(.xlsx)
        • Banco LAFISE (.xlsx)
        • Banco SCOTIABANK (.xlsx)
        • Banco BCT(.xlsx)
        • INS (.txt)
        • Banco BN (.xlsx)
        • Salario Por Rango (.xlsx)
        • Banco BN (.txt) Copy
        • Resumen del periodo (.xlsx) Copy
      • Asiento
        • Asiento Contable
        • Detalle Contable
        • Asiento Provision Aguinaldo
        • Asiento Provision Vacac Acum
      • Generales
        • Detallado Beneficios(.xlsx) Copy
      • Planilla
        • Aguinaldo
          • Salarios brutos (.xlsx)
        • Conceptos salariales
          • Plantilla de carga de montos
          • Reporte de montos de extras
    • Proyectos
      • Clientes
        • Listar clientes
        • Crear cliente
        • Ver cliente
        • Actualizar cliente
        • Eliminar cliente
      • Proyecto
        • Catálogo
        • Crear proyecto
        • Ver proyecto
        • Actualizar proyecto
        • Eliminar proyecto
      • Recursos
        • Recursos del proyecto
        • Agregar recurso
        • Actualizar recurso
        • Quitar recurso
      • Progresos
        • Progresos del proyectos
        • Ver progreso
        • Agregar progreso
        • Editar progreso
        • Eliminar progreso
      • Archivos
        • Descargar archivo
        • Agregar archivo
        • Eliminar archivo
      • Configuracion
        • Configuración de proyecto
    • Beneficios
      • Beneficio
        • Catálogo
        • Ver beneficio
        • Actualizar beneficio
        • Asignar masivamente
        • Revocar masivamente
        • Eliminar beneficio
    • Parametros
      • Boletas de pago
        • Ver parametros boletas
        • Actualizar Parametros boletas
      • Jefaturas
        • Ver parámetros
        • Actualizar Parametros boletas
      • Seguridad
        • Ver parámetros
        • Actualizar parámetros de seguridad
      • Marcas
        • Ver parametros marcas
        • Actualizar Parametros marcas
      • Planilla
        • Ver parametros planilla
        • Actualizar Parametros planilla
      • Vacaciones
        • Parámetros
        • Actualizar
      • Autoservicio
        • Ver parametros autoservicio
    • Liquidaciones
      • Calcular Liquidacion
      • Boleta-Liquidacion (PDF)
      • Actualizar Aguinaldo
      • Actualizar Liquidacion Generall
      • Liquidaciones
      • Actualizar Vacaciones
      • Actualizar Cesantia
      • Actualizar Salarios
    • Notificaciones
      • Suscripciones
      • Actualizar suscripción
    • Integraciones
      • Contabilidad
        • Asientos
          • Asiento de nómina
            GET
    • Reportes
      • Colaboradores
        • Reporte General Colaboradores
      • Vacaciones
        • Reporte Saldo Vacaciones
    • Programación
    • Schemas
      • ClienteInput
      • Afectacion
      • ClienteResumen
      • OpcionConcepto
      • EscalaPago
      • Concepto
      • ConceptoListado
  • Tempo
    • Quiosco
      • Marca facial
      • Detalle de ubicación
      • Marca por PIN
      • Generar PIN
      • Autentificar por ubicación
      • Marca Face liveness
    • Personal
      • Marcar facial
      • Consultar marcas
    • Configuración
      • Cargar configuración
      • Guardar configuración
  1. Asientos

Asiento de nómina

Entorno desarrollo
https://dev-api.talentify.cr
Entorno desarrollo
https://dev-api.talentify.cr
GET
/api/integraciones/contabilidad/asiento-nomina
Este endpoint genera y retorna el asiento contable de nómina correspondiente al mes de cierre indicado (mesCierre), consolidando los movimientos contables calculados por la plataforma Talentify Nómina para ser integrados con un sistema contable externo.

¿Qué hace?#

Busca el periodo de nómina cuyo cierre corresponde al mes indicado (ej. 2026/02). Obtiene el asiento contable asociado a ese cierre (metadatos del asiento + periodo + unidad de negocio), y finalmente devuelve las líneas contables (lines) en el siguiente formato:
número de línea (lineNo)
cuenta contable (account)
descripción de cuenta (accountName)
débito (debit)
crédito (credit)
Además, la estructura presenta un campo llamado totals que contiene el cálcula y sumatoria de débito, crédito y la diferencia.
Formato de fechas
Considerar el formato de fechas para los siguientes campos:
generatedAt: fecha/hora de generación en RFC3339 (ISO 8601), con zona horaria.
fechaCierre y accountingDate: fechas en YYYY-MM-DD.
Notas de integración
1.
El campo externalId identifica de forma única el documento (útil para idempotencia y evitar duplicados en el sistema contable).
2.
La respuesta incluye información de la empresa (company) y el periodo (period) para trazabilidad.
3.
El endpoint requiere autenticación Bearer (Sanctum/JWT según configuración).

Solicitud

Autorización
Proporciona tu token bearer en el encabezado
Authorization
al realizar solicitudes a recursos protegidos.
Ejemplo:
Authorization: Bearer ********************
Parámetros de consulta

Parámetros de Header

Parámetros del Body multipart/form-data

Respuestas

🟢200
application/json
Bodyapplication/json

Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://dev-api.talentify.cr/api/integraciones/contabilidad/asiento-nomina?mesCierre=2025%2F12' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'
Respuesta Ejemplo de Respuesta
{
    "schemaVersion": "1.0",
    "source": "talentify-nomina",
    "externalId": "eabda5da-73e1-4534-a55e-392de562cb27",
    "generatedAt": "2026-02-23T23:09:07-06:00",
    "company": {
        "unidadNegocioId": 1234,
        "nombre": "Euromobilia",
        "identificacionJuridica": "3101077629",
        "logo": {
            "fileName": "3101000000.png",
            "url": "https://dev-talentify.twic.pics/unidad/2875/logo/3101000000.png"
        }
    },
    "period": {
        "periodoId": 5678,
        "fechaCierre": "2025-12-31",
        "nominaId": 4228,
        "moneda": "CRC"
    },
    "journalEntry": {
        "asientoId": 1890,
        "reference": "PLANILLA-20251231",
        "description": "Asiento contable al cierre de periodo",
        "accountingDate": "2025-12-31"
    },
    "lines": [
        {
            "lineNo": 1,
            "account": "20-25-01-03-05-020-000-000-00",
            "accountName": "Ajuste de vacaciones",
            "debit": 1201774.76,
            "credit": 0
        },
        {
            "lineNo": 2,
            "account": "20-25-01-05-01-001-002-000-00",
            "accountName": "Otras horas laboradas",
            "debit": 124950.26,
            "credit": 0
        },
        {
            "lineNo": 3,
            "account": "20-25-02-02-01-020-000-000-00",
            "accountName": "Ajuste de vacaciones",
            "debit": 138694.52,
            "credit": 0
        }
    ],
    "totals": {
        "debit": 343259601.19,
        "credit": 343259601.17,
        "difference": 0.02
    }
}
Modificado en 2026-04-22 22:18:16
Anterior
Actualizar suscripción
Siguiente
Reporte General Colaboradores
Built with