BC Blueprint - Number Series

BC Blueprint - Number Series

BC Blueprint - Number Series

Un análisis funcional y técnico en profundidad sobre el mecanismo que asigna identidad a clientes, artículos, documentos y movimientos en Business Central; cómo selecciona una línea por fecha; qué diferencia existe entre numeración continua y no bloqueante; qué objetos forman el módulo Microsoft.Foundation.NoSeries; cuándo utilizar No. Series o No. Series - Batch; y cómo evitar que un inocente GetNextNo convierta el registro concurrente en una sala de espera.

Nota de versión: los nombres, identificadores de objetos y procedimientos públicos de este artículo se han contrastado con la documentación pública de Microsoft disponible el 18 de octubre de 2026. El módulo actual de numeración pertenece al namespace Microsoft.Foundation.NoSeries. Los textos funcionales están en español, mientras que los nombres de objetos, campos, procedimientos y valores AL conservan su denominación original en inglés. Comprueba siempre los símbolos de la versión contra la que compila tu extensión: un Codeunit "No. Series" parece estable hasta que decides escribir una extensión que vivirá más años que la configuración que la originó.

La infraestructura que se disfraza de campo de texto

En Business Central casi todo tiene un número.

Un cliente tiene No.. Un artículo tiene No.. Un pedido, una factura registrada, un envío, un movimiento de diario, un activo fijo y una orden de producción también tienen números. Incluso muchos registros que nadie recuerda haber creado hasta que aparecen en una incidencia poseen algún tipo de identidad secuencial.

Desde la interfaz, el proceso parece trivial:

  1. El usuario pulsa Nuevo.
  2. Business Central muestra un valor como C-10482.
  3. La vida continúa.

Pero ese valor ha tenido que resolver varias decisiones:

  • Qué serie corresponde a ese tipo de registro.
  • Si puede elegirse una serie alternativa.
  • Qué línea de la serie está vigente para la fecha utilizada.
  • Si el número debe introducirse manualmente o generarse automáticamente.
  • Si se permiten huecos.
  • Si el orden de las fechas debe respetarse.
  • Qué ocurre cuando cien sesiones solicitan un número a la vez.
  • Cuándo debe persistirse el nuevo estado.
  • Qué número se utiliza en el documento abierto y cuál en el documento registrado.

Una No. Series no es, por tanto, un contador bonito. Es una pieza transversal de identidad, control, trazabilidad, concurrencia y experiencia de usuario.

La explicación habitual dice que las series numéricas sirven para crear números consecutivos. Es correcta de la misma manera que decir que una base de datos sirve para guardar cosas: técnicamente impecable y prácticamente insuficiente.

Este artículo persigue cuatro objetivos:

  1. Separar los conceptos funcionales que suelen mezclarse.
  2. Desmontar la arquitectura actual del módulo de No. Series.
  3. Explicar las consecuencias transaccionales y de rendimiento.
  4. Proporcionar patrones AL, pruebas y criterios de diseño aplicables a extensiones reales.

Primero, el modelo mental

Antes de tocar una página de configuración conviene distinguir cinco elementos.

1. La identidad empresarial

Es el valor que identifica al registro: C-10482, SO-2026-00341 o QI-000157.

La identidad puede tener significado visible para la organización, pero no debería intentar contener toda la biografía del registro. Cuando un número codifica año, país, centro, departamento, canal, tipo de cliente y estado emocional del implantador, deja de ser una identidad y se convierte en un formulario comprimido con guiones.

2. No. Series

Es la cabecera lógica de la política de numeración. Define si la serie genera números por defecto, permite introducción manual y exige orden cronológico.

Ejemplo:

Code: QI-CERT
Description: Quality inspection certificates
Default Nos.: Yes
Manual Nos.: No
Date Order: Yes

3. No. Series Line

Es la regla efectiva para un periodo. Contiene Starting Date, Starting No., Ending No., Warning No., Increment-by No., el último número utilizado y la implementación seleccionada.

Una serie puede tener varias líneas. La cabecera dice qué política es; las líneas dicen cómo numera en cada momento.

4. No. Series Relationship

Relaciona una serie principal con alternativas válidas. Permite que un proceso configurado con una serie predeterminada seleccione otra compatible sin aceptar cualquier serie existente en la compañía.

5. El consumidor

Es el setup, maestro, documento o proceso que apunta a la serie. Sales & Receivables Setup, Purchases & Payables Setup, un journal batch o una tabla personalizada no contienen el contador: contienen el código de la política que debe utilizarse.

Esta separación es la primera idea importante:

El registro empresarial conserva el número y, normalmente, el código de serie utilizado. El setup elige la política. No. Series describe esa política. No. Series Line mantiene su estado operativo.

El flujo completo en una imagen

Arquitectura funcional y técnica de Number Series Un setup referencia una serie. La fecha de uso selecciona una línea. La implementación genera el número y actualiza el estado antes de asignarlo al registro consumidor. De la configuración al número asignado La fecha y la implementación son parte del contrato, aunque el usuario solo vea el campo No. Setup o proceso Customer Nos. Order Nos. · Posting Nos. No. Series Default · Manual Date Order · Relationships Selección temporal UsageDate Línea vigente y abierta No. Series Line Rango · Incremento · Warning Last No. Used · Last Date Used Estado de la numeración Implementación Normal: estado transaccional Sequence: no bloqueante Interface No. Series - Single Registro.No. = siguiente número
El código de serie no produce el número por sí mismo. Identifica una política que, combinada con una fecha, selecciona una línea y delega en una implementación.

La arquitectura contiene una decisión deliberada: el consumidor no debería saber cómo se guarda el contador ni cómo se genera el siguiente valor. Solo conoce el código de serie, la fecha de uso y el contrato público de Codeunit "No. Series" o Codeunit "No. Series - Batch".

Mapa de objetos que merece la pena conocer

El núcleo se encuentra en Microsoft.Foundation.NoSeries, dentro de Business Foundation.

