Objetivo

Permitir que o parceiro envie dados cliente para o PDV.

Esta operação ocorre nos eventos 'Identificar o cliente', 'Cadastrar pessoa' e também no pagamento por convênio, caso o cliente não tenha sido identificado durante a compra.

Chamada

POST {url}

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

Parâmetros do Corpo (Body Parameters)

ParâmetroTipoDescrição
DocumentStringNúmero do documento de identificação da pessoa
DocumentTypeString

Tipo de documento de identificação

cdtCPF - CFP

cdtCNPJ - CNPJ

Formatos de Requisição (Request Formats)

application/json

Exemplo (Sample)

{
   "id":"{E20B5192-1CDB-4F92-99C4-BB0F8CD700DB}",
   "version":1,
   "identification":{
      "document":"111",
      "documentType":"cdtCPF"
   }
}


Informações para Resposta (Response Information)

Parâmetros do Corpo (Body Parameters)

PARÂMETROTIPOTAMANHOOBRIGATÓRIODESCRIÇÃO
IdentificationObject Json
Sim

Informações do tipo de identificação do cliente

ParâmetroTipoDescrição
DocumentStringNúmero do documento de
identificação da pessoa
DocumentTypeString

Tipo de documento de identificação

cdtCPF - CFP

cdtCNPJ - CNPJ

cdtIE -  Inscrição estadual

cdtRG - RG

NameString50SimNome / Razão social
EmailString80NãoEmail do cliente
KindString
Sim

Tipo de pessoa

cktPhysical - Física 
cktLegal - Jurídica

TaxpayerString
Não

Contribuinte de ICMS

yntYes - Sim
yntNo - Não

PublicAgencyString
Não

Órgão público

yntYes - Sim
yntNo - Não

TaxRegimeInteger5NãoRegime de tributação
GlobalLimitDouble9, 2NãoValor limite global
DeadlineInteger3NãoPrazo máximo em dias
CreditStatusString
Não

Situação do crédito

ccsAlert - Alerta 
ccsReleased - Liberado
ccsBlocked - Bloqueado
ccsSuspended - Suspenso

NoteString250NãoObservação
CardNumberInteger15NãoNúmero do cartão
BusinessSituationString
Não

Situação comercial

bstReleased - Liberado 
bstBlocked - Bloqueado

KindAddressString
Sim

Tipo do endereço

katMain - Principal 
katCharge - Cobrança 
katDelivery - Entrega 
katCorrespondence - Correspondência 
katPickUp - Retirada

PublicPlaceString60SimDescrição do logradouro
PublicPlaceNumberString10NãoNúmero do logradouro
NeighbourhoodString50SimDescrição do bairro
ComplementString60NãoComplemento de endereço
CityString60SimNome da cidade
FederativeUnitString2SimEstado da cidade
ZipCodeInteger8SimCep sem formatação
IBGEInteger12NãoCódigo da cidade no IBGE

Formatos de Resposta (Response Formats)

application/json

Exemplo simplificado (Sample)

{
  "id": "527dd979-6f51-4046-a6a7-a8e20c4a6a54",
  "version": 1,
  "person": {
    "documents":[
      {
        "document":"91347879846",
        "documentType":"cdtCPF"
      },
      {
        "document":"253716652",
        "documentType":"cdtRG"
      }
    ],
    "Name": "Edson Luan Bernardo Nogueira",
    "kind": "cktPhysical",
    "addresses": [
      {
        "kindAddress": "katMain",
        "publicPlace": "Rua Baiacu",
        "publicPlaceNumber": "482",
        "neighbourhood": "Eldorado",
        "complement": "",
        "city": "Diadema",
        "federativeUnit": "SP",
        "zipCode": "14065540",
        "iBGE": 1234
      }
    ]
  }
}
application/json

Exemplo completo (Sample)

{
  "id": "527dd979-6f51-4046-a6a7-a8e20c4a6a54",
  "version": 1,
  "person": {
    "documents":[
      {
        "document":"91347879846",
        "documentType":"cdtCPF"
      },
      {
        "document":"253716652",
        "documentType":"cdtRG"
      }
    ],
    "Name": "Antonio Arthur João da Mota",
    "email":"[email protected]",
    "kind":"cktPhysical",
    "taxpayer":"yntNo",
    "publicAgency":"yntNo",
    "customer":{
      "globalLimit":0,
      "deadline":0,
      "creditStatus":"ccsReleased",
      "note":"",
      "cardNumber":0,
      "businessSituation":"bstReleased"
    },
    "addresses": [
      {
        "kindAddress": "katMain",
        "publicPlace": "Rua Nestor Ferreira da Rocha",
        "publicPlaceNumber": "368",
        "neighbourhood": "Vila Iolanda II",
        "complement": "",
        "city": "São Paulo",
        "federativeUnit": "SP",
        "zipCode": "08473400",
        "iBGE": 1234
      }
    ]
  }
}