Associe marcadores ao criar um pedido via API

O que mudou

Antes, se você queria aplicar um marcador a um pedido criado via integração, precisava fazer isso depois — em um passo separado, manual ou via outra chamada.

Agora dá pra passar os marcadores diretamente na criação do pedido. O pedido já chega no dashboard com os marcadores aplicados, sem nenhuma etapa a mais.

Quando faz diferença

Se a sua integração já sabe, no momento do envio, como aquele pedido deve ser classificado — por tipo de produto, canal de venda, prioridade, origem — você pode mandar essa informação junto. O marcador aparece no dashboard na hora, sem depender de ninguém aplicar depois.

Como funciona

No payload de criação do pedido, inclua o campo tag_ids com os IDs dos marcadores que devem ser aplicados:

{
  "seller_identifier": "minha-loja-01",
  "orders": [
    {
      "external_id": "PED-9999",
      "tag_ids": [
        "a1b2c3d4-0000-0000-0000-111111111111"
      ]
    }
  ]
}

Para saber os IDs dos marcadores cadastrados na sua marca, use o endpoint de listagem antes de integrar. O campo tag_ids é opcional — pedidos sem marcador continuam funcionando normalmente.

📖 Veja os detalhes técnicos, exemplos e campos disponíveis na documentação: Criar pedido e Listar marcadores.