Integração com o Monnae

Integração com o Tecsystem Monnae, de acordo com as especificações descritas na API de integração, com o objetivo de gerar títulos para cobrança de taxas.

Os títulos são emitidos em nome de Pessoas (físicas ou jurídicas). Por isso, o cadastro de destinatários deve ser mantido em sincronia com o cadastro de pessoas do Monnae. A única forma de sincronizar os destinatário do Facture-e com as pessoas do Monnae se dá no momento do cadastro do documento fiscal, onde a integração será encarregada de persistir o destinatário/pessoa no Monnae. O CPF/CNPJ é a chave que liga o destinatário a uma pessoa no Monnae, portanto caso uma pessoa com CPF/CNPJ igual ao documento utilizado por um destinatário a API apenas devolve o código da pessoa no Monnae para que o Facture-e grave esse código e concretize o elo entre os dois cadastros. Caso o documento não exista no Monnae o destinatário deverá se transformar em uma nova pessoa no Monnae.

O que deve ser tornar título no Monnae?

O Facture-e possui alguns tipos de documentos fiscais que deverão se tornar um título no Monnae caso haja integração configurada entre os dois sistemas. A NF-e, CT-e, Pedido e Ordem de serviço são tipos de documentos fiscais que deverão se tornar um título no Monnae desde que estejam configurados para isso. Outro tipo de documento é a duplicata informada nos documentos citados anteriormente. Portanto o usuário poderá gerar um título no Monnae através do cadastro de uma NF-e, um CT-e, um Pedido, uma Ordem de serviço ou através das duplicatas cadastradas em cada tipo de documento citado.

Como ocorre a transformação de um documento em um título?

A integração entre o Monnae e o Facture-e é bem transparente para o usuário, pois o mesmo não deverá alterar seu fluxo de trabalho para dar atenção a integração entre os sistemas. Portanto ao emitir os documentos citados o sistema se encarrega de fazer a integração funcionar corretamente e de acordo com as configurações informadas pelo usuário.

Onde vejo meu título cadastrado no Facture-e?

Não vê, simples assim. O título deverá ficar salvo apenas no Monnae, o Facture-e apenas se utiliza da API para gerar um fluxo de inclusão, alteração ou exclusão de documentos/títulos no Monnae. Então para que o usuário do Facture-e tenha ciência do título ele deverá acessar o cadastro de títulos do Monnae.

Mais alguns dados

Para que um documento se torne um título no Monnae é necessário, além da configuração de integração no Facture-e, que a série do documento fiscal (apenas NF-e e CT-e) permita a integração com o Monnae, portanto caso uma série utilizada em um documento não esteja configurada para a integração entre os sistemas o mesmo não deverá se tornar um título no Monnae. Essa configuração de integração através da série deverá permitir que o usuário informe somente as séries que realmente interessam a ele no fluxo da integração.

O sistema deverá decidir se transforma o documento em título ou as duplicatas do documento em títulos através das configurações de integração com o Monnae.

No caso da ordem de serviço que depende da situação da mesma para gerar um título no Monnae o sistema deverá sempre atualizar o título após a geração do mesmo no Monnae, mesmo que a situação não seja a configurada na integração. Com isso eu decido apenas quando será gerado o título na primeira vez se será com a situação orçado ou realizado, depois o sistema deverá sempre atualizar o título independente da situação.

• Local do banco de dados: caminho do banco de dados do Monnae a ser passado para a API de integração.
• Lista de integrações: Lista contendo a configuração de cada tipo de integração com o Monnae.

• Tipo integração: Tipos de documentos que possuem integração com o Monnae (NF-e, CT-e, Pedidos e Ordem de serviço).
• Título será gerado por: Duplicatas ou documento fiscal.
• Estado: Estado da ordem de serviço que deverá gerar um título no Monnae.
• Operação: Tipo de operação definida para geração de um título através de um pedido.
• Conta de crédito: conta de crédito a ser utilizada no momento da transição entre uma NF-e/CT-e em um título no Monnae.
• Conta de débito: conta de débito a ser utilizada no momento da transição entre uma NF-e/CT-e em um título no Monnae.
• Centro de custo crédito: centro de custo vinculado a conta de crédito selecionada.
• Centro de custo débito: centro de custo vinculado a conta de débito selecionada.
• Impedir o cadastro se o limite de crédito for insuficiente: impede o cadastro do documento caso o limite de crédito seja menor que o valor a ser salvo.

