--- title: Narwal slug: narwal docTags: createdAt: 2025-07-03T04:31:50.720Z --- ## 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: 1. Acesse o menu **Conexões** na plataforma Fluid. 2. Clique em **Adicionar nova conexão**. 3. Selecione o conector **Narwal**. 4. 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 | ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/nyG-jNX26tUkK96bNYef4_image.png) ## 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. ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/yePaac4zR4GEkLWiKAiET_image.png) ### 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.