Introdução
Se trabalha com o King ERP da Björn Lundén, envia as suas faturas do Catermonkey diretamente para o King. Escolhe como: se é o King que trata da faturação, cada fatura chega como encomenda de venda, que o King fatura com o seu próprio número. Se já envia as faturas a partir do Catermonkey, a ligação lança-as no seu diário de vendas com o número do Catermonkey. Nos dois casos, o Catermonkey adiciona o cliente ao King como devedor, e o IVA e os proveitos ficam nos códigos e nas contas que escolher.
O que precisa. A ligação ao King é um módulo à parte, por 19,50 € por mês, que se ativa em Definições > Integrações. Funciona com o King ERP (King 5) que tenha o King Webservices instalado; o administrador do King ou o seu parceiro King trata disso no seu servidor King. O Catermonkey tem de conseguir alcançar esse endereço pela internet, de preferência por https.
Passo 1: peça ao administrador do King que ative os webservices
No King, o administrador vai a Diversen > Vaste gegevens webservices e define um código de acesso em cada um destes webservices: Webservice_Test, Debiteur_ToevoegenWijzigen, Order_Toevoegen, Order_OrderRegel_Toevoegen, Order_LockVrijgeven, Order_Wijzigen, Order_Verwijderen, Boekingsgang_Toevoegen, Boekingsgang_Journaalpost_Toevoegen, Boekingsgang_Journaalpost_Journaalregel_Toevoegen, Boekingsgang_Journaalpost_Verwijderen e Boekingsgang_Afsluiten. Um webservice sem código de acesso fica desativado no King.
O administrador dá-lhe três dados: o endereço do King Webservices (com protocolo e porta, por exemplo https://king.suaempresa.pt:8082), o código da administração e o código de acesso.
Passo 2: introduza a ligação e teste-a
Vá a Definições > Integrações, abra King e preencha Endereço do King Webservices, Administração e Código de acesso. Clique em Guardar e testar a ligação. O Catermonkey guarda os seus dados e pede ao King uma resposta de teste; quando funciona, vê "Ligado: o King Webservices aceita o código de acesso."
Se o endereço começar por http:// em vez de https://, o Catermonkey avisa-o: o código de acesso circula então sem encriptação. Use https se o seu servidor King o suportar.
Passo 3: escolha quem fatura
A caixa Faturar a partir do Catermonkey e enviar para o King apenas os lançamentos de venda decide o que o King recebe:
Desmarcada (predefinição): o King fatura. Cada fatura passa a ser uma encomenda de venda no King, com uma linha por produto e o nome do produto como texto da fatura. O King fatura a encomenda com o seu próprio número de fatura, por isso não envie também a fatura a partir do Catermonkey.
Marcada: fatura a partir do Catermonkey. A fatura passa a ser um lançamento no seu diário de vendas, com o número de fatura do Catermonkey, com uma linha de devedor e, por grupo de proveitos e taxa de IVA, uma linha de proveitos com o respetivo IVA. O lançamento é provisório, por isso o seu contabilista revê-o no King antes de ficar definitivo.
Com Usar o código de cliente como número de devedor, o código de cliente do Catermonkey é enviado como número de devedor. Um devedor que já exista no King com esse número é atualizado, em vez de ser criado duas vezes. Sem esta opção, é o King que atribui o número de devedor; o Catermonkey guarda esse número junto do cliente para a exportação seguinte.
Passo 4: associe as suas taxas de IVA
Em Códigos de IVA, introduza o Código de IVA no King de cada taxa de IVA com que fatura, tal como aparece no King. Uma fatura com uma taxa sem código não é exportada: o Catermonkey diz-lhe que taxa, em que linha, ainda precisa de um código.
Passo 5: preencha os dados para a sua forma de trabalhar
Se o King fatura (caixa desmarcada):
Armazém: o número do armazém King em que as encomendas são criadas.
Linhas de encomenda como: Tarifas (TAR) ou Artigos (ART). As tarifas não precisam de stock; escolha artigos se os seus artigos no King gerirem stock.
Número de artigo ou tarifa: o artigo ou a tarifa King em que uma linha de encomenda é lançada. Se quiser, use um artigo ou uma tarifa diferente por grupo de proveitos.
Libertar encomendas para faturação: aprova a encomenda no King e liberta-a de imediato para faturação.
Se fatura a partir do Catermonkey (caixa marcada):
Diário: o código do diário de vendas do King.
Exercício: o código do exercício; deixe vazio para usar o ano da data da fatura.
Conta de proveitos: a conta do razão geral para os proveitos e, se quiser, uma conta própria por grupo de proveitos.
Lançar como definitivo: deixe desmarcado para lançar provisoriamente.
Clique em Guardar alterações.
Passo 6: exporte uma fatura
Abra uma fatura. No cartão King, clique em Exportar para o King. O Catermonkey guarda a fatura, adiciona o cliente ao King como devedor e cria a encomenda de venda ou o lançamento. Vê logo o que o King tem agora: o número da encomenda, ou o número do lote de lançamentos. Depois disso, o botão fica desativado: uma fatura segue para o King uma só vez.
Quando lança a partir do Catermonkey, a fatura precisa primeiro de um número de fatura: uma fatura em rascunho não pode ser lançada.
Perguntas frequentes
O King recusa a fatura. O que faço? O Catermonkey mostra o motivo que o King indica, por exemplo um artigo em falta ou um período fechado. Uma encomenda ou um lançamento criado a meio é removido pelo Catermonkey; a mensagem diz-lhe se isso resultou. Ajuste as definições ou a fatura e exporte novamente.
Posso exportar uma fatura duas vezes? Não. Depois de uma exportação bem-sucedida, o botão fica desativado, para que uma fatura não chegue duas vezes ao King, como encomenda ou como lançamento. Para a enviar de novo, remova-a primeiro no King e peça-nos que libertemos a exportação.
O que acontece a uma nota de crédito? Uma nota de crédito segue pelo mesmo caminho. Como encomenda de venda, as suas linhas têm quantidade negativa; como lançamento, o débito e o crédito trocam de lado, de modo que os proveitos e o IVA são revertidos.
Que número de fatura recebe o cliente? Se o King fatura, o King atribui o seu próprio número de fatura e a fatura é enviada a partir do King. Se lança a partir do Catermonkey, o número do Catermonkey é o que conta: o lançamento no King leva esse número.
O meu servidor King não está aberto à internet. Nesse caso, o Catermonkey não o consegue alcançar. Peça ao seu parceiro King que torne o King Webservices acessível por https, ou que configure um túnel para os nossos servidores. Um endereço da sua rede interna (como 192.168.x.x) não é aceite.
E se um grupo de proveitos não tiver artigo nem conta própria? O Catermonkey usa então o artigo predefinido ou a conta de proveitos predefinida que introduziu nas definições. Se também faltar, a fatura não é exportada e o Catermonkey diz-lhe que grupo de proveitos ainda precisa de um.

