ebay purchase report

relatório de compra do ebay

Uma extensão da Web que gera um relatório compacto do histórico de compras do eBay

O histórico de compras do eBay não parece amigável quando você tem toneladas de compras e está interessado em ver uma lista compacta e agrupada do que você comprou, quanto custou, quantas foram enviadas ou não, etc. gerado percorrendo o DOM da página e coletando essas informações e, eventualmente, imprimindo um relatório no console do navegador.

Este projeto fornece uma extensão Firefox | Chrome | Opera Web (complemento) que auxilia na geração de tal relatório. O relatório é gerado em uma nova aba como um documento HTML.

Requisitos

Testado em Linux com Firefox 45+, Chrome 55+, Opera 36+. Deve funcionar também em Windows ou MacOS. Não construído/testado no Microsoft Edge, Android ou iPhone, mas quem sabe, pode funcionar :-)

Permissões do complemento

Algumas funções deste complemento usam certas APIs, portanto, exigiriam certas permissões para instalação. Abaixo está uma lista dessas permissões e o motivo delas:

• acesse seus dados em .ebay.com/

• bem, este é óbvio, não é?

• baixar arquivos e ler e modificar o histórico de download do navegador

• na verdade, estamos usando apenas a função de download para garantir que você possa exportar os dados do relatório para um formato CSV | JSON | XML e, mesmo assim, fazer o download

• acessar as guias do navegador:

• como o relatório é carregado em uma nova guia, é necessário acessar as guias. Além disso, para abrir a página de detalhes do item também seria necessária essa permissão.

Normalmente você não se preocupa com isso quando instala um complemento, não é? Caso você saiba agora :-)

Instale o complemento

A maneira user :

• para navegadores Firefox, use o botão Adicionar ao Firefox da Mozilla.
• para o Chrome, use o botão ADICIONAR AO CHROME do Google.

Se você deseja instalar/testar uma determinada versão, vá para a pasta dist e baixe e instale a versão certa para você:

1. Baixe o arquivo complementar .zip da pasta dist.
2. Abra seu navegador Ferramentas -> Extension | Menu Add-ons
   • No Firefox, no canto superior direito (perto da entrada Search add-on ), há um botão suspenso tools . Clique nesse botão e escolha Install Add-on From File . Escolha o arquivo baixado na etapa (1)
   • No Chrome | Opera, basta arrastar e soltar o arquivo .zip baixado em (1) na lista Extension . Ele irá sugerir automaticamente que você Drop to install

A maneira developer :

• revise o código-fonte, construa o pacote você mesmo e continue lendo How to use it .

Como usar

1. Abra a página do eBay e faça login usando sua conta do eBay
2. Vá para o menu Meu eBay -> Purchase history
3. Quando a página carregar, você notará um botão dourado Quick Report na caixa de grupo Pedidos:
4. Clique no botão Quick Report . Uma nova guia será aberta contendo um relatório HTML compacto do seu histórico de compras no eBay:

Observe que o relatório incluirá apenas itens visíveis. Por exemplo, se você optar por ver apenas 25 Orders per page , o relatório incluirá apenas esses pedidos. Para incluir todo o histórico, certifique-se de escolher a maior opção Orders per page disponível (por exemplo, 100).

Colunas mostradas

Por padrão, o relatório incluiria as seguintes colunas:

• # : o índice da linha do relatório
• Vendedor: o ID do vendedor do eBay
• Data de compra: as informações Order date no eBay
• Preço do item: o valor Item price no eBay
• Quantidade: a quantidade do eBay para o item
• Status de envio: o status de envio do item do pedido do eBay
• Entrega estimada: o item do pedido do eBay Data Estimated delivery , se disponível
• Descrição do item: a descrição do item do pedido do eBay, conforme mostrado no histórico de compras

Por padrão, o relatório geraria um subtotal de rodapé de grupo para cada valor de data/moeda. Este rodapé do grupo mostra a contagem de itens dentro do grupo, seu valor total, quantos foram enviados/não enviados e o preço médio por item. O relatório imprimirá também um total geral para todo o relatório.

