Linha Microsiga Protheus

Árvore de páginas


CONTEÚDO

01. VISÃO GERAL

Apresentar a utilização dos models do GFEX010 - Simulação de Frete.

02. PRÉ-REQUISITO

É pré-requisito o entendimento de utilização de MVC.

O link da documentação de utilização do MVC está no tópico 11. Assuntos Relacionados, no final deste documento.

Este método de simulação aplica-se somente para uso em fonte ADVPL. Para o uso em sistemas externos ao Protheus recomenda-se a API REST de Simulação de Frete, mais detalhes estão no tópico 11. Assuntos Relacionados, no final deste documento.

*Para validar os resultados obtidos pode-se utilizar o programa GFEX010 - Simulação de Frete Completa diretamente no GFE cuja documentação encontra-se abaixo.

03. OUTRAS AÇÕES / AÇÕES RELACIONADAS

AçãoDescrição
Simular

O GFEX010 utiliza 6 models diferentes para informar os dados para simulação:

  • 1 Model para definir o uso de tabelas em negociação - oModelSim:GetModel("GFEX010_01")
  • 1 Model para Agrupador de Carga - oModelSim:GetModel("DETAIL_01")
  • 1 Model para Documentos de Carga - oModelSim:GetModel("DETAIL_02")
  • 1 Model para Itens dos Documentos de Carga - oModelSim:GetModel("DETAIL_03")
  • 1 Model para Trechos dos Documentos de Carga - oModelSim:GetModel("DETAIL_04")
  • 1 Model para disparar a simulação - oModelSim:GetModel("SIMULA")

Utilizada também 2 models para busca do resultado da simulação:

  • 1 Model para indicar o resultado do cálculo - oModelSim:GetModel("DETAIL_05")
  • 1 Model para informações complementares ao cálculo - oModelSim:GetModel("DETAIL_06")

04. PRINCIPAIS CAMPOS E PARÂMETROS - USO DE TABELAS EM NEGOCIAÇÃO

CampoDescriçãoTamanhoTipo

CONSNEG

Considera em Negociação

1C


05. PRINCIPAIS CAMPOS E PARÂMETROS - AGRUPADOR DE CARGA

CampoDescriçãoTamanhoTipo

GWN_NRROM

Número do Agrupador8C
GWN_CDCLFRCódigo da Classificação de Frete4C

GWN_CDTPOP

Código do Tipo de Operação10C

GWN_DOC

Tipo do Documento Agrupador15C

GWN_DISTAN

Distância Total do Agrupador8N

IMPORTANTE!

A informação preenchida para o número do Agrupador não tem relação direta com nenhum registro do banco de Dados. Este número indica o agrupador somente para esta operação de simulação. Esta informação será utilizada para relacionar as demais informações da simulação de frete. O campo GWN_DOC é apenas informativo.

06. PRINCIPAIS CAMPOS E PARÂMETROS - DOCUMENTOS DE CARGA

CampoDescriçãoTamanhoTipo
GW1_NRROMNúmero do Agrupador8C

GW1_EMISDC

Emissor do Documento de Carga14C

GW1_NRDC

Número do Documento de Carga16C

GW1_CDTPDC

Código do Tipo de Documento de Carga5C

GW1_CDREM

Código do Remetente do Documento de Carga14C

GW1_CDDEST

Código do Destinatário do Documento de Carga14C

GW1_TPFRET

Tipo de Frete1C

IMPORTANTE!

A informação de número de agrupador deve utilizar um número indicado no model de Agrupador de Carga. As informações de Emissor, Número e Tipo de Documento de Carga serão utilizadas para relacionar os models abaixo.

07. PRINCIPAIS CAMPOS E PARÂMETROS - ITENS DOCUMENTOS DE CARGA

CampoDescriçãoTamanhoTipo
GW8_EMISDCEmissor do Documento de Carga14C
GW8_NRDCNúmero do Documento de Carga16C
GW8_CDTPDCCódigo do Tipo de Documento de Carga5C
GW8_ITEMCódigo do Item do Documento de Carga16C
GW8_DSITEMDescrição do Item do Documento de Carga50C
GW8_CDCLFRCódigo da Classificação de Frete do Item4C
GW8_TPITEMCódigo do Tipo de Item4C
GW8_QTDEQuantidade do Item13,5N
GW8_PESOR

Peso Real do Item

Importante

Este campo deve conter o valor para o peso total considerando todos os itens. Por exemplo: caso o peso unitário seja de 1 kg e a quantidade seja de 100, deve-se informar neste campo o peso total de 100 kg.

15,5N
GW8_VALORValor do Item11,2N
GW8_VOLUMEVolume do Item11,5N

Importante

As informações de Emissor, Número e Tipo de Documento de Carga deve constar em um registro do model de documentos de carga.

08. PRINCIPAIS CAMPOS E PARÂMETROS - TRECHOS DOCUMENTOS DE CARGA

CampoDescriçãoTamanhoTipo
GWU_EMISDCEmissor do Documento de Carga14C
GWU_NRDCNúmero do Documento de Carga16C
GWU_CDTPDCCódigo do Tipo de Documento de Carga5C
GWU_SEQSequência do Trecho do Documento de Carga2C
GWU_NRCIDOCódigo da Cidade de Origem do Trecho7C
GWU_CEPOCEP da Origem do Trecho8C
GWU_NRCIDDCódigo da Cidade de Destino do Trecho7C
GWU_CEPDCEP de Destino do Trecho8C
GWU_CDTRPCódigo do Transportador do Trecho14C
GWU_CDTPVCCódigo do Tipo de Veículo do Trecho10C

Importante

As informações de Emissor, Número e Tipo de Documento de Carga deve constar em um registro do model de documentos de carga.

9. PRINCIPAIS CAMPOS E PARÂMETROS - SIMULA

CampoDescriçãoTamanhoTipo
INTEGRADispara a Integração1C

Importante

Ao informar o valor "A" para o campo INTEGRA do model SIMULA, a simulação é disparada, por este motivo este deve ser o último campo informado.

10. PRINCIPAIS CAMPOS E PARÂMETROS - CÁLCULO

CampoDescriçãoTamanhoTipo
C1_NRCALCNúmero do Cálculo6C
C1_TPCALCTipo do Cálculo10C
C1_TPFRTTipo de Frete1C
C1_NRAGRNúmero do Agrupador8C
C1_VALFRTValor de Frete15,5N
C1_DTPRENData de Previsão de Entrega8D

11. PRINCIPAIS CAMPOS E PARÂMETROS - INFORMAÇÕES COMPLEMENTARES DO CÁLCULO

CampoDescriçãoTamanhoTipo
C2_NRCALCNúmero do Cálculo6C
C2_CDCLFRCódigo da Classificação de Frete4C
C2_CDTPOPCódigo do Tipo de Operação10C
C2_CDEMITCódigo do Transportador14C

12. TABELAS UTILIZADAS

  • GWN - Romaneios de Carga
  • GW1 - Documentos de Carga
  • GW8 - Itens dos Documentos de Carga
  • GWU - Trechos dos Documentos de Carga

13. ASSUNTOS RELACIONADOS