Árvore de páginas

Versões comparadas

Chave

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

FORMA DE PAGAMENTO poderá ter a seguintes informações:

Deck of Cards
idv1
Card
idv2
labelDescrição dos campos e regras

Pagamento_Forma_Mestre

Informações
titleDescrição

A tabela de forma de pagamento mestre representa o vinculo entre os botões disponíveis para seleção de pagamento em tela do PDV e a forma de pagamento no banco.
Para o Android, a pagamento_forma_mestre corresponde exatamente ao botão apresentado, ou seja, caso seja inserido mais um registro no banco será apresentado mais um botão na tela.
Para o UWP os botões são fixos, a mestre é usada somente para o vinculo da forma com o banco, então caso seja adicionado mais uma mestre é necessário mapeá-la na tela.
Por padrão, na instalação do PDV OMNI já é criado os mestres CRÉDITO, DÉBITO, DINHEIRO, POS, CHEQUE, TROCA, OUTROS, GIFT E QR Code. Porém o QR Code só fica habilitado quando a parametrização para esse mestre está correta.

Informação

Coluna

Obrigatório

Tipo

Tamanho

Descrição

Data de cadastrodata_cadastroSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.
Descrição da mestredescricaoSmTexto30Descrição da mestre. Essa descrição será apresentada no botão na tela de pagamentos do Android.
Ordem de prioridade da mestreortemSimInteiro
Ordem posicional em que o botão deve ser apresentado. Por exemplo, se a ordem for "10" em uma lista de 10 opções, esse mestre será o ultimo da lista a ser apresentado.
SituaçãosituacaoSimInteiro

Define se a mestre em questão está ativo ou inativo.

  • 0 - Inativo
  • 1 - Ativo
Tipo de forma de pagamentotipoSimInteiro
Tipo de pagamento 
  • Outros = 0,
  • Dinheiro = 1,
  • TefCredito = 2,
  • TefDebito = 3,
  • Cheque = 4,
  • Pos = 5,
  • Troca = 6,
  • Fidelidade = 7,
  • CartaoPresente = 8,
  • Cliente = 9,
  • QRCode = 10,
  • Todos = 11
Data de atualizaçãodata_atualizacaoSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.
Identificação no retaguardaid_retaguardaNãoTexto100



Pagamento_Forma

Informação

Coluna

Obrigatório

Tipo

Tamanho

Descrição

Descrição da forma de pagamentodescricaoSimTexto50Descrição da forma de pagamento cadastrada no ERP/Retaguarda
Descrição fiscal da forma de pagamentodescricao_fiscalSimTexto30Descrição fiscal da forma de pagamento, porém não é utilizada pra a impressão do cupom, somente informativo.

codigo_impressoraSimTexto30Defasado. O valor é sempre 0.
Configuração se a forma permite o pagamento do valor total da vendapagamento_valor_totalNãoInteiro
Configuraçã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.
Configuração se a forma permite gerar trocopermite_

...

trocoSimInteiro
Configuração da forma de pagamento para que a mesma permita gerar troco. Ou seja, se o carrinho tiver o valor de R$100,00 e a forma de pagamento DINHEIRO não permitir troco, você não irá conseguir fechar a venda com o pagamento de R$101,00 em DINHEIRO, pois não é permitido retornar R$1,00 de troco utilizando essa forma de pagamento.
Configuração da forma que será gerada de troco, caso a forma permitaid_forma_pagamento_trocoNãoInteiro
Caso a forma de pagamento permita troco, o campo id_forma_pagamento configura em qual forma ela realiza o troco. Por exemplo, se a forma de pagamento TROCA permite troco e está configurada para realizar o troco em VALE TROCA, quando pago um valor acima do total da venda em TROCA a diferença do valor não será em DINHEIRO e sim em VALE TROCA.
Configuração o valor mínimo de recebimento que a forma de pagamento permitevalor_minimo_aceitoNãoNumérico
Configuração para definir um valor minimo para determinada forma de pagamento. Ou seja, caso a forma de pagamento DINHEIRO esteja configurada para aceitar um valor minímo de R$50,00 e você tente informar um pagamento de R$40,00 no PDV, ele não irá permitir, pois o valor minímo para o dinheiro é R$50,00
Código da forma de pagamento no sistema externo que cadastrou (Retaguarda/ERP)codigo_sistema_externoSimTexto50Utilizado no SELFCHECKOUT para geração do QRCode para o pagamento de carteira digital
SituaçãosituacaoSimInteiro

Define se a forma de pagamento em questão está ativo ou inativo.

  • 0 - Inativo
  • 1 - Ativo
Data de cadastrodata_cadastroSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.
Data de atualizaçãodata_atualizacaoSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.
Identificação no retaguardaid_retaguardaNãoTexto100

codigo_modalidade_pagamentoNãoInteiro
Defasado
Tipo de pagamentotipoNãoInteiro
Tipo de pagamento 
  • Outros = 0,
  • Dinheiro = 1,
  • TefCredito = 2,
  • TefDebito = 3,
  • Cheque = 4,
  • Pos = 5,
  • Troca = 6,
  • Fidelidade = 7,
  • CartaoPresente = 8,
  • Cliente = 9,
  • QRCode = 10,
  • Todos = 11
