rev1-2026-05-16

MetaVenda

CRUD de Meta de Venda (tabela SCT) via wrapper FATA050. Cabeçalho define descrição da meta; itens listam vendedores com quantidade e valor de meta.

Código auto-gerado. CT_DOC é gerado por GetSXENum no POST — o endpoint retorna o código gerado em data.CT_DOC. {codigo} no path do POST é placeholder (qualquer valor).

Vinculação com o ERP

CabeçalhoSCTMeta de Venda

ItensSCTMetas por vendedor

Rotina automáticaFATA050MsExecAuto · op 3/4/5

Wrapper AdvPLU_FT050Excsrc/lib/MAT/FT050EXC.prw

Fonte RESTWsSCT.prwsrc/api/MetaVenda/

ChaveCT_DOCGetSXENum no POST

Dependências

Cadastro

Vendedor (SA3)

CT_VEND validado contra SA3 pelo FATA050.

Convenções

Envelope canônico. { success, message, data }. POST retorna data.CT_DOC auto-gerado.

Datas em ISO. CT_DATDE/CT_DATATE aceitam YYYY-MM-DD ou AAAAMMDD.

Whitelist. Cabeçalho: CT_DESCRI. Itens: CT_VEND, CT_QUANT, CT_VALOR.

Sem typeahead. Endpoint expõe só _list + GET por código.

Meta de Venda — mutação

Inclusão / alteração / exclusão via FATA050.

POST/WsSCT/INCLUIR/000001Inclui regra — FATA050 op=3

Descrição

Inclui meta de venda. Código CT_DOC é gerado pelo GetSXENum — path é placeholder.

Cenário

Request body

cabecalho.CT_DESCRIstring · obrigatório

Descrição da meta.

itens[].CT_VENDstring · obrigatório p/ item

Código do vendedor (SA3).

itens[].CT_QUANTnumber

Quantidade meta.

itens[].CT_VALORnumber

Valor meta.

Cabeçalho só. Meta sem itens de vendedor.

Request

POST https://erpapi.jetme.com.br/api/99/01/WsSCT/INCLUIR/000001

{
  "cabecalho": {
    "CT_DESCRI": "Meta Q1 2026"
  }
}

Com vendedores. 2 vendedores com metas de valor.

Request

POST https://erpapi.jetme.com.br/api/99/01/WsSCT/INCLUIR/000001

{
  "cabecalho": {
    "CT_DESCRI": "Meta Vendedores Q1"
  },
  "itens": [
    { "CT_VEND": "V001", "CT_QUANT": 100, "CT_VALOR": 50000.00 },
    { "CT_VEND": "V002", "CT_QUANT": 80, "CT_VALOR": 40000.00 }
  ]
}

Respostas

201

Criado. data.CT_DOC auto-gerado.

400

Payload inválido.

422

Erro FATA050 (produto inválido, datas, sobreposição).

PUT/WsSCT/ALTERAR/000001Altera regra — FATA050 op=4

Descrição

Altera regra existente. Cabeçalho e itens opcionais. Itens via LINPOS + AUTDELETA como em PedidoVenda.

Cenário

Request body

cabecalho.CT_DESCRIstring · opcional

Nova descrição.

Alterar descrição.

Request

PUT https://erpapi.jetme.com.br/api/99/01/WsSCT/ALTERAR/000001

{
  "cabecalho": {
    "CT_DESCRI": "Meta Q1 Revisada"
  }
}

Respostas

200

Alterado.

404

Não encontrada.

422

Erro FATA050.

DELETE/WsSCT/EXCLUIR/000001Exclui regra — FATA050 op=5

Descrição

Exclui regra. Sem body.

Cenário

Exemplo

Request

DELETE https://erpapi.jetme.com.br/api/99/01/WsSCT/EXCLUIR/000001

Respostas

200

Excluída.

404

Não encontrada.

Consulta

Por código + listagem (sem typeahead).

GET/WsSCT/000001Regra por código

Cenário

Exemplo

Request

GET https://erpapi.jetme.com.br/api/99/01/WsSCT/000001

Response 200

{
  "success": true,
  "data": {
    "cabecalho": {
      "CT_DOC": "000001",
      "CT_DESCRI": "Meta Q1 2026"
    },
    "itens": [
      { "CT_SEQUEN": "01", "CT_VEND": "V001", "CT_QUANT": 100, "CT_VALOR": 50000.00 }
    ]
  }
}

GET/WsSCT/_listListagem paginada

Query parameters

page, pageSizeinteger

Paginação (default 1/50, max 500).

Cenário

Exemplo

Request

GET https://erpapi.jetme.com.br/api/99/01/WsSCT/_list?page=1&pageSize=25

Schemas

Componentes do contrato

MetaVendaPayload

object

Cabeçalho + array de itens.

cabecalhoCabecalho

Ver Cabecalho.

itensarray[Item]

Ver Item.

Cabecalho

object · SCT

Cabeçalho. Whitelist CAMPOS_CAB_ALLOW.

CT_DESCRIstringSCT.CT_DESCRI

Descrição da meta.

Item

object · SCT

Meta por vendedor.

CT_VENDstring · obrigatório

Código do vendedor (SA3).

CT_QUANTnumber

Quantidade meta.

CT_VALORnumber

Valor meta.

EnvelopeSucesso

object

Envelope canônico.

success/message/data

Padrão.

EnvelopeErro

object

success=false + message.

message

Causa.

Cenários

1-pra-1 com YAML.

incluir-periodo

POST /WsSCT/INCLUIR/{codigo}

Cabeçalho só, sem itens de vendedor.

cabecalho.CT_DESCRI

Só descrição obrigatória.

incluir-com-produtos

POST /WsSCT/INCLUIR/{codigo}

Cabeçalho + 2 itens de vendedor com meta.

itens[]

2 vendedores (V001 100un R$50k, V002 80un R$40k).

alterar

PUT /WsSCT/ALTERAR/{codigo}

Altera descrição da meta.

cabecalho.CT_DESCRI

Nova descrição.

excluir

DELETE /WsSCT/EXCLUIR/{codigo}

Sem body.

path.codigo

000001

consulta-byid

GET /WsSCT/{codigo}

Cabeçalho + itens.

path.codigo

000001

listagem

GET /WsSCT/_list

Primeira página.

page, pageSize

1, 25

Pendências conhecidas (rev2)

Sem typeahead. Não há GET /_search. Filtros via /_list com page/pageSize.

CT_DOC auto-gerado. Path no POST é placeholder; código real vem do GetSXENum e retorna em data.CT_DOC.