# Sankhya Api Java

> >

- **Type:** Skill
- **Install:** `agentstack add skill-andressaolivi-sankhya-skills-sankhya-api-java-community`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [andressaolivi](https://agentstack.voostack.com/s/andressaolivi)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [andressaolivi](https://github.com/andressaolivi)
- **Source:** https://github.com/andressaolivi/sankhya-skills/tree/main/sankhya-api-java-community

## Install

```sh
agentstack add skill-andressaolivi-sankhya-skills-sankhya-api-java-community
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Skill: API Java do Sankhya (Comunidade)

Esta skill cobre os **pontos de extensão Java oficiais** do ERP Sankhya — as interfaces
e padrões que consultores e parceiros usam para customizar o produto sem alterar
código do fabricante.

> Esta skill cobre **APIs de extensão Java**.
> Para configurações funcionais do ERP, use `sankhya-funcionamento`.
> Para tabelas e campos, use `sankhya-dicionario`.

---

## Arquivos de referência

Leia o(s) arquivo(s) relevante(s) antes de responder:

| Arquivo | Conteúdo | Quando usar |
|---------|----------|-------------|
| `references/indice-geral.md` | Índice das interfaces documentadas, por categoria | Sempre que precisar localizar uma interface por nome |
| `references/api-actionbuttons.md` | `AcaoRotinaJava`, `ContextoAcao`, `QueryExecutor`, `Registro` | "Botão de ação Java", customização disparada por botão na tela |
| `references/api-eventos.md` | `EventoProgramavelJava` (BeforeInsert/AfterUpdate/etc.) + `PersistenceEvent` | Eventos programáveis Java (gatilhos antes/depois de insert/update/delete) |
| `references/api-regrasnegocio.md` | `RegraNegocioJava`, `ContextoRegra` | Regra de negócio Java em alçadas/liberações |
| `references/api-flow.md` | Workflow: `EventoProcessoJava`, `TarefaJava`, contextos do BPM | Customização de processos de Workflow em Java |
| `references/api-reguacobranca.md` | `AcaoReguaCobranca`, `ContextoRegua` | Régua de cobrança Java |
| `references/api-dynamicvo.md` | Padrão de uso do `DynamicVO` (leitura/escrita de campos) | Manipulação de registros em customizações |
| `references/api-entityfacade.md` | Padrão CRUD via `EntityFacade` + `FinderWrapper` | Consultar, criar, atualizar e remover entidades |
| `references/api-japesession.md` | Padrões de uso do `JapeSession` (abertura, blocos transacionais) | Controle de sessão e transação em jobs/scripts standalone |
| `references/api-jdbcwrapper.md` | Padrão de uso do `JdbcWrapper` para SQL nativo | Quando customização precisa rodar SQL/procedure |
| `references/api-servicebroker.md` | Padrão do ServiceBroker e `ServiceContext`; chamadas HTTP | Chamar serviços do Sankhya por HTTP/JSON, criar SPs novos |
| `references/api-utils.md` | Convenções gerais: `BigDecimal`, `Timestamp`, `MGEModelException` | Helpers transversais |

---

## Como responder

1. **Identifique o conceito-chave** na pergunta (botão de ação, evento, regra, flow, VO, sessão, SQL nativo, serviço HTTP).
2. **Leia o arquivo de referência apropriado** antes de redigir a resposta.
3. **Cite o pacote completo** (`br.com.sankhya.extensions.…`) quando a interface for da API pública de extensão.
4. **Forneça um exemplo Java mínimo** sempre que possível — o consultor aprende melhor com código pronto.
5. Lembre que **APIs internas** (DynamicVO, JapeSession, EntityFacade, JdbcWrapper) não têm garantia de estabilidade entre versões — sempre validar contra o ambiente do cliente.

## Avisos importantes

- A skill cobre os padrões usados em **Sankhya Om 4.x** (família de versões).
- As interfaces em `br.com.sankhya.extensions.*` são as **APIs oficiais de customização** do Sankhya — preferir essas sempre que possível.
- Outras classes citadas (`DynamicVO`, `JapeSession`, `EntityFacade`, `JdbcWrapper`, `ServiceContext`) são amplamente usadas em customizações de cliente, mas são **APIs internas** sem garantia de estabilidade entre versões — testar em cada upgrade.
- Os exemplos de código nesta skill seguem padrões públicos compartilhados na comunidade de consultores Sankhya.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [andressaolivi](https://github.com/andressaolivi)
- **Source:** [andressaolivi/sankhya-skills](https://github.com/andressaolivi/sankhya-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-andressaolivi-sankhya-skills-sankhya-api-java-community
- Seller: https://agentstack.voostack.com/s/andressaolivi
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.