Académique Documents
Professionnel Documents
Culture Documents
MANUAL TCNICO
Real-Time
verso 1.0
Ifthen Software
Rua S. Jos, 757
4535- 404 Sta Maria Lamas
info@ifthensoftware.com
suporte@ifthensoftware.com
www.ifthensoftware.com
IFMB Manual Tcnico
ndice
IFMB 2
IFMB Manual Tcnico
* * * NOTA IMPORTANTE * * *
Em todos os exemplos neste manual iremos utilizar para fins demonstrativos a Entidade 11604
e a Sub-Entidade 999. Em casos reais, no dever utilizar esta entidade e sub-entidade mas
sim a entidade e sub-entidade que vos foi atribuda pela Ifthen aquando da adeso ao servio!
Como proceder:
Dever disponibilizar ao seu cliente a seguinte informao para que ele possa
efetuar o pagamento (Entidade, Referncia e Valor):
IFMB 3
IFMB Manual Tcnico
Entidade: 11604
Valor: 25,86
Notas:
No basta enviar ao cliente a referncia. Ter sempre que lhe disponibilizar
a entidade, referncia e valor a pagar;
Os 9 dgitos da referncia multibanco so sempre construdos da seguinte
forma: os 3 primeiros dgitos so obrigatoriamente os 3 dgitos da sub-
entidade (999 neste caso); os 4 dgitos seguintes so o ID (1234 neste
caso); os 2 ltimos so os check-digits calculados (90 neste caso);
As referncias criadas apenas podem ser pagas pelo montante para o qual
foram geradas. Caso o cliente tente pagar outro valor no conseguir. Para
isso, ter que gerar uma nova referncia para o montante pretendido e
envi-la ao cliente;
O cliente poder pagar a mesma referncia mais do que uma vez;
Pode gerar quantas referncias quiser, o n de vezes que quiser. Se voltar
a colocar o mesmo ID e o mesmo valor, a referncia que ser gerada ser
sempre a mesma. Quando cria referncias, as mesmas no ficam
guardadas nem so enviadas para ningum (nem para a Ifthen, nem para
a SIBS). Apenas quando forem pagas entram no sistema;
Caso d a mesma referncia (com o mesmo ID e o mesmo montante) a
vrios clientes, todos eles conseguiro pagar, mas depois no ter forma
direta de identificar quem pagou o qu. Por isso se aconselha que utilize
sempre IDs diferentes e que lhe permitam depois identificar quem pagou o
qu.
IFMB 4
IFMB Manual Tcnico
Por outro lado, pelo mtodo anterior pode criar referncias em qualquer
computador ou outro dispositivo com ligao internet, sem necessidade de
instalar qualquer software.
Como proceder:
IFMB 5
IFMB Manual Tcnico
Caso o seu web site no tenha sido desenvolvido em nenhuma das plataformas
para as quais disponibilizamos o mdulo, verifique com o seu Web Developer a
possibilidade de integrar o nosso servio no seu site. Ns fornecemos exemplos de
implementao e damos-lhe toda a informao e apoio tcnico necessrio.
Caso o seu software de faturao possa ser configurado para incluir as nossas
referncias multibanco, as mesmas podero ser impressas nos documentos,
automaticamente, sempre que os imprimir.
2. Manual do Back-Office
Para aceder ao back-office ter primeiro que se registar, utilizando para isso a chave de
acesso ao back-office que lhe foi disponibilizada pela Ifthen aps a assinatura do contrato.
Pode repetir o processo e efetuar mais do que um registo para utilizadores diferentes.
IFMB 7
IFMB Manual Tcnico
Aps efetuar o registo pode ento entrar no back-office em qualquer computador ou dispositivo
que tenha acesso internet.
Repor palavra-passe: utilize esta opo se se esqueceu da sua palavra passe. Ser-
lhe- gerada uma nova palavra-passe aleatria que ser enviada para o e-mail que
indicou no registo. Aps a receo do e-mail poder utilizar a opo seguinte para
alterar a palavra-passe para uma da sua preferncia;
Alterar palavra-passe: utilize esta opo para alterar a sua palavra-passe;
Aps efetuado o Login, surgir o menu Multibancos onde poder aceder s vrias
funcionalidades do servio.
IFMB 8
IFMB Manual Tcnico
Menu Multibancos
2 3
IFMB 9
IFMB Manual Tcnico
Na parte superior da pgina (rea 2 ), pode definir os filtros pretendidos para a informao a
apresentar. Pode nomeadamente filtrar por entidade e sub-entidade (no caso de ter mais do
que uma), por ano e ms de processamento. Sempre que altere os filtros ou sempre que quiser
atualizar o quadro de pagamentos ter que clicar no boto Atualizar (rea ).3
Pode ainda pesquisar (filtrar) no quadro de pagamentos por qualquer dos campos,
preenchendo o valor a pesquisar nas caixas de texto de cada coluna (rea 4 ). Note que estas
pesquisas esto tambm condicionadas pelos filtros definidos na rea 3 . Ou seja, se
pretender saber se uma determinada referncia foi paga numa qualquer data do passado, ter
que configurar o filtro do ano e do ms para o perodo no qual deseja pesquisar (ou colocar
Todos para pesquisar em todos os anos/meses).
Pode tambm ordenar o quadro pelo campo que quiser, simplesmente clicando no ttulo das
colunas a ordenar.
Caso pretenda exportar a informao do quadro de pagamentos para Excel (XLS), PDF, RTF
ou CSV basta clicar no boto respetivo (na rea ).
5
IFMB 10
IFMB Manual Tcnico
Dever disponibilizar sempre ao seu cliente a Entidade, Referncia e Valor para ele poder
efetuar o pagamento.
IFMB 11
IFMB Manual Tcnico
IFMB 12
IFMB Manual Tcnico
No caso de necessitarem, por algum motivo, de desenvolver o clculo das nossas referncias
multibanco, deixamos aqui a explicao passo-a-passo do algoritmo de gerao das referncias.
No sistema multibanco existem 3 conjuntos de dgitos utilizados pelo cliente para efetuar o
pagamento: Entidade, Referncia e Valor.
Exemplo:
Entidade: 11604
Valor: 25,86
* * * NOTA IMPORTANTE * * *
Em todos os exemplos neste manual iremos utilizar para fins demonstrativos a Entidade 11604
e a Sub-Entidade 999. Em casos reais, no dever utilizar esta entidade e sub-entidade mas
sim a entidade e sub-entidade que vos foi atribuda pela Ifthen aquando da adeso ao servio!
Esta caixa deve ser impressa no documento de venda (usualmente no canto inferior esquerdo) ou,
no caso do comrcio eletrnico, apresentada/impressa pelo browser e, preferencialmente, enviada
tambm por e-mail nos detalhes da encomenda.
A data limite de pagamento pode ser tambm apresentada, mas transparente para o sistema
que aceitar pagamentos em qualquer data, mesmo posteriores.
Os terminais multibanco aceitam tambm o pagamento da mesma referncia mais do que uma
vez, pelo que o tratamento de pagamentos duplicados dever depois ser tratado
administrativamente.
Entidade
A entidade ter sempre 5 dgitos e ser fornecida pela IFTHEN.
Valor
Valor a pagar com no mximo 8 dgitos (excluindo o separador decimal) : XXX XXX,XX
IFMB 13
IFMB Manual Tcnico
No caso de valores inteiros devem-se visualizar sempre as duas casa decimais (por
exemplo 25,00 e no apenas 25).
Referncia
A referncia composta sempre por 9 dgitos (em grupos de 3 facilita a visualizao) e no
nosso sistema composta do seguinte modo:
SSSDDDDCC
Em que
SSS: trs dgitos que identificam a sub-entidade (o vendedor). Este cdigo atribudo
pela IFTHEN.
No exemplo de cima:
11604 o cdigo da entidade;
999 o cdigo da sub-entidade;
1234 o ID - n do documento/encomenda a ser pago ou o nmero do v/ cliente;
90 so os dgitos de controlo;
25,86 o valor a pagar.
Resultado1=
51 x 1 dgito +
73 x 2 dgito +
17 x 3 dgito +
89 x 4 dgito +
38 x 5 dgito +
62 x 6 dgito +
IFMB 14
IFMB Manual Tcnico
45 x 7 dgito +
53 x 8 dgito +
15 x 9 dgito +
50 x 10 dgito +
5x 11 dgito +
49 x 12 dgito +
34 x 13 dgito +
81 x 14 dgito +
76 x 15 dgito +
27 x 16 dgito +
90 x 17 dgito +
9x 18 dgito +
30 x 19 dgito +
3x 20 dgito
Pagamento da Referncias
Imediatamente aps ser gerada a referncia, ela pode ser paga nos terminais Multibanco (ou
HomeBanking, Telemultibanco ou MBSpot) na opo Pagamento de Compras/Servios (do
mesmo modo que as faturas da eletricidade, gua, gs e telecomunicaes). Repare que no tem
que fazer o envio das referncias que gerar para qualquer web servisse da Ifthen ou da SIBS. Elas
apenas tm que ser corretamente calculadas para poderem ser imediatamente pagas. Por outro
lado, as referncias multibanco apenas podem ser pagas pelo valor para o qual foram geradas (o
valor entra no clculo dos check-digits).
Exemplos de Implementao
https://www.ifthensoftware.com/downloads/ifmb/Exemplos_Implementacao.zip
IFMB 15
IFMB Manual Tcnico
Os dois ltimos pontos so os indicados para quem pretenda fazer o tratamento automtico
dos pagamentos.
NOTA: A gerao das referncias multibanco no so efetuadas pelo nosso webservice, mas
apenas a notificao dos pagamentos
4.1. WebService
https://www.ifthensoftware.com/IfmbWS/IfmbWS.asmx
IFMB 16
IFMB Manual Tcnico
Exemplo:
https://www.ifthensoftware.com/IfmbWS/IfmbWS.asmx/getPayments?chavebackoffice=
0000-0000-0000-0000&entidade=11604&subentidade=999&dtHrInicio=
&dtHrFim=&referencia=&valor=
Sempre que voltar a executar este pedido, ser-lhe-o devolvidos apenas os novos
pagamentos que entretanto ocorram (caso ocorram).
Exemplo:
https://www.ifthensoftware.com/IfmbWS/IfmbWS.asmx/getPayments?chavebackoffice=
0000-0000-0000-0000&entidade=11604&subentidade=999
&dtHrInicio=23-05-2012 00:00:00&dtHrFim=23-05-2012 23:59:59&referencia=&valor=
IFMB 17
IFMB Manual Tcnico
Exemplo:
https://www.ifthensoftware.com/IfmbWS/IfmbWS.asmx/getPayments?chavebackoffice=
0000-0000-0000-0000&entidade=11604&subentidade=999&dtHrInicio=
&dtHrFim=&referencia=999123420&valor=10.25
Cdigo Mensagem
0 Sucesso.
1 No existem pagamentos.
2 Erro nas Datas/Horas.
3 Chave invlida.
9 Erro desconhecido.
Como alternativa ao WebService, podem utilizar o mtodo de Call Back para automatizar o
processamento dos pagamentos.
Este URL dever ser previamente definido por vs e enviado Ifthen por e-mail.
IFMB 18
IFMB Manual Tcnico
Devero tambm definir e enviar Ifthen uma chave Anti-Phishing (uma string com o mximo
de 50 caracteres) que ser devolvida como parmetro quando chamarmos o URL, para que
possam verificar a autenticidade da mesma.
O URL indicado por vs dever incluir os parmetros que pretendem que sejam devolvidos
(entre parntesis retos []):
Exemplos de URL:
http://www.yoursite.com/callback.php?chave=[CHAVE_ANTI_PHISHING]&entidad
e=[ENTIDADE]&referencia=[REFERENCIA]&valor=[VALOR]&datahorapag=[DATA_HOR
A_PAGAMENTO]&terminal=[TERMINAL]
http://www.yoursite.com/callback.aspx?chave=[CHAVE_ANTI_PHISHING]&entida
de=[ENTIDADE]&referencia=[REFERENCIA]&valor=[VALOR]
O vosso URL no tem de devolver qualquer valor. O sucesso do nosso pedido determinado
pelo cdigo HTTP obtido: Caso devolva o cdigo HTTP 200 a Ifthen considera que a chamada
foi efetuada com sucesso, caso devolva um cdigo diferente (HTTP 400, 500 ou outro) ento a
Ifthen considera que a chamada no teve sucesso e tentar novamente mais tarde (tentar 13
vezes sendo que as primeiras 8 sero de 5 em 5 minutos e as restantes de hora em hora).
Caso nessas 13 tentativas no obtenha a resposta OK, no voltar a tentar, e enviar um e-
mail a notificar o erro permanente.
IFMB 19