Con qué corren los pasos
Piezas
Una pieza es lo que un paso usa para correr. Estas 29 las escribió KOJ y sirven para cualquier cliente; abajo están las de este.
Este cliente todavía no tiene piezas propias
Cuando una secuencia se repite en varios procedimientos, conviene armarla como una pieza: se nombra una vez y se usa en todos. Y si lo que hace falta no se puede armar con lo que hay, se pide y queda anotado.
De KOJ — sirven para cualquier cliente
P-001Leer archivo de ExcelAbre un archivo de Excel y lo convierte en tabla. Se le dice qué hoja y en qué fila están los encabezados.Traer datos
P-002Leer archivo CSVAbre un archivo de texto separado por comas o punto y coma y lo convierte en tabla. Detecta solo el separador y la codificación.Traer datos
P-003Leer de una fuente de datosConsulta una entidad de un sistema conectado —el ERP, el banco, una base— y deja guardada una copia exacta de lo que leyó, con su sello, para que la corrida se pueda reconstruir tal cual meses después.Traer datos
P-004Leer tablas de un PDFSaca las tablas de un PDF: estados de cuenta del banco, facturas, reportes que llegan sin su archivo original.Traer datos
P-005Filtrar filasDeja solo las filas que cumplen una condición: las del mes, las de una empresa, las que pasan de cierto monto.Transformar
P-006Agrupar y sumarDescargar tabla de resumen: agrupa por lo que se le diga —cliente, cuenta, mes— y suma, cuenta o promedia lo demás.Transformar
P-007Cruzar dos tablas por claveLe pega a cada fila de una tabla los datos de otra que comparten la misma clave, y dice qué hacer con las que no encuentran pareja.Transformar
P-008Comparar dos tablas por claveEl corazón de toda conciliación: pone dos fuentes lado a lado y dice qué cuadra, qué falta en una, qué sobra en la otra y en cuánto difieren, con la tolerancia que se le declare.Transformar
P-009Calcular una columnaAgrega una columna calculada a partir de las que ya están: un impuesto, un margen, una diferencia, un porcentaje.Transformar
P-011Verificar que estén las columnas obligatoriasRevisa que la tabla traiga las columnas que el paso necesita y del tipo que corresponde, antes de que un cálculo falle diez pasos después.Verificar
P-012Verificar que los totales cuadrenSuma un conjunto y lo compara contra un control: que el detalle sume lo que dice el encabezado, que lo conciliado cuadre con el saldo del banco.Verificar
P-013Detectar duplicadosEncuentra los registros repetidos por la clave que se le indique y dice cuántas veces aparece cada uno: facturas cargadas dos veces, NITs repetidos.Verificar
P-014Capturar datos con un formularioLe pide a una persona un puñado de datos con campos definidos y con tipo: monto, fecha, selección de una lista. No un campo de texto libre.Pedirle algo a una persona
P-015Solicitar una aprobaciónLe hace una pregunta a quien tiene que autorizar y espera su respuesta, con la razón escrita cuando rechaza.Pedirle algo a una persona
P-016Adjuntar evidenciaDeja pegado al paso un archivo o una foto: el voucher, la boleta, la pantalla del sistema, la firma del recibido.Pedirle algo a una persona
P-017Imprimir formato en ExcelImprimir formato en excel: toma una tabla y la deja en el formato del cliente, con sus encabezados, sus colores y sus totales donde van.Entregar
P-018Generar un PDFArma un documento en PDF con la plantilla que corresponda: un acta, un certificado, un informe, una constancia.Entregar
P-019Armar una presentaciónConvierte una tabla y su explicación en una presentación lista para mostrar: el comité mensual, el reporte a gerencia.Entregar
P-020Enviar un correoManda un correo a quien corresponda por su rol —no a una dirección quemada— con los archivos que el paso produjo.Avisar
P-021Capturar una tabla fila por filaLe pone enfrente a la persona una lista y le pide un dato por fila: cuatrocientos SKUs para contar en bodega, las entregas de una ruta para marcar entregada o rechazada. Se puede dejar a medias y retomar, y puede ocultar la existencia teórica mientras se cuenta.Pedirle algo a una persona
P-022Enriquecer una tabla consultando un servicioPor cada fila de la tabla consulta un servicio externo y le pega la respuesta: por cada proveedor, su estado en el portal de la SAT; por cada NIT, su vigencia. Si algunas filas no responden, las marca y sigue — el paso no se cae porque tres de doscientos no contestaron.Traer datos
P-023Clasificar cada diferencia contra un catálogo de causasToma las diferencias que salieron de una comparación y le pone a cada una su causa, de una lista cerrada: partida en tránsito, error de digitación, documento anulado, redondeo, pendiente de aclaración. Lo que no encaja se marca sin explicar, no se inventa una categoría nueva.Pedirle algo a una persona
P-024Aplicar una tabla de escala o tarifaBusca en qué tramo cae cada fila y le aplica la regla de ese tramo: los rangos del ISR, la escala del Bono 14, la tarifa por antigüedad, el arancel por partida.Transformar
P-025Prorratear un monto entre las filasReparte un monto entre las filas según un criterio, sin que sobre ni falte un centavo: el flete y el seguro de una importación repartidos entre los ítems del embarque para llegar al costo unitario real.Transformar
P-026Comparar contra el período anterior o la metaLa misma tabla en dos momentos: variación en quetzales, variación en porcentaje y una banda que dice cuándo la variación deja de ser normal. Real contra presupuesto, este mes contra el pasado, resultado contra meta.Transformar
P-027Clasificar por antigüedad en rangosCuenta los días entre una fecha y hoy y arma los cubos: corriente, 1 a 30, 31 a 60, más de 90. Antigüedad de saldos, tránsitos pendientes, existencias por vencer, entregas contra el tiempo prometido.Transformar
P-028Asignar un correlativo con resguardoLe pone a un documento formal su número único e irrepetible dentro de la serie que se declare, y deja guardado el resguardo ligado a la corrida que lo generó: póliza, acta, certificado, informe técnico, nota de anulación.Entregar
P-029Registrar acuerdos con responsable y fechaConvierte una reunión en una lista de acuerdos, cada uno con su responsable, su fecha comprometida y su estado. Los que quedan abiertos entran como insumo a la próxima reunión.Pedirle algo a una persona
P-030Registrar la constancia de una presentaciónDeja asentado que algo se presentó ante SAT, IGSS o Ministerio de Trabajo: número de acuse, fecha y hora, período declarado, monto y el archivo de la constancia. Y avisa si la presentación se hizo después de la fecha límite.Verificar
Declarada no es lo mismo que lista para correr. Todo el catálogo está declarado: un procedimiento puede nombrar una pieza y publicarse. Que además corra sola necesita implementación y pruebas en verde, y eso lo hace KOJ — sin excepciones, tampoco para sus propias piezas.