billbo

0.0.14 • Public • Published

Summary:

Utilities for the national tax billing system of Bolivian country.

Install:

        npm install billbo
        or
        npm install @arquetic/billbo
        or
        git clone https://github.com/aleftos/billbo

Description:

Código de Control (legacy)

GENERACION CUF

El Código Único de Factura permite identificar como única una factura, debe ser generado automáticamente por el aplicativo del sujeto pasivo o tercero responsable utilizando para ello los siguientes campos:

CAMPO DESCRIPCION TIPO LONGITUD
NIT (Emisor) NIT del contribuyente Numérico 13
FECHA/HORA (Emisión) Fecha y Hora del Emisor Numérico
yyyyMMddHHmmssSSS
17
SUCURSAL (de donde se emite la factura) 0 = Casa Matriz
1 = Sucursal 1
2 = Sucursal 2
N = Sucursal N
Numérico 4
MODALIDAD 1 = Electrónica
2 = Computarizada
3 = Manual
Numérico 1
TIPO EMISIÓN 1 = Online
2 = Offline
Numérico 1
CÓDIGO DOCUMENTO FISCAL 1 = Factura
2 = Nota Debito/Crédito
3 = Nota Fiscal
4 = Documento Equivalente
Numérico 1
TIPO DOCUMENTO SECTOR 1 = FACTURA ESTANDAR
2 = FACTURA SECTORES EDUCATIVOS
3 = FACTURA DE ALQUILER DE BIENES INMUEBLES
4 = FACTURA DE COMERCIALIZACION DE HIDROCARBUROS
5 = FACTURA DE SERVICIOS BASICOS
6 = FACTURA DE EMBOTELLADORAS
7 = FACTURA DE ENTIDADES FINANCIERAS
8 = FACTURA DE HOTELES
9 = FACTURAS DE HOSPITALES/CLINICAS
10 = FACTURA DE JUEGOS DE AZAR
11 = FACTURA DE ARTISTAS INTERNACIONALES
12 = FACTURA COMERCIAL DE EXPORTACION
13 = FACTURA COMERCIAL DE EXPORTACIÓN EN LIBRE CONSIGNACION
14 = NOTA FISCAL DE TASA CERO
15 = NOTA FISCAL DE EXPORTACIÓN DE SERVICIO TURÍSTICO Y HOSPEDAJE
16 = NOTA FISCAL DE ZONA FRANCA
17 = NOTA FISCAL DE ARTISTAS NACIONALES
18 = NOTA FISCAL DE COMERCIALIZACIÓN DE ALIMENTOS – SEGURIDAD ALIMENTARIA Y ABASTECIMIENTO
19 = NOTA FISCAL DE COMPRA Y VENTA DE MONEDA EXTRANJERA
20 = NOTA DE CREDITO-DEBITO
21 = NOTA DE CONCILIACION
22 = BOLETO AEREO
Numérico 2
NRO FACTURA Numero de Factura Numérico 8
PUNTO DE VENTA (POS) Número de punto de venta
0 = No corresponde
1,2,3,4,….n
Numérico 4
CÓDIGO AUTOVERIFICADOR Base 11 Numérico 1
Total 52

Nota: Todos los campos deben completarse conforme a la longitud indicada.

Incorporar a la cadena (52 dígitos) resultante, un digito auto verificador utilizando Modulo 11. La cadena resultante debe ser codificada utilizando para ello Base 16 dando como resultado el CUF buscado (código Único de Factura).

Ejemplo:

  1. Con los siguientes datos:

                         • NIT EMISOR = 123456789
                         • FECHA / HORA = 20190113163721231
                         • SUCURSAL = 0
                         • MODALIDAD = 1
                         • TIPOEMISIÓN = 1
                         • CODIGO DOCUMENTO FISCAL = 1
                         • TIPO DOCUMENTO SECTOR = 1
                         • NUMERO DE FACTURA = 1
                         • POS: 0
    
  2. Se completa cada campo según la longitud definida con ceros a la izquierda:

                         • NIT EMISOR = 0000123456789
                         • FECHA / HORA = 20190113163721231
                         • SUCURSAL = 0000
                         • MODALIDAD = 1
                         • TIPOEMISIÓN = 1
                         • CODIGO DOCUMENTO FISCAL = 1
                         • TIPO DOCUMENTO SECTOR = 01
                         • NUMERO DE FACTURA = 00000001
                         • POS: 0000
    
  3. Se concatena los campos:

                 000012345678920190113163721231000011101000000010000
    
  4. Se obtiene el módulo 11 de la cadena y se lo adjunta al final de la cadena

                 0000123456789201901131637212310000111010000000100003
    
  5. Se aplica a la cadena resultante Base 16

                 159FFE6FB1986A24BB32DBE5A2A34214B245A6A3
    

Usage:

let cuf = require('../lib/cuf');

console.log(
  'Test 1 NIT_EMISOR = 123456789, NÚMERO_FACTURA = 1, FECHA_HORA = 20190113163721231 :\n',
  cuf.cuf(
    123456789,
    1,
    20190113163721231
  )
)

console.log(
  'Test 2 most common call:\n',
  cuf.getCUF({
    NIT_EMISOR: '123456789',
    NÚMERO_FACTURA: '1',
    FECHA_HORA: '20190113163721231'
  })
)

