Associado

Pesquisar Associado

get

Retorna a lista de associados conforme parâmetros.

O associado poderá se repetir na lista em virtude de possuir mais de um benefício.

Necessário informar um dos seguintes parâmetros:

  • 'codPessoa'
  • 'nome'
  • 'cpf' ou 'cnpj'
  • 'dataCadastroInicial' e 'dataCadastroFinal'
  • 'dataNascimento'
  • 'situacaoBeneficio'
  • 'placa' ou 'chassi'
Autorizações
Parâmetros de consulta
nomestringOpcional
cpfstringOpcional
cnpjstringOpcional
cnpjEmpresastringOpcional
codPessoainteger · int32Opcional
codLojainteger · int32Opcional
codConsultorinteger · int32Opcional
codRepresentanteinteger · int32Opcional
dataCadastroInicialstringOpcionalExample: dd/MM/yyyyPattern: ^(\d{2}/\d{2}/\d{4})?$
dataCadastroFinalstringOpcionalExample: dd/MM/yyyyPattern: ^(\d{2}/\d{2}/\d{4})?$
dataNascimentostringOpcionalExample: dd/MM/yyyyPattern: ^(\d{2}/\d{2}/\d{4})?$
situacaoBeneficiostringOpcional
placastringOpcional
chassistring · máx: 20Opcional
codPlanointeger · int32 · máx: 2147483647Opcional
ufstringOpcional
dataAtualizacaostringOpcional

Data referente a última atualização do associado ou benefício.

Example: dd/MM/yyyyPattern: ^(\d{2}/\d{2}/\d{4})?$
Respostas
200
Lista de benefícios
application/json
get
GET /siprov-api/ext/associado HTTP/1.1
Host: acesso.siprov.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "categoriaCnh": "A",
  "chassi": "text",
  "codBeneficio": 1,
  "codPessoa": 1,
  "conjuge": "text",
  "cpfCnpj": "text",
  "cpfCnpjResponsavelFinanceiro": "text",
  "dadosAdicionais": [
    {
      "nome": "text",
      "valor": {}
    }
  ],
  "dataAdesao": "text",
  "dataAtivacao": "text",
  "dataCadastro": "text",
  "dataNascimento": "text",
  "email": "text",
  "endereco": {
    "bairro": "text",
    "cep": "text",
    "cidade": "text",
    "complemento": "text",
    "logradouro": "text",
    "numero": "text",
    "tipoEndereco": "text",
    "tipoLogradouro": "text",
    "uf": "text"
  },
  "enderecoResponsavelFinanceiro": {
    "bairro": "text",
    "cep": "text",
    "cidade": "text",
    "complemento": "text",
    "logradouro": "text",
    "numero": "text",
    "tipoEndereco": "text",
    "tipoLogradouro": "text",
    "uf": "text"
  },
  "faturarParaEmpresa": true,
  "idade": 1,
  "identidade": "text",
  "nomeEmpresa": "text",
  "nomeMae": "text",
  "nomePai": "text",
  "nomePessoa": "text",
  "nomeResponsavelFinanceiro": "text",
  "numeroCartaoDesconto": "text",
  "numeroCnh": "text",
  "placa": "text",
  "planos": [
    {
      "codPlano": 1,
      "nome": "text",
      "valor": 1
    }
  ],
  "sequencial": 1,
  "sexo": "text",
  "situacao": "text",
  "telefoneCelular": "text",
  "telefoneFixo": "text",
  "tipoBeneficio": "text",
  "tipoSituacao": "text"
}

Gravar Associado

post

Grava os dados básicos da pessoa, vinculando o cadastro pelo CPF/CNPJ.

Atente-se para os seguintes campos, que tem opções fixas:

  • 'natureza': 'F' ou 'J'
  • 'sexo': 'Feminino' ou 'Masculino'
  • 'telefones' -> 'tipo': 'Fixo' ou 'Celular'
Autorizações
Corpo
codLojainteger · int32Opcional
codPessoainteger · int32Opcional
codigoIntegracaostringOpcional
cpfCnpjstringOpcional
dataExpedicaostringOpcionalPattern: ^(\d{4}\-\d{2}\-\d{2})?$
dataNascimentostringOpcionalPattern: ^(\d{4}\-\d{2}\-\d{2})?$
emailstringOpcional
identidadestring · máx: 25Opcional
naturezastring · enumOpcionalValores possíveis:
nomeFantasiastring · máx: 100Opcional
nomePessoastring · mín: 1 · máx: 250Opcional
observacaostringOpcional
orgaoExpedidorstring · máx: 20Opcional
sexostring · enumOpcionalValores possíveis:
Respostas
200
Cadastro gravado com sucesso
application/json
post
POST /siprov-api/ext/associado HTTP/1.1
Host: acesso.siprov.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 490

{
  "codLoja": 1,
  "codPessoa": 1,
  "codigoIntegracao": "text",
  "cpfCnpj": "text",
  "dataExpedicao": "text",
  "dataNascimento": "text",
  "email": "text",
  "endereco": {
    "bairro": "text",
    "cep": "text",
    "cidade": "text",
    "complemento": "text",
    "logradouro": "text",
    "numero": "text",
    "tipoEndereco": "text",
    "tipoLogradouro": "text",
    "uf": "text"
  },
  "identidade": "text",
  "natureza": "F",
  "nomeFantasia": "text",
  "nomePessoa": "text",
  "observacao": "text",
  "orgaoExpedidor": "text",
  "sexo": "Feminino",
  "telefones": [
    {
      "numero": "text",
      "tipo": "Fixo"
    }
  ]
}
{
  "codPessoa": 1
}

Isto foi útil?