CONTEÚDO

  1. Visão Geral
  2. Exemplo de utilização
  3. Tecnologias Homologadas

01. VISÃO GERAL

Permite o PDV integre a algum parceiro antes de receber o pagamento da venda, através do evento "Antes do Pagamento" da Custom API.

02. EXEMPLO DE UTILIZAÇÃO

Caminho

Monitor PDV / Configurações / Configurações de PDVs / Integrações externas / Vendas

Pré-Requisitos e Restrições

Ter acesso ao monitor para realizar as configurações necessárias.

Formas de pagamento diferente de dinheiro configurar para não gerar troco.

Passo a Passo

Configurações no Monitor PDV

Acesse o Monitor PDV de um navegador na URL http://<ipservidor>/monitorpdv. Troque os símbolos maior e menor e o que está entre eles pelo IP do servidor.

Na sequência informe um Usuário e Senha com permissão para acessar a aplicação.

No menu lateral do lado esquerdo, acesse Configurações e depois Configurações de PDV.

Na tela de Configurações de PDVs, no menu superior, informe a Loja, o Segmento e os PDVs que receberão as novas configurações. Em seguida, clique no botão Carregar Parâmetros.

Imagem 1 - Tela de configurações de PDVs.

Acesso o grupo Integrações externas > Vendas.

Escolha uma das 4 integrações disponíveis.

Informe o Código do parceiro.

Imagem 2 - Código do parceiro.


Acesso o grupo Integrações externas > Antes do pagamento da venda.

Escolha uma das 4 integrações disponíveis.

Configure a URL para gerar a comunicação com o parceiro

Configure a lista de formas de pagamento separado por linha que geraram a comunicação

Imagem 01 - Antes do pagamento


Após configurado evento antes do pagamento no passo anterior. Ao realizar um recebimento de alguma cupom, é realizado uma comunicação com o parceiro via Custom API através do evento de antes do pagamento, conforme imagem abaixo:

Evento também utilizado para integração com Troco Solidário ou Super Troco.

Requisição antes do pagamento:

{
    "Event": "cetBefore",
    "Execution": "cetContinue",
    "ID": "001897000030620",
    "Operation": "cotSalePaymentBefore",
    "Pay": {
        "Discount": 0.0000000000000000E+000,
        "Increase": 0.0000000000000000E+000,
        "PaymentNumber": 1,
        "PaymentType": "cptBillet",
        "Thing": 0.0000000000000000E+000,
        "Total": 1.0000000000000000E+001,
    },
    "Sale": {
        "Discount": 0.0000000000000000E+000,
        "DiscountCodes": [
        ],
        "DiscountNotApplied": 0.0000000000000000E+000,
        "Header": {
            "AccountingDate": "2025-04-11T00:00:00",
            "CooDocument": 480,
            "DateTimeIssue": "2025-04-11T17:09:13",
            "IdDocument": 30620,
            "IdStore": 1,
            "IdTerminal": 897,
            "IdUser": 2,
            "Status": "sttValid"
        },
        "ID": "001897000030620",
        "Increase": 0.0000000000000000E+000,
        "Items": [
            {
                "BarCode": "7891000100103",
                "CaptionPacking": "UN",
                "Description": "LEITE COND MOCA LATA 395G LEITE COND MOCA",
                "DiscountPrice": 0.0000000000000000E+000,
                "IdSegment": 3,
                "IncreasePrice": 0.0000000000000000E+000,
                "InternalCode": "4900",
                "ItemNumber": 1,
                "PackingQuantity": 1.0000000000000000E+000,
                "Quantity": 1.0000000000000000E+000,
                "Status": "sttValid",
                "TotalPrice": 3.2400000000000002E+000,
                "UnitPrice": 3.2400000000000002E+000
            }
        ],
        "Total": 3.2400000000000002E+000,
        "TotalSale": 0.0000000000000000E+000,
    },
    "Version": 1
}

Resposta antes do pagamento

{
  "version": 1,
  "sale": {
    "items": [
      {
        "itemNumber": 1,
        "discountPrice": 0.324,
        "status": "sttValid",
        "partitionDiscount": [
          {
            "price": 0.162,
            "promotionCode": 87,
            "discountAmount": 1
          },
          {
            "price": 0.162,
            "promotionCode": 88,
            "discountAmount": 1
          }
        ]
      }
    ]
  },
  "payBefore": {
    "idDocument": "12345646",
    "document": "71981526978830",
    "documentType": "cdtCNPJ",
    "solidaryChange": 2
  },
  "return": {
    "skipNextEvents": false,
    "clientToken": "7ec731ad-c901-4baa-8f87-14e349362797"
  },
  "execution": "cetCompleted"
}


Tabela dos campos retornado pela interação com o parceiro

PARÂMETROTIPOOBRIGATÓRIODESCRIÇÃO
idDocumentStringfalseIdentificação documento parceiro
documentStringfalseDocumento (CPF ou CNPJ) enviado pelo parceiro
documentTypeStringfalseTipo do documento
solidaryChangeDoublefalseValor para adicionar ao valor da forma de pagamento 
increaseDoublefalseValor para adicionar ao valor da forma de pagamento 
discountDoublefalseValor para descontos


Exemplo JSON Response recebido do parceiro 

{
	"version": 1,
	"sale": {
		"items": [{
			"itemNumber": 1,
			"discountPrice": 0.324,
			"status": "sttValid",
			"partitionDiscount": [{
					"price": 0.162,
					"promotionCode": 62,
					"discountAmount": 1
				},
				{
					"price": 0.162,
					"promotionCode": 83,
					"discountAmount": 1
				}
			]
		}],
		"partitionDiscount": [{
			"promotionCode": 49,
		}]
	},
	"payBefore": {
		"idDocument": "12345646",
		"document": "71981526978830",
		"documentType": "cdtCNPJ",
		"solidaryChange": 2,
	},
	"execution": "cetContinue",
	"interpret": {
		"commandType": "cctPay",
		"pay": {
			"value": 10,
			"operation": "optPayment",
			"iDPayment": "1234567890"
		}
	}
}

03. TECNOLOGIAS HOMOLOGADAS

O uso do Tipo de Produto em diferentes tecnologias não homologadas, como em Sistema Operacional, Plataforma, Navegadores e outros dispositivos, pode comprometer a segurança dos sistemas e está sujeito a situações não previstas, sem cobertura de suporte.

Tipo de produto
  • PDV
Sistema Operacional
  • Linux
  • Windows Desktop
Plataforma
  • Desktop
Navegador
  • N/A (não se aplica)
Utilização/Experiência
  • Aplicações Desktop em geral
  • Aplicações Web em geral