rev1-2026-05-16

RegraDesconto

CRUD de Regra de Desconto (cabeçalho ACO + itens ACP) via wrapper FATA080. Cabeçalho define vigência e tipo do desconto; itens listam produtos beneficiados com o percentual.

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

Vinculação com o ERP

CabeçalhoACORegra de Desconto

ItensACPProdutos da regra

Rotina automáticaFATA080MsExecAuto · op 3/4/5

Wrapper AdvPLU_FT080Excsrc/lib/MAT/FT080EXC.prw

Fonte RESTWsACO.prwsrc/api/RegraDesconto/

ChaveACO_CODREGGetSXENum no POST

Dependências

Cadastro

Produto (SB1)

ACP_CODPRO validado contra SB1 pelo FATA080.

Cadastro

Moeda (SM2)

ACO_MOEDA opcional; default da empresa.

Tabela

Tipo de hora (SX5 da empresa)

ACO_TPHORA + ACO_HORADE/ACO_HORATE definem janela horária da regra.

Convenções

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

Datas em ISO. ACO_DATDE/ACO_DATATE aceitam YYYY-MM-DD ou AAAAMMDD.

Whitelist. Cabeçalho: ACO_DESCRI, ACO_MOEDA, ACO_TPHORA, ACO_HORADE, ACO_HORATE, ACO_DATDE, ACO_DATATE, ACO_TIPDES, ACO_TIPO. Itens: ACP_CODPRO, ACP_PERDES.

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

Regra de Desconto — mutação

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

POST/WsACO/INCLUIR/000001Inclui regra — FATA080 op=3

Descrição

Inclui regra de desconto. Código ACO_CODREG é gerado pelo GetSXENum — path é placeholder.

Cenário

Request body

cabecalho.ACO_DESCRIstring · obrigatório

Descrição da regra.

cabecalho.ACO_DATDEstring (date) · obrigatório

Data inicial.

cabecalho.ACO_DATATEstring (date) · obrigatório

Data final.

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

Produto (SB1).

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

% desconto.

Período só. Regra geral aplicada a todos os produtos.

Request

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

{
  "cabecalho": {
    "ACO_DESCRI": "Black Friday 2026",
    "ACO_DATDE": "2026-11-24",
    "ACO_DATATE": "2026-11-30"
  }
}

Com produtos. 2 produtos com 15% e 20%.

Request

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

{
  "cabecalho": {
    "ACO_DESCRI": "Black Friday TVs",
    "ACO_DATDE": "2026-11-24",
    "ACO_DATATE": "2026-11-30"
  },
  "itens": [
    { "ACP_CODPRO": "P0001", "ACP_PERDES": 15.0 },
    { "ACP_CODPRO": "P0002", "ACP_PERDES": 20.0 }
  ]
}

Respostas

201

Criado. data.ACO_CODREG auto-gerado.

400

Payload inválido.

422

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

PUT/WsACO/ALTERAR/000001Altera regra — FATA080 op=4

Descrição

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

Cenário

Request body

cabecalho.ACO_DATATEstring (date) · opcional

Nova data final.

cabecalho.ACO_DESCRIstring · opcional

Nova descrição.

Estender data final.

Request

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

{
  "cabecalho": {
    "ACO_DATATE": "2026-12-05"
  }
}

Respostas

200

Alterado.

404

Não encontrada.

422

Erro FATA080.

DELETE/WsACO/EXCLUIR/000001Exclui regra — FATA080 op=5

Descrição

Exclui regra. Sem body.

Cenário

Exemplo

Request

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

Respostas

200

Excluída.

404

Não encontrada.

Consulta

Por código + listagem (sem typeahead).

GET/WsACO/000001Regra por código

Cenário

Exemplo

Request

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

Response 200

{
  "success": true,
  "data": {
    "cabecalho": {
      "ACO_CODREG": "000001",
      "ACO_DESCRI": "Black Friday 2026",
      "ACO_DATDE": "20261124",
      "ACO_DATATE": "20261130"
    },
    "itens": [
      { "ACP_ITEM": "01", "ACP_CODPRO": "P0001", "ACP_PERDES": 15.0 }
    ]
  }
}

GET/WsACO/_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/WsACO/_list?page=1&pageSize=25

Schemas

Componentes do contrato

RegraDescontoPayload

object

Cabeçalho + array de itens.

cabecalhoCabecalho

Ver Cabecalho.

itensarray[Item]

Ver Item.

Cabecalho

object · ACO

Cabeçalho. Whitelist CAMPOS_CAB_ALLOW.

ACO_DESCRIstringACO.ACO_DESCRI

Descrição.

ACO_TIPOstringACO.ACO_TIPO

Tipo de regra.

ACO_TIPDESstringACO.ACO_TIPDES

Tipo de desconto (% ou valor).

ACO_MOEDAstringACO.ACO_MOEDA

Moeda (SM2).

ACO_DATDE, ACO_DATATEstring (date)

Vigência.

ACO_TPHORA, ACO_HORADE, ACO_HORATEstring

Janela horária da regra.

Item

object · ACP

Produto beneficiado.

ACP_CODPROstring · obrigatório

Produto (SB1).

ACP_PERDESnumber · obrigatório

% desconto.

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 /WsACO/INCLUIR/{codigo}

Regra geral só com vigência.

cabecalho.{DESCRI,DATDE,DATATE}

Sem produtos = aplicável a todos.

incluir-com-produtos

POST /WsACO/INCLUIR/{codigo}

Vigência + 2 produtos com %.

itens[]

2 itens (P0001 15%, P0002 20%).

alterar

PUT /WsACO/ALTERAR/{codigo}

Estende ACO_DATATE.

cabecalho.ACO_DATATE

Nova data fim.

excluir

DELETE /WsACO/EXCLUIR/{codigo}

Sem body.

path.codigo

000001

consulta-byid

GET /WsACO/{codigo}

Cabeçalho + itens.

path.codigo

000001

listagem

GET /WsACO/_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.

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