sankhya

Node n8n para o ERP Sankhya: gateway genérico (service.sbr) + endpoints REST por módulo, com autenticação OAuth 2.0 ou legado.

Package Information

Released: 3 mo ago
Downloads: 8 weekly / 91 monthly
Latest Version: 0.3.1

Available Nodes

Documentation generating…

Sankhya (Gateway) icon
Sankhya (Gateway)
Camada genérica service.sbr do ERP Sankhya (loadRecords, save, query, etc.)
Sankhya REST icon
Sankhya REST
Endpoints REST /v1 do ERP Sankhya por módulo

Documentation

@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 (qualquer serviceName, incl. Comercial CACSP.*). Alcança qualquer entidade/serviço do ERP.
  • Sankhya REST — endpoints REST /v1 por 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}/authenticate com header X-Token + client_id/client_secret (grant_type=client_credentials) → JWT.
  • Legado: POST {base}/login com headers token/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 build

Instalar 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

  1. Crie a credencial Sankhya API (escolha OAuth2 ou Legado e o ambiente).
  2. Gateway: ex. Execute Query com um SELECT, ou Load Records na entidade Parceiro.
  3. REST: ex. Cadastros → Cidades (listar).

Observações

  • O gateway envia POST em service.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

Discussion