Árvore de páginas

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ÂMETROTIPOOBRIGATÓRIODESCRIÇÃO
ExecutionstringtrueTipo da execução cetContinue, cetInterrupt, cetFailed
VersionstringtrueVersão da API
TextTextString ListtrueTexto que será exibido nos cupons impressos no final da compra

Os outros parâmetros são encontrados no Comando Desconto na VendaClique 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 para emissão do Cupom adicional

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