<h1>Regras de negócio</h1> O cadastro de pedidos no sistema, permite que você registre e gerencie o que foi vendido e precisa ser faturado e entregue indicando, para qual cliente ou parceiro, quais as condições comerciais e financeiras negociadas e demais informações, proporcionando uma clara visão do que está em cada etapa do processo.<br /> <b>OBS:</b> Caso tenha alguma necessidade de configuração do ERP procure “Consultor” ou acesso o link de apoio:<br /> https://ajuda.sankhya.com.br/hc/pt-br/articles/360044612654-Portal-de-Vendasbr <h3>Dependências</h3> Para realizar a inclusão do pedido, os seguintes itens são obrigatórios:<br /> <b>1) </b>Logar no sistema utilizando o Serviço de Login descrito nesta documentação em Login;<br /> <b>2) </b>Produtos/Serviços preeviamente cadastrados e ativos;<br /> <b>3) </b>Empresas previamente cadastradas e ativas;<br /> <b>4) </b>Top's configuradas devidamente tipo de movimentação <b>\"Pedido de venda\"</b>;<br /> <b>5) </b>Tipo de negociação cadastrados seja a vista, a prazo, parcelada, cheque.<br /> <b>6) </b>O parceiro deve estar cadastrado e ativo antes da geração do pedido.<br /> <h3>Detalhes Técnicos</h3> O serviço utilizado para inclusão de notas é o CACSP.IncluirNota que instancia as entidades principais para o envio de pedido, as entidades que este serviço utiliza são: <br /> <b>• CabecalhoNota;</b><br /> <b>• ItemNota.</b><br /> Os campos obrigatórios dependem estritamente da configuração de TOP,empresa, produto, etc. Portanto, neste exemplo colocamos os campos tipicamente obrigatórios em todos os casos de uso. Este exemplo não tenta exaurir as possibilidades,que são muitas, então em alguns casos a chamada a esse serviço pode resultar em mensagem de erro exigindo que outros campos sejam enviados. Apenas um pedido/nota pode ser enviado por vez. <br /> Para realizar a inclusão do pedido através do Json, os campos abaixo são obrigatórios:<br /><br /> <b>CABEÇALHO DO PEDIDO</b>

• NUNOTA – Numero Único da nota;
• CODPARC – Código do Parceiro;
• DTNEG – Data de Negociação;
• CODTIPOPER – Código do Tipo de Operação;
• CODTIPVENDA – Tipo de Negociação;
• CODVEND – Código do vendedor;
• CODEMP – Código da Empresa;
• TIPMOV – Tipo de Movimento.

<b>ITENS DO PEDIDO</b>

• CODPROD – Código do Produto;
• QTDNEG – Quantidade;
• CODLOCALORIG – Código local de Origem;
• CODVOL – Código do Volume;
• IGNOREDESCPROMOQTD - Quando "True" garante que os valores enviados na API não serão alterados devido a algum disconto promocional vigente.

Conforme explicado anteriormente, os campos enviados acima são obrigatórios e são os campos padrões. Os campos abaixo só serão obrigatórios se na requisição o campo "<b><font color=red>INFORMARPRECO</font>"</b> for igual a <b>true</b>, caso contrário os campos abaixo não serão obrigatórios.<br/><br /> <b>• VLRUNIT</b> – Valor Unitário;<br /> <b>• PERCDESC</b> – Percentual de desconto;<br /><br /> <b><font color=red>IMPORTANTE</font>:</b> O atributo <b>INFORMARPRECO</b> serve para enviar o pedido com os valores já negociados e neste caso, o preço e o desconto terão que serem enviados para serem calculados. Caso o campo <b>informarPreço</b> = N então o ERP irá utilizar valor da tabela de preços vigente no momento da inclusão do pedido.

<h3>Descritivo de Campos das Entidades</h3> Acesse [aqui](http://swagger.sankhya.com.br/tabelas/TGFCAB.html) o dicionário de dados da tabela <b>TGFCAB</b><br /> Acesse [aqui](http://swagger.sankhya.com.br/tabelas/TGFITE.html) o dicionário de dados da tabela <b>TGFITE</b><br /> <h3>Exemplo de uso:</h3> <ul> <li>URL Gateway Produção: https://api.sankhya.com.br/</li> <li>URL Gateway Sandbox: https://api.sandbox.sankhya.com.br/</li> </ul> <b>URL de chamada</b>: https://[URL_GATEWAY]/gateway/v1/mgecom/service.sbr?serviceName=CACSP.incluirNota&outputType=json <br /><br /> </b>Corpo de requisição</b>

{
   "serviceName":"CACSP.incluirNota",
   "requestBody":{
      "nota":{
         "cabecalho":{
            "NUNOTA":{
            },
            "CODPARC":{
               "$":"1"
            },
            "DTNEG":{
               "$":"09/12/2022"
            },
            "CODTIPOPER":{
               "$":"2000"
            },
            "CODTIPVENDA":{
               "$":"12"
            },
            "CODVEND":{
               "$":"0"
            },
            "CODEMP":{
               "$":"1"
            },
            "TIPMOV":{
               "$":"O"
            }
         },
         "itens":{
            "INFORMARPRECO":"True",
            "item":[
                  {
                   "NUNOTA":{
                  },
                  "IGNOREDESCPROMOQTD": {
                      "$": "True"
                  },
                  "CODPROD":{
                     "$":"8"
                  },
                  "QTDNEG":{
                     "$":"1"
                  },
                  "CODLOCALORIG":{
                     "$":"0"
                  },
                  "CODVOL":{
                     "$":"UN"
                  },
                  "PERCDESC": {
                    "$": "0"
                  },
                 "VLRUNIT": {
                    "$": "1.75"
                  }
               }               
            ]
         }
      }
   }
}

<b>Retorno:</b><br />

{
    "serviceName": "CACSP.incluirNota",
    "status": "1",
    "pendingPrinting": "false",
    "transactionId": "1484EE05236C4B33DE6355DAA8443EFF",
    "responseBody": {
        "pk": {
            "NUNOTA": {
                "$": "740"
            }
        }
    }
}

<b><font color=red>IMPORTANTE</font>:</b> Este é apenas um exemplo de requisição baseado em um ambiente de teste. Todos os atributos devem ser revistos e ajustados considernado o ambiente do seu caso de uso.