DELIVERY ADDRESS | PCCLIENTENTEND | Referência rotina 3324 |
|
|
|
API | Referência Winthor | Descrição | Tipo(Tamanho) | Obrigatório | Observações |
---|
activityIdpcclientcodatv1Código da atividade do Cliente - aba dados cadastrais | NUMBER(6,0) | Sim | addressInfo | pcclient.enderent | Não | Esse parâmetro só é retornado no GET da requisição. Não é utilizado para gravar informações; | RAZAORECEBEDOR | Nome/Razão Social do Recebedor da mercadoria | VARCHAR2(60,0) | Não |
|
receiverEmail | PCCLIENTENTEND.EMAILRECEBEDOR | E-mail do Recebedor da mercadoria | VARCHAR2(60,0) | Não |
|
customerId | PCCLIENTENTEND.CODCLI | Código do cliente ao qual o endereço de entrega está vinculado | NUMBER(9,0) | Sim |
|
squareId | PCCLIENTENTEND.CODPRACAENT | Código da praça | NUMBER(6 |
billingAddress | pcclient.endercob | Endereço Cobrança - aba endereço cobrança | VARCHAR2(40,0) | Sim | billingAddressNumber | pcclient.numerocob | Numero do endereço de cobrança - aba endereço cobrança | VARCHAR2(6,0) | Não | billingDistrict | pcclient.bairrocob | Bairro - aba endereço cobrança | VARCHAR2(40billingIdpcclientcodcobCódigo de cobrança - aba posição financeira - valor padrão "D" | VARCHAR2(4,0) | Não | Data de cadastro do registro | DATE | Não | Se não enviado, será assumida a data no instante em que a requisição foi realizada; |
lastChangeDate | PCCLIENTENTEND.DTULTALTER | Identifica quando foi feita a última alteração | DATE | Não | Se não enviado, será assumida a data no instante em que a requisição foi realizada; |
zipCode | PCCLIENTENTEND.CEPENT | CEP de entrega |
billingState | pcclient.estcob | Estado - aba endereço cobrança | VARCHAR2(2,0) | Não | billingZipCode | pcclient.cepcob | CEP - aba endereço cobrançabranchParameterId | Filial de referência para considerar o parâmetro ALTERACLIAUTOECOMMERCE | Não | businessCity | pcclient.municent | Campo município - aba endereço comercial | VARCHAR2(15,0) | Não | Necessário para a consulta das outras informações na API de terceiros VIACEP |
state | PCCLIENTENTEND.ESTENT | Estado de |
businessCityId | pcclient.codcidadecom | Cidade - aba endereço entrega | NUMBER(6,0) | Não | Relaciona o ID da cidade cadastrado no banco de dados. |
businessDistrict | pcclient.bairroent | Bairro - aba endereço comercial | VARCHAR2(40,0) | Sim | businessState | pcclient.estent | Estado - aba endereço cityId | pcclient.codcidade | Cidade | NUMBER(10,0) | Sim | Relaciona o ID da cidade cadastrado no banco de dados. |
cnaeId | pcclient.codcnae | CNAE - aba capa | VARCHAR2(60,0) | Não | commercialAddress | pcclient.enderent | Endereço comercial - aba endereço comercial | VARCHAR2(40,0) | Sim | commercialAddressNumber | pcclient.numeroent | Numero do endereço comercial - aba endereço entrega | VARCHAR2(6,0) | Não | commercialZipCode | pcclient.cepcom | CEP - aba endereço entrega | VARCHAR2(9,0) | Sim | complementBillingAddress | pcclient.complementocob | Complemento endereço de cobrança - aba endereço cobrança | VARCHAR2(80,0) | Não | complementBusinessAddress | pcclient.complementoent | Complemento endereço de cobrança - aba endereço comercial | VARCHAR2(80,0) | Não | complementDeliveryAddress | pcclient.complementocom | Complemento endereço de cobrança - aba endereço entrega | VARCHAR2(80,0) | Não | corporate | pcclient.tipofj | Tipo de Pessoa - aba capa | VARCHAR2(1,0) | Sim | Campo Booleano. true é para pessoa jurídica("J") e false para pessoa física ("F"); Como padrão, caso parâmetro não seja enviado, será definido de acordo com o CGC informado, caso seja enviado um CPF será pessoa física ("F"), caso seja CNPJ será pessoa jurídica("J"). |
corporatePhone | pcclient.telent | Telefone - aba endereço comercial | VARCHAR2(13,0) | Não | O valor é criado na tabela 'pcclient.telent'. |
deliveryPhone | pcclient.telcom | Telefone comercial - aba endereço de entrega | VARCHAR2(13,0) | Não | O valor é criado na tabela 'pcclient.telcom'. |
billingPhone | pcclient.telcob | Telefone comercial - aba endereço de cobrança | VARCHAR2(13,0) | Não | O valor é criado na tabela 'pcclient.telcob'. |
countryId | pcclient.codpais | Caso o atrbuto "acceptValidateZipCodeOnline" seja enviado true, o campo não precisa ser enviado pois será gravado o estado retornado na API de terceiros VIACEP. Do contrário, o campo deve ser enviado na requisição. |
city | PCCLIENTENTEND.MUNICENT | Cidade de entrega | VARCHAR2(15,0) | Não | Caso o atrbuto "acceptValidateZipCodeOnline" seja enviado true, o campo não precisa ser enviado pois será gravada a cidade retornada na API de terceiros VIACEP. Do contrário, o campo deve ser enviado na requisição. |
district | PCCLIENTENTEND.BAIRROENT | Bairro de entrega | VARCHAR2(40,0) | Não | Caso o atrbuto "acceptValidateZipCodeOnline" seja enviado true, o campo não precisa ser enviado pois será gravado o bairro retornado na API de terceiros VIACEP. Do contrário, o campo deve ser enviado na requisição. |
address | PCCLIENTENTEND.ENDERENT | Endereço de entrega | NUMBER(40,0) | Não |
|
complement | PCCLIENTENTEND.COMPLEMENTOENT | Complemento de entrega | VARCHAR2(60,0) | Não |
|
cityId | PCCLIENTENTEND.CODCIDADE | Código da cidade de entrega |
Código do pais - aba endereço comercialSimcreateDatepcclientdtcadastroData e Hora de cadastro - aba dados cadastrais | NUMEROENT | Número do endereço de entrega | VARCHAR2(6 |
DATE(7Sim | O formato correto de envio é: "yyyy-MM-dd'T'HH:mm:ss.SSS". Sendo: yyyy para ano com quatro dígitos, MM para mês com dois dígitos, dd para dia com dois dígitos, HH para hora com dois dígitos, mm para minutos com dois dígitos, ss para segundos com dois dígitos, e SSS para milésimos com três dígitos. Exemplo de input válido: "2021-12-02T15:35:20.003". Para 'CustomerOrigin' sendo 'VT', o campo não é obrigatório e pega os dados do de data e horário da requisição. |
|
regionNumber | PCCLIENTENTEND.NUMREGIAO | Caso sistema trabalhe com tributação por endereço de entrega, e não utilize tributação por UF, no momento do cálculo dos impostos, será utilizada a região do endereço de entrega para impostos. | NUMBER(4 |
customerOrigin | Sim | Os valores aceitos para esse campo são: "VT" - VTEX; "WB" - WEB; "WTN" - Winthor não Web; "WTW" - WTA - Winthor Web; "N" - Nenhum; | deliveryAddress | pcclient.endercom | Endereço - aba endereço entrega | VARCHAR2(40deliveryAddressNumberpcclientnumerocomNumero Observações do cadastro de endereço de entrega |
- aba endereço entrega6deliveryDistrictpcclientbairrocomFANTASIA | Nome Fantasia para identificação do estabelecimento de |
Bairro - aba endereço 40deliveryStatepcclientestcomCEPRECEBEDOR | CEP do Recebedor da mercadoria |
Estado - aba endereço entrega2deliveryZipCodepcclientCEPENTCEP - aba endereço COMERCIAL | CODPAISRECEBEDOR | Código do pais do Recebedor da mercadoria | NUMBER(6 |
VARCHAR2(9document | Não | documentType* | pcclient.tipodocumento | Tipo de documento - aba condições comerciais - opções |
|
receiverPhone | PCCLIENTENTEND.FONERECEBEDOR | Telefone do Recebedor da mercadoria | NUMBER(14 |
VARCHAR2(1Os valores aceitos são 'A' para Ambos, 'C' para Cupom ou 'N' para Nota Fiscal. |
|
receiverStateInscription | PCCLIENTENTEND.IERECEBEDOR | Inscrição estadual do Recebedor da mercadoria | NUMBER(14 |
email | pcclient.email | E-mail - aba endereço comercial | VARCHAR2(100SimemailNfepcclientemailnfeLATITUDE | Indica a Latitude |
E-mail NF-e - aba endereço comercial3500Caso esse parâmetro não seja enviado, será replicado o valor do campo 'email' para o 'emailNfe'. |
|
longitude | PCCLIENTENTEND.LONGITUDE | Indica a Longitude | VARCHAR2(20 |
finalCostumer | pcclient.consumidorfinal | Consumidor Final - aba condições comerciais - opções | VARCHAR2(1Campo booleano. true para 'S', false para 'N'. | ibgeId | pccidade.codibge | NUMBER(10,0) | Não | Não é um campo obrigatório porém por redundância, o cliente pode envia-lo para verificar se o ID do IBGE existe no banco de dados. Campo utilizado no POST somente para validação de dados - e o envio deve ser feito pelo body como String. |
|
referencePoint | PCCLIENTENTEND.PONTOREFER | Indica o Ponto de Referência | VARCHAR2(80 |
id* | pcclient.codcli | Código - aba capa | VARCHAR2(9lastChangepcclient.dtultalter | Data e Hora da última alteração - aba dados cadastrais | - | Origem do cliente | VARCHAR2(3 |
DATE(7O formato correto de envio é: "yyyy-MM-dd'T'HH:mm:ss.SSS". Sendo: yyyy para ano com quatro dígitos, MM para mês com dois dígitos, dd para dia com dois dígitos, HH para hora com dois dígitos, mm para minutos com dois dígitos, ss para segundos com dois dígitos, e SSS para milésimos com três dígitos. Exemplo de input válido: "2021-12-02T15:35:20.003". | name | pcclient.cliente | Campo cliente - Nome do cliente - aba capa | VARCHAR2(60,0) | Sim | paymentPlanId | pcclient.codplpag | Plano de pagamento - aba condições comerciais - parâmetros | NUMBER(4,0) | Não | personIdentificationNumber | pcclient.cgcent | CNPJ/CPF - aba capa | VARCHAR2(18,0) | Sim | phone | *Não é gravado em tabela nenhuma | Telefone comercial - aba endereço comercial | VARCHAR2(13,0) | Não | sellerId | pcclient.codusur1 | RCA 1 - Código do RCA | NUMBER(4,0) | Sim | squareId | pcclient.codpraca | Campo praça - endereço comercial | NUMBER(6,0) | Sim | stateInscription | pcclient.ieent | Ins. Est./ Produtor - aba dados cadastrais: Informar Inscrição Estadual. Caso não tenha, informar ISENTO. | VARCHAR2(15,0) | Sim | tradeName | pcclient.fantasia | Fantasia - aba capa | VARCHAR2(40,0) | Não | permissions.acceptValidateZipCodeOnline | boolean | Não | Default: true
Em caso de 'false' a aplicação não irá validar se o CEP está valido em API terceiros (ViaCEP e ByJG)
Obs: opção disponível a partir da versão: 1.2.0.1087
("VT", "Vtex"), ("WB", "Web"), ("WTN", "Winthor não Web"), ("WTW", "WTA - Winthor Web"), ("N", "Nenhum"); Só haverá consulta de informações complementares na API de terceiros VIACEP (cidade, estado e bairro) se a origem for igual a "VT"; |
permissions.acceptValidateZipCodeOnline | - | Permissão que indica se a API deverá realizar a consulta online do CEP (VIACEP) | boolean | Não | Default true; |