Narwal
Objetivo
O conector Narwal permite integrar diversos processos financeiros, fiscais e logísticos da plataforma Narwal Sistemas com a Fluid. Com ele, é possível consultar documentos pendentes, integrar informações de contas a pagar/receber, gerenciar NFes, pedidos de venda, processos internos e muito mais — tudo de forma automatizada em seus fluxos.
Como configurar a Conexão
Para utilizar o conector Narwal na Fluid, é necessário configurar previamente as credenciais de acesso no painel da plataforma.
Passo a passo:
- Acesse o menu Conexões na plataforma Fluid.
- Clique em Adicionar nova conexão.
- Selecione o conector Narwal.
- Preencha os seguintes campos:
Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
Usuário | texto | ✅ | Nome de usuário da sua conta Narwal. |
Senha 🔐 | senha | ✅ | Senha correspondente ao usuário. |
Identidade | texto | ✅ | Parte da URL de acesso da Narwal. Exemplo: minhaempresa para minhaempresa.narwalsistemas.com.br |
Configurando Fluxo
Após configurar a conexão, você poderá usar o conector Narwal nos fluxos da Fluid arrastando-o para o editor e escolhendo o recurso desejado.
Recursos Disponíveis
Abaixo estão os recursos suportados, com suas respectivas operações:
Contas a Pagar
Operação | Descrição | Campos obrigatórios |
|---|---|---|
Consultar Pendentes | Lista títulos a pagar pendentes. | — |
Consultar | Consulta um título específico. | id |
Marcar Integrado | Marca um título como integrado. | body.value, body.type |
Contas a Receber
Operação | Descrição | Campos obrigatórios |
|---|---|---|
Consultar Pendentes | Lista títulos a receber pendentes. | — |
Consultar | Consulta um título específico. | id |
Integra Título | Marca um título como integrado. | body.value, body.type |
Configuração
Operação | Descrição | Campos obrigatórios |
|---|---|---|
Variável de Ambiente | Busca uma variável de ambiente. | id |
Processo
Operação | Descrição | Campos obrigatórios |
|---|---|---|
Processo Detalhe Easy | Inicia um processo detalhado. | — |
Processo Despesa Easy | Inicia um processo de despesa. | — |
Confirma Integração | Confirma integração de processo. | id (W6_HAWB) |
Confirma Integração Despesa | Confirma integração de despesa. | id (W6_HAWB) |
Consultar Detalhes | Consulta detalhes de processo. | id |
Consultar Pendentes | Lista processos pendentes. | — |
Integrar | Envia dados de integração de processo. | body.value, body.type |
NFe
Operação | Descrição | Campos obrigatórios |
|---|---|---|
Consultar Pendentes | Lista NFes pendentes de integração. | — |
Retorna XML-V3 | Retorna o XML da NFe. | id |
Confirma Recebimento | Confirma recebimento da NFe. | body.value, body.type |
Nota Fiscal de Saída
Operação | Descrição | Campos obrigatórios |
|---|---|---|
Consultar Pendentes | Lista NFes de saída pendentes. | — |
Retorna XML-V3 | Retorna XML da nota fiscal de saída. | id |
Retorno de Integração | Envia retorno de integração. | body.value, body.type |
Confirmar Recebimento | Confirma recebimento da NFe de saída. | body.value, body.type |
Pedido de Venda
Operação | Descrição | Campos obrigatórios |
|---|---|---|
Pedido de venda | Integra pedido de venda. | body.value, body.type |
Retorno de integração | Retorno de status da integração. | body.value, body.type |
Filial Controller
Operação | Descrição | Campos obrigatórios |
|---|---|---|
Lista Filial - V3 | Lista filiais disponíveis. | — |
Evento de Integração
Operação | Descrição | Campos obrigatórios |
|---|---|---|
Retorno Integração | Retorna status de integração. | body.value, body.type |
Despesas de Importação
Operação | Descrição | Campos obrigatórios |
|---|---|---|
Consultar Pendentes | Lista despesas de importação pendentes. | — |
OData
Operação | Descrição | Campos obrigatórios |
|---|---|---|
Processo | Lista registros de processos. | Filter |
Observações Técnicas
- Todas as operações que utilizam body aceitam dois formatos de envio: Template ou De/Para.
- Os campos id, productID, priceTableID, entre outros, são normalmente utilizados como identificadores nos endpoints.
- Para integração via De/Para, configure os mapeamentos corretamente nos modelos de transformação da Fluid.
- A autenticação é realizada via usuário, senha e identidade no subdomínio Narwal.
- As respostas seguem o padrão HTTP comum:
- 200 OK para sucesso.
- 4xx para erros de validação.
- 5xx para falhas internas.
Conclusão
O conector Narwal proporciona uma integração robusta com os sistemas de gestão e automação da Narwal Sistemas. Com ele, você automatiza processos financeiros, fiscais e logísticos diretamente dentro da plataforma Fluid, reduzindo falhas manuais e ganhando produtividade.