A partir da versão 1.0.7, ele também mostrará a imagem em miniatura do item enquanto move o mouse sobre o item :-)

Ordenação de classificação

O relatório é gerado por padrão utilizando a ordem natural dos itens adquiridos. Se você deseja classificar o relatório por uma determinada coluna, clique no ícone de seta mostrado próximo ao nome da coluna. Funciona tanto ascendente quanto descendente.

Exportar dados

O relatório permite exportar seu conjunto de dados para formato JSON e XML delimitado por tabulações. Basta usar o link mostrado no documento do relatório.

Emptor de Advertência

1. Devido ao fato de o complemento repetir os itens do pedido exibidos no momento, o relatório incluirá exatamente os itens que você vê na página atual eBay Purchase History .
2. Se você quiser abrir a página de detalhes de um item, basta clicar no item. O add-on simulará o clique do respectivo item na página de histórico de compras do eBay.
3. Ao interagir com o relatório (classificação, abertura de detalhes do item, etc.), certifique-se de não fechar a guia/página do histórico de compras do eBay, caso contrário, uma mensagem de erro será mostrada.

Para desenvolvedores

Se você deseja fazer um fork deste projeto, então você pode estar interessado em construir automaticamente os pacotes .zip|.crx|.xpi, certo? Ok, a maneira mais simples de fazer isso é através da ferramenta de linha de comando web-ext do Mozilla ou, no caso do Chrome|Opera, através da ferramenta de linha de comando crxmake do Chrome.

Os comandos de construção podem ser encapsulados em um script Bourne Shell (que normalmente funcionaria em sistemas do tipo Unix):

 #! /bin/bash

EXT_NAME=ebay_purchase_report_history
EXT_PATH= ${0 %/* } # ;-)
EXT_SRC= $EXT_PATH /src/extension
EXT_DIST= $EXT_PATH /dist
EXT_VER= $( cat $EXT_SRC /manifest.json | grep ' "version" ' | grep -Eow " [0-9.]+ " )

web-ext -s $EXT_SRC -a $EXT_DIST --api-key= < your-addons.mozilla.org-api-key > --api-secret= < your-addons.mozilla.org-api-secret > --id= < your-addons.mozilla.org-api-UUID > sign

crxmake --pack-extension= $EXT_SRC --extension-output= $EXT_DIST / $EXT_NAME - $EXT_VER .crx --key-output= $EXT_DIST / $EXT_NAME - $EXT_VER .pem

Observe que no caso do Firefox você deve:

1. gere sua chave de API Mozilla (veja --api-key e --api-secret )
2. envie manualmente apenas uma vez seu complemento bifurcado para os complementos da Mozilla, também conhecidos como AMO, pegue o UUID do complemento recém-gerado e use-o no script acima.

Leia mais no AMO e/ou no Google.

Documentação

Os arquivos fonte JavaScript são anotados de acordo com a especificação JSDoc e, portanto, a documentação fonte pode ser produzida dinamicamente usando a ferramenta {@link http://usejsdoc.org/|JSDoc}.

Para gerar a documentação JSDoc você deve seguir os passos abaixo. Caso queira usar o template padrão JSDoc pule a etapa (1) abaixo.

1. instale seu JSDoc preferido {@link http://bfy.tw/ABvL|template} (por exemplo, npm install {@link https://www.npmjs.com/package/interledger-jsdoc-template|minami} )

• certifique-se de atualizar a propriedade opts.template com o caminho para o modelo JSDoc instalado no arquivo conf.json do projeto

2. execute o seguinte comando no terminal: jsdoc -c path-to-conf.json

• isso criará uma pasta jsdoc que conterá a documentação JSDoc gerada automaticamente para os arquivos de origem JavaScript

O que vem a seguir

1. Faça com que funcione também para Unpaid items , Canceled items , Canceled invoices e listas de histórico de compras Returns and canceled orders .