Árvore de páginas

Versões comparadas

Chave

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

(aviso)

Button
Cor#FF0000
TextoTDN MIGRADO FORMA PAGTO
Linkhttps://tdn.totvs.com/display/TVPO/Forma+de+pagamento

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

...

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

Requisição

Section
Column
width50%

Exemplo de body da requisição

[
    {
        "codigoModalidadePagamento": 0,
        "codigoSistemaExterno": "string",
        "descricao": "string",
        "descricaoFiscal": "string",
        "formaPagtoModeloFiscal": [
            {
                "codigoFiscal": "string",
                "descricaoFiscal": "string",
                "idRetaguarda": "string",
                "idRetaguardaFormaPagto": "string",
                "modeloFiscal": "string",
                "situacao": 0
            }
        ],
        "formasPagtoCondicoes": [
            {
                "idRetaguarda": "string",
                "idRetaguardaCondicaoPagto": "string",
                "idRetaguardaFormaPagto": "string",
                "situacao": 0
            }
        ],
        "formasPagtoDadosComplementares": [
            {
                "idRetaguarda": "string",
                "idRetaguardaDadoComplementarPagto": "string",
                "idRetaguardaFormaPagto": "string",
                "ordem": 0,
                "situacao": 0
            }
        ],
        "formasPagtoOperadoras": [
            {
                "idRetaguarda": "string",
                "idRetaguardaFormaPagto": "string",
                "idRetaguardaOperadoraPagto": "string",
                "situacao": 0
            }
        ],
        "idInquilino": "string",
        "idProprietario": "string",
        "idRetaguarda": "string",
        "idRetaguardaFormaPagTroco": "string",
        "loteOrigem": "string",
        "permiteTroco": 0,
        "situacao": 0,
        "tipo": 0,
        "tipoCliente": 0,
        "valorMinimoAceito": "string",

        "clienteConsumidor": bool
    }
]

Column
width50%

Definições dos campos do body

Campo

Tipo

Descrição

Obrigatório

Observações

descricao

string

Descrição da forma de pagamento

Sim

Tamanho Máximo: 50 caracteres

codigoModalidadePagamentointegerCódigo da modalidade de pagamentoNão
codigoSistemaExternostringCódigo Sistema Externo

Sim

Tamanho Máximo: 50 caracteres

descricaoFiscalstringDescrição fiscal da forma de pagamento

Sim

Tamanho Máximo: 50 caracteres

formaPagtoModeloFiscalLista de objetosLista de modelos fiscaisNão
formaPagtoModeloFiscal.codigoFiscalstringCódigo fiscalNãoTamanho Máximo: 2 caracteres
formaPagtoModeloFiscal.descricaoFiscalstringDescrição fiscalNãoTamanho Máximo: 30 caracteres
formaPagtoModeloFiscal.idRetaguardastringIdentificador do modelo na retaguardaNãoTamanho Máximo: 100 caracteres
formaPagtoModeloFiscal.idRetaguardaFormaPagtostringIdentificador da forma de pagamento na retaguardaNãoTamanho Máximo: 100 caracteres
formaPagtoModeloFiscal.modeloFiscalstringModelo fiscalNãoTamanho Máximo: 30 caracteres
formaPagtoModeloFiscal.situacaointegerSituação do modelo fiscal Não0 - Inativo, 1 - Ativo
formasPagtoCondicoesLista de objetosLista de condições de forma de pagamentoNão
formasPagtoCondicoes.idRetaguardastringIdentificador da condição na retaguardaNãoTamanho Máximo: 100 caracteres
formasPagtoCondicoes.idRetaguardaCondicaoPagtostringIdentificador da condição de pagamento na retaguardaNãoTamanho Máximo: 100 caracteres
formasPagtoCondicoes.idRetaguardaFormaPagtostringIdentificador da forma de pagamento na retaguardaNãoTamanho Máximo: 100 caracteres
formasPagtoCondicoes.situacaointegerSituação da condição de pagamento (0 - Inativo, 1 - Ativo)Não
formasPagtoDadosComplementaresLista de objetosLista de Dados complementares da forma de pagamentoNão
formasPagtoDadosComplementares.idRetaguardastringIdentificador do dado complementar na reguardarNãoTamanho Máximo: 100 caracteres
formasPagtoDadosComplementares.idRetaguardaDadoComplementarPagtostringIdentificador do dado complementar pagamento na retaguardaNãoTamanho Máximo: 100 caracteres
formasPagtoDadosComplementares.idRetaguardaFormaPagtostringIdentificador da forma de pagamento na retaguardaNãoTamanho Máximo: 100 caracteres
formasPagtoDadosComplementares.ordemintegerOrdem do dado complementarNão
formasPagtoDadosComplementares.situacaointegerSituação do dado complementar (0 - Inativo, 1 - Ativo)Não
formasPagtoOperadorasLista de objetosLista de operadoras da forma de pagamentoNão
formasPagtoOperadoras.idRetaguardastringIdentificador da operadora na retaguardaNãoTamanho Máximo: 100 caracteres
formasPagtoOperadoras.idRetaguardaFormaPagtostringIdentificador da forma de pagamento na retaguardaNãoTamanho Máximo: 100 caracteres
formasPagtoOperadoras.idRetaguardaOperadoraPagtostringIdentificador da Operadora pagamento na retaguarda
Não
NãoTamanho Máximo: 100 caracteres
formasPagtoOperadoras.situacaointegerSituação da operadora (0 - Inativo, 1 - Ativo)Não
idInquilinostringIdentificador do inquilinoSim
idProprietariostringIdentificador do proprietárioSim
idRetaguardastringIdentificador da forma de pagamento na retaguardaSimTamanho Máximo: 100 caracteres
idRetaguardaFormaPagTrocostringIdentificador da forma de pagamento troco na retaguarda

