Árvore de páginas

Versões comparadas

Chave

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


TDN MIGRADO  Cliente

Este método é responsável pela criação de novos Clientes

...

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

Requisição

Section
Column
width50%

Exemplo de body da requisição

[
    {
        "bairro": "string",
        "cep": "string",
        "cidade": "string",
        "complemento": "string",
        "endereco": "string",
        "enviarPnet": 0,
        "estado": "string",
        "idCliente": 0,
        "idClienteRetaguarda": "string",
        "idInquilino": "string",
        "idProprietario": "string",
        "idRetaguarda": "string",
        "loteOrigem": "string",
        "numero": "string",
        "situacao": 0,
        "tipoEndereco": 0
    }
]


Column
width50%

Definições dos campos do body

Campo

Tipo

Descrição

Obrigatório

Observações

idClienteRetaguardaStringIdentificador do cliente na retaguardaSimTamanho máximo: 100 caracteres
enderecoStringEndereçoNãoTamanho máximo: 150 caracteres
numeroStringNúmero do endereçoNãoTamanho máximo: 15 caracteres
complementoStringComplemento do endereçoNãoTamanho máximo: 50 caracteres
bairroStringBairroNãoTamanho máximo: 100 caracteres
cidadeStringCidadeNãoTamanho máximo: 100 caracteres
estadoStringEstadoNãoTamanho máximo: 30 caracteres
cepStringCEP do endereçoNãoTamanho máximo: 10 caracteres
situacaoIntSituação do endereço Sim0 - Inativo, 1 - Ativo
tipoEnderecoIntTipo endereço Não

Código

Tipo

0Entrega
1Comercial
2Cobranca
idInquilinoStringIdentificador do inquilino
Não
Sim
idRetaguardaStringIdentificador do endereço na retaguarda
Não
SimTamanho máximo: 100 caracteres
idProprietarioStringIdentificador do proprietário
Não
Sim
loteOrigemStringIdentificado do lote em que serão enviados os dados
Não
Sim

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

Section
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



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%

Exemplo de body de retorno

{
    "success": false,
    "message": "",
    "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 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

[
    {
        "bairro": "string",
        "cep": "string",
        "cidade": "string",
        "complemento": "string",
        "descricaoTipo": "string",
        "endereco": "string",
        "enviarPnet": 0,
        "estado": "string",
        "idCliente": 0,
        "idClienteRetaguarda": "string",
        "idInquilino": "string",
        "idProprietario": "string",
        "idRetaguarda": "string",
        "loteOrigem": "string",
        "numero": "string",
        "situacao": 0,
        "tipoEndereco": 0
    }
]

Column
width50%

Definições dos campos do body

CampoTipoDescriçãoObrigatórioObservações
idClienteRetaguardaStringIdentificador do cliente na retaguardaSim
descricaoTipoStringDescrição do tipo do endereçoNão
enderecoStringEndereçoNãoTamanho máximo: 150 caracteres
numeroStringNúmero do endereçoNãoTamanho máximo: 15 caracteres
complementoStringComplemento do endereçoNãoTamanho máximo: 50 caracteres
bairroStringBairroNãoTamanho máximo: 100 caracteres
cidadeStringCidadeNãoTamanho máximo: 100 caracteres
estadoStringEstadoNãoTamanho máximo: 30 caracteres
cepStringCEP do endereçoNãoTamanho máximo: 10 caracteres
situacaoIntSituação do endereço Sim0 - Inativo, 1 - Ativo
tipoEnderecoIntTipo endereço.Não
CódigoTipo
0Entrega
1Comercial
2Cobranca
idInquilinoStringIdentificador do inquilinoSim
idRetaguardaStringIdentificador do endereço na retaguardaSim
idProprietarioStringIdentificador do proprietárioSim
loteOrigemStringIdentificado do lote em que serão enviados os dadosSim
enviapnetIntIdentifica se esse endereço vai ser enviado do PDV para a retaguardaNão
idClienteIntIdentificador do cliente no PDVNão


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
Expandir
titleDefinição dos campos de retorno
Expandir
title200 - Ok

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
Expandir
title400 - 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

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

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
Expandir
titleBody de retorno
{
    "success": false,
    "message": "",
    "data": null,
    "errors": null,
    "totalTime": 0,
    "numberOfRecords": 0
}