Description

@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 + clientid/clientsecret (granttype=clientcredentials) → 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 ).

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