Dispersión de nómina por lote: del archivo a la ejecución

Un jefe de nómina colombiano rara vez piensa en su pago mensual como un solo evento. Lo piensa como un archivo: una hoja con filas de empleados, columnas de montos y, si algo sale mal, una fila que hay que encontrar antes de que el resto del pago quede atrapado detrás de ella. Programar la fecha o repetir el ciclo cada mes es la parte fácil. La parte que decide si el pago sale bien es el archivo mismo.

En Soulbit Academy escribimos esta guía sobre esa pieza concreta: cómo se construye el archivo de un lote de nómina, qué valida el sistema antes de aceptarlo, qué ocurre cuando una fila falla y qué evidencia queda para el cierre contable. Soulbit es un riel de pago y tesorería en stablecoins para empresas, no un software de liquidación de nómina ni una integración con el sistema de recursos humanos de la empresa.

Qué es la dispersión de nómina por lote y cuándo se usa

La dispersión de nómina por lote es la ejecución de un pago masivo, en una sola operación, a partir de un archivo que reúne a todos los beneficiarios de un periodo. La empresa carga el archivo una vez, con montos y datos ya definidos, y el sistema dispersa hacia cada destinatario sin transferencias individuales.

Conviene distinguirla de la nómina recurrente. El lote es una ejecución puntual: sirve para la primera nómina de la empresa, para un pago extraordinario como un bono o una liquidación, o para un mes en que la planilla cambió por completo. La nómina recurrente, en cambio, reutiliza la misma lista de beneficiarios ciclo tras ciclo sin reconstruir el archivo. El detalle operativo de ese segundo caso está en cómo programar nómina recurrente en stablecoin, y conviene leerlo antes de decidir cuál de los dos mecanismos usar cada mes.

El lote tampoco es una forma de esquivar la periodicidad legal del salario. El Código Sustantivo del Trabajo fija que el periodo de pago de un sueldo no puede ser mayor de un mes, y el de un jornal no mayor de una semana (art. 134). La empresa puede usar el lote para ejecutar ese pago cuando su lista cambia, pero la cadencia legal sigue siendo la misma, la use en un ciclo recurrente o en una carga puntual.

Un caso típico ilustra la diferencia. Una empresa colombiana con treinta empleados fijos programa su nómina en un ciclo recurrente. Si en diciembre paga además una bonificación extraordinaria a doce personas, con montos distintos a los del sueldo mensual, esa bonificación se dispersa como un lote aparte: no forma parte del ciclo recurrente porque su lista, sus montos y su periodicidad son otros. El mismo razonamiento aplica a la liquidación de un contratista que termina su contrato a mitad de mes, o a un pago único a un grupo de proveedores que no vuelve a repetirse.

Las columnas que debe traer el archivo de nómina por lote

El archivo de nómina por lote necesita seis columnas mínimas para que el sistema pueda validarlo sin depender de una llamada o un correo aclaratorio.

Columna	Qué contiene	Por qué se valida
Identificación del periodo	Referencia interna de la empresa para el mes o el pago	Permite cruzar el lote contra la liquidación propia de la empresa
Identificación del destinatario	Documento o identificador único de cada persona	Evita pagar a un destinatario duplicado o sin ficha completa
Tipo de relación	Empleado o contratista, según la clasificación de la empresa	El sistema no decide esta calificación: solo la registra
Moneda o activo de pago	USDC, USDT o fiat en USD, EUR o GBP, según lo definido	Determina el canal de liquidación que usará cada fila
Monto neto a pagar	El importe ya liquidado por la empresa para ese periodo	Se contrasta contra el saldo fondeado antes de ejecutar
Dirección de destino verificada	La dirección o cuenta de cobro ya validada en la ficha	Es el dato irreversible: un envío a una dirección equivocada no se revierte

El monto neto de cada fila llega ya calculado por la empresa. El archivo no recalcula salarios, ni aplica retenciones, ni determina aportes a seguridad social: recibe el resultado de esa liquidación, que la empresa produce con su propio sistema o contador, y lo convierte en un lote ejecutable. La guía completa de esa parte previa está en cómo pagar nómina en Colombia.

Este punto merece decirse sin rodeos porque es la pregunta más frecuente de un área de sistemas al evaluar el mecanismo.

¿Por qué el archivo y no una integración directa con el software de nómina de la empresa?

Porque Soulbit no ofrece hoy una API ni un conector con ERP o sistemas de recursos humanos. El archivo es el mecanismo de entrada de la V1: la empresa exporta su liquidación ya calculada a este formato y la carga manualmente. No es una limitación oculta, es el alcance real del producto hoy.

Qué valida el sistema antes de aceptar el lote

Antes de aceptar un lote, el sistema comprueba dos cosas de forma bloqueante: la identidad de cada destinatario contra su ficha verificada y el saldo disponible para cubrir el total. Los errores de formato del archivo y de dirección de destino no detienen la carga entera: se marcan fila por fila, como detalla la sección siguiente.

La verificación de identidad depende de un expediente previo. Ningún destinatario nuevo entra a un lote sin haber completado antes su ficha, con su documento, su contrato o factura vigente y su dirección de destino confirmada por un canal distinto al de la solicitud original. Ese expediente se arma una sola vez y se reutiliza en cada lote posterior, y su lógica completa está documentada en la guía de nómina recurrente citada arriba, porque el expediente es el mismo para los dos mecanismos.

