Inicio
Documentação
Recursos
Parcerias
Comunidade

Recursos

Confira as atualizaçÔes das nossas soluçÔes e do funcionamento do sistema ou peça suporte técnico.

Parcerias

Conheça nosso programa para agĂȘncias ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratĂĄ-los.

Comunidade

Fique por dentro das Ășltimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Configurar impressÔes - Integrar via API para Ponto de Venda - Mercado Pago Developers

Configurar impressÔes

A API de ImpressÔes permite integrar seus sistemas para gerenciar impressÔes nas terminais Point configuradas. Este recurso possibilita imprimir imagens personalizadas diretamente de um ponto de venda (PDV), utilizando a impressora integrada dos dispositivos Smart.

Utilize os endpoints abaixo para gerenciar a fila de impressÔes, levando em conta as especificaçÔes de cada endpoint. Garanta que o terminal esteja corretamente configurado no modo PDV (Ponto de Venda).

Para a impressão de imagens, tenha em mente que os formatos aceitos são PNG ou JPEG, com codificação Base64 e um tamanho måximo de 1MB. As imagens que excederem as dimensÔes do rolo de papel serão ajustadas automaticamente.
  • Criar ação da terminal: Permite a criação de uma nova ação de impressĂŁo para Mercado Pago Point, seja de imagens ou impressĂ”es personalizadas. Em caso de sucesso, a resposta devolverĂĄ um cĂłdigo de status 201.
  • Obter ação por ID: Permite consultar todas as informaçÔes da ação de impressĂŁo criada para uma terminal Point atravĂ©s do ID obtido na resposta Ă  sua criação. A consulta da ação de impressĂŁo fornece uma ferramenta prĂĄtica para verificar a ação enviada pela API, especialmente no caso de falhas de impressĂŁo na terminal.
  • Cancelar ação por ID: Permite cancelar uma ação criada para Mercado Pago Point e suas transaçÔes utilizando o ID de referĂȘncia obtido na resposta Ă  sua criação. Apenas uma ação com status created pode ser cancelada. Em caso de sucesso, a solicitação devolverĂĄ uma resposta com status 200.

Aguarde até que a tentativa chegue ao terminal e a impressão seja processada. Se a impressão não chegar automaticamente, pressione o botão Atualizar para buscar a tentativa manualmente.

Tags personalizadas

As tags personalizadas permitem ajustar o formato e a aparĂȘncia dos documentos impressos, garantindo maior controle sobre o estilo e a estrutura do texto. Elas devem ser utilizadas ao enviar um POST ao endpoint Criar ação do terminal, atravĂ©s do atributo subtype, que deve ser configurado como custom. Quando o subtype Ă© definido como custom, o atributo content deve incluir a string formatada utilizando as tags suportadas.

A seguir, consulte as diferentes tags disponíveis, suas funçÔes e exemplos de uso:

As ,[object Object], personalizadas tĂȘm um limite mĂ­nimo de 100 caracteres e um mĂĄximo de 4096 caracteres, incluindo elas prĂłprias.
TagFunçãoExemplo
{b}Negrito{b}Texto em negrito{/b}
{w}Letra grande{w}Texto em letra grande{/w}
{s}Letra pequena{s}Texto em letra pequena{/s}
{br}Quebra de linha{br}
{left}Alinhar Ă  esquerda{left}Texto alinhado Ă  esquerda{/left}
{center}Centralizar texto{center}Texto centralizado{/center}
{qr}Imprimir um QR que representa o texto enviado{qr}Texto{/qr}
{pdf417}Imprimir a mancha de um TED{pdf417}Texto{/pdf417}

Exemplo de utilização:

plain

{
  "type": "print",
  "config": {
    "point": {
      "terminal_id": "{{device.id}}",
      "subtype": "custom"
    }
  },
  "external_reference": "8a42e06e45d5",
  "content": "{br}--------------------------------{br}{center}{w} COMPROVANTE DE ENTREGA{/w}{br}{br}{s} Nro pedido :12345{/s}{br}{s} Loja: Loja de teste{/s}{br}--------------------------------{br}{s}***ITEM(S) DESPACHO***{/s}{br}{s}SKU / ARTIGO                     QUANTIDADE   {/s}{br}{s}----------------------------------------------{/s}{br}{s}4065432630504 / BOLA FUTEBOL WUCL LGE EHV240424   1{br}{s}ENTREGAR: 06/06/2024{/s}{br}{s}ENDEREÇO: METROPOLITANA  {/s}{br}{s}RECEBE: John{/s}{br}{s}entrega ao cliente no período da manhã{/s}{br}--------------------------------{br}"
}