# Dicionário de Campos IBM

### Lista de Campos Nativos

<table><thead><tr><th width="202">Campo IBM</th><th>Descrição Detalhada</th></tr></thead><tbody><tr><td>product/name</td><td>Nome comercial do produto IBM Cloud utilizado (ex: Cloud Databases, Cloud Functions). Essencial para categorização e análise de consumo por produto.</td></tr><tr><td>service/name</td><td>Nome técnico do serviço específico dentro do produto (ex: cloud-object-storage, is, power-iaas). Usado para análise detalhada de uso.</td></tr><tr><td>resource/id</td><td>Identificador exclusivo do recurso provisionado. Útil para rastreamento individual e auditoria de consumo.</td></tr><tr><td>region</td><td>Região geográfica onde o recurso foi consumido (ex: us-south, eu-de). Importante para governança e compliance regional.</td></tr><tr><td>cost/unblended</td><td>Custo direto bruto do recurso, sem descontos. Base para rateios precisos e cálculo real de consumo.</td></tr><tr><td>cost/blended</td><td>Custo médio ponderado com descontos aplicados. Útil para análise financeira consolidada entre contas e serviços.</td></tr><tr><td>cost/tax</td><td>Valor de imposto aplicado ao recurso ou serviço. Necessário para relatórios contábeis e conformidade fiscal.</td></tr><tr><td>billing/charge_type</td><td>Tipo de cobrança aplicada (ex: uso, reserva, desconto, subscrição). Classifica a origem do custo.</td></tr><tr><td>billing/invoice_date</td><td>Data de emissão da fatura associada. Referência para fechamento contábil e geração de relatórios.</td></tr><tr><td>usage/period_start</td><td>Data e hora de início do período de uso do recurso. Usado para delimitação temporal do uso.</td></tr><tr><td>usage/period_end</td><td>Data e hora de fim do período de uso. Complementa o controle de tempo de consumo.</td></tr><tr><td>account/id</td><td>Identificador único da conta IBM Cloud. Essencial para segregação de ambientes e alocação organizacional.</td></tr><tr><td>org/unit</td><td>Unidade organizacional interna à qual os custos foram atribuídos. Suporte à estrutura corporativa.</td></tr><tr><td>cost_center</td><td>Centro de custo associado ao uso. Fundamental para alocação interna e controle de budget.</td></tr><tr><td>project</td><td>Projeto vinculado ao recurso ou grupo de recursos. Auxilia na governança de iniciativas e orçamentos.</td></tr><tr><td>currency</td><td>Moeda utilizada na cobrança (ex: USD, BRL). Importante para conversão e consolidação de custos em múltiplas regiões.</td></tr><tr><td>pricing/unit</td><td>Unidade de cobrança (ex: GB, hora, vCPU). Ajuda a entender a granularidade da precificação.</td></tr><tr><td>pricing/model</td><td>Modelo de precificação do recurso (on-demand, reserved, subscription). Relevante para estratégia de otimização.</td></tr><tr><td>subscription/type</td><td>Tipo de contrato ou subscrição (Pay-As-You-Go, Subscription, RI). Usado para identificar o modelo de aquisição.</td></tr><tr><td>billing/account_name</td><td>Nome descritivo da conta IBM Cloud de faturamento. Facilita o entendimento por humanos.</td></tr><tr><td>invoice/number</td><td>Número da fatura ou documento fiscal. Referência para conciliação com sistemas financeiros.</td></tr><tr><td>sku/number</td><td>Código do SKU (Stock Keeping Unit) do recurso. Útil para classificação técnica e integração com ERP.</td></tr><tr><td>tags</td><td>Metadados associados ao recurso (ex: ambiente:prod, owner:ti). Base para filtros, alocações e relatórios personalizados.</td></tr></tbody></table>

### Lista de Campos Personalizados

