Point-of-sale icon

Recuperar totals do terminal

Recupere os dados do menu totals de um terminal e filtre os dados por grupo ou operador.

Use GetTotalsRequest para recuperar os totals de um terminal sem iniciar um novo período de reconciliação.

Antes de você começar

Endpoint

O URL utilizado para enviar mensagens da API de terminais depende do seu tipo de implementação. Para obter mais informações sobre as arquiteturas disponíveis, consulte a Visão geral da API de terminais

GetTotalsRequest

Para uma lista de campos GetTotalsRequest, consulte campos GetTotalsRequest. 

O SaleID e o ServiceID no MessageHeader devem ser únicos. Combinações SaleID e ServiceID são rejeitadas se usadas recentemente, dentro de 48 horas.

Os campos descritos abaixo são aqueles que você especifica ao fazer uma chamada GetTotalsRequest para a Terminal API.

Expand view
Copy link to code block
Copy code
Copy code
{
   "SaleToPOIRequest":{
      "MessageHeader":{
         "ProtocolVersion":"3.0",
         "MessageClass":"Service",
         "MessageCategory":"GetTotals",
         "MessageType":"Request",
         "ServiceID":"0518144235",
         "SaleID":"CashRegB3",
         "POIID":"P400Plus-275008565"
      },
      "GetTotalsRequest":{
         "TotalFilter":{
            "POIID":"P400Plus-275008565"
         }
      }
   }
}

Use TotalFilter para limitar os totals para combinações de campo/valor apresentadas.
Use o cluster TotalDetails para agrupar os resultados nos campos especificados.

GetTotalsRequest - totalsGroupID específicos

Recuperar totas para um grupo específico de totals. Especificado com o totalsGroupID. 

Expand view
Copy link to code block
Copy code
Copy code
{
  "SaleToPOIRequest": {
    "MessageHeader": {
      "ProtocolVersion": "3.0",
      "MessageClass": "Service",
      "MessageCategory": "GetTotals",
      "MessageType": "Request",
      "ServiceID": "0821163913",
      "SaleID": "CashRegB3",
      "POIID": "P400Plus-275008565"
    },
    "GetTotalsRequest": {
      "TotalFilter": {
        "POIID": "P400Plus-275008565",
        "TotalsGroupID": "GroupA"
      }
    }
  }
}

 GetTotalsRequest - Agrupar por OperatorID

Recupere uma lista de totals para um operador. Especificado com o OperatorID.

Expand view
Copy link to code block
Copy code
Copy code
{
  "SaleToPOIRequest": {
    "MessageHeader": {
      "ProtocolVersion": "3.0",
      "MessageClass": "Service",
      "MessageCategory": "GetTotals",
      "MessageType": "Request",
      "ServiceID": "0821164804",
      "SaleID": "CashRegB3",
      "POIID": "P400Plus-275008565"
    },
    "GetTotalsRequest": {
      "TotalFilter": {
        "POIID": "P400Plus-275008565"
      },
      "TotalDetails": [
        "OperatorID"
      ]
    }
  }
}

GetTotalsResponse

Para uma lista de campos GetTotalsResponse, consulte campos GetTotalsResponse.

Copy code
{
   "SaleToPOIResponse":{
      "MessageHeader":{
         "ProtocolVersion":"3.0",
         "SaleID":"CashRegB3",
         "MessageClass":"Service",
         "MessageCategory":"GetTotals",
         "ServiceID":"0518144235",
         "POIID":"P400Plus-275008565",
         "MessageType":"Response"
      },
      "GetTotalsResponse":{
         "POIReconciliationID":"1000",
         "Response":{
            "Result":"Success"
         },
         "TransactionTotals":[
            {
               "SaleID":"CashRegB3",
               "PaymentInstrumentType":"StoredValue",
               "PaymentCurrency":"EUR",
               "PaymentTotals":[
                  {
                     "TransactionType":"Debit",
                     "TransactionCount":1,
                     "TransactionAmount":100.99
                  }
               ],
               "OperatorID":"",
               "CardBrand":"SVS",
               "TotalsGroupID":"GroupA",
               "ShiftNumber":""
            },
            {
               "SaleID":"CashRegB3",
               "PaymentInstrumentType":"Card",
               "PaymentCurrency":"EUR",
               "PaymentTotals":[
                  {
                     "TransactionType":"Debit",
                     "TransactionCount":51,
                     "TransactionAmount":1841.52
                  }
               ],
               "OperatorID":"",
               "CardBrand":"mc",
               "TotalsGroupID":"GroupA",
               "ShiftNumber":""
            }
         ]
      }
   }