rev1-2026-05-16 Protheus 12.1.33

Banco

CRUD do Cadastro de Bancos (tabela SA6) via rotina automática MATA070 (MsExecAuto). Padrão WSSE2 rev3 / WSSA2 rev28: single-record por request, payload plano, _list com delta-sync (cursor keyset), _byid?tipo=recno|msuid, _search por nome reduzido (typeahead). O identificador externo é a chave composta natural da SA6 com 3 partes: cod-agencia-conta. A6_COD é informado pelo cliente — bancos são cadastro curado, não há GetSXENum.

Bloqueio TOTVS: a SA6 não expõe MSBLQL/MSBLQD; bancos não têm fluxo de bloqueio administrativo. O DELETE só falha quando há saldo em SE5 ou títulos vinculados — neste caso, MATA070 devolve 422 com a mensagem do MSExecAuto.

Vinculação com o ERP

Tabela mestre SA6 Bancos (conta corrente por agência)

Rotina automática MATA070 MsExecAuto · Financeiro · SIGAFIN

Wrapper AdvPL U_MT070Exc src/lib/MAT/MT070EXC.prw

Operações & modos

POST modo 3 PUT modo 4 DEL modo 5

Dependências de ambiente

Identificador externo · obrigatório

Chave composta cod-agencia-conta

o trio A6_COD + A6_AGENCIA + A6_NUMCON é a chave de negócio. Sem GetSXENum — o cliente informa os três valores no path do POST.
Pattern: ^[^-]+-[^-]+-[^-]+$ (ex. 001-12345-0000012345).

Cadastro · sem fluxo de bloqueio

Sem MSBLQL/MSBLQD

a tabela SA6 não expõe os campos administrativos A6_MSBLQL/A6_MSBLQD nesta base — bancos são cadastro curado. Para "desativar" o uso, o operador exclui e re-inclui (ou opera diretamente na rotina nativa MATA070).

Integração bancária · opcional

A6_NRINTEG (código FEBRABAN)

campo de 3 dígitos identificando o banco para layouts CNAB/Open Banking. Pode disparar validações customizadas (X3_VALID) dependentes da parametrização do cliente.

Whitelist

CAMPOS_ALLOW_POST × CAMPOS_ALLOW_PUT

POST aceita 17 campos cadastrais (NREDUZ, NOME, endereço, DV, NRINTEG, agência/conta PIS/COB/AUT). PUT aceita apenas 8 — campos cadastrais sem impacto contábil (sem CGC, sem NRINTEG, sem agências secundárias). Campo fora do whitelist é silenciosamente ignorado pelo MsExecAuto.

Typeahead

A6_NREDUZ + COLLATE acento-insensitive

/_search?term=<prefix> usa cursor TCGenQry via U_RestSug com COLLATE Latin1_General_CI_AI (MSSQL) — busca por prefixo case+accent-insensitive sobre o nome reduzido. Default 10 sugestões, máx 25.

Quirk · build 240223P

Dispatcher único de GET

WSMETHOD GET com WSSYNTAX "/WsSA6/{path}" + dispatcher AdvPL (_list / _byid / _search / chave). O build não distingue múltiplos GET por WSSYNTAX, então a separação é feita pelo último segmento da URL.

Convenções

Identificador externo — chave composta. A chave é um único parâmetro {chave} com 3 partes separadas por hífen: cod-agencia-conta. Exemplo: 001-12345-0000012345. Pattern: ^[^-]+-[^-]+-[^-]+$. No POST a chave vem exclusivamente no path (não é gerada pelo servidor); no PUT/DELETE/GET, o path posiciona a SA6.

Whitelist por operação. POST aceita 17 campos cadastrais (BancoPayload); PUT aceita apenas 8 campos editáveis: A6_NREDUZ, A6_NOME, A6_END, A6_CIDADE, A6_EST, A6_CEP, A6_DV_AGE, A6_DVCTA (BancoPayloadPut). Campo fora do whitelist no PUT é silenciosamente ignorado — MATA070 não toca o registro. Para mudar cod/agencia/conta é preciso DELETE + POST com nova chave.

