rev1-2026-05-16

Intermediador

CRUD do cadastro de Intermediador (A1U) via wrapper FATA760. Chave externa A1U_CODIGO no path. Suporta bloqueio TOTVS padrão (A1U_MSBLQL/A1U_MSBLQD) via helper U_C980Blq.

Bloqueio TOTVS: PUT em intermediador bloqueado (A1U_MSBLQL="1" ou A1U_MSBLQD < data-base) só aceita alterar os próprios campos A1U_MSBLQL/A1U_MSBLQD; qualquer outro campo retorna 422.

Vinculação com o ERP

Tabela mestreA1UIntermediadores

Rotina automáticaFATA760MsExecAuto · op 3/4/5

Wrapper AdvPLU_FT760MVCsrc/lib/MAT/FT760MVC.prw

Fonte RESTWsA1U.prwsrc/api/Intermediador/

Chave externaA1U_CODIGOno path · 6 chars

BloqueioA1U_MSBLQL/A1U_MSBLQDU_C980Blq

Dependências e índices

Índice 1

A1U_FILIAL+A1U_CODIGO

byid e listagem por código.

Índice 2

A1U_FILIAL+A1U_NOME

filtros por nome (typeahead via TCGenQry).

Validação

A1U_CGC (CPF/CNPJ)

X3_VALID nativo TOTVS; CGC inválido → 422.

Bloqueio

U_C980Blq(A1U)

checa A1U_MSBLQL=1 ou A1U_MSBLQD<dDataBase antes do PUT.

Convenções

Envelope canônico. { success, message, data }. POST/PUT retornam data.A1U_CODIGO.

Chave no path. POST/PUT/DELETE usam {intermediador} = A1U_CODIGO (max 6 chars).

Bloqueio MSBLQL/MSBLQD. PUT em intermediador bloqueado: só aceita os próprios campos do par bloqueio; outros → 422. Desbloqueio aceito por flag (A1U_MSBLQL="2") ou data futura/vazia.

Whitelist de campos. Payload aceita A1U_NOME, A1U_CGC, A1U_EMAIL, A1U_TEL, A1U_END, A1U_BAIRRO, A1U_MUN, A1U_EST, A1U_CEP, A1U_MSBLQL, A1U_MSBLQD. Demais ignorados.

A1U_MSBLQD é Date. ISO YYYY-MM-DD ou vazia. Fica fora do CAMPOS_GET até U_RestMonta suportar Date-aware (transversal).

Intermediador — mutação

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

POST/WsA1U/INCLUIR/000001Inclui intermediador — FATA760 op=3

Descrição

Inclui intermediador em A1U. {intermediador} = A1U_CODIGO único; duplicidade → 409. A1U_CGC validado por X3_VALID.

Path parameter

intermediadorstring · max 6 · obrigatório

Código (A1U_CODIGO).

Cenário

Request body

A1U_NOMEstring · obrigatório

Nome completo.

A1U_CGCstring · opcional

CPF/CNPJ — X3_VALID.

A1U_EMAILstring · opcional

Email.

A1U_TELstring · opcional

Telefone.

Mínimo. Só A1U_NOME.

Request

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

{
  "A1U_NOME": "Marketplace XYZ"
}

Completo. Com CGC, email e telefone.

Request

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

{
  "A1U_NOME": "Marketplace XYZ",
  "A1U_CGC": "12345678901",
  "A1U_EMAIL": "contato@mktxyz.com",
  "A1U_TEL": "11912345678"
}

Respostas

201

Criado. data.A1U_CODIGO.

400

Código/payload inválido.

409

Já cadastrado.

422

Erro FATA760 (CGC inválido etc).

PUT/WsA1U/ALTERAR/000001Altera intermediador — FATA760 op=4

Descrição

Altera intermediador. Bloqueio TOTVS: intermediador bloqueado só aceita PUT em A1U_MSBLQL/A1U_MSBLQD; outros campos → 422.

Cenário

Request body

A1U_NOMEstring · opcional

Novo nome.

A1U_EMAILstring · opcional

Novo email.

A1U_TELstring · opcional

Novo telefone.

A1U_MSBLQLstring ("1"/"2") · opcional

1=bloqueado, 2=ativo.

A1U_MSBLQDstring (date) · opcional

Data ISO; bloqueio quando dDataBase > A1U_MSBLQD.

Alterar dados comuns.

Request

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

{
  "A1U_EMAIL": "joao@nova.com",
  "A1U_EMAIL": "novo@mktxyz.com"
}

Bloquear. A1U_MSBLQL=1 + data.

Request

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

{
  "A1U_MSBLQL": "1",
  "A1U_MSBLQD": "2026-05-17"
}

Desbloquear. Único campo permitido em bloqueado.

Request

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

{
  "A1U_MSBLQL": "2"
}

Respostas

200

Alterado.

404

Não encontrado.

422

Bloqueado + payload toca campo fora do par MSBLQL/MSBLQD, ou erro FATA760.