ID Tipo Objeto Responsabilidad
308 Table No. Series Cabecera de la política: código, descripción, numeración predeterminada, numeración manual y orden por fecha.
309 Table No. Series Line Rango efectivo, fechas, incremento, último número, último uso e implementación.
310 Table No. Series Relationship Alternativas válidas asociadas a una serie principal.
456 Page No. Series Lista administrativa de series y acceso a líneas, relaciones y acciones.
457 Page No. Series Lines Configuración y consulta de los rangos efectivos.
458 Page No. Series Relationships Mantenimiento de relaciones entre series.
310 Codeunit No. Series Fachada pública para obtener, consultar y validar números con interacción directa con base de datos.
308 Codeunit No. Series - Batch Fachada pública que acumula cambios y los persiste mediante SaveState().
397 Enum No. Series Implementation Selecciona la implementación Normal o Sequence; es extensible e implementa la interfaz.
— Interface No. Series - Single Contrato de generación: PeekNextNo, GetNextNo, GetLastNoUsed y MayProduceGaps.

Que una tabla y un codeunit compartan ID no es un error. Los rangos de IDs pertenecen a tipos de objeto diferentes. Business Central lleva décadas permitiendo este pequeño generador de dudas en revisiones de código.

Los procedimientos públicos esenciales

Codeunit "No. Series" expone, entre otros:

  • GetNextNo: obtiene y consume el siguiente número.
  • PeekNextNo: calcula el siguiente número sin incrementarlo.
  • GetLastNoUsed: consulta el último número utilizado.
  • TestManual e IsManual: validan o consultan la entrada manual.
  • TestAutomatic e IsAutomatic: validan o consultan la generación automática.
  • HasRelatedSeries, AreRelated y TestAreRelated: trabajan con relaciones.
  • LookupRelatedNoSeries: abre la selección de series relacionadas.
  • GetNoSeriesLine: localiza la línea aplicable para un código y fecha.
  • SelectCurrentNoSeriesLine: selecciona la línea actual.
  • MayProduceGaps: pregunta a la implementación si puede dejar huecos.
  • IsNoSeriesInDateOrder: consulta el requisito de orden cronológico.

Codeunit "No. Series - Batch" ofrece las operaciones de generación equivalentes y añade:

  • SaveState(): persiste todos los cambios acumulados.
  • SaveState(TempNoSeriesLine): persiste un estado temporal concreto.
  • SimulateGetNextNo: incrementa de forma simulada desde un valor indicado.
  • SetSimulationMode: impide guardar el estado de la instancia.

La diferencia no es cosmética. Una fachada actualiza el estado durante cada llamada; la otra trabaja sobre estado temporal y requiere una decisión explícita para guardarlo.

La cabecera No. Series: cuatro campos y bastantes consecuencias

La tabla No. Series parece pequeña porque lo es. Su influencia, sin embargo, no respeta ese tamaño.

Campo Pregunta que responde Consecuencia
Code ¿Cómo se identifica la política? Es el valor referenciado desde setups, documentos y maestros.
Description ¿Qué pretende numerar? Ayuda al administrador; no participa en el cálculo.
Default Nos. ¿Debe generarse automáticamente un número? Permite que el alta consuma la serie sin intervención manual.
Manual Nos. ¿Puede el usuario escribir un número? Habilita rutas manuales, pero no garantiza por sí sola unicidad ni calidad.
Date Order ¿Deben consumirse números en orden cronológico? Impide retroceder respecto a Last Date Used cuando la implementación lo valida.

Default Nos. y Manual Nos. no son opuestos perfectos

Pueden producirse cuatro combinaciones:

Default Nos. Manual Nos. Comportamiento esperado
Sí No El sistema genera el número; el usuario no debería sustituirlo libremente.
Sí Sí Existe un valor automático, pero se permite introducir otro manual.
No Sí El usuario debe escribir un número o elegir una serie relacionada mediante la lógica de la página.
No No Configuración normalmente inútil para altas ordinarias: no genera y tampoco acepta manuales.

La combinación Default Nos. = Yes y Manual Nos. = Yes puede ser válida para maestros en los que se desea una propuesta automática con posibilidad de conservar una referencia externa. En documentos auditables suele exigir más cautela: permitir números manuales amplía el espacio de errores, duplicidades e interpretaciones creativas.

Date Order no significa ordenar la lista por fecha

Significa que la numeración debe respetar el tiempo de uso. Si el último número se consumió con fecha 18 de octubre, intentar obtener otro con fecha 17 puede fallar.

Esto importa en documentos registrados y diarios porque la fecha relevante no siempre es WorkDate(). Puede ser Posting Date, Document Date o la fecha explícita que el proceso entregue a GetNextNo.

Regla práctica: si el orden temporal tiene valor fiscal o de auditoría, pasa la fecha empresarial correcta. Utilizar WorkDate() por comodidad técnica puede crear una numeración perfectamente ordenada respecto a la fecha equivocada.

No. Series Line: donde vive el estado real

Una línea de serie combina configuración, calendario y estado.

Campo Función
Series Code Vincula la línea con su cabecera.
Line No. Diferencia líneas dentro de la serie.
Starting Date Determina desde cuándo puede aplicarse la línea.
Starting No. Primer valor que puede producir el rango.
Ending No. Límite del rango. Vacío suele significar que no se ha definido un final explícito.
Warning No. Umbral a partir del cual debe avisarse de que el rango se agota.
Increment-by No. Salto aplicado entre números consecutivos.
Last No. Used Último valor consumido por la implementación que mantiene estado en tabla.
Open Indica que la línea continúa disponible.
Last Date Used Fecha empresarial asociada al último consumo.
Sequence Name Nombre de la secuencia subyacente cuando se utiliza esa implementación.
Starting Sequence No. Punto de partida numérico de la secuencia.
Implementation Normal o Sequence.

Varias líneas, una sola política

Supongamos esta configuración:

Starting Date Starting No. Ending No. Warning No.
01/01/2026 QI26-000001 QI26-999999 QI26-990000
01/01/2027 QI27-000001 QI27-999999 QI27-990000

Una solicitud con UsageDate = 15/12/2026 debe utilizar la primera línea. Una solicitud con UsageDate = 02/01/2027 debe utilizar la segunda.