ID da pagamento_forma_mestreid_pagamento_forma_mestreNãoInteiro
Vinculo entre a forma de pagamento e a pagamento mestre
Configuração se a forma de pagamento é para clientestipo_clienteNãoInteiro
Identifica se a forma de pagamento é uma forma utilizada para clientes cadastrados, como por exemplo, promissoria ou crédito empresa



Pagamento_Forma_Modelo_Fiscal

Informação

Coluna

Obrigatório

Tipo

Tamanho

Descrição

SituaçãosituacaoSimInteiro

Define se o vinculo fiscal em questão está ativo ou inativo.

  • 0 - Inativo
  • 1 - Ativo
Data de cadastrodata_cadastroSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.
Data de atualizaçãodata_atualizacaoSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.
ID da pagamento_formaid_pagamento_formaSimInteiro
Vinculo entre o modelo fiscal e a forma de pagamento
Identificação do modelo fiscal que o registro é válidomodelo_fiscalSimInteiro

Configuração do modelo fiscal da loja

  • 1 SAT/MFE
  • 2- NFCE/NFe
Código fiscalcodigo_fiscalNãoTexto2Para emissão da XML da venda, esse campo é utilizado para o preenchimento da TAG tPag do grupo pag
Descrição fiscaldescricao_fiscalSimTexto30
Identificação no retaguardaid_retaguardaNãoTexto100Descrição da forma de pagamento apresentado no cupom fiscal



Pagamento_Operadora

Informações
titlePagamento_Operadora

A tabela pagamento_operadora possui vinculo tanto com a forma de pagamento quanto as condições de pagamento.
O vinculo entre a pagamento_operadora e a pagamento_condicao ocorre através da pagamento_condicao_operadora, onde é informado os IDs de vinculo.
O vinculo entre a pagamento_operadora e a pagamento_forma ocorre através da pagamento_forma_operadora, onde é informado os IDs de vinculo.

Informação

Coluna

Obrigatório

Tipo

Tamanho

Descrição

DescriçãodescricaoSimTexto100Descrição da bandeira do cartão
SituaçãosituacaoSimInteiro1

Define se a operadora em questão está ativo ou inativo.

  • 0 - Inativo
  • 1 - Ativo
Data de cadastrodata_cadastroSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.
Data de atualizaçãodata_atualizacaoSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.
Identificação no retaguardaid_retaguardaNãoTexto100
Código TEFcodigo_tefNãoTexto30Código TEF da operadora de cartões
AdministradoraadministradoraNãoTexto100Código da administradora da operadora de cartões
Tipo de transaçãotipo_transacaoSimInteiro

Configuração se a transação utilizada por determinada operadora é débito ou crédito

  • 0 - Débito
  • 1 - Crédito


Pagamento_Operadora_Bin

Informação

Coluna

Obrigatório

Tipo

Tamanho

Descrição

Início das BINsinicioSimInteiro
Inicio do intervalo de BINs permitidos para determinada bandeira
Fim das BINsfimSimInteiro
Final do intervalo de BINs permitidos para determinada bandeira
Data de cadastrodata_cadastroSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.
Data de atualizaçãodata_atualizacaoSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.

id_pagamento_operadoraNãoInteiro
O vinculo entre o intervalo de BINs de cartões com a bandeira de cartão
Identificação no retaguardaid_retaguardaNãoTexto100
Tipo de atributotipo_atributoNãoInteiro

Tipo de atributo do registros

  • 0 = Bin
  • 1 = Bandeira
  • 2 = Rede
  • 3 = TEF Discado, usado também para carteira digital (mercadopago, pix, shipay).
  • Quando for carteira digital, terá somente o TipoAtributo 3, se existir o TipoAtributo 1, não usar como carteira digital
SituaçãosituacaoSimInteiro

Define se a bin em questão está ativo ou inativo.

  • 0 - Inativo
  • 1 - Ativo


Pagamento_Condicao

Informações
titlePagamento_Condicao

A tabela pagamento_condicao possui vinculo tanto com a operadora quanto a forma de pagamento em si.
O vinculo entre a pagamento_condicao e a pagamento_operadora ocorre através da pagamento_condicao_operadora, onde é informado os IDs de vinculo.
O vinculo entre a pagamento_condicao e a pagamento_forma ocorre através da pagamento_forma_condicao, onde é informado os IDs de vinculo.

Informação

Coluna

Obrigatório

Tipo

Tamanho

Descrição

Descrição da condiçãodescricaoSimTexto50

Descrição da condição de pagamento.

*Condições relacionados ao produto eletrônico possui um texto padronizado diferente do cadastrado, onde o nome é formado por:
Caso a operação seja débito será iniciado com "PRE DATADO" e caso seja diferente de débito será "PARCELADO". Na sequência virá o nome do produto, número de parcelas e o texto "PARCELAS".
Por exemplo: "PARCELADO ELO CRED (C)-5 parcelas"

