CadastroProduto

Identificador externo. A chave externa é o próprio B1_COD (passado no path como {produto}), igual ao formulário padrão do Protheus. Tamanho máximo conforme TamSX3("B1_COD") (tipicamente 15 caracteres). Não há geração automática de código — conflito de chave em POST devolve 409 sem retry.

Tabela sem loja. Diferente de SA1/SA2, a SB1 não tem campo de loja. O índice 1 é B1_FILIAL+B1_COD e o índice 2 é B1_FILIAL+B1_DESC — toda busca por descrição passa pelo índice 2 com prefix normalizado (sem acento, uppercase) via U_NoAcento.

Whitelist conservador. O allowlist (CAMPOS_ALLOW) cobre apenas os campos básicos do MATA010: B1_DESC, B1_TIPO, B1_UM, B1_LOCPAD, B1_GRUPO, B1_POSIPI, B1_ORIGEM, B1_RASTRO e o par B1_MSBLQL/B1_MSBLQD. Campos custom (B1_X*) ficam fora da biblioteca; entram em projeto cliente. Campos no payload fora do allowlist são silenciosamente descartados pelo parser.

Bloqueio TOTVS. A rev3 incorporou o padrão B1_MSBLQL/B1_MSBLQD via U_C980Blq. Em produto bloqueado, o PUT só aceita campos do par de bloqueio (caminho de desbloqueio); qualquer outro campo no payload retorna 422 com o motivo. B1_MSBLQD é parseado a partir de string ISO YYYY-MM-DD. O campo ainda não entra em CAMPOS_GET enquanto U_RestMontaRegistro não suportar serialização Date-aware (tarefa transversal, fora do escopo deste endpoint).

Sem id técnico universal. Esta versão não expõe rota /_byid. Ids técnicos como recno ou B1_MSUID não fazem parte do contrato — o cliente referencia produto sempre pelo B1_COD.

Paginação. /_list usa page/pageSize com default 50 e máximo 500. Não há delta-sync por recno nesta revisão — a sincronização incremental, quando necessária, é implementada do lado consumidor a partir do B1_COD (ordenação estável pela chave do índice 1).