Selección de No. Series Line mediante UsageDate Una línea comienza en enero de 2026 y otra en enero de 2027. La fecha de uso determina cuál se utiliza. La fecha elige la línea; la línea elige el rango 01/01/2026 Línea 2026 QI26-000001 → QI26-999999 Vigente hasta que empiece otra línea aplicable 01/01/2027 Línea 2027 QI27-000001 → QI27-999999 Nueva secuencia visible, misma política QI-CERT UsageDate = 15/10/2026 Selecciona la línea 2026
El prefijo anual no aparece por magia. Se obtiene configurando otra línea con una nueva fecha y un nuevo rango.

Cambiar de año no obliga a crear otra cabecera de serie. Una nueva línea mantiene la referencia del setup y cambia el rango de forma temporal. Esto reduce configuración duplicada y conserva la política estable.

Warning No. es operación preventiva, no decoración

El warning existe para actuar antes de llegar a Ending No.. Un rango agotado durante el registro no es un pequeño inconveniente administrativo: puede detener facturación, expediciones o diarios en el peor momento posible.

Un diseño sensato define un umbral con margen suficiente para:

  1. Detectar el aviso.
  2. Entender qué proceso consume la serie.
  3. Crear o ampliar el siguiente rango.
  4. Probarlo.
  5. Desplegar la configuración antes de que el último número llegue con una sonrisa poco colaborativa.

Cómo se construye el siguiente número

El rango se expresa como Code[20], no como Integer. Esto permite prefijos y formatos como:

C-000001
SO-26-004812
QI/2026/000157

El motor incrementa la parte incrementable respetando el formato y el valor de Increment-by No.. Conceptualmente:

QI-000008 + 1  → QI-000009
QI-000009 + 1  → QI-000010
QI-000010 + 5  → QI-000015

La longitud máxima documentada para un número de serie es de 20 caracteres. Ese límite parece generoso hasta que se mezclan un prefijo corporativo, cuatro dígitos de año, un código de país, una barra, otro guion y la esperanza de emitir diez millones de documentos.

El formato es también capacidad

QI-26-000001 ofrece seis posiciones numéricas: un máximo lógico de 999.999 valores dentro de ese patrón. QI-26-001 solo ofrece tres.

Antes de definir una serie calcula:

  • Volumen anual actual.
  • Crecimiento esperado.
  • Posibles reintentos o documentos cancelados.
  • Si se permiten huecos.
  • Horizonte antes de cambiar de línea.
  • Longitud adicional que puedan necesitar procesos derivados.

Microsoft advierte de escenarios en los que Business Central añade un identificador de sistema al número, por ejemplo al construir determinados identificadores de aplicación. Consumir los 20 caracteres completos puede dejar sin espacio a procesos que necesitan añadir un sufijo.

No intentes meter el modelo de datos dentro del número

Un número como ES-MAD-SALES-B2B-2026-000001 parece informativo. También es rígido, largo y propenso a quedar obsoleto cuando la venta cambia de centro, canal o clasificación.

La información analítica pertenece a campos, dimensiones y relaciones. La identidad debe ser estable. Si el significado mutable vive dentro de la clave, cada cambio organizativo convierte la numeración en una discusión arqueológica.

Manual, automático y relacionado: tres decisiones diferentes

Estos conceptos suelen mezclarse, pero responden a preguntas distintas.

Numeración automática

Default Nos. indica que la serie puede proponer el siguiente número automáticamente. Es la ruta habitual en cards y documentos.

Numeración manual

Manual Nos. autoriza que un usuario o proceso entregue el valor. El patrón AL correcto valida esa autorización con TestManual cuando el campo No. cambia respecto al registro anterior.

Permitir manuales no elimina la responsabilidad de comprobar:

  • La clave primaria o índice único.
  • El formato requerido por el negocio.
  • Colisiones con valores que la serie pudiera generar más adelante.
  • Permisos y trazabilidad del cambio.

Series relacionadas

Una relación permite seleccionar entre políticas compatibles. Ejemplo:

  • Serie principal QI-ALL.
  • Relacionada QI-FOOD.
  • Relacionada QI-ELECT.
  • Relacionada QI-PHARM.

La relación no fusiona contadores. Cada serie mantiene sus líneas y su estado. Solo declara que, en un contexto que parte de QI-ALL, las otras son elecciones válidas.

`Default Nos.`Decide si existe una propuesta automática.
`Manual Nos.`Decide si se acepta un valor escrito desde fuera del generador.
`No. Series Relationship`Decide qué políticas alternativas pueden seleccionarse.

Normal frente a Sequence: continuidad o concurrencia

La arquitectura actual encapsula la generación tras la interfaz No. Series - Single. El enum extensible No. Series Implementation selecciona una implementación.

Los valores estándar son:

  • Normal: actualiza el estado mediante la tabla y participa en la transacción.
  • Sequence: utiliza secuencias de base de datos y no actualiza la tabla en cada llamada.

Implementación Normal

La implementación normal está diseñada para escenarios en los que la continuidad importa. Cuando una transacción obtiene un número, la línea correspondiente debe mantenerse coherente hasta que la transacción confirma o revierte.

La ventaja es el control transaccional. El coste es el bloqueo: la fila de No. Series Line puede convertirse en un punto de serialización si muchas sesiones solicitan números de la misma serie dentro de transacciones largas.

El problema no suele ser obtener el número. El problema es obtenerlo al principio, realizar después validaciones, cálculos, inserciones, llamadas y eventos, y mantener el bloqueo mientras todo el desfile termina.

Implementación Sequence

La implementación Sequence utiliza una secuencia de base de datos. La obtención es no bloqueante respecto al estado tradicional de la línea y mejora la concurrencia.

Pero una secuencia puede dejar huecos:

  • La transacción obtiene un número y después falla.
  • Se reserva un valor que no llega a utilizarse.
  • Un rollback revierte los datos empresariales, pero no devuelve necesariamente el número a la secuencia.

Esto no es un defecto accidental. Es la propiedad que permite separar la generación de la transacción y evitar que cada alta compita por la misma fila.

