Marketplace In: etiquetas via operador logístico

O que é e para que serve

A funcionalidade de etiquetas via operador logístico permite que o envio das etiquetas seja feito diretamente pelo operador integrado, com recebimento automático pelo HUB.

Nesse modelo, o processo passa a ser padronizado, seguro e integrado ao fluxo de pedidos, eliminando a necessidade de ações manuais para geração ou importação de etiquetas.

Isso garante mais controle operacional, reduz erros e melhora a rastreabilidade por pedido e seller.

Como funciona na prática

O fluxo de etiquetas passa a operar de forma passiva, onde o operador logístico é responsável pelo envio, e o HUB realiza o processamento.

Na prática, o fluxo ocorre da seguinte forma: o operador envia a etiqueta, o HUB recebe essas informações, realiza a validação dos dados, vincula corretamente ao pedido, seller e marketplace-in, e então disponibiliza a etiqueta para uso.

Esse processo garante que a etiqueta esteja disponível no pedido já pronta para utilização, sem necessidade de intervenção manual.

Regras importantes e comportamento do sistema

O recebimento das etiquetas segue algumas regras importantes para garantir consistência e segurança.

As etiquetas recebidas precisam conter informações essenciais, como identificação do pedido, seller, marketplace-in e formato do arquivo. 

O sistema utiliza esses dados para validar e realizar o vínculo correto. Além disso:

  • o recebimento é feito de forma passiva, ou seja, depende do envio pelo operador logístico;
  • o sistema realiza validação e vínculo automático com o pedido correspondente;
  • há controle para evitar duplicidade de etiquetas para o mesmo pedido;
  • cada recebimento é registrado, incluindo sucesso ou motivo de recusa.

O acesso à funcionalidade é controlado por um escopo específico de API, garantindo que o operador tenha acesso apenas às rotas necessárias para envio das etiquetas.

Como configurar

Operador Logístico no painel

No painel administrativo, em Central do marketplace > Configurações, é possível configurar o operador logístico.

Nessa área, existe um box dedicado onde é possível:

  • criar credenciais de acesso para o operador;
  • visualizar informações de integração;
  • revogar credenciais quando necessário.

Essas credenciais são utilizadas pelo operador logístico para enviar as etiquetas ao HUB de forma autenticada.

Integração via API

A integração é realizada pela API do Marketplace-In, utilizando um escopo exclusivo de Operador Logístico.

Esse escopo garante que o operador tenha acesso apenas ao envio de etiquetas, sem permissão para outras operações da API.

As etiquetas devem ser enviadas contendo os dados necessários para identificação e vínculo, além do arquivo ou URL no formato suportado.

Como visualizar ou acompanhar

Após o recebimento, as etiquetas ficam disponíveis na área de pedidos.

Em Pedidos > Gerar etiquetas, o sistema passa a considerar também os marketplaces-in vinculados ao seller como origem de etiquetas.

As etiquetas podem ser visualizadas e baixadas conforme o formato configurado no canal, como:

  • PDF;
  • ZPL;
  • PNG.

Isso permite centralizar o acesso às etiquetas dentro do fluxo padrão de pedidos.

Observações importantes e limitações

O envio das etiquetas depende da integração com o operador logístico. Caso o operador não envie a informação, o HUB não realiza a geração automaticamente.

A identificação correta do pedido e do seller é essencial para que o vínculo seja realizado com sucesso. Em alguns casos, pode ser necessário considerar dados adicionais, como CNPJ.

A funcionalidade evita o armazenamento duplicado de etiquetas, garantindo que cada pedido tenha apenas os arquivos válidos associados.

Esse modelo traz mais padronização, segurança e escalabilidade para o gerenciamento de etiquetas no Marketplace-In.

Dúvidas?

Acesse o Help Center para saber mais sobre o Hub de Marketplaces da Uappi!

Leave a Reply

Your email address will not be published. Required fields are marked *