DELIVERY ADDRESS | PCCLIENTENTEND | Referência rotina 3324 |
|
|
|
API | Referência Winthor | Descrição | Tipo(Tamanho) | Obrigatório | Observações |
---|
activityId | pcclient.codatv1 | Código da atividade do Cliente - aba dados cadastrais | NUMBER(6,0) | Sim | branchParameterId | Filial de referência para considerar o parâmetro CODPRACACIASHOP |
|
|
|
|
receiverName | PCCLIENTENTEND.RAZAORECEBEDOR | Nome/Razão Social do Recebedor da mercadoria | VARCHAR2(60 |
addressInfo | pcclient.enderent | Não | Esse parâmetro só é retornado no GET da requisição. Não é utilizado para gravar informações; | 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(6billingDistrictpcclientbairrocobBairro - aba endereço cobrançaE-mail do Recebedor da mercadoria | VARCHAR2( |
40billingIdpcclientcodcob de cobrança - aba posição financeira - valor padrão "D"do cliente ao qual o endereço de entrega está vinculado | NUMBER(9 |
VARCHAR2(4NãobillingStatepcclientestcobCODPRACAENT | Código da praça | NUMBER(6 |
Estado - aba endereço cobrança | VARCHAR2(2billingZipCodepcclientcepcobCEP - aba endereço cobrança | VARCHAR2(9,0) | Sim | branchParameterId | 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 | DTCADASTRO | 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 | VARCHAR2(9,0) | Sim | 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 Não | cityId | pcclient.codcidade | Cidade | NUMBER(10,0) | Relaciona 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 | parâmetro 4672 da rotina 132 esteja marcado como sim, 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) | Sim | Caso o parâmetro 4672 da rotina 132 esteja marcado como sim, 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) | Sim | Caso o parâmetro 4672 da rotina 132 esteja marcado como sim, 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) | Sim |
|
complement | PCCLIENTENTEND.COMPLEMENTOENT | Complemento de entrega | VARCHAR2(60,0) | Não |
|
cityId | PCCLIENTENTEND.CODCIDADE | Código da cidade de entrega |
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 | Código do pais - aba endereço comercialcreateDate | pcclient.dtcadastro | Data e Hora de cadastro - aba dados cadastrais | DATE(7,0) | Sim | 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. |
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 | Caso não enviado é realizada uma busca pelo código do IBGE (retornado na validação online do CEP, no caso do parâmetro 4672 estar marcado como sim) e se não encontrado é feita a busca pelo nome da cidade e estado; |
number | PCCLIENTENTEND.NUMEROENT | Número do endereço de entrega | VARCHAR2(6 |
VARCHAR2(40deliveryAddressNumberpcclientnumerocomNumero do endereço de entrega - aba endereço entrega | 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 |
VARCHAR2(6deliveryDistrictpcclientbairrocomOBSERVACAO | Observações do cadastro de endereço de |
Bairro - aba endereço 40deliveryStatepcclientestcomFANTASIA | Nome Fantasia para identificação do estabelecimento de |
Estado - aba endereço 2deliveryZipCodepcclientCEPENT - aba endereço COMERCIALdo Recebedor da mercadoria | VARCHAR2(9,0) | Não |
document | Não | documentType* | pcclient.tipodocumento | Tipo de documento - aba condições comerciais - opções |
|
receiverCountryId | PCCLIENTENTEND.CODPAISRECEBEDOR | Código do pais do Recebedor da mercadoria | NUMBER(6 |
VARCHAR2(1Os valores aceitos são 'A' para Ambos, 'C' para Cupom ou 'N' para Nota Fiscal. | email | pcclient.email | E-mail - aba endereço comercial |
|
receiverPhone | PCCLIENTENTEND.FONERECEBEDOR | Telefone do Recebedor da mercadoria | NUMBER(14 |
VARCHAR2(100SimemailNfepcclientemailnfeE-mail NF-e - aba endereço comercial | IERECEBEDOR | Inscrição estadual do Recebedor da mercadoria | NUMBER(14 |
VARCHAR2(3500Caso esse parâmetro não seja enviado, será replicado o valor do campo 'email' para o 'emailNfe'. | finalCostumer | pcclient.consumidorfinal | Consumidor Final - aba condições comerciais - opções |
|
latitude | PCCLIENTENTEND.LATITUDE | Indica a Latitude | VARCHAR2(20 |
VARCHAR2(1Campo booleano. true para 'S', false para 'N'. |
|
longitude | PCCLIENTENTEND.LONGITUDE | Indica a Longitude | VARCHAR2(20 |
ibgeId | pccidade.codibge | NUMBER(10Nã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(9lastChange | pcclient.dtultalter | Data e Hora da última alteração - aba dados cadastrais | DATE(7,0) | Sim | 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". |
name | pcclient.cliente | Campo cliente - Nome do cliente - aba capa |
|
customerOrigin | - | Origem do cliente | VARCHAR2(3 |
VARCHAR2(60paymentPlanId | 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"; |