• Todas as operações que envolvem a inclusão, alteração ou exclusão de dados através da API de integração devem ser registradas no log de ações.

• Caso o sistema esteja configurado para integrar com o Monnae e a série utilizada no documento esteja configurada para integrar com o Monnae, o sistema deverá incluir um título referente ao documento fiscal (NF-e/CT-e) no Monnae desde que não exista duplicatas cadastradas nestes documentos. Caso haja duplicatas estas se tornarão títulos no Monnae.
• Fica a cargo da API validar os dados obrigatórios para a inclusão de um título no Monnae, e caso ocorra alguma exceção a mesma deverá ser lançada pelo Facture-e com a mensagem oriunda da API, informando sobre um erro na integração mais a mensagem oriunda da API.
• Caso não haja contas de crédito e débito configuradas no sistema deverá ocorrer um erro no momento da integração, porém o documento fiscal deverá ser salvo no Facture-e mesmo assim.
• Caso não haja centros de custos configurados no sistema deverá ocorrer um erro no momento da integração, porém o documento fiscal deverá ser salvo no Facture-e mesmo assim.
• Para o caso de NF-e, o sistema não deverá gerar título se a NF-e for “Sem Pagamento”.

• Caso o sistema esteja configurado para integrar com o Monnae e a série utilizada no documento (apenas NF-e e CT-e) esteja configurada para integrar com o Monnae, o sistema deverá incluir um título referente as duplicatas inclusas no documento fiscal no Monnae.
• Caso a integração esteja configurada o sistema não deverá deixar que um documento fiscal seja salvo sem que haja ao menos uma duplicata inclusa no mesmo.
• O sistema não deverá permitir a inclusão de uma duplicata sem uma conta caso exista a integração com o Monnae.
• O sistema não deverá permitir a inclusão de uma duplicata sem que haja um centro de custo selecionado.

• Caso o sistema esteja configurado para integrar com o Monnae, o sistema deverá incluir um título referente as duplicatas inclusas no cadastro no Monnae. Caso não haja duplicatas o sistema deverá transformar o cadastro em título no Monnae.
• O sistema não deverá permitir a inclusão de uma duplicata sem uma conta caso exista a integração com o Monnae.
• O sistema não deverá permitir a inclusão de uma duplicata sem que haja um centro de custo selecionado.
• Apenas títulos de créditos serão gerados para Ordem de serviço.
• Pedidos pode ser alterados para crédito ou débito na inclusão, selecionando tipo “COMPRA ou VENDA”.

• Caso o título esteja baixado (quitado) no Monnae o sistema não deverá mais continuar com a alteração do título através da integração.
• Pode acontecer do usuário configurar o sistema para que o documento fiscal se torne um título e ele cadastre um documento fiscal e esse documento se torne um título no Monnae mas ele de repente lembre que não era para ser gerado título através do documento e sim da duplicata, daí ele muda as configurações do sistema para começar a gerar título a partir das duplicatas, com isso ele vai no documento fiscal (NF-e/CT-e) altera o mesmo e inclui duplicatas para ser gerado título no Monnae. O sistema deverá então perceber essa mudança e deverá excluir o título no Monnae referente ao documento fiscal e deverá incluir o(s) título(s) para as duplicata(s) cadastradas no documento. Esse processo deverá funcionar também na função inversa onde serão excluídos títulos referentes a duplicatas e incluídos títulos referente a documentos fiscais.
• Um documento com operação de entrada deverá se tornar um título débito no Monnae e um de saída deverá se tornar um título de crédito.
• O sistema deverá validar a série do documento fiscal antes de integrar os sistemas, caso a série não permita a integração a mesma não deverá ocorrer.
• A tentativa de conexão com o BD do Monnae deverá ser realizada na saída do campo onde fica descrita a localização do BD.
• A integração não deverá afetar o limite de crédito da pessoa no Monnae.