Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Deck of Cards
idversções
Card
labelV3.1 (V2)

Requisição

Section
Column
width50%

Exemplo de body da requisição

[
    {
        "atividade": "string",
        "avatarUrl": "string",
        "bairro": "string",
        "celular": "string",
        "cep": "string",
        "cidade": "string",
        "complemento": "string",
        "cpfCnpj": "string",
        "cracha": "string",
        "dataNascimento": "2024-04-02T18:58:17.727Z",
        "email": "string",
        "endereco": "string",
        "estado": "string",
        "estadoCivil": 0,
        "idInquilino": "string",
        "idProprietario": "string",
        "idRetaguarda": "string",
        "loteOrigem": "string",
        "nome": "string",
        "numero": "string",
        "pessoaFisica": 0,
        "rgInscricao": "string",
        "sexo": 0,
        "situacao": 0,
        "telefone": "string",

        "IdProfissionalRetaguarda": string"
    }
]

Column
width50%

Definições dos campos do body

Campo

Tipo

Descrição

Obrigatório

Observações

atividadeStringAtividade

Não

Tamanho máximo: 500 caracteres

avatarUrlStringAvatar do clienteNãoTamanho máximo: 300caracteres
bairroStringBairro principal do cliente

Não

Tamanho máximo: 100 caracteres

celularStringCelular do cliente

Não

Tamanho máximo:  20 caracteres

cepStringCEP do endereço principal do cliente

Não

Tamanho máximo: 10 caracteres

cidadeStringCidade principal do cliente

Não

Tamanho máximo: 100 caracteres

complementoStringComplemente do endereço principal do cliente

Não

Tamanho máximo: 50 caracteres

cpfCnpjStringCPF ou CNPJ do cliente

Sim

Tamanho máximo: 14 caracteres

crachaStringCrachá

Não

Tamanho máximo: 20 caracteres

dataNascimentoDatetime

Data de nascimento do cliente

Não
emailStringEmail do cliente

Não

Tamanho máximo: 80 caracteres

enderecoStringEndereço principal do cliente

Não

Tamanho máximo: 150 caracteres

estadoStringEstado principal do cliente

Não

Tamanho máximo: 30 caracteres

estadoCivilIntIndica o estado civil do cliente (Descritivo abaixo)

Não

Código

Descrição

0Não informado
1Casado
2Solteiro
3Viúvo
4Separado
5Devorciado
6Outros
idInquilinoString

Identificador do inquilino 

Sim
idProprietarioStringIdentificador do proprietárioSim
idRetaguardaStringIdentificador do cliente na retaguardaSimTamanho máximo: 100 caracteres
loteOrigemStringIdentificador do lote em que serão enviados os dadosSim
nomeStringNome do cliente

Sim

Tamanho máximo: 200 caracteres

numeroStringNúmero do endereço principal do cliente

Não

Tamanho máximo: 15 caracteres

pessoaFisicaIntIndica se o cliente é uma pessoa física ou jurídicaSim
rgInscricaoStringRG do cliente

Não

Tamanho máximo: 25 caracteres

sexoIntIndica o genero do cliente (Descritivo abaixo)

Não

CódigoDefinição
0Não Definido
1Masculino
2Feminino
situacaoIntSituação do cliente 

Sim

0 - Inativo, 1 - Ativo
telefoneStringTelefone do cliente

Não

Tamanho máximo: 20 caracteres

IdProfissionalRetaguardaStringId do Profissional vinculado ao cliente

Não

Tamanho máximo: 100 caracteres

Retorno

Deck of Cards
idretornos
Card
label200 - Ok
Column
width50%

Exemplo de body de retorno

{
    "success": true,
    "message": "Requisição inserida com sucesso!",
    "data": null,
    "errors": null,
    "totalTime": 0,
    "numberOfRecords": 0
}

Column
width50%

Definições dos campos do retorno

Campo

Tipo

Descrição

SuccessboolIndica se a criação do compartilhamento foi feita com sucesso
MessagestringCaso ocorra erros durante a criação do compartilhamento eles serão enviados nesse campo
DataobjetoObjeto compartilhamento criado
ErrorsListaListas com os erros encontrados no processo
TotalTimeinttempo da requisição
NumberOfRecordsintnúmero de dados inseridos
Card
label400 - Bad Request
Aviso

Devido a arquitetura implentada temos dois retornos de erros que foram padronizados na versão três deste endpoint

Deck of Cards
idclienteBadRequest
Card
labelCaso 1
Informações

Este retorno ocorre quando um campo enviado não passa pela validação, por exemplo, não enviar um dado obrigatório

Column
width50%

{
    "code": "string",
    "message": "string",
    "detailedMessage": "string",
    "helpUrl": "string",
    "details": [
        {
            "guid": "string",
            "code": "string",
            "message": "string",
            "detailedMessage": "string"
        }
    ]
}

Column
width50%

Campo

Tipo

Descrição

codestringCódigo de erro
messagestringMensagem do erro
detailedMessagestringDetalhamento do erro
helpUrlstringurl de ajuda
TotalTimestringTempo total de busca
detailslista de objetoLista de objeto de erros
details.guidstringIdentificador do erro
details.codestringCódigo do erro
details.messagestringMensagem do erro 
details.detailedMessagestringDetalhamento do erro
Card
labelCaso 2
Informações

Este retorno ocorre quando algo na aplicação não ocorreu da forma esperada, por exemplo, quando uma excessão é lançada pela aplicação

Section
Column
width50%

{
    "success": false,
    "message": "",
    "data": null,
    "errors": null,
    "totalTime": 0,
    "numberOfRecords": 0
}

Column
width50%

Campo

Tipo

