Mudanças entre as edições de "Integração com Domínio"
(→Relação com Outras Integrações) |
|||
| Linha 1: | Linha 1: | ||
| − | ===''' | + | ==='''Conceito'''=== |
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. | 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. | 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. | ||
| − | |||
| − | |||
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. | 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. | ||
Edição atual tal como às 10h12min de 7 de janeiro de 2026
Índice
Conceito
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.
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:
- Inicia uma transação
- Cria o registro de controle da integração
- Envia os dados do documento ao Domínio
- Atualiza a situação da integração
- Registra logs de sucesso ou erro
- 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
