Passar para o conteúdo principal

Integração Domínio via API: Como configurar o envio automático de XMLs

Com a integração via API, os XMLs de NF-e, CT-e e NFS-e Nacional capturados na Qive são enviados automaticamente para o ERP Domínio, sem exportação ou importação manual.

Escrito por Julia S.

Antes de começar

Confira os pré-requisitos:

  1. Pacote de integração contratado

    • Plano Contador: o pacote de integração pode ser contratado à parte, por R$ 59,90 por mês.

    • Demais planos: a contratação é feita com um especialista. Use a opção de contato com o especialista que aparece na tela da integração.

  2. Perfil de Administrador: apenas usuários com perfil Administrador ou Gerente na Qive acessam a tela de configuração.

  3. Módulo de API na Domínio: o seu contrato com a Domínio Sistemas precisa ter ativo o módulo que libera o acesso via API (Central do Desenvolvedor).

A integração via API é o fluxo recomendado para conectar a Qive à Domínio. O módulo Sincroniza Notas® continua disponível para quem já o utiliza.


Passo a passo para realizar a integração

Passo 1: Gere a chave de API na Domínio

A Chave de API é o que permite que a Qive envie os documentos para a Domínio com segurança.

  1. Acesse o ERP Domínio Sistemas.

  2. Vá até o menu Empresas > Configurações do ERP.

  3. Gere a Chave de API seguindo o passo a passo do artigo oficial da Domínio.

  4. Guarde a chave gerada. Você vai usá-la no próximo passo.

Passo 2: Configure a integração na Qive

Você pode configurar uma ou várias empresas de uma só vez.

  1. Acesse sua conta na Qive.

  2. No menu lateral esquerdo, clique em Integrações e selecione Domínio Sistemas.

  3. Clique em Configurar.

  4. Cole as Chaves de API na caixa de texto. Para mais de uma chave, separe-as por vírgula ou por quebra de linha.

  5. Defina quais documentos serão enviados

  6. Clique em Validar Credenciais.

🚩 A Qive testa a conexão com a Domínio em tempo real. Se alguma chave estiver incorreta ou expirada, ela aparece na aba Com erros, e você pode seguir com a configuração das chaves válidas.


Alterações e ajustes pós configuração:

Você escolhe as regras de envio durante a configuração, mas elas podem ser alteradas depois, editando a empresa. A regra padrão vale para todas as chaves inseridas. Para mudar a regra de uma empresa específica, clique em Alterar ao lado dela na lista e ative ou desative as informações que desejar:

  • Credenciais: Altere as credencias necessárias, podendo validar as novas assim como na configuração inicial.

  • Tipos de documento: ative ou desative o envio automático de NF-e, CT-e e NFS-e Nacional.

  • Módulo BOX-e: habilite o envio direto para o módulo Cliente BOX-e da Domínio. Saiba mais sobre o módulo BOX-e.


Como acompanhar os envios

Depois de configurada, a integração funciona de forma automática. Você acompanha o resultado em três lugares:

  • Lista da integração: em Integrações > Domínio Sistemas, você vê se cada credencial foi validada e se a empresa foi ativada.

  • Filtro Sincronização ERP: na listagem de documentos fiscais, use o filtro Sincronização ERP para ver apenas as notas que já foram sincronizadas.

💡Se a Domínio estiver instável, a Qive tenta reenviar a nota automaticamente algumas vezes antes de registrar falha.


Limitações da integração

  • Apenas XML: somente o arquivo XML é enviado. O PDF e o DANFE não são transmitidos para o ERP.

  • NFS-e somente no Padrão Nacional: notas de prefeituras com layout municipal próprio ou no padrão ABRASF não são enviadas.

  • Não é retroativa: só são enviados os documentos capturados a partir da ativação da chave. Notas anteriores não são sincronizadas automaticamente.

  • NFC-e fora do escopo: cupons fiscais não fazem parte do envio automático.


Credencial inválida: o que fazer

Se uma credencial aparecer como inválida na tela da integração:

  1. Gere uma nova Chave de API no ERP Domínio.

  2. Atualize a chave em Integrações > Domínio Sistemas na Qive.

Se tiver outras dúvidas, fale com o nosso time de suporte pelo chat.

Respondeu à sua pergunta?