Skip to main content
HomeBlogGuiasUma API de rastreamento pode funcionar sem etiquetas de envio? Rastrear pedidos de 3Pl e de marketplaces?

Uma API de rastreamento pode funcionar sem etiquetas de envio? Rastrear pedidos de 3Pl e de marketplaces?

17TRACK

Sim. Uma API de rastreamento pode funcionar sem que sua empresa crie etiquetas de envio, desde que uma transportadora ou um parceiro de envio tenha criado uma remessa rastreável e você possa obter um número de rastreamento utilizável ou outro identificador compatível com a API. Isso é comum quando um operador logístico terceirizado (3PL) ou um marketplace gerencia o fulfillment. A distinção é entre não comprar você mesmo a etiqueta e não ter nenhum identificador de remessa: o primeiro geralmente é viável; o segundo pode deixar a API sem nada para rastrear.

Uma API de rastreamento pode funcionar sem etiquetas de envio Rastreamento 3PL

Para um vendedor, operador de marketplace ou equipe de integração, o trabalho prático é conectar cada pedido à remessa criada pela parte que realmente faz o envio. Isso exige acesso aos dados corretos, não necessariamente controle sobre a criação da etiqueta.

Do que uma API de rastreamento precisa quando você não cria a etiqueta

Uma etiqueta de envio é uma forma de produzir um identificador de remessa, mas normalmente não é o dado de entrada lido por uma API de rastreamento. As integrações de rastreamento geralmente funcionam com base nos dados da remessa fornecidos depois que uma etiqueta foi criada em outro sistema. Antes de projetar a conexão, separe três registros que muitas vezes são tratados como intercambiáveis:

  • ID do pedido: Identifica uma compra em sua loja, conta do marketplace ou sistema de gerenciamento de pedidos. Pode abranger vários itens e várias remessas.
  • ID de fulfillment ou pacote: Identifica uma ação de fulfillment ou um pacote em um sistema de 3PL ou marketplace. Seu formato e significado dependem desse sistema.
  • Número de rastreamento da transportadora: Identifica uma remessa para fins de rastreamento, sujeito à aceitação pela transportadora e pelo serviço de rastreamento.

Seu ID interno do pedido ajuda a encontrar o pedido correto do cliente. Ele não funciona automaticamente como um número de rastreamento da transportadora. O padrão usual de integração é obter o número de rastreamento do 3PL ou marketplace, registrar ou consultar esse número por meio da API de rastreamento e armazenar as informações da remessa retornadas junto ao pedido ou pacote correspondente.

Também pode ser necessário o nome ou código da transportadora. Alguns serviços podem tentar detectar a transportadora, mas isso deve ser testado, não presumido, especialmente quando os identificadores se sobrepõem entre transportadoras ou quando um pedido passa por várias redes de entrega. Consulte a documentação da API sobre identificadores aceitos, regras de seleção da transportadora, requisitos de registro e campos de status antes de iniciar uma implementação.

Rastreamento de pedidos enviados por um 3PL

Quando um 3PL embala um pedido, compra a etiqueta e entrega o pacote a uma transportadora, sua empresa talvez nunca veja a própria etiqueta. Ainda assim, você precisa dos detalhes da remessa resultantes desse processo. Pergunte ao 3PL qual sistema ou feed disponibiliza os números de rastreamento, as informações da transportadora, os identificadores dos pacotes e a referência do pedido fornecida por você ao solicitar o fulfillment.

Um fluxo viável de 3PL geralmente funciona assim:

  1. Envie o pedido e uma referência estável ao 3PL por meio do seu processo de fulfillment existente.
  2. Receba uma confirmação de fulfillment contendo o número de rastreamento no nível do pacote e, quando disponível, a transportadora.
  3. Associe esse pacote ao pedido e aos itens corretos do cliente.
  4. Envie o identificador de remessa compatível para sua API de rastreamento ou use o processo de consulta indicado pela API.
  5. Registre as atualizações de rastreamento no pacote e apresente uma visão no nível do pedido à sua equipe de operações ou ao cliente.

