Quem ja trabalhou com Protheus sabe: documentacao oficial existe mas e dispersa, inconsistente, e em portugues formal demais. O TDN tem milhares de paginas mas encontrar a pegadinha de um RecLock sem MsUnlock exige Google + Slack + experiencia acumulada de anos.
Em 13/05/2026, o catalogo /docs da ArchTec cruzou a marca de 438 entradas curadas em portugues direto. Nao e copia de TDN. Nao e gerado por IA solta. E curadoria com foco no que dev Protheus realmente usa — incluindo o que ninguem escreve, como as pegadinhas, anti-padroes, e cross-links semanticos entre conceitos relacionados.
O que ha no catalogo agora
| Categoria | Docs | Foco |
|---|---|---|
| Funcoes AdvPL | 112 | arrays, datas, strings, tabelas, framework, IO, crypto — tudo do dia-a-dia |
| Pontos de Entrada | 184 | Faturamento, Compras, Estoque, RH, e modulos especializados: TMS, GCT, PLS (saude), Agro, WMS, Manutencao |
| Funcoes TLPP | 59 | OO moderno, REST decorators, async/await, security (JWT, AES), observabilidade (metric/trace), reactive |
| Tutoriais | 38 | NFe via TSS, SPED Bloco K, LGPD, Reforma Tributaria 2026, cluster, hot patch, performance, testes |
| Tabelas Protheus | 30 | SA1, SE1, SC5, SB1, SX3, SM0... + relacoes + indices |
| Curiosidades | 15 | Por que campos comecam com Z? Origem do SX*. Por que 3 boletos diferentes? |
O que torna diferente do TDN
1. Pegadinhas em vez de placeholder
O TDN tipico de uma funcao diz "DBSeek — busca por chave no indice". Util? Sim. Suficiente? Nao.
Em /docs/advpl/tabelas/dbseek, voce ve:
- A funcao em uma frase
- Sintaxe com tipos
- 2-3 exemplos copy-paste-friendly
- Pegadinhas: indice 1 nem sempre eh a chave principal,
xFilialobrigatorio,PadR(cCod, TamSx3()[1])pra dimensionar chave - Cross-links pra
Posicione,RecLock,xFilial
2. Pontos de Entrada que ninguem cataloga
Procure no Google: "PE GFEA050 SIGATMS". Quase nao tem nada. SIGATMS, SIGAPLS, SIGAGAA — modulos especializados que cobrem 20-30% das customizacoes em verticais (logistica, saude, agro) tem documentacao de PE quase inexistente em portugues.
O /docs/pe da ArchTec tem agora:
- 8 PEs do TMS — GFEA050 (cargas), GFE040 (ocorrencias), GFE140 (CTe), GFE910 (MDFe)
- 6 PEs do GCT — CN100INC (inclusao contrato), CTRA040 (medicao)
- 6 PEs do PLS (Saude) — PLSA092 (autorizacao procedimento), PLSA200 (faturamento)
- 6 PEs do Agro — AGRA040 (operacao agricola), AGRA050 (safra), AGRA060 (aplicacao defensivos)
- 5 PEs do WMS — WMSA005 (separacao), WMSCONF (conferencia), WMSA010 (enderecamento)
- 5 PEs do MNT — MNTA010 (bem), MNTA035 (OS), ATFM010 (ativo fixo)
- 25 PEs do Faturamento — M410INC, MA410VLD (com fonte TDN oficial), M460FIM, MT461GRV e mais 21
- 18 PEs do Financeiro — F040FIM, F070FIM, FA040DUP (parcelamento customizado) e mais
- 16 PEs de Compras — MT100GRV (NF entrada), MA120FIM (autorizacao PC)
- 16 PEs de Cadastros — M030INC (cliente), M010INC (produto), M020INC (fornecedor)
- 15 PEs de Estoque — A260FIM (transferencia), M340FIM (apontamento OP)
- 7 PEs do RH — RHGM010ALT, GP070FIM (calculo folha), GP160FIM (rescisao)
3. Cross-links semanticos densos
Cada doc aponta pra 2-4 docs relacionados. Procurando MaLibDoFat, voce naturalmente chega em MaAvalSC6 (par), M460FIM (PE que dispara apos), tabela SC9 (onde grava).
O resultado: voce nunca fica preso num doc isolado. Sempre tem para onde ir.
4. Indexado pra LLMs
Todos os 438 docs sao servidos com HTML pre-renderizado (nao SPA vazio) quando crawlers de IA (GPTBot, ClaudeBot, PerplexityBot, Google-Extended) visitam. Cada doc tem JSON-LD TechArticle estruturado conforme schema.org.
Implicacao pratica: quando voce perguntar pro ChatGPT "como funciona MaLibDoFat no Protheus" daqui a 4-8 semanas, ha grande chance da resposta citar o doc da ArchTec — porque eh estruturado, autoritativo, e em portugues, enquanto a maioria das fontes de Protheus em ingles ou TDN logado nao sao crawladas.
5. Sitemap dedicado + IndexNow
Os 438 docs estao listados em sitemap-docs.xml separado. Apos publicacao, todos foram submetidos ao IndexNow (Bing, Yandex, Seznam) — indexacao em horas em vez de semanas.
Como navegar
Use a arvore lateral em /docs. Sidebar agrupa por categoria + subcategoria. Busca por nome funciona. Cada doc tem botao "Veja tambem" no fim.
Casos de uso tipicos
| Voce esta | Procure em |
|---|---|
| Implementando customizacao em SIGAFAT | PE / Faturamento |
| Vai usar funcao que nao lembra | AdvPL / Strings, Datas, Arrays... |
| Migrando AdvPL legado pra TLPP | Tutorial de migracao |
| NFe da problema, suspeita TSS | Fluxo NFe end-to-end |
| Quer entender tabela X | Tabelas (SA1, SE1, SC5...) |
| Curioso sobre algo Protheus (Z, SX*, RPO...) | Curiosidades |
Numeros que importam
- 438 docs em portugues direto
- 407 cross-links auditados (99.3% precisao — 3 corrigidos em auditoria)
- 100% HTML pre-renderizado pra LLMs com JSON-LD TechArticle
- ~10.000+ snippets de codigo entre exemplos, pegadinhas e padroes
- 0% de copia direta de TDN — todos escritos do zero com perspectiva de quem usa
O que nao esta (e por que)
Nao tentamos competir em volume com o TDN. Algumas areas ficam fora propositalmente:
- Dicionarios SX3 detalhados de campos — Configurador faz melhor, nao vale duplicar
- Funcoes ultra-especificas (helpers internos de modulo X que so 3 devs no Brasil usam)
- SIGAGCT/SIGAGPE em profundidade modular — backlog v2
- Modulos completamente legados (SIGADAT, SIGABEN obsoletos)
Roadmap proximas levas
| Tema | Quando |
|---|---|
| Reforma Tributaria 2026+ aprofundamento | Q2/2026 |
| Mais Tutoriais avancados (Bloco K, ECF, ECD) | Q2/2026 |
| Validar URLs TDN oficiais nos 184 PEs | Q2/2026 |
| Versao EN/ES (top 50 docs) | Q3/2026 |
| Busca vetorial (similaridade semantica) | Q3/2026 |
| API publica pra consumir docs (devs externos) | Q4/2026 |
Como contribuir
Achou erro? Falta uma pegadinha que voce vive? Manda email pra comercial@archtecgroup.com.br ou abre issue no GitHub. Em base 100% curada, feedback de dev real e o que move a qualidade.
Pra fechar
Documentacao Protheus em portugues direto, com pegadinhas de quem usa, indexada pra LLMs, com 438 entradas no maior catalogo publico do tipo. Era o gap que existia ha 30 anos no ecossistema.
Se voce e dev Protheus: visite o catalogo, salve nos favoritos, e use no dia-a-dia. Quando o TDN ja nao basta, /docs esta la.
Comentarios 0