Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Authenticator

PARÂMETRO

TIPO

OBRIGATÓRIO

DESCRIÇÃO

UserAuthenticationObject JsonSim

Grupo com os dados para autenticação

AuthenticatorUserAuthentication.HeaderObject JsonSim

Grupo com os dados do cabeçalho

AuthenticatorUserAuthentication.Header.DescriptionStringSim

Descrição da rotina a ser liberada

AuthenticatorUserAuthentication.Header.IdStoreIntegerSim

Código da loja

AuthenticatorUserAuthentication.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

AuthenticatorUserAuthentication.SaleObject JsonSim

Grupo com os dados da venda

AuthenticatorUserAuthentication.Sale.AccountingDateDateSim

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

AuthenticatorUserAuthentication.Sale.DateTimeIssueDateSim

Data e hora da requisição

AuthenticatorUserAuthentication.Sale.IdDocumentIntegerSim

Código do documento

AuthenticatorUserAuthentication.Sale.ItemsArray object JsonNão

Lista de produto(s) da venda

AuthenticatorUserAuthentication.Sale.Items[0].DescriptionStringSim

Descrição do produto

AuthenticatorUserAuthentication.Sale.Items[0].InternalCodeIntegerSim

Código interno do produto

AuthenticatorUserAuthentication.Sale.Items[0].ItemNumberIntegerSim

Código de sequência do produto

AuthenticatorUserAuthentication.Sale.CooDocumentIntegerNão

Código do documento da venda

AuthenticatorUserAuthentication.Sale.DocumentIntegerNão

Códigos interno da venda (seqdocto)

AuthenticatorUserAuthentication.Sale.IdentificationTypeStringNão

Tipo de identificação

AuthenticatorUserAuthentication.Sale.DocumentTypeStringNão

CPF ou CNPJ do cliente informado

AuthenticatorUserAuthentication.Sale.AgreementNumberIntegerNão

Nº do convênio/forma  de pagamento

AuthenticatorUserAuthentication.Sale.AgreedNumberIntegerNão

Código do cliente (Seqpessoa)

AuthenticatorUserAuthentication.Sale.TotalSaleDoubleNão

Total da venda

AuthenticatorUserAuthentication.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

VersionIntegerSim

Número da versão

...

application/json

Exemplo (Sample)

{
    "AuthenticatorEvent": {
    "cetAfter",
    "HeaderExecution": {
        "cetContinue",
    "DescriptionID": "Autenticacao00122220240125140628",
            "IdStoreOperation": 1"cotUserAuthentication",
            "IdTerminalResponse": 222"1515",
    "UserAuthentication": {
        "IdUserHeader": 2,{
            "MethodIdStore": "mtFinalizadoraConvenio"1,
            "MethodStatusIdTerminal": "arPending"222,
            "MethodTitleIdUser": "Autenticacao"2
        },
        "Sale": {
            "AccountingDate": "2024-01-23T0024T00:00:00",
            "AgreedNumber": 138789,
            "AgreementNumber": 252,
            "CooDocument": 2730,
            "DateTimeIssue": "2024-01-23T1425T14:3406:0128",
            "Document": "97107967000109",
            "DocumentType": "cdtCNPJ",
            "IdDocument": 1107196211071968,
            "IdentificationType": "citReward",
            "Items": [
            ],
            "TotalPay": 1.0000000000000000E+001,
            "TotalSale": 1.0000000000000000E+001
        }
    },
    "Event": "cetAfter",
    "Execution": "cetContinue",
    "ID": "00122220240123143401 ",
    "Operation": "cotAuthenticator",
    "Response": "",
    "Version": 1
}


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

...

Neste momento, iria ser apresentada a tela de senha para o cliente informar, mas se o parãmetro (Obter o valor no pinpad) tiver habilitado irá apresentar o retorno do parceiro para validar um token.

...

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

{
   {
    "AuthenticatorEvent": {
    "cetAfter",
    "HeaderExecution": {
        "cetContinue",
    "DescriptionID": "Autenticacao00122220240125140628",
            "IdStoreOperation": 1"cotUserAuthentication",
            "IdTerminalResponse": 222"151516",
    "UserAuthentication": {
        "IdUserHeader": 2,{
            "MethodIdStore": "mtFinalizadoraConvenio"1,
            "MethodStatusIdTerminal": "arPending"222,
            "MethodTitleIdUser": "Autenticacao"2
        },
        "Sale": {
            "AccountingDate": "2024-01-23T0024T00:00:00",
            "AgreedNumber": 138789,
            "AgreementNumber": 252,
            "CooDocument": 2730,
            "DateTimeIssue": "2024-01-23T1425T14:3406:0128",
            "Document": "97107967000109",
            "DocumentType": "cdtCNPJ",
            "IdDocument": 1107196211071968,
            "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.

...