Gerador de Código de Pedido (Loja Online)

Códigos de pedido para loja online: identificadores multicanal que escalam

Quando uma loja online vende por vários canais — site próprio, app e um ou mais marketplaces — um único sequencial #0001 deixa de ser suficiente. O mesmo código pode colidir entre sistemas, o atendimento não enxerga de onde o pedido veio, e a conciliação com adquirentes vira tarefa manual. A resposta pragmática é um identificador com prefixo de canal: um código curto, URL-safe, alfanumérico, que codifica a origem, depois uma sequência ou timestamp, e opcionalmente um checksum.

ORD-W-000123     // site (web)
ORD-M-000124     // app mobile
ORD-ML-007821    // Mercado Livre
ORD-SH-004499    // Shopee
ORD-AM-128340    // Amazon
ORD-MG-099122    // Magalu (Magazine Luiza)

Hubs e integradores no mercado brasileiro

O e-commerce brasileiro depende muito de hubs agregadores que ingerem pedidos de vários marketplaces numa única interface tipo ERP. Bling, Tiny, Olist, Tray e Anymarket são os nomes dominantes. Cada hub atribui o próprio ID interno, e expõe ao lado dele o ID original do marketplace e o ID da sua plataforma de loja. Um único pedido pode carregar quatro identificadores ao mesmo tempo: o do marketplace (Mercado Livre, Shopee, Amazon), o do hub (Bling, Olist), o da loja (VTEX, Tray, Loja Integrada) e o do ERP (Bling, Omie, ContaAzul). Projetar o gerador com prefixo estável e rastreável desde o dia um economiza semanas de trabalho de detetive depois.

Ciclo do pedido e estados de pagamento no Brasil

O pedido online brasileiro percorre uma máquina de estados que reflete os meios de pagamento locais: aguardando pagamento → pago → em separação → enviado → entregue → finalizado — com ramos para cancelado e devolvido. PIX confirma em segundos, autorização de cartão é imediata mas captura pode ser diferida, e boleto bancário leva até três dias úteis para liquidar. Códigos de pedido fake usados em testes de integração devem cobrir cada transição de estado para o QA não depender de pagamento real liquidando.

{
  "orderCode": "ORD-W-000123",
  "channel": "site",
  "status": "em_separacao",
  "payment": { "method": "pix", "txid": "E12345..." },
  "shipping": { "carrier": "loggi", "tracking": "JT0012345BR" },
  "createdAt": "2026-05-29T14:22:11-03:00"
}

Integrações de frete: Correios, Loggi, J&T, Total Express

Quando o pedido sai para entrega, o código costuma ser pareado com um número de rastreio do transportador. Correios usa códigos de 13 caracteres terminando em BR (ex.: AA123456789BR); Loggi, J&T Express, Total Express, Jadlog e Mandaê têm cada um seu formato. Geradores de pedido fake são ideais para popular ambientes de teste com combinações realistas para que o dashboard, a página de rastreio na área do cliente e o template de notificação no WhatsApp possam ser revisados visualmente antes do lançamento.

Fraude, BI e restrições de formato por plataforma

• Antifraude (Konduto, ClearSale, Stone Antifraude) atribui score a cada pedido; o código é a chave de junção entre a API de feedback e o seu ERP.
• Dashboards BI em Power BI, Metabase ou Looker Studio normalmente fatiam por prefixo de canal — mais um motivo para manter o prefixo consistente.
• Stripe usa pi_, ch_, cs_; Magento default é sequencial de 9 dígitos; Shopify usa #1001 incrementando por loja. Escolha 10–15 caracteres totais para encaixar em todos sem atrito.
• UUIDs são válidos mas exagero para exibição ao cliente — longos demais para falar no telefone, sem padrão humano. Use UUID internamente e o código curto para exibir.
• Prefixo de teste: adicione TST- em ambientes não-produtivos para que um código vazado nunca colida acidentalmente com um real.

Perguntas frequentes

Devo usar prefixo diferente por canal? Sim, idealmente. Acelera o atendimento (o agente vê a origem sem consulta), permite fatiamento limpo em BI e evita colisões cross-canal nos raros casos em que sistemas são fundidos.

Qual o tamanho ideal? Dez a quinze caracteres no total. Curto o suficiente para ditar no telefone, longo o suficiente para manter entropia e evitar colisão em milhões de pedidos.

Posso usar só UUID? Tecnicamente sim, mas UUID tem 36 caracteres com hífens — longo demais para exibir ao cliente, difícil de ditar, sem informação de canal embutida. Use UUID internamente e código curto na camada voltada ao cliente.

Como evitar colisão entre marketplaces? Deixe o marketplace ser dono do ID nativo dele (do Mercado Livre, da Shopee) e adicione seu código curto interno por cima. Guarde os dois, busque por qualquer um, e o atendimento sempre ganha.