ChequesTitulos

Identificador externo — RecNo. Diferente de SE2/SA6, a chave natural da SEU para cheques não foi detalhada na TDN. Logo, PUT/DELETE/GET por path usam o recno físico (inteiro positivo). A criação devolve o recno no data da resposta — o consumer persiste esse valor para operações subsequentes.

Cheque sobre título (oper=2) × Cheque avulso (oper=3). O modo da operação é selecionado pelo campo oper no body. Quando omitido, o servidor escolhe 2 se AUTVENCINI/AUTVENCFIM vierem preenchidos; 3 caso contrário. oper=2 aplica o cheque sobre títulos em aberto cuja data de vencimento cai na faixa AUTVENCINI..AUTVENCFIM.

AUTCHEQUE vence o body quando vem no path. O endpoint expõe POST /INCLUIR/{cheque} para forçar o número do cheque (ex. talão pré-impresso). Quando o path traz {cheque}, o AUTCHEQUE do body é ignorado — path domina. Para deixar o servidor gerar via SX5 do banco, use POST /INCLUIR sem {cheque}.

Whitelist AUT* (FINA390). A interface oficial da rotina automática usa prefixo AUT*: AUTBANCO, AUTAGENCIA, AUTCONTA, AUTCHEQUE, AUTVENCINI, AUTVENCFIM, AUTVALOR, AUTFORN, AUTBENEF, AUTNATUREZA. Campos fora do whitelist são silenciosamente ignorados.

PUT reexecuta o wrapper FINA390. Como a rotina não expõe operação de "alteração" explícita, o PUT reaplica nOper=2/3 com os campos do body sobre o cheque posicionado por RecNo. Campos omitidos no body herdam o valor atual do registro (para AUTCHEQUE a herança é automática — ver código do fProcPut).

DELETE faz DbDelete físico. Diferente do soft-delete TOTVS (D_E_L_E_T_='*') que mantém slot do índice ocupado, este endpoint remove o registro fisicamente via RecLock + DbDelete. Útil para limpar cheques de teste sem precisar de purga DBA.

Datas de vencimento (oper=2). AUTVENCINI e AUTVENCFIM aceitam string YYYYMMDD (8 dígitos, sem separadores). A conversão interna usa SToD(AllTrim(valor)). Para oper=3, essas chaves são ignoradas.

Paginação. /_list usa page/pageSize (default 50, máx 500) em modo natural (RecNo asc) ou orderBy=recno com cursor para sync incremental keyset.

Tabela SEU compartilhada com MovimentoCaixinha. O endpoint não filtra registros por EU_TIPO no _list — o consumer pode receber linhas que pertencem ao endpoint MovimentoCaixinha. Pior: PUT/DELETE por RecNo não verificam tipo, podendo modificar registro de caixinha por engano. Roadmap: adicionar filtro WHERE EU_TIPO IN (...cheque) no _list e validação pré-operação em PUT/DELETE.

Chave natural da SEU não detalhada na TDN. Por isso o endpoint usa recno em todos os paths de CRUD (PUT/DELETE/GET). Quando a chave natural for documentada, considerar migrar para um path mais semântico (ex. banco-agencia-conta-cheque).

Bloqueio MSBLQL/MSBLQD não aplicável. A tabela SEU não expõe os campos administrativos de bloqueio — o que conta é o estado do fornecedor (SA2.A2_MSBLQL) e do banco (não bloqueável neste modelo). O FINA390 enforça bloqueios indiretos.

PUT reaplica nOper — pode duplicar efeitos. Como o endpoint reexecuta FINA390 com nOper=2/3 em vez de uma operação de "alteração" propriamente dita, há risco de side-effects acumulativos em alguns ambientes (lançamentos contábeis duplicados, baixas reaplicadas). Validar comportamento em ambiente de homologação antes de habilitar PUT em produção.

DELETE não-FINA390. A exclusão é via RecLock + DbDelete direto. Isso evita as restrições internas que o FINA390 colocaria, mas não dispara hooks/triggers que pudessem estornar lançamentos contábeis derivados. Aceitável para limpeza de smoke tests; em produção, considerar fluxo manual para garantir consistência.

Sem filtro por status / data no _list. A listagem não expõe filtro por EU_STATUS nem por data de emissão. Consumer aplica filtro pós-resposta. Próxima revisão considera adicionar query params dedicados.