Consulta - Ligação Nota x Pedido

Regras de negócio

Esta “Ligação Nota Pedido” recebe uma ação, que é feita no portal de vendas que armazena o número do pedido original, ligando ele ao número da nota gerado.Sendo assim, o sistema busca número da nota, quantidade atendida, status nota e pedido de origem.
IMPORTANTE: Um pedido pode ser faturado várias vezes, caso isto aconteça o mesmo pedido pode estar ligado a várias notas conforme o pedido foi sendo faturado.
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/360044593974-Central-de-Compras-Grade-Itens-Bot%C3%A3o-Outras-Op%C3%A7%C3%B5es

Dependências

Não possui dependências

Detalhes Técnicos

A entidade utilizada é a CompraVendavariosPedido que por sua vez instancia a tabela TGFVAR 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 NUNOTA para poder pesquisar as notas com os Pedidos faturados, porém você pode utilizar outros campos da entidade. .

• NUNOTA – Número único da nota.
• NUNOTAORIG – Número único do Pedido.
IMPORTANTE: Um pedido pode ser faturado várias vezes, caso isto aconteça o mesmo pedido pode estar ligado a várias notas conforme o pedido foi sendo faturado.
Para utilizarmos o filtro, basta acrescentar no corpo da requisição o código abaixo utilizando o criteria:
            "criteria": {
                "expression": {
                    "$": "(this.NUNOTA = ? )"
                },
                "parameters": [
                    {
                        "$": "7438",
                        "type": "I"
                    }
                ]
            }
              

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 TGFVAR

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": "CompraVendavariosPedido",
            "includePresentationFields": "S",
            "offsetPage": "0",
            "criteria": {
                "expression": {
                    "$": "(this.NUNOTA = ? )"
                },
                "parameters": [
                    {
                        "$": "7438",
                        "type": "I"
                    }
                ]
            },
            "entity": {
                "fieldset": {
                    "list": "NUNOTA,SEQUENCIA,QTDATENDIDA,STATUSNOTA,NUNOTAORIG"
                }
            }
        }
    }
}

Retorno em json:

{
    "serviceName": "CRUDServiceProvider.loadRecords",
    "status": "1",
    "pendingPrinting": "false",
    "transactionId": "E59E754F1CB4FC5A4FDE4166D2438EBD",
    "responseBody": {
        "entities": {
            "total": "1",
            "hasMoreResult": "false",
            "offsetPage": "0",
            "offset": "0",
            "metadata": {
                "fields": {
                    "field": [
                        {
                            "name": "NUNOTA"
                        },
                        {
                            "name": "SEQUENCIA"
                        },
                        {
                            "name": "QTDATENDIDA"
                        },
                        {
                            "name": "STATUSNOTA"
                        },
                        {
                            "name": "NUNOTAORIG"
                        },
                        {
                            "name": "SEQUENCIAORIG"
                        }
                    ]
                }
            },
            "entity": {
                "_rmd": {
                    "SEQUENCIAORIG": {
                        "$": "{\"decVlr\":6,\"decQtd\":0,\"controle\":{\"tipoContEst\":\"N\",\"listaContEst\":[\"\"]}}",
                        "provider": "TGFVARPRODUTORMP"
                    }
                },
                "f0": {
                    "$": "7438"
                },
                "f1": {
                    "$": "1"
                },
                "f2": {
                    "$": "10"
                },
                "f3": {
                    "$": "L"
                },
                "f4": {
                    "$": "7436"
                },
                "f5": {
                    "$": "1"
                }
            }
        }
    }
}
Language
Click Try It! to start a request and see the response here!