Histórico da Página

...

Exemplos : Quando houve a necessidade de validar um token no pinpad.

Veja abaixo exemplo de configuração dos parâmetros :

Image Added

Lista de formas de pagamento : Iremos configurar uma lista de formas de pagamento que poderá ser validado e autenticado pelo parceiro.

Obter o valor no pinpad: A solicitação irá ser encaminhada para o cliente informar o valor no Pinpad.

URL : Parceiro irá informar o caminho do seu servidor webservice para receber do PDV as solicitações e valores.

Formato dos arquivos JSON de Requisição e Resposta

Informações para Requisição (Request Information)

Parâmetros do Corpo (Body Parameters)

PARÂMETRO	TIPO	OBRIGATÓRIO	DESCRIÇÃO
Authenticator	Object Json	Sim	Grupo com os dados para autenticação
Authenticator.Header	Object Json	Sim	Grupo com os dados do cabeçalho
Authenticator.Header.Description	String	Sim	Descrição da rotina a ser liberada
Authenticator.Header.IdStore	Integer	Sim	Código da loja
Authenticator.Header.IdTerminal	Integer	Sim	Código do PDV
Authenticator.Header.IdUser	Integer	Sim	Código do usuário (operador de caixa)
Authenticator.Header.Method	String	Sim	Rotina a ser liberada
Authenticator.Header.M ethodStatus	String	Sim	Status da liberação da rotina solicitada. Legenda: arNone: envio da requisição (inicialização); arPending: requisição pendente; arAuthorized: requisição autorizada pelo fiscal de caixa; arNotAuthorized: requisição negada pelo fiscal de caixa; arCanceled: requisição cancelada (API fora do ar, timeout, usuário cancelou a solicitação, tempo limite atingido, etc).
Authenticator.Header.MethodTitle	String	Sim	Título da rotina a ser liberada
Authenticator.Sale	Object Json	Sim	Grupo com os dados da venda
Authenticator.Sale.AccountingDate	Date	Sim	Data do documento ou, quando não existir, da transação
Authenticator.Sale.DateTimeIssue	Date	Sim	Data e hora da requisição
Authenticator.Sale.IdDocument	Integer	Sim	Código do documento
Authenticator.Sale.Items	Array object Json	Não	Lista de produto(s) da venda
Authenticator.Sale.Items[0].Description	String	Sim	Descrição do produto
Authenticator.Sale.Items[0].InternalCode	Integer	Sim	Código interno do produto
Authenticator.Sale.Items[0].ItemNumber	Integer	Sim	Código de sequência do produto
Authenticator.Sale.CooDocument	Integer	Não	Código do documento da venda
Authenticator.Sale.Document	Integer	Não	Códigos interno da venda (seqdocto)
Authenticator.Sale.IdentificationType	String	Não	Tipo de identificação
Authenticator.Sale.DocumentType	String	Não	CPF ou CNPJ do cliente informado
Authenticator.Sale.AgreementNumber	Integer	Não	Nº do convênio/forma de pagamento
Authenticator.Sale.AgreedNumber	Integer	Não	Código do cliente (Seqpessoa)
Authenticator.Sale.TotalSale	Double	Não	Total da venda
Authenticator.Sale.TotalPay	Double	Não	Valor do pagamento
Event	String	Sim	Tipo de evento da API
Execution	String	Sim	Status da execução
ID	String	Sim	ID da transação (que será consultando depois no evento GET)
Operation	String	Sim	Operação que está sendo enviada ("cotAuthenticador" para este evento POST)
Response	String	Não	Valor retornado pelo PDV. Este é o valor de retorno digitado lá no pdv pelo cliente
Version	Integer	Sim	Número da versão

Formatos de Requisição (Request Formats)

application/json

Exemplo (Sample)

{ "Authenticator": { "Header": { "Description": "Autenticacao", "IdStore": 1, "IdTerminal": 222, "IdUser": 2, "Method": "mtFinalizadoraConvenio", "MethodStatus": "arPending", "MethodTitle": "Autenticacao" }, "Sale": { "AccountingDate": "2024-01-23T00:00:00", "AgreedNumber": 138789, "AgreementNumber": 252, "CooDocument": 27, "DateTimeIssue": "2024-01-23T14:34:01", "Document": "97107967000109", "DocumentType": "cdtCNPJ", "IdDocument": 11071962, "IdentificationType": "citReward", "Items": [ ], "TotalPay": 1.0000000000000000E+001, "TotalSale": 1.0000000000000000E+001 } }, "Event": "cetAfter", "Execution": "cetContinue", "ID": "00122220240123143401", "Operation": "cotAuthenticator", "Response": "", "Version": 1}

rupo com os dados para autenticação

Authenticator.HeaderObject JsonSim

Grupo com os dados do cabeçalho

Authenticator.Header.DescriptionStringSim

Descrição da rotina a ser liberada

Authenticator.Header.IdStoreIntegerSim

