Exibir dados no terminal

Use o DisplayRequest para enviar dados da sua caixa registradora para o terminal, para serem mostrados na tela do terminal. Por exemplo, você pode usá-lo para mostrar um recibo virtual em um terminal de tela grande como o M400. Ou você pode usá-lo para enviar uma mensagem para a pessoa que opera o terminal.

Endpoint

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

Solicitação

O exemplo abaixo mostra os campos básicos que você especifica ao fazer uma chamada DisplayRequest para um endpoint da API de terminais.

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

SaleID e POIID são obrigatórios.  

{
   "SaleToPOIRequest":{
      "DisplayRequest":{
         "DisplayOutput":[
            {
               "Device":"CustomerDisplay",
               "InfoQualify":"Display",
               "OutputContent":{
                  "OutputFormat":"XHTML",
                  "OutputXHTML": "...paste Base64 encoded XML here..."
               }
            }
         ]
      },
      "MessageHeader":{
         "ServiceID":"1116172359",
         "ProtocolVersion":"3.0",
         "MessageClass":"Device",
         "POIID":"M400-284251175",
         "MessageType":"Request",
         "SaleID":"POSSystemID12345",
         "MessageCategory":"Display"
      }
   }
}

Resposta

Para obter uma lista dos campos de resposta de exibição, consulte os campos DisplayResponse.

Se a solicitação for bem-sucedida, você receberá uma resposta com os seguintes campos:

Copy code
{
   "SaleToPOIResponse":{
      "DisplayResponse":{
         "OutputResult":[
            {
               "InfoQualify":"Display",
               "Device":"CustomerDisplay",
               "Response":{
                  "Result":"Success"
               }
            }
         ]
      },
      "MessageHeader":{
         "MessageType":"Response",
         "MessageClass":"Device",
         "MessageCategory":"Display",
         "SaleID":"POSSystemID12345",
         "ServiceID":"1123163504",
         "POIID":"MX925-289173817",
         "ProtocolVersion":"3.0"
      }
   }
}

Se a solicitação não for bem-sucedida, por exemplo, se o DisplayRequest for enviado para um terminal incompatível, você receberá uma resposta com os seguintes campos:

Copy code
{
   "SaleToPOIResponse":{
      "MessageHeader":{
         "ProtocolVersion":"3.0",
         "ServiceID":"1123161654",
         "SaleID":"POSSystemID12345",
         "MessageClass":"Device",
         "MessageCategory":"Display",
         "MessageType":"Response",
         "POIID":"MX925-289173817"
      },
      "DisplayResponse":{
         "OutputResult":[
            {
               "InfoQualify":"Display",
               "Response":{
                  "Result":"Failure",
                  "AdditionalResponse":"message=DisplayRequest%20API%20cannot%20be%20used%20for%20this%20terminal%20model.",
                  "ErrorCondition":"NotAllowed"
               },
               "Device":"CustomerDisplay"
            }
         ]
      }
   }
}

Idle the display

Adicione o seguinte xml codificado em BASE64:

Copy code
PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4NCjxzY3JlZW4gbmFtZT0iIj4NCiAgDQo8L3NjcmVlbj4NCg==

Exemplo de XML de Entrada

Copy code
<?xml version="1.0" encoding="UTF-8"?>
 
<screen name="virtual_receipt02.xslt">
 
    <receipt>
 
        <!-- a receipt can have 0 or 1 lines element -->
 
        <lines>
 
            <!-- the lines element can have 0 or more lineitems -->
 
            <lineitem>
 
                <!-- all elements (description, count and amount) are optional -->
 
                <!-- a lineitem could have attributes in the future, such as "format=emphasis" for bold formatting, or returnitem="true" for a returned item -->
 
                <description>Running shoes</description>
 
                <count>2</count>
 
                <amount>
 
                    <!-- an amount must have a currency (symbol) and a value -->
 
                    <currency>$</currency>
 
                    <value>79.99</value>
 
                </amount>
 
            </lineitem>
 
            <lineitem>
 
                <description>T-shirt</description>
 
                <amount>
 
                    <currency>$</currency>
 
                    <value>18.99</value>
 
                </amount>
 
            </lineitem>
 
<lineitem>
 
            <description>Loyalty discount: 5%</description>
 
            <amount>
 
                        <!-- an amount must have a currency (symbol) and
 
a value -->
 
                <currency>$</currency>
 
                <value>-4.48</value>
 
            </amount>
 
        </lineitem>
 
        <lineitem>
 
            <description>Just stating something!</description>
 
        </lineitem>
 
        <lineitem>
 
            <description></description><!-- an empty line does not work
 
