Histórico da Página

Objetivo

Permitir que o PDV imprima informações no comprovante da venda atual, como cupons de descontos e pontos na próxima compra.parceiro defina se o PDV irá imprimir o cupom de venda de forma parcial, total ou não imprimir.

Está operação ocorre no evento Finalização da VendaOs 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.

Os outros parâmetros são encontrados no Comando Desconto na no evento Finalização da 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 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:

Image RemovedImagem 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:

Image RemovedImagem 2

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

Image RemovedImagem 3

Exemplo de texto impresso no cupom:

Observação:
Independente do tipo de impressão utilizado, os comprovantes vinculados ao cupom serão impressos.

Request Exemplo

{
   "Event":"cetBefore",
   "Execution":"cetContinue",
   "ID":"001032000942052",
   "Operation":"cotEndSale",
   "Sale":{
      "Discount":0.0000000000000000E+000,
      "Header":{
         "AccountingDate":"2022-10-04T00:00:00",
         "DateTimeIssue":"2022-10-04T11:05:10",
         "IdDocument":942052,
         "IdInvoiceKey":"29221002768254000180658000000079629611081219",
         "IdStore":1,
         "IdTerminal":32,
         "IdUser":2,
         "Status":"sttValid"
      },
      "ID":"001032000942052",
      "Increase":0.0000000000000000E+000,
      "Items":[
         {
            "BarCode":"3",
            "CaptionPacking":"UN",
            "Description":"REFRIGPETFANTALARANJA2L",
            "DiscountPrice":0.0000000000000000E+000,
            "IdSegment":3,
            "IncreasePrice":0.0000000000000000E+000,
            "InternalCode":"3966",
            "ItemNumber":1,
            "PackingQuantity":1.0000000000000000E+000,
            "Quantity":1.0000000000000000E+000,
            "SellerCode":0,
            "Status":"sttValid",
            "TotalPrice":1.5000000000000000E+001,
            "UnitPrice":1.5000000000000000E+001
         },
         {
            "BarCode":"1",
            "CaptionPacking":"UN",
            "Description":"INSPREMISTPAOFRANVICATO25kg",
            "DiscountPrice":0.0000000000000000E+000,
            "IdSegment":3,
            "IncreasePrice":0.0000000000000000E+000,
            "InternalCode":"1752",
            "ItemNumber":2,
            "OrderNumber":"",
            "PackingQuantity":1.0000000000000000E+000,
            "Quantity":1.0000000000000000E+000,
            "SellerCode":0,
            "Status":"sttValid",
            "TotalPrice":5.8000000000000000E+001,
            "UnitPrice":5.8000000000000000E+001
         }
      ],
      "Payments":[
         {
            "Discount":0.0000000000000000E+000,
            "Increase":0.0000000000000000E+000,
            "InstallmentAmount":0,
            "ItemNumber":1,
            "PaymentNumber":1,
            "PaymentType":"cptMoney",
            "Total":7.3000000000000000E+001
         }
      ],
      "TaxDocument":{
         "Document":"<?xml version=\"1.0\"?>",
         "IdDocument":7962,
         "KindDocument":"65",
         "SerialNumber":"800",
         "URL":"http:\/\/nfcehomolog.sefaz.pe.gov.br\/nfce-web\/consultarNFCe"
      },
      "Total":7.3000000000000000E+001
   },
   "Version":1
}

Response Parceiro Exemplo

{
   "version":1,
   "sale":{
      "increase":0,
      "discount":0,
      "total":0,
      "items":[
         {
            "itemNumber":1,
            "unitPrice":0,
            "increasePrice":0,
            "packingQuantity":0,
            "quantity":0,
            "totalPrice":0,
            "discountPrice":1.5,
            "status":"sttValid",
            "sellerCode":0
         },
         {
            "itemNumber":2,
            "unitPrice":0,
            "increasePrice":0,
            "packingQuantity":0,
            "quantity":0,
            "totalPrice":0,
            "discountPrice":5.8,
            "status":"sttValid",
            "sellerCode":0
         }
      ],
      "print":{
         "printType":"cptPrintPartial"
      }
   },
   "execution":"cetCompleted"
}

Modelo de impressão completa("printType": "cptFull")

Veja que nesse exemplo todos os itens foram impresso no cupom

Image Added

Modelo de impressão parcial("printType": "cptPrintPartial")

Veja que nesse exemplo foi impresso apenas o cabeçalho é os valores pagos

Image Added

...