Qive
8 min
objetivo o conector da qive é uma solução voltada para a automação da consulta e gestão de documentos fiscais eletrônicos, como nf e, nfse, cte e dados de cnpj com este conector, é possível integrar sistemas internos (como erps ou plataformas financeiras) para buscar, consultar e processar documentos fiscais automaticamente, reduzindo a necessidade de consultas manuais e garantindo maior confiabilidade dos dados o objetivo principal é fornecer uma integração direta com a api da qive, permitindo o consumo estruturado de informações fiscais para uso em processos financeiros, contábeis e operacionais criando um fluxo utilizando o conector qive para criar um fluxo utilizando o conector da qive, é necessário estabelecer uma conexão válida e, em seguida, configurar os recursos desejados no canvas criando conexão qive a qive utiliza credenciais baseadas em chaves de api para garantir a segurança dos dados para realizar a integração, você deve gerar suas credenciais diretamente no painel da sua conta qive configuração na qive acesse o seu painel da qive navegue até a seção de integrações ou configurações de api gere ou obtenha o seu api id (id da api) e api key (chave da api) configuração na fluid ao criar a conexão na fluid, você deverá preencher os seguintes parâmetros de autenticação e ambiente ambiente selecione o ambiente desejado para a conexão as opções disponíveis são produção ou sandbox (campo obrigatório); api id o identificador da sua aplicação fornecido pela qive (campo obrigatório); api key a chave secreta correspondente para autorizar as requisições (campo obrigatório) obs https //docs fluidapi io/criar conexao e acesse nosso passo a passo para saber como criar uma conexão configurando fluxo qive crie um fluxo e arraste o conector qive para o canvas obs https //docs fluidapi io/criar fluxo e acesse nosso passo a passo para saber como criar um fluxo selecione o conector e na aba de parametrização preencha os seguintes parâmetros de configuração recurso domínio da api da qive que será utilizado (nfe, nfse, cte ou cnpj) operação ação específica que será executada para o recurso selecionado operações disponíveis por recurso 1\ nfe (nota fiscal eletrônica) buscar nfe recebidas retorna os xmls das notas recebidas permite filtrar por cursor, custom properties (query language), chaves de acesso, cnpjs e período de criação limite máximo de 50 documentos buscar nfe emitidas retorna os xmls das notas emitidas permite os mesmos filtros da busca de recebidas buscar nfe manifestadas busca notas específicas utilizando uma lista de chaves de acesso manifestar nfe realiza a manifestação do destinatário (ex ciência da operação, confirmação) enviando um corpo na requisição 2\ nfse (nota fiscal de serviços eletrônica) buscar nfse recebidas retorna as notas de serviço recebidas permite filtrar por cursor, ids, cnpjs e período de criação buscar nfse emitidas retorna as notas de serviço emitidas permite os mesmos filtros da busca de recebidas 3\ cte (conhecimento de transporte eletrônico) buscar cte (tomador) retorna os ct es onde sua empresa é o tomador do serviço permite filtrar por cursor, chaves de acesso, cnpjs e período de criação buscar cte (não tomador) retorna os ct es vinculados ao seu cnpj onde a empresa não é a tomadora permite escolher o formato de retorno (xml ou json) e aplicar filtros de cursor, chaves e datas 4\ cnpj buscar múltiplos cnpjs realiza a consulta em lote enviando uma lista de cnpjs buscar cnpj único consulta detalhada dos dados de um único cnpj na prática neste tópico, criaremos um exemplo de fluxo para consultar uma nf e recebida específica utilizando a sua chave de acesso e definindo um limite de busca passo 'getnfe' configuração da parametrização recurso nfe operação buscar nfe recebidas limite 5 chaves de acesso (access key\[]) 73231179566794000105550030000849670577498186 para tratar os dados recebidos (como extrair as informações do xml codificado em base64), utilize o https //docs fluidapi io/depara nos passos seguintes conclusão com o passo configurado, ao disparar o fluxo, o conector fará a requisição get https //sandbox api arquivei com br/v1/nfe/received?limit=5\&access key\[]=73231179566794000105550030000849670577498186 e retornará um objeto detalhado contendo a nota e informações de paginação { "count" 1, "data" \[ { "access key" "73231179566794000105550030000849670577498186", "xml" "pg5mzvbyb2mgeg1sbnm9imh0dha6ly93d3cucg9ydgfszmlzy2fslmluzi5ici9uzmuiihzlcnnhbz0inc4wmci " } ], "page" { "next" "https //sandbox api arquivei com br/v1/nfe/received?access key\[0]=73231179566794000105550030000849670577498186\u0026limit=5\u0026cursor=5", "previous" "https //sandbox api arquivei com br/v1/nfe/received?access key\[0]=73231179566794000105550030000849670577498186\u0026limit=5\u0026cursor=0" }, "signature" "bb901068ef682d0a7540eca827adbcecde4c60e8da78def2369af2ed724bbb34", "status" { "code" 200, "message" "ok" } }