A6_COD informado pelo cliente. Diferente de SE2/SC7 que geram número via GetSXENum, bancos são cadastro curado — o operador escolhe o código (geralmente alinhado com FEBRABAN: 001 Banco do Brasil, 033 Santander, 237 Bradesco, 341 Itaú, etc). POST com chave já existente retorna 409.

Filial não trafega no array do MsExecAuto. O endpoint posiciona SA6 em xFilial("SA6") antes da chamada e MATA070 usa xFilial internamente. A6_FILIAL nunca é enviado no array.

Typeahead acento-insensitive. /_search?term=<prefix> usa cursor TCGenQry via helper U_RestSug com COLLATE Latin1_General_CI_AI (MSSQL) — busca por prefixo case+accent-insensitive sobre A6_NREDUZ. Default pageSize=10, máximo 25.

Paginação e delta-sync. /_list usa page/pageSize (default 50, máx 500) com orderBy=chave. Para sincronização incremental, alterne para orderBy=recno e use cursor conforme o nextCursor retornado. Em orderBy=chave, since filtra RecNo() < since.

Identificadores técnicos no GET. Cada resposta inclui recno (sempre). msuid/msuidt aparecem apenas quando o dicionário expõe A6_MSUID/A6_MSUIDT (depende de UPDDISTR de MVC). Filtragem via U_RestOpc.

Cadastro de Bancos (SA6)

CRUD por chave composta cod-agencia-conta — bancos curados sem geração automática

POST /WsSA6/INCLUIR/{chave} Inclui banco com chave composta no path

Descrição

Inclui um novo banco via MATA070 em modo 3 (MODEL_OPERATION_INSERT). A chave (cod-agencia-conta) é definida pelo cliente no path — não há geração automática de A6_COD. Mesma chave de um banco existente retorna 409.

A6_NREDUZ e A6_NOME são obrigatórios (validados pelo MATA070).
Campos opcionais: endereço, CEP, CGC, DV, NRINTEG, agências PIS/COB/AUT.
Whitelist completa: ver BancoPayload.

Path parameter

chave string · path · obrigatório SA6 (chave composta)

3 partes: cod-agencia-conta. Pattern: ^[^-]+-[^-]+-[^-]+$.

Request body

application/json BancoPayload · obrigatório

Payload plano sem campos-chave (path domina). Schema em BancoPayload.

A6_NREDUZ string · obrigatório

Nome reduzido (apelido para typeahead).

A6_NOME string · obrigatório

Razão social do banco.

A6_END string · opcional

Endereço da agência.

A6_CIDADE string · opcional

A6_EST string · opcional

A6_CEP string · opcional

Cenario 1 — Inclusao com dados completos (BB_TEST). Payload com nome reduzido + razão social + endereço + DV verificador + código FEBRABAN.

RequestHTTP/1.1 · application/json

POST https://erpapi.jetme.com.br/api/99/01/WsSA6/INCLUIR/999-99999-0099999999
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Content-Type: application/json
Accept: application/json

{
  "A6_NREDUZ": "BB_TEST",
  "A6_NOME":   "BANCO DO BRASIL TESTE",
  "A6_END":    "AV PRESIDENTE VARGAS 100",
  "A6_CIDADE": "RIO DE JANEIRO",
  "A6_EST":    "RJ",
  "A6_CEP":    "20000000",
  "A6_DV_AGE": "1",
  "A6_DVCTA":  "5",
  "A6_NRINTEG": "001"
}

Response · 201application/json

{
  "success": true,
  "message": "Banco incluido com sucesso.",
  "data": {
    "cod":     "999",
    "agencia": "99999",
    "conta":   "0099999999",
    "recno":   12345
  }
}

