Histórico da Página

Objetivo

Integrar o PDV com cancelas de estacionamento para abono de tickets. No fnal da venda o PDV poderá imprimir o comprovante de abono, esta impressão é opcional.

O parceiro pode configurar uma mensagem, por exemplo, solicitando o número do ticket de estacionamento e realizar todo o processo para liberação da cancela.

O PDV precisa estar com a operação de finalização da venda, na operação de Início da venda e Subtotal da venda não será aplicado, pois a validação de ticket é realizado no final, quando há uma finalização de cupom.

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

Informações adicionais sobre o ticket de estacionamento podem ser encontradas no no Comando Cupom 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,
"execution""cetCompleted",
"vouchersPrint"[
    {
"text"" RECEBO TICKET ESTACIONAMENTOrnrn N. 12345678901234, liberado até 20 00 horasrn"    },
    {
"text"" RECEBO TICKET ESTACIONAMENTOrnrn N. 12345678901234, liberado até 20 00 horasrn"    }
  ]
}

Exemplo Fluxo de Abono no Ticket de Estacionamento

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

Image Added

Image RemovedImagem 1 – Tela Pagamento

A API PDV requisitará para o integrador (parceiro) qual ação deverá ser executada, informando o ciclo da operação que ele está “Operation”, a identificação única da operação/documento “ID”, se a ação será executada antes ou após o evento “Event”, qual a versão da API “Version”, informações sobre a venda com “Header”, “ID” e “Total”. Em “ParkingTicket” haverá duas informações opcionais, que são, “ParkingCourtesy” e “ParkingCust”.

ParkingCourtesy trará as informações de cortesia do ticket, por exemplo, se a venda do cliente for acima de R$15,00 ele tem estacionamento livre por 60 minutos, conforme JSON abaixo.
ParkingCust trará as informações de valores do ticket, por exemplo, se o cliente permanecer até
60 minutos o valor do ticket será de R$3,00, conforme JSON abaixo.
Lembrando que essas informações são configuradas pelo sistema do cliente e são OPCIONAIS.

JSON enviado ao parceiro
{

  "Version"1,
  "Event""cetAfter",
  "Execution""cetContinue",
  "ID""001001000154775",
  "Operation""cotParkingTicketEndSale",
  "Sale"{
    "Header"{
      "AccountingDate""2020-02-14T00 00 00",
      "DateTimeIssue""2020-02-14T08 42 29",
      "IdDocument"154775,
      "IdStore"1,
      "IdTerminal"1,
      "IdUser"2,
      "Status""sttValid"
    },
    "ID""001001000154775",
    "Total"11.98
  },
  "ParkingTicket"{
    "ParkingCourtesy"[
      {
        "MinutesFree"0,
        "SaleValue"5.00,
        "TarifCode""0"
      },
      {
        "MinutesFree"60,
        "SaleValue"15.00,
        "TarifCode""1"
      },
      {
        "MinutesFree"120,
        "SaleValue"20.00,
        "TarifCode""1"
      }
    ],
    "ParkingCust"[
      {
        "MinutesRate"60,
        "PeriodCust"3.00
      },
      {
        "MinutesRate"120,
        "PeriodCust"6.00
      },
      {
        "MinutesRate"240,
        "PeriodCust"9.00
      },
      {
        "MinutesRate"9999,
        "PeriodCust"5.00
      }
    ]
  }
}

JSON retornado pelo parceiro com uma solicitação de valor
{

  "version"1,
  "execution""cetContinue",
  "interpret"{
    "commandType""cctGetValue",
    "value"{
      "title""Ticket de estacionamento",
      "subtitle""Informe o número",
      "dataType""cvtString",
      "size"14
    }
  }
}

Tela apresentada ao operador. 

Image RemovedImagem 2 – Tela de Pagamento

JSON enviado ao parceiro

{
  "Version"1"Event""cetAfter",
  "Execution""cetContinue",
  "ID""001001000154775",
  "Operation""cotParkingTicketEndSale",
  "Response""12345678901234"
}

Tela apresentada ao operador. 

Image RemovedImagem 3 – Tela de Pagamento

JSON retornado pelo parceiro

{
  "version"1,
  "execution""cetCompleted",
  "vouchersPrint"[
    {
      "text"" RECEBO TICKET ESTACIONAMENTO\r\n\r\n N. 12345678901234, liberado até 20 00 horas\r\n"
    },
    {
      "text"" RECEBO TICKET ESTACIONAMENTO\r\n\r\n N. 12345678901234, liberado até 20 00 horas\r\n"
    }
  ]
}

Exemplo de texto impresso no cupom.

Image RemovedImagem 4 – Texto Cupom