<table><thead><tr><th width="97">Campo</th><th width="225">Descrição</th><th width="105">Uso em Billing</th><th width="106">Equivalência</th><th width="175">Diferença de Uso</th></tr></thead><tbody><tr><td>custom/ibm/baixa</td><td>Valor lançado como baixa contábil, indicando liquidação ou encerramento de valores a pagar ou a receber no ciclo de custos. Pode refletir ajustes ou compensações no sistema financeiro.</td><td>Baixa de valores ou créditos</td><td>Relacionado a ajustes financeiros</td><td>Reflete o ajuste de valores que foram considerados em débito ou créditos em contas, ajudando a consolidar os custos finais.</td></tr><tr><td>custom/ibm/chargeback_baixa_cost</td><td>Representa o custo alocado como resultado de uma baixa no sistema de chargeback. É utilizado para refletir movimentações de encerramento de centros de custo ou ajustes de alocação.</td><td>Custo devido a baixa</td><td>Relacionado ao chargeback de baixa</td><td>Aplica-se a custos decorrentes da baixa de valores, geralmente vinculados a reversões ou ajustes de contas.</td></tr><tr><td>custom/ibm/chargeback_excedente_cost</td><td>Custo relacionado ao consumo que excedeu o previsto no orçamento ou contrato, sendo necessário repassar esse excedente aos respectivos centros de custo ou unidades de negócio.</td><td>Excedente de consumo</td><td>Relacionado ao chargeback de excedente</td><td>Identifica o custo de uso além do previsto em contratos ou orçamentos, impactando as alocações de chargeback.</td></tr><tr><td>custom/ibm/chargeback_percentual_rateio_conta</td><td>Percentual aplicado para ratear os custos por conta (account), permitindo distribuir proporcionalmente os valores totais de forma automatizada em ambientes compartilhados.</td><td>Rateio de custos por conta</td><td>Relacionado ao rateio de custos</td><td>Aplica-se ao cálculo da distribuição proporcional de custos dentro das contas, facilitando a alocação entre diferentes centros de custos.</td></tr><tr><td>custom/ibm/chargeback_perc_rateio_cf</td><td>Percentual de rateio aplicado com base no centro de custo (Cost Center ou CF), utilizado para distribuir despesas operacionais em estruturas organizacionais ou projetos.</td><td>Rateio de custos por centro de custo</td><td>Relacionado ao rateio de custos</td><td>Aplica a distribuição percentual de custos dentro dos centros de custo específicos, garantindo que os valores sejam devidamente alocados.</td></tr><tr><td>custom/ibm/chargeback_provisao_cost</td><td>Valor provisionado no sistema de chargeback para cobrir custos futuros estimados, antes da efetiva apuração. Suporta planejamento orçamentário e conformidade fiscal.</td><td>Provisão para custos futuros</td><td>Relacionado a provisões de custos</td><td>Reflete a alocação de provisões para custos futuros, ajudando a antecipar gastos e evitar surpresas financeiras.</td></tr><tr><td>custom/ibm/chargeback_total_cost</td><td>Soma total dos custos alocados via chargeback, incluindo consumo direto, excedentes, provisões e ajustes. É o valor final atribuído aos centros de responsabilidade.</td><td>Valor total de chargeback</td><td>Relacionado ao cálculo total de chargeback</td><td>Representa o valor total de chargebacks a serem considerados para a empresa ou cliente, calculado após rateios e ajustes.</td></tr><tr><td>custom/ibm/nf_commit</td><td>Indica a existência de um compromisso de fatura registrado no sistema, representando acordos prévios de valores contratados com fornecedores ou provedores de serviço.</td><td>Compromisso de pagamento de fatura</td><td>Relacionado ao compromisso com a fatura</td><td>Reflete a fatura de um compromisso financeiro, indicando o valor que foi comprometido em contratos.</td></tr><tr><td>custom/ibm/nf_commit_cost</td><td>Custo efetivo associado ao compromisso de fatura (nf_commit), refletindo os valores financeiros atribuídos aos contratos assumidos, independentemente do consumo real.</td><td>Custo do compromisso de fatura</td><td>Relacionado ao custo de compromisso</td><td>Aplica-se ao custo que se gera a partir do compromisso de pagamento de fatura, alinhando o valor comprometido com os custos reais.</td></tr><tr><td>custom/ibm/nf_excedente</td><td>Valor indicado na fatura como excedente, ou seja, o montante consumido além do previsto ou contratado. Essencial para controle de desvios e renegociação de contratos.</td><td>Excedente em fatura</td><td>Relacionado à fatura de excedente</td><td>Reflete os custos adicionais gerados por excedente de uso ou consumo, ajustando os valores pagos de acordo com o que foi consumido além do previsto.</td></tr><tr><td>custom/ibm/provisao</td><td>Valor estimado e reservado para cobrir futuros custos operacionais ou financeiros relacionados aos serviços da IBM. Utilizado para planejamento e previsibilidade orçamentária.</td><td>Provisão de custos</td><td>Relacionado a provisões financeiras</td><td>Aplica-se a provisões para custos não pagos ou não comprometidos, ajudando na previsão de despesas futuras.</td></tr></tbody></table>