DELETE/WsA1U/EXCLUIR/000001Exclui intermediador — FATA760 op=5

Descrição

DELETE via FATA760 op=5. Falha (422) quando referenciado em SC5/SC6 etc.

Cenário

Exemplo

Request

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

Respostas

200

Excluído.

404

Não encontrado.

422

Em uso.

Consulta

Consulta por código, listagem e typeahead.

GET/WsA1U/000001Intermediador por código

Descrição

Retorna campos do whitelist CAMPOS_GET.

Cenário

Exemplo

Request

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

Response 200

{
  "success": true,
  "data": {
    "A1U_CODIGO": "000001",
    "A1U_NOME": "Marketplace XYZ",
    
    
    "A1U_MSBLQL": "2"
  }
}

GET/WsA1U/_listListagem paginada

Query parameters

codstring · opcional

Prefixo A1U_CODIGO.

nomestring · opcional

Prefixo A1U_NOME.

pageinteger · default 1

Página.

pageSizeinteger · default 50, max 500

Tamanho.

Cenário

Exemplo

Request

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

GET/WsA1U/_searchTypeahead por nome

Descrição

TCGenQry A1U_NOME COLLATE Latin1_General_CI_AI LIKE q% — acento-insensitive. Mín 2, limit 10/25.

Query parameters

qstring · min 2 · obrigatório

Prefixo do nome.

limitinteger · default 10, max 25

Limite.

Cenário

Exemplo

Request

GET https://erpapi.jetme.com.br/api/99/01/WsA1U/_search?q=JOA&limit=5

Schemas

Componentes do contrato OpenAPI

IntermediadorPayload

object

Payload plano de POST/PUT. Whitelist CAMPOS_ALLOW.

A1U_NOMEstring · obrigatório (POST)A1U.A1U_NOME

Nome completo (40 chars).

A1U_CGCstring · opcionalA1U.A1U_CGC

CPF/CNPJ — X3_VALID.

A1U_EMAIL, A1U_TELstring · opcional

Contato.

A1U_END, A1U_BAIRRO, A1U_MUN, A1U_EST, A1U_CEPstring · opcional

Endereço.

A1U_MSBLQLstring · opcionalA1U.A1U_MSBLQL

1=bloqueado, 2=ativo.

A1U_MSBLQDstring (date) · opcionalA1U.A1U_MSBLQD

Data ISO.

Intermediador

object · A1U

Intermediador retornado pelo GET (CAMPOS_GET). A1U_MSBLQD não entra (Date pendente).

A1U_CODIGO + campos do IntermediadorPayload exceto A1U_MSBLQD

A1U_CODIGO é a chave; demais seguem o payload.

EnvelopeSucesso

object · envelope

Envelope canônico.

success

true.

message

Texto.

data

{ A1U_CODIGO } em POST/PUT, dados completos em GET.

EnvelopeErro

object · envelope

success=false + message. Quando bloqueio TOTVS dispara: "Registro bloqueado a partir de DD/MM/YYYY (A1U_MSBLQD)".

message

Causa.

Cenários

1-pra-1 com examples: do YAML.

incluir-minimo

POST /WsA1U/INCLUIR/{intermediador}

Mínimo viável — só A1U_NOME.

A1U_NOME

"Marketplace XYZ"

incluir-completo

POST /WsA1U/INCLUIR/{intermediador}

Com CGC e email.

A1U_NOME, A1U_CGC, A1U_EMAIL, A1U_TEL

PF completo.

alterar-dados

PUT /WsA1U/ALTERAR/{intermediador}

Edita email/telefone de intermediador não bloqueado.

A1U_EMAIL

Atualização.

bloquear

PUT /WsA1U/ALTERAR/{intermediador}

A1U_MSBLQL=1 + data.

A1U_MSBLQL=1, A1U_MSBLQD=2026-05-17

Bloqueia.

desbloquear

PUT /WsA1U/ALTERAR/{intermediador}

A1U_MSBLQL=2 — único campo permitido em bloqueado.

A1U_MSBLQL=2

Reativa.

excluir

DELETE /WsA1U/EXCLUIR/{intermediador}

DELETE sem body. Falha quando referenciado em SC5.

path.intermediador

A1U_CODIGO sem referências.

consulta-byid

GET /WsA1U/{intermediador}

Intermediador 000001.

path.intermediador

000001

listagem

GET /WsA1U/_list

Intermediadores com nome "JOA", pag 25.

nome / pageSize

"JOA" / 25

typeahead

GET /WsA1U/_search

Sugestões para "JOA" — acento-insensitive.

q / limit

"JOA" / 5

Pendências conhecidas (rev2)

A1U_MSBLQD fora do CAMPOS_GET. U_RestMonta não tem serialização Date-aware. A1U_MSBLQD entra no PUT, não no retorno. Transversal.

Hierarquia (A1U_GEREN, A1U_SUPER). Não estão no whitelist. Adicionar quando precisar.