/* * Coder & programmer: Luis Sanabria * Copyright: (c) Arquetic.org 2019 * Date: March, 2019 * GitHub: https://github.com/aleftos/billbo * Summary: Utilities for the national tax billing system of Bolivian country. * Description: * * 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 17 * yyyyMMddHHmmssSSS * * SUCURSAL (de donde se emite la factura) 0 = Casa Matriz Numérico 4 * 1 = Sucursal 1 * 2 = Sucursal 2 * N = Sucursal N * * MODALIDAD 1 = Electrónica Numérico 1 * 2 = Computarizada * 3 = Manual * * TIPO EMISIÓN 1 = Online Numérico 1 * 2 = Offline * * CÓDIGO DOCUMENTO FISCAL 1 = Factura Numérico 1 * 2 = Nota Debito/Crédito * 3 = Nota Fiscal * 4 = Documento Equivalente * * TIPO DOCUMENTO SECTOR 1 = FACTURA ESTANDAR Numérico 2 * 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 * * NRO FACTURA Numero de Factura Numérico 8 * * PUNTO DE VENTA (POS) Número de punto de venta Numérico 4 * 0 = No corresponde * 1,2,3,4,….n * * 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: * 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 * * 1. 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 * * 2. Se concatena los campos: * * 000012345678920190113163721231000011101000000010000 * * 3. Se obtiene el módulo 11 de la cadena y se lo adjunta al final de la cadena * * 0000123456789201901131637212310000111010000000100003 * * 4. Se aplica a la cadena resultante Base 16 * * 159FFE6FB1986A24BB32DBE5A2A34214B245A6A3 */ import * as tocuf from './toCUF'; // Typescript BigInt patch export interface BillData { NIT_EMISOR: string | number, NÚMERO_FACTURA: string | number, FECHA_HORA?: string | number, // default = getTime SUCURSAL?: string | number, // default = CASA MATRÍZ MODALIDAD?: string | number, // default = ELECTRÓNICA TIPO_EMISIÓN?: string | number, // default = ONLINE CÓDIGO_DOCUMENTO_FISCAL?: string | number, // default = FACTURA TIPO_DOCUMENTO_SECTOR?: string | number, // default = FACTURA ESTÁNDAR POS?: string | number, // default = NO CORRESPONDE CUF?: string // to return } export class CUFind { lengths = [13, 8, 17, 4, 1, 1, 1, 2, 4]; billData: BillData; cuf: string; constructor( data: BillData ) { if (data) { this.billData = { NIT_EMISOR: data.NIT_EMISOR, NÚMERO_FACTURA: data.NÚMERO_FACTURA, FECHA_HORA: data.FECHA_HORA || new CUFTime().getCUFTime(), SUCURSAL: data.SUCURSAL || '0', MODALIDAD: data.MODALIDAD || '1', TIPO_EMISIÓN: data.TIPO_EMISIÓN || '1', CÓDIGO_DOCUMENTO_FISCAL: data.CÓDIGO_DOCUMENTO_FISCAL || '1', TIPO_DOCUMENTO_SECTOR: data.TIPO_DOCUMENTO_SECTOR || '1', POS: data.POS || '0' } let i = 0; for (const prop in this.billData) { let st = this.validate(this.billData[prop], this.lengths[i]); i++; if (st.ok === true) this.billData[prop] = st.f; else try { throw new TypeError("Malformed arguments to CUF constructor"); } catch (error) { this.billData.CUF = 'ERROR: Malformed arguments to CUF constructor: ' + prop + ': ' + this.billData[prop]; return; } } this.billData.CUF = this.calCUF(); } else { try { throw new TypeError("Unxpected arguments to CUF constructor"); } catch (error) { this.billData.CUF = 'ERROR: Unxpected arguments to CUF constructor: ' + 'NIT_EMISOR or NÚMERO_FACTURA is missing'; } } } /* * Get CUF from object bill data */ getCUF() { this.billData.CUF = this.calCUF(); return this.billData; } /* * Function: fill * Description: Left filled with character '0' if field length is less length. * Arguments: * f: field to fill * l: reference length * Return: * String filled */ fill (f: string, l: number) { let d = l - f.length; if (d !== 0) for (let i = 0; i < d; i++) f = '0' + f; return f; } /* * Function: Validate * Description: Check if field is Number and proper length. * Return: Object adding validated field. */ validate(f: string, l: number) { if (f.constructor === Number) { let fo = f.toString(); if (fo.length <= l) return { f: fo, ok: true } } else if (f.constructor === String) { if (/^\+?[0-9][\d]*$/.test(f) === true && f.length <= l) return { f: f, ok: true } else return { ok: false }; } else return { ok: false }; } /* * Function: mod11 * Description: Bolivian "Impuestos Nacionales" module 11 algorithm. * Return: String with module 11 code. */ mod11(toMod11: string, numDig = 1, limMult = 9, ten = false) { let mult: number, add:number, i:number, n: number, dig: number; if (!ten) numDig = 1; for (n = 1; n <= numDig; n++) { add = 0; mult = 2; for (i = toMod11.length - 1; i >= 0; i--) { add += (mult * parseInt(toMod11.substring(i, i + 1))); if (++mult > limMult) mult = 2; } if (ten) { dig = ((add * 10) % 11) % 10; } else { dig = add % 11; } if (ten) { dig = ((add * 10) % 11) % 10; } else { dig = add % 11; } if (dig == 10) { toMod11 += '1'; } if (dig == 11) { toMod11 += '0'; } if (dig < 10) { toMod11 += dig.toString(); } } return toMod11.substring(toMod11.length - numDig, toMod11.length); } /* * Function: calCUF * Description: Bolivian "Impuestos Nacionales" CUF (Código Único de Factura) calculation. */ calCUF() { this.cuf = this.fill(this.billData.NIT_EMISOR.toString(), 13) + this.billData.FECHA_HORA + this.fill(this.billData.SUCURSAL.toString(), 4) + this.billData.MODALIDAD + this.billData.TIPO_EMISIÓN + this.billData.CÓDIGO_DOCUMENTO_FISCAL + this.fill(this.billData.TIPO_DOCUMENTO_SECTOR.toString(), 2) + this.fill(this.billData.NÚMERO_FACTURA.toString(), 8) + this.fill(this.billData.POS.toString(), 4); return tocuf.toCUF(this.cuf + this.mod11(this.cuf)); } } export class CUFTime { constructor() { } /* * Function: CUFTime * Description: Bolivian "Impuestos Nacionales" CUF (Código Único de Factura) calculation. * Return: Return current date in required format. */ getCUFTime() { let dt = new Date(); let current_date = dt.getDate().toString(); let current_month = (dt.getMonth() + 1).toString(); let current_year = dt.getFullYear().toString(); let current_hrs = dt.getHours().toString(); let current_mins = dt.getMinutes().toString(); let current_secs = dt.getSeconds().toString(); let current_milliseconds = dt.getMilliseconds().toString(); // * Fill to left current_date = +current_date < 10 ? '0' + current_date : current_date; current_month = +current_month < 10 ? '0' + current_month : current_month; current_hrs = +current_hrs < 10 ? '0' + current_hrs : current_hrs; current_mins = +current_mins < 10 ? '0' + current_mins : current_mins; current_secs = +current_secs < 10 ? '0' + current_secs : current_secs; current_milliseconds = current_milliseconds === '0' ? '000' : +current_milliseconds < 10 ? '00' + current_milliseconds : +current_milliseconds < 100 ? '0' + current_milliseconds : current_milliseconds; // * Concat in required way let current_datetime = current_year + current_month + current_date + current_hrs + current_mins + current_secs + current_milliseconds; return current_datetime; } }