Tabela SAPObjetoVBAPMóduloSD_O2C

Tabela VBAP — Tabela de Itens de Documento de Vendas

VBAP armazena uma linha por item de documento de vendas, ou seja, uma linha de material ou serviço dentro de uma consulta, cotação, pedido, contrato ou contrato de remessa. Ela contém a categoria do item, centro, quantidade, valor líquido, moeda e status de rejeição para essa linha, e se vincula ao cabeçalho em VBAK e avança para as tabelas de linhas de remessa, status e dados comerciais através das mesmas chaves VBELN e POSNR.

Esta página descreve o que uma linha VBAP realmente representa, quais campos possuem peso diagnóstico real e como a tabela se une às tabelas de cabeçalho, linhas de remessa, status e dados comerciais. Ela se concentra nos padrões de falha que os consultores realmente encontram quando um item de pedido de vendas parece incorreto nos dados.

Revisado por um consultor SAP da ERPClimb em 15 de set. de 2026· 1.127 palavras

O que ela armazena

Uma linha em VBAP representa um único item dentro de um documento de vendas, identificado pelo número do documento VBELN e pelo número do item POSNR. O item pode ser uma linha de material padrão, um item de texto, uma linha de mercadoria gratuita, um item de nível superior em uma estrutura de lista de materiais ou um item de serviço. A VBAP contém os atributos comerciais e logísticos dessa linha: categoria do item, centro, depósito, quantidade do pedido, unidade de vendas, valor líquido, moeda, rota e motivo da rejeição, se a linha tiver sido cancelada. Ela se aplica uniformemente a todas as categorias de documentos de vendas porque consultas, cotações, pedidos, contratos e contratos de remessa usam a mesma estrutura de cabeçalho-item, VBAK e VBAP. A categoria do documento é lida de VBAK, não de VBAP, então VBAP sozinha não pode dizer a que tipo de documento o item pertence.

Campos-chave

  • MANDT - mandante, sempre o primeiro filtro, nunca omita em uma seleção manual
  • VBELN - número do documento de vendas, a chave do cabeçalho compartilhada com VBAK
  • POSNR - número do item dentro do documento, não é único por si só
  • MATNR - número do material inserido na linha
  • WERKS - centro de remessa para este item
  • LGORT - depósito proposto ou inserido para este item
  • PSTYV - categoria de item de documento de vendas, impulsiona a relevância de preços, remessa e faturamento
  • ABGRU - motivo da rejeição, em branco significa que o item ainda está em aberto
  • KWMENG - quantidade do pedido cumulativa na unidade de vendas
  • VRKME - unidade de vendas para o item
  • NETWR - valor líquido do item na moeda do documento
  • WAERK - moeda do documento
  • UEPOS - número do item de nível superior, preenchido para subitens de lista de materiais e mercadorias gratuitas
  • GRKOR - grupo de remessa, controla se os itens devem ser entregues juntos
  • ROUTE - rota determinada para o item
  • ERDAT - data de criação do item

Como ela se une ao modelo de dados

  • VBAP-VBELN = VBAK-VBELN se une ao cabeçalho do documento para organização de vendas, tipo de documento e vendido para
  • VBAP-VBELN/POSNR = VBEP-VBELN/POSNR se une às linhas de remessa para datas de entrega e quantidades confirmadas
  • VBAP-VBELN/POSNR = VBUP-VBELN/POSNR se une ao status do item para sinalizadores de status de entrega, faturamento e rejeição
  • VBAP-VBELN/POSNR = VBKD-VBELN/POSNR se une aos dados comerciais para condições de pagamento, incoterms e data de precificação no nível do item
  • VBAP-VBELN/POSNR = VBFA-VBELV/POSNV (ou VBELN/POSNN para o lado sucessor) se une ao fluxo de documentos para rastrear o item em entregas e faturamento
  • VBAK-KNUMV alimentando KONV, então filtrando por KPOSN = VBAP-POSNR, recupera os registros de condição precificados para este item específico

Como lê-la com segurança

