|
<< Click to Display Table of Contents >> Web Services - FaturamentoVerbaGravar |
  
|
|
<< Click to Display Table of Contents >> Web Services - FaturamentoVerbaGravar |
|
EndPoint responsável pela inclusão e alteração da verba de um item de nota fiscal SEM pedido de venda. É o mesmo lançamento da tela FTTELA93 (Verbas da Nota sem Pedido) e utiliza as mesmas consistências da tela.
Quando a nota fiscal possui pedido de venda, a verba deve ser informada no pedido (telas PVTELA01, PVTELA02 ou PVTELA50 - aba Verbas, ou EndPoint PedidoVendaInclusaoSimplificada) e este EndPoint recusa a gravação.
Operações (sTipoOperacao)
I - Inclusão: grava a verba do item. Cada item da nota aceita uma única verba; se o item já possuir verba, utilize a alteração.
A - Alteração: altera a verba já gravada no item (identificado por empresa, nota, série e item). Verbas já contabilizadas não podem ser alteradas.
Regras
- A nota fiscal deve existir na empresa, não pode estar cancelada e não pode possuir pedido de venda.
- A verba (sVerba) é o código da verba, deve estar ativa e ser uma verba NÃO estocada.
- O percentual (sPercentual) deve ser maior que zero; nas verbas calculadas por percentual, no máximo 100. Aceita vírgula ou ponto como separador decimal (2,5 ou 2.5), mas não os dois juntos.
- A divisão de negócio (sDivisaoNegocio) é informada pelo NOME exato e só deve ser informada quando a verba obriga divisão (quando informada, deve estar cadastrada e ativa); quando a verba não utiliza divisão, ela deve ficar em branco.
- A campanha (sCampanha) é obrigatória, informada pelo NOME exato, e deve estar cadastrada e ativa (consulte os nomes no EndPoint CampanhasConsulta).
- O usuário gravado é o usuário do Token utilizado na chamada. Inclusões e alterações ficam registradas no LOG de alterações do sistema.
IMPORTANTE:
Todos os parametros e retornos estão no formato TEXTO. Para gravação de novos registros, UTILIZE CAIXA ALTA E NÃO CARACTERES ESPECIAIS (Ã, Ç, etc.).
Alguns parâmetros são arrays, permitindo mais de um filtro para o mesmo campo. São identificados com as iniciais 'sa' (String Array).
parData: "26/01/2021"
parNumeroDecimal: "10,09"
parTexto: "JOAO DA SILVA"
saEmpresa: ["11", "12"]
PARÂMETROS:
Parâmetro |
Obrigatório |
Descrição |
sTipoOperacao |
Sim |
I = Inclusão, A = Alteração. |
sEmpresaNumero |
Sim |
Número da empresa da nota fiscal. |
sNotaFiscal |
Sim |
Número da nota fiscal. |
sSerie |
Sim |
Série da nota fiscal. |
sItem |
Sim |
Número do item da nota fiscal. |
sVerba |
Sim |
Código da verba (não estocada). |
sPercentual |
Sim |
Percentual da verba. Ex: "2,5". |
sDivisaoNegocio |
Conforme a verba |
Nome da divisão de negócio (cadastrada e ativa). Obrigatório somente quando a verba obriga divisão. |
sCampanha |
Sim |
Nome da campanha (cadastrada e ativa). |
RETORNO:
Campo |
Descrição |
sErro |
Em branco quando a operação foi realizada. Caso contrário, traz o motivo da recusa (nada é gravado). |
sIDGravado |
ID interno da verba do item gravada. Para consultar a verba, utilize o EndPoint FaturamentoVerbaConsulta filtrando por sEmpresaNumero, sNotaFiscal, sSerie e sItem. |
sNumeroGerado |
Não utilizado neste EndPoint. |
http://jundsoft.ddns.net:10180/WService73/wsJUNDSOFT_FULL_V1.asmx/FaturamentoVerbaGravar
Filtro Aplicado (exemplo de inclusão):
{
"Request": {
"sTipoOperacao": "I",
"sEmpresaNumero": "12",
"sNotaFiscal": "103366",
"sSerie": "1",
"sItem": "1",
"sVerba": "VE01",
"sPercentual": "3,75",
"sDivisaoNegocio": "",
"sCampanha": "TESTE WS CAMPANHA A - ALTERADA"
}
}
Retorno (sucesso):
{
"d": [
{
"__type": "wsJUNDSOFT_FULL_V1.RetornoGenerico",
"sErro": "",
"sIDGravado": "1",
"sNumeroGerado": ""
}
]
}