Series

El Catálogo de Series de Bily permite administrar series y folios para clasificar y numerar los documentos fiscales emitidos dentro de la plataforma.

Este catálogo define cómo se asignan y controlan los folios, manteniendo consistencia operativa sin imponer restricciones innecesarias al usuario.


¿Qué es una serie?

Una serie es un identificador opcional que permite clasificar y ordenar los documentos fiscales, generalmente acompañada de un folio consecutivo.

En Bily, las series:

  • Son flexibles
  • Pueden existir con o sin folio
  • Pueden estar asociadas o no a un tipo de documento
  • No bloquean la operación si el usuario decide sobrescribirlas

Tipos de documentos compatibles

Una serie puede asociarse opcionalmente a uno de los siguientes tipos de documento:

DescripciónTipoDeComprobante
FacturaINGRESO
Recibo de pagoPAGO
Nota de débitoEGRESO
Nota de cargoINGRESO
Nota de créditoEGRESO
Recibo de honorariosINGRESO
ArrendamientoINGRESO
Carta porteINGRESO
Carta porte trasladoTRASLADO
DonativoINGRESO
Recibo de nóminaNOMINA

La asociación es opcional, pero cuando existe permite a Bily sugerir automáticamente la serie y folio correctos durante la emisión.


Reglas de creación de series

Al crear una serie, Bily permite los siguientes escenarios:

  • Crear una serie sin folio inicial → Se asigna automáticamente el folio 1

  • Crear una serie con folio inicial definido por el usuario

  • Crear una serie sin tipo de documento asignado

  • Crear una serie con tipo de documento asignado

📘

Sólamente puede haber una serie asignada a un tipo de documento al mismo tiempo, de esta manera Bily evita ambigüedades al momento de sugerir series automáticas por tipo de documento.


Asignación automática de serie y folio en documentos

Durante la emisión de documentos, Bily aplica la siguiente lógica:

1. Documento sin serie ni folio especificados

  • Se busca una serie asociada al tipo de documento
  • Si existe, se asigna la serie y se utiliza el folio consecutivo
  • Si no existe, el documento se emite sin serie ni folio

2. Documento con serie pero sin folio

  • Se busca la serie en el catálogo
  • Si existe, se asigna el folio consecutivo
  • Si no existe, el documento se emite solo con la serie, sin folio

3. Documento con folio pero sin serie

  • Se respeta el folio literal
  • No se asigna serie

4. Documento con serie y folio especificados

  • Se respetan ambos valores exactamente como fueron enviados

Estas reglas aplican tanto para emisión vía API REST como desde el Panel (Dashboard).


Comportamiento en el Panel (Dashboard)

Desde el Panel de Bily:

  • Puedes crear series:
    • Con o sin folio inicial
    • Con o sin tipo de documento
  • Al emitir un CFDI:
    • Bily sugiere automáticamente la serie y folio según el documento
    • El usuario puede modificar manualmente la serie o el folio antes de emitir

Bily no bloquea al usuario si decide sobrescribir la sugerencia.


¿Cómo se administra dentro de Bily?

El catálogo de Series se administra como un recurso de control para asignar serie y folio consecutivo a distintos tipos de documentos, manteniendo consistencia y evitando duplicidades operativas.

Desde el Panel (Dashboard)

Desde el Panel de Bily podrás:

  • Crear series con o sin folio inicial
  • Asignar una serie opcionalmente a un tipo de documento
  • Consultar el consecutivo actual y administrar el catálogo de forma centralizada
  • Al emitir un documento, visualizar la serie y su consecutivo sugerido y, si tu operación lo requiere, ajustarlo manualmente

Consulta el Manual de operación Catálogos - Series


Desde la API REST

La API REST permite:

  • Crear series con folio inicial o sin folio (folio 1 por defecto)
  • Crear series con o sin tipo de documento asignado
  • Consultar y administrar series para integraciones externas
  • Aplicar las reglas de asignación de serie/folio al emitir documentos según el contenido del request

Consulta la Referencia API Series


Numeración clara sin fricción operativa

El catálogo de series de Bily ofrece un equilibrio entre control y libertad, permitiendo sugerencias inteligentes sin imponer restricciones rígidas.