Sim

Tamanho Máximo: 100 caracteres

loteOrigemstring

Identificador do lote

Sim
permiteTrocoIntIndica se a forma de pagamento permite troco (0 - Não; 1 - Sim)Sim
situacaointegerSituação da forma de pagamento (0 - Inativo, 1 - Ativo)

Não

Caso não enviado será cadastrado como 0

tipointegerTipo da forma de pagamento Sim

Código

Tipo

0Outros
1Dinheiro
2Credito
3Debito
4Cheque
5POS
6Troca
8Gift
10QRCode
tipoClienteintegerTipo clienteNão
valorMinimoAceitostringValor mínimo aceita para a forma de pagamentoNãoTamanho Máximo: 50 caracteres
clienteConsumidorboolHabilita forma de pagamento para aquela forma de pagamentoNãotrue/false

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

[
    {
        "codigoModalidadePagamento": 0,
        "codigoSistemaExterno": "string",
        "descricao": "string",
        "descricaoFiscal": "string",
        "formaPagtoModeloFiscal": [
            {
                "codigoFiscal": "string",
                "descricaoFiscal": "string",
                "idRetaguarda": "string",
                "idRetaguardaFormaPagto": "string",
                "modeloFiscal": "string",
                "situacao": 0
            }
        ],
        "formasPagtoCondicoes": [
            {
                "idRetaguarda": "string",
                "idRetaguardaCondicaoPagto": "string",
                "idRetaguardaFormaPagto": "string",
                "situacao": 0
            }
        ],
        "formasPagtoDadosComplementares": [
            {
                "idRetaguarda": "string",
                "idRetaguardaDadoComplementarPagto": "string",
                "idRetaguardaFormaPagto": "string",
                "ordem": 0,
                "situacao": 0
            }
        ],
        "formasPagtoOperadoras": [
            {
                "idRetaguarda": "string",
                "idRetaguardaFormaPagto": "string",
                "idRetaguardaOperadoraPagto": "string",
                "situacao": 0
            }
        ],
        "idInquilino": "string",
        "idProprietario": "string",
        "idRetaguarda": "string",
        "idRetaguardaFormaPagTroco": "string",
        "loteOrigem": "string",
        "permiteTroco": 0,
        "situacao": 0,
        "tipo": 0,
        "tipoCliente": 0,
        "valorMinimoAceito": "string"

        "clienteConsumidor": bool
    }
]

Column
width50%

Definições dos campos do body

Campo

Tipo

Descrição

Observações

Obrigatório

descricaostringDescrição da forma de pagamento

Tamanho Máximo: 50 caracteres

Sim

descricaoFiscalstringDescrição fiscal da forma de pagamento

Tamanho Máximo: 30 caracteres

Sim

