1.0.3 • Published 4 years ago

nuvemshop v1.0.3

Weekly downloads
1
License
ISC
Repository
github
Last release
4 years ago

Funções úteis para facilitar a chamada de métodos de requisição HTTP para API da plataforma NuvemShop

Como usar ?

npm i nuvemshop

Setando um cliente a partir de um objeto.

const nuvemshop = require("nuvemshop");
//
nuvemshop.config({
        store_id: "Id da loja",
        access_token: "Token de acesso",
        user_agent: "Usuário de acesso"
    });

Funções:

  • getStore(): Essa função retorna um vetor(array) com todas as informações cadastrais referentes a loja/empresa.

  • listCustomers(): Essa função retorna um vetor(array) com todos os clientes para uma determinada loja.

  • getCustomer(customer_id): Essa função retorna um único objeto de um cliente contendo todas as sus informações cadastrais, passando-se o seu "id".

  • listCategories(): Essa função retorna um vetor(array) com todas as categorias cadastradas na loja.

  • getCategory(category_id): Essa função retorna um único objeto de uma categoria contendo sus informações cadastrais, passando-se o seu "id".

  • listProducts(): Essa função retorna um vetor(array) com todos os produtos cadastrados na loja.

  • getProduct(product_id): Essa função retorna um único objeto de um produto cadastrado na loja, passando-se o seu "id".

  • getProductVariants(product_id): Essa função retorna um vetor(array) de todas as variantes de um determinado produto, por meio do "id" do produto.

  • getProductVariantsById(product_id, variant_id): Essa função seleciona uma única variação para um determinado produto.

  • getProductImages(product_id): Essa função retorna um vetor(array) com todas as imagens correspondentes a um determinado produto.

  • listOrders: Essa função retorna um vetor(array) com todas as ordens de pedidos realizados para uma determinada loja.

  • getOrder: Essa função retorna um único objeto de uma order contendo sus informações cadastrais, passando-se o seu "id".

Filtros:

Lista com parâmetros de filtro para as funções de listagem de entidade:

listStore

ParâmetroExplicação
fieldsLista de campos separados por vírgula a serem incluídos na resposta

listCustomers

ParâmetroExplicação
since_idRestringir resultados para após o ID especificado
created_at_minMostrar clientes criados após a data (ISO 8601 format)
created_at_maxMostrar clientes criados antes da data (ISO 8601 format)
updated_at_minMostrar a última atualização dos clientes após a data (ISO 8601 format)
updated_at_maxMostrar a última atualização dos clientes antes da data (ISO 8601 format)
pagePágina a mostrar
per_pageQuantidade de resultados
fieldsLista de campos separados por vírgula a serem incluídos na resposta
qPesquisar clientes que contenham o texto fornecido em seu nome, email ou identificação

listCategories

ParâmetroExplicação
since_idRestringir resultados para após o ID especificado
languageEspecifique o idioma de pesquisa
handleMostrar categorias com um determinado URL
parent_idMostrar categorias com uma determinada categoria pai
created_at_minMostrar categorias criados após a data (ISO 8601 format)
created_at_maxMostrar categorias criados antes da data (ISO 8601 format)
updated_at_minMostrar a última atualização das categorias após a data (ISO 8601 format)
updated_at_maxMostrar a última atualização das categorias antes da data (ISO 8601 format)
pagePágina a mostrar
per_pageQuantidade de resultados
fieldsLista de campos separados por vírgula a serem incluídos na resposta

listProducts

ParâmetroExplicação
since_idRestringir resultados para após o ID especificado
languageEspecifique o idioma de pesquisa
qPesquisar produtos que contenham o texto fornecido em seu nome, descrição ou SKU
handleMostrar produtos com um determinado URL
category_idMostrar produtos com uma determinada categoria
publishedMostrar produtos por status publicado. Os valores válidos são "true" ou "false"
free_shippingMostrar produtos pelo status free_shipping. Os valores válidos são "true" ou "false"
created_at_minMostrar produtos criados após a data (ISO 8601 format)
created_at_maxMostrar produtos criados antes da data (ISO 8601 format)
updated_at_minMostrar produtos atualizados pela última vez após a data (ISO 8601 format)
updated_at_maxMostrar produtos atualizados pela última vez antes da data (ISO 8601 format)
sort_byClassificar produtos por um critério específico (I.E.: sort_by=created-at-ascending)
pagePágina a mostrar
per_pageQuantidade de resultados
fieldsLista de campos separados por vírgula a serem incluídos na resposta

