@nomada-sh/mx-invoice-tax-calculation
TypeScript icon, indicating that this package has built-in type declarations

1.0.13 • Public • Published

Tax calculation for méxico

These functions help you to obtain the tax calculation for an invoice in mexico. You can get the calculation for vat tranferred and witheld, isr and ieps.

Install package

Install package

$ npm install @nomada-sh/mx-invoice-tax-calculation

or

$ yarn add @nomada-sh/mx-invoice-tax-calculation

How use this package

To use the calculation functions you need to know the structure of a concept, below you can see the interface of a concept

Concept interface

export interface IConcept {
    valorUnitario:            number;
    descuento:                number;
    porcDescuento:            number;
    descripcion:              string;
    cantidad:                 number;
    key:                      string;
    impuestos:                {traslados: ITax[], retenciones: ITax[]};
}

Tax interface

export interface ITax {
    tipoImpuesto         : 'traslado' | 'retencion';
    impuesto             : '001' | '002' | '003':
    nombreImpuesto       : 'IEPS' | 'IVA' | 'ISR';
    valorTasaOcuota      : number;
    valorTasaOcuotaPorc  : number;
    rangoFijo            : string;
    tipoFactor           : string;
    key                  : string;
};
  • 001 -> IEPS.
  • 002 -> IVA.
  • 003 -> ISR.
  • Key -> it's basically a uuid.

Import the functions into project

import { calcMannyConcepts, calculateConceptTax } from '@nomada-sh/mx-invoice-tax-calculation';
import { IConcept } from '@nomada-sh/mx-invoice-tax-calculation/dist/interfaces';
const conceptExample: IConcept = {
  key: '58efbeb4-0b7c-45b4-84e4-9588d3f47dc9',
  descripcion: 'concept1',
  cantidad: 6,
  valorUnitario: 55,
  descuento: 0,
  porcDescuento: 0,
  impuestos: {
    traslados: [
      {
        key: '1c1011aa-040f-496a-b170-0224cd632d53',
        tasaOcuota: '',
        valorTasaOcuota: 0.16,
        valorTasaOcuotaPorc: 16,
        impuesto: '002',
        nombreImpuesto: 'IVA',
        tipoImpuesto: 'traslado',
        rangoFijo: 'Fijo',
        tipoFactor: 'Tasa',
      },
      {
        tipoImpuesto: 'traslado',
        impuesto: '003',
        nombreImpuesto: 'IEPS',
        tasaOcuota: 'f27c5a1c-f445-473d-8727-5feb94a3cca1',
        valorTasaOcuota: 0.30,
        valorTasaOcuotaPorc: 30,
        importeImpuesto: '0.00',
        rangoFijo: 'Fijo',
        tipoFactor: 'Tasa',
        key: 'c2e20350-003c-4326-aabd-5f9c8d3e1121',
      },
    ],
    retenciones: [],
  },
};

Run the functions to get the calculations

calcMannyConcepts

Allows to calculate multiple concepts

const calculatedTaxes = calcMannyConcepts([conceptExample, conceptExample]);
console.log(calculatedTaxes);

calcMannyconcepts's answer

{
    "amount": 660,
    "discount": {
        "value": 0,
        "data": []
    },
    "ivaTransferred": {
        "value": 137.28,
        "data": [
            {
                "value": 68.64,
                "porcentage": 16,
                "desc": "concept1",
                "key": "58efbeb4-0b7c-45b4-84e4-9588d3f47dc9"
            },
            {
                "value": 68.64,
                "porcentage": 16,
                "desc": "concept1",
                "key": "58efbeb4-0b7c-45b4-84e4-9588d3f47dc9"
            }
        ]
    },
    "ivaWitheld": {
        "value": 0,
        "data": []
    },
    "ieps": {
        "value": 198,
        "data": [
            {
                "value": 99,
                "porcentage": 30,
                "desc": "concept1",
                "key": "58efbeb4-0b7c-45b4-84e4-9588d3f47dc9"
            },
            {
                "value": 99,
                "porcentage": 30,
                "desc": "concept1",
                "key": "58efbeb4-0b7c-45b4-84e4-9588d3f47dc9"
            }
        ]
    },
    "isr": {
        "value": 0,
        "data": []
    },
    "subtotal": 660,
    "total": 995.28
}

calculateConceptTax

allows to calculate only one concept

const calculatedTaxes= calculateConceptTax(conceptExample);
console.log(calculatedTaxes);

calculateConceptTax's answer

{
    "key": "58efbeb4-0b7c-45b4-84e4-9588d3f47dc9",
    "description": "concept1",
    "amount": 330,
    "discount": 0,
    "porcDescuento": 0,
    "subTotal": 330,
    "iepsT": {
        "type": "transferred",
        "percentage": 30,
        "valuePercentage": 0.3,
        "factorType": "Tasa",
        "taxName": "IEPS",
        "iepsValue": 99
    },
    "ivaT": {
        "type": "transferred",
        "percentage": 16,
        "valuePercentage": 0.16,
        "taxName": "IVA",
        "ivaValue": 68.64
    },
    "total": 497.64
}

Readme

Keywords

Package Sidebar

Install

npm i @nomada-sh/mx-invoice-tax-calculation

Weekly Downloads

0

Version

1.0.13

License

ISC

Unpacked Size

28.2 kB

Total Files

8

Last publish

Collaborators

  • devmanny
  • manny-nomada