Comparación entre implementación Normal y Sequence Normal mantiene el estado dentro de la transacción y puede bloquear. Sequence obtiene valores fuera de ese estado transaccional, escala mejor y puede dejar huecos. La decisión no es técnica: depende del valor del hueco Normal Estado transaccional en No. Series Line Sesión A GetNextNo Sesión B Espera el bloqueo ✓ Mejor control de continuidad ✓ El rollback protege el estado △ Posible contención concurrente △ Sensible a transacciones largas Úsala cuando la continuidad sea requisito. Sequence Secuencia de base de datos no bloqueante Sesión A Obtiene 1042 Sesión B Obtiene 1043 ✓ Mayor concurrencia ✓ Menor contención por numeración △ Un rollback puede dejar hueco △ No sirve para toda exigencia fiscal Úsala cuando los huecos sean aceptables.
No existe una implementación universalmente mejor. Existe una implementación coherente —o no— con la obligación empresarial.

Allow Gaps in Nos. y la arquitectura actual

Funcionalmente, Business Central presenta la posibilidad de permitir huecos. Arquitectónicamente, esa decisión utiliza la implementación basada en secuencia. La documentación actual del enum lo expresa como Normal frente a Sequence, y la API ofrece MayProduceGaps para preguntar por la propiedad sin acoplar el consumidor al valor concreto del enum.

Ese detalle es una buena lección de diseño: el código que necesita saber si una serie puede dejar huecos debería preguntar MayProduceGaps. No debería asumir que un valor visual o una implementación futura se comportará siempre de una forma concreta.

Matriz de decisión

Escenario Huecos Concurrencia Elección habitual
Factura registrada sometida a numeración fiscal Normalmente no aceptables Media/alta Normal, revisando requisitos locales.
Cliente, proveedor o artículo Habitualmente aceptables Alta en migraciones Sequence.
Sales Quote Aceptables Puede ser alta Sequence.
Warehouse Pick o actividad operativa Habitualmente aceptables Alta Sequence.
Certificado registrado con obligación de continuidad No aceptables Depende del proceso Normal.
Registro técnico interno sin significado auditado Aceptables Alta Considerar Sequence o incluso SystemId, según el caso.
La aplicación no decide la normativa por ti. Que Business Central permita seleccionar una implementación no significa que la numeración sea válida en cualquier país, localización, sector o proceso. La continuidad legal debe validarse con los responsables funcionales y fiscales correspondientes.

Documentos abiertos y documentos registrados: dos identidades distintas

En áreas como ventas y compras, el documento editable y el documento registrado no son el mismo registro ni tienen necesariamente la misma serie.

Un sales order puede utilizar:

  • Order Nos. para el documento abierto.
  • Posted Shipment Nos. para el envío registrado.
  • Posted Invoice Nos. para la factura registrada.
  • Posted Credit Memo Nos. para abonos.

El número del pedido ayuda a operar. El número de la factura registrada ayuda a auditar y comunicar un documento legal. Mezclar ambos ciclos limita flexibilidad y puede forzar continuidad donde no es necesaria o permitir huecos donde sí importan.

Ciclo de numeración de un documento de venta El pedido editable usa una serie operativa. Al registrar se generan documentos registrados con sus propias series y requisitos. Un proceso, varias identidades Sales Order No. = SO-006482 Editable · cancelable · operativo Los huecos pueden ser aceptables Posted Shipment No. = SH-004921 Resultado logístico registrado Sales Invoice No. = FV-2026-018552 Documento contable y fiscal Posting engine elige la serie destino
La continuidad exigida al resultado registrado no obliga a tratar el borrador operativo con la misma estrategia.

Asignar demasiado pronto también es una decisión

Si una serie legal se consume al crear un borrador y ese borrador se elimina, el diseño ha trasladado la obligación de continuidad a un objeto que todavía no era legal. Por eso los motores de registro suelen disponer de series específicas y asignan números registrados dentro del proceso de posting.

La pregunta correcta no es “¿cuándo puedo obtener el número?”, sino “¿en qué momento nace la identidad que este número representa?”.

Recorrido interno de una llamada a GetNextNo

Una llamada sencilla esconde varias etapas conceptuales:

NewNo := NoSeries.GetNextNo(NoSeriesCode, UsageDate);

El flujo puede resumirse así:

  1. Validar que NoSeriesCode contiene una serie utilizable.
  2. Localizar la cabecera No. Series.
  3. Filtrar sus líneas por código, fecha y estado.
  4. Seleccionar la línea aplicable a UsageDate.
  5. Validar orden por fecha, rango, warning y final.
  6. Delegar en la implementación indicada por Implementation.
  7. Calcular u obtener el siguiente valor.
  8. Actualizar el estado correspondiente.
  9. Devolver un Code[20] al consumidor.

La API permite ocultar errores y warnings mediante determinados overloads:

NewNo := NoSeries.GetNextNo(NoSeriesCode, UsageDate, true);

Si se ocultan y ocurre un problema, el resultado puede ser vacío. Esto es útil para consultas tolerantes, pero peligroso cuando un número es obligatorio.

No conviertas errores de configuración en cadenas vacías silenciosas. Si el proceso no puede continuar sin número, deja que la API explique la causa o valida explícitamente el resultado. Un error visible en el setup es más barato que un registro parcialmente construido con identidad vacía.

PeekNextNo no reserva nada

PeekNextNo calcula cuál sería el siguiente número sin incrementar el estado.

Es apropiado para:

  • Mostrar una previsualización.
  • Comparar un valor que ya existe con lo que produciría la serie.
  • Simular o validar lógica antes de decidir el consumo.

No es apropiado para:

  • Prometer al usuario que ese número seguirá disponible.
  • Generar una clave y guardarla mucho más tarde.
  • Implementar reservas caseras.

Entre PeekNextNo y una llamada posterior otra sesión puede consumir el número. La previsualización no es una escritura con buenos modales; es solo una lectura.

No. Series frente a No. Series - Batch

La documentación actual es explícita:

  • Codeunit "No. Series" interactúa activamente con la base de datos y no acumula peticiones.
  • Codeunit "No. Series - Batch" acumula cambios hasta llamar a SaveState().

Cuándo utilizar la fachada directa

