Lógica de transformação de dados da fatura

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 6 min. de leitura
  • Integração de Operações de contas a pagar com Document Intelligence converte os valores do campo de fatura e linha de fatura do documento de fatura para um formato compatível com o sistema que processa a fatura.

    Lógica de derivação de tipo

    A aplicação inclui a seguinte lógica para derivar o campo de tipo na fatura.

    • Considera o valor da ordem de compra no registro da fase da fatura
    • Se o valor da ordem de compra não estiver vazio, o tipo de fatura será definido como Tipo de OC.
    • Se o valor da ordem de compra estiver vazio, o tipo de fatura será definido como Tipo Não OC.

    Lógica de conversão de data

    A aplicação inclui a seguinte lógica para converter formatos de data mencionados no documento de fatura:
    • Considera AAAA-MM-DD como o formato ISO e o formato do sistema para conversão de data.
    • Considera datas somente no formato MM-DD-AAAA para conversão.
    • Não considera datas no formato DD-MM-AAAA se DD for menor que 12.
    Tabela 1. Lógica de conversão de data
    Formato de data na fatura de entrada Formato de data convertido
    2 de setembro de 2022 2022-09-02
    3 de setembro de 2022 2022-09-02
    02-Set-2022 2022-09-02
    02 de setembro de 2022 2022-09-02
    Sept-02-2022 2022-09-02
    Sep-02-2022 2022-09-02
    09-02-2022 2022-09-02
    02-09-2022 2022-02-09
    09/02/2022 2022-09-02
    02/09/2022 2022-02-09

    Lógica de conversão de moeda

    A aplicação oferece suporte a diferentes localidades, como sistemas numéricos norte-americanos, europeus e indianos. Por exemplo, "X,XXX.XXX", "X.XXX,XX", "XX,XX.XXX", em que X é um número positivo de um dígito.

    Tabela 2. Lógica de conversão de moeda
    Cenário Formato de moeda na fatura de entrada Formato de moeda convertido
    Valor seguido por um espaço e o código da moeda EUR 76 EUR 76
    Valor seguido por um espaço e o símbolo da moeda 76 € EUR 76
    Código da moeda seguido por vários espaços e o valor EUR 76 EUR 76
    Símbolo de moeda seguido por vários espaços e o valor 76 euros EUR 76
    Valor sem um código de moeda ou símbolo 76 76 (seguido da moeda da ordem de compra ou da moeda da sessão)
    Valor separado por vírgula, ponto ou qualquer outro agrupamento ou separador decimal seguido por um espaço e o código da moeda EUR 7.123.456,99 EUR 7123456,99
    Valor seguido pelo código da moeda sem espaço 76EUR EUR 76
    Valor seguido pelo símbolo da moeda sem espaço 76 euros EUR 76
    Código da moeda seguido pelo valor sem espaço EUR76 EUR 76
    Símbolo da moeda seguido pelo valor sem espaço 76 euros EUR 76
    Primeiro, a aplicação procura o código de moeda exclusivo ativo na tabela Moeda [fx_currency] quando um valor de fatura de entrada tem um símbolo ou código de moeda. Se várias correspondências de moeda forem encontradas ou o valor da fatura de entrada não tiver código ou símbolo de moeda, a aplicação executará a lógica de moeda padrão dependendo do tipo de fatura da seguinte forma.
    • Fatura da OC - Pesquisa ordem de compra e moeda relacionada e define a moeda da fatura como moeda da ordem de compra. Em caso de ordem de compra ausente ou moeda relacionada, a moeda da fatura será definida como a moeda do sistema.
    • Fatura sem OC - Pesquisa a entidade jurídica e a moeda local e define a moeda da fatura como a moeda local da entidade jurídica. No caso de entidade jurídica e moeda local ausentes, a moeda da fatura será definida como a moeda do sistema.

    Lógica de conversão de preço unitário

    A aplicação oferece suporte a diferentes localidades, como localidade de formato numérico dos EUA, europeu e indiano. Por exemplo, "X,XXX.XXX", "X.XXX,XX", "XX,XX.XXX", em que X é um número positivo de um dígito.

    Se o preço unitário da fatura de entrada consistir no símbolo da moeda ou código presente na tabela Moeda [fx_currency], o preço unitário será convertido. Por exemplo, XX,XXX,XXX.XX ou USD XX,XX,XXX.X, em que X é um número positivo de um dígito.

    Tabela 3. Lógica de conversão de preço unitário
    Preço unitário mencionado na fatura de entrada Preço unitário convertido
    1,000,25.10 100025,10
    1,00,025.10 100025,10
    USD 1.000.25,10 100025,10
    USD 1,000,25.10 100025,10
    USD1.00.025,10 100025,10
    USD 1,00,025.10 100025,10

    Lógica de conversão decimal

    A aplicação oferece suporte a diferentes localidades, como localidade de formato decimal dos EUA, europeu e indiano. Por exemplo, "X,XXX.XXX", "X.XXX,XX", "XX,XX.XXX", em que X é um número positivo de um dígito.

    Os agrupamentos de moeda nas linhas de fatura e fatura são determinados com base nas configurações de localidade do sistema do usuário. As moedas europeias consideram a vírgula como um separador decimal e o ponto como um separador de mil. Em alguns casos, vários caracteres também podem ser usados como separador de agrupamento. As linhas de fatura e fatura de entrada presentes nas tabelas [sn_ap_ic_invoice_stage] e [sn_ap_ic_invoice_line_stage] são convertidas com base no posicionamento dos separadores decimais e de milhares.
    Nota:
    Para números como 100 251 e 100,251, o sistema verifica se há outros separadores decimais mencionados na fatura e os converte para o formato decimal apropriado. Se a fatura contiver campos com um único separador decimal, a conversão não se aplicará à fatura e o valor será definido como vazio, conforme mostrado na tabela a seguir.
    Para obter mais informações sobre conversão de moeda, consulte Currency administration.
    Tabela 4. Lógica de conversão decimal
    Formato decimal mencionado na fatura de entrada Formato decimal convertido
    1,000,25.10 100025,10
    1,00,025.10 100025,10
    100,251 100 251
    10.102,510 10102.51
    10.10.102,510 1010102.51
    100 251
    100,251

    Lógica para buscar valores de campos de referência

    Tabela 5. Lógica do valor do campo de referência
    Campo de Referência Lógica para buscar o valor do campo
    Entidade jurídica O sistema busca o valor verificando os seguintes valores na ordem listada:
    1. Faturar para a empresa
    2. Cidade, Estado, País, CEP
    3. Cidade, Estado, País, CEP
    4. Estado, País, CEP
    5. CEP
    6. País
    7. CEP
    Ordem de Compra O sistema faz o seguinte:
    • O sistema considera o valor da ordem de compra mencionado na fase de fatura
    • Se o valor da ordem de compra for prefixado com caracteres especiais, letras ou zeros, a aplicação ignorará os prefixos e corresponderá o valor da ordem de compra restante com o número ERP da tabela de ordem de compra
    • Se uma ordem de compra exclusiva for encontrada, a aplicação preencherá a ordem de compra na fatura
    Fornecedor O sistema executa um dos seguintes procedimentos:
    • O sistema considera o valor mencionado na fatura e faz uma correspondência completa com o fornecedor na tabela Fornecedor.
    • Se a fatura contiver uma ordem de compra associada ao fornecedor, a aplicação corresponderá ao nome do fornecedor mencionado na fatura com o nome do fornecedor da ordem de compra e preencherá o fornecedor.
    • Se o documento da fatura contiver o nome do fornecedor com mais de duas palavras, a aplicação executará a correspondência parcial do nome em relação aos detalhes do fornecedor na tabela do fornecedor junto com o endereço ou a cidade. Exemplo. Se o documento da fatura contiver o nome do fornecedor como XX Corp e o nome do fornecedor na tabela do fornecedor for XX Ltd, a aplicação corresponderá XX na tabela do fornecedor junto com o endereço e preencherá o documento da fatura com o fornecedor correspondente.
    Se um registro de fornecedor exclusivo for encontrado em qualquer um dos itens acima, a aplicação preencherá o fornecedor na fatura.
    País O sistema executa um dos seguintes procedimentos:
    • Considera o valor mencionado na fatura
    • Se este valor não for mencionado na fatura, ele preencherá o nome curto do país da Organização Internacional para Padronização (ISO) ou o nome longo do país ISO
    Subtotal, Valor do imposto, Outros encargos O sistema faz o seguinte:
    • Se a fatura contiver XX,XXX,XXX, a aplicação agrupará o numérico em quatro dígitos após o separador decimal.
    • Se a fatura contiver três dígitos numéricos após o separador, a aplicação definirá os campos da fatura como vazios.
    • Se a fatura contiver uma combinação de separadores decimais e milhares em um formulário, a aplicação usará o valor numérico como padrão para o separador decimal.
    • Se a fatura contiver valor negativo ou quantidade negativa, então DocIntel a lógica de transformação é atualizada para extrair valores negativos em que o sinal negativo é:
      • Presente após o valor (nível de cabeçalho ou linha)
      • Presente em um colchete (nível de cabeçalho ou linha)
      Nesses casos, a fatura é considerada do tipo Nota de crédito.