Critérios de ordenaçãoExplicação
userClassificação definida manualmente pelo usuário
price-ascending, cost-ascendingClassificar por preço ascendente
price-descending, cost-descendingClassificar por preço decrescente
alpha-ascending, name-ascendingClassificar por Nome do produto ascendente
alpha-descending, name-descendingClassificar por nome do produto decrescente
created-at-ascendingClassificar por data de criação crescente
created-at-descendingClassificar por data de criação decrescente
best-sellingClassificar por número de produtos vendidos descendente

getProductVariants

ParâmetroExplicação
since_idRestringir resultados para após o ID especificado
created_at_minMostrar variantes do produto criadas após a data (ISO 8601 format)
created_at_maxMostrar variantes de produto criadas antes da data (ISO 8601 format)
updated_at_minMostrar variantes do produto atualizadas após a data (ISO 8601 format)
updated_at_maxMostrar variantes do produto atualizadas pela última vez antes da data (ISO 8601 format)
pagePágina a mostrar
per_pageQuantidade de resultados
fieldsLista de campos separados por vírgula a serem incluídos na respost

getProductImages

ParâmetroExplicação
since_idRestringir resultados para após o ID especificado
srcMostrar imagens do produto com um determinado URL
positionMostrar imagens do produto em uma determinada posição
pagePágina a mostrar
per_pageQuantidade de resultados
fieldsLista de campos separados por vírgula a serem incluídos na resposta

listOrders

ParâmetroExplicação
since_idRestringir resultados para após o ID especificado
statusMostrar pedidos com um determinado estado. "any" é o padrão
channelsRestrinja os resultados ao canal de vendas especificado. "any" é o padrão (significa pedidos de pos, api, loja etc.)
payment_statusMostrar pedidos com um determinado estado de pagamento. "any" é o padrão (significa pedidos autorizados, pendentes e pagos)
shipping_statusMostrar pedidos com um determinado estado de entrega. "any" é o padrão
created_at_minMostrar pedidos criados após a data (ISO 8601 format)
created_at_maxMostrar pedidos criados antes da data (ISO 8601 format)
updated_at_minÚltima atualização dos pedidos após a data do pedido (ISO 8601 format)
updated_at_maxÚltima atualização dos pedidos antes da data (ISO 8601 format)
total_minMostrar pedidos com valor total maior ou igual ao valor especificado
total_maxMostrar pedidos com valor total menor ou igual ao valor especificado
customer_idsRestrinja os resultados aos IDs de clientes especificados (separados por vírgula)
pagePágina a mostrar
per_pageQuantidade de resultados
fieldsLista de campos separados por vírgula a serem incluídos na resposta
qPesquisar pedidos pelo número especificado; ou contendo o texto fornecido no nome ou no email do cliente
app_idMostrar pedidos criados por um determinado aplicativo

Exemplos:

getStore

const nuvemshop = require("nuvemshop");
//
const app = async () => {
    nuvemshop.config({
        store_id: "Id da loja",
        access_token: "Token de acesso",
        user_agent: "Usuário de acesso"
    });
    //
    const loja = await nuvemshop.getStore();
    //Example passing filter on parameter
    const loja = await nuvemshop.getStore("fields=id,name");
    console.log(loja);
}
//
app();

listCustomers

const nuvemshop = require("nuvemshop");
//
const app = async () => {
    nuvemshop.config({
        store_id: "Id da loja",
        access_token: "Token de acesso",
        user_agent: "Usuário de acesso"
    });
    //
    const clientes = await nuvemshop.listCustomers();
    //Example passing filter on parameter
    const clientes = await nuvemshop.listCustomers("since_id=1000&fields=id,name");
    console.log(clientes);
}
//
app();

getCustomer