El saldo se verifica antes de ejecutar, no durante. El sistema contrasta el total del lote, incluida la comisión de red, contra el saldo disponible en la cuenta operativa. Si el fondeo es insuficiente, el lote queda detenido para toda la carga, no solo para las filas que exceden el saldo: es la única validación que sí afecta al archivo completo, porque el fondeo es una condición de todo el lote, no de una fila.

La verificación de la empresa es la precondición que debe completarse antes de cualquier validación de identidad o de saldo. Sin haber completado el proceso de KYB, que valida la sociedad, su actividad y sus beneficiarios finales, no existe cuenta operativa desde la cual cargar ningún archivo. Ese expediente se resuelve una sola vez, al abrir la relación, y no vuelve a repetirse lote a lote.

Qué pasa cuando una fila del archivo falla en la validación

Una fila que falla no bloquea el lote completo. Queda marcada como pendiente, con el motivo específico del rechazo, mientras las demás filas siguen su curso hacia la aprobación.

Error en la fila	Qué provoca	Cómo se resuelve
Dirección de destino no verificada	La fila queda pendiente hasta confirmar la ficha del destinatario	Verificar por un canal distinto y, si es alta nueva, hacer una transferencia de prueba
Monto en cero o negativo	El sistema rechaza la fila por dato inválido	Corregir el monto en el archivo y reenviar solo esa fila
Destinatario duplicado en el mismo lote	Riesgo de pago doble a la misma persona	Eliminar la fila repetida antes de aprobar el lote
Moneda o activo no soportado para ese destinatario	La fila queda pendiente de definición	Ajustar la moneda de pago según lo acordado con el destinatario
Ficha del destinatario incompleta	La fila no puede validarse contra ningún dato de referencia	Completar la ficha antes de incorporar a la persona al lote

¿Se puede reenviar solo la fila corregida sin rehacer el lote entero?

Sí. La corrección se aplica sobre la fila específica y el lote conserva las filas ya validadas. Esto evita el escenario más costoso operativamente: tener que reconstruir un archivo de cuarenta o cien filas porque una sola tenía un dato mal cargado.

Aprobación y doble control: el paso entre cargar y ejecutar

Ningún lote se ejecuta con la sola carga del archivo. Pasa primero por una aprobación a cargo de alguien distinto de quien construyó el archivo, incluso si el equipo financiero de la empresa son dos personas.

Ese doble control existe porque un pago on-chain, una vez ejecutado, no se revierte con una llamada al banco. La persona que aprueba revisa el total del lote, el número de filas pendientes frente a las validadas y el saldo fondeado, y solo entonces confirma la ejecución. La traza de quién aprobó y cuándo queda registrada junto al lote.

Ejecutado el lote, cada destinatario en Colombia recibe pesos o dólares reales por canales bancarios locales, según lo que haya definido la empresa fila por fila. El flujo completo de esa conversión y el rail local están documentados en dispersión de pagos en COP y USD, que conviene leer junto a esta guía porque el archivo es la entrada y el rail local es la salida del mismo proceso.

El cierre contable: la evidencia que deja cada lote ejecutado

Cada lote ejecutado deja un identificador on-chain por destinatario, la pieza que convierte un pago masivo en un conjunto de asientos contables defendibles ante una auditoría.

La conciliación se hace fila por fila, cruzando destinatario, monto bruto, comisión de red y fecha contra ese identificador. El procedimiento completo, incluido el criterio para separar bruto y comisión, está en cómo conciliar pagos en stablecoin en la contabilidad.

Esa evidencia no reemplaza las obligaciones tributarias propias de la empresa en Colombia, que siguen corriendo en paralelo al lote. La DIAN exige generar y transmitir el documento soporte de pago de nómina electrónica dentro de los primeros diez días del mes siguiente al periodo pagado, según la propia DIAN. El detalle de esa obligación, que ya tiene su propio desarrollo, está en nómina electrónica ante la DIAN.

Los aportes a la PILA corren por un calendario aparte: vencen entre el día hábil 2 y el día hábil 16 del mes siguiente, según los dos últimos dígitos del NIT del empleador, conforme al Decreto 1990 de 2016. La guía completa de esa obligación está en PILA: guía de aportes para el empleador.

¿Por qué conservar la evidencia de cada lote más allá del cierre del mes?

Porque la UGPP puede fiscalizar hasta cinco años atrás. Un lote sin identificador trazable, sin ficha de destinatario y sin registro de aprobación es un hueco documental que aparece precisamente cuando ya no hay forma sencilla de reconstruirlo.

Qué entrega Soulbit V1 en nómina por lote y qué no

La V1 ejecuta la dispersión de nómina por lote a partir de un archivo cargado por la empresa, con validación de formato, de identidad, de dirección de destino y de saldo, y con doble control antes de ejecutar. Incluye custodia institucional, saldos en USDC y USDT, fiat en USD, EUR y GBP, y rail bancario local solo en Colombia.

Lo que no entrega delimita el mecanismo con precisión. No calcula salarios, ni aportes, ni retenciones. No genera el documento soporte de nómina electrónica ante la DIAN ni la planilla PILA: esas obligaciones siguen en la empresa. Y, el límite que más preguntas genera en equipos de sistemas, no ofrece una API ni un conector con ERP o con el software de nómina de la empresa. El archivo es, hoy, el único mecanismo de carga.

No ofrecer una API no es un defecto que esconder. Un archivo estandarizado, validado fila por fila, con doble control y evidencia on-chain, resuelve el mismo problema que resolvería una integración automática, con menos superficie de error humano de la que tiene copiar y pegar importes uno por uno. La diferencia está en quién arma el archivo: hoy lo hace la empresa, no un conector automático.