deividy/frete

Consumo da API de calculo de frete, preços e prazos do correio. http://ws.correios.com.br/calculador/CalcPrecoPrazo.asmx

Frete

---

Modulo para consumo da API dos correios de calculo remoto de precos e prazos:

• http://ws.correios.com.br/calculador/CalcPrecoPrazo.asmx
• https://www.correios.com.br/atendimento/ferramentas/sistemas/arquivos/manual-de-implementacao-do-calculo-remoto-de-precos-e-prazos/view

Implementação de todos os metodos disponiveis na API, com acessores simples e fáceis. :)

Para ganharmos um pouco de performance, usamos o wsdl salvo no folder ./correios-data/CalcPrecoPrazo.xml, ao invés de fazermos o request inicial para isso.

Também mantemos uma lista de todos os serviços disponíveis pelos correio em ./correios-data/listaServicos.json, você pode atualizar essa lista juntamente com as definiçōes de TypeScript rodando o arquivo ./scripts/dump-services.js

Todas as opções do wsdl estao disponíveis via os mesmos comandos, e os metodos estão disponíveis nos mesmos nomes mas em camelCase e sem o prefixo Calc, (e.g. .precoPrazo()).

Para maiores detalhes de usage, você pode checar os nossos tests em frete.spec.js

Exemplos

Calculo simples de prazo usando promises:

const frete = require('frete');

(async function() {
    const results = await frete()
        .cepOrigem('13467460')
        .servico(frete.servicos.sedex)
        .prazo('13466321');

        console.log(results);
})();

Calculo simples de prazo:

const frete = require('frete');

frete()
    .cepOrigem('13467460')
    .servico(frete.servicos.sedex)
    .prazo('13466321', function (err, results) {
        console.log(err);
        console.log(results);
    })

Calculo simples de preco:

const frete = require('frete');

frete()
    .cepOrigem('13467460')
    .peso(1)
    .formato(frete.formatos.caixaPacote)
    .comprimento(16)
    .altura(2)
    .largura(11)
    .diametro(1)
    .maoPropria(frete.maoPropria.nao)
    .valorDeclarado(50)
    .avisoRecebimento(frete.avisoRecebimento.sim)
    .servico(frete.servicos.sedex)
    .preco('13466321', function (err, results) {
        console.log(err);
        console.log(results);
    });

Calculo simples de preco e prazo:

const frete = require('frete');

frete()
    .cepOrigem('13467460')
    .peso(1)
    .formato(frete.formatos.caixaPacote)
    .comprimento(16)
    .altura(2)
    .largura(11)
    .diametro(1)
    .maoPropria(frete.maoPropria.nao)
    .valorDeclarado(50)
    .avisoRecebimento(frete.avisoRecebimento.sim)
    .servico(frete.servicos.sedex)
    .precoPrazo('13466321', function (err, results) {
        console.log(err);
        console.log(results);
    });

Default options:

const frete = require('frete');
frete.cepOrigem('13467460').servico([ frete.servicos.sedex, frete.servicos.pac ]);

frete().prazo('13466321', function (err, results) {
    console.log(err);
    console.log(results);

    frete().prazo('13466321', function (err, results) {
        console.log(err);
        console.log(results);
    });
});

Objeto as config / More usages

const frete = require('frete');
frete.cepOrigem('13467460').servico([ frete.servicos.sedex, frete.servicos.pac ]);

frete({
    cepDestino: '13466321',
    peso: 1,
    formato: frete.formatos.caixaPacote,
    comprimento: 16,
    altura: 2,
    largura: 11,
    diametro: 1,
    maoPropria: frete.maoPropria.nao,
    valorDeclarado: 50,
    avisoRecebimento: frete.avisoRecebimento.sim
}).prazo(function(err, result) {
    console.log(err);
    console.log(result);
});

Utilities

const frete = require('frete');

console.log(frete.servicos.list);
console.log(frete.servicos.search('sedex'));
console.log(frete.servicos.byCode[81876]);

---

Dependency

• argument-validator
• node-soap

frete's Issues

Resource request: Typescript typing

It would be a very interesting feature, in the future I can make a pull request. :D

Como armazenar o responseJSON?

Fiquei na dúvida como pegar o retorno do responseJSON do resultado. É assíncrono?

frete() retorna uma promise?

Erro - Mudança Webservices Correios

Primeiramente, ótima lib! Mas estou com um problema :/

Tinha uma função Lambida rodando na AWS usando somente a lib, e estava funcionando a um bom tempo, aparentemente a dois dias atrás ela parou de funcionar e estou tomando esse erro

"message": "Erro ao calcular o frete",\n "error": "connect ECONNREFUSED 201.48.198.97:80"

Aparentemente o correio mudou a API deles, mas não tenho certeza.

Cubagem

Faz o cálculo de cubagem também?
Tipo, como eu faria para chamar esses métodos para um carrinho de compras com vários itens de diferentes tamanhos e peso?

Porque não passar os parametros em um dicionário

Olá, estou desenvolvendo um package para reaction commerce (em meteor) e seu modulo esta sendo muito util =)

Uma dúvida, porque não ao invés de passar os parametros desta forma atual

frete()
    .cepOrigem('13467460')
    .peso(1)
    .formato(1)
    .comprimento(16)
    .altura(2)
    .largura(11)
    .diametro(1)
    .maoPropria('N')
    .valorDeclarado(50)
    .avisoRecebimento('S')
    .servico(frete.codigos.sedex)
    .preco('13466321', function (err, results) {
        console.log(err);
        console.log(results);
    });

não passar na forma de um objeto

frete({
    cepOrigem: '13467460',
    peso: 1,
    formato: 1
}).preco(function(er, res){

})

Digo isso porque tive alguns problemas para integrar esta função com alguns métodos, como o Meteor.wrapAsync. Além disso acho que ficaria mais legível e intuitivo.

Parabens pelo módulo =)

TypeScript

Missing type declarations (.d.ts)

Declaração de tipos do Typescript não está funcionando

Estou começando a usar essa package no meu projeto mas percebi que os tipos não estão pegando, ele não me fala quais parâmetros passar e etc.