Responsabilidade de impressão e tratamento de recibos
A geração e a impressão de recibos podem ser divididas entre o terminal POS e o sistema de automação. Esta página descreve como essa responsabilidade é controlada. Ela também explica como o conteúdo do recibo é retornado quando o POS não imprime.
O que é responsabilidade de impressão
Em um ambiente de POS Integrado, os parâmetros que você envia em cada operação controlam a estratégia de impressão, por exemplo em Sale ou Refund. O terminal pode imprimir os recibos por conta própria ou retornar o conteúdo estruturado do recibo ao sistema de automação. Esse sistema decide depois se imprime ou armazena. Assim, cada partner trata os recibos conforme as necessidades do seu negócio.
Estratégias de impressão
O POS Integrado admite duas estratégias de tratamento de recibos:
Impressão gerenciada pelo POS
O terminal imprime os recibos diretamente com sua impressora integrada.
Impressão gerenciada pela automação
O terminal retorna o conteúdo estruturado do recibo ao sistema de automação. Esse sistema é responsável por imprimir ou armazenar o recibo.
As duas estratégias sempre retornam uma resposta de operação ao sistema de automação.
Parâmetro PrintOnPos
O parâmetro PrintOnPos determina onde o recibo é tratado:
true— o POS imprime o recibo.false— o conteúdo do recibo é retornado na resposta.
Quando PrintOnPos é false, a resposta inclui um objeto ReceiptContent com todos os campos do recibo. Para ver a lista completa de campos, consulte Objeto ReceiptContent.
Objeto ReceiptContent
O parâmetro ReceiptContent é retornado como um objeto estruturado. Ele contém todas as linhas do recibo geradas pelo POS.
Com esse parâmetro, o sistema de automação reproduz o recibo exatamente como o POS gerou. Ele também guarda os registros das transações em formato digital e imprime os recibos em impressoras externas.
Quando PrintOnPos está definido como true, o campo ReceiptContent pode vir vazio ou ser omitido na resposta da operação.
Responsabilidade de impressão do app
Quando o sistema de automação gerencia a impressão, seu app precisa imprimir ao menos o recibo do estabelecimento. Esse recibo é o registro da transação para o vendedor. Imprima também o recibo do cliente quando ele precisar de uma via.
Recibos do cliente e do estabelecimento
Conforme a operação e os parâmetros que você envia:
- Os recibos do estabelecimento podem ser impressos automaticamente.
- Os recibos do cliente podem ser impressos ou omitidos (por exemplo, com
SkipReceipt). - A impressão do recibo pode ser repetida se houver problema com o papel.
Os parâmetros da operação determinam o comportamento do recibo.
Recursos relacionados
Para ver a responsabilidade de impressão na prática, explore estes guias:
- Pagamento em Passo Único — Controle o comportamento do recibo com os parâmetros
PrintOnPoseSkipReceipt. - Operações de reembolso — Trate a impressão de recibos nas transações de reembolso.
- Recuperar o Último Comprovante — Reimprima ou recupere o conteúdo do recibo da última operação.