/advpl-boilerplate

11 templates AdvPL/TLPP em pt-BR puro: execauto MATA010/020/030/410/FINA040/070, PE, MVC, REST, TReport e mais. Headers Protheus.doc completos.

Assinatura: /advpl-boilerplate <tipo> <NomeFuncao> [pasta]

/advpl-boilerplate gera fontes prontos a partir de 11 templates curados em portugues brasileiro puro — variaveis, comentarios e mensagens.

11 tipos disponiveis

Tipo	O que gera	Uso tipico
`execauto-mata010`	User Function que inclui produto via MSExecAuto MATA010	Importacao de catalogo
`execauto-mata020`	Inclui fornecedor (SA2)	Cadastro batch
`execauto-mata030`	Inclui cliente (SA1)	Onboarding
`execauto-mata410`	Inclui pedido de venda (SC5/SC6)	Integracao marketplace
`execauto-fina040`	Inclui titulo a receber (SE1)	Cobranca
`execauto-fina070`	Baixa titulo a receber via FINA070	Conciliacao bancaria
`pe`	Ponto de Entrada generico	Validacao custom
`user-function`	User Function basica com header	Funcao utilitaria
`mvc`	Cadastro MVC completo (Model + View + Menu + Browse)	Tela nova
`ws-rest`	Web Service REST TLPP com GET/POST + JsonObject	API HTTP
`report`	Relatorio TReport com query SQL	Relatorio custom

Como usar

# Cria User Function que importa produto
/advpl-boilerplate execauto-mata010 ATImpProd

# Cria MVC completo
/advpl-boilerplate mvc CadProdNovo

# Em pasta especifica
/advpl-boilerplate ws-rest minhaApi ./src/integracoes/

O que todo template tem

Header Protheus.doc completo no padrao TOTVS
Comentarios e variaveis em pt-BR (estilo nativo da comunidade)
GetArea() / RestArea() pra preservar contexto
Begin Transaction / End Transaction onde aplicavel
Tratamento de erro com Begin Sequence / Recover
Log inicial com FwLogger ou ConOut

Exemplo de output (execauto-mata010)

#Include "totvs.ch"
#Include "protheus.ch"

/*/{Protheus.doc} ATImpProd
Importacao de produto via MSExecAuto MATA010.

@type   Function
@author claude-advpl-skill
@since  13/05/2026
@param  cCodigo, Character, Codigo do produto
@param  cDesc,   Character, Descricao
@return Logical, .T. se OK, .F. se erro
/*/
User Function ATImpProd(cCodigo, cDesc)
    Local aCab := {}
    Local lRet := .F.
    Private lMsErroAuto := .F.

    // Verifica duplicidade
    SB1->(DBSetOrder(1))
    If SB1->(DBSeek(xFilial("SB1") + cCodigo))
        ConOut("Produto " + cCodigo + " ja existe")
        Return .F.
    EndIf

    aAdd(aCab, {"B1_FILIAL", xFilial("SB1"),  NIL})
    aAdd(aCab, {"B1_COD",    cCodigo,         NIL})
    aAdd(aCab, {"B1_DESC",   cDesc,           NIL})
    aAdd(aCab, {"B1_TIPO",   "PA",            NIL})
    aAdd(aCab, {"B1_UM",     "UN",            NIL})
    aAdd(aCab, {"B1_LOCPAD", "01",            NIL})
    aAdd(aCab, {"B1_GRUPO",  "0001",          NIL})

    MsExecAuto({|x,y| Mata010(x,y)}, aCab, 3)

    If lMsErroAuto
        ConOut("Erro: " + MostraErro())
        DisarmTransaction()
    Else
        lRet := .T.
        ConOut("Produto " + cCodigo + " incluido")
    EndIf
Return lRet

Casos de uso

Onboarding de dev novo — boilerplate validado em vez de copy-paste de fonte alheio
Integracoes ETL — ja vem com a estrutura ExecAuto correta
MVC novo — economiza 1-2 horas de setup inicial
Padronizacao — todos os fontes saem com mesmo header e estrutura

Instalacao

A skill faz parte do pacote claude-advpl-skill open source. Baixe e instale:

curl -O https://archtecgroup.com.br/downloads/claude-advpl-skill-v0.2.1.zip
unzip claude-advpl-skill-v0.2.1.zip
bash install.sh
# OU Windows PowerShell:
.\install.ps1

Documentacao tecnica completa: GitHub maycondev/claude-advpl-skill

Caso de uso real (post): Auditando 800 linhas de AdvPL em 30 segundos

Suporte / Customizacao

Precisa adaptar a skill pro seu fluxo, integrar em pipeline CI/CD custom, ou usar em ambiente corporativo com NDA?

A ArchTec oferece consultoria especializada em automacao de dev Protheus com Claude/AI. Fale com nossos especialistas →