Árvore de páginas

Versões comparadas

Chave

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

...

  • Endpoint: /api/retaguarda/v2/clienteenderecos
  • Versão: 2
  • Método: Post
  • Autenticação: Bearer token
  • Permissão: Retaguarda

Este endpoint recebe uma lista de Cliente endereço]s endereços para que possam ser enviados vários na mesma requisição

Aviso

Para que a baixa do Cliente endereço criado ocorra no PDV Omni é necessário realizar a abertura de um lote do tipo  56 = ClienteEndereco

titleexpandtitleDefinição de requisição
Deck of Cards
idversções
Card
labelV3.1 (V2)

Requisição

Section
Column
width50%
Expandir

Exemplo de body da requisição

[
    {
        "bairro": "string",
        "cep": "string",
        "cidade": "string",
        "complemento": "string",
        "endereco": "string",
        "enviarPnet": 0,
        "estado": "string",
        "idCliente": 0,
        "idClienteRetaguarda": "string",
        "

descricaoTipo

idInquilino": "string",
        "idProprietario": "string",
        "idRetaguarda": "string",
        "

endereco

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 inquilinoNão
idRetaguardaStringIdentificador do endereço na retaguardaNãoTamanho máximo: 100 caracteres
idProprietarioStringIdentificador do proprietárioNão
loteOrigemStringIdentificado do lote em que serão enviados os dadosNão

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",
   

"estado

    "complemento": "string",
        "descricaoTipo": "string",
        "

cep

endereco": "string",
        "

situacao

enviarPnet": 0,
        "estado": "string",
        "

tipoEndereco

idCliente": 0,
        "

enviarPnet

idClienteRetaguarda":

0

"string",
        "idInquilino": "string",
        "idProprietario": "string",
        "idRetaguarda": "string",
        "

idProprietario

loteOrigem": "string",
        "

loteOrigem

numero": "string",
        "situacao": 0,
        "tipoEndereco": 0
    }
]

Column
width
50%

Definições dos campos

do body

CampoTipoDescriçãoObrigatórioObservações
idClienteRetaguardaStringIdentificador do cliente na retaguarda
Obrigatório
Sim
descricaoTipoStringDescrição do tipo do endereço
Opcional
Não
enderecoStringEndereço
Opcional
NãoTamanho máximo: 150 caracteres
numeroStringNúmero do endereço
Opcional
NãoTamanho máximo: 15 caracteres
complementoStringComplemento do endereço
Opcional
NãoTamanho máximo: 50 caracteres
bairroStringBairro
Opcional
NãoTamanho máximo: 100 caracteres
cidadeStringCidade
Opcional
NãoTamanho máximo: 100 caracteres
estadoStringEstado
Opcional
NãoTamanho máximo: 30 caracteres
cepStringCEP do endereço
Opcional
NãoTamanho máximo: 10 caracteres
situacaoIntSituação do
endereço (
endereço Sim0 - Inativo, 1 - Ativo
)Obrigatório
tipoEnderecoIntTipo endereço
(Definição abaixo)
.Não
CódigoTipo
0Entrega
1Comercial
2Cobranca
Opcional
idInquilinoStringIdentificador do inquilino
Opcional
Sim
idRetaguardaStringIdentificador do endereço na retaguarda
Opcional
Sim
idProprietarioStringIdentificador do proprietário
Opcional
Sim
loteOrigemStringIdentificado do lote em que serão enviados os dados
Opcional
Expandir
titleTipoEndereco
Sim
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

CódigoTipo
0Entrega
1Comercial
2Cobranca
Expandir
titleDefinição dos campos de retorno
200 - Okexpandtitle
Expandir
title

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