Árvore de páginas

Versões comparadas

Chave

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

...

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

[
    {
        "

idCliente

bairro":

0

"string",
        "

idClienteRetaguarda

cep": "string",
        "

descricaoTipo

cidade": "string",
        "

endereco

complemento": "string",
        "

numero

endereco": "string",
        "

complemento

enviarPnet":

"string"

0,
        "

bairro

estado": "string",
        "

cidade

idCliente":

"string"

0,
        "

estado

idClienteRetaguarda": "string",
        "

cep

idInquilino": "string",
        "

situacao

idProprietario":

0

"string",
        "

tipoEndereco

idRetaguarda":

0

"string",
   

"enviarPnet": 0,

    "

idInquilino

loteOrigem": "string",
        "

idRetaguarda

numero": "string",
        "

idProprietario

situacao":

"string"

0,
        "

loteOrigem

tipoEndereco":

"string"

0
    }
]


Column
width
50%

Definições dos campos

do body

Campo

Tipo

Descrição

Obrigatório

Observações

ObrigatórioNão

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

Código

Tipo

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

Retorno

IntIdentifica se esse endereço vai ser enviado do PDV para a retaguardaNãoidClienteIntIdentificador do cliente no PDVNão Expandir
titleDefinição dos campos de retorno
200 - Okexpandtitle
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

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

Body
Expandir
title

de retorno

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