Regras de negócio

Os tipos de negociação se referem às formas de pagamento utilizadas pela empresa, seja nas operações de compra ou venda. Nos tipos de negociação são realizadas diversas parametrizações que serão utilizadas nas negociações com os parceiros da empresa; portanto, tem-se aqui um cadastro de extrema importância.
OBS: Caso tenha alguma necessidade de configuração do ERP procure “Consultor” ou acesso o link de apoio: https://ajuda.sankhya.com.br/hc/pt-br/articles/360045109173-Tipos-de-Negocia%C3%A7%C3%A3o

Dependências

Não possui dependências

Detalhes Técnicos

A entidade utilizada é a TipoNegociacao que por sua vez instancia a tabela TGFTPV mapeando os campos principais.
Para realizarmos a busca através do Json, utilizamos o serviço "CRUDServiceProvider.loadRecords".

O serviço CRUDServiceProvider.loadRecords é um otimo serviço para ser utilizado para consulta de dados através do JSON.

No exemplo abaixo foi utilizado como filtro o campo CODTIPVENDA, porém você pode utilizar outros campos da entidade.
• CODTIPVENDA – Código do tipo de negociação.
O cadastro de tipos de negociação é histórico e para efetuar a busca da ultima versão é necessário buscar utilizando os campos CODTIPVENDA e ATIVO, após isto o retorno do JSON trará o ultimo tipo de negociação ordenando pela data e hora de alteração. Para utilizarmos o filtro, basta acrescentar no corpo da requisição o código abaixo utilizando o criteria:

    "criteria": {
      "expression": {
        "$": "this.CODTIPVENDA = ? AND this.ATIVO = ?"
      },
      "parameters":[
        {
           "type":"I",
           "value":"11"
        },
        {
           "type":"S",
           "value":"S"
        }
      ]
    }

Ao realizar a busca pelo código do tipo de negociação, o retono trará os títulos cadastrados para este código de negociação, sendo assim pode trazer diversos tipos de negociação como:
1 - Cartão de Débito;
2 - A vista;
3 - A prazo;
4 - Parcelada;
5 - Cheque pré-datado;
6 - Crediário;
7 - Financeira;
8 - Cartão de Crédito.

Para melhor performance sempre utilize nas suas consultas apenas os campos necessários, para evitar tráfego de dados que não serão utilizados.

Descritivo de campos da entidade

Acesse aqui o dicionário de dados da tabela TGFTPV

Exemplo de uso:

URL de chamada: https://api.sankhya.com.br/gateway/v1/mge/service.sbr?serviceName=CRUDServiceProvider.loadRecords&outputType=json

Corpo de requisição

 {
  "serviceName": "CRUDServiceProvider.loadRecords",
  "requestBody": {
    "dataSet": {
      "rootEntity": "TipoNegociacao",
      "includePresentationFields": "S",
      "criteria": {
        "expression": {
          "$": "this.CODTIPVENDA = ? AND this.ATIVO = ?"
        },
        "parameters":[
          {
             "type":"I",
             "value":"11"
          },
          {
             "type":"S",
             "value":"S"
          }
        ]
      },
      "entity": {
        "fieldset": {
              "list":"CODTIPVENDA,DHALTER,DESCRTIPVENDA,TAXAJURO"
        }
      }
    }
  }
}

Retorno em json:

{
    "serviceName": "CRUDServiceProvider.loadRecords",
    "status": "1",
    "pendingPrinting": "false",
    "transactionId": "F44CF8381F02E59494DAC151AEDBFACE",
    "responseBody": {
        "entities": {
            "total": "1",
            "metadata": {
                "fields": {
                    "field": [
                        {
                            "name": "CODTIPVENDA"
                        },
                        {
                            "name": "DHALTER"
                        },
                        {
                            "name": "DESCRTIPVENDA"
                        },
                        {
                            "name": "TAXAJURO"
                        }
                    ]
                }
            },
            "entity": {
                "f0": {
                    "$": "11"
                },
                "f1": {
                    "$": "16/07/2020 16:42:15"
                },
                "f2": {
                    "$": "À VISTA"
                },
                "f3": {}
            }
        }
    }
}