{"title":"Exibir dados no terminal","category":"default","creationDate":1776961627,"content":"

Use o DisplayRequest<\/code> para enviar dados da sua caixa registradora para o terminal, para serem mostrados na tela do terminal. Por exemplo, voc\u00ea pode us\u00e1-lo para mostrar um recibo virtual em um terminal de tela grande como o M400. Ou voc\u00ea pode us\u00e1-lo para enviar uma mensagem para a pessoa que opera o terminal.<\/p>\n

Endpoint<\/h2>\n

O URL usado para enviar mensagens da API do terminal depende do seu tipo de implementa\u00e7\u00e3o. Para obter mais informa\u00e7\u00f5es sobre as arquiteturas dispon\u00edveis, consulte Vis\u00e3o geral da API de terminais<\/a>.<\/p>\n

Solicita\u00e7\u00e3o<\/h2>\n

O exemplo abaixo mostra os campos b\u00e1sicos que voc\u00ea especifica ao fazer uma chamada DisplayRequest<\/code>\u00a0para um endpoint da API de terminais<\/a>.<\/p>\n

O SaleID<\/code> e ServiceID<\/code> n MessageHeader<\/code> devem ser \u00fanicos. Combina\u00e7\u00f5es SaleID<\/code> e ServiceID<\/code> s\u00e3o rejeitadas se usadas recentemente, dentro de 48 horas.<\/p>\n

SaleID<\/code> e\u00a0POIID<\/code>\u00a0s\u00e3o obrigat\u00f3rios.\u00a0\u00a0<\/p>\n

\n

Voc\u00ea deve passar o XML codificado em Base64 no campo OutputXHTML<\/code>, e defina o OutputFormat<\/code> como XHTML.<\/p>\n<\/div><\/div>\n

\n

Para obter uma lista completa dos campos que voc\u00ea pode transmitir em uma solicita\u00e7\u00e3o de exibi\u00e7\u00e3o, consulte a DisplayRequest<\/a><\/p>\n<\/div><\/div>\n

\n <\/code-sample>\n<\/div>\n

Resposta<\/h2>\n

Para obter uma lista dos campos de resposta de exibi\u00e7\u00e3o, consulte os campos\u00a0DisplayResponse<\/code>.<\/p>\n

Se a solicita\u00e7\u00e3o for bem-sucedida, voc\u00ea receber\u00e1 uma resposta com os seguintes campos:<\/p>\n

{\n   \"SaleToPOIResponse\":{\n      \"DisplayResponse\":{\n         \"OutputResult\":[\n            {\n               \"InfoQualify\":\"Display\",\n               \"Device\":\"CustomerDisplay\",\n               \"Response\":{\n                  \"Result\":\"Success\"\n               }\n            }\n         ]\n      },\n      \"MessageHeader\":{\n         \"MessageType\":\"Response\",\n         \"MessageClass\":\"Device\",\n         \"MessageCategory\":\"Display\",\n         \"SaleID\":\"POSSystemID12345\",\n         \"ServiceID\":\"1123163504\",\n         \"POIID\":\"MX925-289173817\",\n         \"ProtocolVersion\":\"3.0\"\n      }\n   }\n}<\/code><\/pre>\n
Se a solicita\u00e7\u00e3o n\u00e3o for bem-sucedida, por exemplo, se o DisplayRequest for enviado para um terminal incompat\u00edvel, voc\u00ea receber\u00e1 uma resposta com os seguintes campos:<\/p>\n
{\n   \"SaleToPOIResponse\":{\n      \"MessageHeader\":{\n         \"ProtocolVersion\":\"3.0\",\n         \"ServiceID\":\"1123161654\",\n         \"SaleID\":\"POSSystemID12345\",\n         \"MessageClass\":\"Device\",\n         \"MessageCategory\":\"Display\",\n         \"MessageType\":\"Response\",\n         \"POIID\":\"MX925-289173817\"\n      },\n      \"DisplayResponse\":{\n         \"OutputResult\":[\n            {\n               \"InfoQualify\":\"Display\",\n               \"Response\":{\n                  \"Result\":\"Failure\",\n                  \"AdditionalResponse\":\"message=DisplayRequest%20API%20cannot%20be%20used%20for%20this%20terminal%20model.\",\n                  \"ErrorCondition\":\"NotAllowed\"\n               },\n               \"Device\":\"CustomerDisplay\"\n            }\n         ]\n      }\n   }\n}<\/code><\/pre>\n
Idle the display<\/h2>\n
Adicione o seguinte xml codificado em BASE64:<\/p>\n
PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4NCjxzY3JlZW4gbmFtZT0iIj4NCiAgDQo8L3NjcmVlbj4NCg==<\/code><\/pre>\n
Exemplo de XML de Entrada<\/h2>\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n\n<screen name=\"virtual_receipt02.xslt\">\n\n    <receipt>\n\n        <!-- a receipt can have 0 or 1 lines element -->\n\n        <lines>\n\n            <!-- the lines element can have 0 or more lineitems -->\n\n            <lineitem>\n\n                <!-- all elements (description, count and amount) are optional -->\n\n                <!-- a lineitem could have attributes in the future, such as \"format=emphasis\" for bold formatting, or returnitem=\"true\" for a returned item -->\n\n                <description>Running shoes<\/description>\n\n                <count>2<\/count>\n\n                <amount>\n\n                    <!-- an amount must have a currency (symbol) and a value -->\n\n                    <currency>$<\/currency>\n\n                    <value>79.99<\/value>\n\n                <\/amount>\n\n            <\/lineitem>\n\n            <lineitem>\n\n                <description>T-shirt<\/description>\n\n                <amount>\n\n                    <currency>$<\/currency>\n\n                    <value>18.99<\/value>\n\n                <\/amount>\n\n            <\/lineitem>\n\n<lineitem>\n\n            <description>Loyalty discount: 5%<\/description>\n\n            <amount>\n\n                        <!-- an amount must have a currency (symbol) and\n\na value -->\n\n                <currency>$<\/currency>\n\n                <value>-4.48<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <description>Just stating something!<\/description>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <description><\/description><!-- an empty line does not work\n\nout of the box -->\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <description>***** RETURNS *****<\/description>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>1<\/count>\n\n            <description>grey t-shirt @ 12.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>-12.99<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <description>____________________<\/description>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <description>***** SALES *****<\/description>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>4<\/count>\n\n            <description>black t-shirt @ 12.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>51.96<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>1<\/count>\n\n            <description>white sweater @ 29.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>29.99<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>2<\/count>\n\n            <description>red socks @ 9.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>19.98<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>4<\/count>\n\n            <description>black t-shirt @ 12.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>51.96<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>1<\/count>\n\n            <description>white sweater @ 29.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>29.99<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>2<\/count>\n\n            <description>red socks @ 9.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>19.98<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>4<\/count>\n\n            <description>black t-shirt @ 12.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>51.96<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>1<\/count>\n\n            <description>white sweater @ 29.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>29.99<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>2<\/count>\n\n            <description>red socks @ 9.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>19.98<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n            <!-- an empty lineitem would result in a blank line (taking up vertical space) -->\n\n            <lineitem \/>\n\n            <lineitem>\n\n                <description>Thanks for shopping with us!<\/description>\n\n            <\/lineitem>\n\n        <\/lines>\n\n        <!-- a receipt can have 0 or 1 tax element -->\n\n        <tax>\n\n            <!-- a tax element can have 0 or 1 taxtotal element -->\n\n            <taxtotal>\n\n                <!-- description and amount are both optional -->\n\n                <description>tax<\/description>\n\n                <amount>\n\n                    <currency>$<\/currency>\n\n                    <value>-1010.14<\/value>\n\n                <\/amount>\n\n            <\/taxtotal>\n\n            <!-- the tax element can have 0 or more taxitems -->\n\n            <taxitem>\n\n                <!-- description and amount are both optional -->\n\n                <description>VAT<\/description>\n\n                <amount>\n\n                    <currency>$<\/currency>\n\n                    <value>21.34<\/value>\n\n                <\/amount>\n\n            <\/taxitem>\n\n            <taxitem>\n\n                <description>Seasonal TAX: 1.5%<\/description>\n\n                <amount>\n\n                    <currency>$<\/currency>\n\n                    <value>0.80<\/value>\n\n                <\/amount>\n\n            <\/taxitem>\n\n        <\/tax>\n\n        <!-- a receipt can have 0 or 1 total element -->\n\n        <total>\n\n            <!-- description and amount are both optional -->\n\n            <description>Your total amount<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>-1079.98<\/value>\n\n            <\/amount>\n\n        <\/total>\n\n        <!-- a receipt can have 0 or 1 subtotal element -->\n\n        <subtotal>\n\n            <!-- description and amount are both optional -->\n\n            <description>subtotal<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>-1219.98<\/value>\n\n            <\/amount>\n\n        <\/subtotal>\n\n    <\/receipt>\n\n<\/screen><\/code><\/pre>","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/shopper-engagement\/display-data\/display-receipt","articleFields":{"description":"Use solicita\u00e7\u00f5es de exibi\u00e7\u00e3o para mostrar recibos virtuais e outros dados no terminal.","id":"36179762","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"28-04-2020 21:54"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/shopper-engagement\/display-data\/display-receipt","title":"Exibir dados no terminal","content":"Use o DisplayRequest para enviar dados da sua caixa registradora para o terminal, para serem mostrados na tela do terminal. Por exemplo, voc\u00ea pode us\u00e1-lo para mostrar um recibo virtual em um terminal de tela grande como o M400. Ou voc\u00ea pode us\u00e1-lo para enviar uma mensagem para a pessoa que opera o terminal.\nEndpoint\nO URL usado para enviar mensagens da API do terminal depende do seu tipo de implementa\u00e7\u00e3o. Para obter mais informa\u00e7\u00f5es sobre as arquiteturas dispon\u00edveis, consulte Vis\u00e3o geral da API de terminais.\nSolicita\u00e7\u00e3o\nO exemplo abaixo mostra os campos b\u00e1sicos que voc\u00ea especifica ao fazer uma chamada DisplayRequest\u00a0para um endpoint da API de terminais.\nO SaleID e ServiceID n MessageHeader devem ser \u00fanicos. Combina\u00e7\u00f5es SaleID e ServiceID s\u00e3o rejeitadas se usadas recentemente, dentro de 48 horas.\nSaleID e\u00a0POIID\u00a0s\u00e3o obrigat\u00f3rios.\u00a0\u00a0\n\nVoc\u00ea deve passar o XML codificado em Base64 no campo OutputXHTML, e defina o OutputFormat como XHTML.\n\n\nPara obter uma lista completa dos campos que voc\u00ea pode transmitir em uma solicita\u00e7\u00e3o de exibi\u00e7\u00e3o, consulte a  DisplayRequest\n\n\n    \n\nResposta\nPara obter uma lista dos campos de resposta de exibi\u00e7\u00e3o, consulte os campos\u00a0DisplayResponse.\nSe a solicita\u00e7\u00e3o for bem-sucedida, voc\u00ea receber\u00e1 uma resposta com os seguintes campos:\n{\n   \"SaleToPOIResponse\":{\n      \"DisplayResponse\":{\n         \"OutputResult\":[\n            {\n               \"InfoQualify\":\"Display\",\n               \"Device\":\"CustomerDisplay\",\n               \"Response\":{\n                  \"Result\":\"Success\"\n               }\n            }\n         ]\n      },\n      \"MessageHeader\":{\n         \"MessageType\":\"Response\",\n         \"MessageClass\":\"Device\",\n         \"MessageCategory\":\"Display\",\n         \"SaleID\":\"POSSystemID12345\",\n         \"ServiceID\":\"1123163504\",\n         \"POIID\":\"MX925-289173817\",\n         \"ProtocolVersion\":\"3.0\"\n      }\n   }\n}\nSe a solicita\u00e7\u00e3o n\u00e3o for bem-sucedida, por exemplo, se o DisplayRequest for enviado para um terminal incompat\u00edvel, voc\u00ea receber\u00e1 uma resposta com os seguintes campos:\n{\n   \"SaleToPOIResponse\":{\n      \"MessageHeader\":{\n         \"ProtocolVersion\":\"3.0\",\n         \"ServiceID\":\"1123161654\",\n         \"SaleID\":\"POSSystemID12345\",\n         \"MessageClass\":\"Device\",\n         \"MessageCategory\":\"Display\",\n         \"MessageType\":\"Response\",\n         \"POIID\":\"MX925-289173817\"\n      },\n      \"DisplayResponse\":{\n         \"OutputResult\":[\n            {\n               \"InfoQualify\":\"Display\",\n               \"Response\":{\n                  \"Result\":\"Failure\",\n                  \"AdditionalResponse\":\"message=DisplayRequest%20API%20cannot%20be%20used%20for%20this%20terminal%20model.\",\n                  \"ErrorCondition\":\"NotAllowed\"\n               },\n               \"Device\":\"CustomerDisplay\"\n            }\n         ]\n      }\n   }\n}\nIdle the display\nAdicione o seguinte xml codificado em BASE64:\nPD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4NCjxzY3JlZW4gbmFtZT0iIj4NCiAgDQo8L3NjcmVlbj4NCg==\nExemplo de XML de Entrada\n<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n\n<screen name=\"virtual_receipt02.xslt\">\n\n    <receipt>\n\n        <!-- a receipt can have 0 or 1 lines element -->\n\n        <lines>\n\n            <!-- the lines element can have 0 or more lineitems -->\n\n            <lineitem>\n\n                <!-- all elements (description, count and amount) are optional -->\n\n                <!-- a lineitem could have attributes in the future, such as \"format=emphasis\" for bold formatting, or returnitem=\"true\" for a returned item -->\n\n                <description>Running shoes<\/description>\n\n                <count>2<\/count>\n\n                <amount>\n\n                    <!-- an amount must have a currency (symbol) and a value -->\n\n                    <currency>$<\/currency>\n\n                    <value>79.99<\/value>\n\n                <\/amount>\n\n            <\/lineitem>\n\n            <lineitem>\n\n                <description>T-shirt<\/description>\n\n                <amount>\n\n                    <currency>$<\/currency>\n\n                    <value>18.99<\/value>\n\n                <\/amount>\n\n            <\/lineitem>\n\n<lineitem>\n\n            <description>Loyalty discount: 5%<\/description>\n\n            <amount>\n\n                        <!-- an amount must have a currency (symbol) and\n\na value -->\n\n                <currency>$<\/currency>\n\n                <value>-4.48<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <description>Just stating something!<\/description>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <description><\/description><!-- an empty line does not work\n\nout of the box -->\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <description>***** RETURNS *****<\/description>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>1<\/count>\n\n            <description>grey t-shirt @ 12.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>-12.99<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <description>____________________<\/description>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <description>***** SALES *****<\/description>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>4<\/count>\n\n            <description>black t-shirt @ 12.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>51.96<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>1<\/count>\n\n            <description>white sweater @ 29.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>29.99<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>2<\/count>\n\n            <description>red socks @ 9.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>19.98<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>4<\/count>\n\n            <description>black t-shirt @ 12.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>51.96<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>1<\/count>\n\n            <description>white sweater @ 29.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>29.99<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>2<\/count>\n\n            <description>red socks @ 9.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>19.98<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>4<\/count>\n\n            <description>black t-shirt @ 12.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>51.96<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>1<\/count>\n\n            <description>white sweater @ 29.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>29.99<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n        <lineitem>\n\n            <count>2<\/count>\n\n            <description>red socks @ 9.99<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>19.98<\/value>\n\n            <\/amount>\n\n        <\/lineitem>\n\n            <!-- an empty lineitem would result in a blank line (taking up vertical space) -->\n\n            <lineitem \/>\n\n            <lineitem>\n\n                <description>Thanks for shopping with us!<\/description>\n\n            <\/lineitem>\n\n        <\/lines>\n\n        <!-- a receipt can have 0 or 1 tax element -->\n\n        <tax>\n\n            <!-- a tax element can have 0 or 1 taxtotal element -->\n\n            <taxtotal>\n\n                <!-- description and amount are both optional -->\n\n                <description>tax<\/description>\n\n                <amount>\n\n                    <currency>$<\/currency>\n\n                    <value>-1010.14<\/value>\n\n                <\/amount>\n\n            <\/taxtotal>\n\n            <!-- the tax element can have 0 or more taxitems -->\n\n            <taxitem>\n\n                <!-- description and amount are both optional -->\n\n                <description>VAT<\/description>\n\n                <amount>\n\n                    <currency>$<\/currency>\n\n                    <value>21.34<\/value>\n\n                <\/amount>\n\n            <\/taxitem>\n\n            <taxitem>\n\n                <description>Seasonal TAX: 1.5%<\/description>\n\n                <amount>\n\n                    <currency>$<\/currency>\n\n                    <value>0.80<\/value>\n\n                <\/amount>\n\n            <\/taxitem>\n\n        <\/tax>\n\n        <!-- a receipt can have 0 or 1 total element -->\n\n        <total>\n\n            <!-- description and amount are both optional -->\n\n            <description>Your total amount<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>-1079.98<\/value>\n\n            <\/amount>\n\n        <\/total>\n\n        <!-- a receipt can have 0 or 1 subtotal element -->\n\n        <subtotal>\n\n            <!-- description and amount are both optional -->\n\n            <description>subtotal<\/description>\n\n            <amount>\n\n                <currency>$<\/currency>\n\n                <value>-1219.98<\/value>\n\n            <\/amount>\n\n        <\/subtotal>\n\n    <\/receipt>\n\n<\/screen>","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Shopper engagement","lvl3":"Exibir dados no terminal","lvl4":"Exibir dados no terminal"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/shopper-engagement","lvl3":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/shopper-engagement\/display-data","lvl4":"\/pt\/point-of-sale\/shopper-engagement\/display-data\/display-receipt"},"levels":5,"category":"In-person payments","category_color":"green","tags":["Exibir","dados","terminal"]},"articleFiles":{"screen-EN_LineItem_landscape.png":"\"\"","screen-EN_LineItem_plus_QRCode_landscape.png":"\"\"","screen-EN_LineItem_portrait.png":"\"\"","screen-EN_QRCode_before_LineItem_portrait.png":"\"\"","display-virtual-receipts_0.json":"
display-virtual-receipts_0.json<\/p>"}}