Utiliza No. Series cuando:

  • Necesitas uno o pocos números.
  • El alta del registro es sencilla.
  • Quieres que el estado se actualice junto con cada llamada.
  • No estás recorriendo cientos o miles de elementos dentro del mismo proceso.

Cuándo utilizar batch

Utiliza No. Series - Batch cuando:

  • Un proceso obtiene muchos números.
  • Trabajas con varias series durante el mismo posting.
  • Quieres evitar modificaciones repetidas de No. Series Line.
  • Necesitas simular incrementos coherentes.
  • Puedes definir con claridad el punto en que el estado debe persistirse.

Ejemplo simplificado:

local procedure AssignInspectionNos(var TempInspection: Record "Quality Inspection" temporary)
var
    QualitySetup: Record "Quality Setup";
    NoSeriesBatch: Codeunit "No. Series - Batch";
begin
    QualitySetup.Get();
    QualitySetup.TestField("Inspection Nos.");

    if TempInspection.FindSet() then
        repeat
            TempInspection."No." :=
                NoSeriesBatch.GetNextNo(
                    QualitySetup."Inspection Nos.",
                    TempInspection."Inspection Date");
            TempInspection.Modify();
        until TempInspection.Next() = 0;

    NoSeriesBatch.SaveState();
end;

La llamada a SaveState() no es una ceremonia opcional al final del ejemplo. Es el punto en el que el estado acumulado se escribe.

El error clásico del batch

NewNo := NoSeriesBatch.GetNextNo(NoSeriesCode);
// Falta SaveState().

La variable devuelve valores coherentes durante la vida de esa instancia, pero el estado no se persiste como pretendía el proceso. Cuando el código parece generar números y aun así la serie no avanza correctamente, revisa este punto antes de culpar a la fase lunar o al runtime.

El booleano que cambió de significado

El refactoring oficial de Microsoft advierte de una trampa especialmente elegante: el overload GetNextNo(Code[20]; Date; Boolean) existe tanto en la API antigua como en la nueva, pero el booleano no significa lo mismo.

  • En la API legacy controlaba si debía guardarse el número solicitado.
  • En la API actual indica si deben ocultarse errores y warnings.

Una sustitución mecánica puede compilar y modificar el comportamiento. Es el tipo de migración que produce confianza durante cinco minutos y una investigación durante cinco horas.

Implementar una serie en una extensión AL

Vamos a utilizar un ejemplo neutral: una extensión para inspecciones de calidad. Cada inspección necesita un número y puede conservar la serie utilizada.

1. Campo de setup

table 50100 "Quality Setup"
{
    Caption = 'Quality Setup';
    DataClassification = CustomerContent;

    fields
    {
        field(1; "Primary Key"; Code[10])
        {
            Caption = 'Primary Key';
        }
        field(10; "Inspection Nos."; Code[20])
        {
            Caption = 'Inspection Nos.';
            TableRelation = "No. Series";
        }
    }

    keys
    {
        key(PK; "Primary Key")
        {
            Clustered = true;
        }
    }
}

El setup almacena el código de serie, no el siguiente número. Añadir TableRelation = "No. Series" proporciona lookup e integridad funcional desde la interfaz.

2. Campos del registro consumidor

field(1; "No."; Code[20])
{
    Caption = 'No.';

    trigger OnValidate()
    var
        QualitySetup: Record "Quality Setup";
        NoSeries: Codeunit "No. Series";
    begin
        if "No." = xRec."No." then
            exit;

        QualitySetup.Get();
        QualitySetup.TestField("Inspection Nos.");
        NoSeries.TestManual(QualitySetup."Inspection Nos.", "No.");
        "No. Series" := '';
    end;
}

field(2; "No. Series"; Code[20])
{
    Caption = 'No. Series';
    Editable = false;
    TableRelation = "No. Series";
}

Limpiar No. Series al introducir un número manual deja constancia de que ese valor no fue obtenido de la serie automática. Dependiendo del diseño, puede convenir conservar otra referencia de procedencia; no atribuyas a la serie un número que no consumió.

3. Generación en OnInsert

trigger OnInsert()
var
    QualitySetup: Record "Quality Setup";
    NoSeries: Codeunit "No. Series";
begin
    if "No." <> '' then
        exit;

    QualitySetup.Get();
    QualitySetup.TestField("Inspection Nos.");

    "No. Series" := QualitySetup."Inspection Nos.";

    if NoSeries.AreRelated(
        QualitySetup."Inspection Nos.",
        xRec."No. Series")
    then
        "No. Series" := xRec."No. Series";

    "No." := NoSeries.GetNextNo("No. Series", "Inspection Date");
end;

Este patrón conserva una serie relacionada del registro anterior cuando sea válida, igual que muchos maestros estándar conservan contexto durante altas consecutivas.

Si Inspection Date puede estar vacía durante OnInsert, define conscientemente la fecha:

if "Inspection Date" = 0D then
    "Inspection Date" := WorkDate();

No pases 0D por accidente y esperes que todos los procesos interpreten la ausencia de fecha igual.

4. AssistEdit para elegir una relacionada

procedure AssistEdit(OldInspection: Record "Quality Inspection"): Boolean
var
    QualitySetup: Record "Quality Setup";
    NoSeries: Codeunit "No. Series";
    DefaultHighlightedNoSeriesCode: Code[20];
    SelectedNoSeriesCode: Code[20];
begin
    QualitySetup.Get();
    QualitySetup.TestField("Inspection Nos.");

    DefaultHighlightedNoSeriesCode := "No. Series";
    if DefaultHighlightedNoSeriesCode = '' then
        DefaultHighlightedNoSeriesCode := OldInspection."No. Series";

    if not NoSeries.LookupRelatedNoSeries(
        QualitySetup."Inspection Nos.",
        DefaultHighlightedNoSeriesCode,
        SelectedNoSeriesCode)
    then
        exit(false);

    "No. Series" := SelectedNoSeriesCode;
    "No." := NoSeries.GetNextNo("No. Series", WorkDate());
    exit(true);
end;

La página llama al procedimiento desde el assist-edit del campo No.. La tabla mantiene la regla; la página solo presenta la interacción.

