Á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

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

"descricaoTipo

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

cep

descricaoTipo": "string",
     

"situacao

  "endereco": "string",
        "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
Obrigatório
idClienteRetaguardaStringIdentificador do cliente na retaguardaSim
descricaoTipoStringDescrição do tipo do endereçoNão
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.Não
CódigoTipo
0Entrega
1Comercial
2Cobranca
Não
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
}

...