pagamentoValorTotalintConfiguração da forma de pagamento para que a mesma permita o pagamento do valor total da venda utilizando a mesma. Ou seja, se o carrinho tiver o valor de R$100,00 e a forma de pagamento DINHEIRO não permitir o pagamento total da venda, você não irá conseguir fechar a venda com o pagamento de R$100,00 em DINHEIRO. É necessário informar um pagamento inferior em DINHEIRO e o restante em outra forma de pagamento.
Não
permiteTrocoIntIndica se a forma de pagamento permite troco 0 - Não; 1 - SimSim
idRetaguardaFormaPagTrocostringIdentificador da forma de pagamento troco na retaguarda

Tamanho Máximo: 100 caracteres

Sim

valorMinimoAceitostringValor mínimo aceita para a forma de pagamento
Não
codigoSistemaExternostringCódigo Sistema Externo

Tamanho Máximo: 50 caracteres

Sim

situacaointegerSituação da forma de pagamento 

0 - Inativo, 1 - Ativo)

Sim

codigoModalidadePagamentointegerDEFASADO
Não
tipointegerTipo da forma de pagamento
CódigoTipo
0Outros
1Dinheiro
2Credito
3Debito
4Cheque
5POS
6Troca
7Fidelidade
8Gift
9Cliente
10QRCode
11Todos
Sim
tipoClienteintegerIdentifica se a forma de pagamento é uma forma utilizada para clientes cadastrados, como por exemplo, promissoria ou crédito empresa
Não
formasPagtoCondicoesLista de objetosLista de condições de forma de pagamento
Não
formasPagtoCondicoes.idRetaguardastringIdentificador da condição na retaguarda
Não
formasPagtoCondicoes.idRetaguardaFormaPagtostringIdentificador da forma de pagamento na retaguarda
Não
formasPagtoCondicoes.idRetaguardaCondicaoPagtostringIdentificador da condição de pagamento na retaguarda
Não
formasPagtoCondicoes.situacaointegerSituação da condição de pagamento 0 - Inativo, 1 - AtivoNão
formasPagtoDadosComplementaresLista de objetosLista de Dados complementares da forma de pagamento
Não
formasPagtoDadosComplementares.idRetaguardastringIdentificador do dado complementar na reguardar
Não
formasPagtoDadosComplementares.idRetaguardaFormaPagtostringIdentificador da forma de pagamento na retaguarda
Não
formasPagtoDadosComplementares.idRetaguardaDadoComplementarPagtostringIdentificador do dado complementar pagamento na retaguarda
Não
formasPagtoDadosComplementares.situacaointegerSituação do dado complementar 0 - Inativo, 1 - AtivoNão
formasPagtoDadosComplementares.ordemintegerOrdem do dado complementar
Não
formasPagtoOperadorasLista de objetosLista de operadoras da forma de pagamento
Não
formasPagtoOperadoras.idRetaguardastringIdentificador da operadora na retaguarda
Não
formasPagtoOperadoras.idRetaguardaFormaPagtostringIdentificador da forma de pagamento na retaguarda
Não
formasPagtoOperadoras.idRetaguardaOperadoraPagtostringIdentificador da Operadora pagamento na retaguarda
Não
formasPagtoOperadoras.situacaointegerSituação da operadora 0 - Inativo, 1 - AtivoNão
formaPagtoModeloFiscalLista de objetosLista de modelos fiscais
Não
formaPagtoModeloFiscal.idRetaguardastringIdentificador do modelo na retaguarda
Não
formaPagtoModeloFiscal.idRetaguardaFormaPagtostringIdentificador da forma de pagamento na retaguarda
Não
formaPagtoModeloFiscal.modeloFiscalstringModelo fiscal
Não
formaPagtoModeloFiscal.codigoFiscalstringCódigo fiscal
Não
formaPagtoModeloFiscal.descricaoFiscalstringDescrição fiscal
Não
formaPagtoModeloFiscal.situacaointegerSituação do modelo fiscal0 - Inativo, 1 - AtivoNão
idInquilinostringIdentificador do inquilino
Sim
idRetaguardastringIdentificador da forma de pagamento na retaguardaTamanho máximo: 100 caracteresSim
idProprietariostringIdentificador do proprietário
Sim
loteOrigemstring

Identificador do lote


Sim
clienteConsumidorbolean

Habilita forma de pagamento para aquele cliente

true/falseNã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