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

Contratante

Contratado

Parâmetro

Endereço

ParFrete

Vigência

Itens

Centro de Custo

Projeto

Frete

Categoria