PRIMAVERA | Developers

    Show / Hide Table of Contents

    Interface IBasBSArtigos

    Classe utilizada para obter serviços e regras de negócio sobre Artigos.

    Namespace: IBasBS100
    Assembly: IBasBS100.dll
    Syntax
    [ComVisible(true)]
    [Guid("49260762-39AC-4422-B1D7-527BF353B49A")]
    public interface IBasBSArtigos

    Methods

    Actualiza(BasBEArtigo)

    Actualiza o artigo na base de dados.

    Declaration
    void Actualiza(BasBEArtigo clsArtigo)
    Parameters
    Type Name Description
    BasBEArtigo clsArtigo

    Actualiza(BasBEArtigo, ref String)

    Actualiza o artigo na base de dados.

    Declaration
    void Actualiza(BasBEArtigo clsArtigo, ref string strAvisos)
    Parameters
    Type Name Description
    BasBEArtigo clsArtigo
    System.String strAvisos

    ActualizaArtigosFilhos(BasBEArtigoDimensoes, Boolean, String[])

    Actualiza os artigos dimensionais de um Mestre que seja novo quer esteja em edição

    Declaration
    void ActualizaArtigosFilhos(BasBEArtigoDimensoes objDimensoes, bool blnEmModoEdicao, params string[] objParams)
    Parameters
    Type Name Description
    BasBEArtigoDimensoes objDimensoes

    Artigo Mestre (pai) das dimensões a actualizar.

    System.Boolean blnEmModoEdicao

    Indica se o artigo é novo ou esta em edição.

    System.String[] objParams

    Array com os paramentros das propriedades a actualizar. O nome das propriedades a actualizar deve coincidir com o nome dos campos na tabela artigo (exemplo Para actualizar o artigo associado nos artigo dimensionais, deve-se adicionar a string "ArtAssociado," como parametro.

    ActualizaDataUltimaEntrada(String, DateTime)

    Actualiza a data da última entrada do artigo.

    Declaration
    void ActualizaDataUltimaEntrada(string Artigo, DateTime Data)
    Parameters
    Type Name Description
    System.String Artigo
    System.DateTime Data

    ActualizaDataUltimaSaida(String, DateTime)

    Actualiza a data da última saída do artigo.

    Declaration
    void ActualizaDataUltimaSaida(string Artigo, DateTime Data)
    Parameters
    Type Name Description
    System.String Artigo
    System.DateTime Data

    ActualizaPCM(String, String, Double, String, Double, Double, String, Double)

    Actualiza o preço de custo médio na ficha do artigo.

    Declaration
    void ActualizaPCM(string EntradaSaida, string Artigo, double Quantidade, string strUnidade, double PrecUnit, double DescontoComercial, string Seccao, double DespesasAdicionais = 0)
    Parameters
    Type Name Description
    System.String EntradaSaida
    System.String Artigo
    System.Double Quantidade
    System.String strUnidade
    System.Double PrecUnit
    System.Double DescontoComercial
    System.String Seccao
    System.Double DespesasAdicionais

    ActualizaPCUltimo(String, ref Double, String, Double, String, Double)

    Actualiza o preço de custo último no artigo.

    Declaration
    void ActualizaPCUltimo(string Artigo, ref double PrecUnit, string strUnidade, double DescontoComercial, string Seccao, double DespesasAdicionais = 0)
    Parameters
    Type Name Description
    System.String Artigo
    System.Double PrecUnit
    System.String strUnidade
    System.Double DescontoComercial
    System.String Seccao
    System.Double DespesasAdicionais

    ActualizaUltFornecedor(String, String, String, Int32, String)

    Actualiza o último fornecedor.

    Declaration
    void ActualizaUltFornecedor(string Artigo, string TipoDoc, string strSerie, int NumDoc, string Entidade)
    Parameters
    Type Name Description
    System.String Artigo

    Identificador do Artigo.

    System.String TipoDoc

    Identificador do Tipo do Documento.

    System.String strSerie

    Identificador da Série.

    System.Int32 NumDoc

    Identificador do Número do Documento.

    System.String Entidade

    Identificador da Entidade.

    ActualizaValorAtributo(String, String, Object)

    Actualiza um atributo do artigo.

    Declaration
    void ActualizaValorAtributo(string Artigo, string Atributo, dynamic Valor)
    Parameters
    Type Name Description
    System.String Artigo
    System.String Atributo
    System.Object Valor

    ActualizaValorAtributos(String, StdBECampos)

    Actualiza um conjunto de atributos de um artigo.

    Declaration
    void ActualizaValorAtributos(string Artigo, StdBECampos Atributos)
    Parameters
    Type Name Description
    System.String Artigo
    StdBECampos Atributos

    ApagaUltimoDocCompra(String, Int32, String)

    Apagar a informação do último documento de comrpa do artigo.

    Declaration
    void ApagaUltimoDocCompra(string strTipoDoc, int lngNumDoc, string strSerie = "")
    Parameters
    Type Name Description
    System.String strTipoDoc
    System.Int32 lngNumDoc
    System.String strSerie

    Consulta(String, Boolean)

    Devolve a a informação associada ao artigo para consulta.

    Declaration
    BasBEArtigo Consulta(string Artigo, bool CarregaCamposIgnorados = true)
    Parameters
    Type Name Description
    System.String Artigo
    System.Boolean CarregaCamposIgnorados

    Se o artigo existir em cache usa-o, não carregando os campos identificados como não tendo cache

    Returns
    Type Description
    BasBEArtigo

    ConvertePreco(Double, Boolean, Double, Boolean, Double, Int32)

    Procede à conversão de um preço com iva incuído.

    Corresponde à stored procedure GCPTABArtigosConvertePreco.

    Declaration
    double ConvertePreco(double Preco, bool IvaIncOrig, double TaxaIvaOrig, bool IvaIncDest, double TaxaIvaDest, int CasasDecimais)
    Parameters
    Type Name Description
    System.Double Preco

    Valor a converter

    System.Boolean IvaIncOrig

    Indicação se o preço está com iva incluído ou não

    System.Double TaxaIvaOrig

    Taxa de iva, para o caso de iva incluído

    System.Boolean IvaIncDest

    Indicação se o preço a converter terá iva incluído ou não

    System.Double TaxaIvaDest

    Taxa de iva, para o caso de iva incluído

    System.Int32 CasasDecimais

    Número de casas decimais a arredondar o valor. (Definido na moeda)

    Returns
    Type Description
    System.Double

    ConvertePrecoParaUnidade(String, String, Double, Boolean, Int32, Double)

    Procede à conversão de um Preço na Unidade Base para uma outra unidade diferente da Unidade Base

    Declaration
    double ConvertePrecoParaUnidade(string strArtigo, string strUnidadeDestino, double dblPreco, bool bUsaBaseDados = true, int iArred = 0, double dFactor = 1)
    Parameters
    Type Name Description
    System.String strArtigo
    System.String strUnidadeDestino
    System.Double dblPreco
    System.Boolean bUsaBaseDados
    System.Int32 iArred
    System.Double dFactor
    Returns
    Type Description
    System.Double

    ConvertePrecoParaUnidadeBase(String, String, Double, Boolean, Int32, Double)

    Procede à conversão de um Preço de uma Unidade para a Unidade Base do Artigo

    Declaration
    double ConvertePrecoParaUnidadeBase(string strArtigo, string strUnidadeOrigem, double dblPreco, bool bUsaBaseDados = true, int iArred = 0, double dFactor = 1)
    Parameters
    Type Name Description
    System.String strArtigo
    System.String strUnidadeOrigem
    System.Double dblPreco
    System.Boolean bUsaBaseDados
    System.Int32 iArred
    System.Double dFactor
    Returns
    Type Description
    System.Double

    ConvertePrecoUnidOrigemUnidDestino(String, String, String, Double, Boolean, Int32, Double)

    Procede à conversão de um Preço de uma Unidade para a Unidade Destino do Artigo

    Declaration
    double ConvertePrecoUnidOrigemUnidDestino(string strArtigo, string strUnidadeOrigem, string strUnidadeDestino, double dblPreco, bool bUsaBaseDados = true, int iArred = 0, double dFactor = 1)
    Parameters
    Type Name Description
    System.String strArtigo
    System.String strUnidadeOrigem
    System.String strUnidadeDestino
    System.Double dblPreco
    System.Boolean bUsaBaseDados
    System.Int32 iArred
    System.Double dFactor
    Returns
    Type Description
    System.Double

    ConverteQtdParaUnidade(String, String, Double, Boolean, Int32, Double)

    Procede à conversão de uma Quantidade na Unidade Base para uma outra unidade diferente da Unidade Base

    Declaration
    double ConverteQtdParaUnidade(string strArtigo, string strUnidadeDestino, double dblQuantidade, bool bUsaBaseDados = true, int iArred = 0, double dFactor = 1)
    Parameters
    Type Name Description
    System.String strArtigo
    System.String strUnidadeDestino
    System.Double dblQuantidade
    System.Boolean bUsaBaseDados
    System.Int32 iArred
    System.Double dFactor
    Returns
    Type Description
    System.Double

    ConverteQtdParaUnidadeBase(String, String, Double, Boolean, Int32, Double)

    Procede à conversão de uma Quantidade numa Unidade para a Unidade Base do Artigo

    Declaration
    double ConverteQtdParaUnidadeBase(string strArtigo, string strUnidadeOrigem, double dblQuantidade, bool bUsaBaseDados = true, int iArred = 0, double dFactor = 1)
    Parameters
    Type Name Description
    System.String strArtigo
    System.String strUnidadeOrigem
    System.Double dblQuantidade
    System.Boolean bUsaBaseDados
    System.Int32 iArred
    System.Double dFactor
    Returns
    Type Description
    System.Double

    ConverteQtdUnidOrigemUnidDestino(String, String, String, Double, Boolean, Int32, Double)

    Procede à conversão de um Preço na Unidade Origem para uma outra unidade Destino

    Declaration
    double ConverteQtdUnidOrigemUnidDestino(string strArtigo, string strUnidadeOrigem, string strUnidadeDestino, double dblPreco, bool bUsaBaseDados = true, int iArred = 0, double dFactor = 1)
    Parameters
    Type Name Description
    System.String strArtigo
    System.String strUnidadeOrigem
    System.String strUnidadeDestino
    System.Double dblPreco
    System.Boolean bUsaBaseDados
    System.Int32 iArred
    System.Double dFactor
    Returns
    Type Description
    System.Double

    ConverteUnOrigUnDestQuantidade(String, String, String, Double)

    Procede à conversão de uma Quantidade entre duas unidades

    Declaration
    dynamic ConverteUnOrigUnDestQuantidade(string strArtigo, string strUnidadeOrigem, string strUnidadeDestino, double dblQuantidade)
    Parameters
    Type Name Description
    System.String strArtigo
    System.String strUnidadeOrigem
    System.String strUnidadeDestino
    System.Double dblQuantidade
    Returns
    Type Description
    System.Object

    ConverteUnOrigUnDestValor(String, String, String, Double, String, BasBETiposGcp.TipoValor, BasBEMoeda)

    Procede à conversão de um Preço na Unidade Base para uma outra unidade diferente da Unidade Base

    Declaration
    dynamic ConverteUnOrigUnDestValor(string strArtigo, string strUnidadeOrigem, string strUnidadeDestino, double dblValor, string strMoeda, BasBETiposGcp.TipoValor teTipoValor, BasBEMoeda objMoeda = null)
    Parameters
    Type Name Description
    System.String strArtigo
    System.String strUnidadeOrigem
    System.String strUnidadeDestino
    System.Double dblValor
    System.String strMoeda
    BasBETiposGcp.TipoValor teTipoValor
    BasBEMoeda objMoeda
    Returns
    Type Description
    System.Object

    CriaLote(String, ref String, String, DateTime, DateTime, String, String)

    Cria um Lote na Tabela ArtigoLote

    Declaration
    void CriaLote(string Artigo, ref string Lote, string Descricao, DateTime DataFabrico, DateTime DataValidade, string Controlador, string Observacoes)
    Parameters
    Type Name Description
    System.String Artigo
    System.String Lote
    System.String Descricao
    System.DateTime DataFabrico
    System.DateTime DataValidade
    System.String Controlador
    System.String Observacoes

    DaArtigoComCodBarras(ref String)

    Devolve o Código de um Artigo apartir do seu Código de Barras.

    Declaration
    string DaArtigoComCodBarras(ref string CodBarras)
    Parameters
    Type Name Description
    System.String CodBarras
    Returns
    Type Description
    System.String

    DaArtigoFilho(String, String, String, String)

    Devolve o código do artigo referente às rubricas de dimensão

    Declaration
    string DaArtigoFilho(string strArtigoPai, string strRubDim1, string strRubDim2 = "", string strRubDim3 = "")
    Parameters
    Type Name Description
    System.String strArtigoPai
    System.String strRubDim1
    System.String strRubDim2
    System.String strRubDim3
    Returns
    Type Description
    System.String

    DaDefCamposUtil()

    Devolve as definições dos campos do utilizador.

    Declaration
    StdBEDefCamposUtil DaDefCamposUtil()
    Returns
    Type Description
    StdBEDefCamposUtil

    DaFactorConversao(String, String, String)

    Retorna o factor de conversão a utilizar para um determinado artigo.

    Declaration
    double DaFactorConversao(string sArtigo, string sUnidadeBase, string sUnidadeDestino)
    Parameters
    Type Name Description
    System.String sArtigo
    System.String sUnidadeBase
    System.String sUnidadeDestino
    Returns
    Type Description
    System.Double

    DaValorAtributo(String, String)

    Devolve o valor de um atributo.

    Declaration
    dynamic DaValorAtributo(string Artigo, string Atributo)
    Parameters
    Type Name Description
    System.String Artigo
    System.String Atributo
    Returns
    Type Description
    System.Object

    DaValorAtributoLock(String, String)

    Devolve o valor de um atributo.

    Declaration
    dynamic DaValorAtributoLock(string Artigo, string Atributo)
    Parameters
    Type Name Description
    System.String Artigo
    System.String Atributo
    Returns
    Type Description
    System.Object

    DaValorAtributos(String, String[])

    Dá o valor de um conjunto de atributos

    Declaration
    StdBECampos DaValorAtributos(string strArtigo, params string[] Atributos)
    Parameters
    Type Name Description
    System.String strArtigo
    System.String[] Atributos
    Returns
    Type Description
    StdBECampos

    DaValorAtributosLock(String, String[])

    Dá o valor de um conjunto de atributos

    Declaration
    StdBECampos DaValorAtributosLock(string strArtigo, params string[] Atributos)
    Parameters
    Type Name Description
    System.String strArtigo
    System.String[] Atributos
    Returns
    Type Description
    StdBECampos

    Edita(String)

    Edita a informação associada ao artigo.

    Declaration
    BasBEArtigo Edita(string Artigo)
    Parameters
    Type Name Description
    System.String Artigo
    Returns
    Type Description
    BasBEArtigo

    EditaDimensao(String)

    Edita a informação associada a uma dimensão.

    Declaration
    BasBEArtigoDimensao EditaDimensao(string strArtigo)
    Parameters
    Type Name Description
    System.String strArtigo

    Artigo do qual se pretende editar as dimensões.

    Returns
    Type Description
    BasBEArtigoDimensao

    EditaDimensoes(String)

    Edita a informação das dimensões de um artigo Pai.

    Declaration
    BasBEArtigoDimensoes EditaDimensoes(string strArtigoPai)
    Parameters
    Type Name Description
    System.String strArtigoPai

    Artigo Mestre (pai) das dimensões a editar.

    Returns
    Type Description
    BasBEArtigoDimensoes

    Existe(String)

    Verifica se o artigo existe na base de dados.

    Declaration
    bool Existe(string Artigo)
    Parameters
    Type Name Description
    System.String Artigo
    Returns
    Type Description
    System.Boolean

    ExisteCodBarras(String)

    Esta função indica se o Codigo de Barras introduzido já se encontra associado a outro artigo. Caso verdadeiro devolve o código do artigo.

    Declaration
    string ExisteCodBarras(string CodBarras)
    Parameters
    Type Name Description
    System.String CodBarras

    Código de barras utilizado para validar a sua existência

    Returns
    Type Description
    System.String

    ExistemDocumentosCertificadosArtigo(String)

    Retorna verdadeiro, caso existam documentos de venda ou compra certificados lançados para um determinado artigo.

    Declaration
    bool ExistemDocumentosCertificadosArtigo(string Artigo)
    Parameters
    Type Name Description
    System.String Artigo

    Código do artigo a validar.

    Returns
    Type Description
    System.Boolean

    ExistemMovimentos(String, String)

    Declaration
    int ExistemMovimentos(string sArtigo, string sModulos = "CVSN")
    Parameters
    Type Name Description
    System.String sArtigo
    System.String sModulos
    Returns
    Type Description
    System.Int32

    ExistemMovimentosLotes(String)

    Verifica se existem movimentos para um determinado artigo que movimenta lotes

    Declaration
    bool ExistemMovimentosLotes(string sArtigo)
    Parameters
    Type Name Description
    System.String sArtigo

    O artigo ao qual verificar a existência de movimentos

    Returns
    Type Description
    System.Boolean

    FactorConvUnBaseUnDest(String, String)

    Retorna o factor de conversão entre a unidade base e uma outra unidade, para um determinado artigo.

    Declaration
    double FactorConvUnBaseUnDest(string sArtigo, string sUnidadeDestino)
    Parameters
    Type Name Description
    System.String sArtigo
    System.String sUnidadeDestino
    Returns
    Type Description
    System.Double

    FactorConvUnBaseUnDest(String, String, ref String)

    Retorna o factor de conversão entre a unidade base e uma outra unidade, para um determinado artigo.

    Declaration
    double FactorConvUnBaseUnDest(string sArtigo, string sUnidadeDestino, ref string sUnidadeBase)
    Parameters
    Type Name Description
    System.String sArtigo
    System.String sUnidadeDestino
    System.String sUnidadeBase
    Returns
    Type Description
    System.Double

    FactorConvUnOrigUnDest(String, String, String)

    Retorna o factor de conversão entre duas unidades quaisquer, para um determinado artigo.

    A stored procedure correspondente é: GCPTABArtigosFactorConvUnOrigUnDest

    Declaration
    double FactorConvUnOrigUnDest(string sArtigo, string sUnidadeOrigem, string sUnidadeDestino)
    Parameters
    Type Name Description
    System.String sArtigo
    System.String sUnidadeOrigem
    System.String sUnidadeDestino
    Returns
    Type Description
    System.Double

    ListaArtigos(StdBEFiltroListagem)

    Executa a listagem de artigos, de forma estruturada, para um filtro definido

    Declaration
    List<BasBEArtigo> ListaArtigos(StdBEFiltroListagem filtro)
    Parameters
    Type Name Description
    StdBEFiltroListagem filtro
    Returns
    Type Description
    System.Collections.Generic.List<BasBEArtigo>

    LstArtigos()

    Devolve uma listagem com todos os artigos existentes.

    Declaration
    StdBELista LstArtigos()
    Returns
    Type Description
    StdBELista

    LstArtigosServico()

    Devolve uma lista com os artigos do tipo serviço A, B e C.

    Declaration
    StdBELista LstArtigosServico()
    Returns
    Type Description
    StdBELista

    LstDimensao1(String)

    Dá uma lista das dimensoes UM (TipoDim2,Dim2,RubDim2,OrdemDim)

    Declaration
    StdBELista LstDimensao1(string Artigo)
    Parameters
    Type Name Description
    System.String Artigo
    Returns
    Type Description
    StdBELista

    LstDimensao2(String)

    Dá uma lista das dimensoes Dois

    Declaration
    StdBELista LstDimensao2(string Artigo)
    Parameters
    Type Name Description
    System.String Artigo
    Returns
    Type Description
    StdBELista

    LstDimensao3(String)

    Dá uma lista das dimensoes três

    Declaration
    StdBELista LstDimensao3(string Artigo)
    Parameters
    Type Name Description
    System.String Artigo
    Returns
    Type Description
    StdBELista

    LstDimensoes(String)

    Permite retornar uma lista com a colecção de dimensões associados a um artigo tendo por base a tabela Artigo (Artigo,TipoDim1,Dim1,RubDim1,TipoDim2,Dim2,RubDim2,TipoDim3,Dim3,RubDim3,OrdemDim).

    Declaration
    StdBELista LstDimensoes(string strArtigoPai)
    Parameters
    Type Name Description
    System.String strArtigoPai
    Returns
    Type Description
    StdBELista

    LstDimensoesUtilizadas(String)

    Permite retornar uma lista com as rubricas de dimensões associadas a uma artigo pai e respectivas combinações.

    Declaration
    StdBELista LstDimensoesUtilizadas(string strArtigoPai)
    Parameters
    Type Name Description
    System.String strArtigoPai
    Returns
    Type Description
    StdBELista

    PreencheDadosRelacionados(BasBEArtigo)

    Preenche o artigo com os valores sugeridos por defeito.

    Declaration
    BasBEArtigo PreencheDadosRelacionados(BasBEArtigo clsArtigo)
    Parameters
    Type Name Description
    BasBEArtigo clsArtigo
    Returns
    Type Description
    BasBEArtigo

    Remove(String)

    Remove um artigo.

    Declaration
    void Remove(string Artigo)
    Parameters
    Type Name Description
    System.String Artigo

    Identificador do Artigo.

    ValidaActualizacao(BasBEArtigo, ref String)

    Efectua as validações necessárias à actualização do artigo.

    Declaration
    bool ValidaActualizacao(BasBEArtigo clsArtigo, ref string StrErro)
    Parameters
    Type Name Description
    BasBEArtigo clsArtigo
    System.String StrErro
    Returns
    Type Description
    System.Boolean

    ValidaRemocao(String, String)

    Efectua as validações necessárias à remoção do artigo.

    Declaration
    bool ValidaRemocao(string Artigo, string StrErro)
    Parameters
    Type Name Description
    System.String Artigo
    System.String StrErro
    Returns
    Type Description
    System.Boolean