PUT Terceiros - Varejonline/api GitHub Wiki

Terceiros são quaisquer pessoas físicas ou jurídicas cadastradas no sistema. Estão neste grupo os clientes, funcionários, fornecedores e todas pessoas com as quais a empresa tem relação.

URL

PUT https://integrador.varejonline.com.br/apps/api/terceiros/:id_terceiro

Parâmetros

Envie um JSON no corpo da requisição, contendo:

padraoNome: informar "NOME_FANTASIA" ou "RAZAO_SOCIAL" para indicar ao sistema qual nome convencionar na apresentação em tela (string)
nome: nome do terceiro (string) (obrigatório) (max 255 char)
nomeFantasia: nome fantasia da empresa, utilizado apenas para pessoa jurídica (string) (obrigatório) (max 255 char)
documento: CPF ou CNPJ do terceiro com/sem formatação (string) (obrigatório)
emails: emails do terceiro (List string) (max 255 char)
rg: número do RG do terceiro. Apenas para terceiro com documento de Pessoa Física (string) (max 50 char)
dataNascimento data de nascimento do terceiro quando Pessoa Física (dd-mm-aaaa)
ie: número da Inscrição Estadual do terceiro. Apenas para terceiro com documento de Pessoa Jurídica (string) (max 255 char)
entidadeCadastro: id da entidade de cadastro do terceiro(long)
ativo: indica se o terceiro está ativo ou não (boolean) (caso não informado assume valor "true")
enderecos: lista de endereços do terceiro, contendo:
- tipo: tipo do logradouro (string). Exemplos: RUA, AVENIDA, RODOVIA. Veja a lista completa
- logradouro: nome do logradouro (string) (max 255 char)
- numero: número do endereco (string) (max 400 char)
- bairro: bairro do endereco (string) (max 255 char)
- cep: CEP do endereco sem máscara (string)
- codigoIBGECidade: código do IBGE da cidade (string) (Não incluir o atributo quando seu conteúdo for vazio)
- tipoEndereco: Tipo do Endereço (string)
- pais: País do Endereço (string)
- uf: sigla em caixa alta da UF do endereço (string) (Se estrangeiro enviar "EX") (apenas para pais diferente do BRASIL) (opcional)
- cidade: nome da cidade (string) (apenas para pais diferente do BRASIL) (opcional) (max 255 char)
telefones: lista de telefones do terceiro, contendo: (opcional)
- ddd: Código do DDD (int) (obrigatório) (max 10 char)
- ddi: Código do DDI (int) (obrigatório) (max 10 char)
- numero: Número do telefone (string) (obrigatório) (max 255 char)
- ramal: Número do ramal (int) (obrigatório) (max 10 char)
- tipoTelefone: CELULAR, RESIDENCIAL, COMERCIAL, RECADO (string) (opcional, padrão: COMERCIAL)
classes: lista de classes às quais o terceiro pertence. (opcional)
categoria: Define a categorização do terceiro no Varejonline (string) (opcional)
autorizaReceberEmail: Opt-in do terceiro autorizando ou não a comunicação por email (boolean) (opcional, padrão: false)
autorizaReceberSms: Opt-in do terceiro autorizando ou não a comunicação por sms (boolean) (opcional, padrão: false)
limiteCredito: Define os valores de limite de crédito para o terceiro (objeto complexo) (opcional)
- valorTotal: limite de crédito total (Decimal) (opcional)
- valorMensal: limite de crédito mensal (Decimal) (opcional)
- valorRenda: valor da renda do terceiro (Decimal) (opcional)
camposCustomizados: Define os valores da estrutura de campos customizados da base. (opcional)
- id: id do terceiro associado aos valores informados (long)
- valoresPrimitivo: valores dos campos customizados primitivos
  - id: id do campo customizado (long)
  - value: valor do campo customizado (object - varia conforme tipagem do campo)
  - type: tipo do campo customizado (string)