Código da loja

Authenticator.Header.IdTerminalIntegerSim

Código do PDV

Authenticator.Header.IdUserIntegerSim

Código do usuário (operador de caixa)

Authenticator.Header.MethodStringSim

Rotina a ser liberada

Authenticator.Header.M

ethodStatus

StringSim

Status da liberação da rotina solicitada. Legenda:

arNone: envio da requisição (inicialização);

arPending: requisição pendente;

arAuthorized: requisição autorizada pelo fiscal de caixa;

arNotAuthorized: requisição negada pelo fiscal de caixa;

arCanceled: requisição cancelada (API fora do ar, timeout, usuário cancelou a solicitação, tempo limite atingido, etc).

Authenticator.Header.MethodTitleStringSim

Título da rotina a ser liberada

Authenticator.SaleObject JsonSim

Grupo com os dados da venda

Authenticator.Sale.AccountingDateDateSim

Data do documento ou, quando não existir, da transação

Authenticator.Sale.DateTimeIssueDateSim

Data e hora da requisição

Authenticator.Sale.IdDocumentIntegerSim

Código do documento

Authenticator.Sale.ItemsArray object JsonNão

Lista de produto(s) da venda

Authenticator.Sale.Items[0].DescriptionStringSim

Descrição do produto

Authenticator.Sale.Items[0].InternalCodeIntegerSim

Código interno do produto

Authenticator.Sale.Items[0].ItemNumberIntegerSim

Código de sequência do produto

Authenticator.Sale.CooDocumentIntegerNão

Código do documento da venda

Authenticator.Sale.DocumentIntegerNão

Códigos interno da venda (seqdocto)

Authenticator.Sale.IdentificationTypeStringNão

Tipo de identificação

Authenticator.Sale.DocumentTypeStringNão

CPF ou CNPJ do cliente informado

Authenticator.Sale.AgreementNumberIntegerNão

Nº do convênio/forma de pagamento

Authenticator.Sale.AgreedNumberIntegerNão

Código do cliente (Seqpessoa)

Authenticator.Sale.TotalSaleDoubleNão

Total da venda

Authenticator.Sale.TotalPayDoubleNão

Valor do pagamento

EventStringSim

Tipo de evento da API

ExecutionStringSim

Status da execução

IDStringSim

ID da transação (que será consultando depois no evento GET)

OperationStringSim

Operação que está sendo enviada ("cotAuthenticador" para este evento POST)

ResponseStringNão

Valor retornado pelo PDV.

Este é o valor de retorno digitado lá no pdv pelo cliente

VersionIntegerSimNúmero da versão

Formatos de Response(Response Formats) para obter valor, no caso do exemplo um Token

application/json

Exemplo (Sample)

{

"version": 1, "sale": null, "pay": null, "return": { "code": 0 }, "execution": "cetContinue", "interpret": { "commandType": "cctGetValue", "messageCommand": null, "options": null, "value": { "title": "Cliente fidelidade", "subtitle": "Informe o Token", "dataType": "cvtToken", "size": 0, "documentTypes": [ ] }, "pay": null }, "vouchersPrint": [ ]}

Exemplo da venda no convênio :

...

Requisição do Exemplo (Request) com a resposta do que foi digitado :

{ "Authenticator": { "Header": { "Description": "Autenticacao", "IdStore": 1, "IdTerminal": 222, "IdUser": 2, "Method": "mtFinalizadoraConvenio", "MethodStatus": "arPending", "MethodTitle": "Autenticacao" }, "Sale": { "AccountingDate": "2024-01-23T00:00:00", "AgreedNumber": 138789, "AgreementNumber": 252, "CooDocument": 27, "DateTimeIssue": "2024-01-23T14:34:01", "Document": "97107967000109", "DocumentType": "cdtCNPJ", "IdDocument": 11071962, "IdentificationType": "citReward", "Items": [ ], "TotalPay": 1.0000000000000000E+001, "TotalSale": 1.0000000000000000E+001 } }, "Event": "cetAfter", "Execution": "cetContinue", "ID": "00122220240123143401", "Operation": "cotAuthenticator", "Response": "151516", "Version": 1}

Parceiro trata o retorno e finaliza com um response se estiver de acordo com a venda.

Response do Exemplo (Response) com a resposta cetCompleted:

{

"version": 1, "sale": null, "pay": null, "return": { "code": 0, "messageText": "0" }, "execution": "cetCompleted", "interpret": null, "vouchersPrint": [ ]}

Árvore de páginas

Versões comparadas

Versão antiga 2

Nova versão 3

Chave

Formato dos arquivos JSON de Requisição e Resposta

Informações para Requisição (Request Information)

Parâmetros do Corpo (Body Parameters)

Formatos de Requisição (Request Formats)

application/json

Formatos de Response(Response Formats) para obter valor, no caso do exemplo um Token

application/json

Exemplo da venda no convênio :