Histórico da Página
Integração via Web Service de Pedidos - Logix
Contexto de negócio
Com o desenvolvimento de Web Service para as principais rotinas do módulo Pedido de Venda do Logix, é possível a utilização dessas funcionalidades/serviços em uma variada gama de aplicações, como por exemplo páginas WEB, aplicativos mobile, Fluig e outros sistemas que suportam requisições HTTP com protocolo REST.
Sistemas Envolvidos
- ERP Logix - Módulo de Pedidos de Venda.
Escopo
Foram desenvolvidos Web Services (WS) no sistema REST para as seguintes funcionalidades do módulo Pedidos do produto Logix:
- Inclusão de pedido.
- Consulta de pedido.
- Modificação de pedido.
- Simulação de faturamento com base no pedido.
- Cancelamento parcial de pedido.
- Cancelamento total de pedido.
- Exclusão de pedido em análise.
Cada Web Service recebe parâmetros de entrada, realiza uma determinada operação e retorna alguns parâmetros de saída. Na secção "Web Services", serão detalhados cada um dos parâmetros.
Para os parâmetros de entrada, existem três tipos diferentes: PathParam, QueryString e PayLoad. No link a seguir, é possível entender a diferença entre eles e como utilizá-los: 2. Parâmetros de Entrada
Todos os WS foram desenvolvidos com base na rotina de pedidos da versão 12, sendo que alguns conceitos/rotinas não foram previstos, por exemplo:
- Integração com módulo de Fluxo de Caixa.
- Conceito de Kit.
- Integração com módulo de Assistência Técnica.
- Conceito de cota de representante.
- Previsão de produção.
Para mais informações sobre o sistema REST na TOTVS, consulte o link: REST ADVPL.
Pré-requisitos instalação/implantação/utilização
- Logix versão 12 com pacote mínimo 12.1.17.
- Server TOTVS TEC configurado com serviço REST. Para mais informações verifique: 01. Configuração.
- Executar o conversor de parâmetro VDP02533 no LOG00086 (Administração de Parâmetros) e configurar o parâmetro "Motivo de desbloqueio dos pedidos via Web Service.".
- Executar o programa VDP10090 (Aprovação de Consistências) para criação da nova consistência 127. Se necessário atualizar o nível de aprovação.
- Liberar no Firewall a porta configurada no server TOTVS TEC para o serviço REST.
Web Services
1- Inclusão de Pedido
Objetivo: Incluir pedido de venda com situação “Em Análise”.
Operação: POST
Exemplo da URL: http://SERVER:PORT/logixrest/vdpr0001/incluiPedidoVenda
Parâmetros de entrada (Tipo: PayLoad):
Parâmetro | Definição | Observação | |
Dados de configuração | |||
lr_parametros | consistir_pedido | CHAR(01) | Indica o tipo de consistência do pedido: N - Não consistir, apenas incluir o pedido em análise; S - Consistir e incluir o pedido em análise; V - Consistir e caso encontre alguma inconsistência diferente de 117 (pedido em análise), não incluir o pedido. |
Dados mestre | |||
lr_principal | cod_empresa | pedidos.cod_empresa | |
num_pedido | pedidos.num_pedido | ||
cod_cliente | pedidos.cod_cliente | ||
dat_emis_repres | pedidos.dat_emis_repres | ||
cod_nat_oper | pedidos.cod_nat_oper | ||
ies_finalidade | pedidos.ies_finalidade | ||
cod_cnd_pgto | pedidos.cod_cnd_pgto | ||
ies_tip_entrega | pedidos.ies_tip_entrega | ||
cod_tip_venda | pedidos.cod_tip_venda | ||
cod_tip_carteira | pedidos.cod_tip_carteira | ||
lr_representante | ies_comissao | pedidos.ies_comissao | |
cod_repres | pedidos.cod_repres | ||
pct_comissao | pedidos.pct_comissao | ||
cod_repres_adic | pedidos.cod_repres_adic | ||
pct_comissao_2 | pedido_comis.pct_comissao_2 | ||
cod_repres_3 | pedido_comis.cod_repres_3 | ||
pct_comissao_3 | pedido_comis.pct_comissao_3 | ||
lr_adicionais | num_pedido_repres | pedidos.num_pedido_repres | |
num_pedido_cli | pedidos.num_pedido_cli | ||
cod_local_estoq | pedidos.cod_local_estoq | ||
pedido_pallet | ped_inf_com_mestre.pedido_pallet | ||
pct_tolera_minima | ped_inf_com_mestre.pct_tolera_minima | ||
pct_tolera_maxima | ped_inf_com_mestre.pct_tolera_maxima | ||
dat_min_fat | ped_inf_com_mestre.dat_min_fat | ||
nota_empenho | ped_inf_com_mestre.nota_empenho | ||
contrato_compra | ped_inf_com_mestre.contrato_compra | ||
forma_pagto | ped_compl_pedido.forma_pagto | ||
processo_export | ped_compl_pedido.processo_export | ||
numero_cno_esocial | DECIMAL(12,0) | ||
cnpj_cpf_subempreiteiro | CHAR(19) | ||
lr_frete | cod_transpor | pedidos.cod_transpor | |
cod_consig | pedidos.cod_consig | ||
ies_frete | pedidos.ies_frete | ||
ies_embal_padrao | pedidos.ies_embal_padrao | ||
pct_frete | pedidos.pct_frete | ||
lr_preco_desconto | ies_preco | pedidos.ies_preco | |
pct_desc_financ | pedidos.pct_desc_financ | ||
pct_desc_adic | pedidos.pct_desc_adic | ||
num_list_preco | pedidos.num_list_preco | ||
cod_moeda | pedidos.cod_moeda | ||
tip_desc | ped_compl_pedido.tip_desc | ||
pct_desc_1 | ped_itens_desc.pct_desc_1 | desconto em cascata do pedido | |
pct_desc_2 | ped_itens_desc.pct_desc_2 | desconto em cascata do pedido | |
pct_desc_3 | ped_itens_desc.pct_desc_3 | desconto em cascata do pedido | |
pct_desc_4 | ped_itens_desc.pct_desc_4 | desconto em cascata do pedido | |
pct_desc_5 | ped_itens_desc.pct_desc_5 | desconto em cascata do pedido | |
pct_desc_6 | ped_itens_desc.pct_desc_6 | desconto em cascata do pedido | |
pct_desc_7 | ped_itens_desc.pct_desc_7 | desconto em cascata do pedido | |
pct_desc_8 | ped_itens_desc.pct_desc_8 | desconto em cascata do pedido | |
pct_desc_9 | ped_itens_desc.pct_desc_9 | desconto em cascata do pedido | |
pct_desc_10 | ped_itens_desc.pct_desc_10 | desconto em cascata do pedido | |
regra_cotacao | ped_inf_com_mestre.regra_cotacao | ||
val_cotacao_fixa | ped_inf_com_mestre.val_cotacao_fixa | ||
data_vigencia | ped_inf_com_mestre.data_vigencia | ||
lr_entrega | num_sequencia | ped_end_ent.num_sequencia | enviar 0 se não pegar o endereço de entrega cadastrado no Logix |
end_entrega | ped_end_ent.end_entrega | ||
den_bairro | ped_end_ent.den_bairro | ||
cod_cidade | ped_end_ent.cod_cidade | ||
cod_cep | ped_end_ent.cod_cep | ||
num_cgc | ped_end_ent.num_cgc | ||
ins_estadual | ped_end_ent.ins_estadual | ||
nom_cliente_end_ent | ped_info_compl.parametro_texto | ||
lr_retirada | seq_endereco_retirada | ped_end_retirada.seq_endereco_retirada | |
razao_social_retir | ped_end_retirada.razao_social_retir | ||
endereco_retirada | ped_end_retirada.endereco_retirada | ||
bairro_retirada | ped_end_retirada.bairro_retirada | ||
cidade_retirada | ped_end_retirada.cidade_retirada | ||
cep_retirada | ped_end_retirada.cep_retirada | ||
cnpj_retirada | ped_end_retirada.cnpj_retirada | ||
inscr_est_retirada | ped_end_retirada.inscr_est_retirada | ||
telefone_retirada | ped_end_retirada.telefone_retirada | ||
lr_compl_nfe | modalidade_frete_nfe | ped_info_nf_e.modalidade_frete_nfe | |
inf_adic_fisco | ped_info_nf_e.inf_adic_fisco | ||
dat_saida | DATE | ||
hor_saida | CHAR(10) | ||
lr_nf_referencia | nota_fiscal | ped_nf_referencia.nota_fiscal | |
serie_nota_fiscal | ped_nf_referencia.serie_nota_fiscal | ||
subser_nota_fiscal | ped_nf_referencia.subser_nota_fiscal | ||
espc_nota_fiscal | ped_nf_referencia.espc_nota_fiscal | ||
dat_emissao | ped_nf_referencia.dat_emissao | ||
modelo_nota_fiscal | ped_nf_referencia.modelo_nota_fiscal | ||
emitente | ped_nf_referencia.emitente | ||
chave_acesso | ped_nf_referencia.chave_acesso | ||
tip_refer | ped_nf_referencia.tip_refer | ||
lr_textos_pedido | tex_observ_1 | ped_observacao.tex_observ_1 | |
tex_observ_2 | ped_observacao.tex_observ_2 | ||
den_texto_1 | ped_itens_texto.den_texto_1 | ||
den_texto_2 | ped_itens_texto.den_texto_2 | ||
den_texto_3 | ped_itens_texto.den_texto_3 | ||
den_texto_4 | ped_itens_texto.den_texto_4 | ||
den_texto_5 | ped_itens_texto.den_texto_5 | ||
lr_cliente_interm | cod_cliente | ped_item_nat.cod_cliente | |
cod_nat_oper | ped_item_nat.cod_nat_oper | ||
cod_cnd_pgto | ped_item_nat.cod_cnd_pgto | ||
sequencia_entrega | vdp_end_entga_intm.sequencia | ||
nom_cliente_entrega | vdp_end_entga_intm.nom_cliente | ||
endereco_entrega | vdp_end_entga_intm.endereco | ||
bairro_entrega | vdp_end_entga_intm.bairro | ||
cidade_entrega | vdp_end_entga_intm.cidade | ||
cep_entrega | vdp_end_entga_intm.cep | ||
cnpj_cpf_entrega | vdp_end_entga_intm.cnpj_cpf | ||
inscricao_estadual_entrega | vdp_end_entga_intm.inscricao_estadual | ||
lr_vendor | pct_taxa_negoc | vendor_pedido.pct_taxa_negoc | |
ies_cnd_vendor | vendor_pedido.ies_cnd_vendor | ||
dat_cnd_vendor | vendor_pedido.dat_cnd_vendor | ||
lr_embarque | mercado | fat_solic_fatura.mercado | |
local_embarque | fat_solic_fatura.local_embarque | ||
modo_embarque | fat_solic_fatura.modo_embarque | ||
dat_hor_embarque | fat_solic_fatura.dat_hor_embarque | ||
cidade_embarque | clientes.cod_cidade | ||
local_despacho | fat_solic_fatura.local_despacho | ||
local_desembarque | INTEGER | ||
la_consignatario_adic | seq_consignatario | ped_consg_adic.seq_consignatario | |
Qtd máxima de registros: 30 | consignatario | ped_consg_adic.consignatario | |
tip_frete | ped_consg_adic.tip_frete | ||
la_processo_refer | tributo | ped_proc_refer.tributo | |
Qtd máxima de registros: 100 | proc_referenciado | ped_proc_refer.proc_referenciado | |
Dados itens: | |||
la_pedido_itens | ind_bonificacao | CHAR(01) | Indica se o item é de bonificação ("S"/"N") |
Qtd máxima de registros: 2000 | sequencia_item | ped_itens.num_sequencia | |
cod_item | ped_itens.cod_item | ||
pct_desc_adic | ped_itens.pct_desc_adic | ||
pre_unit | ped_itens.pre_unit | ||
qtd_pecas_solic | ped_itens.qtd_pecas_solic | ||
prz_entrega | ped_itens.prz_entrega | ||
val_frete_unit | ped_itens.val_frete_unit | ||
val_seguro_unit | ped_itens.val_seguro_unit | ||
pct_desc_1 | ped_itens_desc.pct_desc_1 | desconto em cascata do item | |
pct_desc_2 | ped_itens_desc.pct_desc_2 | desconto em cascata do item | |
pct_desc_3 | ped_itens_desc.pct_desc_3 | desconto em cascata do item | |
pct_desc_4 | ped_itens_desc.pct_desc_4 | desconto em cascata do item | |
pct_desc_5 | ped_itens_desc.pct_desc_5 | desconto em cascata do item | |
pct_desc_6 | ped_itens_desc.pct_desc_6 | desconto em cascata do item | |
pct_desc_7 | ped_itens_desc.pct_desc_7 | desconto em cascata do item | |
pct_desc_8 | ped_itens_desc.pct_desc_8 | desconto em cascata do item | |
pct_desc_9 | ped_itens_desc.pct_desc_9 | desconto em cascata do item | |
pct_desc_10 | ped_itens_desc.pct_desc_10 | desconto em cascata do item | |
den_texto_1 | ped_itens_texto.den_texto_1 | ||
den_texto_2 | ped_itens_texto.den_texto_2 | ||
den_texto_3 | ped_itens_texto.den_texto_3 | ||
den_texto_4 | ped_itens_texto.den_texto_4 | ||
den_texto_5 | ped_itens_texto.den_texto_5 | ||
xped | ped_seq_ped_cliente.xped | ||
nitemped | ped_seq_ped_cliente.nitemped | ||
la_aen_pedido | sequencia_item | ped_itens.num_sequencia | |
Qtd máxima de registros: 2000 | linha_produto | ped_aen_item_ped.linha_produto | |
linha_receita | ped_aen_item_ped.linha_receita | ||
segmto_mercado | ped_aen_item_ped.segmto_mercado | ||
classe_uso | ped_aen_item_ped.classe_uso | ||
la_comissao_item | sequencia_item | ped_itens.num_sequencia | |
Qtd máxima de registros: 2000 | seq_representante | ped_comissao_item.seq_representante | |
representante | ped_comissao_item.representante | ||
pct_comissao | ped_comissao_item.pct_comissao | ||
la_pedido_exportacao | sequencia_item | ped_itens.num_sequencia | |
Qtd máxima de registros: 2000 | seq_registro | ped_exp_item.seq_registro | |
processo_export | ped_exp_item.processo_export | ||
num_reg_export | ped_exp_item.num_reg_export | ||
dat_reg_export | ped_exp_item.dat_reg_export | ||
num_decl_dspc_adua | ped_exp_item.num_decl_dspc_adua | ||
dat_decl_dspc_adua | ped_exp_item.dat_decl_dspc_adua | ||
chave_nfe_export | ped_exp_item.chave_nfe_export | ||
qtd_export_item | ped_exp_item.qtd_export_item | ||
la_remessa_item | sequencia_item | ped_itens.num_sequencia | |
Qtd máxima de registros: 2000 | dat_emis_nf_usina | ped_itens_rem.dat_emis_nf_usina | |
dat_retorno_prev | ped_itens_rem.dat_retorno_prev | ||
cod_motivo_remessa | ped_itens_rem.cod_motivo_remessa | ||
val_estoque | ped_itens_rem.val_estoque | ||
cod_area_negocio | ped_itens_rem.cod_area_negocio | ||
cod_lin_negocio | ped_itens_rem.cod_lin_negocio | ||
num_conta | ped_itens_rem.num_conta | ||
tex_observ | ped_itens_rem.tex_observ | ||
num_pedido_compra | ped_itens_rem.num_pedido_compra | ||
aen_remessa | ped_inf_com_item.aen_remessa | ||
Dados Grade de item: | |||
la_grades_item | sequencia_item | ped_itens.num_sequencia | |
Qtd máxima de registros: 2000 | item | ped_itens_grade.cod_item | |
grade_1 | ped_itens_grade.cod_grade_1 | ||
grade_2 | ped_itens_grade.cod_grade_2 | ||
grade_3 | ped_itens_grade.cod_grade_3 | ||
grade_4 | ped_itens_grade.cod_grade_4 | ||
grade_5 | ped_itens_grade.cod_grade_5 | ||
qtd_pecas_solic | ped_itens_grade.qtd_pecas_solic | ||
la_prazo_grade | sequencia_item | ped_itens.num_sequencia | |
Qtd máxima de registros: 2000 | item | ped_itens_grade.cod_item | |
grade_1 | ped_itens_grade.cod_grade_1 | ||
grade_2 | ped_itens_grade.cod_grade_2 | ||
grade_3 | ped_itens_grade.cod_grade_3 | ||
grade_4 | ped_itens_grade.cod_grade_4 | ||
grade_5 | ped_itens_grade.cod_grade_5 | ||
qtd_pecas_solic | ped_itens_grade.qtd_pecas_solic | ||
prazo_entrega | ped_item_prazo.prazo_entrega |
Exemplo de JSON enviado como parâmetro de entrada:
{
"lr_parametros": {
"consistir_pedido": "N"
},
"lr_principal": {
"cod_empresa": "DV",
"num_pedido": 0,
"cod_cliente": "A1",
"dat_emis_repres":"2016-01-01",
"cod_nat_oper": 1,
"ies_finalidade": 1,
"cod_cnd_pgto": 1,
"ies_tip_entrega": 2,
"cod_tip_venda": 1,
"cod_tip_carteira": "01"
},
"lr_representante": {
"ies_comissao": "S",
"cod_repres": "1",
"pct_comissao": 3.15,
"cod_repres_adic": "2",
"pct_comissao_2": 2.6,
"cod_repres_3": "3",
"pct_comissao_3": 0
},
"lr_adicionais": {
"num_pedido_repres": "ped_repres 10",
"num_pedido_cli": "ped_cli 15",
"cod_local_estoq": "LOCAL B",
"pedido_pallet": "N",
"pct_tolera_minima": 0,
"pct_tolera_maxima": 80,
"dat_min_fat": "2018-01-01",
"nota_empenho": "1654",
"contrato_compra": "1459",
"forma_pagto": "CH",
"processo_export": "489",
"numero_cno_esocial": "",
"cnpj_cpf_subempreiteiro": ""
},
"lr_frete": {
"cod_transpor": "1",
"cod_consig": "3",
"ies_frete": 1,
"ies_embal_padrao": "3",
"pct_frete": 0
},
"lr_preco_desconto": {
"ies_preco": "F",
"pct_desc_financ": 0.69,
"pct_desc_adic": "0.6",
"num_list_preco": null,
"cod_moeda": "1",
"tip_desc": 2,
"pct_desc_1": 0.1,
"pct_desc_2": 0.2,
"pct_desc_3": 0.3,
"pct_desc_4": 0.4,
"pct_desc_5": 0.5,
"pct_desc_6": 0.6,
"pct_desc_7": 0.7,
"pct_desc_8": 0.8,
"pct_desc_9": 0.9,
"pct_desc_10": null,
"regra_cotacao": "F",
"val_cotacao_fixa": 5.0,
"data_vigencia": "2021-04-30"
},
"lr_entrega": {
"num_sequencia": "1",
"end_entrega": "",
"den_bairro": "",
"cod_cidade": "",
"cod_cep": "",
"num_cgc": "",
"ins_estadual": "",
"nom_cliente_end_ent": ""
},
"lr_retirada": {
"seq_endereco_retirada": 2,
"razao_social_retir": "razao retirada",
"endereco_retirada": null,
"bairro_retirada": "santo antonio",
"cidade_retirada": "SC184",
"cep_retirada": "89223-800",
"cnpj_retirada": "",
"inscr_est_retirada": "",
"telefone_retirada": ""
},
"lr_compl_nfe": {
"modalidade_frete_nfe": "9",
"inf_adic_fisco": "info adicional ao fisco",
"dat_saida": "2017-01-26",
"hor_saida": "09:41:55"
},
"lr_nf_referencia": {
"nota_fiscal": null,
"serie_nota_fiscal": null,
"subser_nota_fiscal": null,
"espc_nota_fiscal": null,
"dat_emissao": null,
"modelo_nota_fiscal": null,
"emitente": null,
"chave_acesso": null,
"tip_refer": null
},
"lr_textos_pedido": {
"tex_observ_1": "Observação mestre 1",
"tex_observ_2": "Observação mestre 2",
"den_texto_1": "TEXTO PEDIDO 1",
"den_texto_2": "TEXTO PEDIDO 2",
"den_texto_3": "TEXTO PEDIDO 3",
"den_texto_4": "TEXTO PEDIDO 4",
"den_texto_5": "TEXTO PEDIDO 5"
},
"lr_cliente_interm": {
"cod_cliente": null,
"cod_nat_oper": null,
"cod_cnd_pgto": null,
"sequencia_entrega": null,
"nom_cliente_entrega": null,
"endereco_entrega": null,
"bairro_entrega": null,
"cidade_entrega": null,
"cep_entrega": null,
"cnpj_cpf_entrega": null,
"inscricao_estadual_entrega": null
},
"lr_vendor": {
"pct_taxa_negoc": "",
"ies_cnd_vendor": "",
"dat_cnd_vendor": ""
},
"lr_embarque": {
"mercado": null,
"local_embarque": null,
"modo_embarque": null,
"dat_embarque": null,
"cidade_embarque": null,
"local_despacho": null,
"local_desembarque": null
},
"la_consignatario_adic": [
{
"seq_consignatario": 1,
"consignatario": "AM",
"tip_frete": "3"
}
],
"la_processo_refer": [
{
"tributo": "",
"proc_referenciado": ""
}
],
"la_pedido_itens": [
{
"ind_bonificacao": "N",
"sequencia_item": 1,
"cod_item": "DV_NORMAL",
"pct_desc_adic": 2,
"pre_unit": 1006,
"qtd_pecas_solic": 10,
"prz_entrega": "2017/01/21",
"val_frete_unit": 0,
"val_seguro_unit": 0,
"pct_desc_1": 0.11,
"pct_desc_2": 0.22,
"pct_desc_3": 0.33,
"pct_desc_4": 0.44,
"pct_desc_5": 0.55,
"pct_desc_6": 0.66,
"pct_desc_7": 0.77,
"pct_desc_8": 0.99,
"pct_desc_9": 0.99,
"pct_desc_10": 0.1,
"den_texto_1": "TEXTO ITEM 1",
"den_texto_2": "TEXTO ITEM 2",
"den_texto_3": "TEXTO ITEM 3",
"den_texto_4": "TEXTO ITEM 4",
"den_texto_5": "TEXTO ITEM 5",
"xped": null,
"nitemped": 11
},
{
"ind_bonificacao": "S",
"sequencia_item": 1,
"cod_item": "DV_NORMAL",
"pct_desc_adic": 0,
"pre_unit": 10001,
"qtd_pecas_solic": 19,
"prz_entrega": "2017/01/26",
"val_frete_unit": 0,
"val_seguro_unit": 0,
"pct_desc_1": "",
"pct_desc_2": "",
"pct_desc_3": "",
"pct_desc_4": "",
"pct_desc_5": "",
"pct_desc_6": "",
"pct_desc_7": "",
"pct_desc_8": "",
"pct_desc_9": "",
"pct_desc_10": "",
"den_texto_1": "TEXTO ITEM 1-bonif",
"den_texto_2": "TEXTO ITEM 2-bonif",
"den_texto_3": "TEXTO ITEM 3-bonif",
"den_texto_4": "TEXTO ITEM 4-bonif",
"den_texto_5": "TEXTO ITEM 5-bonif",
"xped": "",
"nitemped": ""
},
{
"ind_bonificacao": "N",
"sequencia_item": 2,
"cod_item": "DV_GRADE",
"pct_desc_adic": 0,
"pre_unit": 2000,
"qtd_pecas_solic": 20,
"prz_entrega": "2017/01/21",
"val_frete_unit": 0,
"val_seguro_unit": 0,
"pct_desc_1": "",
"pct_desc_2": "",
"pct_desc_3": "",
"pct_desc_4": "",
"pct_desc_5": "",
"pct_desc_6": "",
"pct_desc_7": "",
"pct_desc_8": "",
"pct_desc_9": "",
"pct_desc_10": "",
"den_texto_1": "TEXTO ITEM 1-grade",
"den_texto_2": "TEXTO ITEM 2-grade",
"den_texto_3": "TEXTO ITEM 3-grade",
"den_texto_4": "TEXTO ITEM 4-grade",
"den_texto_5": "TEXTO ITEM 5-grade",
"xped": "1",
"nitemped": "2"
}
],
"la_aen_pedido": [
{
"sequencia_item": null,
"linha_produto": "",
"linha_receita": "",
"segmto_mercado": "",
"classe_uso": ""
}
],
"la_comissao_item": [
{
"sequencia_item": 1,
"seq_representante": "1",
"representante": "1",
"pct_comissao": "2"
},
{
"sequencia_item": 2,
"seq_representante": "1",
"representante": "1",
"pct_comissao": "2"
}
],
"la_pedido_exportacao": [
{
"sequencia_item": null,
"seq_registro": "",
"processo_export": "",
"num_reg_export": "",
"dat_reg_export": "",
"num_decl_dspc_adua": "",
"dat_decl_dspc_adua": "",
"chave_nfe_export": "",
"qtd_export_item": ""
}
],
"la_remessa_item": [
{
"sequencia_item": "",
"dat_emis_nf_usina": "",
"dat_retorno_prev": "",
"cod_motivo_remessa": "",
"val_estoque": "",
"cod_area_negocio": "",
"cod_lin_negocio": "",
"num_conta": "",
"tex_observ": "",
"num_pedido_compra": "",
"aen_remessa": ""
}
],
"la_grades_item": [
{
"sequencia_item": 2,
"item": "DV_GRADE",
"grade_1": "1",
"grade_2": "1",
"grade_3": "",
"grade_4": "",
"grade_5": "",
"qtd_pecas_solic": 15
},
{
"sequencia_item": 2,
"item": "DV_GRADE",
"grade_1": "1",
"grade_2": "0002",
"grade_3": "",
"grade_4": "",
"grade_5": "",
"qtd_pecas_solic": 5
}
],
"la_prazo_grade": [
{
"sequencia_item": null,
"item": "",
"grade_1": "",
"grade_2": "",
"grade_3": "",
"grade_4": "",
"grade_5": "",
"qtd_pecas_solic":"" ,
"prazo_entrega": ""
}
]
}
Parâmetros de saída:
Parâmetro |
|
| Definição | Observação |
status | SMALLINT | TRUE (processou) / FALSE (não processou) | ||
msg | CHAR(200) | Retorna msg fixa caso ocorra algum erro. | ||
data | RECORD | |||
pedido | INTEGER | Retorna o número do pedido se status=TRUE | ||
sit_pedido | CHAR(01) | Retorna a situação do pedido se status=TRUE | ||
count_mensagens | SMALLINT | Quantidade de mensagens de retorno | ||
mensagens | RECORD ARRAY | |||
tipo | CHAR(01) | Tipo do texto: E – Erro de execução de SQL; V – Validação de campo; I – Inconsistência do pedido; A – Alerta (Apenas informativa). | ||
texto | CHAR(2000) | Descrição da mensagem |
2 - Web Service Simulação de Faturamento
Objetivo: Simula o faturamento do pedido de venda (Similar a opção existente no VDP20000 – Manutenção de Pedidos).
Operação: POST
Exemplo URL: http://SERVER:PORT/logixrest/vdpr0002/simulaFaturamentoPedido
Parâmetros de entrada (Tipo: PathParam):
Parâmetro | Definição | Observação |
empresa | pedidos.cod_empresa | Obrigatório |
pedido | pedidos.num_pedido | Obrigatório |
Parâmetros de saída:
Parâmetro | Definição | Observação | ||
status | SMALLINT | TRUE (processou) / FALSE (não processou) | ||
msg | CHAR(2000) | Mensagem de erro caso status = FALSE | ||
data | RECORD | |||
mestre | RECORD ARRAY | Dados mestres da NF | ||
trans_nota_fiscal | fat_nf_mestre.trans_nota_fiscal | |||
tip_nota_fiscal | fat_nf_mestre.tip_nota_fiscal | |||
nom_cliente | clientes.nom_cliente | |||
nota_fiscal | fat_nf_mestre.nota_fiscal | |||
val_frete_rodov | fat_nf_mestre.val_frete_rodov | |||
val_frete_cliente | fat_nf_mestre.val_frete_cliente | |||
val_seguro_rodov | fat_nf_mestre.val_seguro_rodov | |||
val_seguro_cliente | fat_nf_mestre.val_seguro_cliente | |||
val_nota_fiscal | fat_nf_mestre.val_nota_fiscal | |||
item | RECORD ARRAY | Dados de item da NF | ||
trans_nota_fiscal | fat_nf_mestre.trans_nota_fiscal | |||
seq_item_pedido | fat_nf_item.seq_item_pedido | |||
item | fat_nf_item.item | |||
des_item | fat_nf_item.des_item | |||
unid_medida | fat_nf_item.unid_medida | |||
qtd_item | fat_nf_item.qtd_item | |||
preco_unit_liquido | fat_nf_item.preco_unit_liquido | |||
val_liquido_item | fat_nf_item.val_liquido_item | |||
seq_item_nf | fat_nf_item.seq_item_nf | |||
tip_item | fat_nf_item.tip_item | |||
duplicata | RECORD ARRAY | Duplicatas da NF | ||
trans_nota_fiscal | fat_nf_mestre.trans_nota_fiscal | |||
seq_duplicata | fat_nf_duplicata.seq_duplicata | |||
val_duplicata | fat_nf_duplicata.val_duplicata | |||
dat_vencto_sdesc | fat_nf_duplicata.dat_vencto_sdesc | |||
dat_vencto_cdesc | fat_nf_duplicata.dat_vencto_cdesc | |||
pct_desc_financ | fat_nf_duplicata.pct_desc_financ | |||
val_bc_comissao | fat_nf_duplicata.val_bc_comissao | |||
tributo_item | RECORD ARRAY | Tributos do item da NF | ||
trans_nota_fiscal | fat_nf_mestre.trans_nota_fiscal | |||
seq_item_nf | fat_nf_item.seq_item_nf | |||
tributo_benef | fat_nf_item_fisc.tributo_benef | |||
bc_tributo_tot | fat_nf_item_fisc.bc_tributo_tot | |||
val_tributo_tot | fat_nf_item_fisc.val_tributo_tot | |||
trans_config | fat_nf_item_fisc.trans_config | |||
tributo_nota | RECORD ARRAY | Tributo total da NF | ||
trans_nota_fiscal | fat_nf_mestre.trans_nota_fiscal | |||
tributo_benef | fat_mestre_fiscal.tributo_benef | |||
bc_tributo_tot | fat_mestre_fiscal.bc_tributo_tot | |||
val_tributo_tot | fat_mestre_fiscal.val_tributo_tot |
3 - Web Service Consulta de Pedido
Objetivo: Consulta os dados de um pedido de venda, podendo ser uma consulta básica, apenas com os dados principais (cabeçalho do pedido) ou completa. Além disso estão disponíveis diversos filtros para restringir a pesquisa.
Operação: GET
Exemplo URL: http://SERVER:PORT/logixrest/vdpr0003/consultaPedidoVenda
Parâmetros de entrada:
Parâmetro | Tipo | Definição | Observação |
tipo_pesquisa | PathParam (Obrigatório) | CHAR(30) | Informar:
|
paginacao | PathParam (Obrigatório) | SMALLINT | Informar a quantidade de pedidos que deseja retornar por execução. Enviar 0 (zero) caso não utilize este recurso. O máximo de pedidos é 50 por execução. |
posicao_inicial_paginacao | PathParam (Obrigatório) | SMALLINT | Informar a posição inicial para seleção dos registros de paginação. Enviar 1 (um) caso não utilize paginação. |
retorna_descricoes | PathParam (Obrigatório) | CHAR(01) | Informar "S" para retornar a descrição dos campos que possuem cadastro externo (Ex: Cliente, Carteira, Natureza de operação, Item, etc) e "N" para não retornar. |
retorna_totais | PathParam (Obrigatório) | CHAR(01) | Informar "S" para retornar o somatório total de quantidade e valor dos itens do pedido e "N" para não retornar. |
data_emissao_de | QueryString | pedidos.dat_emis_repres | Formato: 01/01/2001 |
data_emissao_ate | QueryString | pedidos.dat_emis_repres | Formato: 01/01/2001 |
prazo_entrega_de | QueryString | ped_itens.prz_entrega | Formato: 01/01/2001 |
prazo_entrega_ate | QueryString | ped_itens.prz_entrega | Formato: 01/01/2001 |
campo_sql_livre | QueryString | CHAR(5000) | Campo livre de SQL a ser utilizado na seleção principal. É possível informar diretamente um campo da tabela "pedidos". Ex: campo_sql_livre=pedidos.cod_consig='CLI_25' ou então um SUBSELECT. Ex: campo_sql_livre=EXISTS (SELECT DISTINCT 1 FROM clientes WHERE clientes.cod_cliente = pedidos.cod_cliente AND clientes.cod_tip_cli = '02') |
cod_empresa | QueryString (array) | pedidos.cod_empresa | limitado a 50 linhas |
num_pedido | QueryString (array) | pedidos.num_pedido | limitado a 500 linhas |
cod_cliente | QueryString (array) | pedidos.cod_cliente | limitado a 100 linhas |
cod_nat_oper | QueryString (array) | pedidos.cod_nat_oper | limitado a 100 linhas |
cod_cnd_pgto | QueryString (array) | pedidos.cod_cnd_pgto | limitado a 50 linhas |
cod_tip_carteira | QueryString (array) | pedidos.cod_tip_carteira | limitado a 50 linhas |
cod_repres | QueryString (array) | pedidos.cod_repres | limitado a 100 linhas |
sit_pedido | QueryString (array) | pedidos.ies_sit_pedido | limitado a 20 linhas |
cod_transpor | QueryString (array) | pedidos.cod_transpor | limitado a 50 linhas |
Parâmetros de saída:
Parâmetro |
|
| Definição | Observação |
status | SMALLINT | TRUE (processou) / FALSE (não processou) | ||
msg | CHAR(2000) | Mensagem de erro caso status = FALSE | ||
data | RECORD | |||
status_paginacao | CHAR(40) | Retorna:
| ||
pedidos | RECORD ARRAY | Informações mestres do pedido | ||
cod_empresa | pedidos.cod_empresa | |||
num_pedido | pedidos.num_pedido | |||
cod_cliente | pedidos.cod_cliente | |||
nom_cliente | clientes.nom_cliente | |||
cep_cliente | clientes.cod_cep | |||
num_cgc_cpf_cliente | clientes.num_cgc_cpf | |||
ins_estadual_cliente | clientes.ins_estadual | |||
den_cidade_cliente | cidades.den_cidade | |||
uf_cliente | cidades.cod_uni_feder | |||
pct_comissao | pedidos.pct_comissao | |||
num_pedido_repres | pedidos.num_pedido_repres | |||
dat_emis_repres | pedidos.dat_emis_repres | |||
cod_nat_oper | pedidos.cod_nat_oper | |||
den_nat_oper | nat_operacao.den_nat_oper | |||
cod_transpor | pedidos.cod_transpor | |||
den_transpor | clientes.nom_cliente | |||
cod_consig | pedidos.cod_consig | |||
den_consig | clientes.nom_cliente | |||
ies_finalidade | pedidos.ies_finalidade | |||
ies_frete | pedidos.ies_frete | |||
ies_preco | pedidos.ies_preco | |||
cod_cnd_pgto | pedidos.cod_cnd_pgto | |||
den_cnd_pgto | cond_pgto.den_cnd_pgto | |||
pct_desc_financ | pedidos.pct_desc_financ | |||
ies_embal_padrao | pedidos.ies_embal_padrao | |||
ies_tip_entrega | pedidos.ies_tip_entrega | |||
ies_aceite | pedidos.ies_aceite | |||
ies_sit_pedido | pedidos.ies_sit_pedido | |||
dat_pedido | pedidos.dat_pedido | |||
num_pedido_cli | pedidos.num_pedido_cli | |||
pct_desc_adic | pedidos.pct_desc_adic | |||
num_list_preco | pedidos.num_list_preco | |||
den_list_preco | vdp_lista_preco_mestre.descricao_lista | |||
cod_repres | pedidos.cod_repres | |||
nom_repres | representante.nom_repres | |||
cod_repres_adic | pedidos.cod_repres_adic | |||
nom_repres_adic | representante.nom_repres | |||
dat_alt_sit | pedidos.dat_alt_sit | |||
dat_cancel | pedidos.dat_cancel | |||
cod_tip_venda | pedidos.cod_tip_venda | |||
den_tip_venda | tipo_venda.den_tip_venda | |||
cod_motivo_can | pedidos.cod_motivo_can | |||
dat_ult_fatur | pedidos.dat_ult_fatur | |||
cod_moeda | pedidos.cod_moeda | |||
den_moeda | moeda.den_moeda | |||
ies_comissao | pedidos.ies_comissao | |||
pct_frete | pedidos.pct_frete | |||
cod_tip_carteira | pedidos.cod_tip_carteira | |||
den_tip_carteira | tipo_carteira.den_tip_carteira | |||
num_versao_lista | pedidos.num_versao_lista | |||
cod_local_estoq | pedidos.cod_local_estoq | |||
end_entrega | RECORD ARRAY | Endereço de entrega | ||
cod_empresa | ped_end_ent.cod_empresa | |||
num_pedido | ped_end_ent.num_pedido | |||
end_entrega | ped_end_ent.end_entrega | |||
den_bairro | ped_end_ent.den_bairro | |||
cod_cidade | ped_end_ent.cod_cidade | |||
den_cidade | cidades.den_cidade | |||
cod_cep | ped_end_ent.cod_cep | |||
num_cgc | ped_end_ent.num_cgc | |||
ins_estadual | ped_end_ent.ins_estadual | |||
num_sequencia | ped_end_ent.num_sequencia | |||
nom_cliente_end_ent | ped_info_compl.parametro_texto | |||
observacao | RECORD ARRAY | Observações do pedido | ||
cod_empresa | ped_observacao.cod_empresa | |||
num_pedido | ped_observacao.num_pedido | |||
tex_observ_1 | ped_observacao.tex_observ_1 | |||
tex_observ_2 | ped_observacao.tex_observ_2 | |||
comissao | RECORD ARRAY | Comissões mestres do representante | ||
cod_empresa | pedido_comis.cod_empresa | |||
num_pedido | pedido_comis.num_pedido | |||
pct_comissao_2 | pedido_comis.pct_comissao_2 | |||
cod_repres_3 | pedido_comis.cod_repres_3 | |||
nom_repres_3 | representante.nom_repres | |||
pct_comissao_3 | pedido_comis.pct_comissao_3 | |||
proc_referenciado | RECORD ARRAY | Processo referenciado | ||
empresa | ped_proc_refer.empresa | |||
pedido | ped_proc_refer.pedido | |||
tributo | ped_proc_refer.tributo | |||
proc_referenciado | ped_proc_refer.proc_referenciado | |||
des_iden_processo | vdp_proc_refer.des_iden_processo | |||
nf_referencia | RECORD ARRAY | Notas fiscais de referência | ||
empresa | ped_nf_referencia.empresa | |||
pedido | ped_nf_referencia.pedido | |||
nota_fiscal | ped_nf_referencia.nota_fiscal | |||
serie_nota_fiscal | ped_nf_referencia.serie_nota_fiscal | |||
subser_nota_fiscal | ped_nf_referencia.subser_nota_fiscal | |||
espc_nota_fiscal | ped_nf_referencia.espc_nota_fiscal | |||
dat_emissao | ped_nf_referencia.dat_emissao | |||
modelo_nota_fiscal | ped_nf_referencia.modelo_nota_fiscal | |||
emitente | ped_nf_referencia.emitente | |||
des_emitente | clientes.nom_cliente | |||
chave_acesso | ped_nf_referencia.chave_acesso | |||
tip_refer | ped_nf_referencia.tip_refer | |||
end_retirada | RECORD ARRAY | Endereço de retirada | ||
empresa | ped_end_retirada.empresa | |||
pedido | ped_end_retirada.pedido | |||
razao_social_retir | ped_end_retirada.razao_social_retir | |||
endereco_retirada | ped_end_retirada.endereco_retirada | |||
bairro_retirada | ped_end_retirada.bairro_retirada | |||
cidade_retirada | ped_end_retirada.cidade_retirada | |||
den_cidade | cidades.den_cidade | |||
cep_retirada | ped_end_retirada.cep_retirada | |||
cnpj_retirada | ped_end_retirada.cnpj_retirada | |||
inscr_est_retirada | ped_end_retirada.inscr_est_retirada | |||
telefone_retirada | ped_end_retirada.telefone_retirada | |||
seq_endereco_retirada | ped_end_retirada.seq_endereco_retirada | |||
consignat_adic | RECORD ARRAY | Consignatários adicionais | ||
empresa | ped_consg_adic.empresa | |||
pedido | ped_consg_adic.pedido | |||
seq_consignatario | ped_consg_adic.seq_consignatario | |||
consignatario | ped_consg_adic.consignatario | |||
den_consig | clientes.nom_cliente | |||
tip_frete | ped_consg_adic.tip_frete | |||
vendor | RECORD ARRAY | Taxas Vendor | ||
cod_empresa | vendor_pedido.cod_empresa | |||
num_pedido | vendor_pedido.num_pedido | |||
pct_taxa_negoc | vendor_pedido.pct_taxa_negoc | |||
ies_cnd_vendor | vendor_pedido.ies_cnd_vendor | |||
dat_cnd_vendor | vendor_pedido.dat_cnd_vendor | |||
cliente_intermediario | RECORD ARRAY | Cliente intermediário | ||
cod_empresa | ped_item_nat.cod_empresa | |||
num_pedido | ped_item_nat.num_pedido | |||
cod_cliente | ped_item_nat.cod_cliente | |||
nom_cliente | clientes.nom_cliente | |||
cep_cliente | clientes.cod_cep | |||
num_cgc_cpf_cliente | clientes.num_cgc_cpf | |||
ins_estadual_cliente | clientes.ins_estadual | |||
den_cidade_cliente | cidades.den_cidade | |||
uf_cliente | cidades.cod_uni_feder | |||
cod_nat_oper | ped_item_nat.cod_nat_oper | |||
den_nat_oper | nat_operacao.den_nat_oper | |||
cod_cnd_pgto | ped_item_nat.cod_cnd_pgto | |||
den_cnd_pgto | cond_pgto.den_cnd_pgto | |||
end_entrega_interm | RECORD ARRAY | Endereço de entrega do cliente intermediário | ||
empresa | vdp_end_entga_intm.empresa | |||
pedido | vdp_end_entga_intm.pedido | |||
sequencia | vdp_end_entga_intm.sequencia | |||
nom_cliente | vdp_end_entga_intm.nom_cliente | |||
endereco | vdp_end_entga_intm.endereco | |||
bairro | vdp_end_entga_intm.bairro | |||
cidade | vdp_end_entga_intm.cidade | |||
den_cidade | cidades.den_cidade | |||
cep | vdp_end_entga_intm.cep | |||
cnpj_cpf | vdp_end_entga_intm.cnpj_cpf | |||
inscricao_estadual | vdp_end_entga_intm.inscricao_estadual | |||
embarque | RECORD ARRAY | Dados de embarque | ||
empresa | ped_info_compl.empresa | |||
pedido | ped_info_compl.pedido | |||
mercado | ped_info_compl.parametro_texto | |||
den_mercado | mercado.den_mercado | |||
local_embarque | ped_info_compl.parametro_texto | |||
den_local_embarque | local_embarque.den_local_embarque | |||
modo_embarque | ped_info_compl.parametro_texto | |||
den_mod_embar | modo_embarque.den_mod_embar | |||
dat_hor_embarque | ped_info_compl.parametro_dat | |||
cidade_embarque | ped_info_compl.parametro_texto | |||
den_cidade | cidades.den_cidade | |||
local_despacho | ped_info_compl.parametro_texto | |||
des_local_despacho | vdp_local_despacho.des_local_despacho | |||
local_desembarque | ped_info_compl.parametro_texto | |||
den_local_desembarque | local_embarque.den_local_embarque | |||
esocial | RECORD ARRAY | Esocial | ||
empresa | ped_info_compl.empresa | |||
pedido | ped_info_compl.pedido | |||
numero_cno_esocial | ped_info_compl.parametro_val | |||
cnpj_cpf_subempreiteiro | ped_info_compl.parametro_texto | |||
complemento_pedido | RECORD ARRAY | Complementos do pedido | ||
empresa | ped_compl_pedido.empresa | |||
pedido | ped_compl_pedido.pedido | |||
dat_hor_inclusao | ped_compl_pedido.dat_hor_inclusao | |||
usuario_inclusao | ped_compl_pedido.usuario_inclusao | |||
forma_pagto | ped_compl_pedido.forma_pagto | |||
des_forma_pagto | vdp_forma_pagto.des_forma_pagto | |||
tip_desc | ped_compl_pedido.tip_desc | |||
des_tip_desc | vdp_tip_desc.des_tip_desc | |||
processo_export | ped_compl_pedido.processo_export | |||
info_nf_e | RECORD ARRAY | Informações para NFe | ||
empresa | ped_info_nf_e.empresa | |||
pedido | ped_info_nf_e.pedido | |||
modalidade_frete_nfe | ped_info_nf_e.modalidade_frete_nfe | |||
des_modalidade_frete | obf_modal_fret_nfe.des_modalidade_frete | |||
inf_adic_fisco | ped_info_nf_e.inf_adic_fisco | |||
dat_hor_saida | ped_info_nf_e.dat_hor_saida | |||
inf_complementar | RECORD ARRAY | Informações adicionais mestre | ||
empresa | ped_inf_com_mestre.empresa | |||
pedido | ped_inf_com_mestre.pedido | |||
usuario | ped_inf_com_mestre.usuario | |||
pedido_pallet | ped_inf_com_mestre.pedido_pallet | |||
pct_tolera_minima | ped_inf_com_mestre.pct_tolera_minima | |||
pct_tolera_maxima | ped_inf_com_mestre.pct_tolera_maxima | |||
dat_min_fat | ped_inf_com_mestre.dat_min_fat | |||
dat_inclusao | ped_inf_com_mestre.dat_inclusao | |||
hor_inclusao | ped_inf_com_mestre.hor_inclusao | |||
data_alteracao | ped_inf_com_mestre.data_alteracao | |||
nota_empenho | ped_inf_com_mestre.nota_empenho | |||
contrato_compra | ped_inf_com_mestre.contrato_compra | |||
regra_cotacao | ped_inf_com_mestre.regra_cotacao | |||
val_cotacao_fixa | ped_inf_com_mestre.val_cotacao_fixa | |||
data_vigencia | ped_inf_com_mestre.data_vigencia | |||
desconto_cascata | RECORD ARRAY | Descontos em cascata do pedido e dos itens. Para o desconto de pedido a sequência é igual a 0; | ||
cod_empresa | ped_itens_desc.cod_empresa | |||
num_pedido | ped_itens_desc.num_pedido | |||
num_sequencia | ped_itens_desc.num_sequencia | |||
pct_desc_1 | ped_itens_desc.pct_desc_1 | |||
pct_desc_2 | ped_itens_desc.pct_desc_2 | |||
pct_desc_3 | ped_itens_desc.pct_desc_3 | |||
pct_desc_4 | ped_itens_desc.pct_desc_4 | |||
pct_desc_5 | ped_itens_desc.pct_desc_5 | |||
pct_desc_6 | ped_itens_desc.pct_desc_6 | |||
pct_desc_7 | ped_itens_desc.pct_desc_7 | |||
pct_desc_8 | ped_itens_desc.pct_desc_8 | |||
pct_desc_9 | ped_itens_desc.pct_desc_9 | |||
pct_desc_10 | ped_itens_desc.pct_desc_10 | |||
itens_bonificacao | RECORD ARRAY | Itens de bonificação | ||
cod_empresa | ped_itens_bnf.cod_empresa | |||
num_pedido | ped_itens_bnf.num_pedido | |||
num_sequencia | ped_itens_bnf.num_sequencia | |||
cod_item | ped_itens_bnf.cod_item | |||
den_item | item.den_item | |||
cod_unid_med | item.cod_unid_med | |||
pct_desc_adic | ped_itens_bnf.pct_desc_adic | |||
pre_unit | ped_itens_bnf.pre_unit | |||
qtd_pecas_solic | ped_itens_bnf.qtd_pecas_solic | |||
qtd_pecas_atend | ped_itens_bnf.qtd_pecas_atend | |||
qtd_pecas_cancel | ped_itens_bnf.qtd_pecas_cancel | |||
qtd_pecas_reserv | ped_itens_bnf.qtd_pecas_reserv | |||
prz_entrega | ped_itens_bnf.prz_entrega | |||
qtd_pecas_romaneio | ped_itens_bnf.qtd_pecas_romaneio | |||
pct_desc_bruto | ped_itens_bnf.pct_desc_bruto | |||
itens_texto | RECORD ARRAY | Textos do pedido e dos itens. Para o texto do pedido a sequência é igual a 0. | ||
cod_empresa | ped_itens_texto.cod_empresa | |||
num_pedido | ped_itens_texto.num_pedido | |||
num_sequencia | ped_itens_texto.num_sequencia | |||
den_texto_1 | ped_itens_texto.den_texto_1 | |||
den_texto_2 | ped_itens_texto.den_texto_2 | |||
den_texto_3 | ped_itens_texto.den_texto_3 | |||
den_texto_4 | ped_itens_texto.den_texto_4 | |||
den_texto_5 | ped_itens_texto.den_texto_5 | |||
itens | RECORD ARRAY | Itens normais do pedido | ||
cod_empresa | ped_itens.cod_empresa | |||
num_pedido | ped_itens.num_pedido | |||
num_sequencia | ped_itens.num_sequencia | |||
cod_item | ped_itens.cod_item | |||
den_item | item.den_item | |||
cod_unid_med | item.cod_unid_med | |||
pct_desc_adic | ped_itens.pct_desc_adic | |||
pre_unit | ped_itens.pre_unit | |||
qtd_pecas_solic | ped_itens.qtd_pecas_solic | |||
qtd_pecas_atend | ped_itens.qtd_pecas_atend | |||
qtd_pecas_cancel | ped_itens.qtd_pecas_cancel | |||
qtd_pecas_reserv | ped_itens.qtd_pecas_reserv | |||
prz_entrega | ped_itens.prz_entrega | |||
val_desc_com_unit | ped_itens.val_desc_com_unit | |||
val_frete_unit | ped_itens.val_frete_unit | |||
val_seguro_unit | ped_itens.val_seguro_unit | |||
qtd_pecas_romaneio | ped_itens.qtd_pecas_romaneio | |||
pct_desc_bruto | ped_itens.pct_desc_bruto | |||
itens_aen | RECORD ARRAY | AEN dos itens normais. | ||
empresa | ped_aen_item_ped.empresa | |||
pedido | ped_aen_item_ped.pedido | |||
sequencia | ped_aen_item_ped.sequencia | |||
linha_produto | ped_aen_item_ped.linha_produto | |||
linha_receita | ped_aen_item_ped.linha_receita | |||
segmto_mercado | ped_aen_item_ped.segmto_mercado | |||
classe_uso | ped_aen_item_ped.classe_uso | |||
itens_nat_oper_refer | RECORD ARRAY | Natureza de operação de referência dos itens | ||
cod_empresa | ped_item_nat.cod_empresa | |||
num_pedido | ped_item_nat.num_pedido | |||
num_sequencia | ped_item_nat.num_sequencia | |||
ies_tipo | ped_item_nat.ies_tipo | |||
cod_nat_oper | ped_item_nat.cod_nat_oper | |||
den_nat_oper | nat_operacao.den_nat_oper | |||
cod_cnd_pgto | ped_item_nat.cod_cnd_pgto | |||
den_cnd_pgto | cond_pgto.den_cnd_pgto | |||
itens_remessa | RECORD ARRAY | Itens de remessa. | ||
cod_empresa | ped_itens_rem.cod_empresa | |||
num_pedido | ped_itens_rem.num_pedido | |||
num_sequencia | ped_itens_rem.num_sequencia | |||
dat_emis_nf_usina | ped_itens_rem.dat_emis_nf_usina | |||
dat_retorno_prev | ped_itens_rem.dat_retorno_prev | |||
cod_motivo_remessa | ped_itens_rem.cod_motivo_remessa | |||
den_motivo_remessa | motivo_remessa.den_motivo_remessa | |||
val_estoque | ped_itens_rem.val_estoque | |||
cod_area_negocio | ped_itens_rem.cod_area_negocio | |||
cod_lin_negocio | ped_itens_rem.cod_lin_negocio | |||
num_conta | ped_itens_rem.num_conta | |||
tex_observ | ped_itens_rem.tex_observ | |||
num_pedido_compra | ped_itens_rem.num_pedido_compra | |||
aen_remessa | ped_inf_com_item.aen_remessa | |||
den_estr_linprod | linha_prod.den_estr_linprod | |||
xped_nitemped | RECORD ARRAY | Xped e Nitemped do item para NFe | ||
empresa | ped_seq_ped_cliente.empresa | |||
pedido | ped_seq_ped_cliente.pedido | |||
seq_item_ped | ped_seq_ped_cliente.seq_item_ped | |||
xped | ped_seq_ped_cliente.xped | |||
nitemped | ped_seq_ped_cliente.nitemped | |||
itens_cancel | RECORD ARRAY | Informações de cancelamento dos itens. | ||
cod_empresa | ped_itens_cancel.cod_empresa | |||
num_pedido | ped_itens_cancel.num_pedido | |||
num_sequencia | ped_itens_cancel.num_sequencia | |||
cod_item | ped_itens_cancel.cod_item | |||
dat_cancel | ped_itens_cancel.dat_cancel | |||
cod_motivo_can | ped_itens_cancel.cod_motivo_can | |||
den_motivo | mot_cancel.den_motivo | |||
qtd_pecas_cancel | ped_itens_cancel.qtd_pecas_cancel | |||
itens_grade | RECORD ARRAY | Grades dos itens. | ||
cod_empresa | ped_itens_grade.cod_empresa | |||
num_pedido | ped_itens_grade.num_pedido | |||
num_sequencia | ped_itens_grade.num_sequencia | |||
cod_item | ped_itens_grade.cod_item | |||
cod_grade_1 | ped_itens_grade.cod_grade_1 | |||
den_grade_1 | CHAR(30) | |||
cod_grade_2 | ped_itens_grade.cod_grade_2 | |||
den_grade_2 | CHAR(30) | |||
cod_grade_3 | ped_itens_grade.cod_grade_3 | |||
den_grade_3 | CHAR(30) | |||
cod_grade_4 | ped_itens_grade.cod_grade_4 | |||
den_grade_4 | CHAR(30) | |||
cod_grade_5 | ped_itens_grade.cod_grade_5 | |||
den_grade_5 | CHAR(30) | |||
qtd_pecas_solic | ped_itens_grade.qtd_pecas_solic | |||
qtd_pecas_atend | ped_itens_grade.qtd_pecas_atend | |||
qtd_pecas_cancel | ped_itens_grade.qtd_pecas_cancel | |||
qtd_pecas_reserv | ped_itens_grade.qtd_pecas_reserv | |||
qtd_pecas_romaneio | ped_itens_grade.qtd_pecas_romaneio | |||
itens_prazo | RECORD ARRAY | Prazo de entrega por grade. | ||
empresa | ped_item_prazo.empresa | |||
pedido | ped_item_prazo.pedido | |||
sequencia_item | ped_item_prazo.sequencia_item | |||
item | ped_item_prazo.item | |||
prazo_entrega | ped_item_prazo.prazo_entrega | |||
grade_1 | ped_item_prazo.grade_1 | |||
grade_2 | ped_item_prazo.grade_2 | |||
grade_3 | ped_item_prazo.grade_3 | |||
grade_4 | ped_item_prazo.grade_4 | |||
grade_5 | ped_item_prazo.grade_5 | |||
qtd_pc_solicitada | ped_item_prazo.qtd_pc_solicitada | |||
qtd_pc_cancelada | ped_item_prazo.qtd_pc_cancelada | |||
itens_comissao | RECORD ARRAY | Comissão de representante por item. | ||
empresa | ped_comissao_item.empresa | |||
pedido | ped_comissao_item.pedido | |||
seq_item_pedido | ped_comissao_item.seq_item_pedido | |||
representante | ped_comissao_item.representante | |||
seq_representante | ped_comissao_item.seq_representante | |||
pct_comissao | ped_comissao_item.pct_comissao | |||
itens_exportacao | RECORD ARRAY | Informações de exportação dos itens | ||
empresa | ped_exp_item.empresa | |||
pedido | ped_exp_item.pedido | |||
seq_item_ped | ped_exp_item.seq_item_ped | |||
seq_registro | ped_exp_item.seq_registro | |||
processo_export | ped_exp_item.processo_export | |||
num_reg_export | ped_exp_item.num_reg_export | |||
dat_reg_export | ped_exp_item.dat_reg_export | |||
num_decl_dspc_adua | ped_exp_item.num_decl_dspc_adua | |||
dat_decl_dspc_adua | ped_exp_item.dat_decl_dspc_adua | |||
chave_nfe_export | ped_exp_item.chave_nfe_export | |||
qtd_export_item | ped_exp_item.qtd_export_item | |||
totais | RECORD ARRAY | Somatório total de quantidade e valor dos itens do pedido. (Considera apenas os itens que foram pesquisados) | ||
cod_empresa | pedidos.cod_empresa | |||
num_pedido | pedidos.num_pedido | |||
qtd_saldo | DECIMAL(15,3) | |||
val_bruto_saldo | DECIMAL(17,6) | |||
val_liq_saldo | DECIMAL(17,6) | |||
qtd_total | DECIMAL(15,3) | |||
val_bruto_total | DECIMAL(17,6) | |||
val_liq_total | DECIMAL(17,6) | |||
val_liq_carteira | DECIMAL(17,6) |
4 - Web Service Modificação de Pedido
Para que o processo de modificação de pedido por meio externo (Web Service) ocorra sem interferência de outros processos dentro do Logix, foi criada a consistência de pedido 127 - “Pedido bloqueado para alteração via WEB SERVICE.”. Quando o pedido possuir essa consistência não será possível modificar ou cancelar o pedido por meio do Logix. Caso o pedido esteja em carteira, também será alterada a situação para “B – Bloqueado” impedindo assim que ele seja reservado, romaneado ou faturado.
Portanto, antes de acionar o Web Service de modificação, é necessário acionar o seguinte WS:
Objetivo: Incluir consistência 127 e bloquear o pedido caso esteja em carteira.
Operação: POST
Exemplo URL: http://SERVER:PORT/logixrest/vdpr0004/bloqueiaPedidoAlteracao
Parâmetros de entrada:
Parâmetro | Tipo | Definição | Observação |
empresa | PathParam | pedidos.cod_empresa | |
pedido | PathParam | pedidos.num_pedido | |
usuario | PathParam | usuario.nom_usuario | Caso não informado será considerado o usuário da requisição. |
Parâmetros de saída:
Parâmetro | Definição | Observação |
status | SMALLINT | TRUE (processou) / FALSE (não processou) |
msg | CHAR(2000) | Mensagem de erro ou informação. |
Caso não seja mais necessário modificar o pedido, deve-se utilizar o Web Service a seguir para realizar o desbloqueio do pedido e aprovação da consistência 127:
Objetivo: Aprovar a consistência 127 e desbloquear o pedido caso não exista mais consistência.
Informações | ||
---|---|---|
| ||
É necessário cadastrar o parâmetro"Motivo de desbloqueio dos pedidos via Web Service." no LOG00086. |
Operação: POST
Exemplo URL: http://SERVER:PORT/logixrest/vdpr0004/desbloqueiaPedidoAlteracao
Parâmetros de entrada:
Parâmetro | Tipo | Definição | Observação |
empresa | PathParam | pedidos.cod_empresa | |
pedido | PathParam | pedidos.num_pedido | |
usuario | PathParam | usuario.nom_usuario | Caso não informado será considerado o usuário da requisição. |
Parâmetros de saída:
Parâmetro | Definição | Observação |
status | SMALLINT | TRUE (processou) / FALSE (não processou) |
msg | CHAR(2000) | Mensagem de erro ou informação. |
Nota | ||
---|---|---|
| ||
A aprovação da nova consistência poderá ser realizada também pelo VDP20021. Ficando sob a responsabilidade do cliente o cadastro da alçada de aprovação no VDP10090. |
Objetivo: Realizar a modificação e consistências do pedido, além de retirar a consistência 127 e desbloquear o pedido caso não exista mais consistência.
Informações | ||
---|---|---|
| ||
Independente do campo/tabela alterado todos os demais deverão ser preenchidos também, pois caso contrário o WS entenderá que esse campo/tabela foi excluído. |
Operação: PUT
Exemplo URL: http://SERVER:PORT/logixrest/vdpr0005/modificaPedidoVenda
Parâmetros de entrada (Tipo: PayLoad):
Parâmetro | Definição | Observação | |
Dados mestre | |||
lr_principal | cod_empresa | pedidos.cod_empresa | |
num_pedido | pedidos.num_pedido | ||
cod_cliente | pedidos.cod_cliente | ||
dat_emis_repres | pedidos.dat_emis_repres | ||
cod_nat_oper | pedidos.cod_nat_oper | ||
ies_finalidade | pedidos.ies_finalidade | ||
cod_cnd_pgto | pedidos.cod_cnd_pgto | ||
ies_tip_entrega | pedidos.ies_tip_entrega | ||
cod_tip_venda | pedidos.cod_tip_venda | ||
cod_tip_carteira | pedidos.cod_tip_carteira | ||
lr_representante | ies_comissao | pedidos.ies_comissao | |
cod_repres | pedidos.cod_repres | ||
pct_comissao | pedidos.pct_comissao | ||
cod_repres_adic | pedidos.cod_repres_adic | ||
pct_comissao_2 | pedido_comis.pct_comissao_2 | ||
cod_repres_3 | pedido_comis.cod_repres_3 | ||
pct_comissao_3 | pedido_comis.pct_comissao_3 | ||
lr_adicionais | num_pedido_repres | pedidos.num_pedido_repres | |
num_pedido_cli | pedidos.num_pedido_cli | ||
cod_local_estoq | pedidos.cod_local_estoq | ||
pedido_pallet | ped_inf_com_mestre.pedido_pallet | ||
pct_tolera_minima | ped_inf_com_mestre.pct_tolera_minima | ||
pct_tolera_maxima | ped_inf_com_mestre.pct_tolera_maxima | ||
dat_min_fat | ped_inf_com_mestre.dat_min_fat | ||
nota_empenho | ped_inf_com_mestre.nota_empenho | ||
contrato_compra | ped_inf_com_mestre.contrato_compra | ||
forma_pagto | ped_compl_pedido.forma_pagto | ||
processo_export | ped_compl_pedido.processo_export | ||
numero_cno_esocial | DECIMAL(12,0) | ||
cnpj_cpf_subempreiteiro | CHAR(19) | ||
lr_frete | cod_transpor | pedidos.cod_transpor | |
cod_consig | pedidos.cod_consig | ||
ies_frete | pedidos.ies_frete | ||
ies_embal_padrao | pedidos.ies_embal_padrao | ||
pct_frete | pedidos.pct_frete | ||
lr_preco_desconto | ies_preco | pedidos.ies_preco | |
pct_desc_financ | pedidos.pct_desc_financ | ||
pct_desc_adic | pedidos.pct_desc_adic | ||
num_list_preco | pedidos.num_list_preco | ||
cod_moeda | pedidos.cod_moeda | ||
tip_desc | ped_compl_pedido.tip_desc | ||
pct_desc_1 | ped_itens_desc.pct_desc_1 | desconto em cascata do pedido | |
pct_desc_2 | ped_itens_desc.pct_desc_2 | desconto em cascata do pedido | |
pct_desc_3 | ped_itens_desc.pct_desc_3 | desconto em cascata do pedido | |
pct_desc_4 | ped_itens_desc.pct_desc_4 | desconto em cascata do pedido | |
pct_desc_5 | ped_itens_desc.pct_desc_5 | desconto em cascata do pedido | |
pct_desc_6 | ped_itens_desc.pct_desc_6 | desconto em cascata do pedido | |
pct_desc_7 | ped_itens_desc.pct_desc_7 | desconto em cascata do pedido | |
pct_desc_8 | ped_itens_desc.pct_desc_8 | desconto em cascata do pedido | |
pct_desc_9 | ped_itens_desc.pct_desc_9 | desconto em cascata do pedido | |
pct_desc_10 | ped_itens_desc.pct_desc_10 | desconto em cascata do pedido | |
regra_cotacao | ped_inf_com_mestre.regra_cotacao | ||
val_cotacao_fixa | ped_inf_com_mestre.val_cotacao_fixa | ||
data_vigencia | ped_inf_com_mestre.data_vigencia | ||
lr_entrega | num_sequencia | ped_end_ent.num_sequencia | enviar 0 se não pegar o endereço de entrega cadastrado no Logix |
end_entrega | ped_end_ent.end_entrega | ||
den_bairro | ped_end_ent.den_bairro | ||
cod_cidade | ped_end_ent.cod_cidade | ||
cod_cep | ped_end_ent.cod_cep | ||
num_cgc | ped_end_ent.num_cgc | ||
ins_estadual | ped_end_ent.ins_estadual | ||
nom_cliente_end_ent | ped_info_compl.parametro_texto | ||
lr_retirada | seq_endereco_retirada | ped_end_retirada.seq_endereco_retirada | |
razao_social_retir | ped_end_retirada.razao_social_retir | ||
endereco_retirada | ped_end_retirada.endereco_retirada | ||
bairro_retirada | ped_end_retirada.bairro_retirada | ||
cidade_retirada | ped_end_retirada.cidade_retirada | ||
cep_retirada | ped_end_retirada.cep_retirada | ||
cnpj_retirada | ped_end_retirada.cnpj_retirada | ||
inscr_est_retirada | ped_end_retirada.inscr_est_retirada | ||
telefone_retirada | ped_end_retirada.telefone_retirada | ||
lr_compl_nfe | modalidade_frete_nfe | ped_info_nf_e.modalidade_frete_nfe | |
inf_adic_fisco | ped_info_nf_e.inf_adic_fisco | ||
dat_saida | DATE | ||
hor_saida | CHAR(10) | ||
lr_nf_referencia | nota_fiscal | ped_nf_referencia.nota_fiscal | |
serie_nota_fiscal | ped_nf_referencia.serie_nota_fiscal | ||
subser_nota_fiscal | ped_nf_referencia.subser_nota_fiscal | ||
espc_nota_fiscal | ped_nf_referencia.espc_nota_fiscal | ||
dat_emissao | ped_nf_referencia.dat_emissao | ||
modelo_nota_fiscal | ped_nf_referencia.modelo_nota_fiscal | ||
emitente | ped_nf_referencia.emitente | ||
chave_acesso | ped_nf_referencia.chave_acesso | ||
tip_refer | ped_nf_referencia.tip_refer | ||
lr_textos_pedido | tex_observ_1 | ped_observacao.tex_observ_1 | |
tex_observ_2 | ped_observacao.tex_observ_2 | ||
den_texto_1 | ped_itens_texto.den_texto_1 | ||
den_texto_2 | ped_itens_texto.den_texto_2 | ||
den_texto_3 | ped_itens_texto.den_texto_3 | ||
den_texto_4 | ped_itens_texto.den_texto_4 | ||
den_texto_5 | ped_itens_texto.den_texto_5 | ||
lr_cliente_interm | cod_cliente | ped_item_nat.cod_cliente | |
cod_nat_oper | ped_item_nat.cod_nat_oper | ||
cod_cnd_pgto | ped_item_nat.cod_cnd_pgto | ||
sequencia_entrega | vdp_end_entga_intm.sequencia | ||
nom_cliente_entrega | vdp_end_entga_intm.nom_cliente | ||
endereco_entrega | vdp_end_entga_intm.endereco | ||
bairro_entrega | vdp_end_entga_intm.bairro | ||
cidade_entrega | vdp_end_entga_intm.cidade | ||
cep_entrega | vdp_end_entga_intm.cep | ||
cnpj_cpf_entrega | vdp_end_entga_intm.cnpj_cpf | ||
inscricao_estadual_entrega | vdp_end_entga_intm.inscricao_estadual | ||
lr_vendor | pct_taxa_negoc | vendor_pedido.pct_taxa_negoc | |
ies_cnd_vendor | vendor_pedido.ies_cnd_vendor | ||
dat_cnd_vendor | vendor_pedido.dat_cnd_vendor | ||
lr_embarque | mercado | fat_solic_fatura.mercado | |
local_embarque | fat_solic_fatura.local_embarque | ||
modo_embarque | fat_solic_fatura.modo_embarque | ||
dat_hor_embarque | fat_solic_fatura.dat_hor_embarque | ||
cidade_embarque | clientes.cod_cidade | ||
local_despacho | fat_solic_fatura.local_despacho | ||
local_desembarque | integer | ||
la_consignatario_adic | seq_consignatario | ped_consg_adic.seq_consignatario | |
Qtd máxima de registros: 30 | consignatario | ped_consg_adic.consignatario | |
tip_frete | ped_consg_adic.tip_frete | ||
la_processo_refer | tributo | ped_proc_refer.tributo | |
Qtd máxima de registros: 100 | proc_referenciado | ped_proc_refer.proc_referenciado | |
Dados itens: | |||
la_pedido_itens | ind_bonificacao | CHAR(01) | Indica se o item é de bonificação ("S"/"N") |
Qtd máxima de registros: 2000 | sequencia_item | ped_itens.num_sequencia | |
cod_item | ped_itens.cod_item | ||
pct_desc_adic | ped_itens.pct_desc_adic | ||
pre_unit | ped_itens.pre_unit | ||
qtd_acrescentar | ped_itens.qtd_pecas_solic | ||
qtd_subtrair | ped_itens.qtd_pecas_solic | Somente para pedidos "Em análise" será possível diminuir a quantidade do item. | |
prz_entrega | ped_itens.prz_entrega | ||
val_frete_unit | ped_itens.val_frete_unit | ||
val_seguro_unit | ped_itens.val_seguro_unit | ||
pct_desc_1 | ped_itens_desc.pct_desc_1 | desconto em cascata do item | |
pct_desc_2 | ped_itens_desc.pct_desc_2 | desconto em cascata do item | |
pct_desc_3 | ped_itens_desc.pct_desc_3 | desconto em cascata do item | |
pct_desc_4 | ped_itens_desc.pct_desc_4 | desconto em cascata do item | |
pct_desc_5 | ped_itens_desc.pct_desc_5 | desconto em cascata do item | |
pct_desc_6 | ped_itens_desc.pct_desc_6 | desconto em cascata do item | |
pct_desc_7 | ped_itens_desc.pct_desc_7 | desconto em cascata do item | |
pct_desc_8 | ped_itens_desc.pct_desc_8 | desconto em cascata do item | |
pct_desc_9 | ped_itens_desc.pct_desc_9 | desconto em cascata do item | |
pct_desc_10 | ped_itens_desc.pct_desc_10 | desconto em cascata do item | |
den_texto_1 | ped_itens_texto.den_texto_1 | ||
den_texto_2 | ped_itens_texto.den_texto_2 | ||
den_texto_3 | ped_itens_texto.den_texto_3 | ||
den_texto_4 | ped_itens_texto.den_texto_4 | ||
den_texto_5 | ped_itens_texto.den_texto_5 | ||
xped | ped_seq_ped_cliente.xped | ||
nitemped | ped_seq_ped_cliente.nitemped | ||
motivo_alteracao | ped_inf_com_item.motivo_alteracao | Motivo de alteração | |
la_aen_pedido | sequencia_item | ped_itens.num_sequencia | |
Qtd máxima de registros: 2000 | linha_produto | ped_aen_item_ped.linha_produto | |
linha_receita | ped_aen_item_ped.linha_receita | ||
segmto_mercado | ped_aen_item_ped.segmto_mercado | ||
classe_uso | ped_aen_item_ped.classe_uso | ||
la_comissao_item | sequencia_item | ped_itens.num_sequencia | |
Qtd máxima de registros: 2000 | seq_representante | ped_comissao_item.seq_representante | |
representante | ped_comissao_item.representante | ||
pct_comissao | ped_comissao_item.pct_comissao | ||
la_pedido_exportacao | sequencia_item | ped_itens.num_sequencia | |
Qtd máxima de registros: 2000 | seq_registro | ped_exp_item.seq_registro | |
processo_export | ped_exp_item.processo_export | ||
num_reg_export | ped_exp_item.num_reg_export | ||
dat_reg_export | ped_exp_item.dat_reg_export | ||
num_decl_dspc_adua | ped_exp_item.num_decl_dspc_adua | ||
dat_decl_dspc_adua | ped_exp_item.dat_decl_dspc_adua | ||
chave_nfe_export | ped_exp_item.chave_nfe_export | ||
qtd_export_item | ped_exp_item.qtd_export_item | ||
la_remessa_item | sequencia_item | ped_itens.num_sequencia | |
Qtd máxima de registros: 2000 | dat_emis_nf_usina | ped_itens_rem.dat_emis_nf_usina | |
dat_retorno_prev | ped_itens_rem.dat_retorno_prev | ||
cod_motivo_remessa | ped_itens_rem.cod_motivo_remessa | ||
val_estoque | ped_itens_rem.val_estoque | ||
cod_area_negocio | ped_itens_rem.cod_area_negocio | ||
cod_lin_negocio | ped_itens_rem.cod_lin_negocio | ||
num_conta | ped_itens_rem.num_conta | ||
tex_observ | ped_itens_rem.tex_observ | ||
num_pedido_compra | ped_itens_rem.num_pedido_compra | ||
aen_remessa | ped_inf_com_item.aen_remessa | ||
Dados Grade de item: | |||
la_grades_item | sequencia_item | ped_itens.num_sequencia | |
Qtd máxima de registros: 2000 | item | ped_itens_grade.cod_item | |
grade_1 | ped_itens_grade.cod_grade_1 | ||
grade_2 | ped_itens_grade.cod_grade_2 | ||
grade_3 | ped_itens_grade.cod_grade_3 | ||
grade_4 | ped_itens_grade.cod_grade_4 | ||
grade_5 | ped_itens_grade.cod_grade_5 | ||
qtd_acrescentar | ped_itens_grade.qtd_pecas_solic | ||
qtd_subtrair | ped_itens_grade.qtd_pecas_solic | ||
la_prazo_grade | sequencia_item | ped_itens.num_sequencia | |
Qtd máxima de registros: 2000 | item | ped_itens_grade.cod_item | |
grade_1 | ped_itens_grade.cod_grade_1 | ||
grade_2 | ped_itens_grade.cod_grade_2 | ||
grade_3 | ped_itens_grade.cod_grade_3 | ||
grade_4 | ped_itens_grade.cod_grade_4 | ||
grade_5 | ped_itens_grade.cod_grade_5 | ||
qtd_acrescentar | ped_itens_grade.qtd_pecas_solic | ||
qtd_subtrair | ped_itens_grade.qtd_pecas_solic | ||
prazo_entrega | ped_item_prazo.prazo_entrega |
Exemplo de JSON enviado como parâmetro de entrada:
{
"lr_principal": {
"cod_empresa": "DV",
"num_pedido": 5831,
"cod_cliente": "A1",
"dat_emis_repres":"2016-01-03",
"cod_nat_oper": 1,
"ies_finalidade": 3,
"cod_cnd_pgto": 1,
"ies_tip_entrega": 1,
"cod_tip_venda": 2,
"cod_tip_carteira": "01"
},
"lr_representante": {
"ies_comissao": "S",
"cod_repres": "2",
"pct_comissao": 0.15,
"cod_repres_adic": "1",
"pct_comissao_2": 1.6,
"cod_repres_3": "5",
"pct_comissao_3": 1
},
"lr_adicionais": {
"num_pedido_repres": "ped_repres 20",
"num_pedido_cli": "ped_cli 20",
"cod_local_estoq": "LOCAL C",
"pedido_pallet": "S",
"pct_tolera_minima": 1,
"pct_tolera_maxima": 50,
"dat_min_fat": "2018-11-01",
"nota_empenho": "14",
"contrato_compra": "1119",
"forma_pagto": "BO",
"processo_export": "19",
"numero_cno_esocial": "",
"cnpj_cpf_subempreiteiro": ""
},
"lr_frete": {
"cod_transpor": "3",
"cod_consig": "1",
"ies_frete": 3,
"ies_embal_padrao": "3",
"pct_frete": 0
},
"lr_preco_desconto": {
"ies_preco": "R",
"pct_desc_financ": 0.69,
"pct_desc_adic": "0.66",
"num_list_preco": null,
"cod_moeda": "1",
"tip_desc": 1,
"pct_desc_1": 0.1,
"pct_desc_2": 0.2,
"pct_desc_3": 0.3,
"pct_desc_4": 0.4,
"pct_desc_5": 0.5,
"pct_desc_6": 0.6,
"pct_desc_7": 0.7,
"pct_desc_8": 0.8,
"pct_desc_9": 0.9,
"pct_desc_10": 0.10,
"regra_cotacao": "F",
"val_cotacao_fixa": 5.0,
"data_vigencia": "2021-04-30"
},
"lr_entrega": {
"num_sequencia": "",
"end_entrega": "",
"den_bairro": "",
"cod_cidade": "",
"cod_cep": "",
"num_cgc": "",
"ins_estadual": "",
"nom_cliente_end_ent": ""
},
"lr_retirada": {
"seq_endereco_retirada": null,
"razao_social_retir": "",
"endereco_retirada": "",
"bairro_retirada": "",
"cidade_retirada": "",
"cep_retirada": "",
"cnpj_retirada": "",
"inscr_est_retirada": "",
"telefone_retirada": ""
},
"lr_compl_nfe": {
"modalidade_frete_nfe": null,
"inf_adic_fisco": null,
"dat_saida": null,
"hor_saida": null
},
"lr_nf_referencia": {
"nota_fiscal": 211,
"serie_nota_fiscal": "1",
"subser_nota_fiscal": "0",
"espc_nota_fiscal": "SERV",
"dat_emissao": "2016-02-24",
"modelo_nota_fiscal": "1",
"emitente": "EMR",
"chave_acesso": "FG",
"tip_refer": "2"
},
"lr_textos_pedido": {
"tex_observ_1": "ObservaçãoAlguém zela por ti",
"tex_observ_2": "Observação mestre 2 -MODI",
"den_texto_1": "TEXTO PEDIDO 1-MO",
"den_texto_2": "TEXTO PEDIDO 2-MO",
"den_texto_3": "TEXTO PEDIDO 3-MO",
"den_texto_4": "TEXTO PEDIDO 4-MO",
"den_texto_5": "TEXTO PEDIDO 5-MO"
},
"lr_cliente_interm": {
"cod_cliente": "",
"cod_nat_oper": "",
"cod_cnd_pgto": "",
"sequencia_entrega": "",
"nom_cliente_entrega": "",
"endereco_entrega": "",
"bairro_entrega": "",
"cidade_entrega": "",
"cep_entrega": "",
"cnpj_cpf_entrega": "",
"inscricao_estadual_entrega": ""
},
"lr_vendor": {
"pct_taxa_negoc": "",
"ies_cnd_vendor": "",
"dat_cnd_vendor": ""
},
"lr_embarque": {
"mercado": null,
"local_embarque": null,
"modo_embarque": null,
"dat_hor_embarque": null,
"cidade_embarque": null,
"local_despacho": null,
"local_desembarque": null
},
"la_consignatario_adic": [
{
"seq_consignatario": 1,
"consignatario": "AM",
"tip_frete": "3"
}
],
"la_processo_refer": [
{
"tributo": "",
"proc_referenciado": ""
}
],
"la_pedido_itens": [
{
"ind_bonificacao": "N",
"sequencia_item": 1,
"cod_item": "DV_NORMAL",
"pct_desc_adic": 0,
"pre_unit": 15,
"qtd_acrescentar": 0,
"qtd_subtrair": 0,
"prz_entrega": "2017/01/21",
"val_frete_unit": 0,
"val_seguro_unit": 0,
"pct_desc_1": 1,
"pct_desc_2": 2,
"pct_desc_3": 3,
"pct_desc_4": 4,
"pct_desc_5": 5,
"pct_desc_6": 6,
"pct_desc_7": 7,
"pct_desc_8": 8,
"pct_desc_9": 9,
"pct_desc_10": 10,
"den_texto_1": "TEXTO ITEM 1",
"den_texto_2": "TEXTO ITEM 2",
"den_texto_3": "TEXTO ITEM 3",
"den_texto_4": "TEXTO ITEM 4",
"den_texto_5": "TEXTO ITEM 5",
"xped": "2",
"nitemped": "11",
"motivo_alteracao": "1"
},
{
"ind_bonificacao": "N",
"sequencia_item": 2,
"cod_item": "DV_GRADE",
"pct_desc_adic": 1,
"pre_unit": 15,
"qtd_acrescentar": 100,
"qtd_subtrair": 0,
"prz_entrega": "2017/01/21",
"val_frete_unit": 0,
"val_seguro_unit": 0,
"pct_desc_1": 1,
"pct_desc_2": 2,
"pct_desc_3": 3,
"pct_desc_4": 4,
"pct_desc_5": 5,
"pct_desc_6": 6,
"pct_desc_7": 7,
"pct_desc_8": 8,
"pct_desc_9": 9,
"pct_desc_10": 10,
"den_texto_1": "TEXTO ITEM 1",
"den_texto_2": "TEXTO ITEM 2",
"den_texto_3": "TEXTO ITEM 3",
"den_texto_4": "TEXTO ITEM 4",
"den_texto_5": "TEXTO ITEM 5",
"xped": 16,
"nitemped": 11,
"motivo_alteracao": "1"
},
{
"ind_bonificacao": "S",
"sequencia_item": 1,
"cod_item": "DV_NORMAL",
"pct_desc_adic": 2,
"pre_unit": 15,
"qtd_acrescentar": 80,
"qtd_subtrair": 0,
"prz_entrega": "2017/01/21",
"val_frete_unit": 0,
"val_seguro_unit": 0,
"pct_desc_1": 1,
"pct_desc_2": 2,
"pct_desc_3": 3,
"pct_desc_4": 4,
"pct_desc_5": 5,
"pct_desc_6": 6,
"pct_desc_7": 7,
"pct_desc_8": 8,
"pct_desc_9": 9,
"pct_desc_10": 10,
"den_texto_1": "TEXTO ITEM 1",
"den_texto_2": "TEXTO ITEM 2",
"den_texto_3": "TEXTO ITEM 3",
"den_texto_4": "TEXTO ITEM 4",
"den_texto_5": "TEXTO ITEM 5",
"xped": 16,
"nitemped": 11,
"motivo_alteracao": "1"
}
],
"la_aen_pedido": [
{
"sequencia_item": null,
"linha_produto": "",
"linha_receita": "",
"segmto_mercado": "",
"classe_uso": ""
}
],
"la_comissao_item": [
{
"sequencia_item": 1,
"seq_representante": "1",
"representante": "2",
"pct_comissao": "2"
}
],
"la_pedido_exportacao": [
{
"sequencia_item": null,
"seq_registro": "",
"processo_export": "",
"num_reg_export": "",
"dat_reg_export": "",
"num_decl_dspc_adua": "",
"dat_decl_dspc_adua": "",
"chave_nfe_export": "",
"qtd_export_item": ""
}
],
"la_remessa_item": [
{
"sequencia_item": "",
"dat_emis_nf_usina": "",
"dat_retorno_prev": "",
"cod_motivo_remessa": "",
"val_estoque": "",
"cod_area_negocio": "",
"cod_lin_negocio": "",
"num_conta": "",
"tex_observ": "",
"num_pedido_compra": "",
"aen_remessa": ""
}
],
"la_grades_item": [
{
"sequencia_item": 2,
"item": "DV_GRADE",
"grade_1": "1",
"grade_2": "1",
"grade_3": "",
"grade_4": "",
"grade_5": "",
"qtd_acrescentar":50,
"qtd_subtrair": 0
},
{
"sequencia_item": 2,
"item": "DV_GRADE",
"grade_1": "1",
"grade_2": "0002",
"grade_3": "",
"grade_4": "",
"grade_5": "",
"qtd_acrescentar": 50,
"qtd_subtrair":0
}
],
"la_prazo_grade": [
{
"sequencia_item": null,
"item": "",
"grade_1": "",
"grade_2": "",
"grade_3": "",
"grade_4": "",
"grade_5": "",
"qtd_acrescentar": 0,
"qtd_subtrair": 0,
"prazo_entrega": ""
}
]
}
Parâmetros de saída:
Parâmetro | Definição | Observação | ||
status | SMALLINT | TRUE (processou) / FALSE (não processou) | ||
msg | CHAR(200) | Não utilizado. | ||
data | RECORD | |||
sit_pedido | CHAR(01) | Retorna a situação do pedido se status=TRUE | ||
count_mensagens | SMALLINT | Quantidade de mensagens de retorno | ||
mensagens | RECORD ARRAY | |||
tipo | CHAR(01) | Tipo do texto: E – Erro de execução de SQL; V – Validação de campo; I – Inconsistência do pedido; A – Alerta (Apenas informativa). | ||
texto | CHAR(2000) | Descrição da mensagem |
5 - Web Service Cancelamento Total de Pedido
Objetivo: Realizar o cancelamento total do pedido de venda em carteira.
Operação: POST
Exemplo URL: http://SERVER:PORT/logixrest/vdpr0006/cancelaPedidoTotal
Parâmetros de entrada:
Parâmetro | Tipo | Definição | Observação |
empresa | PathParam | pedidos.cod_empresa | |
pedido | PathParam | pedidos.num_pedido | |
motivo | PathParam | mot_cancel.cod_motivo | Motivo cadastrado na tabela "mot_cancel" |
usuario | QueryString | usuario.nom_usuario | Caso não informado será considerado o usuário da requisição. |
Parâmetros de saída:
Parâmetro | Definição | Observação |
status | SMALLINT | TRUE (processou) / FALSE (não processou) |
msg | CHAR(2000) | Mensagem de erro ou informação. |
6 - Web Service Cancelamento Parcial de Pedido
Objetivo: Realizar o cancelamento parcial do pedido de venda em carteira.
Operação: POST
Exemplo URL: http://SERVER:PORT/logixrest/vdpr0006/cancelaPedidoParcial
Parâmetros de entrada:
Parâmetro | Tipo | Definição | Observação |
empresa | PathParam | pedidos.cod_empresa | |
pedido | PathParam | pedidos.num_pedido | |
motivo | PathParam | mot_cancel.cod_motivo | Motivo cadastrado na tabela "mot_cancel" |
usuario | QueryString | usuario.nom_usuario | Caso não informado será considerado o usuário da requisição. |
la_itens | PayLoad | ||
ind_bonificacao | CHAR(01) | Indica se o item é de bonificação ("S"/"N") | |
sequencia_item | ped_itens.num_sequencia | ||
grade_1 | ped_itens_grade.cod_grade_1 | ||
grade_2 | ped_itens_grade.cod_grade_2 | ||
grade_3 | ped_itens_grade.cod_grade_3 | ||
grade_4 | ped_itens_grade.cod_grade_4 | ||
grade_5 | ped_itens_grade.cod_grade_5 | ||
qtd_pecas_cancel | ped_itens_grade.qtd_pecas_cancel |
Parâmetros de saída:
Parâmetro | Definição | Observação |
status | SMALLINT | TRUE (processou) / FALSE (não processou) |
msg | CHAR(2000) | Mensagem de erro ou informação. |
7 - Web Service Exclusão de Pedido em Análise
Objetivo: Realizar a exclusão do ERP de pedidos em análise.
Operação: POST
Exemplo URL: http://SERVER:PORT/logixrest/vdpr0006/excluiPedidoAnalise/
Parâmetros de entrada:
Parâmetro | Tipo | Definição | Observação |
empresa | PathParam | pedidos.cod_empresa | |
pedido | PathParam | pedidos.num_pedido | |
motivo | QueryString | CHAR(500) | Descrição do motivo de exclusão. |
usuario | QueryString | usuario.nom_usuario | Caso não informado será considerado o usuário da requisição. |
Parâmetros de saída:
Parâmetro | Definição | Observação |
status | SMALLINT | TRUE (processou) / FALSE (não processou) |
msg | CHAR(2000) | Mensagem de erro ou informação. |