Dias entre parcelasdias_entre_parcelasNãoInteiro
Dado recebido no retagaurda/ERP. Posteriormente esse dado é gravado no objeto Financeiro.Objects.Cartao na mensagem do financeiro integrado com o TOTVS Live
Número máximo de parcelasnumero_maximo_parcelasNãoInteiro
Dado recebido no retagaurda/ERP. No PDV esse dado é utilizado para preenchimento de lista de parcelas disponívels para seleção e finalização da venda.
Percentual mínimo de entradapercentual_minimo_entradaNãoInteiro
Dado recebido no retaguarda/ERP, porém não utilizado no PDV.
Prazo máximo para primeira parcelaprazo_maximo_primeira_parcelaNãoInteiro
Dado recebido no retaguarda/ERP, porém não utilizado no PDV.
Solicita a data das demais parcelassolicita_data_demais_parcelasNãoInteiro
Dado recebido no retaguarda/ERP, porém não utilizado no PDV.
Solicita a data da primeira parcelasolicita_data_primeira_parcelaNãoInteiro
Dado recebido no retaguarda/ERP, porém não utilizado no PDV.
SituaçãosituacaoSimInteiro

Define se a condição em questão está ativo ou inativo.

  • 0 - Inativo
  • 1 - Ativo
Data de cadastrodata_cadastroSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.
Data de atualizaçãodata_atualizacaoSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.
Identificação no retaguardaid_retaguardaNãoTexto100
Dado complementardado_complementarNãoInteiro
Defasado
Descrição do dado complementardado_complementar_descricaoNãoTexto30Defasado
Dia fixo para o pagamentodia_fixo_pagamentoNãoInteiro
Dado recebido no retaguarda/ERP e utilizado pelo PDV para realizar o calculo das parcelas.
Quantidade de dias de carência para o primeiro pagamentodias_carencia_primeiro_vencimentoNãoInteiro
Dado recebido no retaguarda/ERP e utilizado pelo PDV para realizar o calculo das parcelas.
Configuração se o número de parcelas é fixofixa_numero_parcelasNãoInteiro
Dado recebido no retaguarda/ERP e utilizado pelo PDV formatar a apresentação das parcelas.
Quantidade de parcelasquantidade_parcelasNãoInteiro
Dado recebido no retaguarda/ERP e utilizado pelo PDV formatar a apresentação das parcelas.
Tipo de arredondamentotipo_arredondamentoNãoInteiro
Defasado
  • Arredonda primeira parcela = 0
  • Arredonda ultima parcela = 1
Tipo de vencimento para o parcelamentotipo_vencimento_parcelamentoNãoInteiro
  • Dado recebido no retaguarda/ERP e utilizado pelo PDV para realizar o calculo das parcelas.
    Dias corridos entre parcelas = 0
  • Dia fixo mensal = 1
  • Dia fixo semanal = 2
  • Dia fixo quinzenal = 3
Configuração se vence em dia útilvence_dia_utilNãoInteiro
Defasado
Configuração do valor mínimo de parcelavalor_minimo_parcelaSimNumérico10Dado recebido no retaguarda/ERP e utilizado pelo PDV formatar a apresentação das parcelas


Pagamento_Dado_Complementar

Informações
titlePagamento_Dado_Complementar

A tabela pagamento_dado_complementar possui vinculo com a forma de pagamento.
O vinculo entre a pagamento_dado_complementar e a pagamento_forma ocorre através da pagamento_forma_dado_complementar, onde é informado os IDs de vinculo.

Informação

Coluna

Obrigatório

Tipo

Tamanho

Descrição

Identificação no retaguardaid_retaguardaNãoTexto100
Descrição do dado complementardescricaoNãoTexto30Descrição do dado complementar que será apresentado na tela do PDV
Tipo de dado complementartipoNãoInteiro
Valor fixo como 1.
Configuração se o dado é obrigatórioobrigatorioSimInteiro
Valor fixo como 1.
Tamanho do dado permitidotamanhoNãoInteiro
Valor fixo como 25.
Tipo campo TEFtipo_campo_tefNãoInteiro
Defasado
SituaçãosituacaoSimInteiro

Define se o dado em questão está ativo ou inativo.

  • 0 - Inativo
  • 1 - Ativo
Data de cadastrodata_cadastroSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.
Data de atualizaçãodata_atualizacaoSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.
Card
idv2
labelComo integrar

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

  • Endpoint:
    • /api/retaguarda/v2/FormaPagtos
    • /api/retaguarda/v3/FormaPagtos
    • /api/retaguarda/v3/dadosdinamicos/down/18/1
  • Método: Post
  • Autenticação: Bearer token
  • Permissão: Retaguarda

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

Aviso

Para que a baixa do FormaPagto criado ocorra no PDV Omni é necessário realizar a abertura de um lote do tipo  18 = 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 retaguardaNã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