MANDT é implícito na maioria das ferramentas, mas ainda é o primeiro filtro lógico. VBELN é altamente seletivo e deve ser a restrição primária sempre que o número do documento for conhecido; POSNR sozinho é quase inútil, pois se repete em todos os documentos. Nunca selecione por MATNR ou WERKS em toda a tabela sem também restringir VBELN ou um intervalo de datas, a tabela é grande em qualquer sistema SD ativo e uma varredura irrestrita nesses campos demorará muito. Se o ponto de partida for um cliente ou data em vez de um número de documento, consulte VBAK primeiro com VKORG, ERDAT ou KUNNR, extraia a lista VBELN e, em seguida, junte-se a VBAP. Cuidado com zeros à esquerda em VBELN ao colar números de documentos manualmente.

Como comprová-la nos dados

Sintoma: um item de pedido de vendas mostra valor líquido zero na tela do pedido. Selecione VBAP para esse VBELN e POSNR e verifique NETWR e WAERK diretamente. Se NETWR for realmente zero e ABGRU estiver em branco, o item foi precificado como zero, o que aponta para os registros de condição em KONV via VBAK-KNUMV e KPOSN = POSNR, e não para a própria VBAP. Se ABGRU estiver preenchido, o item foi rejeitado e um valor zero é esperado e correto.

ECC vs. S/4HANA

VBAP permanece uma tabela transparente com essencialmente a mesma estrutura no S/4HANA, ela não foi substituída ou reestruturada como parte da simplificação do modelo de dados de SD. Ela se encontra abaixo da camada de visualização CDS de pedido de vendas usada por aplicativos Fiori mais recentes e relatórios analíticos, mas essa camada lê de VBAP em vez de substituí-la, então o acesso direto à tabela, relatórios ABAP e consultas legadas construídas contra VBAP continuam funcionando sem alterações. A mudança do modelo de parceiro de negócios afeta as tabelas mestre de clientes, não a VBAP.

Armadilhas comuns

  • Tratar POSNR como único ou sequencial entre documentos; ele só tem significado combinado com VBELN, e a numeração dos itens pode saltar de dezenas ou centenas dependendo do incremento definido na customização, lacunas não significam itens excluídos
  • Ler NETWR como o valor final faturado; NETWR reflete o resultado do preço do item do pedido no momento em que foi processado pela última vez, não o que foi realmente faturado, essa comparação requer VBRP
  • Assumir que um ABGRU em branco significa que o item ainda está totalmente aberto para entrega; o item ainda pode estar bloqueado, totalmente entregue ou totalmente faturado, esse estado reside em VBUP, não em VBAP
  • Assumir que KWMENG é o que será enviado; as quantidades confirmadas e entregues residem em VBEP e nas tabelas de entrega, KWMENG é apenas a quantidade pedida
  • Esquecer que os itens de nível superior (UEPOS preenchido) muitas vezes não possuem relevância independente de preço ou entrega própria, os subitens abaixo deles sim, então filtrar por UEPOS em branco perde as linhas de componentes de lista de materiais que precisam de atenção separada
  • Puxar PSTYV e assumir que ele sempre corresponde à categoria de item proposta pelo grupo de categoria de item no cadastro de material; substituições manuais na entrada do pedido são comuns e apenas o valor armazenado em VBAP para aquele item específico é autoritário
  • Usar VBAP isoladamente para explicar por que uma linha não foi entregue ou faturada; isso sempre requer VBUP para status e VBFA para quais documentos foram realmente criados a jusante

De quem é este problema

Consultores funcionais de gerenciamento de pedidos ou SD são responsáveis por questões sobre determinação de categoria de item, resultados de precificação e motivos de rejeição armazenados aqui. A equipe de Basis ou gerenciamento de dados é responsável pelo crescimento da tabela e arquivamento. Se a disputa for sobre o que o cliente foi realmente cobrado, e não sobre o que a linha do pedido mostra, a responsabilidade muda para o faturamento, o que significa VBRP e VBRK, não VBAP.

Objetos SAP relacionados

Páginas revisadas às quais este objeto se conecta no grafo de conhecimento da ERPClimb.

Fonte: ERPClimb — https://erpclimb.com/sap-tables/vbapA ERPClimb é uma plataforma independente e não é afiliada à SAP SE. As páginas de referência são escritas e revisadas por consultores SAP para aprendizado e solução de problemas.