Integração com Domínio

Introdução

A integração com o sistema Domínio permite o envio automático de documentos fiscais do PHERP para o ambiente do contador, garantindo agilidade, conformidade fiscal e redução de processos manuais.

Essa integração é nativa do PHERP e utiliza rotinas internas para seleção, envio e controle dos documentos integrados, sem a necessidade de requisições externas via API.

Objetivo da Integração

O principal objetivo da integração com o Domínio é automatizar o envio dos documentos fiscais emitidos ou cancelados no PHERP para o sistema do contador.

Documentos Enviados

A integração contempla os seguintes documentos:

• Nota Fiscal Eletrônica (NF-e – Modelo 55)
• Nota Fiscal de Consumidor Eletrônica (NFC-e – Modelo 65)
• Nota Fiscal de Serviço (Modelo 3)
• Documentos de Entrada vinculados à NF-e

Critérios de Seleção dos Documentos

Os documentos elegíveis para integração devem atender aos seguintes critérios:

• Pertencer à empresa configurada
• Estar com situação Emitido ou Cancelado
• Possuir XML gerado
• Não ter sido integrado anteriormente
• Atender aos filtros de data informados

Documentos de entrada possuem validações adicionais relacionadas à situação da NF-e.

Parâmetros de Configuração

A integração utiliza parâmetros configurados no cadastro de integração do sistema, os quais são obrigatórios para o correto funcionamento do envio dos documentos fiscais ao Domínio.

Parâmetro	Descrição
IntegrationKey (Contador)	Chave fornecida pelo contador para validação da empresa e geração da IntegrationKey efetiva
IntegrationKey (Efetiva)	Chave gerada automaticamente pelo sistema após validação da chave do contador
Client ID	Identificador do sistema ERP fornecido pela Domínio Sistemas – Thomson Reuters
Client Secret	Chave secreta vinculada ao Client ID, utilizada para geração do token de autenticação
Boxe	Indica se o contador utiliza o serviço BOX-e para armazenamento dos XMLs

Esses parâmetros são utilizados automaticamente durante o processamento da integração e não necessitam de intervenção manual após a configuração inicial.

BOX-e (Domínio Sistemas)

O BOX-e é um serviço opcional oferecido pela Domínio Sistemas – Thomson Reuters, destinado ao armazenamento em nuvem dos arquivos XML de documentos fiscais pelo período legal de até 5 anos.

A utilização do BOX-e não interfere no funcionamento da integração, nem altera o processo de envio ou validação dos documentos fiscais. Seu uso impacta exclusivamente a forma como os XMLs são armazenados após o processamento no ambiente da Domínio.

Quando habilitado, os documentos fiscais enviados pelo PHERP são armazenados no ambiente da Domínio. Caso não esteja habilitado, os XMLs são apenas processados pela Domínio.

A definição do uso do BOX-e é realizada conforme contrato do contador com a Domínio Sistemas e refletida nos parâmetros de configuração da integração.

Fluxo de Processamento

Para cada documento selecionado, o PHERP executa o seguinte fluxo:

1. Inicia uma transação
2. Cria o registro de controle da integração
3. Envia os dados do documento ao Domínio
4. Atualiza a situação da integração
5. Registra logs de sucesso ou erro
6. Confirma ou cancela a transação conforme o resultado

Cada documento é tratado de forma individual.

Tratamento de Erros

Em caso de falha no envio de um documento:

• A situação da integração é marcada como Erro
• A mensagem detalhada é registrada em log
• O documento pode ser reprocessado posteriormente
• O erro não impacta os demais documentos

Auditoria e Controle

Todas as integrações realizadas ficam registradas, permitindo:

• Identificação do documento integrado
• Data e hora do envio
• Situação da integração
• Histórico de mensagens e erros

Esses dados garantem total rastreabilidade do processo.

Execução da Integração

A execução da integração com o Domínio é realizada exclusivamente de forma manual, mediante ação do usuário autorizado no sistema.

Durante a execução, o usuário pode informar filtros opcionais de período, utilizando:

• Data inicial
• Data final

Caso os filtros de data não sejam informados, o sistema considera todos os documentos elegíveis conforme as regras de seleção da integração.

A cada execução, os documentos são avaliados individualmente, respeitando os critérios de seleção e evitando o reenvio de documentos já integrados.

Assuntos Relacionados

Integrações

PHSYS API

Servidor de Aplicação