SISTEMA DE RASTREAMENTO ON-LINE DE FARDOS BETTER COTTON

Transcrição

1 SISTEMA DE RASTREAMENTO ON-LINE DE FARDOS BETTER COTTON MANUAL DE CAPACITAÇÃO PARA BENEFICIADORAS BRASILEIRAS QUE USAM SAI Maio de 2013

2 Í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 1

3 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 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. 2

4 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 Fazendas 2. 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 ( 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. 3

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

6 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, 5

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

8 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 serviço web. Esses três módulos são detalhados abaixo. Login Para se conectar, vá para 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. 7

9 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 . 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 do qual foi feito o upload do arquivo. O sumário proporciona dados consolidados e estatísticas do arquivo do qual se fez upload, 8

10 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 Sim 9

11 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 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 10

12 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 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. 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 11

13 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. 12

14 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. 13

15 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 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 Também é possível fazer upload de arquivos CSV sem acessar o SRF, através do envio do upload por Para isso, deve primeiro encontrar o endereço de para o qual precisa mandar o arquivo CSV, bem como o token de segurança. Você deve ir ao menu Configuração de do CSV. 14

16 A figura abaixo mostra como sua tela se apresenta quando clica na opção Configuração de do CSV : Endereço de Token de segurança Como pode ver a tela Configuração de do CSV fornece o endereço de para o qual o arquivo CSV deve ser mandado e o token de segurança para autorizar o upload por . 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 s de arquivos CSV sem ter que se conectar ao SRF. 1. Prepare um novo Coloque o endereço de para upload no campo Para. 3. Coloque o token de segurança no corpo do . A primeira linha do 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 deve se apresentar: Endereço de Anexe o arquivo CSV Token de segurança 15

17 5. Você pode especificar qualquer assunto. O campo assunto é opcional e pode ser deixado em branco. 6. Envie o preparado. Se seu 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 foi recebido com sucesso. No caso de falha no upload de seu ,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 mostrada na figura abaixo é retornada. Deverá enviar o arquivo CSV novamente para o mesmo endereço de com o token de segurança correto. 2. Nenhum arquivo anexado ou arquivo vazio anexado 16

18 Se por engano não tiver anexado a seu 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 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 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: 17

19 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 Criar : Sucesso Criar : Falha Modificar : Sucesso Modificar : Falha Nenhuma ação Explicação Isto significa que o fardo foi criado com sucesso. Isto significa que o fardo não pôde ser criado. Isto significa que o fardo foi modificado com sucesso. Isto significa que o fardo não pôde ser modificado. Nenhuma ação foi realizada no fardo. Resultados de Registro de Upload por Quando faz o upload de um arquivo CSV por , recebe também o relatório por . Isso pode 18

20 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 é 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

21 Anexo 1: Acrônimos BCI SRF CSV ID GP SAI Better Cotton Initiative Sistema de Rastreamento de Fardos Comma Separated Values [Valores Separados por Vírgulas] Identificador Fazenda Sistema Abrapa de Identificação 20

22 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 Beneficiadores 4, 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. 21

23 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. 22

24 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 , 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, , 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 23

25 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 } 24