Respostas

201

Banco incluído. Envelope CrudResponse com data = BancoRef (chave resolvida + ids técnicos).

400

Body JSON ausente/inválido, chave composta com formato inválido (≠ 3 partes), A6_NREDUZ/A6_NOME vazios. Tier: validation-error.

409

Banco já existe na mesma chave cod/agencia/conta. Mensagem: "Banco ja existe nesta chave (cod/agencia/conta)." Tier: business-error.

422

Rejeição do MATA070 — validação X3_VALID de algum campo (ex. A6_NRINTEG com layout customizado). Mensagem editorial em message. Tier: business-error.

500

Erro interno (DbSeek, deserialização, exceção AdvPL).

PUT /WsSA6/ALTERAR/{chave} Altera dados não-chave do banco (MATA070 modo 4)

Descrição

Altera campos do banco via MATA070 em modo 4 (MODEL_OPERATION_UPDATE). Escopo reduzido: apenas 8 campos cadastrais sem impacto contábil entram no array do MsExecAuto:

A6_NREDUZ — nome reduzido (impacta typeahead)
A6_NOME — razão social
A6_END, A6_CIDADE, A6_EST, A6_CEP — endereço
A6_DV_AGE, A6_DVCTA — dígitos verificadores

Campo fora do whitelist é silenciosamente ignorado. Para alterar cod/agencia/conta, faça DELETE + POST com nova chave.

Path parameter

chave string · path · obrigatório SA6 (chave composta)

3 partes separadas por hífen.

Request body

application/json BancoPayloadPut · obrigatório

Subconjunto dos 8 campos editáveis. Schema em BancoPayloadPut.

A6_NREDUZ string · opcional

Novo nome reduzido (apelido).

A6_NOME string · opcional

Nova razão social.

Renomear (NREDUZ + NOME) — alteração trivial do par nome reduzido + razão social. Campos-chave do body são ignorados (path vence).

RequestHTTP/1.1 · application/json

PUT https://erpapi.jetme.com.br/api/99/01/WsSA6/ALTERAR/999-99999-0099999999
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Content-Type: application/json
Accept: application/json

{
  "A6_NREDUZ": "BB_REV",
  "A6_NOME":   "BANCO DO BRASIL REVISADO"
}

Respostas

200

Banco alterado. Envelope CrudResponse.

400

Chave composta ausente/inválida no path, body ausente, JSON malformado. Tier: validation-error.

404

Banco não localizado pela chave. Tier: not-found.

422

Rejeição do MATA070 — validação customizada via X3_VALID. Tier: business-error.

500

Erro interno.

DEL /WsSA6/EXCLUIR/{chave} Exclui banco (MATA070 modo 5)

Descrição

Exclui o banco via MATA070 em modo 5 (MODEL_OPERATION_DELETE). Pré-requisitos:

Banco sem saldo em movimento (SE5).
Sem títulos com E2_PORTADO/E1_PORTADO apontando para este banco.

Quando há vinculação ativa, MATA070 devolve 422 com a mensagem do MsExecAuto. Comportamento delegado integralmente à rotina nativa.

Path parameter

chave string · path · obrigatório SA6 (chave composta)

3 partes separadas por hífen.

Cenario

Exemplo da requisicao (cenario ativo)

Exclusao — via MATA070 modo 5. Quando há vinculação (SE5/títulos), retorna 422.

RequestHTTP/1.1 · sem body

DELETE https://erpapi.jetme.com.br/api/99/01/WsSA6/EXCLUIR/999-99999-0099999999
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Accept: application/json

Respostas

200

Banco excluído. Mensagem: "Banco excluido com sucesso."

400

Chave ausente/inválida. Tier: validation-error.

404

Banco não localizado. Tier: not-found.

422

Exclusão rejeitada — banco com movimento/títulos vinculados (mensagem do MATA070). Tier: business-error.

500

Erro interno.

