Configurar sistemas ERP para lançamento
Um sistema é uma ligação ERP num ambiente. O passo Contabilizar documentos, um lançamento a partir de um ficheiro e todas as outras formas de lançar (consulte Contabilizar documentos em sistemas ERP) enviam cada documento para um sistema, e é o sistema que decide como o documento é construído, verificado e enviado. Todas as ligações ERP que consegue ver aparecem como um sistema por si próprias — cinco ligações SAP são cinco sistemas, na nuvem e instalados localmente lado a lado — e a mesma ligação num ambiente de testes e num de produção são dois sistemas, cada um com as suas definições.
Os sistemas configuram-se uma vez por ambiente. Todos os projetos desse ambiente partilham a grelha de que entidade lança onde e as definições de cada sistema. Só Entrar em produção é feito por projeto.
Abrir Sistemas
Seção intitulada “Abrir Sistemas”Abra o Registo de lançamentos e escolha Sistemas em Definições na barra lateral. O cabeçalho tem:
- Um seletor de ambiente: o ambiente cujos sistemas são listados.
- Um seletor de projeto, que começa em Sem projeto. Escolha um projeto para ver se cada sistema está em produção nele e para entrar em produção.
- Ações, com Entrar em produção neste projeto… (apresentado a um arquiteto do projeto), Copiar para outro ambiente… (apresentado a um administrador do espaço de trabalho), Sugerir que entidade lança onde… e Histórico de alterações.
A página mostra dois cartões: Sistemas · ambiente e Que entidade lança onde. Sem nenhuma ligação ERP no ambiente, a página indica Sem sistemas para lançar: adicione uma ligação a um sistema ERP em Ligações e ela aparece aqui.
A lista de sistemas
Seção intitulada “A lista de sistemas”Cada sistema é uma linha: o seu nome, o seu tipo de ERP e um conjunto de etiquetas.
| Etiqueta | O que indica |
|---|---|
| Nuvem | Um sistema na nuvem. |
| Instalação local · agente online | Um sistema de instalação local cujo agente esteve em contacto nos últimos cinco minutos. |
| Instalação local · agente offline desde hora / Instalação local · agente não ligado | O agente não está online, ou nenhum agente serve este ambiente. |
| Pode lançar | É possível lançar no sistema. |
| Não verificado | Um sistema de instalação local cujo agente não está online. |
| Real / Simular | Apresentado apenas com um projeto escolhido: se este sistema lança a sério nesse projeto. |
| Retirado | O sistema não aceita novos lançamentos. Apresentado no lugar de Real ou Simular. |
Uma linha pode ainda ter dois botões:
- Voltar a ligar — apresentado quando o agente de um sistema de instalação local não está online. Abre a ligação para que possa iniciar sessão novamente.
- Entrar em produção › — apresentado a um arquiteto do projeto, com um projeto escolhido, num sistema que não está Retirado, pode receber lançamentos e ainda está em Simular. Consulte Entrar em produção.
O que uma linha mostra ao abrir
Seção intitulada “O que uma linha mostra ao abrir”Abra uma linha com o seletor à sua esquerda. Mostra três elementos e uma fila de ligações.
O que falta é a lista de verificação do que impede o sistema de receber lançamentos, com quem faz cada item. Um item concluído aparece assinalado e marcado como concluído.
| Item | Quem | Concluído quando |
|---|---|---|
| Conta de serviço e respetivas permissões | TI | Sempre concluído por agora; nada a configurar. |
| Agente instalado e online (apenas instalação local) | TI | O agente está online. |
| Uma entidade lança neste sistema | Administrador do espaço de trabalho | Uma linha de Que entidade lança onde indica este sistema. |
| Entrar em produção | Arquiteto do projeto | O sistema está em produção no projeto escolhido. |
O que pode fazer é uma linha, como “Aceita diários, faturas de clientes · estorna diários · responde na chamada”. Enumera os tipos de documento que o sistema aceita, os que consegue estornar e se a sua resposta chega responde na chamada ou responde mais tarde. A lista completa de cada sistema encontra-se abaixo, em O que cada sistema consegue fazer.
Cópia das suas listas mostra a idade da cópia que o sistema tem das suas contas, empresas e períodos, com Atualizar agora e Ver a cópia. Consulte A cópia das listas de um sistema.
As ligações por baixo são Para TI, Definições…, Marcar como Retirado (ou Repor de Retirado) e Histórico, que abre o Histórico de alterações apenas deste sistema.
As definições que existem
Seção intitulada “As definições que existem”Cada definição tem um valor inicial, e a maioria dos projetos nunca altera nenhuma.
| Definição | Onde | Quem a altera | Valor inicial |
|---|---|---|---|
| Que entidade lança onde | Sistemas, uma vez por ambiente | Um administrador do espaço de trabalho | Sem linhas. Sem linhas, o único sistema que não está Retirado e que consta em Sistemas aceita todas as entidades. |
| Retirado | A linha de um sistema | Um administrador do espaço de trabalho | Não retirado |
| Simular ou Real | Entrar em produção, por sistema, por projeto | O arquiteto do projeto | Simular |
| Valores necessários sempre | As Definições de um sistema | Um administrador do espaço de trabalho | Nenhum |
| Correspondências de códigos (incluindo a correspondência da entidade) | As Definições de um sistema | Um administrador do espaço de trabalho | Nenhuma |
| A função própria do cliente (SAP de instalação local) | As Definições de um sistema | Um administrador do espaço de trabalho | Nenhuma, ou a função que um passo convertido traz |
| Regras de retenção | Regras de retenção, por sistema | Um administrador do registo (erp.register.admin) |
Nada fica retido |
| Reter para uma pessoa | O passo, em Mais ▸ | Quem constrói o passo | Nada fica retido |
| Quem é notificado | O passo, em Mais ▸ | Quem constrói o passo | Quem iniciou a execução |
| Conta de arredondamento e limite | O passo, em Mais ▸ | Quem constrói o passo | Sem arredondamento |
| Quando um documento contabilizado volta alterado | O passo, em Mais ▸ | Quem constrói o passo | Perguntar (valor inicial). Fica em Requer atenção com duas opções. |
As quatro definições do passo são descritas com o passo em Contabilizar documentos em sistemas ERP; a retenção própria de um passo é descrita abaixo.
Definições do sistema
Seção intitulada “Definições do sistema”Escolha Definições… numa linha aberta. A caixa de diálogo, Definições: sistema, só pode ser editada por um administrador do espaço de trabalho; qualquer outra pessoa vê Só um administrador do espaço de trabalho pode alterar estas definições. Guardar substitui todas as definições do sistema, e cada alteração fica registada no Histórico de alterações.
Os Valores necessários sempre são valores acrescentados a todos os documentos enviados para este sistema, como pares Valor e Definir como. Um sistema lê pelo nome os de que precisa, e uma coluna do próprio documento com o mesmo significado prevalece sobre o valor do sistema:
| Sistema | Valor | Utilizado para |
|---|---|---|
| Sage Intacct | gl_journal_id |
O diário em que um lançamento de diário é registado, quando o documento não tem journal_type. |
| Sage 100 | bank_code |
A conta bancária por onde é feito um pagamento, quando o documento não tem bank_code. |
As Correspondências de códigos indicam onde um código daqui é outro código no sistema: uma Dimensão, O nosso código e Código no sistema. Utilize a dimensão entity para uma entidade cuja empresa no sistema tem outro código, e account para uma conta. As verificações procuram um código nas listas do sistema através da sua correspondência, ou tal como estão escritos quando não a têm, e uma correspondência de entidade também permite que a grelha sugira este sistema para essa entidade.
A função própria do cliente aparece apenas para SAP de instalação local. Indique a função de cada Tipo de documento. As definições indicam apenas a função: a correspondência de campos de cada função — que campo SAP recebe que coluna — mantém-se no sistema tal como está, e uma função que um passo de lançamento SAP convertido trouxe mantém a correspondência de campos que o passo tinha. Consulte SAP de instalação local.
Que entidade lança onde
Seção intitulada “Que entidade lança onde”O segundo cartão é a grelha de que entidade lança em que sistema, a partir de que data, definida uma vez por ambiente e partilhada por todos os projetos desse ambiente. Cada linha é uma entidade, →, um sistema e uma De (AAAA-MM-DD) opcional.
- Escolha Adicionar uma linha, escreva a entidade e escolha um sistema em Escolha um sistema. Só são oferecidos os sistemas que não estão Retirados.
- Deixe De (AAAA-MM-DD) em branco para “desde o início”, ou indique a data em que a entidade começa a lançar nesse sistema. Para mudar uma entidade para outro sistema a meio do ano, mantenha a sua primeira linha e adicione uma segunda linha para o novo sistema a partir da data da mudança, por exemplo
2026-07-01. - Escolha Guardar. Uma data que não esteja nesse formato é recusada com Uma data tem o aspeto 2026-07-01.
Editar a grelha exige um administrador do espaço de trabalho; as outras pessoas veem-na apenas em leitura. Uma entidade já guardada não pode ser renomeada: remova a sua linha com a cruz no fim e adicione outra. As entidades que os documentos referiram mas que ainda nenhuma linha indica são listadas sem sistema escolhido; se não houver nenhuma, o cartão indica Ainda não há entidades. São as encontradas nas tabelas que lança. Adicione uma linha para indicar uma.
Como um documento encontra o seu sistema
Seção intitulada “Como um documento encontra o seu sistema”Um documento é lançado através dos sistemas do ambiente do seu projeto.
- O seu sistema é a linha mais recente da entidade cuja data De é igual ou anterior à data de lançamento do documento (hoje, quando não tem nenhuma).
- Quando a grelha do ambiente não tem nenhuma linha e só um sistema que não está Retirado consta em Sistemas, esse sistema aceita todos os documentos.
- Um documento cuja entidade nenhuma linha abranja nessa data não é lançado, e indica que não existe sistema para a sua entidade.
- Um documento cuja linha indica um sistema Retirado não é lançado, e indica que o sistema está retirado.
Linhas sugeridas
Seção intitulada “Linhas sugeridas”Para uma entidade que ainda nenhuma linha indica, a grelha sugere um sistema quando exatamente um sistema do ambiente que não está Retirado refere essa entidade — através de uma correspondência de códigos entity ou na sua própria cópia da lista de empresas. A linha mostra Sugerido e permanece só de leitura até escolher Aceitar; só as linhas aceites são guardadas.
Sugerir que entidade lança onde… em Ações é a sugestão do Weave a partir do Data Foundation: com um projeto escolhido, preenche cada entidade que o Foundation do projeto carregou com a ligação de onde a carregou. Nada é calculado por um modelo e nada é guardado: as linhas são preenchidas, uma mensagem indica quantas, e lê cada uma e escolhe Guardar. Sem nada carregado, indica Ainda sem sugestões.
Linhas que não pode alterar aqui
Seção intitulada “Linhas que não pode alterar aqui”- Uma linha cujo sistema está Retirado é apresentada só de leitura com Retirado. Guardar a grelha mantém-na.
- Uma linha cujo sistema não consegue ver é apresentada só de leitura com Não está nesta lista. Guardar a grelha remove-a, pelo que Guardar pede primeiro uma confirmação em Guardar encaminhamento.
Entrar em produção
Seção intitulada “Entrar em produção”Nada é lançado a sério até alguém entrar em produção de propósito. Entrar em produção é feito por sistema e por projeto: num projeto, alguns sistemas podem estar em produção enquanto outros ainda estão em Simular. Um projeto novo, copiado ou de teste começa em Simular em todos os sistemas até alguém entrar em produção nele.
- Escolha o projeto no seletor de projeto do cabeçalho.
- Escolha Entrar em produção › na linha de um sistema, ou Entrar em produção neste projeto… em Ações para todos os sistemas que podem receber lançamentos e ainda não estão em produção. Sem um projeto escolhido, é-lhe indicado Escolha um projeto para entrar em produção.
- A caixa de diálogo Entrar em produção começa por verificar o que mudaria, sem alterar nada, e mostra-o:
- Estes passam a Real: os sistemas que vão lançar a sério.
- O modo de lançamento do projeto passa a Em produção, pelo que todos os sistemas em produção lançam a sério. — apresentado quando o próprio projeto ainda não está em modo Real.
- Já em produção: os sistemas que já estão.
- sistema não pode passar a Real: com o motivo: o sistema está Retirado, o projeto está bloqueado, não tem acesso de escrita a essa ligação, ou não é um sistema em que possa lançar.
- Escolha Entrar em produção. Só fica ativo quando pelo menos um sistema passaria a Real.
Entrar em produção grava a autorização do projeto para esses sistemas nesse ambiente e define o modo de lançamento do projeto como Real quando não o era. Cada sistema que entra em produção fica registado no Histórico de alterações. Entrar em produção nunca é copiado para outro ambiente ou projeto.
Entrar em produção exige o arquiteto do projeto, num projeto que não esteja bloqueado, com o seu próprio acesso de escrita a cada ligação. A mesma verificação aplica-se através da API REST (POST /erp/go-live) e da ferramenta MCP erp_go_live, que também recusa um token de IA delegado: é uma pessoa que entra em produção, nunca um agente em seu nome. Ambas se limitam a indicar o que mudaria, a menos que dry_run seja definido como false.
Retirar um sistema
Seção intitulada “Retirar um sistema”Escolha Marcar como Retirado numa linha aberta e confirme com Reformar: o sistema deixa de ser oferecido para lançamentos até ser reposto. As suas linhas na grelha são mantidas, e os documentos encaminhados para ele não são lançados. Repor de Retirado reverte a ação. Ambas exigem um administrador do espaço de trabalho e ficam registadas no Histórico de alterações.
Para TI
Seção intitulada “Para TI”Para TI abre Para TI: sistema, o que o produto faz neste sistema para que possa ser permitido e auditado:
- Inicia sessão como — a conta com que a ligação inicia sessão.
- Tamanho do lote — o tamanho do lote que as definições do sistema indicam, ou Não definido.
- Agente e Versão do agente — para um sistema de instalação local.
- Como lhe chamamos — cada função ou serviço que o produto chama pelo nome, com a data da última utilização. Para SAP de instalação local, são as funções definidas nas Definições. Antes de se ter lançado ou testado alguma coisa, indica Ainda nada. É listado depois de este sistema receber lançamentos ou testes.
Quando o início de sessão expirou, a caixa de diálogo indica-o e oferece Voltar a ligar.
Copiar para outro ambiente
Seção intitulada “Copiar para outro ambiente”Configure um ambiente de testes uma vez e copie-o para produção em vez de o escrever de novo. Escolha Copiar para outro ambiente… em Ações (apenas um administrador do espaço de trabalho).
- Escolha o ambiente em Copiar para.
- Todos os sistemas deste ambiente são listados e marcados quando a mesma ligação é um sistema no outro ambiente; um que não seja é apresentado como sistema (não está neste ambiente) e não pode ser marcado.
- Escolha Copiar e confirme.
Para cada sistema marcado, a cópia substitui as definições, as correspondências de códigos e as funções SAP desse sistema no outro ambiente por estas, e acrescenta as linhas da grelha que o referem e que o outro ambiente não tem (a mesma entidade a partir da mesma data). As linhas que já lá estão ficam como estão. O resultado indica quantas linhas da grelha e as definições de quantos sistemas foram copiadas. Entrar em produção não é copiado: todos os projetos do outro ambiente permanecem em Simular até alguém entrar em produção lá.
A cópia das listas de um sistema
Seção intitulada “A cópia das listas de um sistema”As verificações comparam os documentos com as Contas, Empresas e Períodos do próprio sistema. O PlaidCloud mantém uma cópia de cada uma, lida do próprio sistema:
- No início de cada execução Real num sistema em produção, a partir do sistema, com até 60 segundos para toda a leitura. Apenas a leitura dessa execução pode impedir um documento.
- Em Atualizar agora, numa linha aberta. Atualizar contacta o seu sistema ERP tal como o lançamento, pelo que exige um administrador do espaço de trabalho e o seu próprio acesso de escrita a essa ligação. Indica quantas contas, empresas e períodos leu, e quanto tempo demorou a leitura. Uma cópia atualizada serve para consulta: não alimenta nenhuma verificação.
Cada lista mostra a sua idade na linha — como “Contas lidas há 3 horas”, “Períodos parciais, lidos há 2 dias” ou “Empresas ainda não lidas” — ou que não foi possível lê-la e porquê. Uma cópia que ficou incompleta ou veio vazia não substitui a anterior.
Ver a cópia abre Cópia das listas, uma lista de cada vez (Contas, Empresas ou Períodos), com Código, Nome, Bloqueado, Estado no sistema, De e Para. Mostra até às primeiras 5000 linhas. Os códigos de imposto, clientes e fornecedores não são copiados; ficam ao cuidado do sistema.
Uma execução Simular não lê nada do sistema, pelo que em Simular estas verificações não são executadas e é o sistema que decide quando entra em produção.
Verificações face às listas
Seção intitulada “Verificações face às listas”No início de uma execução Real num sistema em produção, cada documento é verificado face às listas que essa execução leu. Uma verificação cuja lista não foi possível ler, veio parcial ou vazia, ou não terminou a tempo fica não verificada — nunca é aprovada nem impede nada — e é o sistema que decide. A página da execução mostra que verificações foram executadas em cada documento.
- Period open (Período aberto). O período do documento é encontrado pelo seu código de período ou, se não houver, pelos períodos em que a sua data de lançamento se enquadra. Só é impedido quando todos os períodos que o contêm estão fechados para lançamento no sistema — um período de ajuste que se sobrepõe ao seu mês mantém a data aberta. Um período cujo estado o sistema comunica com palavras que o PlaidCloud não conhece fica não verificado.
- A entidade é uma empresa. Quando a lista de empresas foi lida, a entidade do documento — através da sua correspondência de códigos
entity, se a tiver, ou tal como está escrita — tem de ser uma das empresas do sistema. - As contas existem. Quando a lista de contas foi lida, a conta de cada linha — através da sua correspondência de códigos
account, se a tiver, ou tal como está escrita — tem de estar no sistema e não estar bloqueada para lançamento. Os códigos numéricos correspondem independentemente dos zeros à esquerda, pelo que6100encontra0000006100.
Um documento impedido fica Não lançado com o motivo, como “Linha 3: a conta 6100 não existe em sistema”. As listas que cada sistema ERP oferece constam da tabela abaixo.
Regras de retenção
Seção intitulada “Regras de retenção”Nada fica retido até uma regra o determinar. Um documento que uma regra retém aguarda como Requer aprovação até uma pessoa o aprovar em Aprovações; tudo o resto que passa as suas verificações é enviado sem aprovação. Escolha Regras de retenção em Definições na barra lateral.
A lista tem Nome, Aplica-se a, Reter quando, Aprovado por e Por. Sem regras, indica Nada está retido. Quem tem erp.register.view pode ler as regras; adicionar, editar e eliminar exige um administrador do registo (erp.register.admin), que vê Nova regra, Editar e Eliminar na barra de ferramentas. Eliminar uma regra impede-a de reter novos documentos; os documentos que já aguardam continuam a aguardar até alguém decidir. Cada alteração fica registada no Histórico de alterações.
As condições de uma regra
Seção intitulada “As condições de uma regra”Nova regra abre Nova regra de retenção:
- Dê um Nome à regra, por exemplo “Diários acima de 250 000”.
- Escolha o sistema em Aplica-se a. São oferecidos os sistemas de todos os ambientes que consegue ver.
- Marque o que retém um documento em Reter quando. Têm de se verificar todas as condições marcadas; sem nenhuma marcada, nada fica retido.
- O montante é superior a um valor, na moeda própria da entidade: o tamanho do documento é a soma dos seus débitos mais os montantes locais positivos, ou os seus montantes de transação quando a tabela não indica montantes locais.
- Foi lançado a partir de um ficheiro.
- É um estorno, crédito ou correção — marque qualquer um dos três.
- É assinalado como invulgar — consulte Assinalado como invulgar.
- Sempre, por exemplo durante o fecho — retém todos os documentos do sistema; desativa as outras condições.
- Escolha quem aprova em Aprovado por: Os aprovadores do registo ou Pessoas nomeadas — marque as pessoas e, opcionalmente, as entidades para que aprovam, separadas por vírgulas (em branco é todas as entidades).
- Escolha Guardar. Fica ativo quando a regra tem um nome, um sistema, pelo menos uma condição, um montante que é um número e, para pessoas nomeadas, pelo menos uma pessoa.
Um documento retido retém todos os outros documentos do seu conjunto, pelo que um conjunto é aprovado e lançado como um só.
Quem pode aprovar
Seção intitulada “Quem pode aprovar”Um aprovador precisa de erp.register.approve e do seu próprio acesso à ligação do documento. Quando a regra indica pessoas, só essas pessoas aprovam — e apenas para as entidades que ela enumera, se enumerar alguma. Ninguém aprova um documento que enviou: nem quem iniciou a execução nem quem enviou o documento com Lançar estes.
Uma aprovação dada enquanto o documento foi enviado em Simular não conta para um envio Real: quando o mesmo documento é mais tarde enviado em modo Real, fica novamente retido para uma nova decisão.
Se a sua área de trabalho exigir separação de funções nos lançamentos, um estorno, crédito ou correção que ela abranja fica também retido para uma segunda pessoa, mesmo sem regra.
A retenção própria de um passo
Seção intitulada “A retenção própria de um passo”Um passo Contabilizar documentos pode reter mais do que os seus sistemas, em Mais ▸ → Reter para uma pessoa. As suas condições são O montante é superior a, Foi lançado a partir de um ficheiro, É um estorno, crédito ou correção, É assinalado como invulgar e Sempre, combinadas da mesma forma; sem nada marcado, nada mais fica retido. A retenção de um passo apenas se soma às regras do sistema — não pode libertar o que uma regra do sistema retém — e os seus documentos são aprovados pelos aprovadores do registo. Os aprovadores nomeados definem-se numa regra do sistema.
Alterar a retenção de um passo através da API REST (PUT /erp/steps/{step_id}/holds) ou da ferramenta MCP erp_hold_upsert exige analyze.step.write e a função de Arquiteto ou Gestor do projeto num projeto que não esteja bloqueado.
Assinalado como invulgar
Seção intitulada “Assinalado como invulgar”Um documento é assinalado como invulgar quando, em comparação com o que a sua entidade lançou antes:
- o seu montante é mais de dez vezes superior ou inferior ao do último lançamento da mesma referência;
- utiliza uma conta, cliente, fornecedor ou parceiro comercial que a sua entidade não utilizou nos seus últimos 500 documentos; ou
- a sua data de lançamento está fora do seu período.
Cada assinalação regista a frase que explica o motivo, como “A data de lançamento 2026-08-02 está fora do período 2026-07.” A assinalação é calculada a partir dos documentos anteriores da entidade; nenhum modelo de IA é chamado. Uma entidade sem documentos anteriores nunca é assinalada.
O que cada sistema consegue fazer
Seção intitulada “O que cada sistema consegue fazer”Todos os sistemas abaixo podem funcionar em Simular, que constrói e verifica cada documento e não envia nada. Um documento de um tipo que o seu sistema não aceita fica Não lançado; não é convertido noutro tipo.
| Sistema | Onde | Aceita | Estorna | Resposta | Listas para as verificações |
|---|---|---|---|---|---|
| NetSuite | Nuvem | Diários, faturas de clientes | Diários | Na chamada | Contas, subsidiárias, períodos de lançamento |
| Sage Intacct | Nuvem | Diários, faturas de clientes | Diários | Na chamada | Contas, entidades, períodos de relato |
| QuickBooks | Nuvem | Diários, faturas de clientes, faturas de fornecedores, notas de crédito | Diários, faturas de clientes | Na chamada | Contas, a empresa, meses fechados até à data de fecho dos livros |
| Xero | Nuvem | Diários, faturas de clientes, faturas de fornecedores, notas de crédito | Diários, faturas de clientes | Na chamada | Contas, a organização, meses fechados até à data de bloqueio |
| Acumatica | Nuvem | Diários, faturas de clientes, faturas de fornecedores, pagamentos, notas de crédito | Diários | Mais tarde | Contas, filiais, períodos financeiros |
| Business Central | Nuvem | Diários | Diários | Na chamada | Empresas, contas, períodos contabilísticos |
| Dynamics 365 F&O | Nuvem | Diários | Diários | Mais tarde | Contas principais, entidades legais, períodos fiscais |
| Oracle Fusion | Nuvem | Diários | Diários | Mais tarde | Livros, combinações de contas, períodos contabilísticos |
| S/4HANA Cloud | Nuvem | Diários | Diários | Mais tarde | Códigos de empresa, contas do razão — sem períodos, pelo que Period open não é verificado |
| Workday | Nuvem | Diários | Diários | Mais tarde | Empresas, contas do razão, períodos fiscais |
| SAP (instalação local) | Instalação local | Diários, faturas de clientes, faturas de fornecedores, através da função do cliente | — | Mais tarde, a partir do relatório do agente | Nenhuma lida; o sistema decide |
| Sage 100 | Instalação local | Diários, pagamentos | — | Mais tarde, a partir do agente | Nenhuma lida; o agente verifica o período e as faturas em aberto numa execução Real |
Uma resposta na chamada chega quando o documento é enviado. Uma resposta mais tarde chega depois do envio, e o documento fica Em espera até lá; um documento cuja resposta nunca se resolve fica Não confirmado, o que resolve a partir do Registo de lançamentos.
SAP de instalação local
Seção intitulada “SAP de instalação local”O SAP de instalação local lança através do agente, chamando a função própria do cliente para cada tipo de documento — definida em A função própria do cliente. Um documento cujo tipo não tem função, ou cuja correspondência de campos da função não tem nenhum campo para a referência do documento, fica Não lançado. Converter um passo de lançamento SAP existente traz a sua função e a correspondência de campos para o sistema, quando o sistema ainda não tem função para esse tipo de documento; consulte Contabilizar documentos em sistemas ERP.
- Simular constrói o mesmo pedido e pára antes do agente: nada chega ao SAP.
- Real entrega os documentos ao agente que serve o ambiente do sistema. O agente escreve as respostas do SAP num relatório na conta de documentos predefinida do projeto (em
/erp_posting/sap), e cada documento fica Em espera até esse relatório ser lido. Um projeto sem conta de documentos predefinida não pode lançar no SAP em modo Real, e os seus documentos ficam Não lançados com esse motivo. - Quando o agente está offline, nada é enviado: os documentos ficam Não lançados, indicando que o agente estava offline, e podem ser repetidos quando ele voltar. Quando o agente não aceita os documentos em cerca de 18 segundos, estes são retirados sem envio e ficam Não lançados da mesma forma.
- Um documento que o relatório do SAP deixa por decidir fica Não confirmado. Resolva-o a partir do Registo de lançamentos.
Sage 100
Seção intitulada “Sage 100”O Sage 100 é de instalação local e não tem API de rede: os documentos chegam-lhe através do agente, que executa a Business Object Interface do Sage.
- Uma empresa por ligação. A ligação indica a empresa Sage e a sua moeda. Um documento de outra empresa, ou com uma linha noutra moeda, não é enviado.
- Os diários são lançados como lançamentos de diário do razão geral. A referência de um diário é a sua descrição no Sage, pelo que pode ter no máximo 30 carateres.
- Os pagamentos são lançados como cheques manuais de contas a pagar, para pagamentos feitos fora do Sage: um fornecedor por pagamento, a referência como número do cheque (no máximo 7 carateres), um
bank_code(do documento ou dos valores necessários sempre do sistema), e cada linha a indicar a fatura que paga com um montante positivo. - Numa execução Real, o agente pergunta primeiro ao Sage: um diário datado num período que o Sage fechou é impedido, tal como um pagamento de uma fatura que o Sage não tem em aberto.
- Depois do envio, um documento só fica Lançado quando as tabelas de lançamentos do Sage o mostram. Um documento introduzido num lote do Sage mas ainda não atualizado fica Em espera; uma verificação em segundo plano pergunta novamente ao agente, no máximo uma vez por hora, e um que ainda esteja em espera passados sete dias passa a Não confirmado.
Histórico de alterações
Seção intitulada “Histórico de alterações”Cada alteração a um sistema é registada com quem a fez e quando: Definições do sistema, Retirado, Função SAP, Correspondência de códigos, Que entidade lança onde, Regra de retenção, Entrar em produção e Cópia de listas (cada leitura das listas de um sistema). Escolha Histórico de alterações em Definições na barra lateral ou no menu Ações, ou Histórico na linha de um sistema para esse sistema apenas. A lista tem Quando, Por, O quê, Sistema, Qual, De e Para.
Vê as alterações dos sistemas em que tem acesso; uma operação de Entrar em produção apenas para os projetos a que consegue aceder, e a retenção de um passo apenas nos projetos a que consegue aceder.
Quem pode fazer o quê
Seção intitulada “Quem pode fazer o quê”Todas as regras abaixo são verificadas pelo servidor, da mesma forma para a aplicação, a API REST e as ferramentas MCP, salvo indicação em contrário na sua linha.
| Para | É necessário |
|---|---|
| Ver Sistemas, as definições de um sistema, a grelha e a sua cópia das listas | analyze.connection.read, e apenas as ligações que consegue ver |
| Alterar definições, retirar um sistema, guardar a grelha, copiar para outro ambiente | Um administrador do espaço de trabalho |
| Atualizar as listas de um sistema | Um administrador do espaço de trabalho na página Sistemas, ou analyze.connection.read através da API REST e da ferramenta MCP erp_system_lists; em qualquer dos casos, o seu próprio acesso de escrita a essa ligação |
| Entrar em produção | O arquiteto do projeto num projeto que não esteja bloqueado, com o seu próprio acesso de escrita a cada ligação; uma pessoa, nunca um token de IA delegado |
| Ler regras de retenção | erp.register.view |
| Adicionar, alterar ou eliminar a regra de retenção de um sistema | Um administrador do registo (erp.register.admin) |
| Alterar a retenção própria de um passo | analyze.step.write, e a função de Arquiteto ou Gestor do projeto num projeto que não esteja bloqueado |
| Aprovar um documento retido | erp.register.approve e o seu próprio acesso à ligação do documento; indicado na regra quando esta indica pessoas; nunca o seu próprio envio |