console.log(
  'Test 3 FECHA_HORA takes data from module:\n',
  cuf.getCUF({
    NIT_EMISOR: '123456789',
    NÚMERO_FACTURA: '1',
    FECHA_HORA: cuf.getCUFTime()  // * local time
  })
)

console.log(
  'Test 4 FECHA_HORA is no present:\n',
  cuf.getCUF(
    {
      NIT_EMISOR: '123456789',
      NÚMERO_FACTURA: '29',
      // FECHA_HORA: cuf.getCUFTime(),  // * FECHA_HORA is no present
      SUCURSAL: '0',
      MODALIDAD: '1',
      TIPO_EMISIÓN: '2',
      CÓDIGO_DOCUMENTO_FISCAL: '2',
      TIPO_DOCUMENTO_SECTOR: '6',
      POS: '0'
    }
  )
)

console.log(
  'Test 5 NIT_EMISOR is number type, FECHA_HORA is no present:\n',
  cuf.getCUF(
    {
      NIT_EMISOR: 123456789,            // * number type
      NÚMERO_FACTURA: '29',
      // FECHA_HORA: cuf.getCUFTime(),  // * FECHA_HORA is no present
      SUCURSAL: '0',
      MODALIDAD: '1',
      TIPO_EMISIÓN: '2',
      CÓDIGO_DOCUMENTO_FISCAL: '2',
      TIPO_DOCUMENTO_SECTOR: '6',
      POS: '0'
    }
  )
)

console.log(
  'Test 6 FECHA_HORA is number type, TIPO_EMISIÓN contains non numeric type:',
  cuf.getCUF(
    {
      NIT_EMISOR: '123456789',
      NÚMERO_FACTURA: '29',
      FECHA_HORA: 20190113163721249,
      SUCURSAL: '0',
      MODALIDAD: '1',
      TIPO_EMISIÓN: '2A',           // * return ERROR
      CÓDIGO_DOCUMENTO_FISCAL: '2',
      TIPO_DOCUMENTO_SECTOR: '6',
      POS: '0'
    }
  )
)

console.log('Local time: ', cuf.getCUFTime());

// Output:

// Test 1 NIT_EMISOR = 123456789, NÚMERO_FACTURA = 1, FECHA_HORA = 20190113163721231 :
 { NIT_EMISOR: '123456789',
  'NÚMERO_FACTURA': '1',
  FECHA_HORA: '20190113163721230',
  SUCURSAL: '0',
  MODALIDAD: '1',
  'TIPO_EMISIÓN': '1',
  'CÓDIGO_DOCUMENTO_FISCAL': '1',
  TIPO_DOCUMENTO_SECTOR: '1',
  POS: '0',
  CUF: '159FFE6FB1986A24BB32D9C788C2785A0005A6A7' }

// Test 2 most common call:
 { NIT_EMISOR: '123456789',
  'NÚMERO_FACTURA': '1',
  FECHA_HORA: '20190113163721231',
  SUCURSAL: '0',
  MODALIDAD: '1',
  'TIPO_EMISIÓN': '1',
  'CÓDIGO_DOCUMENTO_FISCAL': '1',
  TIPO_DOCUMENTO_SECTOR: '1',
  POS: '0',
  CUF: '159FFE6FB1986A24BB32DBE5A2A34214B245A6A3' }

// Test 3 FECHA_HORA takes data from module:
 { NIT_EMISOR: '123456789',
  'NÚMERO_FACTURA': '1',
  FECHA_HORA: '20190328113205475',
  SUCURSAL: '0',
  MODALIDAD: '1',
  'TIPO_EMISIÓN': '1',
  'CÓDIGO_DOCUMENTO_FISCAL': '1',
  TIPO_DOCUMENTO_SECTOR: '1',
  POS: '0',
  CUF: '159FFE6FB198D41F2B9F4EDD635C98B1CF45A6A9' }

// Test 4 FECHA_HORA is no present:
 { NIT_EMISOR: '123456789',
  'NÚMERO_FACTURA': '29',
  FECHA_HORA: '20190328113205478',
  SUCURSAL: '0',
  MODALIDAD: '1',
  'TIPO_EMISIÓN': '2',
  'CÓDIGO_DOCUMENTO_FISCAL': '2',
  TIPO_DOCUMENTO_SECTOR: '6',
  POS: '0',
  CUF: '159FFE6FB198D41F2B9F5537B12637CC82F50027' }

// Test 5 NIT_EMISOR is number type, FECHA_HORA is no present:
 { NIT_EMISOR: '123456789',
  'NÚMERO_FACTURA': '29',
  FECHA_HORA: '20190328113205479',
  SUCURSAL: '0',
  MODALIDAD: '1',
  'TIPO_EMISIÓN': '2',
  'CÓDIGO_DOCUMENTO_FISCAL': '2',
  TIPO_DOCUMENTO_SECTOR: '6',
  POS: '0',
  CUF: '159FFE6FB198D41F2B9F5755CB07018735350023' }

// Test 6 FECHA_HORA is number type, TIPO_EMISIÓN contains non numeric type
 ERROR

// Get local time in required format

Local time:  20190328113205481

TBO

Readme

Keywords

Package Sidebar

Install

npm i billbo

Weekly Downloads

2

Version

0.0.14

License

MIT

Unpacked Size

240 kB

Total Files

34

Last publish

Collaborators

  • aleftos