GET /WsSA6/{chave} Consulta banco pela chave composta

Descrição

Retorna o banco posicionado pela chave composta (índice 1 da SA6: A6_FILIAL+A6_COD+A6_AGENCIA+A6_NUMCON). Cada parte é preenchida com PadR no TamSX3 correspondente antes do DbSeek. Aplica whitelist de CAMPOS_GET (cabeçalho da SA6 + ids técnicos).

Path parameter

chave string · path · obrigatório SA6 (chave composta)

3 partes separadas por hífen.

Cenario

Exemplo da requisicao (cenario ativo)

Consulta por chave composta — retorna envelope com data: Banco.

RequestHTTP/1.1 · sem body

GET https://erpapi.jetme.com.br/api/99/01/WsSA6/999-99999-0099999999
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Accept: application/json

Respostas

200

Banco encontrado. Envelope { success: true, data: Banco }.

400

Chave composta inválida (≠ 3 partes). Tier: validation-error.

404

Banco não localizado para a chave. Tier: not-found.

500

Erro interno.

GET /WsSA6/_byid Consulta banco por identificador técnico (recno|msuid)

Descrição

Busca o banco por id técnico — útil para integrações que persistem recno ou msuid e querem reconfirmar o registro sem decompor a chave de negócio em 3 partes.

Query parameters

tipo string · query · obrigatório

Qual id técnico está sendo usado.

recnomsuid

valor string · query · obrigatório

Inteiro positivo para tipo=recno, string para tipo=msuid.

Cenarios

Exemplo da requisicao (cenario ativo)

Busca por recno — id técnico sempre disponível.

RequestHTTP/1.1 · sem body

GET https://erpapi.jetme.com.br/api/99/01/WsSA6/_byid?tipo=recno&valor=12345
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Accept: application/json

Busca por msuid — requer A6_MSUID no dicionário (depende de UPDDISTR de MVC). Sem o campo, retorna 501.

RequestHTTP/1.1 · sem body

GET https://erpapi.jetme.com.br/api/99/01/WsSA6/_byid?tipo=msuid&valor=9f7a3e2c4b8d1a0e
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Accept: application/json

Respostas

200

Banco encontrado. Envelope { success: true, data: Banco }.

400

tipo/valor ausentes, tipo fora do enum, valor não numérico para recno.

404

Banco não localizado ou fora da filial corrente. Tier: not-found.

501

Busca por msuid requer campo A6_MSUID no dicionário.

500

Erro interno.

Listagem

Paginação por filtros, delta-sync e typeahead

GET /WsSA6/_list Lista bancos por filtros com paginação

Descrição

Lista bancos com filtros por cod, agencia, conta, nreduz em dois modos:

orderBy=chave (default) — usa o índice 1 da SA6; paginação por page/pageSize.
orderBy=recno — varre fisicamente (ordem 0); paginação por keyset com cursor/nextCursor. Indicado para sync incremental.

O filtro nreduz faz busca contains case-insensitive no nome reduzido — útil para localizar bancos por apelido.

Query parameters

cod string · query · opcional SA6.A6_COD

Código do banco (3 chars).

agencia string · query · opcional SA6.A6_AGENCIA

Número da agência (filtro exato após trim).

conta string · query · opcional SA6.A6_NUMCON

Número da conta corrente (filtro exato).

nreduz string · query · opcional SA6.A6_NREDUZ

Filtro contains case-insensitive no nome reduzido.

fields string · query · opcional

Lista de campos separados por vírgula. Validados contra CAMPOS_GET.

page integer · query · opcional

Página (default 1, mínimo 1). Só faz sentido com orderBy=chave.

pageSize integer · query · opcional

Tamanho da página (default 50, máx 500).

orderBy string · query · opcional

Modo de ordenação. Default chave.

chaverecno

since integer · query · opcional

Em orderBy=chave, descarta RecNo() < since.

cursor integer · query · opcional

