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

cdtIDInternal - Código interno

cdtCPF - CFP

cdtCNPJ - CNPJ

cdtIDForeign - Identificador único 

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
true

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

cdtIDInternal - Código interno

cdtCPF - CFP

cdtCNPJ - CNPJ

cdtIDForeign - Identificador único 

NameString50trueNome / Razão social
KindString
true

Tipo de pessoa

cktPhysical - Física 
cktLegal - Jurídica

TaxpayerString
False

Contribuinte de ICMS

yntYes - Sim
yntNo - Não

PublicAgencyString
False

Órgão público

yntYes - Sim
yntNo - Não

TaxRegimeInteger5FalseRegime de tributação
GlobalLimitDouble9, 2FalseValor limite global
DeadlineInteger3FalsePrazo máximo em dias
CreditStatusString
False

Situação do crédito

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

NoteString250FalseObservação
CardNumberInteger15FalseNúmero do cartão
BusinessSituationString
False

Situação comercial

bstReleased - Liberado 
bstBlocked - Bloqueado

KindAddressString
true

Tipo do endereço

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

PublicPlaceString60trueDescrição do logradouro
PublicPlaceNumberString10falseNúmero do logradouro
NeighbourhoodString50trueDescrição do bairro
ComplementString60falseComplemento de endereço
CityString60trueNome da cidade
FederativeUnitString2trueEstado da cidade
ZipCodeInteger8trueCep
IBGEInteger12falseCódigo da cidade no IBGE


Request Exemplo

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

Response Example

{
   "id":"{B0DAC044-3540-4EBF-988F-18BE345A9609}",
   "version":1,
   "person":{
      "identification":{
         "document":"11111111111",
         "personCode":0,
         "documentType":"cdtCPF",
         "identificationType":"citInternal"
      },
      "corporateName":"Razao social",
      "fantasyName":"Nome fantasia",
      "kind":"cktPhysical",
      "taxpayer":"yntYes",
      "publicAgency":"yntNo",
      "customer":{
         "taxRegime":1,
         "globalLimit":1000.5,
         "deadline":30,
         "lastConstraintDateTime":"2022-09-21T10:00:00.000Z",
         "creditStatus":"cstReleased",
         "note":"Observacao do cliente",
         "cardNumber":12345,
         "businessSituation":"bstReleased"
      },
      "customerSegments":[
         {
            "idSegment":1,
         },
         {
            "idSegment":2,
         }
      ],
      "addresses":[
         {
            "publicPlaceCode":1000,
            "kindAddress":"katMain",
            "publicPlace":"Rua nova uniao",
            "publicPlaceNumber":"100",
            "neighbourhood":"Santa Monica",
            "complement":"Cond Novo, bl 50 apto 400",
            "city":"Uberlandia",
            "federativeUnit":"MG",
            "zipCode":38411108,
            "iBGE":10
         },
         {
            "publicPlaceCode":500,
            "kindAddress":"katDelivery",
            "publicPlace":"Rua Araguari",
            "publicPlaceNumber":"95",
            "neighbourhood":"Centro",
            "complement":"Edif Plaza, 10 andar",
            "city":"Uberlandia",
            "federativeUnit":"MG",
            "zipCode":38411108,
            "iBGE":10
         },
         {
            "publicPlaceCode":71,
            "kindAddress":"katCorrespondence",
            "publicPlace":"Av Sebastiao Salgado",
            "publicPlaceNumber":"32",
            "neighbourhood":"Centro",
            "complement":"Edif Central, 15 andar",
            "city":"Uberlandia",
            "federativeUnit":"MG",
            "zipCode":38411108,
            "iBGE":10
         }
      ]
   }
}