5. Separar número de borrador y número registrado

Si la inspección produce un certificado legal, no reutilices necesariamente Inspection Nos.. Añade Posted Certificate Nos. al setup y obtén ese número dentro del posting que crea el registro final.

PostedCertificate."No." :=
    NoSeries.GetNextNo(
        QualitySetup."Posted Certificate Nos.",
        Inspection."Posting Date");

La serie debe representar el ciclo de vida de la identidad, no la comodidad de tener un único campo de setup.

Patrones de uso que parecen inocentes y no lo son

Generar un número antes de todas las validaciones

DocumentNo := NoSeries.GetNextNo(PostingNoSeries, PostingDate);
CheckEverythingThatCanStillFail();

Con Normal, el rollback puede proteger el estado, pero la llamada temprana amplía el tiempo durante el que la línea permanece implicada en la transacción. Con Sequence, un fallo posterior puede dejar hueco.

Valida primero todo lo que no depende del número. Obtén la identidad lo más cerca posible de la creación efectiva, sin romper la atomicidad del proceso.

Utilizar una serie como generador genérico de IDs técnicos

Si nadie ve el número, no existe requisito de formato, no hay secuencia empresarial y el valor solo une tablas internas, quizá necesites SystemId, un Guid o una clave técnica distinta.

No. Series añade configuración, estado y semántica empresarial. Utilizarla para cualquier entero incremental es como alquilar un departamento fiscal para numerar filas temporales.

Compartir una serie entre procesos sin intención explícita

Dos procesos pueden apuntar a la misma serie. Eso crea un único espacio intercalado:

Pedido A → DOC-001
Devolución B → DOC-002
Pedido C → DOC-003

Puede ser correcto si la organización quiere una secuencia común. Puede ser desastroso si cada proceso esperaba continuidad independiente. El hecho de que ambos campos acepten Code[20] no significa que deban contener el mismo código.

Cambiar el formato a mitad de una línea activa

Editar Starting No. o el estado de una línea ya consumida altera la continuidad esperada. Para cambiar prefijos o reiniciar periodos, crea una nueva línea con Starting Date y prueba la transición.

Usar PeekNextNo como reserva

Ya lo hemos dicho, pero merece reincidencia: observar no es reservar. Si el proceso necesita exclusividad, debe consumir el número dentro de la transacción diseñada para ello.

Concurrencia, bloqueos y límites transaccionales

La numeración continua impone una realidad matemática: para decidir que dos sesiones no reciben el mismo siguiente número, algún estado compartido debe coordinarse.

Con la implementación normal, esa coordinación se apoya en la fila de No. Series Line. Si la transacción permanece abierta, otras sesiones que necesitan la misma línea pueden esperar.

Síntomas de contención

  • Usuarios que esperan al registrar documentos distintos pero con la misma serie.
  • Tiempos variables que desaparecen al reducir concurrencia.
  • Bloqueos asociados a No. Series Line.
  • Procesos batch rápidos en cálculo pero lentos al persistir cada número.
  • Una personalización que obtiene el número al principio y ejecuta lógica extensa después.

Formas de reducirla sin romper el negocio

  1. Utilizar Sequence en entidades donde los huecos son aceptables.
  2. Utilizar No. Series - Batch para generación múltiple coherente.
  3. Retrasar la obtención hasta después de validaciones independientes.
  4. Reducir la duración de la transacción.
  5. Evitar llamadas externas mientras se mantiene estado bloqueado.
  6. Separar series por procesos solo cuando tenga sentido funcional, no como parche automático.
  7. Medir el posting real antes de atribuir toda la espera a la numeración.
La solución de rendimiento también debe conservar el contrato. Cambiar una factura legal de `Normal` a `Sequence` puede eliminar un bloqueo y crear un problema de auditoría. Un gráfico verde no convierte un hueco prohibido en aceptable.

No. Series - Batch no hace desaparecer la transacción

El batch reduce operaciones repetidas y mantiene estado temporal hasta SaveState(). No convierte una numeración continua en no bloqueante ni elimina la necesidad de coordinar la persistencia final.

Su valor es agrupar, simplificar y optimizar. La semántica de continuidad sigue perteneciendo a la implementación seleccionada.

Migrar desde NoSeriesManagement

El módulo moderno separa responsabilidades que antes estaban concentradas en Codeunit NoSeriesManagement. El refactoring oficial recomienda utilizar:

  • Codeunit "No. Series" para uso directo.
  • Codeunit "No. Series - Batch" para cambios diferidos o múltiples.

Equivalencias conceptuales

Intención anterior Patrón actual
Obtener sin modificar PeekNextNo
Obtener y actualizar directamente GetNextNo en No. Series
Obtener varios y guardar al final GetNextNo en No. Series - Batch + SaveState()
Inicializar número y conservar serie relacionada Asignar serie, comprobar AreRelated, llamar a GetNextNo
Validar manuales TestManual o IsManual
Simular incrementos SimulateGetNextNo

No migres por búsqueda y sustitución

Una migración correcta revisa la intención de cada llamada:

  1. ¿Se quería consumir o solo consultar?
  2. ¿El booleano controlaba persistencia o errores?
  3. ¿Existía estado diferido que ahora necesita batch?
  4. ¿Se conservaba una serie relacionada?
  5. ¿El código dependía de eventos legacy?
  6. ¿La fecha pasada era realmente la correcta?

El objetivo no es eliminar warnings. Es conservar comportamiento empresarial con una API más explícita.

Impacto funcional en toda la aplicación

Maestros

Customers, vendors, items, resources, fixed assets y otros maestros utilizan series para ofrecer identidades homogéneas. Aquí suelen aceptarse huecos y la concurrencia puede ser relevante durante migraciones o integraciones masivas.

Documentos comerciales

Quotes, orders, invoices y credit memos abiertos utilizan series operativas. Sus documentos registrados utilizan otras series. La configuración influye en copia de documentos, posting, navegación y comunicación externa.

Diarios

Los journal batches pueden definir No. Series y Posting No. Series. La numeración puede depender de la fecha de registro y del proceso que renumera documentos antes de posting.

Almacén y fabricación

