@luizeduos/n8n-nodes-sankhya
v0.1.0
Published
Node n8n para o ERP Sankhya: gateway genérico (service.sbr) + endpoints REST por módulo, com autenticação OAuth 2.0 ou legado.
Maintainers
Readme
@luizeduos/n8n-nodes-sankhya
Nodes community do n8n para o ERP Sankhya. Cobre a API em duas camadas:
- Sankhya (Gateway) — camada genérica
service.sbr:loadRecords,loadRecord,loadView,DatasetSP.save,removeRecord,executeQuery(SQL) e Custom Service Call (qualquerserviceName, incl. ComercialCACSP.*). Alcança qualquer entidade/serviço do ERP. - Sankhya REST — endpoints REST
/v1por módulo: Cadastros, Financeiro, Fiscal, Pessoal, Estoque.
Autenticação
A credencial Sankhya API suporta dois fluxos (seletor) e ambiente prod/sandbox:
- OAuth 2.0 (recomendado):
POST {base}/authenticatecom headerX-Token+client_id/client_secret(grant_type=client_credentials) → JWT. - Legado:
POST {base}/logincom headerstoken/appkey/username/password→bearerToken.
O token é gerado automaticamente (preAuthentication) e injetado como Authorization: Bearer.
Bases: produção https://api.sankhya.com.br/ · sandbox https://api.sandbox.sankhya.com.br/.
Build & instalação
cd sankhya-node
npm install
npm run buildInstalar no n8n self-hosted via Settings → Community Nodes → Install → @luizeduos/n8n-nodes-sankhya (após publicar), ou via pasta custom montada no Docker (npm pack + npm install <tgz>).
Uso rápido
- Crie a credencial Sankhya API (escolha OAuth2 ou Legado e o ambiente).
- Gateway: ex. Execute Query com um SELECT, ou Load Records na entidade
Parceiro. - REST: ex. Cadastros → Cidades (listar).
Observações
- O gateway envia
POSTemservice.sbr(aceito universalmente pelo Sankhya). - Os endpoints REST usam path params tipados + Query Parameters/Body (JSON) genéricos — cobertura ampla sem schema campo-a-campo (enriquecível por módulo).
- A credencial não tem botão Test (depende de dados reais). Valide rodando uma operação simples.
Licença
MIT
