Comando Cupom Desconto da Venda

Filtros


Atalhos para busca

Objetivo

Permitir que o PDV imprima informações no comprovante da venda atual, como cupons de descontos e pontos na próxima compra.

Os comprovantes da venda serão sobrepostos sempre que mandar um novo comprovante para a aplicação, comprovantes que podem chegar com o PDV na operação subtotal e finalizar venda. A seguir exemplos de como executar esta operação.

PARÂMETRO TIPO OBRIGATÓRIO DESCRIÇÃO
Execution string true Tipo da execução cetContinue, cetInterrupt, cetFailed
Version string true Versão da API
Text TextString List true Texto que será exibido nos cupons impressos no final da compra

 

Os outros parâmetros são encontrados no Comando Desconto na Venda. Clique aqui e acesse a documentação.

Tags de impressão

Será possível a utilização de tags de impressão, que poderão ser envidas no Response nos parâmetros “vouchersPrint” e “text”, sendo elas:

  • [ImpExpandidoUmaLinha] – Início da impressão de texto estendido
  • [ImpFimExpandido] – Fim da impressão de texto estendido
  • [ImpNegrito] – Fim da impressão em negrito
  • [ImpFimNegrito] – Início da impressão em negrito
  • [ImpBarra] – Início da impressão de código de barras
  • [ImpFimBarra] – Fim da impressão de código de barras

Response Example

{
  "version": 1,
  "sale": {
    "items": [
      {
        "itemNumber": 1,
        "discountPrice": 8.59,
        "discountAmount": 1
      }
    ],
    
  },
  "vouchersPrint": [
    {
      "text": "  CUPOM DESCONTO 1rnrn   Cupom de 5% de desconto para rnpróximarncompra, aplicado para todos os rnprodutos.rnrn[ImpBarra]1234567891231[ImpFimBarra]"
    },
    {
      "text": "  CUPOM DESCONTO 2rnrn   Cupom de 10% de desconto para rnpróximarncompra, aplicado para todos os rnprodutos.rnrn[ImpBarra]1234567891231[ImpFimBarra]"
    }
  ]
}
}
}

Exemplo Fluxo Desconto e Cupom desconto

Início da venda no PDV, foi inserido um produto e teclado Enter. Após todos os produtos inseridos foi acionado a função para ir ao Subtotal da venda:

Imagem 1

JSON enviado ao parceiro:

{
  "Event": "cetBefore",
  "Execution": "cetContinue",
  "ID": "001600000590921",
  "Operation": "cotSubtotalSale",
  "Sale": {
    "Header": {
      "AccountingDate": "2020-01-22T00:00:00",
      "DateTimeIssue": "2020-01-22T14:15:36",
      "IdDocument": 590921,
      "Identification": [
        {
          "Document": "28142095823",
          "DocumentType": "cdtCPF"
        }
      ],
      
    },
    "ID": "001600000590921",
    "Items": [
      {
        "CaptionPacking": "UN",
        "Description": "COCA COLA",
        "InternalCode": "3988",
        "ItemNumber": 1,
        "PackingQuantity": 1.000,
        "Quantity": 5.000,
        
      }
    ]
  }
}

JSON retornado pelo parceiro com uma mensagem para o operador do PDV, nesse caso informa que o cliente ganhou 100 pontos na compra:

{
  "version": 1,
  "sale": {
    "items": [
      {
        "itemNumber": 1,
        "discountPrice": 0.499,
        "discountAmount": 1
      }
    ],
    "messages": {
      "customer": [
        {
          "text": "Ganhou desconto 100 nessa compra"
        }
      ],
      "user": [
        {
          "text": "Ganhou desconto 100 nessa compra"
        }
      ]
    },
    "vouchersPrint": [
      {
        "text": "  CUPOM DESCONTO 1rnrn   Cupom de 5% de desconto para rnpróximarncompra, aplicado para todos os rnprodutos.rnrn[ImpBarra]1234567891231[ImpFimBarra]"
      },
      {
        "text": "  CUPOM DESCONTO 2rnrn   Cupom de 10% de desconto para rnpróximarncompra, aplicado para todos os rnprodutos.rnrn[ImpBarra]1234567891231[ImpFimBarra]"
      }
    ]
  },
  "execution": "cetContinue",
  "interpret": {
    "commandType": "cctMessage",
    "messageCommand": {
      "title": "Cliente fidelidade",
      "text": "É um cliente fidelidade?",
      "defaultButton": "Sim",
      "messageType": "cmtConfirmation",
      "buttons": [
        {
          "caption": "Sim",
          "response": "1"
        },
        {
          "caption": "Não",
          "response": "2"
        }
      ]
    }
  }
}

Tela apresentada ao operador:

Imagem 2

Após finalização da venda conforme tela abaixo, será impresso o comprovante onde constará os cupons de desconto impressos:

Imagem 3

Exemplo de texto impresso no cupom:

Imagem 4
Este artigo foi útil para você?
Sim
Não
Confirmar que o artigo não foi útil