Medições

A medição trata do processo de verificação e gerenciamento do andamento de um contrato, ou seja, neste momento são medidas as quantidades e valores dos produtos movimentados.

Vínculo Financeiro

Se o contrato possuir parametrização para vínculo com o módulo Financeiro, e os parâmetros financeiros dos itens estiverem devidamente configurados, ao confirmar uma Medição, serão geradas faturas e parcelas do mesmo. A quantidade de faturas geradas será de acordo com a igualdade de parametrização financeira dos itens.

Vínculo Pedido de Venda

Se o contrato possuir parametrização para vínculo com o módulo Distribuição e for de escopo Aberto, através do botão “Gerar Pedido de Venda” será possível gerar Pedidos de Venda a partir da Medição.

Cadastro de Medições do Contrato

Apenas contratos que integram com o módulo Distribuição podem gerar Pedidos de Venda;
É possível realizar o lançamento de medição para contratos com tipo de escopo Aberto e Fechado, sendo que quando lançado medição para tipo de escopo Aberto, o botão "Gerar Pedido de Venda" será habilitado e quando lançado medição para contrato do tipo de escopo Fechado, o Pedido de Venda será gerado automaticamente ao ativar o contrato.
Para contratos que utilizam item composto, não é permitido lançar uma Medição manual.

Serviço 1001 - Integração de Contrato

Sistema: Contratos
Código do serviço: 1001
Descrição: Integração de Contrato

Exemplo de XML

Inclusão

