Distribuir XML Via API Dominio

---
title: Distribuir XML Via API Dominio
slug: distribuir-xml-via-api-dominio
sistema:
  - Gestão Administrativa [04]
chamado: "0000460224"
categoria: user_manual
tipo: how-to
publico: "contador, operador fiscal"
keywords:
  - XML
  - API Domínio
  - NF-e
  - distribuição de documentos fiscais
  - Gestão Doc-e
  - x-integration-key
  - XMLPath
autor: Antonio Marcos Zampier
setor: Qualidade
modulo: Gestão Administrativa
versao_doc: 01
revisao: Andreia Burko Bley
aprovado_em: 08/2023
release: D 23.05a
versao_pipeline: 2.7.0
ultima_revisao: "2026-06-13"
---

## Visão Geral

Permite distribuir arquivos XML de documentos fiscais eletrônicos (NF-e, CT-e, NFS-e) diretamente ao escritório contábil por meio da integração com a API Domínio. O processo envolve configurar a chave de integração no Administrador e, em seguida, selecionar e enviar os documentos pelo módulo Gestão Administrativa.

## Configurar a Conexão com a API Domínio

Antes de enviar XMLs, é necessário registrar as credenciais de integração no Administrador.

1. Abra o módulo **Administrador** e acesse o menu **Administrador > F - Parâmetros Gerais**.

   ![Menu Administrador com opção F - Parâmetros Gerais destacada](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/distribuir-xml-via-api-dominio/distribuir-xml-via-api-dominio-01.png)

2. Na tela **Parâmetros Gerais**, clique na aba **API Config** e preencha os campos do diálogo **Config API** conforme abaixo:

   ![Tela Parâmetros Gerais, aba API Config, com diálogo Config API aberto; campo ID preenchido com "apiDominio", Descrição "Dominio"; Parâmetros numerados: 1 - campo x-integration-key preenchido, 2 - campo XMLPath preenchido com "C:\teorema\dominio"; botões Cancelar e Confirmar](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/distribuir-xml-via-api-dominio/distribuir-xml-via-api-dominio-02.png)

   > **Nota:** O parâmetro **x-integration-key** deve ser solicitado ao contador que utiliza o sistema Domínio. O campo **XMLPath** define a pasta local onde os XMLs serão salvos antes do envio.

## Distribuir XMLs pela Gestão Doc-e

Com a API configurada, acesse o módulo de gestão de documentos fiscais eletrônicos para selecionar e enviar os arquivos.

1. No módulo **Gestão Administrativa**, acesse o menu **Vendas > Gestão Doc-e**.

   ![Menu Vendas do módulo Gestão Administrativa com item Gestão Doc-e destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/distribuir-xml-via-api-dominio/distribuir-xml-via-api-dominio-03.png)

2. Selecione o **período**, a **empresa** e o **tipo de documento** (ex.: NF-e). Marque os documentos desejados e clique no botão **API Dominio** na barra de ferramentas.

   ![Tela Gestão Doc-e com filtros de período, empresa e tipo Doc-e preenchidos; lista de documentos NF-e selecionados; botão API Dominio destacado na barra superior](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/distribuir-xml-via-api-dominio/distribuir-xml-via-api-dominio-04.png)

3. O sistema gera os XMLs na pasta configurada em **XMLPath** e cria um arquivo de log registrando quais notas foram encaminhadas. Após o envio, os XMLs são movidos automaticamente para a subpasta **Enviados**.

   ![Windows Explorer exibindo a pasta APIDominio com subpasta "Enviados" e arquivo "Log21082023.txt" gerados após o envio](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/distribuir-xml-via-api-dominio/distribuir-xml-via-api-dominio-05.png)

   ![Arquivo Log21082023.txt aberto, exibindo entradas com ID, caminho do arquivo XML enviado, data/hora e status "Aguardando processamento. Por favor aguarde o arquivo ser processado."](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/distribuir-xml-via-api-dominio/distribuir-xml-via-api-dominio-06.png)

4. Na subpasta **Enviados**, é mantida cópia de cada XML transmitido à Domínio via API.

   ![Windows Explorer exibindo a pasta Enviados dentro de APIDominio com três arquivos XML de NF-e (nfe40) listados](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/distribuir-xml-via-api-dominio/distribuir-xml-via-api-dominio-07.png)

## Mensagem de Erro: API Domínio Não Configurada

Caso o botão **API Dominio** seja acionado sem que a integração tenha sido configurada, o sistema exibe uma mensagem informando que o acesso à API precisa ser configurado.

![Tela Gestão Doc-e com diálogo de aviso indicando que o acesso à API Domínio não foi configurado e orientando a realizar a configuração](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/distribuir-xml-via-api-dominio/distribuir-xml-via-api-dominio-08.png)

> **Atenção:** Ao receber essa mensagem, retorne ao módulo **Administrador > F - Parâmetros Gerais > API Config** e cadastre as credenciais da API Domínio conforme descrito na seção anterior.

## Informações do documento

> Autor: Antonio Marcos Zampier
> Setor: Qualidade
> Módulo: Gestão Administrativa
> Chamado: 0000460224
> Versão do Sistema: D 23.07a
> Versão do documento: 01
> Revisão: Andreia Burko Bley
> Aprovado em: 08/2023

---

> 📎 **Arquivos originais:** [Manual Distribuir XML via API Dominio.docx](https://drive.google.com/uc?export=download&id=1o8CP-NPMyXd_Kzx18lpYRIqPoYinh1ZD) · [Manual Distribuir XML via API Dominio.pdf](https://drive.google.com/uc?export=download&id=1CEMEZrS7M8-BbDVgF7bRhT6ovv7CCBBG)