sunat-catalogs v1.0.7

Instalación y uso

npm install --save sunat-catalogs

const Catalogs = require('sunat-catalogs');

Atributos Estáticos (Statics Attributes)

Todos los catálogos definidos en la sección "Definición de Catálogos", tendrán los siguientes atributos estáticos, los cuales nos permitiran acceder a los metadatos del catálogo.

const { TipoTributo } = require('sunat-catalogs');

console.log(TipoTributo.numeroCat); 
// Resultado: 05

console.log(TipoTributo.tituloCat); 
// Resultado: Código de tipos de tributos y otros conceptos

console.log(TipoTributo.nombreCat); 
// Resultado: Codigo de tributos

console.log(TipoTributo.agenciaCat); 
// Resultado: PE:SUNAT

console.log(TipoTributo.uriCat); 
// Resultado: urn:pe:gob:sunat:cpe:see:gem:catalogos:catalogo05

console.log(`Catálogo Nro. ${TipoTributo.numeroCat} - ${TipoTributo.tituloCat}`);
// Resultado: Catálogo Nro. 05 - Código de tipos de tributos y otros conceptos

IMPORTANTE:Los métodos estáticos se llaman sin crear instancias de su clase y tampoco son invocables cuando se instancia la clase.

Funciones

Todos los catálogos definidos en la sección "Definición de Catálogos", tendrán definida la funcióndescripcion()para acceder a la descripción de los códigos de los catálogos.Cada catálogo también cuenta con funciones propias.

const { TipoTributo } = require('sunat-catalogs');

const tributo = new TipoTributo(TipoTributo.ICBPER);

console.log(tributo.descripcion());
// Resultado: Impuesto al Consumo de las bolsas de plástico

console.log(tributo.nombre());
// Resultado: ICBPER

console.log(tributo.categoria());
// Resultado: S

console.log(tributo.codigo());
// Resultado: OTH

Definición de Catálogos

Catálogo Nro. 01 - Código de Tipo de Documento

Para este catálogo se ha definido la clase de nombre TipoDocumeto, la misma que cuenta con las siguientes funciones:

• descripcion()- Permite obtener la descripción del tipo de documento

const { TipoDocumento } = require('sunat-catalogs');

const documento = new TipoDocumento(TipoDocumento.FA);

console.log(documento.descripcion());
// Resultado: Factura

En la siguiente tabla se describen las constantes disponibles:

Catálogo Nro. 02 - Código de Tipo de Monedas

Para este catálogo se ha definido la clase de nombre TipoMoneda, la misma que cuenta con las siguientes funciones:

• descripcion()- Permite obtener la descripción del tipo de moneda

const { TipoMoneda } = require('sunat-catalogs');

const moneda = new TipoMoneda(TipoMoneda.SOL);

console.log(moneda.descripcion());
// Resultado: Sol

En la siguiente tabla se describen las constantes disponibles:

Catálogo Nro. 03 - Códigos de Tipo de Unidad de Medida

Para este catálogo se ha definido la clase de nombre TipoUnidadMedida, la misma que cuenta con las siguientes funciones:

• descripcion()- Permite obtener la descripción del tipo de unidad de medida

const { TipoUnidadMedida } = require('sunat-catalogs');

const medida = new TipoUnidadMedida(TipoUnidadMedida.UNIDAD_INTERNACIONAL);

console.log(medida.descripcion());
// Resultado: Número de unidades internacionales

En la siguiente tabla se describen las constantes disponibles:

Catálogo Nro. 04 - Código de País

Para este catálogo se ha definido la clase de nombre Pais, la misma que cuenta con las siguientes funciones:

• descripcion()- Permite obtener la descripción del país

const { Pais } = require('sunat-catalogs');

const pais = new Pais(Pais.PERU);

console.log(pais.descripcion());
// Resultado: Perú

En la siguiente tabla se describen las constantes disponibles:

Catálogo Nro. 05 - Código de Tipos de Tributos

Para este catálogo se ha definido la clase de nombre TipoTributo, la misma que cuenta con las siguientes funciones:

• descripcion()- Permite obtener la descripción del tipo de tributo
• nombre()- Permite obtener el nombre del tipo de tributo
• categoria()- Permite obtener la categoría del tipo de tributo
• codigo()- Permite obtener el código internacional del tipo de tributo

const { TipoTributo } = require('sunat-catalogs');

const tributo = new TipoTributo(TipoTributo.IGV);

console.log(tributo.descripcion());
// Resultado: IGV Impuesto General a las Ventas

console.log(tributo.nombre());
// Resultado: IGV

console.log(tributo.categoria());
// Resultado: S

console.log(tributo.codigo());
// Resultado: VAT

En la siguiente tabla se describen las constantes disponibles:

Catálogo Nro. 06 - Código de Tipo de Documento de Identidad

Para este catálogo se ha definido la clase de nombre TipoDocumentoIdentidad, la misma que cuenta con las siguientes funciones:

• descripcion()- Permite obtener la descripción del documento de identidad

const { TipoDocumentoIdentidad } = require('sunat-catalogs');

const documento = new TipoDocumentoIdentidad(TipoDocumentoIdentidad.DNI);

console.log(documento.descripcion());
// Resultado: Documento Nacional de Identidad

En la siguiente tabla se describen las constantes disponibles:

Catálogo Nro. 07 - Código de Tipo de Afectación del IGV

Para este catálogo se ha definido la clase de nombre TipoAfectacionIgv, la misma que cuenta con las siguientes funciones:

• descripcion()- Permite obtener la descripción del tipo de afectación
• codTributo(onerosa)- Permite obtener el código del tributo relacionado al tipo de afectación
  • onerosa- Definir como true si la operación es onerosa y false si la operación es gratuita

const { TipoAfectacionIgv } = require('sunat-catalogs');

const afectacion = new TipoAfectacionIgv(TipoAfectacionIgv.GRAVADO_IVAP);

console.log(afectacion.descripcion());
// Resultado: Gravado - IVAP

console.log(afectacion.codTributo(true));
// Resultado: 1016

console.log(afectacion.codTributo(false));
// Resultado: 9996

En la siguiente tabla se describen las constantes disponibles:

Catálogo Nro. 08 - Código de Tipos de Sistema de Cálculo del ISC

Para este catálogo se ha definido la clase de nombre TipoSistemaIsc, la misma que cuenta con las siguientes funciones:

• descripcion()- Permite obtener la descripción del tipo de sistema de cálculo

const { TipoSistemaIsc } = require('sunat-catalogs');

const documento = new TipoSistemaIsc(TipoSistemaIsc.SISTEMA_VALOR);

console.log(documento.descripcion());
// Resultado: Sistema al valor

En la siguiente tabla se describen las constantes disponibles:

Catálogo Nro. 09 - Códigos de Tipo de Nota de Crédito

Para este catálogo se ha definido la clase de nombre TipoNotaCredito, la misma que cuenta con las siguientes funciones:

• descripcion()- Permite obtener la descripción del tipo de nota de crédito

const { TipoNotaCredito } = require('sunat-catalogs');

const nc = new TipoNotaCredito(TipoNotaCredito.ANULACION_OPERACION);

console.log(nc.descripcion());
// Resultado: Anulación de la operación

En la siguiente tabla se describen las constantes disponibles:

Catálogo Nro. 10 - Códigos de Tipo de Nota de Débito

Para este catálogo se ha definido la clase de nombre TipoNotaDebito, la misma que cuenta con las siguientes funciones:

• descripcion()- Permite obtener la descripción del tipo de nota de débito

const { TipoNotaDebito } = require('sunat-catalogs');

const nd = new TipoNotaDebito(TipoNotaDebito.INTERESES_MORA);

console.log(nd.descripcion());
// Resultado: Intereses por mora

En la siguiente tabla se describen las constantes disponibles:

Catálogo Nro. 12 - Código de Documentos Relacionados

Para este catálogo se ha definido la clase de nombre DocumentoRelacionado, la misma que cuenta con las siguientes funciones:

• descripcion()- Permite obtener la descripción del documento relacionado

const { DocumentoRelacionado } = require('sunat-catalogs');

const documento = new DocumentoRelacionado(DocumentoRelacionado.FA_ANTICIPO);