Em orderBy=recno, retoma após este RecNo (vindo de nextCursor).

Cenarios

Exemplo da requisicao (cenario ativo)

Listagem paginada — default orderBy=chave, pageSize=50.

RequestHTTP/1.1 · sem body

GET https://erpapi.jetme.com.br/api/99/01/WsSA6/_list?page=1&pageSize=50
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Accept: application/json

Delta-sync — orderBy=recno + cursor retomavel via nextCursor retornado na pagina anterior. Indicado para sincronização incremental do consumer.

RequestHTTP/1.1 · sem body

GET https://erpapi.jetme.com.br/api/99/01/WsSA6/_list?orderBy=recno&cursor=0&pageSize=200
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Accept: application/json

Respostas

200

Página de bancos. Envelope com data (array de Banco), orderBy, pageSize, count, opcionalmente page ou nextCursor conforme o modo.

400

Parâmetro inválido (fields com campo fora do whitelist, pageSize > 500).

500

Erro interno.

GET /WsSA6/_search Typeahead por nome reduzido (LIKE prefix, acento-insensitive)

Descrição

Busca rápida sobre A6_NREDUZ usando cursor TCGenQry com COLLATE Latin1_General_CI_AI (acento+case-insensitive). Use para autocomplete em UIs que pedem ao operador escolher o banco para vincular num cadastro de fornecedor ou em uma conta corrente.

Query parameters

term string · query · obrigatório SA6.A6_NREDUZ

Prefixo do nome reduzido (mín. 1 char).

pageSize integer · query · opcional

Quantidade máxima de sugestões (default 10, máx 25).

Cenario

Exemplo da requisicao (cenario ativo)

Typeahead "BB" — retorna bancos cujo nome reduzido começa por "BB". Resposta inclui chave de negócio + nome + recno por sugestão.

RequestHTTP/1.1 · sem body

GET https://erpapi.jetme.com.br/api/99/01/WsSA6/_search?term=BB&pageSize=10
Authorization: Bearer eyJhbGciOiJIUzI1NiIs…
Accept: application/json

Respostas

200

Lista de sugestões. Envelope com data (array de objetos { cod, agencia, conta, nreduz, nome, recno }), count, term.

400

term ausente. Mensagem: "Parametro 'term' obrigatorio (busca por A6_NREDUZ)."

500

Erro interno (falha na execução TCGenQry, deadlock, etc).

Schemas

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

Banco

object

Representação retornada nos GETs (/{chave}, /_list, /_byid). Cabeçalho da SA6 + ids técnicos.

A6_FILIALstringSA6.A6_FILIAL

Filial do banco.

A6_CODstringSA6.A6_COD

Código do banco (3 chars, geralmente alinhado com FEBRABAN).

A6_AGENCIAstringSA6.A6_AGENCIA

Número da agência.

A6_NUMCONstringSA6.A6_NUMCON

Número da conta corrente.

A6_NREDUZstringSA6.A6_NREDUZ

Nome reduzido (apelido para typeahead, busca acento-insensitive).

A6_NOMEstringSA6.A6_NOME

Razão social do banco.

A6_ENDstringSA6.A6_END

Endereço da agência.

A6_CIDADEstringSA6.A6_CIDADE

Cidade.

A6_ESTstringSA6.A6_EST

UF (2 chars).

A6_CEPstringSA6.A6_CEP

CEP (8 chars, sem máscara).

A6_CGCstringSA6.A6_CGC

CNPJ da agência (14 chars, sem máscara).

A6_DV_AGEstringSA6.A6_DV_AGE

Dígito verificador da agência.

A6_DVCTAstringSA6.A6_DVCTA

Dígito verificador da conta.

A6_NRINTEGstringSA6.A6_NRINTEG

Código de integração bancária (FEBRABAN, 3 chars).

recnointeger

Id técnico do registro.

msuidstring

MS_UID, quando o dicionário expõe A6_MSUID.

