“Um catálogo correto começa no CSV do produtor.”
Objetivo: publicar os produtos da empresa no Plano Empresas – Catálogo de Produtos.
Em geral, a empresa faz isso uma vez. Depois, no dia a dia, apenas administra disponibilidade e preço.
Alguns vendedores utilizam o catálogo para anunciar
lotes do dia com entrega na rota de retorno.
Isso permite otimizar a logística da viagem.
O catálogo de produtos exibido no Portal CM²O Agro Serra RJ é estruturado em formato de planilha, permitindo consulta rápida e objetiva pelos interessados.
Para garantir consistência das informações e funcionamento correto do sistema, todos os campos estruturais do catálogo devem estar preenchidos no momento do envio do arquivo CSV.
Campos estruturais obrigatórios do catálogo:• Categoria do produto
• Código do produto (ref_code)
• Nome do produto • Unidade de comercialização (ud_venda)
• Valor da unidade de comercialização
• Indicação de disponibilidade do produto
• Anotação ou observação do produtor
Esses campos formam a identificação operacional do produto no portal e permitem que interessados selecionem itens e gerem listas de interesse comercial.
Estas orientações são para upload do catálogo. A sua exibição poderá ter layout diferente.
1) O que você vai precisar
- Um arquivo CSV com o catálogo (feito no Excel/LibreOffice/Google Sheets).
- Imagens pequenas dos produtos (img_small), em .jpg, .png ou .webp.
2) Como montar o CSV do catálogo
Regra: cada linha do CSV representa uma condição de venda do produto.
Nota: o mesmo produto pode ter uma linha para “kg” e outra para “caixa”.
Nomes de colunas aceitas (exatamente como abaixo e mesma ordem):
- categoria
- ref_code
- product_name
- ud_venda
- valor_unidade
- anotacao_produtor
- img_small
Cabeçalho obrigatório do arquivo CSV:
categoria;ref_code;product_name;ud_venda;valor_unidade;anotacao_produtor;img_small
Regras do arquivo CSV:
- O separador de colunas deve ser ponto e vírgula (;)
- O separador de texto deve ser as aspas (")
- A primeira linha deve ser o cabeçalho
- Não incluir títulos ou textos antes do cabeçalho
- Todos os campos são requeridos
- valor_unidade deve ser número
- img_small deve conter o mesmo nome registrado em 'product_name', mas tudo minúsculo. (ex.: product_name 'Abacaxi' terá nome abacaxi.png no campo img_small)
- ud_venda deve ser informada em letras minúsculas (ex.: kg, caixa, saco).
Unidades de venda (ud_venda) aceitas (minúsculas):
- balde
- caixa
- dúzia
- fardo
- g
- kg
- litro
- maço
- muda
- pacote
- saco
- un
Exemplo de arquivo válido, supondo que seu ref_code seja 'fruleg-01', (categoria frutos e legumes, produto número 01 dessa categoria):
categoria;ref_code;product_name;ud_venda;valor_unidade;anotacao_produtor;img_small frutos e legumes;fruleg-01;Tomate Cereja;caixa;85,00;caixa fechada;tomatecereja.png frutos e legumes;fruleg-02;Tomate Italiano;kg;9,90;venda mínima 10kg;tomateitaliano.png
3) Código do produto (ref_code)
Cada produto deve possuir um código próprio definido pelo produtor.
Esse código é utilizado para identificação e organização dos produtos no catálogo e deve ser definido antes do envio do arquivo CSV ao portal.
O Portal CM²O Agro Serra RJ não cria códigos de produtos automaticamente.
Caso o produtor ainda não possua um sistema de codificação interno, recomenda-se definir um padrão simples de identificação antes da publicação do catálogo.
Importante sobre o código do produto (ref_code):
ref_codeidentifica o produto.- O mesmo
ref_codepode aparecer em mais de uma linha, desde que aud_vendaseja diferente. - O
ref_codee outros campos do CSV são utilizados em diversos processamentos para oferecer funcionalidades consistentes e prover integridade dos dados.
Exemplo (mesmo produto com duas ud_venda diferentes):
frutos e legumes;fruleg-02;Tomate Italiano;kg;......
frutos e legumes;fruleg-02;Tomate Italiano;caixa;......
Exemplo de ref_code do Portal: 'fruleg-02', e seu catálogo terá a linha assim:
| hortifruti | fruleg-02 | Tomate Italiano | kg | 9,90 | venda mínima 10kg | tomateitaliano.png |
4) Como salvar o arquivo CSV
- Abra o catálogo no Excel ou LibreOffice.
- Use “Salvar como”.
- Escolha o formato CSV.
- Se aparecer opção de separador de campos, use
;(ponto e vírgula). - Para separador de textos, use
"(aspas).
5) Como preparar as imagens (img_small)
Formatos aceitos: JPG, PNG ou WebP.
Regra do nome do arquivo: o nome da imagem deve ser igual ao img_small do CSV. (alternativamente, você pode usar seu ref_code no campo img_small, e será a identificação da imagem do seu produto). Exemplo:
frutos e legumes;fruleg-02;Tomate Italiano;kg;9,90;mínimo 10kg;fruleg-02.png
Exemplo:
No CSV: img_small = tomateitaliano.png
Arquivo: tomateitaliano.png (ou fruleg-02.png, fruleg-02.webp)
Dica: use imagem retangular (formato de tela). Se souber, use 16:9.
6) Passo a passo para enviar
- Acesse o Portal com o usuário da empresa (tem de ser o mesmo que registrou a empresa no Portal).
- Entre em Meus Anúncios → botão 'criar anúncio novo' → Planos Empresas → Catálogo de Produtos.
- Envie o arquivo CSV uma única vez.
- Envie as imagens, selecionando em lotes de no máximo 20 imagens por vez.
REPITA o envio, selecionando novos lotes das imagens restantes até que todas sejam enviadas. - Confira o catálogo publicado após aprovação pelo Portal.
7) Depois de publicado
- O produtor deve indicar no catálogo os produtos disponíveis (checkbox). Opção 'editar catálogo'.
- O cliente do portal (logado) interessado em produtos de um catálogo, poderá selecionar itens dele (checkbox) e gerar uma lista de interesse.
- A lista poderá ser baixada, impressa e/ou enviada ao produtor por ação do ineteressado.
- Após envio/fechamento, a lista não poderá ser editada (ficará disponível apenas para consulta do interessado e do produtor).
- A lista exibirá um campo de
statuspara indicar sua visualização pelo destinatário. - Internautas visitantes não terão acesso às listas, poderão consultar apenas o catálogo para visualização.
8) Utilizando o catálogo do produtor
Como baixar e guardar sua lista de interesses
Após selecionar os produtos no catálogo e clicar em Gerar Lista de Interesses, o sistema exibirá sua lista com os itens escolhidos.
Nessa página você encontrará o botão Download.
Ao clicar em Download, o portal irá gerar um arquivo da sua lista, que será baixado para o seu dispostivo.
Como utilizar esse arquivo
- Localize o arquivo baixado no seu dispositivo.
- Abra o arquivo e o visualize por meio do seu navegador de internet (Chrome, Edge, ou outro costuma que usar).
- Você verá a lista exatamente como foi gerada no portal.
- Se desejar, utilize a opção Imprimir do navegador.
- No diálogo de impressão, você poderá escolher Salvar como PDF, opção comumente disponível nos computadores.
Dessa forma você pode guardar sua lista, enviar para outras pessoas ou utilizá-la como referência para negociação com o produtor.
Esse procedimento funciona em qualquer computador ou celular moderno, sem necessidade de instalar programas adicionais.
Envio de listas ao produtor
O envio da lista de interesse é realizado pelo próprio interessado por meio de funcionalidade do portal.
O sistema registra o envio da lista e encaminha o conteúdo ao endereço eletrônico público da empresa produtora.
Caso seja necessário reenviar a lista, o próprio interessado poderá executar novamente a ação de envio.
O portal registra os eventos de envio, mas não interfere na decisão comercial do interessado.
Alterações posteriores no catálogo
Alterações posteriores em campos estruturais do catálogo, como código do produto, nome do produto ou unidade de comercialização, podem gerar inconsistências nos registros já existentes no portal.
Por esse motivo, recomenda-se que essas informações sejam definidas de forma estável antes da publicação do catálogo.
Caso novas formas de comercialização surjam no futuro, como novas unidades de venda (por exemplo: pallets, caixas especiais ou novos formatos de embalagem), o procedimento correto é adicionar um novo item comercial ao catálogo, mantendo os registros anteriores inalterados.
Imagem do produto
A imagem do produto é exibida apenas sob demanda.
No catálogo público, a imagem aparece através de um botão de visualização que abre a fotografia do produto em janela sobreposta.
Essa abordagem permite manter o catálogo leve, rápido para consulta e adequado ao uso diário por compradores e distribuidores.
A visualização de imagens é opcional e destinada principalmente a compradores que necessitam confirmar características visuais do produto.
Listas de interesse comercial
O catálogo permite que interessados selecionem produtos e gerem uma lista de interesse comercial.
A lista pode ser:
• visualizada no portal
• baixada em arquivo HTML
• impressa em PDF
• enviada diretamente ao produtor
O envio da lista é realizado exclusivamente para o endereço de e-mail público informado pela empresa produtora no portal.
Caso o interessado deseje compartilhar a lista com terceiros, deverá fazê-lo utilizando o arquivo baixado e seu próprio sistema de e-mail.
9) Organização do Catálogo de Produtos
Cada empresa participante do Portal CM²O Agro Serra RJ mantém um catálogo estruturado de seus produtos.
Esse catálogo deve ser tratado como a vitrine oficial da empresa dentro do portal.
O catálogo não é destinado à criação de múltiplas listas temporárias ou sazonais. Em vez disso, o produtor deve manter e atualizar continuamente o catálogo existente, incluindo novos produtos ou categorias conforme sua produção evolui.
Boas práticas para o produtor
- manter o catálogo sempre atualizado;
- incluir novos produtos ou categorias quando necessário;
- utilizar o campo de disponibilidade para indicar produtos momentaneamente indisponíveis;
- revisar periodicamente os valores e observações.
Essa política tem como objetivos:
- manter a organização das informações no portal;
- facilitar a consulta pelos compradores;
- preservar a qualidade e a credibilidade do catálogo apresentado ao mercado.