Warehouse activities, production orders y otros documentos operativos pueden tener volúmenes altos. Si no existe obligación de continuidad, permitir huecos reduce contención.

Integraciones

Una API que crea registros puede activar la numeración estándar o entregar un valor manual. Para lo segundo, la serie debe permitirlo y la integración debe gestionar duplicados, reintentos e idempotencia.

Auditoría

La serie no sustituye la trazabilidad. Un auditor puede necesitar explicar huecos, cancelaciones, documentos revertidos y orden temporal. El diseño debe combinar numeración, estado del documento, entradas registradas, change log cuando proceda y procedimientos operativos.

Integraciones e idempotencia: el número no es una estrategia de reintento

Supongamos que un sistema externo llama a una API para crear una inspección:

  1. Business Central obtiene QI-000145.
  2. La respuesta se pierde por un problema de red.
  3. El sistema externo reintenta.
  4. Business Central crea QI-000146.

Ahora existen dos registros para una misma intención empresarial. La serie funcionó perfectamente. El diseño de integración no.

La solución suele requerir una clave externa idempotente:

External System = LAB
External Request ID = 7b1e0b7d-...

Antes de crear, la API comprueba si esa solicitud ya fue procesada. No. identifica el registro dentro de Business Central; la clave idempotente identifica la petición externa.

Importaciones masivas

Durante una migración decide de forma explícita:

  • Conservar números históricos como manuales.
  • Generar nuevos números y almacenar la referencia legacy aparte.
  • Mantener un mapa antiguo-nuevo.
  • Ajustar la serie para evitar colisión con valores importados.
  • Utilizar Sequence o batch si el volumen y el contrato lo permiten.

No establezcas Last No. Used mirando únicamente el valor lexicográficamente mayor si los formatos históricos son heterogéneos. Prueba el siguiente valor real que produciría la línea.

Errores habituales y lo que realmente significan

Síntoma Causa probable Investigación
“You may not enter numbers manually…” Manual Nos. está desactivado y se modificó No. manualmente. Revisar OnValidate, importación o API que asignó el valor.
No existe una línea válida para la fecha Falta una línea con Starting Date aplicable o la línea no está abierta. Comparar UsageDate con las líneas de la serie.
La serie se ha agotado Se alcanzó Ending No.. Crear el siguiente rango y revisar por qué no se actuó en Warning No..
Los números retroceden en fecha Date Order está activo y se pasa una fecha anterior a Last Date Used. Verificar Posting Date y el orden del proceso.
Aparecen huecos inesperados Se usa Sequence, hubo rollbacks o consumos no finalizados. Confirmar implementación y trazas del proceso.
Usuarios se bloquean entre sí Numeración Normal compartida dentro de transacciones largas. Medir locks y localizar el momento de GetNextNo.
El batch repite o no avanza como se esperaba Falta SaveState() o se recrea la instancia. Revisar ciclo de vida de la variable y persistencia final.
Una serie alternativa no aparece No existe No. Series Relationship desde la principal. Revisar dirección y códigos de la relación.
El siguiente número tiene un formato extraño Rango o parte incrementable mal diseñados. Probar Starting No., último usado e incremento en sandbox.
Una integración crea duplicados funcionales Reintento sin idempotencia. Añadir clave externa; no culpar al contador.

Método de depuración sin adivinación ceremonial

  1. Identifica el registro y el campo de setup que selecciona la serie.
  2. Anota el código de No. Series realmente almacenado, no el que alguien recuerda haber configurado.
  3. Captura la UsageDate entregada al motor.
  4. Localiza la No. Series Line aplicable.
  5. Revisa Implementation, Starting No., Ending No., Last No. Used, Open y Last Date Used.
  6. Comprueba Default Nos., Manual Nos. y Date Order en la cabecera.
  7. Si hay selección alternativa, revisa No. Series Relationship.
  8. Distingue PeekNextNo de GetNextNo.
  9. Si es batch, localiza SaveState().
  10. Si hay espera, observa la transacción completa y no solo la línea donde se solicita el número.

Diseño de una estrategia de numeración

Empieza por clasificar identidades

Para cada entidad, documenta:

Pregunta Ejemplo de respuesta
¿Qué identifica? Certificado de inspección registrado.
¿Cuándo nace la identidad? Al registrar la inspección aprobada.
¿Quién ve el número? Cliente, calidad y auditoría.
¿Puede eliminarse el registro? No; solo corregirse mediante proceso controlado.
¿Se permiten huecos? No, según política interna y requisito aplicable.
¿Debe seguir orden de fecha? Sí, por posting date.
¿Volumen anual? 80.000 con crecimiento del 20 %.
¿Serie compartida? No; separada por tipo documental.
¿Manual permitido? Solo migración inicial, mediante proceso específico.

Convención de nombres

El código de serie debe ayudar a encontrar su uso sin intentar reproducir el número generado.

CUST       Customers
S-ORD      Sales orders
S-INV+     Posted sales invoices
QI-CERT    Posted quality certificates

La convención debe ser corta, consistente y documentada. El Code admite 20 caracteres, pero un código de setup no gana valor por acercarse al límite.

Prefijos visibles

Un prefijo aporta valor cuando distingue categorías que los usuarios manejan fuera del sistema: pedido, factura, abono o certificado.

No aporta valor cuando replica datos ya presentes y cambiantes. Si cada reorganización exige redefinir series porque el departamento aparece en el número, la identidad está demasiado acoplada a la estructura organizativa.

Reinicio anual

Un reinicio anual requiere una línea nueva, fechas correctas y pruebas alrededor del cambio:

  • Último documento del 31 de diciembre.
  • Primer documento del 1 de enero.
  • Registro atrasado con fecha del año anterior.
  • Date Order activo o inactivo.
  • Concurrencia durante el cambio.
  • Informes e integraciones que asumen un patrón.

No esperes a las 23:58 del 31 de diciembre para descubrir que el número de seis dígitos estaba pensado para cinco.

Estrategia de pruebas

Las pruebas de numeración deben validar comportamiento, no solo que el resultado “empieza por QI”.

