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.
Caso um documento tenha gerado um título no Monnae e a configuração de geração de título tenha sido modificada para duplicatas, o sistema deverá excluir o título mesmo que não haja duplicatas no documento.
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.
