Regras de negócio

É tudo aquilo que é arrecadado pela empresa, a título de Lançamentos financeiros a pagar com status “Em Aberto” ou “Parcialmente Baixado”.
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/360045114753-Movimenta%C3%A7%C3%A3o-Financeira#oquesoreceitasedespesas

Dependências

Não possui dependências

Detalhes Técnicos

A entidade utilizada é a Financeiro que por sua vez instancia a tabela TGFFIN 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 foram utilizados como filtro os campos CODTIPTIT, DHBAIXA e RECDESP, porém você pode utilizar outros campos da entidade .

• NUFIN – Nro Único;

• DHBAIXA – Data da baixa;

• RECDESP – Receita/Despesa.

Para utilizarmos o filtro, basta acrescentar no corpo da requisição o código abaixo utilizando o criteria:

      "criteria": {
        "expression": {
          "$": "this.DHBAIXA IS NULL and this.RECDESP = ? and this.NUFIN = ?"
        },
        "parameter":[
          {
             "type":"I",
             "value":"1"
          },
          {
             "type":"I",
             "value":"186"
          }
        ]
      }

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 TGFFIN

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": "Financeiro",
      "includePresentationFields": "S",
      "offsetPage": "0",
      "criteria": {
        "expression": {
          "$": "this.DHBAIXA IS NULL and this.RECDESP = ? and this.NUFIN = ?"
        },
        "parameter":[
          {
             "type":"I",
             "value":"1"
          },
          {
             "type":"I",
             "value":"186"
          }
        ]
      },
      "entity": {
        "fieldset": {
              "list":"NUFIN,CODEMP,NUMNOTA,DTNEG,DTVENC"
        }
      }
    }
  }
}

Retorno em json:

{
    "serviceName": "CRUDServiceProvider.loadRecords",
    "status": "1",
    "pendingPrinting": "false",
    "transactionId": "E4B45548D6742C423A674A76FADEAF74",
    "responseBody": {
        "entities": {
            "total": "1",
            "hasMoreResult": "false",
            "offsetPage": "0",
            "offset": "0",
            "metadata": {
                "fields": {
                    "field": [
                        {
                            "name": "NUFIN"
                        },
                        {
                            "name": "CODEMP"
                        },
                        {
                            "name": "NUMNOTA"
                        },
                        {
                            "name": "DTNEG"
                        },
                        {
                            "name": "DTVENC"
                        },
                        {
                            "name": "Empresa_NOMEFANTASIA"
                        }
                    ]
                }
            },
            "entity": {
                "f0": {
                    "$": "186"
                },
                "f1": {
                    "$": "2"
                },
                "f2": {
                    "$": "0"
                },
                "f3": {
                    "$": "29/05/2014"
                },
                "f4": {
                    "$": "03/06/2014"
                },
                "f5": {
                    "$": "EMPRESA MODELO"
                }
            }
        }
    }
}