Retirada (Clique e Retire)

QR Code estático de retirada

Retorna a imagem PNG do QR Code estático de Clique e Retire da filial, para usar em cartazes e adesivos no ponto de venda.

Header obrigatório. Toda chamada exige o header x-abbiamo-seller-group-key. Preencha-o no canto superior direito desta página ou veja como obter a sua chave.

Rate limit: 300 requisições por minuto por chave. Acima disso a API retorna HTTP 429.

Este endpoint devolve a imagem PNG do QR Code estático de retirada de uma filial. É o QR que vai nos materiais de Clique e Retire expostos no ponto de venda — o cliente escaneia no balcão para iniciar a jornada de autoatendimento de retirada.

O QR é fixo por filial: gere uma vez e reutilize em todos os cartazes e adesivos daquela loja. A filial é identificada pelo identifier na URL (o mesmo seller_identifier usado na criação de pedidos) e precisa pertencer ao seller group autenticado.

O QR escopa a busca pela filial. Quando o cliente escaneia este QR e informa o código de rastreio, a jornada de retirada só encontra pedidos de retirada (TAKEOUT) daquela filial, criados nos últimos 3 meses. Por isso o material é por filial: se a sua bandeira tem mais de uma filial, gere um QR por filial — um QR único da bandeira só acharia os pedidos de uma única filial.

A resposta é binária (image/png). Salve o corpo da resposta direto como arquivo .png, ou embuta a imagem no seu material de impressão.

A requisição falha com 403 se a filial informada não pertencer ao seller group autenticado, e com 404 se nenhuma filial for encontrada para o identifier.

GET
/v1/takeout/seller/{identifier}/static-qrcode

Authorization

sellerGroupKey
x-abbiamo-seller-group-key<token>

In: header

Path Parameters

identifier*string

Identificador da filial — o mesmo seller_identifier usado na criação de pedidos. Default: documento (CNPJ) da filial.

Response Body

image/png

application/json

application/json

application/json

curl -X GET "https://example.com/v1/takeout/seller/string/static-qrcode"
"string"
{
  "message": "Unauthorized"
}
{
  "message": "Given seller does not belong to seller group",
  "code": "SELLER_NOT_IN_SELLER_GROUP",
  "status": "FORBIDDEN"
}
{
  "message": "Seller not found",
  "code": "SELLER_NOT_FOUND",
  "status": "NOT_FOUND"
}