Protheus / MovimentoBancario rev1-2026-05-16 · https://erpapi.jetme.com.br/api/99/01 Empresa 99 · Filial 01
rev1-2026-05-16 Protheus 12.1.33

MovimentoBancario (SE5)

CRUD do Movimento Bancário (tabela SE5) via rotina automática FINA100 (MsExecAuto). Cobre pagamentos (modo 3), recebimentos (modo 4), exclusão física (modo 5) e cancelamento (modo 6 -- preserva o registro com flag). A chave natural da SE5 tem 13 partes (filial+data+banco+agencia+conta+documen+tipodoc+tipo+clifor+loja+prefixo+numero+parcela), o que torna inviável um path REST por chave de negócio: o acesso individual canônico é via _byid?tipoid=recno&valor=N.

PUT não suportado. O FINA100 não expõe nOper de alteração no caminho oficial. A rota PUT /WsSE5/ALTERAR/{recno} retorna 405 com guidance: para alterar movimento existente faça DELETE (modo 5 ou 6) + POST com os valores ajustados.
Tabela mestre SE5 Movimento Bancário (extrato)
Rotina automática FINA100 MsExecAuto · Financeiro
Wrapper AdvPL U_FN100Exc src/lib/FIN/FN100EXC.prw
Operações & modos
POST modo 3/4 PUT 405 DEL modo 5/6
Dependências de ambiente
Cadastro · obrigatório
Conta bancária (SA6)
o trio E5_BANCO+E5_AGENCIA+E5_CONTA precisa existir e estar ativo em SA6.
Sem a conta, o FINA100 rejeita com "Conta nao localizada".
Cadastro · condicional
Cliente / Fornecedor (SA1/SA2)
quando o movimento referencia uma entidade (E5_CLIFOR+E5_LOJA), o par precisa existir em SA1 (recebimento) ou SA2 (pagamento) e não pode estar bloqueado.
Cadastro · condicional
Natureza financeira (SED)
quando E5_NATUREZ é informada, o código precisa existir em SED.
Vínculo · opcional
Título financeiro (SE1/SE2)
quando o movimento corresponde à baixa de um título, os campos E5_PREFIXO+E5_NUMERO+E5_PARCELA+E5_TIPO+E5_CLIFOR+E5_LOJA devem espelhar a chave do título existente.
Quirk · chave SE5
Chave natural com 13 partes
expor a chave em path REST é impraticável; o endpoint usa recno como path param em PUT/DELETE e _byid?tipoid=recno&valor=N para acesso individual. GET sem _list/_byid/_search retorna 501 com mensagem explícita.
Quirk · build 240223P
WSDATA dataref (não data)
o nome data é reservado no HTTPREST e causa 500 silencioso. O endpoint expõe o filtro de data como ?dataref=YYYY-MM-DD.
Quirk · FINA100
Operações 7/8/9 fora de escopo
transferência (7), estorno de transferência (8) e classificação (9) exigem semântica própria e não são cobertas por este endpoint — devem ser expostas em endpoints dedicados sob demanda.
Quirk · build 240223P
Dispatcher único de GET
WSMETHOD GET com WSSYNTAX "/WsSE5/{path}" + dispatcher AdvPL (_list / _byid / _search). O build não distingue múltiplos GET por WSSYNTAX — a separação é feita no AdvPL pelo último segmento da URL.

MovimentoBancario

CRUD por RecNo — pagamento, recebimento, exclusão e cancelamento

Listagem

Paginação por filtros + delta-sync

Schemas

Definições canônicas — campos com origem SX3 rastreável

Cenários

Catálogo de combinações reconhecidas. Tier semântico no slug; endpoint no type-pill.