A etapa de associação merece atenção especial. Um único pedido pode sair do armazém em duas caixas, ou um item pode ser enviado depois dos demais. Em qualquer um dos casos, não há um único status de pacote que descreva com precisão todo o pedido. Mantenha registros no nível do pacote e derive deles qualquer mensagem no nível do pedido. Por exemplo, não marque um pedido como entregue apenas porque o primeiro pacote foi entregue.

Combine com o 3PL como as correções serão enviadas. Etiquetas podem ser anuladas, pacotes podem ser reembalados e um número de rastreamento inicial pode ser substituído. Sua integração deve conseguir associar a substituição ao mesmo pedido sem exibir indefinidamente os dois números como remessas ativas.

Rastreamento de pedidos de marketplace quando o marketplace controla o envio

O fulfillment de marketplaces apresenta uma questão técnica semelhante, mas uma questão de acesso diferente. O marketplace ou seu parceiro de fulfillment pode criar a etiqueta, enquanto o vendedor talvez receba apenas os detalhes de envio que sua conta, fluxo de pedidos ou integração autorizada disponibiliza. Uma API de rastreamento não pode compensar um número de rastreamento que o marketplace não disponibilizou para você.

Comece identificando o modelo de fulfillment de cada pedido. Para pedidos enviados pelo vendedor, seu próprio fluxo de envio ou 3PL pode ser a fonte dos dados do pacote. Para pedidos processados pelo marketplace, o marketplace pode ser a fonte das informações da remessa, e os campos disponíveis para o vendedor podem ser diferentes. Não presuma que uma página de pedido que mostra um status de entrega também forneça um número de rastreamento da transportadora adequado para registro em uma API separada.

Se o marketplace fornecer um número rastreável, confirme se você tem permissão para recuperá-lo e usá-lo no sistema pretendido. Em seguida, teste se a API de rastreamento aceita esse identificador e se os eventos resultantes acrescentam informações úteis além do status do marketplace. Se o marketplace expuser apenas sua própria referência de pedido ou entrega, verifique se há um método de consulta explicitamente compatível. Não envie um ID interno de pedido do marketplace como se fosse um número da transportadora e espere resultados confiáveis.

Mantenha separados o estado do pedido no marketplace e o estado da remessa na API de rastreamento. Um marketplace pode descrever um pedido como enviado assim que o fulfillment for confirmado, enquanto o rastreamento da transportadora ainda pode não mostrar uma leitura de aceitação. Esses registros respondem a perguntas diferentes e podem ser atualizados em momentos distintos.

Quando o rastreamento sem etiquetas não resolverá o problema

“Nenhuma etiqueta criada por nós” não é um bloqueio. As situações a seguir podem ser:

  • Nenhuma remessa foi criada: Antes que o fulfillment gere um identificador utilizável, pode não haver uma remessa da transportadora para consultar. Uma confirmação de pedido, por si só, não comprova que há um pacote em trânsito.
  • O identificador não está disponível para você: Um 3PL ou marketplace pode manter o número sem expô-lo por meio do seu fluxo autorizado. Resolva esse problema de acesso aos dados na origem.
  • O identificador não é compatível: Um número de referência, código exclusivo do marketplace ou formato de transportadora não compatível pode não funcionar com a API selecionada. Verifique as entradas aceitas na documentação e com uma remessa de teste.
  • O pacote ainda não tem uma nova leitura: Um número pode existir antes que a transportadora registre um evento de aceitação. Trate um resultado vazio ou inalterado como um estado a ser investigado, não como prova automática de que o número é inválido.
  • O rastreamento é restrito ou incompleto: A transportadora, o serviço ou o fluxo da remessa pode não fornecer os eventos exigidos pelo seu caso de uso voltado ao cliente. Confirme a qualidade real dos eventos usando remessas representativas.

Esses limites são importantes porque uma API não pode criar eventos físicos ausentes nem conceder acesso aos dados de pedidos de outra parte. Seu valor está em recuperar e organizar informações de rastreamento compatíveis quando o identificador necessário e as permissões já existem.

Como avaliar uma API para esse fluxo