<Contrato OPERACAO="I">
    <CON_IN_CODIGO>1</CON_IN_CODIGO>
    <CON_ST_IDENTIFICACAO>Contrato de Integração</CON_ST_IDENTIFICACAO>
    <CON_ST_DESCRICAO>Integração pelo serviço 1001</CON_ST_DESCRICAO>
    <TPC_IN_CODIGO>999</TPC_IN_CODIGO>
    <CTG_IN_CODIGO>2</CTG_IN_CODIGO>
    <CON_ST_CODALTERNATIVO>0101</CON_ST_CODALTERNATIVO>
    <FIL_IN_CODIGO>5</FIL_IN_CODIGO>
    <CON_CH_TIPOINTEGRACAO>P</CON_CH_TIPOINTEGRACAO>

    <Contratante OPERACAO="I">
        <AGN_IN_CODIGO>5</AGN_IN_CODIGO>
        <AGN_TAU_ST_CODIGO>C</AGN_TAU_ST_CODIGO>
    </Contratante>

    <Contratado OPERACAO="I">
        <AGN_IN_CODIGO>519</AGN_IN_CODIGO>
        <AGN_TAU_ST_CODIGO>F</AGN_TAU_ST_CODIGO>
    </Contratado>

    <Parametros OPERACAO="I">
        <PAR_CH_RELACITEM>S</PAR_CH_RELACITEM>
        <PAR_CH_ABERTOFECHADO>A</PAR_CH_ABERTOFECHADO>
        <PAR_CH_GERARPARCELAS>P</PAR_CH_GERARPARCELAS>
        <PAR_CH_RENOVAUTOM>N</PAR_CH_RENOVAUTOM>
        <PAR_CH_REPLICACONFITEM>S</PAR_CH_REPLICACONFITEM>
        <CLA_IN_REDUZIDO>1</CLA_IN_REDUZIDO>
        <CUS_IN_REDUZIDO>9</CUS_IN_REDUZIDO>
        <PRO_IN_REDUZIDO>5</PRO_IN_REDUZIDO>
        <PAR_CH_VINCULOFINANC>S</PAR_CH_VINCULOFINANC>
        <PAR_CH_ENTRADAMEDICAO>M</PAR_CH_ENTRADAMEDICAO>
        <PAR_DT_DATABASEPARCELA>01/01/2016</PAR_DT_DATABASEPARCELA>
        <PFIN_IN_CODIGO>1</PFIN_IN_CODIGO>
        <TPD_IN_CODIGO>104</TPD_IN_CODIGO>
        <COND_ST_CODIGOPDV>02</COND_ST_CODIGOPDV>
        <TRA_IN_CODIGO>500</TRA_IN_CODIGO>
        <PAR_BO_OBRIGAPRAZO>N</PAR_BO_OBRIGAPRAZO>
        <PAR_BO_OBRIGACLAUSULA>N</PAR_BO_OBRIGACLAUSULA>
        <PAR_BO_ADTAUTOMATICO>N</PAR_BO_ADTAUTOMATICO>
        <PAR_BO_VALIDAREAJUSTE>N</PAR_BO_VALIDAREAJUSTE>
        <PAR_BO_ITEMCOMPOSTO>N</PAR_BO_ITEMCOMPOSTO>
        <ACAO_IN_CODIGO>108</ACAO_IN_CODIGO>
        <COND_ST_CODIGO>04 PARC</COND_ST_CODIGO>
        <TPR_ST_TIPOPRECO>CIF</TPR_ST_TIPOPRECO>
        <SER_ST_CODIGO>1</SER_ST_CODIGO>
        <PAR_RE_VLMINFATURA>0</PAR_RE_VLMINFATURA>
        <PAR_IN_DIASENTREGA>15</PAR_IN_DIASENTREGA>
        <PAR_CH_BUSCAICCPROJ>I</PAR_CH_BUSCAICCPROJ>
        <PAR_BO_USAREGRADISTRI>N</PAR_BO_USAREGRADISTRI>
    </Parametros>

    <Enderecos OPERACAO="I">
        <AGN_IN_CODIGO>5</AGN_IN_CODIGO>
        <ENA_IN_CODIGOENT>1</ENA_IN_CODIGOENT>
        <ENA_IN_CODIGOCOB>2</ENA_IN_CODIGOCOB>
        <ENA_IN_CODIGOFAT>3</ENA_IN_CODIGOFAT>
    </Enderecos>

    <ParFrete OPERACAO="I">
        <AGN_IN_CODIGODON>5</AGN_IN_CODIGODON>
        <AGN_TAU_ST_CODIGODON>C</AGN_TAU_ST_CODIGODON>
        <AGN_IN_CODIGOREM>519</AGN_IN_CODIGOREM>
        <AGN_TAU_ST_CODIGOREM>F</AGN_TAU_ST_CODIGOREM>
        <AGN_IN_CODIGOCOLENA>7</AGN_IN_CODIGOCOLENA>
        <AGN_IN_CODIGODES>5</AGN_IN_CODIGODES>
        <AGN_TAU_ST_CODIGODES>C</AGN_TAU_ST_CODIGODES>
        <AGN_IN_CODIGOENTENA>20</AGN_IN_CODIGOENTENA>
        <ENA_IN_CODIGOENT>1</ENA_IN_CODIGOENT>
        <AGN_IN_CODIGORED>3</AGN_IN_CODIGORED>
        <AGN_TAU_ST_CODIGORED>T</AGN_TAU_ST_CODIGORED>
        <AGN_IN_CODIGOCON>20</AGN_IN_CODIGOCON>
        <AGN_TAU_ST_CODIGOCON>F</AGN_TAU_ST_CODIGOCON>
        <CLP_ST_CODIGO>1</CLP_ST_CODIGO>
        <PTC_ST_PEDIDOCLIENTE>1235</PTC_ST_PEDIDOCLIENTE>
        <TPC_ST_CODIGO>A</TPC_ST_CODIGO>
        <PTC_ST_TIPOFRETE>CIF</PTC_ST_TIPOFRETE>
        <PTC_ST_TIPOCONSIG>INI</PTC_ST_TIPOCONSIG>
        <UNM_IN_CODIGO>10</UNM_IN_CODIGO>
        <AGN_TAU_ST_CODIGOCOLENA>7</AGN_TAU_ST_CODIGOCOLENA>
        <AGN_TAU_ST_CODIGOENTENA>T</AGN_TAU_ST_CODIGOENTENA>
    </ParFrete>

    <Vigencia OPERACAO="I">
        <VGC_DT_DATAINICIAL>01/01/2016</VGC_DT_DATAINICIAL>
        <VGC_DT_DATAFINAL>31/12/2016</VGC_DT_DATAFINAL>
        <VGC_ST_DESCRICAO>Vigencia</VGC_ST_DESCRICAO>
        <VGC_ST_COMPLEMENTO>Complemento</VGC_ST_COMPLEMENTO>
        <VGC_CH_RENOVACAOAUTOM>N</VGC_CH_RENOVACAOAUTOM>
    </Vigencia>

    <Itens OPERACAO="I">
        <ITE_IN_CODIGO>3</ITE_IN_CODIGO>
        <ITC_RE_QTDEATUAL>1000</ITC_RE_QTDEATUAL>
        <ITC_RE_VALORUNITATUAL>35</ITC_RE_VALORUNITATUAL>
        <CLA_IN_REDUZIDO>1</CLA_IN_REDUZIDO>
        <PFIN_IN_CODIGO>1</PFIN_IN_CODIGO>
        <ITC_ST_COMPLEMENTO>Complemento</ITC_ST_COMPLEMENTO>
        <UNI_ST_UNIDADE>CX</UNI_ST_UNIDADE>
        <FMT_ST_CODIGO>1</FMT_ST_CODIGO>
        <ITC_RE_QTDEMINIMA>10</ITC_RE_QTDEMINIMA>
        <ITC_RE_QTDEMULTIPLA>20</ITC_RE_QTDEMULTIPLA>
        <ITC_RE_PERCIPI>2,6</ITC_RE_PERCIPI>
        <ITC_IN_SEQUENCIA>1</ITC_IN_SEQUENCIA>

        <CentroCusto OPERACAO="I">
            <CCF_IN_REDUZIDO>9</CCF_IN_REDUZIDO>
            <ICC_RE_PERC>100</ICC_RE_PERC>
            <ICC_RE_VLPROP>35000</ICC_RE_VLPROP>
            <ICC_IN_SEQUENCIA>1</ICC_IN_SEQUENCIA>

            <Projeto OPERACAO="I">
                <PROJ_IN_REDUZIDO>5</PROJ_IN_REDUZIDO>
                <ICP_RE_PERC>100</ICP_RE_PERC>
                <ICP_RE_VLPROP>35000</ICP_RE_VLPROP>
            </Projeto>
        </CentroCusto>

        <Frete OPERACAO="I">
            <ITR_RE_VLRFREPESOATUAL>2000</ITR_RE_VLRFREPESOATUAL>
            <ITR_ST_CLASSIFICFRETE>FTE</ITR_ST_CLASSIFICFRETE>
            <ITR_ST_TPQUEBRAPESODESC>MN</ITR_ST_TPQUEBRAPESODESC>
            <ITR_ST_TPQUEBRAPESOTOL>PC</ITR_ST_TPQUEBRAPESOTOL>
            <ITR_ST_TPQUEBRAPESOBASE>IN</ITR_ST_TPQUEBRAPESOBASE>
            <ITR_ST_TPQUEBRAPESOQTDE>EX</ITR_ST_TPQUEBRAPESOQTDE>
            <ITR_RE_VLRTOLERANCIA>2</ITR_RE_VLRTOLERANCIA>
            <ITR_RE_VLRPEDATUAL>150</ITR_RE_VLRPEDATUAL>
            <ITR_IN_PERCMAXADTOATUAL>10</ITR_IN_PERCMAXADTOATUAL>
        </Frete>

        <Categorias OPERACAO="I">
            <CAT_IN_REDUZIDO>1</CAT_IN_REDUZIDO>
            <ITG_RE_VLRFREDESPATUAL>300</ITG_RE_VLRFREDESPATUAL>
        </Categorias>
    </Itens>
</Contrato>

Exclusão

<Contrato OPERACAO="D">
<CON_IN_CODIGO>98</CON_IN_CODIGO>
<FIL_IN_CODIGO>5</FIL_IN_CODIGO>
</Contrato>

Obs: Não é possível realizar alteração em um contrato (OPERACAO = 'U').

Exemplo de chamada no delphi

var
vDM: TDM_CtoIntContrato_Server;
vData : OleVariant;
begin
try
    vDM := TDM_CtoIntContrato_Server.Create(Self);
    vDM.CL_ContratoImp_.Close;
    vDM.CL_ContratanteImp_.Close;
    vDM.CL_ContratadoImp_.Close;
    vDM.CL_ParametroContrImp_.Close;
    vDM.CL_EndFilialImp_.Close;
    vDM.CL_ParTraContrImp_.Close;
    vDM.CL_VigenciaImp_.Close;
    vDM.CL_ItemContrImp_.Close;
    vDM.CL_ItemContrCCFImp_.Close;
    vDM.CL_ItemContrProjImp_.Close;
    vDM.Cl_ItemContrTraImp_.Close;
    vDM.Cl_ItemContrTraCategImp_.Close;

    vDM.CL_ContratoImp_.Create;
    vDM.CL_ContratanteImp_.Create;
    vDM.CL_ContratadoImp_.Create;
    vDM.CL_ParametroContrImp_.Create;
    vDM.CL_EndFilialImp_.Create;
    vDM.CL_ParTraContrImp_.Create;
    vDM.CL_VigenciaImp_.Create;
    vDM.CL_ItemContrImp_.Create;
    vDM.CL_ItemContrCCFImp_.Create;
    vDM.CL_ItemContrProjImp_.Create;
    vDM.Cl_ItemContrTraImp_.Create;
    vDM.Cl_ItemContrTraCategImp_.Create;

    vData := VarArrayCreate([0, 11, 0, 0], varVariant);
    vData[0,0] := vDM.CL_ContratoImp_.Data;
    vData[1,0] := vDM.CL_ContratanteImp_.Data;
    vData[2,0] := vDM.CL_ContratadoImp_.Data;
    vData[3,0] := vDM.CL_ParametroContrImp_.Data;
    vData[4,0] := vDM.CL_EndFilialImp_.Data;
    vData[5,0] := vDM.CL_ParTraContrImp_.Data;
    vData[6,0] := vDM.CL_VigenciaImp_.Data;
    vData[7,0] := vDM.CL_ItemContrImp_.Data;
    vData[8,0] := vDM.CL_ItemContrCCFImp_.Data;
    vData[9,0] := vDM.CL_ItemContrProjImp_.Data;
    vData[10,0] := vDM.Cl_ItemContrTraImp_.Data;
    vData[11,0] := vDM.Cl_ItemContrTraCategImp_.Data;

    vDM.IntegraContrato('P', vData, RDMUsuario, 'A', 0);

finally
    FreeAndNil(vDM);
end;
end;

Estrutura analítica dos campos

Contrato

	Obrigatório
Tag	Insert	Delete	descrição	Observação
CONTRATO	S	N		Informar a operação – 'I' para Insert e 'D' para Delete
CON_IN_CODIGO	N	S	Código do Contrato	Caso não seja informado será gerado um código sequêncial
CON_ST_IDENTIFICACAO	S	N	Identificação do Contrato
CON_ST_DESCRICAO	S	N	Descrição do Contrato
TPC_IN_CODIGO	S	N	Código do Tipo do Contrato
CTG_IN_CODIGO	S	N	Código da Categoria
CON_ST_CODALTERNATIVO	N	N	Código alternativo do contrato
FIL_IN_CODIGO	S	S	Código da Filial
CON_CH_TIPOINTEGRACAO	S	N	Tipo Integração

Contratante

	Obrigatório
Tag	Insert	Delete	descrição	Observação
CONTRATANTE	S	N		Informar a operação – 'I' para Insert e 'D' para Delete
AGN_IN_CODIGO	S	N	Código do Agente
AGN_TAU_ST_CODIGO	S	N	Código da tabela auxiliar

Contratado

	Obrigatório
Tag	Insert	Delete	descrição	Observação
CONTRATADO	S	N		Informar a operação – 'I' para Insert e 'D' para Delete
AGN_IN_CODIGO	S	N	Código do Agente
AGN_TAU_ST_CODIGO	S	N	Código da tabela auxiliar

Parâmetro

	Obrigatório
Tag	Insert	Delete	descrição	Observação
PARAMETROS	N	N		Informar a operação – 'I' para Insert e 'D' para Delete
PAR_CH_RELACITEM	N	N	Relacionamento do Item
PAR_CH_ABERTOFECHADO	N	N	Contrato Aberto ou Fechado
PAR_CH_GERARPARCELAS	N	N	Gera Parcelas no Contas a Pagar ou no Contas a Receber
PAR_CH_RENOVAUTOM	N	N	Renovação Automática do Contrato
PAR_CH_REPLICACONFITEM	N	N	Assume as configurações dos parâmetros do Contrato para as configurações dos Itens do contrato
CLA_IN_REDUZIDO	N	N	Código reduzido da classe
CUS_IN_REDUZIDO	N	N	Código reduzido do centro de custo
PRO_IN_REDUZIDO	N	N	Código reduzido do Projeto
PAR_CH_VINCULOFINANC	N	N	Vínculo com Financeiro
PAR_CH_ENTRADAMEDICAO	N	N	Entrada da Medição
PAR_DT_DATABASEPARCELA	N	N	Data Base para geração de parcelas
PFIN_IN_CODIGO	N	N	Código Parâmetro Financeiro
TPD_IN_CODIGO	N	N	Tipo de Documento de Venda
COND_ST_CODIGOPDV	N	N	Código da Condição de Pagamento de Pedido de Vendas
TRA_IN_CODIGO	N	N	Código da Transportadora
PAR_BO_OBRIGAPRAZO	N	N	Obrigatório informar prazos
PAR_BO_OBRIGACLAUSULA	N	N	Obrigatório informar cláusulas
PAR_BO_ADTAUTOMATICO	N	N	Lançamento automático de quantidade de itens
PAR_BO_VALIDAREAJUSTE	N	N	Valida prazos de reajustes ao gerar movimentações
PAR_BO_ITEMCOMPOSTO	N	N	Utiliza itens compostos
ACAO_IN_CODIGO	N	N	Código de Ação
COND_ST_CODIGO	N	N	Código da Condição de Pagamento
TPR_ST_TIPOPRECO	N	N	Código do Tipo Preço
SER_ST_CODIGO	N	N	Série do Pedido
PAR_RE_VLMINFATURA	N	N	Valor Mínimo de Faturamento
PAR_IN_DIASENTREGA	N	N	Dias para Entrega
PAR_CH_BUSCAICCPROJ	N	N	Busca por contratos potenciais considera apenas o Item ou Item, Centro de Custo e Projeto
PAR_BO_USAREGRADISTRI	N	N	Utiliza regra do Módulo de Distribuição para gerar a numeração do Pedido de Venda

Endereço

	Obrigatório
Tag	Insert	Delete	descrição	Observação
ENDERECOS	N	N		Informar a operação – 'I' para Insert e 'D' para Delete
AGN_IN_CODIGO	N	N	Código do Agente
ENA_IN_CODIGOENT	N	N	Endereço de Entrega
ENA_IN_CODIGOCOB	N	N	Endereço de Cobrança
ENA_IN_CODIGOFAT	N	N	Endereço de Faturamento

ParFrete

	Obrigatório
Tag	Insert	Delete	descrição	Observação
PARFRETE	N	N		Informar a operação – 'I' para Insert e 'D' para Delete
AGN_IN_CODIGODON	N	N	Código Agentes Pagador
AGN_TAU_ST_CODIGODON	N	N	Cód. Auxiliar Agentes Pagador
AGN_IN_CODIGOREM	N	N	Código Agentes Remetente
AGN_TAU_ST_CODIGOREM	N	N	Cód. Auxiliar Agentes Remetente
AGN_IN_CODIGOCOLENA	N	N	Código Agentes Endereço de Coleta
AGN_IN_CODIGODES	N	N	Código Agentes Destinatário
AGN_TAU_ST_CODIGODES	N	N	Cód. Auxiliar Agentes Destinatário
AGN_IN_CODIGOENTENA	N	N	Código Agentes Endereço de Entrega
ENA_IN_CODIGOENT	N	N	Código do Endereço Agente Entrega
AGN_IN_CODIGORED	N	N	Código Agentes Redespacho
AGN_TAU_ST_CODIGORED	N	N	Cód. Auxiliar Agentes Redespacho
AGN_IN_CODIGOCON	N	N	Código Agentes Consignatário
AGN_TAU_ST_CODIGOCON	N	N	Cód. Auxiliar Agentes Consignatário
CLP_ST_CODIGO	N	N	Código da Classe do Produto
PTC_ST_PEDIDOCLIENTE	N	N	Código do Pedido do Cliente
TPC_ST_CODIGO	N	N	Código do Tipo de Carga
PTC_ST_TIPOFRETE	N	N	Tipo Frete
PTC_ST_TIPOCONSIG	N	N	Tipo de Consignatário
UNM_IN_CODIGO	N	N	Código da Unidade de Medida
AGN_TAU_ST_CODIGOCOLENA	N	N	Cód. Auxiliar Agentes Endereço de Coleta
AGN_TAU_ST_CODIGOENTENA	N	N	Cód. Auxiliar Agentes Local de Entrega

Vigência

	Obrigatório
Tag	Insert	Delete	descrição	Observação
VIGENCIA	N	N		Informar a operação – 'I' para Insert e 'D' para Delete
VGC_DT_DATAINICIAL	N	N	Data Inicial da Vigência
VGC_DT_DATAFINAL	N	N	Data Final da Vigência
VGC_ST_DESCRICAO	N	N	Descrição da Vigência
VGC_ST_COMPLEMENTO	N	N	Complemento
VGC_CH_RENOVACAOAUTOM	N	N	Renovação Automática

Itens

	Obrigatório
Tag	Insert	Delete	descrição	Observação
ITENS	S	N		Informar a operação – 'I' para Insert e 'D' para Delete
ITE_IN_CODIGO	S	N	Código do Item
ITC_RE_QTDEATUAL	S	N	Quantidade Atual do Item
ITC_RE_VALORUNITATUAL	S	N	Valor Unitário Atual do Item
CLA_IN_REDUZIDO	N	N	Código reduzido da classe
PFIN_IN_CODIGO	N	N	Código Parâmetro Financeiro
ITC_ST_COMPLEMENTO	N	N	Complemento
UNI_ST_UNIDADE	N	N	Unidade do Item
FMT_ST_CODIGO	N	N	Formato de conversão de unidade
ITC_RE_QTDEMINIMA	N	N	Quantidade Mínima de Compra
ITC_RE_QTDEMULTIPLA	N	N	Quantidade Múltipla de Compra
ITC_RE_PERCIPI	N	N	Valor Percentual do IPI
ITC_IN_SEQUENCIA	S	N	Sequência do Item

Centro de Custo

	Obrigatório
Tag	Insert	Delete	descrição	Observação
CENTROCUSTO	N	N		Informar a operação – 'I' para Insert e 'D' para Delete
CCF_IN_REDUZIDO	N	N	Código reduzido do centro de custo
ICC_RE_PERC	N	N	Percentual por Centro de Custo
ICC_RE_VLPROP	N	N	Valor proporcional por Centro de Custo
ICC_IN_SEQUENCIA	N	N

Projeto

	Obrigatório
Tag	Insert	Delete	descrição	Observação
PROJETO	N	N		Informar a operação – 'I' para Insert e 'D' para Delete
PROJ_IN_REDUZIDO	N	N	Código reduzido do Projeto
ICP_RE_PERC	N	N	Percentual por Projeto
ICP_RE_VLPROP	N	N	Valor proporcional por Projeto

Frete

	Obrigatório
Tag	Insert	Delete	descrição	Observação
FRETE	N	N		Informar a operação – 'I' para Insert e 'D' para Delete
ITR_RE_VLRFREPESOATUAL	N	N	Valor Atual de Frete Peso
ITR_ST_CLASSIFICFRETE	N	N	Classificação de Frete
ITR_ST_TPQUEBRAPESODESC	N	N	Tipo de Desconto da Quebra de Peso
ITR_ST_TPQUEBRAPESOTOL	N	N	Tipo de Tolerância da Quebra de Peso
ITR_ST_TPQUEBRAPESOBASE	N	N	Base de Desconto de Quebra de Peso
ITR_ST_TPQUEBRAPESOQTDE	N	N	Quantidade de Quebra para Desconto de Mercadoria
ITR_RE_VLRTOLERANCIA	N	N	Valor da Tolerância em Quantidade ou Percentual
ITR_RE_VLRPEDATUAL	N	N	Valor Atual de Frete Pedágio
ITR_IN_PERCMAXADTOATUAL	N	N	Percentual Máximo de Adiantamento Atual

Categoria

	Obrigatório
Tag	Insert	Delete	descrição	Observação
CATEGORIAS	N			Informar a operação – 'I' para Insert e 'D' para Delete
CAT_IN_REDUZIDO	N		Código Reduzido da Categoria
ITG_RE_VLRFREDESPATUAL	N		Valor Atual de Frete Despesa

Browser not supported