Sucursal y terminal

Los primeros 8 dígitos del consecutivo identifican desde dónde se emitió el comprobante: la sucursal (3 dígitos) y la terminal o punto de venta (5 dígitos). Cada combinación de sucursal, terminal y tipo de comprobante lleva su propia numeración.

Campos

Campo	Alias	Formato	Si se omite
document.branch	document.sucursal	3 dígitos, 001–999	001
document.terminal	document.punto_venta	5 dígitos, 00001–99999	00001

Podés enviar los valores sin ceros a la izquierda ("branch": "2", "terminal": "3"): Aster los completa a 002 y 00003.

Por convención, la sucursal 001 es la casa matriz y la terminal 00001 es la terminal única o centralizada. Un emisor con un solo local y un solo sistema puede omitir los dos campos.

Cómo modelar tu negocio

Sucursal corresponde a un establecimiento físico: cada local, bodega o tienda. Terminal corresponde a cada punto que emite comprobantes dentro de ese establecimiento: una caja, un punto de venta, una tableta de vendedor o un servidor de facturación en línea.

Lo importante es que dos puntos que emiten al mismo tiempo no compartan la misma combinación de sucursal y terminal si cada uno lleva su propia numeración. Si Aster numera por vos, puede compartirla sin problema: el contador es atómico.

Ejemplo: ferretería con dos locales

Ferretería La Sabana S.A. tiene la casa matriz en Guadalupe con dos cajas y un local en Escazú con una caja, además de una tienda en línea:

Punto de emisión	branch	terminal	Consecutivo de la primera factura
Guadalupe, caja 1	001	00001	00100001010000000001
Guadalupe, caja 2	001	00002	00100002010000000001
Escazú, caja 1	002	00001	00200001010000000001
Tienda en línea	001	00010	00100010010000000001

Cada fila numera aparte. El tiquete (04) de la caja 2 de Guadalupe empezaría en 00100002040000000001.

Factura emitida desde la caja 2 de Guadalupe

{
  "document": {
    "document_type": "01",
    "branch": "001",
    "terminal": "00002"
  }
}

Recomendaciones

• Guardá la sucursal y la terminal en la configuración de cada punto de venta, no en el código, para poder agregar cajas sin desplegar.
• No reutilicés una terminal para otro equipo si ese equipo lleva numeración propia. Dale un número nuevo.
• Si dejás que Aster numere, podés usar una sola terminal por local aunque tengas varias cajas. Separarlas sigue siendo útil para conciliar ventas por caja.
• Los Mensajes Receptor se numeran en la sucursal 001, terminal 00001, en sus propias series (05, 06, 07).