SISTEMA DE RASTREAMENTO
ON-LINE DE FARDOS BETTER
COTTON
MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS
BRASILEIRAS QUE USAM SAI
Maio de 2013
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
Índice
Introdução ao Sistema Better Cotton 2
Introdução ao Sistema de Rastreamento de Fardos (SRF) 3
Como o Sistema de Rastreamento de Fardos funciona? Visão Geral
Guia do usuário
7
Visão Geral
7
Login
5
7
Navegação
8
Como iniciar
9
Como fazer upload de um arquivo CSV
Seu upload de CSV funciona?
17
Recapitulação: o que você precisa fazer?
Anexo 1: Acrônimos
14
19
20
Anexo 2: Termos e Condições de Utilização do sistema de rastreamento on-line de fardos Better
Cotton
21
Anexo 3: Como fazer upload de um arquivo CSV por serviço web
BETTERCOTTON.ORG
23
1
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
Introdução ao Sistema Better Cotton
A Cadeia de Fornecimento do Better Cotton
A Better Cotton Initiative (BCI) existe para melhorar a produção de algodão para os produtores, o
meio em que é cultivado e o futuro do setor. Para atingir este objetivo, deve-se criar um mercado
para o algodão produzido de modo mais sustentável - Better Cotton. Better Cotton é o algodão que
foi avaliado como cultivado de acordo com os Critérios e Princípios de Produção BCI. Estes Critérios e
Princípios de Produção dão enfoque às atividades no âmbito da propriedade rural.1
A criação de um mercado para o Better Cotton requer um produto específico que pode ser
identificado como Better Cotton. Para a BCI este produto específico é um fardo contendo 100% de
Better Cotton. Assim, a BCI desenvolveu uma Cadeia de Fornecimento para Better Cotton que
descreve os requisitos compulsórios para produção de fardos de 100% Better Cotton.
A Cadeia de Fornecimento do Sistema Better Cotton foi concebida para permitir que o Better Cotton
cultivado esteja disponível para os varejistas interessados e consiste dos seguintes elementos que
dão enfoque ao segmento da propriedade rural ao beneficiador.
1. Segregação do Better Cotton do campo ao fardo — para garantir que os fardos descritos como
Better Cotton não contenham nenhum outro tipo de algodão.
2. Pesagem de algodão em caroço e fibra de algodão — para ajudar a informar à BCI a
quantidade de Better Cotton que está sendo cultivada.
3. Fardos 100% Better Cotton — para fornecer uma commodity comercializável.
4. Um identificador Better Cotton que permita a identificação dos fardos 100% Better Cotton —
pode ser físico, por exemplo, uma etiqueta; ou virtual, por exemplo via um banco de dados
que detalhe o status de cada fardo, ou ambos.
5. Cadeia de custódia documentada (da propriedade rural ao beneficiador) — para permitir a
identificação da origem do algodão em um fardo Better Cotton e fornecer um meio para
verificar a integridade da Cadeia de Fornecimento para Better Cotton.
Estas várias etapas foram descritas em um fluxo de processo, como descrito abaixo:
O enfoque da implementação da Cadeia de Fornecimento do Better Cotton é no movimento de
algodão em caroço da propriedade rural ao beneficiador, segregação do Better Cotton na
beneficiadora, e na criação de um fardo de fibra 100% Better Cotton.
A implementação do Sistema Better Cotton
A BCI trabalha com diversos Parceiros de Implementação em regiões foco da BCI (Brasil, Índia,
Paquistão, África Central e Ocidental). Estes Parceiros de Implementação realizam projetos para
implementar o Sistema Better Cotton. Cada Projeto BCI tem uma ou mais Unidades de Produtores.
Uma Unidade de Produtores contém vários Grupos de Aprendizagem e/ou Empregadores de
1
Vá a http://bettercotton.org/better-cotton/the-better-cotton-system/ para mais detalhes sobre o Sistema Better
Cotton, especialmente sobre o documento “Avaliação da Propriedade Rural” para mais informações sobre os
requisitos para o cultivo de Better Cotton.
BETTERCOTTON.ORG
2
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
Grandes Fazendas.
Agricultores que participem de projetos BCI são categorizados como Pequenos Agricultores ou
“Empregadores de Grandes Fazendas”. Pequenos Agricultores são organizados em “Grupos de
Aprendizagem” que proporcionam um ambiente de desenvolvimento de conhecimento em que os
agricultores podem se reunir, discutir e aprender sobre o cultivo de Better Cotton e é, para os
pequenos agricultores, um meio eficiente de coletar e comparar dados.
Todas as avaliações de propriedades rurais devem ser realizadas no âmbito do Grupo de
Aprendizagem ou Empregador de Grandes Fazendas2. A qualificação para vender Better Cotton é,
portanto, concedida no âmbito do Grupo de Aprendizagem ou Empregador de Grandes Fazendas.
Introdução ao Sistema de Rastreamento de Fardos (SRF)
Escopo e Intenção
A BCI desenvolveu um sistema on-line de rastreamento de fardos para garantir que os fardos
alegadamente de Better Cotton contenham, de fato, Better Cotton. O sistema rastreia o volume de
caroço de Better Cotton produzido e beneficiado, garantindo que corresponda ao volume de fibra
de Better Cotton sendo comercializado.
O sistema é operado pela UTZ Certified3, sendo o único endossado pela BCI. NB: O sistema de
rastreamento de fardo Better Cotton não é uma plataforma comercial. Nenhuma transação pode ser
realizada nele.
O sistema de rastreamento de fardo Better Cotton foi designado para complementar o Sistema
Abrapa de Identificação (SAI) já em uso no Brasil e evitar a duplicação na utilização de etiquetas. As
beneficiadoras podem administrar suas compras de algodão em caroço, inventário, produção e
vendas de fardos de Better Cotton, nos seus sistemas de gestão locais. Depois, podem descarregar
as informações necessárias a partir de seu sistema local para o arquivo CSV (arquivos com valores
separados por vírgula) no Sistema de Rastreamento de Fardos. A função de carregamento de CSV é
planejada somente para beneficiadoras que usam o SAI.
Usuários
O Sistema de Rastreamento de Fardos Better Cotton está sendo disponibilizado aos seguintes
usuários:
• membros BCI; e
• beneficiadoras comprometidas com a participação na Cadeia de Fornecimento de Better Cotton
em conformidade com os requisitos detalhados no preâmbulo.
Configuração do sistema e requisitos técnicos
Para acessar e usar o Sistema de Rastreamento de Fardos Better Cotton, um usuário precisa:
• um computador conectado à Internet
• um dos seguintes navegadores de internet instalados neste computador:
Internet Explorer 9.0 ou versão posterior
Mozilla Firefox 20 ou versão posterior
Nota importante
O Sistema de Rastreamento de Fardos Better Cotton será usado para rastrear APENAS Better Cotton.
Todas as referências a algodão, algodão em caroço, fibra de algodão neste documento devem ser
2
Para maiores informações sobre isto, consulte Mecanismo de Avaliação da Propriedade Rural BCI
(http://bettercotton.org/better-cotton/the-better-cotton-system/).
3
UTZ CERTIFIED oferece programas de sustentabilidade e rastreamento para café, cacau e chá. Com sua experiência
em rastreamento, oferece serviços para outros programas de sustentabilidade como a BCI.
BETTERCOTTON.ORG
3
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
interpretadas como Better Cotton.
Assistência
Se precisar de qualquer assistência na utilização do Sistema de Rastreamento de Fardos Better
Cotton, entre em contato com [email protected]
BETTERCOTTON.ORG
4
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
Como o Sistema de Rastreamento de Fardos funciona? Visão Geral
Licenciamento de Produtores (responsabilidade da BCI)
Quando um Empregador de Grandes Fazendas (EGF) tiver sido confirmado como cultivador de
Better Cotton, uma licença para vender um volume específico de algodão em caroço é criada pela
BCI no Sistema de Rastreamento de Fardo Better Cotton, e a Fazenda é identificada por um número
exclusivo (denominado ID do GP). Quando o GP vende seu caroço de algodão a uma beneficiadora,
deve informar o seu número de ID como fornecido pela BCI.
Criar o perfil da beneficiadora no Sistema de Rastreamento de Fardos (responsabilidade
da ABRAPA)
Para cada instalação de beneficiamento, a BCI insere as seguintes informações no Sistema de
Rastreamento de Fardos Better Cotton, com base em informações fornecidas pela beneficiadora ao
se registrar para a utilização do sistema de rastreamento Better Cotton:
• capacidade de processamento (isto é, fardos por dia);
• peso médio do fardo (em kg);
• razão de produção/conversão do beneficiador (de algodão em caroço à fibra de algodão).
• o número SAI, isto é, na etiqueta abaixo de Código de Extensão, Sede/Escritório e Identificação
de Beneficiador, Estado, Município e País.
Cada instalação de beneficiamento/beneficiadora com seu próprio código de beneficiador alocado
pelo SAI deve, portanto, ter um nome de usuário para acessar o Sistema de Rastreamento de Fardos
Better Cotton, mesmo que sejam parte da mesma empresa.
Declarar fardos Better Cotton (responsabilidade da beneficiadora)
Para beneficiar e prensar fardos, solicita-se aos beneficiadores que declarem a lista de fardos que
produziram e de que produtor compraram ou que foram contratados para beneficiar o algodão em
caroço utilizado nos fardos. Isto é feito através do upload de um arquivo CSV, listando os fardos
(detalhado na próxima seção).
O Sistema de Rastreamento de Fardos verifica então se a Fazenda foi licenciado pela BCI para um
volume suficiente. Se a verificação for positiva os fardos declarados são considerados Better Cotton.
Declarar venda / compra de fardos (responsabilidade da beneficiadora)
Para vender fardos de Better Cotton, solicita-se que as beneficiadoras atualizem as informações sobre
eles no Sistema de Rastreamento de Fardos, de forma que a BCI saiba que foram vendidos. Isto
também é feito por meio de upload de um arquivo CSV (que teria sido descarregado primeiramente
do sistema local da beneficiadora). Sistema de Rastreamento de Fardos.
Para vender fardos de Better Cotton, solicita-se que as beneficiadoras forneçam uma lista de fardos,
BETTERCOTTON.ORG
5
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
apresentando as IDs de fardo, conforme inseridas no BTS, a seus clientes.
Encontrar o Better Cotton para comprar / como verificar a autenticidade dos fardos de
Better Cotton
Basicamente, os membros da BCI utilizam o Sistema de Rastreamento de Fardos:
1) para encontrar onde há fardos de Better Cotton disponíveis para venda e contatar as
beneficiadoras para comprá-los.;
2) para verificar se algodão que compraram é realmente Better Cotton (este é o caso se o
algodão é comprado tanto diretamente do beneficiador ou através de um intermediário
como um comerciante).
Observação: Beneficiadoras têm a possibilidade de não mostrar seus fardos aos membros BCI.
Observe, no entanto, que se você não mostrar seus fardos, seus cliente não poderão verificar se o
algodão que compraram é, de fato, Better Cotton. Quando tiver vendido os fardos, deve apresentálos no Sistema de Rastreamento de Fardos: seu cliente poderá verificá-los, mas não aparecerão como
disponíveis para venda para os membros BCI.
BETTERCOTTON.ORG
6
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
Guia do usuário
Visão Geral
As beneficiadoras registram a aquisição de algodão em caroço dos produtores, criam os fardos e
gerenciam seus inventários de fardos através do upload de arquivos CSV. O sistema mantém um
registro de algodão em caroço convertido em fardos.
O BTS também requer que os beneficiadores conectem suas próprias agendas de endereços de
produtores (em seus sistemas locais) com o SRF como segue:
• As beneficiadoras empregam seus sistemas locais para manter um registro dos produtores de
quem compram algodão ou de quem eles beneficiam de acordo com um contrato.
• É designado, pelo sistema local do beneficiador, um nome ou código a cada produtor.
• O SRF também designa um número de identificação para cada produtor, chamado de ID da
Fazenda.
• O BTS tem uma Agenda de Endereços, que funciona como uma ponte entre o SRF e o sistema
local da beneficiadora. Com a ajuda da Agenda de Endereços, a beneficiadora pode conectar um
ID da Fazenda em seu próprio sistema ao seu no SRF para referência futura e para gerenciar o
inventário muito mais facilmente.
•
O BTS fornece três modos de upload de arquivo CSV para o usuário: web, e-mail e serviço web.
Esses três módulos são detalhados abaixo.
Login
Para se conectar, vá para http://baletracker.bettercotton.org, e digite seu nome de usuário e senha
conforme fornecidos pela BCI. O sistema está disponível em português para usuários brasileiros.
Quando está se conectando ao Sistema de Rastreamento de Fardos Better Cotton pela primeira vez,
deve aceitar os termos e condições de utilização do Sistema de Rastreamento de Fardos Better
Cotton. Selecione “Li os termos e condições e aceito” e clique em OK para confirmar.
BETTERCOTTON.ORG
7
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
Navegação
Como entrar no BTS/Declarar módulo de Fardos
A seta vermelha indica o módulo que está sendo acessado. Para ir para o BTS/Declarar Fardos, clique
em em Declarar Fardos no topo da tela. Ao clicar em “Declarar Fardos”, a tela apresentada abaixo
aparecerá:
Menus
Você poderá ver uma barra de menu no topo da tela. Cada menu é explicado mais tarde neste guia
do usuário.
Registros de uploads
A tela de registros de uploads é a primeira tela visualizada ao clicar em Declarar Fardos. Os registros
de uploads mantêm o histórico e detalhes de todas as atividades de uploads feitas através do
aplicativo SRF e e-mail. A figura abaixo mostra a tela de registros de uploads.
A grade de dados na tela Registros de uploads exibe:
•
•
•
•
O
a data em que foi feito o upload do arquivo,
o nome do arquivo de que foi feito o upload,
o sumário do resultado do arquivo de que foi feito o upload, e
o usuário ou endereço de e-mail do qual foi feito o upload do arquivo.
sumário proporciona dados consolidados e estatísticas do arquivo do qual se fez upload,
BETTERCOTTON.ORG
8
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
realçando os registros cujo upload foi bem-sucedido, o número de registros dos quais foi impossível
fazer upload, e o número de fardos criados e atualizados.
Você pode filtrar os registros baseado no intervalo de tempo durante o qual foi feito o upload do
arquivo. A figura abaixo realça os campos de filtro:
Os passos dados abaixo descrevem como você pode filtrar registros.
1.
2.
3.
4.
No campo “De”, selecione a data na qual o período a ser filtrado inicia.
No campo “Para”, selecione a data na qual o período termina.
Clique o botão “Filtro” para filtrar os registros em datas selecionadas.
Você poderá ver todos os registros na faixa especificada de datas.
Como iniciar
Antes de fazer upload de arquivos CSV, deve passar por uma série de etapas:
• Prepare seu arquivo CSV
• Defina a configuração de CSV
• Insira Produtores em sua Agenda de Endereços
Essas etapas são explicadas nesta seção.
Estrutura do arquivo CSV
A tabela abaixo apresenta o posicionamento de cada coluna requerida no arquivo CSV. Você não
pode mudar a posição das colunas e estas devem ser mantidas mesmo que não forneça dados a
alguma delas. Além disso, o processador CSV ignorará a primeira linha ao ler o arquivo, de forma que
esta não deve conter dados e deve conter o nome das colunas, como exibido abaixo. Os dados
devem iniciar a partir da segunda linha, como aqui mostrado.
Os dados em seu arquivo CSV devem seguir um número de regras para que o BTS compreenda os
dados dos quais fará o upload:
Coluna
“ID do
Fardo”
Descrição
Formato obrigatório
Este
é
o
número
de
identificação exclusivo de um
fardo.
Seu número SAI (10 dígitos) - o
número da prensa (3 dígitos) #-ID do
fardo (6 dígitos)
Ex. 9876546543-102-110009
BETTERCOTTON.ORG
É
obrigatório
fornecer
dados nesta
coluna?
Sim
9
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
“Data de
transação”
Esta é a data na qual recebeu o
algodão em caroço utilizado
para fazer esse fardo.
dd-mm-yyyy
Ex. 31-05-2012
Se estiver usando o MS Excel para
gerar seus arquivos CSV, dependendo
da versão, deverá personalizar o
modo como os dados são mostrados.
Para isto, selecione as células em que
há datas, clique com o botão direito,
procure “Formatar células”, vá para a
aba “número”, escolha “Personalizar”
e sob “Tipo”, personalize a data para
que apareça como “dd-mm-aaaa”,
com “-” e não com “/”.
Sim
“Número
de
referência
interna”
Isto pode ser qualquer valor
interno/ID
utilizado
para
identificar um fardo.
Não é exigido formato específico.
Não
“ID da
Agenda de
Endereços
”
Este é o nome de uma Fazenda
que você conectou a uma ID de
GP BCI na Agenda de
endereços.
Essa ID é qualquer número ou texto.
Sim
“Peso do
fardo”
Este campo contém o peso do
fardo correspondente. Se não
for fornecido o peso para um
fardo, o valor padrão, como
declarado na configuração de
CSV, será utilizado. Este campo
é
ignorado
quando
as
informações sobre um fardo são
modificadas (ex. mudança de
presença no inventário para
vendido).
Somente dígitos
Não
“Mostrar/
ocultar”
Se quiser mostrar seus fardos
para os membros BCI, escolha
“sim”.
Se não quiser mostrar seus
fardos para os membros BCI,
escolha “não”.
Observação: se seus fardos são
“vendidos” (veja a próxima
linha sobre Status), devem ser
apresentados no sistema, de
forma que o cliente possa
verificar se os fardos adquiridos
são Better Cotton.. Se esconder
seus fardos, seu cliente não
poderá verificá-los no sistema.
Esse campo deve conter “yes” (sim) ou
“no” (não), em inglês. Estes termos
devem estar em inglês.
Sim
BETTERCOTTON.ORG
10
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
Status
Se o fardo ainda estiver em seu
inventário, isto é, se não tiver
sido
vendido,
escolha
“inventário”.
Se tiver vendido o fardo,
escolha “vendido”.
Este é o status de um fardo “inventory (inventário) ou sold
(vendido)”. Estes termos devem estar
em inglês.
Sim
“Data da
venda”
Esta é a data em que o fardo é
vendido. Deve existir um valor
neste campo se o status estiver
marcado como “vendido”.
O formato da data é dd-mm-aaaa
Ex. 31-05-2012
Se estiver usando o MS Excel para
preparar seus arquivos CSV, e
dependendo da versão deste, você
deverá personalizar o modo como os
dados são mostrados. Para isto,
selecione as células em que tenha
datas, clique com o botão direito,
procure “Formatar células”, vá para a
aba “número”, escolha “Personalizar”
e sob “Tipo” personalize a data para
que apareça como “dd-mm-aaaa”,
com “-” e não com “/”.
Sim
(condicional)
“Nome do
comprador
”
Esta coluna contém o nome do
comprador do fardo.
“Código
do país”
Essa coluna contém o código
do país do comprador do fardo.
Não
O formato segue os Códigos ISO de
Países, em inglês, compostos de 2
letras.http://www.iso.org/iso/countr
y_codes/iso_3166_code_lists/countr
y_names_and_code_elements.htm
Por exemplo, BR para Brasil, US para
EUA, CN para China, PK para
Paquistão, IN para Índia, etc.
Não
Há diversas maneiras de gerar um arquivo CSV. A opção mais simples é o MS Excel. Para salvar um
arquivo Excel como CSV, vá para “salvar como”, escolha “salvar como tipo” “CSV delimitado por
vírgula”.
Você também pode gerar um arquivo CSV a partir de um documento de texto com seu bloco de
notas.
Para salvar seu documento de texto como um arquivo CSV, adicione apenas a extensão “.csv” após o
BETTERCOTTON.ORG
11
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
nome de seu arquivo:
Configuração de CSV: Proporção de Conversão e Peso do Fardo
Antes de fazer o upload de arquivos CSV por qualquer meio, deve definir uma proporção de
conversão e um peso médio de fardo. A proporção de conversão de fardos é a porcentagem de
algodão em caroço convertido em fibra de algodão. Ao criar fardos através do upload de um arquivo
CSV, deve ser especificado o peso do fardo. Mas se a informação do peso do fardo não for fornecida
no arquivo CSV, então o peso do fardo declarado em Configuração de CSV será utilizado como peso
padrão do fardo.
Para especificar sua proporção de conversão e peso médio de fardo, clique em “Configuração de
CSV”.
Você verá a tela apresentada abaixo:
1. adicione a proporção de conversão de fardo no espaço fornecido.
2. insira o peso do fardo em kg.
3. clique em OK para salvar a proporção de conversão de fardo para utilizar quando do upload de
arquivos CSV.
4. a proporção de conversão e peso do fardo são salvas.
5. clique em “Fechar” para sair desta tela.
Agenda de Endereços
Como mencionado anteriormente, a beneficiadora fornece a seus produtores números de
identificação gerados localmente e a SRF da BCI fornece aos produtores IDs de Fazendas. Para a
conveniência das beneficiadoras, esta pode emparelhar ambos as IDs de uma fazenda e dar um nome
ao par.
Clique em “Agenda de Endereços”.
BETTERCOTTON.ORG
12
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
A figura abaixo mostra como a Agenda de Endereços se apresenta em sua tela:
Adicionar entrada na Agenda de Endereços
O aplicativo lhe permite adicionar entrada na agenda de endereços pela criação de um par de IDs:
1. clique em Adcionar Entrada no lado esquerdo superior da grade de dados.
2. você verá agora a tela Adicionar/Modificar Inserção, como mostrado na figura abaixo ;
3. forneça a ID de GP da BCI (6 dígitos),
4. forneça um nome para o par (pode ser o nome ou número que utiliza normalmente em seu
sistema de gestão local),
5. O sistema preenche o campo nome da Fazenda correspondente à ID da Fazenda. Se uma
correspondência for encontrada,
6. clique em Criar para confirmar e salvar a entrada. Clique em Cancelar para sair desta tela sem
salvar.
BETTERCOTTON.ORG
13
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
Procurar na Agenda de Endereços
Para facilidade do usuário, uma entrada pode ser procurada na agenda de endereços. Entradas na
agenda de endereços podem ser procuradas baseadas no nome, ID ou nome da Fazenda. A figura
abaixo destaca a barra de busca:
As etapas seguintes descrevem como você pode procurar uma entrada na agenda de endereços:
1. forneça a palavra-chave que deseja para conduzir a busca,
2. Clique no
ícone para procurar as palavras-chave fornecidas.
3. As entradas que correspondem aos critérios fornecidos serão apresentadas em sua tela.
4. Para visualizar todas as entradas e atualizar os critérios de busca, clique na opção “Restaurar”.
Como fazer upload de um arquivo CSV
O SRF fornece três modos de upload de arquivo CSV para o usuário: web, e-mail e serviço web. Esta
seção descreve os modos de upload de arquivos CSV.
No Sistema de Rastreamento de Fardos
1. Para fazer upload de um arquivo CSV para o SRF você deve clicar a opção “Fazer upload de CSV”
na barra de menu.
Ao clicar no “Upload CSV”, a tela mostrada abaixo aparecerá:
2. Clique em “Pesquisar” na tela para localizar o arquivo no seu dispositivo de armazenamento.
Selecione o arquivo do qual deve fazer o upload e clique em “OK”. A localização do arquivo
selecionado aparecerá no espaço destinado na tela.
3. Para fazer upload de o arquivo selecionado, clique no botão “Fazer upload”. Clique em
“Cancelar” para sair desta tela sem salvar.
O registro de uploads é atualizado e a linha de cima da tela de Registros de uploads conterá os
detalhes do último arquivo do qual foi feito upload. Isso pode levar alguns segundos, não atualize sua
tela.
Por e-mail
Também é possível fazer upload de arquivos CSV sem acessar o SRF, através do envio do upload por
e-mail.
1. Para isso, deve primeiro encontrar o endereço de e-mail para o qual precisa mandar o arquivo
CSV, bem como o token de segurança. Você deve ir ao menu “Configuração de e-mail do CSV”.
BETTERCOTTON.ORG
14
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
A figura abaixo mostra como sua tela se apresenta quando clica na opção “Configuração de e-mail do
CSV”:
Endereço de e-mail
Token de segurança
Como pode ver a tela “Configuração de e-mail do CSV” fornece o endereço de e-mail para o qual o
arquivo CSV deve ser mandado e o token de segurança para autorizar o upload por e-mail. A figura
abaixo mostra uma visão ampliada das duas
Observação: O token de segurança não muda. Consequentemente, você pode compartilhá-lo com
colegas de modo que eles possam enviar e-mails de arquivos CSV sem ter que se conectar ao SRF.
1. Prepare um novo e-mail.
2. Coloque o endereço de e-mail para upload no campo “Para”.
3. Coloque o token de segurança no corpo do e-mail. A primeira linha do e-mail deve conter
somente o token de segurança. Nenhuma outra informação deve ser fornecida na primeira linha.
4. Anexe o arquivo CSV. A figura abaixo mostra como seu e-mail deve se apresentar:
Endereço de e-mail
Anexe o arquivo CSV
Token de segurança
BETTERCOTTON.ORG
15
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
5. Você pode especificar qualquer “assunto”. O campo “assunto” é opcional e pode ser deixado
em branco.
6. Envie o e-mail preparado.
Se seu e-mail for enviado com sucesso, a tela de registros de uploads é atualizada e a primeira
linha na tela apresenta o registro do último upload (isto pode levar alguns segundos). Também,
você receberá uma mensagem confirmando que o e-mail foi recebido com sucesso.
No caso de falha no upload de seu e-mail,você receberá uma mensagem de erro como resposta a
ele. Os casos de erros são discutidos abaixo
1.
“Token de segurança inexistente ou incorreto”:
Se por engano você não tiver enviado um token de segurança ou se este estiver incorreto, a
mensagem de e-mail mostrada na figura abaixo é retornada.
Deverá enviar o arquivo CSV novamente para o mesmo endereço de e-mail com o token de
segurança correto.
2. “Nenhum arquivo anexado ou arquivo vazio anexado”
BETTERCOTTON.ORG
16
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
Se por engano não tiver anexado a seu e-mail um arquivo CSV ou se este estiver vazio, sem dados, a
mensagem de retorno do sistema é mostrada na figura abaixo:
Para fazer upload de um arquivo novamente, você deve anexá-lo em e-mail ou enviar um arquivo com
registros de dados, fornecer o token de segurança correto, e enviar o arquivo para o endereço de email mencionado.
Por serviço Web
Este modo de fazer upload de um arquivo CSV é explicado no apêndice a este documento, pois é
planejado apenas para empresas de TI que desenvolvam um serviço web para sua cliente
beneficiadora.
Seu upload de CSV funciona?
Sumário do Resultado de Uploads
Para verificar se seu e-mail foi levado em conta pelo SRF, clique em “Registros de uploads” que
fornece uma lista de todos os uploads.
Você verá a tela onde o seu último upload aparecerá na parte superior:
BETTERCOTTON.ORG
17
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
A tela Registros de uploads fornece um Sumário do Resultado de Uploads.
O sumário proporciona dados consolidados e estatísticas do arquivo do qual se fez upload,
realçando os registros cujo upload foi bem-sucedido, o número de registros dos quais foi impossível
fazer upload, e o número de fardos criados e atualizados.
Para uma visão mais detalhada a respeito da atividade de upload e status dos fardos individuais,
clique em “Baixar Relatório”.
Como Entender os Relatórios de Registro de Upload
A figura abaixo mostra o arquivo Excel baixado ao clicar “Baixar Relatório”.
O arquivo mostra o status de cada registro no arquivo de upload original na coluna de resultados. A
coluna de resultados pode ter quaisquer dos seguintes cinco status:
Status
Explicação
Criar : Sucesso
Isto significa que o fardo foi criado com sucesso.
Criar : Falha
Isto significa que o fardo não pôde ser criado.
Modificar : Sucesso
Isto significa que o fardo foi modificado com sucesso.
Modificar : Falha
Isto significa que o fardo não pôde ser modificado.
Nenhuma ação
Nenhuma ação foi realizada no fardo.
Resultados de Registro de Upload por e-mail
Quando faz o upload de um arquivo CSV por e-mail, recebe também o relatório por e-mail. Isso pode
BETTERCOTTON.ORG
18
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
levar algum tempo, dependendo do tamanho do arquivo contendo o status dos registros
processados e um arquivo Excel anexo, devolvido com o status de cada registro. A figura abaixo
representa isto.
Devolver Anexo
O arquivo anexo no e-mail é o mesmo arquivo que você pode baixar da tela “Registros de Uploads”.
Recapitulação: o que você precisa fazer?
Etapa 1: declarar os fardos ao prensá-los. Você pode fazer isso ao carregar o arquivo CSV conforme
descrito no manual.
Etapa 2: declarar vendas de fardos no ato. Você pode fazer isso ao carregar o arquivo CSV conforme
descrito no manual.
Observação: quando seu algodão já tiver sido alocado ao cliente antes da prensa dos fardos, você
pode pular a etapa 1 e declarar seus fardos no sistema diretamente como vendidos.
Etapa 3: forneça a seu cliente uma lista das IDs de fardos vendidos conforme consta no sistema.
Observação: IDs de fardos devem ter o seguinte formato: (SAI) (10 dígitos) – número da prensa ( 3
dígitos) – número do fardo (6 dígitos), ex. 0789853676-001-141334.
BETTERCOTTON.ORG
19
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
Anexo 1: Acrônimos
BCI
Better Cotton Initiative
SRF
Sistema de Rastreamento de Fardos
CSV
Comma Separated Values [Valores Separados por Vírgulas]
ID
Identificador
GP
Fazenda
SAI
Sistema Abrapa de Identificação
BETTERCOTTON.ORG
20
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
Anexo 2: Termos e Condições de Utilização do sistema de
rastreamento on-line de fardos Better Cotton
Final, 2 de agosto de 2010
Preâmbulo
Objetivo
O sistema de rastreamento on-line de fardos Better Cotton auxilia a rastreabilidade dos fardos de
algodão que tenham sido produzidos em conformidade com os Critérios e Princípios de Produção
BCI (clique aqui para fazer download) e avaliados como Better Cotton em conformidade com os
Mecanismos de Avaliação da Propriedade Rural BCI (clique aqui para fazer download). O sistema de
rastreamento de fardo Better Cotton é operado pela UTZ Certified, sendo o único endossado pela
BCI.
Usuários
O Sistema de Rastreamento de Fardos Better Cotton está sendo disponibilizado a:
• Membros BCI; e
• Beneficiadores4, comprometidos com a participação na Cadeia de Fornecimento de Better
Cotton em conformidade com os requisitos detalhados no documento: Cadeia de
Fornecimento do Better Cotton (clique aqui para fazer o download).
Termos e Condições de Uso
Ao assinalar a caixa abaixo, o Usuário se compromete com estes Termos e Condições de Utilização
do sistema de rastreamento on-line de fardos Better Cotton.
Acesso
A BCI se reserva o direito de recusar o acesso ao sistema de rastreamento de fardo Better Cotton a
qualquer pessoa ou organização sem dar qualquer justificação para tal.
A BCI não terá qualquer responsabilidade em relação ao Usuário do sistema de rastreamento on-line
de fardos Better Cotton.
A BCI tem o direito de suspender o acesso do Usuário através de uma notificação por escrito se o
Usuário:
• perder seu status de associado à BCI;
• violar estes Termos e Condições de Uso;
• fornecer qualquer informação que seja imprecisa ou possa gerar mal-entendidos em qualquer
aspecto material;
• se engajar em condutas que na opinião razoável da BCI sejam incompatíveis com a utilização
adequada do Sistema de Rastreamento de Fardos BCI ou possam afetar de maneira adversa a
operação do mesmo.
Compromissos do Usuário
O Usuário concorda em:
• relatar e inserir apenas informações verdadeiras e precisas no Sistema de Rastreamento de
Fardos Better Cotton.
• relatar e inserir informações tempestivamente.
• não divulgar seu nome de usuário e senha do sistema de rastreamento on-line de fardos Better
Cotton a terceiros.
4
Cada instalação de beneficiamento, incluindo aquelas que façam parte da mesma beneficiadora, deve aceitar estes
Termos e Condições de Uso.
BETTERCOTTON.ORG
21
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
•
•
não compartilhar informações obtidas (cópia, provenientes de download, etc.) através do
sistema de rastreamento on-line de fardos Better Cotton com terceiros que não façam parte de
suas relações comerciais na cadeia de fornecimento de algodão.
obedecer às Regras de Comunicações BCI (clique aqui para fazer o download), especificamente,
ao que diz respeito ao logotipo BCI e marca registrada Better Cotton.
Compromissos da BCI
A BCI concorda em:
• mediante a aceitação de um requerimento para utilização do sistema de rastreamento on-line de
fardos Better Cotton, conceder acesso ao mesmo ao Usuário;
• fornecer capacitação e assistência para a utilização do sistema de rastreamento on-line de fardos
Better Cotton;
• manter em sigilo qualquer informação comercialmente delicada fornecida à BCI como parte do
relatório anual sobre utilização de Better Cotton;
• promover o Usuário beneficiador associado aos membros da BCI como participante da Cadeia
de Fornecimento Better Cotton.
Responsabilidade sobre ICMS
O sistema de rastreamento de fardo Better Cotton não é uma plataforma comercial. A BCI não é
responsável pela coleta e/ou prestação de contas de ICMS que possa ser pagável a qualquer
autoridade pelo Vendedor ou Comprador em relação a uma venda. Cada usuário do Sistema de
Rastreamento de Fardos Better Cotton concorda em indenizar efetiva e integralmente, e manter
integral e efetivamente indenizada a BCI contra quaisquer processos judiciais, custas, alegações,
demandas, gastos, perdas, danos ou responsabilidade, multas, custos e gastos sofridos e incorridos
ou acordados para pagamento pela BCI como resultado da falha do usuário no cumprimento de
quaisquer obrigações referentes a ICMS daquele usuário.
Assinatura
Ao assinalar a caixa abaixo, em nome da minha organização/empresa, reconheço que li e aceitei os
Termos e Condições de Utilização do sistema de rastreamento on-line de fardos Better Cotton.
BETTERCOTTON.ORG
22
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
Anexo 3: Como fazer upload de um arquivo CSV por serviço web
Seu fornecedor de TI pode desenvolver um serviço ao cliente web para integrar seu sistema de
gestão de inventário com o SRF e, consequentemente, automatizar o upload de arquivos CSV sem ter
que fazer nada. O SRF permite que você faça o upload de arquivos CSV utilizando um serviço web
pela implementação de um serviço de cliente web em Java, .NET, Grails, Ruby, PHP, e qualquer outra
linguagem de programa que seu fornecedor de TI puder desenvolver para você.
Esta seção destina-se a seu fornecedor de TI.
Como fazer upload através de um serviço web?
O serviço web apresenta dois métodos de utilização, como listado abaixo:
1. isAlive:
o método isAlive é utilizado para verificar o status do serviço web
quando um usuário solicita o método. O método retorna uma sequência com o nome
dado ou parâmetro.
2. uploadFile: o método uploadFile é utilizado para fazer upload de um arquivo CSV
juntamente com um token de segurança válido. O upload do arquivo CSV é feito em
formato base64binary. Após a validação do token de segurança pelo serviço web, o
arquivo CSV é processado.
Situações de Erro no Upload de Serviço Web:
As seguintes situações de erro podem ocorrer no upload de serviço web:
1. Se a beneficiadora envia um token de segurança inválido, a resposta do sistema é:
Você forneceu um token de segurança incorreto, consequentemente o processo de upload
CSV não executou o arquivo CSV. Tente novamente com um token de segurança válido.
2. Se a beneficiadora envia qualquer arquivo ao invés de um arquivo CSV, a resposta do
sistema é:
Não encontramos um arquivo CSV para ser processado. Envie um arquivo CSV adequado
juntamente com o token de segurança válido.
3. Se o usuário envia um arquivo em um formato diferente do CSV, a resposta do
sistema é:
Tipo de Arquivo Inválido
4. Se um outro arquivo CSV estiver sendo processado simultaneamente via e-mail, web,
ou serviço web, a resposta do sistema é:
Há um outro arquivo CSV sendo processado no momento, cujo upload foi feito por {0} em {1}.
Dependendo do tamanho do arquivo pode levar algum tempo para finalizar o processamento.
{0} = Status de upload (web, e-mail, serviço web)
{1} = Data/hora
5. Se uma beneficiadora que não constar do SAI fizer upload de um arquivo CSV, a
resposta do sistema será:
Você não é uma beneficiadora do SAI.
Se nenhum erro for encontrado ao processar o arquivo, o sistema envia um sumário da atividade de
upload juntamente com o arquivo processado
BETTERCOTTON.ORG
23
SISTEMA DE RASTREAMENTO DE FARDOS – MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS
Pseudo código do Serviço de cliente Web
Gera chamadas de cliente web utilizando WSDL
Chama o isAlive com algum texto
Se a resposta é devolvida
Configurar o token de segurança
Configurar a data e hora no formato (dd-mm-aaaa)
Inicializar fluxo de entradas para fazer upload do arquivo CSV do sistema de arquivos
Converter o fluxo de entradas em matriz de byte
Chamar o método uploadFile com matriz de byte, token de segurança, data e nome do arquivo
Obter o status de upload
Se o erro no status de upload é igual a 0
Inicializar o fluxo de saída
Salvar o arquivo Excel
Outro
Verificar mensagem de erro
Outro
Ocorre exceção
A seção abaixo contém uma amostra de código Java para utilização do serviço web
Status do Serviço Web
Primeiramente, gera um chamado para utilizar o serviço web. Você pode chamar o método através
dele.
Serviço FileUploaderImplService = novo FileUploaderImplService();
Carregador FileUploader = service.getPort(FileUploader.class);
System.out.println(“status de serviço: " + uploader.isAlive("Jason Segal");
Resultado:
Sim Jason Segal, Estou aqui :) - SRF, Better Cotton Initiative
Upload de arquivo
Arquivar= Arquivo novo("C:/temp/sai-ginner.csv");
InputStream inputStream = novo FileInputStream(file);
Formatar data SimpleDateFormat = nova SimpleDateFormat("dd-MM-yyyy");
Sequência dataHora = dateFormat.format(nova Data());
byte fileBytes[] = IOUtils.toByteArray(inputStream); // obter bytes do arquivo // em base64binary
UploadStatus
uploadStatus
=
uploader.uploadFile("8aX1$hs85X98",dateTime,
fileBytes,file.getName());
Status de Upload
if(uploadStatus.getErrorCode() == 0){ // sem erros
System.out.println("Sumário de Uploads: " + uploadStatus.getSummary());
FileOutputStream outputStream = novo FileOutputStream(novo File("C:/temp/processedCSV.xls"));
// Como obter o arquivo Excel
outputStream.write(uploadStatus.getAttachedFile()); //como salvar o Excel
outputStream.close();
}outro // ocorreu erro
{
System.out.println(“Mensagem de erro: " + uploadStatus.getErrorMessage()); // como
obter detalhes de erros }
BETTERCOTTON.ORG
24