node-api

Índice

• Informações gerais
• Dependências
• Gerador de CPF
• Validador de CPF
• Gerador de CNPJ
• Validador de CNPJ
• Cálculo de Financiamento PRICE
• Cálculo de Financiamento SAC
• Cálculo de Prestação
• Cálculo de Valor Futuro
• Cálculo de Valor Presente
• Setup

Informações Gerais

• Toda a biblioteca foi desenvolvida em Node.js com foco em cálculos financeiros
• Chamadas e saídas em formato JSON
• APIs para uso público

Dependências

• Node module: express

geraCPF

• Arquivo: geraCPF.js
• Gerador de CPFs válidos para uso em teste de aplicações
• URL: http://.../geraCPF
• Body => JSON

{ "authKey":"", "param": [#]} onde # é a quantidade de CPFs a serem gerados

• Method: GET
• Retorno:

{
    "statCode": "<status code>",
    "statMsg": "<status message>",
    "result": ["###########","###########"] onde ########### são CPFs gerados
}

• Os stat codes e messages podem ser vistos em include/std_messages_api.js

validaCPF

• Arquivo: validaCPF.js
• Verificador de número de CPF
• URL: http://.../validaCPF
• Body => JSON

{ "authKey":"", "param": ["###########","###########"]} onde ########### são CPFs a serem validados

• Method: GET ou POST
• Retorno:

{
    "statCode": "<status code>",
    "statMsg": "<status message>",
    "result": [#,#] onde # = 0 para CPF inválido e 1 para CPF válido 
}

• Os stat codes e messages podem ser vistos em include/std_messages_api.js

geraCNPJ

• Arquivo: geraCNPJ.js
• Gerador de CNPJs válidos para uso em teste de aplicações
• URL: http://.../geraCNPJ
• Body => JSON

{ "authKey":"", "param": [#]} onde # é a quantidade de CNPJs a serem gerados

• Method: GET
• Retorno:

{
    "statCode": "<status code>",
    "statMsg": "<status message>",
    "result": "result": ["###########","###########"] onde ########### são CNPJss gerados
}

• Os stat codes e messages podem ser vistos em include/std_messages_api.js

validaCNPJ

• Arquivo: validaCNPJ.js
• Validador de número de CNPJ
• URL: http://.../validaCNPJ
• Body => JSON

{ "authKey":"", "param": ["###########","###########"]} onde ########### são CNPJs a serem validados

• Method: GET ou POST
• Retorno:

{
    "statCode": "<status code>",
    "statMsg": "<status message>",
    "result": [#,#] onde # = 0 para CNPJ inválido e 1 para CNPJ válido 
}

• Os stat codes e messages podem ser vistos em include/std_messages_api.js

calculaPRICE

• Arquivo: calculaPRICE.js
• Calculo de financiamento por tabela PRICE - Sistema Frances de Amortizacao
• URL: http://.../calculaPRICE
• Body => JSON

 { "authKey":"", "param": [vl, i, n]} Ex.: { "authKey":"", "param": [1000, 1.5, 12]}

• onde vl = valor financiado / i = taxa de juros / n = numero de periodos
• Method: GET ou POST
• Retorno:

{
    "statCode": "<status code>",
    "statMsg": "<status message>",
    "result": [
        [
            ###,        Numero da parcela
            ###.##,     Vl. da Prestação
            ###.##,     Vl. da Amortização
            ###.##,     Vl dos Juros
            ###.##      Saldo devedor
        ],[...]
        ]
}

• Os stat codes e messages podem ser vistos em include/std_messages_api.js

calculaSAC

• Arquivo: calculaSAC.js
• Calculo de financiamento por tabela SAC
• URL: http://.../calculaSAC
• Body => JSON

{ "authKey":"", "param": [vl, i, n]} Ex.: { "authKey":"", "param": [1000, 1.5, 12]}

• onde vl = valor financiado / i = taxa de juros / n = numero de periodos
• Method: GET ou POST
• Retorno:

{
    "statCode": "<status code>",
    "statMsg": "<status message>",
    "result": [
        [
            ###,        Numero da parcela
            ###.##,     Vl. da Prestação
            ###.##,     Vl. da Amortização
            ###.##,     Vl dos Juros
            ###.##      Saldo devedor
        ],[...]
        ]
}

• Os stat codes e messages podem ser vistos em include/std_messages_api.js

calculaPAGTO

• Arquivo: calculaPAGTO.js
• Cálculo financeiro para valor de Prestação
• URL: http://.../calculaPAGTO
• Body => JSON

{ "authKey":"", "param": [vl, i, n]} Ex.: { "authKey":"", "param": [1000, 1.5, 12]}

• onde vl = valor financiado / i = taxa de juros / n = numero de periodos
• Method: GET ou POST
• Retorno:

{
    "statCode": "<status code>",
    "statMsg": "<status message>",
    "result": #####.## correspondente ao valor da prestação
}

• Os stat codes e messages podem ser vistos em include/std_messages_api.js

calculaVF

• Arquivo: calculaVF.js
• Cálculo financeiro para Valor Futuro
• URL: http://.../calculaVF
• Body => JSON

{ "authKey":"", "param": [vp, i, n]} Ex.: { "authKey":"", "param": [vp, i, n]}

• onde vp = valor presente / i = taxa de juros / n = numero de periodos
• Method: GET ou POST
• Retorno:

{
    "statCode": "<status code>",
    "statMsg": "<status message>",
    "result": ####.## correspondente ao valor futuro
}

• Os stat codes e messages podem ser vistos em include/std_messages_api.js

calculaVP

• Arquivo: calculaVP.js
• Cálculo financeiro para Valor Presente
• URL: http://.../calculaVP
• Body => JSON

{ "authKey":"", "param": [vf, i, n]} Ex.: { "authKey":"", "param": [vf, i, n]}

• onde vf = valor futuro / i = taxa de juros / n = numero de periodos
• Method: GET ou POST
• Retorno:

{
    "statCode": "<status code>",
    "statMsg": "<status message>",
    "result": ####.## correspondente ao valor presente
}

• Os stat codes e messages podem ser vistos em include/std_messages_api.js

Setup

• Basta copiar os arquivos para uma pasta e executar o node
• Por definição, o serviço é executado na porta 8080 do TCP/IP mas pode ser trocado pela edição do arquivo app.js na linha process.env.PORT

var port = process.env.PORT || 8080;