SISTEMA DE RASTREAME NTO ON-LINE DE FARDOS …bettercotton.org/wp-content/uploads/2014/01/Better-Cotton-Bale... · meio em que é cultivado e o futuro do setor. Para atingir este

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

B E T T E R C O T T O N . O R G 1

Í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 5

Guia do usuário 7

Visão Geral 7

Login 7

Navegação 8

Como iniciar 9

Como fazer upload de um arquivo CSV 14

Seu upload de CSV funciona? 17

Recapitulação: o que você precisa fazer? 19

Anexo 1: Acrônimos 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 23



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.



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.



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]



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,



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.



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.



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:

• 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.

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.

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. No campo “De”, selecione a data na qual o período a ser filtrado inicia. 2. No campo “Para”, selecione a data na qual o período termina. 3. Clique o botão “Filtro” para filtrar os registros em datas selecionadas. 4. 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 Descrição Formato obrigatório

É obrigatório fornecer

dados nesta coluna?

“ID do Fardo”

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

Sim



“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



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.

Não

“Código do país”

Essa coluna contém o código do país do comprador do fardo.

O formato segue os Códigos ISO de Países, em inglês, compostos de 2 letras.http://www.iso.org/iso/country_codes/iso_3166_code_lists/country_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



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”.



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.



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”.



A figura abaixo mostra como sua tela se apresenta quando clica na opção “Configuração de e-mail do CSV”:

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:

Token de segurança

Endereço de e-mail

Anexe o arquivo CSV

Endereço de e-mail

Token de segurança



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”



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 e-mail 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:



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



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.

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.

Devolver Anexo



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



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.



• 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.



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



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 }

Documents

SISTEMA DE RASTREAME NTO ON-LINE DE FARDOS …bettercotton.org/wp-content/uploads/2014/01/Better-Cotton-Bale... · meio em que é cultivado e o futuro do setor. Para atingir este