Especialistas em TOTVS Protheus, BI e Automação de Processos
Dicionário Protheus · SX2

Tabela SW9 no Protheus

Capa de Invoices

A tabela SW9 do Protheus está descrita no dicionário (SX2) como “Capa de Invoices”. Possui 32 campos e 3 índices. Abaixo estão tipo, tamanho e descrição de cada campo, os índices e um exemplo de consulta SQL.

Propriedades da tabela

Código
SW9
Nome
Capa de Invoices
Nome (inglês)
Invoices Cover
Compartilhamento por filial
Exclusivo
Compartilhamento por unidade
Exclusivo
Compartilhamento por empresa
Exclusivo
Campos / índices
32 / 3

Campos da tabela SW9 (32)

OrdemCampoTipoTam.Dec.TítuloDescriçãoContexto
01 W9_FILIAL C 2 0 Filial Filial do Sistema Real
02 W9_INVOICE C 20 0 Invoice Invoice Real
03 W9_DT_EMIS D 8 0 Emissao Emissão Real
04 W9_HAWB C 20 0 Processo Processo Real
05 W9_FORN C 6 0 Fornecedor Fornecedor Real
06 W9_FORLOJ C 2 0 Loja Fo. Loja Fo. Real
07 W9_NOM_FOR C 20 0 Nome Fornec. Nome Fornec. Real
08 W9_MOE_FOB C 3 0 Moeda Moeda Real
09 W9_FOB_TOT N 14 2 Preço Itens Preço Itens Real
10 W9_INCOTER C 3 0 Incoterm Incoterm Real
11 W9_TX_FOB N 15 8 Taxa Reais Taxa Reais Real
12 W9_NUM C 9 0 Nro.Titulo Numero do Titulo Real
13 W9_DTLANC D 8 0 Dt. Lancam. Data Lancamento Comtabil Real
14 W9_COND_PA C 5 0 Condicao Pag Condicao de Pagamento Real
15 W9_DIAS_PA N 3 0 Dias Pagto. Dias de Pagamento Real
16 W9_RAT_POR C 1 0 Rateado Por Rateado Por Real
17 W9_FREINC C 1 0 Frete Incl. Frete Incluso Real
18 W9_SEGINC C 1 0 Seguro Incl. Seguro Incluso Real
19 W9_SEGURO N 14 2 Seguro Valor do Seguro Real
20 W9_FRETEIN N 14 2 Int'l Freigh Int'l Freight Real
21 W9_INLAND N 14 2 Inland Charg Inland Charges Real
22 W9_PACKING N 14 2 Packing Char Packing Charges Real
23 W9_OUTDESP N 14 2 Outr. Desp. Outras Despesas Real
24 W9_DESCONT N 14 2 Desconto Desconto Real
25 W9_TUDO_OK C 1 0 Invoice OK Invoice OK Real
26 W9_FORNECC C 6 0 Forn. Com. Fornecedor da Comissão Real
27 W9_LOJAC C 2 0 Loja Loja Real
28 W9_COMPV C 1 0 Tp. Vl. Com. Tipo do Valor da Comissao Real
29 W9_PERCOM N 6 2 Comissao % Comissao Siscomex % Real
30 W9_VALCOM N 14 2 Vl. Comissao Valor da comissao Real
31 W9_TIPOCOM C 1 0 Tp. Comissao Tipo da Comissao Real
32 W9_RATFRT C 1 0 Rateia Frete Rateia Frete Para Itens Virtual

Tipo: C = caractere, N = numérico, D = data, L = lógico, M = memo.

Índices da tabela SW9 (3)

OrdemChaveDescriçãoApelido
1W9_FILIAL+W9_INVOICE+W9_FORN+W9_FORLOJ+W9_HAWBInvoice + Fornecedor + Loja Fo. + Processo
2W9_FILIAL+W9_FORN+W9_FORLOJFornecedor + Loja Fo.
3W9_FILIAL+W9_HAWBProcesso

Perguntas frequentes sobre a tabela SW9

O que é a tabela SW9?

É a tabela “Capa de Invoices” do ERP TOTVS Protheus, com 32 campos definidos no dicionário SX3.

Quais são os índices da tabela SW9?

A tabela tem 3 índices. O principal (ordem 1) usa a chave W9_FILIAL+W9_INVOICE+W9_FORN+W9_FORLOJ+W9_HAWB.

Qual é o nome físico da tabela SW9 no banco de dados?

No banco, o nome é o código da tabela seguido do código da empresa (no dicionário de referência desta consulta: SW9990). Em ADVPL, use RetSqlName("SW9") para obter o nome correto do ambiente.

Exemplo de consulta SQL da tabela SW9

Modelo gerado a partir da estrutura da tabela. Ajuste os filtros ao seu cenário.

SELECT
    W9_FILIAL,
    W9_INVOICE,
    W9_DT_EMIS,
    W9_HAWB,
    W9_FORN,
    W9_FORLOJ,
    W9_NOM_FOR,
    W9_MOE_FOB,
    W9_FOB_TOT,
    W9_INCOTER,
    W9_TX_FOB,
    W9_NUM,
    W9_DTLANC,
    W9_COND_PA,
    W9_DIAS_PA,
    W9_RAT_POR,
    W9_FREINC,
    W9_SEGINC,
    W9_SEGURO,
    W9_FRETEIN,
    W9_INLAND,
    W9_PACKING,
    W9_OUTDESP,
    W9_DESCONT,
    W9_TUDO_OK,
    W9_FORNECC,
    W9_LOJAC,
    W9_COMPV,
    W9_PERCOM,
    W9_VALCOM,
    W9_TIPOCOM,
    W9_RATFRT
FROM SW9
WHERE
    D_E_L_E_T_ = ' '
    AND W9_FILIAL = 'VALOR'
    AND W9_INVOICE = 'VALOR'
    AND W9_DT_EMIS BETWEEN '20261101' AND '20261130'
    AND W9_HAWB = 'VALOR'
    AND W9_FORN = 'VALOR'
    AND W9_FORLOJ = 'VALOR'
    AND W9_NOM_FOR = 'VALOR'
    AND W9_MOE_FOB = 'VALOR'
    AND W9_FOB_TOT = 0
    AND W9_INCOTER = 'VALOR'
    AND W9_TX_FOB = 0
    AND W9_NUM = 'VALOR'
    AND W9_DTLANC BETWEEN '20261101' AND '20261130'
    AND W9_COND_PA = 'VALOR'
    AND W9_DIAS_PA = 0
    AND W9_RAT_POR = 'VALOR'
    AND W9_FREINC = 'VALOR'
    AND W9_SEGINC = 'VALOR'
    AND W9_SEGURO = 0
    AND W9_FRETEIN = 0
    AND W9_INLAND = 0
    AND W9_PACKING = 0
    AND W9_OUTDESP = 0
    AND W9_DESCONT = 0
    AND W9_TUDO_OK = 'VALOR'
    AND W9_FORNECC = 'VALOR'
    AND W9_LOJAC = 'VALOR'
    AND W9_COMPV = 'VALOR'
    AND W9_PERCOM = 0
    AND W9_VALCOM = 0
    AND W9_TIPOCOM = 'VALOR'
    AND W9_RATFRT = 'VALOR'

Outras tabelas relacionadas

Dicionário Protheus · atualizado em 13/10/2026. Voltar ao índice do dicionário.