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: unCodeunit "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:
- El usuario pulsa Nuevo.
- Business Central muestra un valor como
C-10482. - 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:
- Separar los conceptos funcionales que suelen mezclarse.
- Desmontar la arquitectura actual del módulo de
No. Series. - Explicar las consecuencias transaccionales y de rendimiento.
- 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. Seriesdescribe esa política.No. Series Linemantiene su estado operativo.
El flujo completo en una imagen
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.TestManualeIsManual: validan o consultan la entrada manual.TestAutomaticeIsAutomatic: validan o consultan la generación automática.HasRelatedSeries,AreRelatedyTestAreRelated: 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.
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:
- Detectar el aviso.
- Entender qué proceso consume la serie.
- Crear o ampliar el siguiente rango.
- Probarlo.
- 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.
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.
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. |
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.
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í:
- Validar que
NoSeriesCodecontiene una serie utilizable. - Localizar la cabecera
No. Series. - Filtrar sus líneas por código, fecha y estado.
- Seleccionar la línea aplicable a
UsageDate. - Validar orden por fecha, rango, warning y final.
- Delegar en la implementación indicada por
Implementation. - Calcular u obtener el siguiente valor.
- Actualizar el estado correspondiente.
- 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.
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 aSaveState().
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
- Utilizar
Sequenceen entidades donde los huecos son aceptables. - Utilizar
No. Series - Batchpara generación múltiple coherente. - Retrasar la obtención hasta después de validaciones independientes.
- Reducir la duración de la transacción.
- Evitar llamadas externas mientras se mantiene estado bloqueado.
- Separar series por procesos solo cuando tenga sentido funcional, no como parche automático.
- Medir el posting real antes de atribuir toda la espera a la numeración.
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:
- ¿Se quería consumir o solo consultar?
- ¿El booleano controlaba persistencia o errores?
- ¿Existía estado diferido que ahora necesita batch?
- ¿Se conservaba una serie relacionada?
- ¿El código dependía de eventos legacy?
- ¿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:
- Business Central obtiene
QI-000145. - La respuesta se pierde por un problema de red.
- El sistema externo reintenta.
- 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
Sequenceo 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
- Identifica el registro y el campo de setup que selecciona la serie.
- Anota el código de
No. Seriesrealmente almacenado, no el que alguien recuerda haber configurado. - Captura la
UsageDateentregada al motor. - Localiza la
No. Series Lineaplicable. - Revisa
Implementation,Starting No.,Ending No.,Last No. Used,OpenyLast Date Used. - Comprueba
Default Nos.,Manual Nos.yDate Orderen la cabecera. - Si hay selección alternativa, revisa
No. Series Relationship. - Distingue
PeekNextNodeGetNextNo. - Si es batch, localiza
SaveState(). - 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 Orderactivo 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.
PeekNextNono modifica el último número.- Una fecha de 2027 utiliza la línea de 2027.
- Una serie no relacionada se rechaza.
No. Series - Batchproduce la secuencia esperada y persiste después deSaveState().- El modo simulación no modifica datos.
- Un rollback deja el resultado esperado según
NormaloSequence.
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:
- Crear muchas operaciones sobre la misma serie.
- Medir duración, locks y errores.
- Comparar
Normal, batch ySequencesolo donde el contrato permita alternativas. - 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.oEnding 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:
- Identifica todos sus consumidores.
- Revisa documentos abiertos que ya guardan
No. Series. - Comprueba integraciones y validaciones de formato.
- Evalúa requisitos locales.
- Prueba el siguiente número.
- Registra quién aprobó el cambio.
- 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
- Create number series - Business Central
- Number sequences in Business Central
- Codeunit
No. Series - Codeunit
No. Series - Batch - Table
No. Series - Table
No. Series Line - Table
No. Series Relationship - Enum
No. Series Implementation - Interface
No. Series - Single - Microsoft BCApps: Refactoring to use the new No. Series module