console.log(documento.descripcion());
// Resultado: Factura - emitida por anticipos

En la siguiente tabla se describen las constantes disponibles:

Catálogo Nro. 16 - Código de Tipo de Precio de Venta (TipoPrecioVenta)

Para este catálogo se ha definido la clase de nombre DocumentoRelacionado, la misma que cuenta con las siguientes funciones:

• descripcion()- Permite obtener la descripción del documento relacionado

const { DocumentoRelacionado } = require('sunat-catalogs');

const documento = new DocumentoRelacionado(DocumentoRelacionado.FA_ANTICIPO);

console.log(documento.descripcion());
// Resultado: Factura - emitida por anticipos

En la siguiente tabla se describen las constantes disponibles:

Catálogo Nro. 19 - Código de Estado del Ítem

Para este catálogo se ha definido la clase de nombre EstadoItem, la misma que cuenta con las siguientes funciones:

• descripcion()- Permite obtener la descripción del estado de ítem

const { EstadoItem } = require('sunat-catalogs');

const estado = new EstadoItem(EstadoItem.ADICIONAR);

console.log(estado.descripcion());
// Resultado: Adicionar

En la siguiente tabla se describen las constantes disponibles:

Catálogo Nro. 22 - Código de Regimen de Percepciones

Para este catálogo se ha definido la clase de nombre RegimenPercepcion, la misma que cuenta con las siguientes funciones:

• descripcion()- Permite obtener la descripción de la percepción
• tasa()- Permite obtener la tasa de percepción

const { RegimenPercepcion } = require('sunat-catalogs');

const percepcion = new RegimenPercepcion(RegimenPercepcion.VENTA_INTERNA);

console.log(percepcion.descripcion());
// Resultado: Percepción venta interna

console.log(percepcion.tasa());
// Resultado: 2.00

En la siguiente tabla se describen las constantes disponibles:

Catálogo Nro. 23 - Código de Regimen de Retenciones

Para este catálogo se ha definido la clase de nombre RegimenRetencion, la misma que cuenta con las siguientes funciones:

• descripcion()- Permite obtener la descripción de la retención
• tasa()- Permite obtener la tasa de retención

const { RegimenRetencion } = require('sunat-catalogs');

const retencion = new RegimenRetencion(RegimenRetencion.TASA_3);

console.log(retencion.descripcion());
// Resultado: Tasa 3%

console.log(retencion.tasa());
// Resultado: 3.00

En la siguiente tabla se describen las constantes disponibles:

Catálogo Nro. 51 - Códigos de Tipo de Operación

Para este catálogo se ha definido la clase de nombre TipoOperacion, la misma que cuenta con las siguientes funciones:

• descripcion()- Permite obtener la descripción del tipo de operación

const { TipoOperacion } = require('sunat-catalogs');

const operacion = new TipoOperacion(TipoOperacion.VENTA_INTERNA);

console.log(operacion.descripcion());
// Resultado: Venta interna

En la siguiente tabla se describen las constantes disponibles:

Catálogo Nro. 53 - Códigos de Cargos o Descuentos

Para este catálogo se ha definido la clase de nombre CargoDescuento, la misma que cuenta con las siguientes funciones:

• descripcion()- Permite obtener la descripción del cargo o descuento
• indicador()- Permite saber si el código corresponde a un cargo (true) o un descuento (false)
• nivel()- Permite obtener el nivel relacionado al código (item o global)
• esCargoDet()- Determina si corresponde a un cargo por detalle (true o false)
• esDescuentoDet()- Determina si corresponde a un descuento por detalle (true o false)
• esCargoGlb()- Determina si corresponde a un cargo global (true o false)
• esDescuentoGlb()- Determina si corresponde a un descuento global (true o false)

const { CargoDescuento } = require('sunat-catalogs');

const operacion = new CargoDescuento(CargoDescuento.DCTOS_ITEM_AFECTA_BASE_IGV_IVAP);

console.log(operacion.descripcion());
// Resultado: Descuentos que afectan la base imponible del IGV/IVAP

En la siguiente tabla se describen las constantes disponibles: