Funcionalidades - Contratos

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

TagInsertDeletedescriçãoObservação
CONTRATOSN
Informar a operação – 'I' para Insert e 'D' para Delete
CON_IN_CODIGONSCódigo do ContratoCaso não seja informado será gerado um código sequêncial
CON_ST_IDENTIFICACAOSNIdentificação do Contrato
CON_ST_DESCRICAOSNDescrição do Contrato
TPC_IN_CODIGOSNCódigo do Tipo do Contrato
CTG_IN_CODIGOSNCódigo da Categoria
CON_ST_CODALTERNATIVONNCódigo alternativo do contrato
FIL_IN_CODIGOSSCódigo da Filial
CON_CH_TIPOINTEGRACAOSNTipo Integração


Contratante



Obrigatório

TagInsertDeletedescriçãoObservação
CONTRATANTESN
Informar a operação – 'I' para Insert e 'D' para Delete
AGN_IN_CODIGOSNCódigo do Agente
AGN_TAU_ST_CODIGOSNCódigo da tabela auxiliar


Contratado



Obrigatório

TagInsertDeletedescriçãoObservação
CONTRATADOSN
Informar a operação – 'I' para Insert e 'D' para Delete
AGN_IN_CODIGOSNCódigo do Agente
AGN_TAU_ST_CODIGOSNCódigo da tabela auxiliar


Parâmetro



Obrigatório

TagInsertDeletedescriçãoObservação
PARAMETROSNN
Informar a operação – 'I' para Insert e 'D' para Delete
PAR_CH_RELACITEMNNRelacionamento do Item
PAR_CH_ABERTOFECHADONNContrato Aberto ou Fechado
PAR_CH_GERARPARCELASNNGera Parcelas no Contas a Pagar ou no Contas a Receber
PAR_CH_RENOVAUTOMNNRenovação Automática do Contrato
PAR_CH_REPLICACONFITEMNNAssume as configurações dos parâmetros do Contrato para as configurações dos Itens do contrato
CLA_IN_REDUZIDONNCódigo reduzido da classe
CUS_IN_REDUZIDONNCódigo reduzido do centro de custo
PRO_IN_REDUZIDONNCódigo reduzido do Projeto
PAR_CH_VINCULOFINANCNNVínculo com Financeiro
PAR_CH_ENTRADAMEDICAONNEntrada da Medição
PAR_DT_DATABASEPARCELANNData Base para geração de parcelas
PFIN_IN_CODIGONNCódigo Parâmetro Financeiro
TPD_IN_CODIGONNTipo de Documento de Venda
COND_ST_CODIGOPDVNNCódigo da Condição de Pagamento de Pedido de Vendas
TRA_IN_CODIGONNCódigo da Transportadora
PAR_BO_OBRIGAPRAZONNObrigatório informar prazos
PAR_BO_OBRIGACLAUSULANNObrigatório informar cláusulas
PAR_BO_ADTAUTOMATICONNLançamento automático de quantidade de itens
PAR_BO_VALIDAREAJUSTENNValida prazos de reajustes ao gerar movimentações
PAR_BO_ITEMCOMPOSTONNUtiliza itens compostos
ACAO_IN_CODIGONNCódigo de Ação
COND_ST_CODIGONNCódigo da Condição de Pagamento
TPR_ST_TIPOPRECONNCódigo do Tipo Preço
SER_ST_CODIGONNSérie do Pedido
PAR_RE_VLMINFATURANNValor Mínimo de Faturamento
PAR_IN_DIASENTREGANNDias para Entrega
PAR_CH_BUSCAICCPROJNNBusca por contratos potenciais considera apenas o Item ou Item, Centro de Custo e Projeto
PAR_BO_USAREGRADISTRINNUtiliza regra do Módulo de Distribuição para gerar a numeração do Pedido de Venda


Endereço



Obrigatório

TagInsertDeletedescriçãoObservação
ENDERECOSNN
Informar a operação – 'I' para Insert e 'D' para Delete
AGN_IN_CODIGONNCódigo do Agente
ENA_IN_CODIGOENTNNEndereço de Entrega
ENA_IN_CODIGOCOBNNEndereço de Cobrança
ENA_IN_CODIGOFATNNEndereço de Faturamento


ParFrete



Obrigatório

TagInsertDeletedescriçãoObservação
PARFRETENN
Informar a operação – 'I' para Insert e 'D' para Delete
AGN_IN_CODIGODONNNCódigo Agentes Pagador
AGN_TAU_ST_CODIGODONNNCód. Auxiliar Agentes Pagador
AGN_IN_CODIGOREMNNCódigo Agentes Remetente
AGN_TAU_ST_CODIGOREMNNCód. Auxiliar Agentes Remetente
AGN_IN_CODIGOCOLENANNCódigo Agentes Endereço de Coleta
AGN_IN_CODIGODESNNCódigo Agentes Destinatário
AGN_TAU_ST_CODIGODESNNCód. Auxiliar Agentes Destinatário
AGN_IN_CODIGOENTENANNCódigo Agentes Endereço de Entrega
ENA_IN_CODIGOENTNNCódigo do Endereço Agente Entrega
AGN_IN_CODIGOREDNNCódigo Agentes Redespacho
AGN_TAU_ST_CODIGOREDNNCód. Auxiliar Agentes Redespacho
AGN_IN_CODIGOCONNNCódigo Agentes Consignatário
AGN_TAU_ST_CODIGOCONNNCód. Auxiliar Agentes Consignatário
CLP_ST_CODIGONNCódigo da Classe do Produto
PTC_ST_PEDIDOCLIENTENNCódigo do Pedido do Cliente
TPC_ST_CODIGONNCódigo do Tipo de Carga
PTC_ST_TIPOFRETENNTipo Frete
PTC_ST_TIPOCONSIGNNTipo de Consignatário
UNM_IN_CODIGONNCódigo da Unidade de Medida
AGN_TAU_ST_CODIGOCOLENANNCód. Auxiliar Agentes Endereço de Coleta
AGN_TAU_ST_CODIGOENTENANNCód. Auxiliar Agentes Local de Entrega


Vigência



Obrigatório

TagInsertDeletedescriçãoObservação
VIGENCIANN
Informar a operação – 'I' para Insert e 'D' para Delete
VGC_DT_DATAINICIALNNData Inicial da Vigência
VGC_DT_DATAFINALNNData Final da Vigência
VGC_ST_DESCRICAONNDescrição da Vigência
VGC_ST_COMPLEMENTONNComplemento
VGC_CH_RENOVACAOAUTOMNNRenovação Automática


Itens



Obrigatório

TagInsertDeletedescriçãoObservação
ITENSSN
Informar a operação – 'I' para Insert e 'D' para Delete
ITE_IN_CODIGOSNCódigo do Item
ITC_RE_QTDEATUALSNQuantidade Atual do Item
ITC_RE_VALORUNITATUALSNValor Unitário Atual do Item
CLA_IN_REDUZIDONNCódigo reduzido da classe
PFIN_IN_CODIGONNCódigo Parâmetro Financeiro
ITC_ST_COMPLEMENTONNComplemento
UNI_ST_UNIDADENNUnidade do Item
FMT_ST_CODIGONNFormato de conversão de unidade
ITC_RE_QTDEMINIMANNQuantidade Mínima de Compra
ITC_RE_QTDEMULTIPLANNQuantidade Múltipla de Compra
ITC_RE_PERCIPINNValor Percentual do IPI
ITC_IN_SEQUENCIASNSequência do Item


Centro de Custo



Obrigatório

TagInsertDeletedescriçãoObservação
CENTROCUSTONN
Informar a operação – 'I' para Insert e 'D' para Delete
CCF_IN_REDUZIDONNCódigo reduzido do centro de custo
ICC_RE_PERCNNPercentual por Centro de Custo
ICC_RE_VLPROPNNValor proporcional por Centro de Custo
ICC_IN_SEQUENCIANN


Projeto



Obrigatório

TagInsertDeletedescriçãoObservação
PROJETONN
Informar a operação – 'I' para Insert e 'D' para Delete
PROJ_IN_REDUZIDONNCódigo reduzido do Projeto
ICP_RE_PERCNNPercentual por Projeto
ICP_RE_VLPROPNNValor proporcional por Projeto


Frete



Obrigatório

TagInsertDeletedescriçãoObservação
FRETENN
Informar a operação – 'I' para Insert e 'D' para Delete
ITR_RE_VLRFREPESOATUALNNValor Atual de Frete Peso
ITR_ST_CLASSIFICFRETENNClassificação de Frete
ITR_ST_TPQUEBRAPESODESCNNTipo de Desconto da Quebra de Peso
ITR_ST_TPQUEBRAPESOTOLNNTipo de Tolerância da Quebra de Peso
ITR_ST_TPQUEBRAPESOBASENNBase de Desconto de Quebra de Peso
ITR_ST_TPQUEBRAPESOQTDENNQuantidade de Quebra para Desconto de Mercadoria
ITR_RE_VLRTOLERANCIANNValor da Tolerância em Quantidade ou Percentual
ITR_RE_VLRPEDATUALNNValor Atual de Frete Pedágio
ITR_IN_PERCMAXADTOATUALNNPercentual Máximo de Adiantamento Atual


Categoria



Obrigatório

TagInsertDeletedescriçãoObservação
CATEGORIASN

Informar a operação – 'I' para Insert e 'D' para Delete
CAT_IN_REDUZIDON
Código Reduzido da Categoria
ITG_RE_VLRFREDESPATUALN
Valor Atual de Frete Despesa