const nuvemshop = require("nuvemshop");
//
const app = async () => {
    nuvemshop.config({
        store_id: "Id da loja",
        access_token: "Token de acesso",
        user_agent: "Usuário de acesso"
    });
    //
    const id = "xxxxx";
    const cliente = await nuvemshop.getCostumer(id);
    console.log(cliente);
}
//
app();

listCategories

const nuvemshop = require("nuvemshop");
//
const app = async () => {
    nuvemshop.config({
        store_id: "Id da loja",
        access_token: "Token de acesso",
        user_agent: "Usuário de acesso"
    });
    //
    const categorias = await nuvemshop.listCategories();
    //Example passing filter on parameter
    const categorias = await nuvemshop.listCategories("since_id=1000&fields=id,name");
    console.log(categorias);
}
//
app();

getCategory

const nuvemshop = require("nuvemshop");
//
const app = async () => {
    nuvemshop.config({
        store_id: "Id da loja",
        access_token: "Token de acesso",
        user_agent: "Usuário de acesso"
    });
    //
    const id = "xxxxx";
    const categoria = await nuvemshop.getCategory(id);
    console.log(categoria);
}
//
app();

listProducts

const nuvemshop = require("nuvemshop");
//
const app = async () => {
    nuvemshop.config({
        store_id: "Id da loja",
        access_token: "Token de acesso",
        user_agent: "Usuário de acesso"
    });
    //
    const produtos = await nuvemshop.listProducts();
    //Example passing filter on parameter
    const produtos = await nuvemshop.listProducts("since_id=1000&fields=id,name");
    console.log(produtos);
}
//
app();

getProduct

const nuvemshop = require("nuvemshop");
//
const app = async () => {
    nuvemshop.config({
        store_id: "Id da loja",
        access_token: "Token de acesso",
        user_agent: "Usuário de acesso"
    });
    //
    const id = "xxxxx";
    const produto = await nuvemshop.getProduct(id);
    console.log(produto);
}
//
app();

getProductVariants

const nuvemshop = require("nuvemshop");
//
const app = async () => {
    nuvemshop.config({
        store_id: "Id da loja",
        access_token: "Token de acesso",
        user_agent: "Usuário de acesso"
    });
    //
    const id = "xxxxx";
    const variantes_produto = await nuvemshop.getProductVariants(id);
    //Example passing filter on parameter
    const variantes_produto = await nuvemshop.getProductVariants(id, "since_id=1000&fields=id,name");
    console.log(variantes_produto);
}
//
app();

getProductVariantsById

const nuvemshop = require("nuvemshop");
//
const app = async () => {
    nuvemshop.config({
        store_id: "Id da loja",
        access_token: "Token de acesso",
        user_agent: "Usuário de acesso"
    });
    //
    const produto_id = "xxxxx";
    const variante_id = "xxxxx";
    const variante_produto = await nuvemshop.getProductVariantsById(produto_id, variante_id);
    console.log(variante_produto);
}
//
app();

getProductImages

const nuvemshop = require("nuvemshop");
//
const app = async () => {
    nuvemshop.config({
        store_id: "Id da loja",
        access_token: "Token de acesso",
        user_agent: "Usuário de acesso"
    });
    //
    const id = "xxxxx";
    const produto_imagens = await nuvemshop.getProductImages(id);
    //Example passing filter on parameter
    const produto_imagens = await nuvemshop.getProductImages(id, "since_id=1000&fields=id,name");
    console.log(produto_imagens);
}
//
app();

listOrders

const nuvemshop = require("nuvemshop");
//
const app = async () => {
    nuvemshop.config({
        store_id: "Id da loja",
        access_token: "Token de acesso",
        user_agent: "Usuário de acesso"
    });
    //
    const pedidos = await nuvemshop.listOrders();
    //Example passing filter on parameter
    const pedidos = await nuvemshop.listOrders("since_id=1000&fields=id,name");
    console.log(pedidos);
}
//
app();

getOrder

const nuvemshop = require("nuvemshop");
//
const app = async () => {
    nuvemshop.config({
        store_id: "Id da loja",
        access_token: "Token de acesso",
        user_agent: "Usuário de acesso"
    });
    //
    const id = "xxxxx";
    const pedido = await nuvemshop.getOrder(id);
    console.log(pedido);
}
//
app();