Tabela EKKO — Tabela de Cabeçalho do Documento de Compras
EKKO armazena uma linha por cabeçalho de documento de compras, abrangendo pedidos de compras, contratos, acordos de remessa e solicitações de cotação. Ela contém fornecedor, organização de compras, tipo de documento, moeda, condições e status de liberação, mas não quantidades ou valores, que ficam no nível do item em EKPO.
EKKO é a tabela de cabeçalho por trás de todo documento de compras criado nas transações ME21N, ME31K, ME31L e transações relacionadas. Esta página aborda o que uma linha de cabeçalho realmente representa, como unir com itens e histórico, e as armadilhas de ler status e datas no nível do cabeçalho quando a resposta real reside em EKPO ou EKBE.
Publicado em 15 de set. de 2026· 980 palavras
O que ela armazena
Uma linha em EKKO é um cabeçalho de documento de compras, com chave por EBELN. O campo de tipo de documento BSART decide o que esse cabeçalho realmente é: um pedido de compra padrão, um contrato, um acordo de remessa, uma solicitação de cotação ou uma cotação, e o significado de vários outros campos muda dependendo desse tipo. O cabeçalho carrega fornecedor, organização de compras, grupo de compradores, moeda, condições de pagamento, incoterms, dados de criação e, onde um procedimento de liberação está ativo, o status geral de liberação. Ele não carrega quantidades, preços ou datas de entrega para itens individuais; esses pertencem a EKPO e EKET. Ele também não carrega histórico de recebimento de mercadorias ou fatura; isso é EKBE. Trate EKKO como o envelope, não o conteúdo.
Campos-chave
- MANDT - mandante
- EBELN - número do documento de compras, a chave de junção para quase todo o resto
- BSTYP - categoria do documento, distingue OC, SC, contrato, acordo de remessa em um nível mais amplo
- BSART - tipo de documento, por exemplo, OC padrão, contrato-quadro, controla a interpretação do campo e o layout da tela
- LIFNR - número do fornecedor para este documento
- EKORG - organização de compras
- EKGRP - grupo de compradores
- WAERS - moeda do documento
- ZTERM - chave das condições de pagamento
- INCO1 - incoterms parte 1
- AEDAT - data de criação do cabeçalho
- ERNAM - usuário que criou o documento
- LOEKZ - flag de eliminação no nível do cabeçalho
- FRGKE - indicador geral de liberação, significativo apenas quando uma estratégia de liberação está configurada
- KDATB, KDATE - início e fim da validade, preenchidos para contratos e acordos de remessa, em branco nos OCs padrão
Como se une ao modelo de dados
- EKKO-EBELN = EKPO-EBELN, cabeçalho para itens de linha, a junção usada para quase todos os relatórios de compras
- EKKO-EBELN = EKET-EBELN (via EKPO-EBELP = EKET-EBELP), cabeçalho para linhas de remessa
- EKKO-EBELN = EKBE-EBELN, cabeçalho para o histórico de recebimento de mercadorias e fatura
- EKKO-EBELN = EKKN-EBELN, cabeçalho para linhas de atribuição contábil
- EKKO-EBELN = EKPA-EBELN, cabeçalho para funções de parceiro como endereço de pedido ou recebedor de mercadorias
- EKKO-LIFNR = LFA1-LIFNR, pesquisa de mestre de fornecedores
- EKKO-EKGRP = T024-EKGRP, descrição do grupo de compradores
Como ler com segurança
MANDT restringe toda seleção primeiro, então EBELN é a chave natural se já for conhecida. Onde EBELN não é conhecida, restrinja por BSART e EKORG juntos antes de adicionar um intervalo de datas em AEDAT; selecionar apenas por LIFNR em um sistema grande é caro porque o fornecedor não é o componente de índice principal. Evite uma varredura completa da tabela filtrada apenas por FRGKE ou BSTYP, ambos são flags de baixa cardinalidade com baixa seletividade. Se a pergunta for sobre valor ou quantidade, não consulte EKKO, vá para EKPO ou EKBE e obtenha EBELN de lá.
Como provar nos dados
Sintoma: um comprador alega que um OC nunca foi liberado para verificações de bloqueio de pagamento. Selecione EKKO onde EBELN é igual ao número do documento e leia FRGKE. Um valor indicando liberação incompleta confirma que ele está preso na estratégia de liberação, não bloqueado a jusante. Faça uma verificação cruzada com o histórico de status de liberação na tabela de liberação associada se a estratégia usar várias etapas, já que FRGKE mostra apenas o estado agregado atual, não qual aprovador ainda está pendente.
ECC vs. S/4HANA
EKKO continua sendo a tabela de persistência primária para cabeçalhos de documentos de compras no S/4HANA; ela não foi substituída ou dividida como algumas tabelas FI foram. Aplicativos Fiori e relatórios analíticos leem dados de compras por meio de visões CDS construídas sobre EKKO e EKPO, mas a estrutura da tabela subjacente e os campos-chave descritos aqui permanecem inalterados para documentos de compras padrão. ABAP customizado escrito diretamente contra EKKO ainda funciona.
Armadilhas comuns
- Ler FRGKE como prova final de que um OC está totalmente liberado sem verificar se uma estratégia de liberação está configurada para aquele tipo de documento e valor; em tipos de documento sem uma estratégia, o campo simplesmente não é relevante
- Assumir que LOEKZ em branco significa que o documento está totalmente ativo; o flag de eliminação no nível do item em EKPO pode ser diferente do cabeçalho, um OC pode ter todos os itens eliminados enquanto a linha do cabeçalho sobrevive
- Tratar KDATB e KDATE como datas de entrega; elas são datas de validade de contrato ou acordo de remessa e estão em branco em pedidos de compras comuns, confundi-las com datas de EKET resulta em uma linha do tempo de entrega errada
- Esperar um valor total do pedido no cabeçalho; EKKO não possui campo de valor líquido, o valor precisa ser somado de EKPO, e fazer essa soma incorretamente em várias moedas sem verificar WAERS produz um total sem sentido
- Usar AEDAT como um proxy para quando o pedido foi realmente feito com o fornecedor comercialmente; é a data de criação do documento SAP, que pode atrasar ou anteceder o evento de negócios real, especialmente com a criação em massa a partir de requisições
- Assumir que apenas BSART conta a história completa na distinção entre acordo de remessa e contrato; BSTYP precisa ser verificado junto porque algumas configurações reutilizam códigos de tipo semelhantes entre categorias
De quem é esse problema
Um consultor funcional MM ou de compras é responsável por questões sobre o comportamento do tipo de documento, configuração da estratégia de liberação e significado dos campos de cabeçalho. Disputas sobre dados mestre de fornecedores são encaminhadas para a equipe de dados mestre ou de operações de compras. Questões de atribuição contábil ou objeto de custo em um cabeçalho específico pertencem conjuntamente a MM e FI/CO, já que a categoria de atribuição contábil definida no cabeçalho influencia o que EKKN permite no nível do item.
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/ekkoA 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.