out of the box -->
 
        </lineitem>
 
        <lineitem>
 
            <description>***** RETURNS *****</description>
 
        </lineitem>
 
        <lineitem>
 
            <count>1</count>
 
            <description>grey t-shirt @ 12.99</description>
 
            <amount>
 
                <currency>$</currency>
 
                <value>-12.99</value>
 
            </amount>
 
        </lineitem>
 
        <lineitem>
 
            <description>____________________</description>
 
        </lineitem>
 
        <lineitem>
 
            <description>***** SALES *****</description>
 
        </lineitem>
 
        <lineitem>
 
            <count>4</count>
 
            <description>black t-shirt @ 12.99</description>
 
            <amount>
 
                <currency>$</currency>
 
                <value>51.96</value>
 
            </amount>
 
        </lineitem>
 
        <lineitem>
 
            <count>1</count>
 
            <description>white sweater @ 29.99</description>
 
            <amount>
 
                <currency>$</currency>
 
                <value>29.99</value>
 
            </amount>
 
        </lineitem>
 
        <lineitem>
 
            <count>2</count>
 
            <description>red socks @ 9.99</description>
 
            <amount>
 
                <currency>$</currency>
 
                <value>19.98</value>
 
            </amount>
 
        </lineitem>
 
        <lineitem>
 
            <count>4</count>
 
            <description>black t-shirt @ 12.99</description>
 
            <amount>
 
                <currency>$</currency>
 
                <value>51.96</value>
 
            </amount>
 
        </lineitem>
 
        <lineitem>
 
            <count>1</count>
 
            <description>white sweater @ 29.99</description>
 
            <amount>
 
                <currency>$</currency>
 
                <value>29.99</value>
 
            </amount>
 
        </lineitem>
 
        <lineitem>
 
            <count>2</count>
 
            <description>red socks @ 9.99</description>
 
            <amount>
 
                <currency>$</currency>
 
                <value>19.98</value>
 
            </amount>
 
        </lineitem>
 
        <lineitem>
 
            <count>4</count>
 
            <description>black t-shirt @ 12.99</description>
 
            <amount>
 
                <currency>$</currency>
 
                <value>51.96</value>
 
            </amount>
 
        </lineitem>
 
        <lineitem>
 
            <count>1</count>
 
            <description>white sweater @ 29.99</description>
 
            <amount>
 
                <currency>$</currency>
 
                <value>29.99</value>
 
            </amount>
 
        </lineitem>
 
        <lineitem>
 
            <count>2</count>
 
            <description>red socks @ 9.99</description>
 
            <amount>
 
                <currency>$</currency>
 
                <value>19.98</value>
 
            </amount>
 
        </lineitem>
 
            <!-- an empty lineitem would result in a blank line (taking up vertical space) -->
 
            <lineitem />
 
            <lineitem>
 
                <description>Thanks for shopping with us!</description>
 
            </lineitem>
 
        </lines>
 
        <!-- a receipt can have 0 or 1 tax element -->
 
        <tax>
 
            <!-- a tax element can have 0 or 1 taxtotal element -->
 
            <taxtotal>
 
                <!-- description and amount are both optional -->
 
                <description>tax</description>
 
                <amount>
 
                    <currency>$</currency>
 
                    <value>-1010.14</value>
 
                </amount>
 
            </taxtotal>
 
            <!-- the tax element can have 0 or more taxitems -->
 
            <taxitem>
 
                <!-- description and amount are both optional -->
 
                <description>VAT</description>
 
                <amount>
 
                    <currency>$</currency>
 
                    <value>21.34</value>
 
                </amount>
 
            </taxitem>
 
            <taxitem>
 
                <description>Seasonal TAX: 1.5%</description>
 
                <amount>
 
                    <currency>$</currency>
 
                    <value>0.80</value>
 
                </amount>
 
            </taxitem>
 
        </tax>
 
        <!-- a receipt can have 0 or 1 total element -->
 
        <total>
 
            <!-- description and amount are both optional -->
 
            <description>Your total amount</description>
 
            <amount>
 
                <currency>$</currency>
 
                <value>-1079.98</value>
 
            </amount>
 
        </total>
 
        <!-- a receipt can have 0 or 1 subtotal element -->
 
        <subtotal>
 
            <!-- description and amount are both optional -->
 
            <description>subtotal</description>
 
            <amount>
 
                <currency>$</currency>
 
                <value>-1219.98</value>
 
            </amount>
 
        </subtotal>
 
    </receipt>
 
</screen>