- valoresComposicao: valores dos campos customizados do tipo COMPOSICAO
  - id: id do campo customizado (long)
  - valores: lista de valores primitivos
    - id: id do campo customizado (long)
    - value: valor do campo customizado (object - varia conforme tipagem do campo) (max para string 255 BYTE)
    - type: tipo do campo customizado (string)
- valoresLista: valores dos campos customizados do tipo LISTA
  - campoId: id do campo customizado retornado pela lista (long)
  - valoresPrimitivo: lista de valores primitivos
    - id: id do campo customizado (long)
    - value: valor do campo customizado (object - varia conforme tipagem do campo) (max para string 255 BYTE)
    - type: tipo do campo customizado (string)
  - valoresComposicao: valores dos campos customizados do tipo COMPOSICAO
    - id: id do campo customizado (long)
    - valores: lista de valores primitivos
      - id: id do campo customizado (long)
      - value: valor do campo customizado (object - varia conforme tipagem do campo) (max para string 255 BYTE)
      - type: tipo do campo customizado (string)
marcas: lista de marcas do terceiro, contendo: (opcional)
- autorizaReceberSms: limite de crédito total (boolean) (opcional, padrão: false)
- autorizaReceberEmail: limite de crédito total (boolean) (opcional, padrão: false)
- autorizaReceberWhatsapp: limite de crédito total (boolean) (opcional, padrão: false)
- marca: informações da marca
  - id: id da marca (long)
  - nome: nome da marca (string) (max 255 char)

Sucesso:

HTTP STATUS 201 – CREATED
Body:

{
      "idRecurso": 1,
      "codigoMensagem": 0,
      "mensagem": "Operação realizada com sucesso."
}

Requisição inválida:

HTTP STATUS 400 – BAD REQUEST
Body:

{
      "idRecurso": 0,
      "codigoMensagem": 1,
      "mensagem": "Terceiro com documento inválido"
}

Exemplo

PUT https://integrador.varejonline.com.br/apps/api/terceiros/:id_terceiro

'Content-Type'='application/json'

{
   "nome":"Nome do terceiro",
   "documento":"023.168.132-00",
   "emails":[
      "[email protected]",
      "[email protected]"
   ],
   "rg":"42.943.412-1",
   "dataNascimento":"11-08-1980",
   "enderecos":[
      {
         "tipo":"AVENIDA",
         "logradouro":"9 de Julho",
         "numero":"900",
         "bairro":"CENTRO",
         "cep":"12000111",
         "uf":"SP",
         "codigoIBGECidade":"3554102",
         "tipoEndereco":"ENDERECO_CORRESPONDENCIA"
      },
      {
         "tipo":"RUA",
         "logradouro":"15 de Novembro",
         "numero":"1020",
         "bairro":"JD. MARIA",
         "cep":"12600123",
         "uf":"SP",
         "codigoIBGECidade":"3554102",
         "tipoEndereco":"ENDERECO_SEDE"
      }
   ],
   "telefones":[
      {
         "ddi":"55",
         "ddd":"12",
         "numero":"12341234",
         "tipoTelefone":"RESIDENCIAL" 
      },
      {
         "ddi":"0",
         "ddd":"31",
         "numero":"12340000",
         "ramal":"1234",
         "tipoTelefone":"CELULAR" 
      }
   ],
   "classes":[
      "SOCIO_PROPRIETARIO",
      "FUNCIONARIO"
   ],
   "categoria": "CLIENTES VIP",
   "autorizaReceberEmail": false,
   "autorizaReceberSms": true,
   "marcas": [
        {
            "autorizaReceberSms": false,
            "autorizaReceberEmail": false,
            "autorizaReceberWhatsapp": true,
            "marca": {
                "id": 283,
                "nome": "TESTE"
            }
        },
        {
            "autorizaReceberSms": true,
            "autorizaReceberEmail": false,
            "autorizaReceberWhatsapp": false,
            "marca": {
                "id": 0,
                "nome": "SEM MARCA"
            }
        }
   ]
}