Árvore de páginas

Versões comparadas

Chave

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

Este método é responsável pela criação de novos FormaPagtoDados complementares de pagamento

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

Este endpoint recebe uma lista de CondicaoPagto Dados complementares para que possam ser enviados vários na mesma requisição

Aviso

Para que a baixa do CondicaoPagto Dado complementar criado ocorra no PDV Omni é necessário realizar a abertura de um lote do tipo  17 = CondicaoPagto16 = DadoComplementarPagto

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

[
    {
        "descricao": "string",
        "

diasEntreParcelas

idInquilino":

0

"string",
        "

numeroMaximoParcelas

idProprietario":

0

"string",
        "

percentualMinimoEntrada

idRetaguarda":

0

"string",
        "

prazoMaximoPrimeiraParcela

loteOrigem":

0

"string",
        "

solicitaDataDemaisParcelas

obrigatorio": 0,
        "

solicitaDataPrimeiraParcela

situacao": 0,
        "

situacao

tamanho": 0,
        "tipoDadoComplementar": 0
    }
]

Column
width50%

Definições dos campos do body

Campo

Tipo

Descrição

Obrigatório

Observações

descricao

String

Descrição do dado complementar

Sim

Tamanho máximo: 30 caracteres

idInquilinoStringIdentificador do inquilinoSim
idProprietarioStringIdentificador do proprietárioSim
idRetaguardaStringIdentificador do dado complementar na retaguardaSimTamanho máximo: 100 caracteres
loteOrigemStringIdentificador do lote em que os dados serão enviadosSim
obrigatorioIntIndica se o dado é obrigatório Sim0 - Opcional, 1 - Obrigatório
situacaoIntSituação do dado complementar Sim0 - Inativo, 1 - Ativo
tamanhoIntTamanho do dado complementarNão
tipoDadoComplementarIntTipo do dado complementarSim

Código

Tipo

0Alfanumerico
1Numerico
2Data
3ListaSelecao

Retorno

Deck of Cards
idretornos
Card
label200 - Ok
Column
width50%

Exemplo de body de retorno

{
    "success": true,
    "

dadoComplementarDescricao

message": "

string

Requisição inserida com sucesso!",
    "

condicoesPagtoOperadoras

data":

[

null,
   

  {

"errors": null,
   

   

"

id

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

{
    "

idRetaguarda

code": "string",
   

   

"

idRetaguardaCondicaoPagto

message": "string",
   

   

"

idRetaguardaOperadora

detailedMessage": "string",

 

   

 

"

situacao

helpUrl":

0

"string",

   

    "

idCondicaoPagamento

details":

0

[
       

}

{
   

],

        "

idInquilino

guid": "string",
            "

idRetaguarda

code": "string",
            "

idProprietario

message": "string",
            "

loteOrigem

detailedMessage": "string"
        }
    ]
}

Column
width
50%

Definições dos campos

do retorno

Campo

Tipo

Descrição

Observações
code
descricaoStringDesccrição da condição de pagamento

Obrigatório

Tamanho máximo: 50 caracteres

diasEntreParcelasIntDias entre as parcelasObrigatório
numeroMaximoParcelasIntNúmero máximo de parcelasObrigatório
percentualMinimoEntradaIntPercentual mínimo de entradaOpcional
prazoMaximoPrimeiraParcelaIntPrazo máximo da primeira parcela

Opcional

Caso não enviado será cadastrado como 0

solicitaDataDemaisParcelasIntIndica se solicita a data das demais parcelas

Aceito 0 ou 1

Caso não enviado será cadastrado como 0

solicitaDataPrimeiraParcelaIntIndica se solicita a data da primeira parcela

Aceito 0 ou 1

Caso não enviado será cadastrado como 0

situacaoIntSituação da condição de pagamento (0 - Inativo, 1 - Ativo)

Obrigatório

tipoDadoComplementarIntTipo do dado complementarOpcional
dadoComplementarDescricaoStringDescrição dado complementarOpcional
condicoesPagtoOperadorasLista de ObjetosLista de operadoresOpcional
condicoesPagtoOperadoras.idIntIdentificador da operadora no POSHOpcional
condicoesPagtoOperadoras.idRetaguardaStringIdentificador da condicao pagamento operadora na retaguardaObrigatório
condicoesPagtoOperadoras.idRetaguardaCondicaoPagtoStringIdeintificador da condição pagamento na retaguardaObrigatório
condicoesPagtoOperadoras.idRetaguardaOperadoraStringIdentificador da operadora na retaguardaObrigatório
condicoesPagtoOperadoras.situacaoIntSituação da operadora (0 - Inativo, 1 - Ativo)

Opcional

Caso não enviado será cadastrado como 0

condicoesPagtoOperadoras.idCondicaoPagamentoIntIdentificador da Forma de pagametno Condição pagamento no POSHOpcional
stringCó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

[
    {
        "descricao": "string",
        "idInquilino": "string",
        "idProprietario": "string",
        "idRetaguarda": "string",
        "loteOrigem": "string",
        "obrigatorio": 0,
        "situacao": 0,
        "tamanho": 0,
        "tipoDadoComplementar": 0
    }
]

Column
width50%

Definições dos campos do body

Campo

Tipo

Descrição

Obrigatório

Observações

descricaoStringDescrição do dado complementar

Não

Tamanho máximo: 30 caracteres

tipoDadoComplementarIntTipo do dado complementar Não
CódigoTipo
0Alfanumerico
1Numerico
2Data
3ListaSelecao
obrigatorioIntIndica se o dado é obrigatórioSim0 - Opcional, 1 - Obrigatório
tamanhoIntTamanho do dado complementarNão
situacaoIntSituação do dado complementar Sim0 - Inativo, 1 - Ativo
idInquilinoStringIdentificador do inquilino
Obrigatório
Sim
idRetaguardaStringIdentificador
da condição de pagamento
do dado complementar na retaguarda
Obrigatório
Sim
idProprietarioStringIdentificador do proprietário
Obrigatório
Sim
loteOrigemStringIdentificador do lote em que os dados serão enviados
Obrigatório para a integração Expandir
titleDefinição dos campos de retorno
200 - Okexpandtitle
Sim

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

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