A Tracking API da 17TRACK é uma opção relevante a ser investigada quando sua equipe precisa de dados de rastreamento de remessas em seus próprios sistemas, e não de uma ferramenta para comprar etiquetas. A documentação para desenvolvedores é o local para verificar os campos de registro aceitos, as transportadoras compatíveis, a estrutura das respostas, a autenticação e os métodos disponíveis de entrega de atualizações para seu caso de uso. Não deduza que há suporte a um 3PL, marketplace ou identificador proprietário específico apenas pela existência de uma API geral de rastreamento.

Crie um pequeno conjunto de testes antes de selecionar ou implantar qualquer provedor. Inclua um pedido de 3PL com um número da transportadora, um pedido de marketplace para o qual sua conta disponibilize um número, um pedido com vários pacotes, um número criado antes da primeira leitura e uma remessa com um evento de entrega posterior. Se substituições ou transferências internacionais forem comuns, inclua-as também. O teste deve responder a perguntas operacionais, não apenas verificar se uma solicitação retorna uma resposta HTTP bem-sucedida:

  • Você consegue enviar os identificadores que realmente recebe sem reescrevê-los manualmente?
  • Consegue associar cada registro de rastreamento de forma confiável ao pedido e pacote corretos?
  • As descrições dos eventos, os horários e as informações da transportadora são suficientes para suas mensagens aos clientes e fluxos de suporte?
  • Como seu sistema lidará com atualizações duplicadas, eventos ausentes, alterações de número e solicitações com falha?
  • O uso pretendido dos dados do marketplace e dos clientes está em conformidade com os termos de acesso aplicáveis a esses dados?

Para a integração em si, preserve tanto o registro original da fonte quanto o registro da API de rastreamento. Armazene a referência do pedido, a referência do pacote, o número de rastreamento enviado, as informações da transportadora, se disponíveis, e o horário em que cada atualização foi recebida. Isso facilita a investigação de divergências sem apresentar um evento da API como se fosse o histórico completo de fulfillment. Se a API oferecer a opção entre verificar em uma programação e receber atualizações por meio de um mecanismo de entrega compatível, escolha com base no comportamento documentado e na sua necessidade de atualizações oportunas; nenhuma das abordagens elimina a necessidade de tratamento de erros.

A decisão prática

Use uma API de rastreamento sem criar etiquetas quando outra parte enviar o pacote e fornecer um identificador de remessa compatível que você esteja autorizado a usar. Primeiro, obtenha um feed confiável de dados dos pacotes do 3PL ou marketplace. Depois, teste os identificadores e os eventos de rastreamento com a API e com sua lógica de associação de pedidos. Se você tiver apenas um ID de pedido ou um status do marketplace, resolva essa lacuna nos dados de origem antes de investir em uma integração de rastreamento de transportadora.

Perguntas frequentes

Posso rastrear um pedido usando apenas o número do pedido da minha loja?

Geralmente não por meio de uma API de rastreamento de transportadora. O número do pedido da sua loja identifica a compra no seu sistema. Em geral, você precisa do identificador de remessa correspondente, a menos que o serviço específico ofereça explicitamente suporte à consulta pelo seu tipo de referência de pedido.

Preciso da permissão do 3PL para usar seus números de rastreamento?

Confirme seu acesso contratual e técnico aos dados da remessa. Um 3PL pode já retornar números de rastreamento como parte do feed de fulfillment, mas a integração deve usar um canal autorizado e tratar os dados dos clientes de forma adequada.

Por que a API não mostra movimentação depois que o 3PL envia um número?

O número pode ter sido criado antes da primeira leitura registrada pela transportadora. Verifique se o identificador e a transportadora estão corretos, se a etiqueta original foi substituída e se uma consulta posterior produz eventos. Não associe “ainda não há leitura” a “não foi enviado” sem verificar o registro de fulfillment.

E se um pedido do marketplace for enviado em vários pacotes?

Rastreie separadamente cada identificador de pacote disponível e associe todos os pacotes ao mesmo pedido. Mantenha o status do pedido voltado ao cliente separado do status de cada pacote, para que um pacote entregue não faça o pedido inteiro parecer concluído.

Fontes