msuidtstring

Timestamp técnico do MS_UID.

BancoPayload

object

Payload aceito em POST (whitelist CAMPOS_ALLOW_POST). Campos-chave (cod, agencia, conta) vêm exclusivamente do path — não precisam aparecer no body.

A6_NREDUZstring · obrigatórioSA6.A6_NREDUZ

Nome reduzido (apelido para typeahead, máx 15 chars).

A6_NOMEstring · obrigatórioSA6.A6_NOME

Razão social do banco (máx 30 chars).

A6_ENDstring · opcionalSA6.A6_END

Endereço da agência.

A6_CIDADEstring · opcionalSA6.A6_CIDADE

Cidade.

A6_ESTstring · opcionalSA6.A6_EST

UF.

A6_CEPstring · opcionalSA6.A6_CEP

CEP (8 chars, sem máscara).

A6_CGCstring · opcionalSA6.A6_CGC

CNPJ da agência (14 chars, sem máscara).

A6_DV_AGEstring · opcionalSA6.A6_DV_AGE

Dígito verificador da agência.

A6_DVCTAstring · opcionalSA6.A6_DVCTA

Dígito verificador da conta.

A6_NRINTEGstring · opcionalSA6.A6_NRINTEG

Código de integração bancária (FEBRABAN, 3 chars).

A6_BAIRROstring · opcionalSA6.A6_BAIRRO

Bairro.

A6_AG_PIS, A6_AG_COB, A6_AG_AUTstring · opcional

Agências adicionais (PIS, cobrança, automática).

A6_CTA_PIS, A6_CTA_COB, A6_CTA_AUTstring · opcional

Contas adicionais (PIS, cobrança, automática).

A6_CGCAGENstring · opcional

CGC do agente arrecadador (opcional).

BancoPayloadPut

object

Whitelist do PUT (CAMPOS_ALLOW_PUT) — somente 8 campos editáveis sem impacto contábil. Campo fora desta lista é silenciosamente ignorado.

A6_NREDUZstring · opcionalSA6.A6_NREDUZ

Novo nome reduzido.

A6_NOMEstring · opcionalSA6.A6_NOME

Nova razão social.

A6_ENDstring · opcionalSA6.A6_END

Endereço.

A6_CIDADEstring · opcionalSA6.A6_CIDADE

Cidade.

A6_ESTstring · opcionalSA6.A6_EST

UF.

A6_CEPstring · opcionalSA6.A6_CEP

CEP.

A6_DV_AGEstring · opcionalSA6.A6_DV_AGE

Dígito verificador da agência.

A6_DVCTAstring · opcionalSA6.A6_DVCTA

Dígito verificador da conta.

BancoRef

object

Referência leve à chave do banco — devolvida em data nas respostas de POST e PUT. Acrescenta ids técnicos.

codstring

Código do banco.

agenciastring

Agência.

contastring

Conta corrente.

recnointeger

RecNo do registro.

msuidstring

MS_UID quando o dicionário tem A6_MSUID.

msuidtstring

Timestamp do MS_UID.

CrudResponse

object · envelope

Envelope padrão de POST/PUT/DELETE. data traz BancoRef em POST/PUT, string vazia em DELETE.

successboolean · const: true

Sempre true em sucesso.

messagestring · obrigatório

Mensagem editorial.

datastring | BancoRef · opcional

Chave resolvida ou string vazia.

Erro

object · envelope

Envelope padrão de erros 4xx/5xx. Em 422 a message traz a mensagem do NomeAutoLog do MATA070.

successboolean · const: false

Sempre false em erros.

messagestring · obrigatório

Mensagem editorial do erro.

datastring · opcional

Token interno / detalhe técnico.

Cenários

Catálogo de combinações de payload/query reconhecidas pelos métodos. Cada cenário usa o mesmo schema mas demonstra um uso típico distinto. Tier semântico no slug; endpoint no type-pill.

