Transmitir para parceiros
Transmitir para parceiros envia os metadados ONIX dos seus títulos, e opcionalmente suas imagens de capa, diretamente ao servidor FTP, FTPS ou SFTP de um parceiro comercial. Você define cada parceiro uma vez por catálogo (endereço, credenciais, caminhos, nomenclatura do arquivo), testa a conexão e depois transmite a seleção atual ou os resultados da pesquisa em um clique. A transferência é executada como uma tarefa em segundo plano, então você pode continuar trabalhando enquanto o arquivo é gerado e enviado.
Onde encontrar
- Na lista de títulos, abra a lista suspensa Ações e escolha Transmitir para parceiros. A caixa de diálogo está disponível em catálogos ONIX 2.1 e ONIX 3.0 igualmente, para todo usuário que pode abrir a lista.
- Os parceiros pertencem ao catálogo atual: um parceiro definido em um catálogo não é listado em outro.
- O resultado de cada transmissão aparece no menu Notificações da barra superior (veja O espaço de trabalho).
Visão geral da tela
A caixa de diálogo lista seus parceiros em duas tabelas. A tabela Ações de FTP (Nome, endereço FTP, uma caixa de seleção por linha) contém os parceiros FTP, FTPS e SFTP: Adicionar um novo parceiro abre o formulário do parceiro, e Editar e Excluir aparecem nos parceiros criados no ONIXEDIT Cloud. A tabela Ações de POST (URL, Legenda EN, Legenda FR) contém os pontos de acesso HTTP descritos abaixo, com Nova ação POST, Editar e Excluir. O botão Transmitir [[NÚMERO]] título(s) aos parceiros selecionados fica desativado até que pelo menos uma linha de uma das tabelas seja marcada; o número é o tamanho da sua seleção, ou o número de títulos da lista quando nada está selecionado.
Como definir um parceiro
Na caixa de diálogo, clique em Adicionar um novo parceiro (ou em Editar em uma linha existente).
Preencha a conexão:
Campo O que informar Nome do Destinatário Um nome para o parceiro; obrigatório. Tipo de conexão FTP/FTPS ou SFTP. Endereço O nome do host ou o endereço IP, com uma porta opcional após dois-pontos ( ftp.example.com:2121). Um valor inválido mostra Endereço de servidor inválido.Nome do usuário / Senha As credenciais fornecidas pelo seu parceiro. FTP explícito sobre TLS Marque quando o parceiro exige FTPS com TLS explícito. Transferência Passiva Marque quando o parceiro exige o modo passivo (habitual atrás de firewalls). Caminho remoto para arquivo ONIX A pasta no servidor para onde vai o arquivo ONIX, por exemplo /Path/To/ONIX.Versão ONIX 3 Apenas catálogos ONIX 3.0: ONIX 3.0 ou ONIX 3.1 para o arquivo enviado a este parceiro. No cartão Nome do arquivo, escolha como o arquivo é nomeado (veja abaixo).
No cartão Imagens de capa, marque Copiar imagens de capa se o parceiro quiser as imagens como arquivos. O cartão então ativa Caminho remoto para imagens (pré-preenchido com o caminho ONIX), Máscara de nome de imagem (pré-preenchida com
[ISBN13]) e Mantenha apenas o link da imagem de capa no arquivo ONIX.Clique em Conexão de teste. Uma mensagem verde Conexão bem-sucedida ou vermelha Falha na conexão aparece; Cancelar interrompe um teste que trava.
Clique em OK para salvar o parceiro.
Como nomear o arquivo ONIX
O cartão Nome do arquivo oferece três opções:
- Máscara de nome de arquivo — um nome fixo composto de quaisquer caracteres válidos e tokens, sem a extensão, por exemplo
Prefix_[yyyyMMdd]_Suffix. Clique em Tokens para inserir um token de data ([yyyyMMdd],[ddMMyyyy],[yyyy-M-d],[yyyy]…), um token de data e hora ([yyyyMMddHHmm]…) ou um token de data, hora e segundos ([yyyyMMddHHmmss]…), nas ordens de dia, mês e ano que você preferir. - Pedir nome do arquivo — a máscara fica desativada e o ONIXEDIT Cloud pede um nome a você a cada transmissão (veja abaixo).
- Use a convenção de nome de arquivo e extensão TitlePage (.XOT e .COT) — o arquivo é enviado com a extensão
.XOTe renomeado para.COTquando a transferência termina, como o TitlePage exige. Esta opção precisa de um carimbo de data e hora completo: um token só de data na máscara é substituído por[ddMMyyyyHHmmss], e esse token é acrescentado quando a máscara não tem nenhum. Ela também desativa Pedir nome do arquivo.
O botão Tokens da Máscara de nome de imagem oferece [ISBN10], [ISBN13], [EAN], [REF] (referência de registro) e [Original-Filename].
Como transmitir títulos
- Selecione os títulos na lista ou execute uma pesquisa; sem nenhum dos dois, o catálogo inteiro é enviado.
- Abra Ações e escolha Transmitir para parceiros.
- Marque os parceiros de destino e clique em Transmitir [[NÚMERO]] título(s) aos parceiros selecionados.
- Para cada parceiro configurado com Pedir nome do arquivo, a caixa de diálogo Digite um nome de arquivo para abre com o nome do parceiro: digite o Nome do arquivo (sem extensão), insira Tokens se quiser e clique em Enviar ao parceiro.
- A caixa de diálogo fecha e uma tarefa Transmissão para parceiros entra na fila. Acompanhe-a no menu Notificações; uma transferência com falha mostra Mais detalhes com o motivo.
Um arquivo ONIX é gerado por parceiro, no formato do catálogo (ONIX 2.1, ou a Versão ONIX 3 escolhida para o parceiro em um catálogo ONIX 3.0), e enviado ao Caminho remoto para arquivo ONIX do parceiro. Quando Copiar imagens de capa está ativado, as imagens dos títulos transmitidos são enviadas ao Caminho remoto para imagens sob sua Máscara de nome de imagem.
Ações POST
Uma ação POST é um parceiro acessado por HTTP em vez de FTP: o ONIXEDIT Cloud posta um campo de cada título (sua referência de registro, ISBN13, EAN, ONIX_NOSEQ, um campo personalizado ou outra tag ONIX) na URL que você informa — a forma como uma loja virtual ou a API de um distribuidor recebe pedidos de novos títulos. As ações POST são definidas na tabela Ações de POST da caixa de diálogo Transmitir para parceiros e podem ser iniciadas de lá, marcadas como um parceiro FTP, ou a partir da lista suspensa Ações da lista de títulos.
Como definir uma ação POST
Na caixa de diálogo, clique em Nova ação POST (ou em Editar em uma linha existente).
Preencha o formulário POST Action:
Campo O que informar Caption EN / Caption FR O nome da ação como aparece na lista suspensa Ações, em inglês e em francês; o idioma da interface escolhe o que é exibido. HTTP POST A URL que recebe a solicitação. Field O valor postado para cada título: Record Reference, ISBN13, EAN, ONIX_NOSEQ, ONIXEDIT campo personalizado ou Outra etiqueta ONIX. Body O nome do campo personalizado ou a ONIX Tag a postar, quando Field é um dos dois últimos. Titles Selection Quais títulos o parceiro aceita: Selected Titles Only (a ação precisa de uma seleção), All or Selected Titles (seleção, pesquisa ou catálogo inteiro) ou No Title Required (a solicitação é enviada sem títulos). Clique em OK. Excluir em uma linha pergunta Você realmente deseja remover esta ação POST da lista? antes de removê-la.
Como postar títulos
- A partir da caixa de diálogo: marque a ação POST (e qualquer parceiro FTP) e clique em Transmitir, como para uma transmissão FTP.
- A partir da lista de títulos: quando o catálogo tem pelo menos uma ação POST, a lista suspensa Ações termina com Postar produtos selecionados para seguido da legenda de cada ação. Escolha uma e confirme; a confirmação indica o escopo — a seleção atual com sua contagem, a pesquisa atual ou o catálogo inteiro até o limite da tarefa (veja Ações sobre os títulos).
De qualquer forma, uma tarefa Transmissão para parceiros entra na fila e é acompanhada no menu Notificações.
Dicas
Amazon e imagens de capa
Quando o endereço contém "amazon" e Copiar imagens de capa está ativado, o ONIXEDIT Cloud propõe marcar Mantenha apenas o link da imagem de capa no arquivo ONIX. porque a Amazon lida mal com miniaturas de capa copiadas.
Teste antes de transmitir
Um caminho ou uma senha errados só aparecem como uma tarefa com falha minutos depois. Use Conexão de teste sempre que alterar o endereço, as credenciais ou o tipo de conexão.
Perguntas frequentes
Quais títulos são transmitidos?
Os títulos que você marcou na lista. Sem seleção, os resultados da pesquisa atual são enviados e, sem pesquisa também, o catálogo inteiro. O botão Transmitir mostra o número antes de você confirmar.
Preciso criar um arquivo ONIX antes?
Não. A transmissão é uma tarefa em segundo plano que gera o arquivo ONIX para cada parceiro selecionado e o envia, junto com as imagens de capa se o parceiro as pedir.
Posso enviar ONIX 3.1 a um parceiro e ONIX 3.0 a outro?
Sim. Em um catálogo ONIX 3.0, cada parceiro tem sua própria configuração de versão ONIX 3. Em um catálogo ONIX 2.1, o arquivo é sempre ONIX 2.1.
Por que não consigo editar ou excluir um parceiro?
Os parceiros FTP que foram configurados fora do ONIXEDIT Cloud são listados apenas para transmissão. Editar e Excluir são oferecidos nos parceiros e nas ações POST criados aqui.
Como sei se a transmissão funcionou?
Abra o menu Notificações da barra superior. A tarefa Transmissão para parceiros mostra seu andamento, seu resultado e, em caso de falha, os detalhes do erro.