Descrição

SuccessboolIndica se a criação do cliente foi feita com sucesso
MessagestringMessagem com os erros
DataobjetoObjeto cliente
ErrorsListaListas com os erros encontrados no processo
TotalTimeinttempo da requisição
NumberOfRecordsintnúmero de dados inseridos
Card
labelV3.2
Informações

Este endpoint ainda está em processo de manutenção, as informações estão disponibilizadas apenas para consulta, não sendo possível realizar a requisição.

Requisição

Section
Column
width50%

Exemplo de body da requisição

[
    {
        "atividade": "string",
        "avatarUrl": "string",
        "bairro": "string",
        "celular": "string",
        "cep": "string",
        "cidade": "string",
        "complemento": "string",
        "cpfCnpj": "string",
        "cracha": "string",
        "dataNascimento": "2024-04-02T18:58:17.727Z",
        "descricao": "string",
        "email": "string",
        "endereco": "string",
        "estado": "string",
        "estadoCivil": 0,
        "idInquilino": "string",
        "idProprietario": "string",
        "idRetaguarda": "string",
        "loteOrigem": "string",
        "nome": "string",
        "numero": "string",
        "pessoaFisica": 0,
        "rgInscricao": "string",
        "sexo": 0,
        "situacao": 0,
        "telefone": "string",
        "tipoEndereco": 0,

         "idProfissionalRetaguarda": "string"
    }
]

Column
width50%

Definições dos campos do body

Campo

Tipo

Descrição

Obrigatório

Observações

nomeStringNome do cliente

Sim

Tamanho máximo: 250 caracteres

enderecoStringEndereço principal do cliente

Não

Tamanho máximo: 150 caracteres

numeroStringNúmero do endereço principal do cliente

Não

Tamanho máximo: 15 caracteres

complementoStringComplemente do endereço principal do cliente

Não

Tamanho máximo: 50 caracteres

bairroStringBairro principal do cliente

Não

Tamanho máximo: 100 caracteres

cidadeStringCidade principal do cliente

Não

Tamanho máximo: 100 caracteres

estadoStringEstado principal do cliente

Não

Tamanho máximo: 30 caracteres

cepStringCEP do endereço principal do cliente

Não

Tamanho máximo: 10 caracteres

telefoneStringTelefone do cliente

Não

Tamanho máximo: 20 caracteres

celularStringCelular do cliente

Não

Tamanho máximo:  20 caracteres

emailStringEmail do cliente

Não

Tamanho máximo: 80 caracteres

dataNascimentoDatetime

Data de nascimento do cliente

Não
situacaoIntSituação do cliente 

Sim

0 - Inativo, 1 - Ativo

pessoaFisicaIntIndica se o cliente é uma pessoa física ou jurídicaSim0 - Pessoa Física, 1 - Pessoa Jurídica
cpfCnpjStringCPF ou CNPJ do cliente

Não

Tamanho máximo: 25 caracteres

rgInscricaoStringRG do cliente

Não

Tamanho máximo: 25 caracteres

sexoIntIndica o genero do cliente 

Não

DescriçãoCódigo
Não informado0
Masculino1
Feminino2
estadoCivilIntIndica o estado civil do cliente

Não

DescriçãoCódigo
Não informado0
Casado1
Solteiro2
Viúvo3
Separado4
Devorciado5
Outros6
avatarUrlStringDEFASADONãoDEFASADO
atividadeStringAtividade

Não

Tamanho máximo: 500 caracteres

crachaStringDEFASADO

Não

DEFASADO

idInquilinoString

Identificador do inquilino 

Sim
idRetaguardaStringIdentificador do cliente na retaguardaSimTamanho máximo: 100 caracteres
idProprietarioStringIdentificador do proprietárioSim
loteOrigemStringIdentificador do lote em que serão enviados os dadosSim
tipoEnderecoIntTipo EndereçoNão
DescriçãoCódigo
Entrega0
Comercial1
Cobrança2
descricaoStringDescriçãoNão

Tamanho maxímo: 100 caracteres

idProfissionalRetaguardaStringId do Profissional vinculado ao clienteNão

Tamanho maxímo: 100 caracteres

Retornos

Deck of Cards
idretornos
Card
label200 - Ok
Column
width50%

Exemplo de body de retorno

{
    "success": true,
    "message": "Requisição inserida com sucesso!",
    "data": null,
    "errors": null,
    "totalTime": 0,
    "numberOfRecords": 0
}

Column
width50%

Definições dos campos do retorno

Campo

Tipo

Descrição

SuccessboolIndica se a criação do compartilhamento foi feita com sucesso
MessagestringCaso ocorra erros durante a criação do compartilhamento eles serão enviados nesse campo
DataobjetoObjeto compartilhamento criado
ErrorsListaListas com os erros encontrados no processo
TotalTimeinttempo da requisição
NumberOfRecordsintnúmero de dados inseridos
Card
label400 - Bad Request
Column
width50%

Exemplo de body de retorno

{
    "code": "string",
    "message": "string",
    "detailedMessage": "string",
    "helpUrl": "string",
    "details": [
        {
            "guid": "string",
            "code": "string",
            "message": "string",
            "detailedMessage": "string"
        }
    ]
}

Column
width50%

Definições dos campos do retorno

Campo

Tipo

Descrição

codestringCódigo de erro
messagestringMensagem do erro
detailedMessagestringDetalhamento do erro
helpUrlstringurl de ajuda
TotalTimestringTempo total de busca
detailslista de objetoLista de objeto de erros
details.guidstringIdentificador do erro
details.codestringCódigo do erro
details.messagestringMensagem do erro 
details.detailedMessagestringDetalhamento do erro

...