Pruebas funcionales mínimas

  • Alta automática con Default Nos..
  • Alta manual permitida.
  • Alta manual rechazada.
  • Selección de serie relacionada.
  • Fecha anterior y posterior a un cambio de línea.
  • Aviso al alcanzar Warning No..
  • Error al superar Ending No..
  • Comportamiento de Date Order.
  • Borrado o cancelación del documento abierto.
  • Registro que genera una identidad distinta.

Pruebas AL sugeridas

[Test]
procedure NewInspectionUsesConfiguredNoSeries()
var
    Inspection: Record "Quality Inspection";
begin
    // [GIVEN] A configured automatic No. Series.
    LibraryQuality.CreateInspectionNoSeries('QI-000001', 'QI-999999');

    // [WHEN] An inspection is inserted without a number.
    Inspection.Init();
    Inspection."Inspection Date" := WorkDate();
    Inspection.Insert(true);

    // [THEN] The record receives the expected identity and series code.
    LibraryAssert.AreNotEqual('', Inspection."No.", 'No. must be assigned.');
    LibraryAssert.AreEqual(
        LibraryQuality.GetInspectionNoSeriesCode(),
        Inspection."No. Series",
        'Unexpected No. Series.');
end;

Otros tests deberían cubrir:

  • Dos inserciones consecutivas producen números distintos.
  • PeekNextNo no modifica el último número.
  • Una fecha de 2027 utiliza la línea de 2027.
  • Una serie no relacionada se rechaza.
  • No. Series - Batch produce la secuencia esperada y persiste después de SaveState().
  • El modo simulación no modifica datos.
  • Un rollback deja el resultado esperado según Normal o Sequence.

Pruebas de concurrencia

Los unit tests ordinarios no reproducen toda la contención real. Para procesos críticos añade pruebas de volumen y sesiones paralelas en un entorno representativo:

  1. Crear muchas operaciones sobre la misma serie.
  2. Medir duración, locks y errores.
  3. Comparar Normal, batch y Sequence solo donde el contrato permita alternativas.
  4. Repetir con la lógica de posting completa, incluidos subscribers.

Una prueba que llama diez mil veces a GetNextNo mide el generador. No mide necesariamente el documento real, que puede dedicar la mayor parte del tiempo a otras cosas igualmente entusiastas.

Gobierno, migración y operación

Propiedad de la configuración

Define quién puede:

  • Crear series.
  • Añadir líneas.
  • Cambiar implementación.
  • Modificar límites.
  • Permitir manuales.
  • Crear relaciones.
  • Corregir una serie agotada en producción.

La página es administrativa, pero sus cambios tienen impacto operativo y, a veces, legal.

Transporte entre entornos

Las series contienen estado de uso. Copiar configuración de sandbox a producción sin distinguir definición y estado puede sobrescribir decisiones sensibles.

Separa:

  • La política deseada.
  • Las líneas iniciales que deben crearse.
  • El estado ya consumido en cada compañía.
  • Las series localizadas o creadas por otras extensiones.

Un install codeunit puede insertar defaults si faltan. No debería reinicializar una serie existente en cada upgrade.

Monitorización operativa

Mantén una revisión periódica de:

  • Series próximas a Warning No. o Ending No..
  • Líneas que terminan al cambiar de periodo.
  • Series sin línea vigente futura.
  • Procesos con bloqueos recurrentes.
  • Series manuales en áreas donde ya no deberían serlo.
  • Huecos cuya explicación deba conservarse.

Cambios en producción

Antes de modificar una serie activa:

  1. Identifica todos sus consumidores.
  2. Revisa documentos abiertos que ya guardan No. Series.
  3. Comprueba integraciones y validaciones de formato.
  4. Evalúa requisitos locales.
  5. Prueba el siguiente número.
  6. Registra quién aprobó el cambio.
  7. Conserva evidencia del estado anterior.

Checklist antes de producción

Diseño funcional

Configuración

Desarrollo AL

Pruebas y operación

Hoja de referencia rápida

Necesidad Herramienta
Obtener y consumir un número NoSeries.GetNextNo(...)
Ver el siguiente sin consumir NoSeries.PeekNextNo(...)
Validar entrada manual NoSeries.TestManual(...)
Comprobar relación NoSeries.AreRelated(...)
Elegir una alternativa relacionada NoSeries.LookupRelatedNoSeries(...)
Generar muchos números No. Series - Batch
Persistir el batch NoSeriesBatch.SaveState()
Simular incremento NoSeriesBatch.SimulateGetNextNo(...)
Saber si puede haber huecos NoSeries.MayProduceGaps(...)
Localizar la línea aplicable NoSeries.GetNoSeriesLine(...)
Exigir orden cronológico Date Order + fecha de uso correcta
Evitar bloqueo donde los huecos son válidos Implementación Sequence
Mantener continuidad transaccional Implementación Normal

La regla que lo conecta todo

Una No. Series no genera únicamente texto. Declara el contrato de identidad de un proceso.

Ese contrato responde:

  • Qué representa el número.
  • Cuándo debe existir.
  • Quién puede decidirlo.
  • Qué fecha gobierna su secuencia.
  • Si un hueco es un hecho aceptable o un incidente.
  • Cuánta concurrencia puede soportar.
  • Qué estado debe persistirse y cuándo.

La arquitectura moderna de Business Central refleja esas decisiones mediante capas claras:

Setup
  → No. Series
      → No. Series Line seleccionada por UsageDate
          → No. Series Implementation
              → número empresarial
                  → registro o documento registrado

Cuando el diseño es correcto, nadie piensa en él. Los números aparecen, los documentos se registran y los usuarios dedican su energía a problemas más interesantes.

Cuando el diseño es incorrecto, una tabla con cuatro campos de cabecera puede bloquear facturación, agotar un rango en cierre de mes, duplicar solicitudes externas o crear un debate fiscal alrededor de FV-2026-004812.

Ese es el papel de los mecanismos invisibles: no llaman la atención mientras sostienen el sistema. Y por eso merece la pena diseñarlos como arquitectura, no como el desplegable que quedaba pendiente cinco minutos antes de salir a producción.

Referencias oficiales

Post a Comment

Previous Post Next Post