|
<< Click to Display Table of Contents >> Web Services - FaturamentoVerbaConsulta |
  
|
|
<< Click to Display Table of Contents >> Web Services - FaturamentoVerbaConsulta |
|
Consultar as verbas lançadas nos itens das notas fiscais SEM pedido de venda (tela FTTELA93 / EndPoint FaturamentoVerbaGravar).
Utilize os diversos filtros para otimizar a consulta. O resultado é ordenado por empresa, nota, série e item.
Filtros disponíveis: sNotaFiscal, sSerie, sItem, período de emissão, sClienteCNPJ, sClienteNome, sProdutoCodigo, sVerba, sCampanha, sCampanhaID, sDivisaoNegocioID, sDivisaoNegocio e sContabilizada.
O filtro sEmpresaNumero é obrigatório. O filtro sContabilizada aceita S (somente verbas já contabilizadas), N (somente não contabilizadas) ou T (todas); em branco assume T.
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"]
FILTROS:
Nos filtros para consultas, poderá ser utilizado o caracter % (percentual) como coringa:
sCampanha: "VERAO%" (todas as campanhas começando com VERAO)
sCampanha: "%2026" (todas as campanhas terminando com 2026)
sCampanha: "%VERAO%" (todas as campanhas que contenham VERAO em seu nome)
sCampanha: "VERAO 2026" (somente a campanha VERAO 2026)
Para os filtros que não são obrigatórios na consulta, deixando em branco ("") indica que não será aplicado.
Paginação da consulta disponível utilizando as variáveis sPagina (começando da página 1) e sPaginaQtdeRegistros. Deixando as duas em branco, a consulta retorna todos os registros.
PARÂMETROS:
Parâmetro |
Tipo de filtro |
Descrição |
sEmpresaNumero |
Obrigatório |
Número da empresa. |
sNotaFiscal |
Igual |
Número da nota fiscal. |
sSerie |
Aceita % |
Série da nota fiscal. |
sItem |
Igual |
Número do item da nota fiscal. |
sDataEmissaoInicial / Final |
Período |
Período da data de emissão da nota (DD/MM/AAAA). |
sClienteCNPJ |
Aceita % |
CNPJ/CPF do cliente. |
sClienteNome |
Aceita % |
Nome do cliente. |
sProdutoCodigo |
Aceita % |
Código do produto. |
sVerba |
Aceita % |
Código da verba. |
sCampanha |
Aceita % |
Nome da campanha. |
sCampanhaID |
Igual |
ID da campanha. |
sDivisaoNegocioID |
Igual |
ID da divisão de negócio. |
sDivisaoNegocio |
Aceita % |
Nome da divisão de negócio. |
sContabilizada |
S / N / T |
Situação da contabilização. Em branco = T (todas). |
sPagina |
Paginação |
Número da página, começando em 1. |
sPaginaQtdeRegistros |
Paginação |
Quantidade de registros por página. |
RETORNO:
Campo |
Descrição |
sEmpresaNumero, sNotaFiscal, sSerie, sNotaDataEmissao |
Dados da nota fiscal. |
sClienteCNPJ, sClienteNome |
Cliente da nota fiscal. |
sItem, sProdutoCodigo, sProdutoDescricao, sItemValorTotal |
Dados do item da nota fiscal. |
sVerba, sVerbaDescricao, sPercentual |
Verba lançada no item e seu percentual. |
sValorContabilizado |
Valor já contabilizado da verba (em branco quando ainda não contabilizada). |
sDivisaoNegocioID, sDivisaoNegocio |
Divisão de negócio (somente quando a verba utiliza divisão). |
sCampanhaID, sCampanha |
Campanha da verba. |
sErro |
Em caso de erro, o motivo vem no primeiro registro. |
http://jundsoft.ddns.net:10180/WService73/wsJUNDSOFT_FULL_V1.asmx/FaturamentoVerbaConsulta
Filtro Aplicado:
{
"Request": {
"sEmpresaNumero": "12",
"sNotaFiscal": "103366",
"sSerie": "1",
"sItem": "",
"sDataEmissaoInicial": "",
"sDataEmissaoFinal": "",
"sClienteCNPJ": "",
"sClienteNome": "",
"sProdutoCodigo": "",
"sVerba": "",
"sCampanha": "",
"sCampanhaID": "",
"sDivisaoNegocioID": "",
"sDivisaoNegocio": "",
"sContabilizada": "T",
"sPagina": "1",
"sPaginaQtdeRegistros": "50"
}
}
Retorno:
{
"d": [
{
"__type": "wsJUNDSOFT_FULL_V1.FaturamentoVerbaConsultaResponse",
"sEmpresaNumero": "12",
"sNotaFiscal": "103366",
"sSerie": "1",
"sNotaDataEmissao": "13/10/2026",
"sClienteCNPJ": "00000000000",
"sClienteNome": "CLIENTE EXEMPLO",
"sItem": "1",
"sProdutoCodigo": "CELULAR",
"sProdutoDescricao": "CELULAR XPTO DE ULTIMA GERACAO",
"sItemValorTotal": "1760,00",
"sVerba": "VE01",
"sVerbaDescricao": "DESCRICAO VE01",
"sPercentual": "3,7500",
"sValorContabilizado": "",
"sDivisaoNegocioID": "",
"sDivisaoNegocio": "",
"sCampanhaID": "6",
"sCampanha": "TESTE WS CAMPANHA A - ALTERADA",
"sErro": ""
}
]
}