Pular para o conteúdo principal

Emissão de Etiquetas

O endpoint /printtag é usado para buscar as etiquetas que forem disponibilizadas pelos Marketplaces.

Cada Marketplace tem formatos específicos nos quais é possível gerar as etiquetas.

  • AliExpress = PDF OU ZPL
  • Amazon = PDF e ZPL
  • Americanas Marketplace (B2W) = JSON ou PDF
  • Carrefour = PDF
  • Dafiti = PDF
  • Decathlon = PDL e ZPL
  • Digigrow = ZPL
  • Falabella = PDF e ZPL
  • Magalu = PDF e ZPL
  • Mercado Livre = ZPL2, ZPL, JSON e PDF
  • Netshoes = PDF e ZPL
  • Olist = ZPL
  • Paris = PDF
  • Ripley = PDF
  • Shopee = PDF OU ZPL
  • Shein = PDF
  • TikTok = PDF e ZPL
  • Via = PDF
  • Walmart = PDF e ZPL
aviso

Importante​

Não é possível reemitir uma etiqueta já gerada para os Marketplaces (AMAZON, MAGAZINE LUIZA E SHOPEE). Desta forma, quando a etiqueta do pedido já tiver sido gerada, o botão de ‘Emitir etiqueta’ não deve ficar disponível em tela, e via integração será gerado um erro 400 com uma mensagem no response bare "Etiqueta já emitida".

Para emitir uma etiqueta via API é necessário realizar um POST para o endpoint indicado abaixo, substituindo o {type} pelo formato desejado (PDF, ZPL, ZPL2, JSON) na URL: /v2/printtag/{type}

Quando o tipo for ZPL2, é possível informar em Parâmetros a expressão “file”, enviando "TXT", "PLP" ou "ZPL". Quando informado TXT é retornado um JSON com o conteúdo do TXT fornecido pelo Marketplace, quando informado PLP o retorno é um PDF com o PLP, quando é informado ZPL o retorno é somente os caracteres que compõem o ZPL da etiqueta.

4.png

Pontos de atenção sobre emissão de etiquetas para a Americanas Marketplace (B2W)​

A B2W possuí dois formatos disponíveis, JSON (necessário um decode por parte da integração) e PDF (é retornado um ZIP com os arquivos pronto para ser impresso sendo, etiqueta + pré-lista de postagem PLP).

Pontos de atenção sobre emissão de etiquetas para a Dafiti​

Ao consultar os detalhes do pedido (metadata), o seguinte campo constará no JSON: needInvoiceXML: true

Documentação para impressão de etiquetas

Para Dafiti Milkrun, o fluxo de impressão de etiquetas automaticamente emite o manifesto. Sendo assim, a última etapa de responsabilidade do seller, na modalidade Dafiti Milkrun, é a impressão de etiquetas. Após essa etapa a coleta do pacote do pedido estará em curso.

Ponto de atenção sobre emissão de etiquetas Shopee​

Não é possível escolher o formato da etiqueta da Shopee no ANYMARKET. O seller deve configurar no painel da Shopee o formato no qual deseja a emissão das etiquetas para que o ANYMARKET apenas replique.

Pontos de atenção sobre emissão de etiquetas para +1 volume​

Para fazer a emissão de mais de uma etiqueta para o pedido, será necessário enviar a quantidade de etiquetas desejadas no campo “number-of-packages” presente no “metadata” na atualização do pedido PUT “/v2/orders”, assim ao consultar a etiqueta no endpoint /v2/printtag/{type} será disponibilizada para download a quantidade de etiquetas desejada.

{
  "status": "INVOICED",
  "invoice": {
    "accessKey": "654215484654131321654685465461232135246546532131321"
    "series": "000001",
    "number": "12345678",
    "date": "2022-11-01T19:35:04-03:00",
  },
  "metadata": {
    "number-of-packages": "3",
  }
}
dica

Observação​

A opção de mais de uma etiqueta por pedido, está disponível apenas via API e alguns marketplaces, não sendo possível fazer essa emissão via tela.

O número dos pacotes não pode ser atualizado depois de incluso.