incluir-banco-completo

POST /WsSA6/INCLUIR/{chave}

Inclusão de banco com dados cadastrais completos (nome reduzido + razão social + endereço + DV + código FEBRABAN). Chave imposta no path; A6_COD é cliente-driven (sem GetSXENum).

Quando usar: bootstrap de cadastro de bancos no provisionamento de filial nova, ou inclusão pontual de banco que ainda não foi cadastrado.

alterar-nome-banco

PUT /WsSA6/ALTERAR/{chave}

Altera A6_NREDUZ + A6_NOME (8 campos editáveis no whitelist) via MATA070 Op=4. Campos fora do whitelist são silenciosamente ignorados.

Quando usar: renomear banco após fusão/incorporação, ajustar nome reduzido para typeahead mais ergonômico, atualizar endereço da agência.

excluir-banco

DELETE /WsSA6/EXCLUIR/{chave}

Exclui banco via MATA070 Op=5. Comportamento delegado à rotina nativa — rejeita com 422 se houver saldo SE5 ou títulos vinculados (E2_PORTADO/E1_PORTADO).

Quando usar: banco curado por engano (chave errada), banco descontinuado sem movimento, limpeza de bancos de teste.

consulta-direta

GET /WsSA6/{chave}

DbSeek pelo índice 1 da SA6 (chave composta com PadR). Retorna envelope { success, data: Banco }.

busca-por-recno

GET /WsSA6/_byid

Busca por RecNo() via tipo=recno&valor=N. Identificador técnico sempre disponível.

busca-por-msuid

GET /WsSA6/_byid

Busca por A6_MSUID via tipo=msuid&valor=GUID. Requer o campo no dicionário (UPDDISTR de MVC). Sem o campo — retorna 501.

listar-paginado

GET /WsSA6/_list

Default orderBy=chave + page/pageSize. Paginação por offset sobre o índice 1 da SA6.

listar-delta-sync

GET /WsSA6/_list

orderBy=recno + cursor retomavel. Cada página devolve nextCursor para a próxima chamada.

Quando usar: sincronização incremental do consumer (Angular embarcado, integradores externos).

typeahead-nome

GET /WsSA6/_search

Cursor TCGenQry sobre A6_NREDUZ com COLLATE Latin1_General_CI_AI — busca por prefixo case+accent-insensitive. Default 10 sugestões.

Quando usar: autocomplete em UI de cadastro de fornecedor/título quando o operador precisa escolher o banco para vincular.

Pendências conhecidas (rev1)

Bloqueio MSBLQL/MSBLQD não aplicável. A tabela SA6 não expõe os campos administrativos A6_MSBLQL/A6_MSBLQD nesta base — bancos não têm fluxo de bloqueio TOTVS. Para "desativar" um banco em uso, o operador exclui e re-inclui (ou opera diretamente na rotina nativa MATA070). O padrão de bloqueio aplicado em SA1/SA2/SB1/SB5/SC1 não chega a este endpoint.

Sem geração automática de A6_COD. Diferente de SE2/SC7, o cadastro de bancos é curado — o operador informa o trio cod-agencia-conta no path. Não há GetSXENum; POST sem chave (ou com chave duplicada) retorna 400/409.

A6_NRINTEG com X3_VALID customizado. O código FEBRABAN (3 chars) pode disparar validações específicas do cliente (formato de layout CNAB/Open Banking). Se o ambiente tiver X3_VALID customizado em A6_NRINTEG, o POST pode retornar 422 com mensagem do dicionário — comportamento delegado integralmente ao MATA070.

DELETE bloqueado por movimento. Quando há saldo em SE5 (movimento bancário) ou títulos com E2_PORTADO/E1_PORTADO apontando para este banco, o MATA070 modo 5 rejeita com 422. A mensagem vem do NomeAutoLog da rotina — o endpoint apenas a propaga. Para casos terminais, purga física via DBA.