| Parâmetro obrigatório usado quando criar uma assinatura. Designa a regra da assinatura a ser criada.
O valor esperado neste parâmetro é um string de símbolos conforme a especificação iCalendar, ou Internet Calendar, descrita na RFC5545 (ver http://tools.ietf.org/html/rfc5545).
Esta especificação permite, dentro de outras coisas, definir regras complexas de assinatura, via a propriedade RRULE.
Por razões técnicas. não for possível definir períodos de assinatura inferiores a um dia.
As palavras chaves SECONDLY" / "MINUTELY" /
"HOURLY não são levadas em conta.
Exemplos: -
Para definir parcelas de pagamento que ocorrem o último dia de cada mês, durante 12 meses, a regra se escreve:
RRULE:FREQ=MONTHLY;BYMONTHDAY=28,29,30,31;BYSETPOS=-1;COUNT=12
Esta regra significa que se o mês corrente não contém um dia 31, então o motor levará em conta o dia 30. Se o dia 30 não existe, então ele levará em conta o dia 29, e assim por diante até o dia 28.
Outra versão desta regra é: RRULE:FREQ=MONTHLY;COUNT=5;BYMONTHDAY=-1
- Para definir parcelas de pagamento que ocorrem o dia 10 de cada mês, durante 12 meses, a regra de assinatura se escreve da seguinte forma: RRULE:FREQ=MONTHLY;COUNT=12;BYMONTHDAY=10
- Para definir parcelas de pagamento que ocorrem todo trimestre, até o 31/12/2016: RRULE:FREQ=YEARLY;BYMONTHDAY=-1;BYMONTH=1,4,7,10;UNTIL=20161231
As parcelas ocorrerão todo dia 1° de janeiro, abril, julho e outubro. A quantidade total deles depende da data de início da assinatura (ver parâmetro vads_sub_effect_date).
Para maiores detalhes e exemplos, você pode consultar o site http://recurrance.sourceforge.net/.
Campo de entrada e de saída, retornado na resposta (IPN e URL de retorno).
|