From b5eadf70385610cf56491ae0e3dc9442388cb5f1 Mon Sep 17 00:00:00 2001 From: DavertMik Date: Wed, 27 May 2026 13:57:07 +0300 Subject: [PATCH] Add Usage-Based Billing documentation New page under Management > Company documenting per-seat quotas (test reports, API requests, AI tokens), overage toggle, monthly spending cap, billable v1/v2 API route inventory, notifications, and edge cases. Opens with a docs-style 4-card comparison diagram of Trial / Free / Paid-capped / Paid-metered modes. Co-Authored-By: Claude Opus 4.7 --- astro.config.mjs | 1 + .../company/images/usage-billing-modes.png | Bin 0 -> 95223 bytes .../company/images/usage-billing-modes.svg | 83 +++++++ .../management/company/usage-based-billing.md | 228 ++++++++++++++++++ 4 files changed, 312 insertions(+) create mode 100644 src/content/docs/management/company/images/usage-billing-modes.png create mode 100644 src/content/docs/management/company/images/usage-billing-modes.svg create mode 100644 src/content/docs/management/company/usage-based-billing.md diff --git a/astro.config.mjs b/astro.config.mjs index 0be712a9..197a2c8d 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -417,6 +417,7 @@ export default defineConfig({ { label: 'Audit Log', link: '/management/company/audit-log' }, { label: 'Trials', link: '/management/company/trials' }, { label: 'Subscriptions', link: '/management/company/subscriptions' }, + { label: 'Usage-Based Billing', link: '/management/company/usage-based-billing' }, { label: 'Plan Features Comparison', link: '/management/company/plan-features-comparison' }, ], }, diff --git a/src/content/docs/management/company/images/usage-billing-modes.png b/src/content/docs/management/company/images/usage-billing-modes.png new file mode 100644 index 0000000000000000000000000000000000000000..d3a143ace028e48d4d6f562c6be5a7fc3dcea3d2 GIT binary patch literal 95223 zcmeFZcUV(f*Do4%+dyDj5b2_T6p;=BQY?rxm6Fgwq<85(U_lfFq?gc?CJCWKqy|BH zFQEkpNDUBruXl#GeDAsEoaedEeePfPd~54o$;z5@jxpvazcJ>Vet!8}fr^5G0s?_h zDL#9m4uM=8hd@quT{s7xtOYy*Um!P4o~f%sAYPmhi2nx&WDh*@pMyYL1t5_5R}hF~ z90Wr5Cb3-Y0r=tEYh{HekYnON=@y_wSALiX7Bnno~_W+JZ`_=JzK8Ae2_bRvFbz2X+<}J?CVD{Nu#!6X6}*8 zv*ka>+7pN3g&&Uv;)Ssi3a0^C|9$a{@!wy6o`*nE$1lXz2Oj|6O%Zeet0cdln%d;> z&qqkjX-vbGZ6njP~>Sd!ISpipTc?dr^F$UmwinR0VmCabU$}EWN@o^I-xU& zM}XXc2Nwf4B%fVBvj*HN*M&8`)!XEu-`&L0%Kq~a-cQL(&S`c}X-^t7knc=N)xK3{ zdii9CKXP#12PZ=?fgu9P6b3!cZgJp{co6@6^Y57ii z2JC&8ho6B!0zwWlBj_VWC_?wQn62$EUYfHhGAsSstlwx})Gvx?3y-L+@;wEC)XXN9 z4(D9tjP%U2?e`T!SnZef6`!SI>>pY+s!$WSyZW&3?{KmN|JP&0C@b>T2$u~f$9eq7 zYkpk@E!>P$!BvjxKp^AGwt=R?eEB-UGAM(JhChoTbjwqVtz%17VJB?9egfzH>x9iO zfKC4sHr0r24jkE#&M8~HN44SS%!7$k@glb>e!Uh%*~b5U_Wb!4TcK84v1VH_?|lXk zhQbPU(S^Ep;Qx~DG6vk)RxNGChJ(K{3AQk4ScO~ksD$3)^fq5u&p*1qw2OXrBCv2a zEbYY;feB4vD3z2>CHJnxd5o_xaz^g{S`0C3{qVzf=kfKV>s!u0L;OKT`CCVn$()!+kZUbMem~7uZ_olfrkbM zQ_@`G-o_}F=0;q*!j!(^^o`;|zDETXOy-B?rl!7Z;buwqC7=Fth!|#xL=US9H&O?e zcd)d3md?FwvU1j-njChYlIPY?9^NWWrhWz46GJ$tf^-TzSQ_>IVJMe6{UW}v&sHe= zb^V*O=g)dod9{cGyT2~ zG6Or8)(|J=Q)3Yob1>6+*5l)ZAlt+<-y(TlGa>oE&YnZ6*T0ExKk|tORHbO6VM)&< z(d$I|2;0US`uXehI--Vjr(b`*5YBSzq~phM=g;Kn^`YKv=QyETB7+SZUp0D)Mj}aU zi0Rdy0jI{3At5#-lUnl11)%QHL$N$^g zohT?MqMA*uVI{g~df9`O_c{%1g?%T48a;xyGM;pOWleAFMCP$kQwK9)N#Z#!Dk=|r zu+6XGt*;AySWgED?M_C699x?`(VaFxr^cYCEfP7 z{K^!(dYm7~;`C8^CFkD~bup$nor2A*MVj~hFM%^hI}sm*Pdd=;WG9U!b=^w0ZQ_hHMZ!cMnHOOVt^l7#%z>e(StZyIQJ(ii(Y}X!;Zml@=K{Mm zTVxKeE69+w-=DyS9rEKOD}a##yy#ek%zAZh`n0%T!l_OH`f~w)5$-f==IV1zTn0MF zUNn@GpI;bZdhyc5a$c=S)Qb9*cT^{n!Lf#rK4IB)O5FQ|(gh`5_Je)Q?6qeAR|O$jamIZo`)QD82`Lh&jTmo9xBGDTjlvUpK3qMBPhLxR&yMTCe&kQu|?#G0LS z>-P}e`iRWd(RX&h7I#f6Usi3msUS^k`uO-whwY0X0=@Y4P$!;)J-_XZnHdAtH~4nS z$z1V=6He~fum8M9MFBlK>p>^!Acl!duknXCxSu6AfBW{jVnn^Iy|-FqXJA9^KZg5o zaN-A!0{(f=NS_kN-m3wg3CG@SySmT{VoJt``ou^bA^ah4jGo+yef+Q3^Sf6A1kJ^L!1(}7v)mPOuQdd+qCpOVji$vZR=}sq*1TF^ zKM?Xz5co&3&lxv5xQE>}Ih9NpH3bjvsMy=DyK}52fIf&%$fK?BlT`|G{3mv|eSmVs z=ja^h|JoV9mM2GjT41)n|9KJLl(GkszL%N@+*fxsjDR8q1-&r4WyD|8+MZ?41iCsk z9c`!dXp8&e0O;y#$Ug=?q2j3CVI3h$I}RHC$2Bg@MP}zeu9`E~{_pRcI^pR*-dXX- zULTLI93}TPb>gaPfc}6l2mkn@d{6?R0UFHy`s*bio&VuC?2bGUNkTL0TB9+ z%m4iUE4mnm|D_H;Z=Chuc)57Ws+R@jwpc_Qv?A_UO&;E=&ET2N zm~m~hHXx**6RjL|2D;eOJbD1jsMIWZrx;?bsA`Sq`&p{^klpLwf~~Rf(ARqOn>k`8 zr^tHJ9?_9mww*M2EIl$B{|d+7nx6l6w!!1bbM68tLs17KK$Tqcb@yj`7D-UVS~wvz zIU+Q<&=hdTLdwVoyJ> zoXmlI0NN^jx>BE;B<9J?vUjO^P*x9hR$D zt97Q2p;hMl2Gb$I7;j)z{*|@_i{3wcOJRh=(vi$xBs&V;I^_ZgB+48};~Q0hSk-m~ zlt`buZKKnf-cX`K!FxO4<1=G3c7&?Z^VU6QF=){9Vj$zmzpWyRT~Mkv--TV5pB3pU zTxJ4F@u0vMqq^L_aTlwoQ`Vkzz^RDX8rmtl9~X5Mkk)quPoYD&`s9 ze6NE@N3V+6g6Rh41# z03RM#&w9YkC(IGmadxi5W7(e-rS;xvgB@+wKc0DQO@lIjRnaw$Ou#oRopzgCg$lUACvqq3Acp2RR1s z4_NWFDvdy-UO=Sbvalf$lkn9#{Ezt_*F!#Qb*bY@$o=Z|K;Q#^6(pbbaGDjpIv>+YNw9VrsdBdO=go)7?ueTf8 z;KC!tn58(FrAT`_>=J;ZQ^_gXCB3_Kc*b+_qWK0BPbxCQdxFKaMJ$q3HD)D}m+`wW z=sgQq7UvU1Fo+gRe*Y;PQP706racK0OZQXQ(4nPPL>Qu!R8n?W^;ERTykucmgx488 zV%7V-9ahis=CCSS%1*beH#2BD-H=apzPBX@Nn7bl2Rc*=#SRQ^96mzjJpVpg=0Xe} zf}sf9_1y53Qg$3UeH~;jum#>b7HG`imn0mP8axZGJe% za!n8XsG4jAEmwo1EY(JlW7WdowQ8G&TPWa$B)$YlXyktBLqTEP`t29?ORLeU^Z4QK zXBso)^>TCz>oMDR7A7+LKf{|tzKWMfHio``+VGJPJy9A-SQsT*Vz-h zJJEZD3>^vEdTNABVzm2e((g;achqdJ`!|mlaqq7my;tbv$Tr_>8C$XlmvDUQHG@z| zQYs~|7{a{%Fa%rEt!6Z`#&8~fB?`!CvuS#*J`Lvi;I&VE3IGLaCP_|3Bs5Kl-mHo# zen0GzOzU_N|81;9vqKp!_pY=nTHe@<;`o4!7bxg<(Nn;aJ-4_j)>BXbtS+H1*ZAlo zO#Jt7u?MhflaYPgPxo}4B!>OH6+R%2zyp}%8iF_Qh0^i1bLJK+fAadMaBWUUjtod6 z8kHWwg}p1zydkyv);m@7u-xthd|Lvc#`Wayl_zE8RnnUQzo=_i=iT*0GQ%cwJn8VojTQ}Gf!Gfk_Oubn$$u($><{FMGG(m0 zH3oDw+3xx^R%hnvxQC6eN&=+)7vZ`eU{8jhov1(ganbo zib>C`&epa8N3z)!63^|DS`5vr9{hTJ-`laa``ElznfIW&*v3+bNls)Qpiwz1I`fy> z+dWj*M@4?;oD&UNs-&_}5~mSesAs%OZ8u?7zi~wt1~h4O+dLevbG z&lwQ#?1h1i{)bo(6|am>K`ZuUzjJDWlcyV)Bl@32k};+eC8Z-1ud;-e&+H4aINCDX z3&Ppp@z2Tj6rmE)F^|fHi07QZM(U?qsbXD(h#8E0NcAzecZO3BBcyA53a@ITIv#)isl!pq;)iJ%V21q=g6X6Ql_*}&oIdf!FMnuq6A_pKmx@@ zgel;QZLpJD<8s90%efYqR3z@&d|=Y8n5bJ9h-e#rlXHw z!_?Rvn&@)yJbJB-493642FFH6rz2_8XLH3-&XEVx*+&(|r#u>R+DrVF0ow6u%(6%R2S{-9Pw!{orakm{I?fhM0 z#8~vDN6+o@SS!JtXEn~3{87V%kAjjru{xS6rW_++HTIFxx2?sYG*R3OP_0xU31!06 zGZ$tXA>K`AtkaA6inJn2D(=~mV^=a?8;{mjZNVgs)J(G%&NiaS2Fz;ilMe`yoFYX( zbVrK@Gef+~{+mWR_0a;~JXJ<_eDQv&s-i`PMzapSHBgDRF8!mZs`WruPG`H*(w^qgQSEh$pN-~XZa7xzuuaPf+p_z_<1-Ud6-&Brf<>$G5g6Z~v_`96-0Af4xCt1P zwTNU|*HhhI({rSqIIEp5Ms-3-ZeO^hY`+ju{UU3yk(WG~ZkfYT3rpjnjNykrLB89DL9Tj~Gq?}3;fTAzmD(ulMw6-8QuG5Df_f9z8G17gt)R3Ec`EsnrB^N1{6GTlAA$5_<`$@d<6D@wXw+XMN6*;* z%qM9UZv4UM$a@g@isu2Msx#TPv+J2OX(Lj$cr(sT?$Q)b$My}#T`6lijwm5%%M^GEQ?J^0{4&N7(k z45)uSa7>G=$YiCMKhy?0L$)#R?(y_UA$X*>-IVK)TnY9#_V7_leiM?yS5= zo{!f3)^0FbjdtME&w53$j?#D%f1)-U~Cj=73Hx;nAkptE;N^sWCvu2D4M z`#lhbamm?uLVF*WYe|GPLB{>P>VB9Md^w24Tw1#SJCe3AbahHAG{7a##{q}OYSXgt zNINIV->#4{FZET(2tasF(1M)#)9DAS8Zv!?IY~;~gMz>`v!6p7Nf#9|VjmPedg}ArRIlbSc9)E~-l(}kHtJY~zD`oeUyY(anE*9I|)VaqXXz+8$ z924<7b&JygKj0cl!Osf_S}crP(kxU}E*+LlEs4tzQyZ%WZUJ&c#7x6T!~7YEk^R31 zizW9S^(#s7A6E9QP6zg@0T&Y%v`k>&>PJzI_szLr`e_rNjvdV8oC1#h7t$K#dL_oBhj z<6%5EOjCQC&$c?q7cimKQd<7O#9wC<`ZBT)-}kAYKzecruaiW$LLDZ*;fA9#=Eqn*Ls?dPAxl#*1j$DRdQ+weuTs^fK z<5v>ol{!O(dA}zvI48cq5DA;1CRVX--*$kZq~>coS1tY>ITu&Oc}Z}#Qr~;-3CuA` zDm1A>5*8ppYirNeo#a4RTv!<)G8kK8-d&2Wq&rG zU^6qR@_wSy3zr_4E3&X=Pq&3)x)(AJpSbKDcAfL=xk10>8b@+Pkjsu7BB`tgX^NSZ zBB+zO5={a>#%*l4Hqbb3v&N1c@-557z0s6}H^B7{87@(u1~#zpXS$y3hM2ZjUeR%X zxm770nEoXg)^$>(z3;AQ(U`Nb;DicIabuFQ8K_C$R{&XTlK1ZXjupZ@H($~gn|^f{ zR1I$OJNFN{v>uzyXXgoRVz-4{2XQ&BW#945MO&(Lo!a`mk0gpF%z|a_R&7Q?TT6%g zKw&|gN^k*(xJ%vIVd#?+d5-rpNO&U1iriNnKKTltFjwoXaSM10ubfpC52>x8wM0h; zyDui*fln{}O(q^?V$yimG%Ef9wCh$Svp4g8PxwiJRkPw8r#uuxhzaLbMHsDo*~T#; zezjg!U*K9J7a0tXblfN8KNe;81TlB4>nz1wrBl6kQo)jiVdgSms9_#BIp^DhRO zfLATI+yhT>=J^LcI;t+4zl*A4B*>6*?8+v?^wuTqVMhE%>u z0|w#qB$hMul=ae6ln|PQsqNy6;1y6~nJ{k*b+K$aV+h{RvS*sQ?@}(-kZI>F&6N%SIoz_vLv(%jj3HHU8xil_Q5iQj#K6W&=9T}SRB9lT1 zt;K~?cY&{GzAYv5<58RCo$_h&X&Sz$>^ z9ey2B(YC#_Ma)KD<_P`iO*~)FK-sTltkLoDS8RWpl(Cx45ZhF>W;RpLaB66bFK80% ztY>xey$7PynwtM?+Bx?(2dMb65u`IQz&knrZ*ndG(suJv-!h#r1JZ%ktp<5kV+iHni^VjE51kGD3Il-gqC8D+)Et0~?~*wjjZY zZ0t*yDx73$I=tbB)pnJvhkFmbBF>MU5bM!4Wr(krceI)%S@bGP@k{SQGc(%? zteq28rS%dvx-5&3TE)j>-5Nc=uF}C}64?W1F|_2;cWU26Ga_uhzin#e<)#X9qki#` ze&gNPrFPZ%p1#djge*UEp55>C(0N#-WPuM*Gk;^a6oS)t_r=64CSS<2?ZdV~zX};J z@DRWFdLJ^VXK|inwC*21#<}1H8rk|r&u0)RNBCl!s9@hd@ zG^I*)IHO(PfknI zg&H{d9v8F-(zw~St!n_wVLaO0Hs+g8=qpS%83gPh2hY@NeW3HM$t12b*O?&p zI7N~5H-S@?E1hvwv1Xo*3(GvP!R4L_@T<-j0yrxi%7hP10vS#2TTtEh-Un;8kew8p z{rGFpQOEs_-Q3_6^SqMz!1~Zh50FEf>Y-WSRE?ZrY@14;PXsAnNIp8M9I_~i)d#*L#7`f~Dxw(vq|piX~o%mqCf zVIz`K(1ivf&u?76H7fGKh!wCOJZk!tz)nmu5(;L=21JJ^S2lQXR*tj;nr{Mc4%xL3 zM7SLPprp}rM#vB{JsFu!sI=bmY5Y?Gl>bQ0T&L}1apziG^I<8kmt<&2JHfJ-6=loA zc(=+Wt$t-%SCN9^YcA0S))}Ki64n|lHbt5AGmb{Cf>M*x?JNFaAQnhFfhrIk`kI@h zyqB>qfZ#mk@hdP=F|nQ)FBxf#m9DuZ?Np)@-Qu~w1jyP+{^ZnCm&QjS(&Er7Tq0S1 zAtudL@M<#q*>lfmjI7iGUOEs!Y6v-oW+y6!>6^h``kUaR{OtDN#{J4UFocL*wd1P6 zo79a#oOv`&#z|=X>1zL4o%#K05q)ru*R(gPr$ZUE>_>^~Fd0^Q0I2@aU5q%#O`Kj9 z+U&j3NGC84jg%C*HG2y3k^wk|^Ya4&#L$UQKPWN2M+&RExlmZ^`^hG9WAZg>?06Kp zq0+b|#V?A2yOLM&{DrBkl`z!8O%C)u-oli!Sj8TK4O;2G^@v;Jo1%H>`j!Duj}<>E zn}m%y-1WL!m9koR5uyT$^Y9f;)+Qu)nT6FvO}YUGn4}14kHMDWKT1{K=T!tDW@B(R zJ^}M96Cj?}ig;S4I9z|8Dr{n`l1fbaNIuhz^FCa*>(;1b+jtE?6q*;fcGzArm5Ydi z)tRDdqq!Zidj8fN-7<~x;$WRB-Rrgxhh`W87%T1@`{b6*egZE0;(M}V^Cb4SrKby< z`_8gs(V;Q-7OY|0GiO_2%9!DeMjq4_tGGQDiP1@Fb^tF2WGdPbzjd2e?M6_RcC# zn2{HbimX8TFJ>Uy{Hi}fe~I2$EYSeq>L_Y*L46`g6;x(&w#_Ba)q*PQi{rxiEDrT$ z80V(F87z8jiFx}?1gK#`l}iVsT>3pyY9K_vI&N~AsVU4Dv|VJ!aJY{ul9*@rz#AbD{umn*-Z?^cciF9Sy!aS!Rb42p+o;6I}B9+%OG6 z6|XnN0cNcLKK*r`nmLjkhg8e>QV4^09x9wmF<_+h)BQ5ang_Z->U9`)L zxI6GGRkFewjn5e|TBw_&((fDrJ3&`>(O^w!C_4cTZaKsx;uWgJ9 z^YaJ=q*l}tqnR2h!V`50!X?JRh6PrT1;C;#UxD@5IYf^9#)7Gs;u$ZedhWX{6&8DRDt! zsWIo-^Lu-L1CYQ$xf^m2!x|3*I0OOLGjCs?9lp zc%LIaa%DM!oxLgD`)ORUWsxd?=VpS+kEP;qMQ5`CP^=lyY3uPX<)pH->E5amvm3GN zU3xFZkre&>Q0uFfj0kEj_n~U!aKCuAr-2h#7|vG!D<~*>;~r3HF1C+V?VZ(g-O&6M zs)c?hQi|0fFllE?=L|_`cu)2r=qG1xZ4YM_$d)?Qe~8vp^|iL ziBbHkY?YV&$9#;7Btu{=QHD=<`KI+@_N~nhnUq6lmA}cG7XEpya9kUYe)Ek@#}7Oh zXKh)F0P*;r*SL7w7}`#Fi>qaA)ZF-sFlza4jc(hFC&MrTnPBrK3?EX@vS_ng*>q13^+cK_#^?5iu)#AY8+x*OP zL#iNJa6Ks#4&vQhke~nMZSOQ}sJ%;?7MJPy^;kiFNds+drs}hJFN?$|W;Z}bIEb4q zKZy7OAOw(rcn*n?rFjm;PIB((rZS;aRYz#*^a{uD5i_ zyg+-yFHf4gXsBvCiPGf2Ztn}B9R@P%%70GIrC`w`Cv)(yGxw(xE z9+`I!HV@gr>NPNwW~65lyR(cs*KbIdyLFXl8O#@t#x{iQ0`>>uPUU@2?riF+{(WX| za(UN_7(!EWTr=@{`SIeCM@34SJ85;xjtseUs=pF^pt{2nq+#Z~Wq4u+hOqz0YPN%J zVK>dae&~=1Bd!KRi4qzmT=%|g{l0U}h5%B2!58cDV0K2&b^GFSx+=82v=bT zFejb6*OMd=IaL?WJC)jvm1{(d+>5$Pca#XlT3RSKWM?GnU*c=l%ZR0dt004;!>6M2p12bQMUq4 zDf}LU8;*c*ekZya3yb%229DN!`N?{|Ty3l3+%_{`^1BL^fI7$6bxVTDd(NKJGev{# zSMHSg0ST_hW2&^LDj(Qb=+2I0>t1{LM@>)dAx}xC4QF`ASdxKk zdfP@RqLehq0S2R(ZYAz~j36>NnTXpIF@42fR~kgyQsH{Zh*5TCn-0PRFxr`WRp}|Col@W37dGOHz=qIrTkT^X z*3Q?ZKddJABxEsmqbdZSZ3HZDG<|C7n%xjf+Lm2{)FC|S_;d)n9f2OPE>Y;Fiiw3a zU1#=YYb$l=)kpQ)tAjaG>TGHn5CUKvQjJuc+`AVW^G4y}x?YFl-L1w|%@SlZ<@Ei4 zZ=R7K83yybJ33ZUDqz~P5B?7Oq4|(zM3~Kj zsZbS_>9sZ8+|tz4)gsC`%2UIev)W$c4+$(7Tjb~fdxNj@>rFcC7T5+vho#NqU^t%3 zXUhjb@F=Lrp);N5Jy%Pr#nQ)GqRTT0?mkx+c%d)Yx)&`z-z7i2Kl}NyOuG25}e7 zjB+#j*Xs0k2cMy?t7@XH`&9%KLYcO8WdVW*S%+y0uv_2{BwcoXgfhSAnL&3)q&HB_ zbBpq|<44yes)gWf%lr`2Z;-sGrna`WU0WeKf{}Nd9}W9Le|E;X&4s27!ZlXG2etrJ zzG((56SUFx4@CL?DvRaLHsV)Tb1jOIZcaY@ZD3_J+gIw^kN;sKZp+so1s3f_qP42; zJBvwV3CJStNr`6DXc(%q(uIKqZfw=vSL{5t^t=F^xR6K*iK(8)Ri)iy>^F*~T3GJ4 z{VgwD9q;=9)vjA}+sw#sb;`t|(1I0ceExm~$fLQ!2}&P@Eh2G?*zbiQdTvu~BHEbe zd=BpIcXoSr1hH61&6VPe2B79nG6QY}xxU6^S2S_EkzG-3^A;^QH8GDv&W(S&Epdjt zV?tm?5#HL?*4Ggy{n0Lj@oBTIn?qG^okA!*OO|>)1yVO7LTfn~XI)ewE^4F67qi}Q zpyh8NhM*jl809AFXZ@^bM&MOULGy;g%Azg#kxtLW>Tf?9#RqcmxA1q$^^hfA?_ka+TDqGf}}7 z!MCsDH!-0_Z<=}d^b1>zy$OZ}F4IllaR!d|bmJLW7C(#+B`NsnGJ7pLtQA~r3k=8=1NAPS z%ZG$E3(iPI00lK(z4AxGK6izuHPY@InRB)G2n&gjD&mL1fRZIP^TVin(CJS>V@oj# z6wW@v;1opBQ9{bPv-Pk9pHYd->@2`)Wv+>}EsYx3oKr4Q&YGU z9+iP@3F(vYrCqfgsA9J|7!_*|MmrY>%9Pu(`qSYu;fMi;F-~m ziP?*NE^a^k&6N?O6!G1i)QzQ#A?nH|ZDIr(#f621H#;jiKH61zyTF3Ym#VrZD0gpw zGi%_Wnr?Ljp)mL^Lfq!ZG;fiirsY`iw;t`Ds8til%9#vt#VDch5}UcV6`WjLT=|0? z@dnLCB}yNFB628F%?~tNg=LbrXh%WRTy0Q}bzF6&PScO1WpeNA@&WZV^j!LO+Nd|K zyAFr)Zmh-X1l+uNQ;vie8E9%f=UII4;ZEuDr}kZa+4)DwXe~?(5P^E_(R(E+_c65i zlVd$&73SfRKC&FlY>J;=V%4q`zYKv4HovHDGKe$EGbAOFKx$x(8&(C*CMfi?M(fNM zPqS9T*Em+%%^h6*B!s1S9@vM)R-FZVp_&}zTY<~7E@=U1V=z_5 znvfZgo`cOoOS%2S;D)O0C`VlmqXXdj4xy}P$RS_rbTpsF(?~-vO&ALLqH4uY(s?F_ znne-`;7u?ZvfM`$CPPhjB1j#|_rJ|DZw=Lx14`;&mM^inzy)IE8dm}iW>8NJC7+$y zcipyTef^rh(pcJTxHCbBWKrRU!XXU`R;_WhRT(VlIkoKo-Y-1q;jUkD^g9QNdoSOd zZKf-uT#wDuPZ1VYupwgC`Z_}tsV1cZ}P`{ zrdLmIx6-W%l9z@LV8uS%Sn^S|0E!9ZOST6VdR|`T7>DoyL7?N+or@&u)Va8JbE-Z5 zFXpDEmRlqB^=?a+@2yh#W4^|TYJihMkU|e(>@NxTn7DQWumPzQjZlsdvm5&6uU^>( zmVl3bC;6?LtQS1+Rg>`DQ|Xu$I&L3<=>u1=0rJK9LrgLb98dhwa+x-G^8jokVRJy? z=DVs*cXiwMY^u!SkPc!HYVh@0`e;f-UMQ>g zIsjrmXJ2?K{Y)N}oL`m*j!uZl%;4>}8vI%fPKBj6byo0-$;__r*eGy6IH=v|WE5ZS z>Y=r9-fHbsVFQeCBw^MVzmSuu#!!oPpPrw_QRis#{m$(4=2Z{ut`k|>Uk_ya^0pfl zKhnc2t3P}5wZq)hW8Vp^4X_kau0MX#WaMtj9}`^kn^gS5#CLc&)ssKFw%ex)~=*b71l(E+8ZiFfZ#FMeBES9c>l-qu7 zU0wukJ*rPcQN5>GLjr&G3JsUAuto%M#vJmR$nlLEL#_N#Ky#C%N=t1hFI{S)PYoI? zX(XLOj(TrN`U;o$;;)n4^|rkTSa)GtWyhNRJ7)g+^)LvjheuB`$vCwU9j$RWnNG%_ z=B2tjV-?fp%c?8pke(T`fG-(9Y3K_UobbKxUbk?Qrhld1_+2JND&ra+1rDPx%a=elC!rB1rJ<3|O+b8pM4S^?kmB zq(sQprY|-5ZcL>`o|MPj51?5_FoY^dKNbs}v$oLd2jGmXJTM3^fGcL=g`1!6s~0@l z^}+rer<`m&I6Ccrn_@-jE!?-|(yehk8vf)p2lGDNgWo%BNw~Zj?;^b4*%Ck^sWy4# zB80|`trN61&b2%+IKB-MRkiJVBzDEw&McdycV_Zl)k)pCbvfV+r>Uu`V$a+6fzgQ( z^CUfhMaMOQq_Drr29IO7FH%sbo01r)NoD7)izrvu($ZM33!jF()U97EUvcoQI~N+T zOO8T1^CJDtXG;IP5{mEpu5(-ZsEcF`;@H66gsQQz+2-%Z?mzTq-6$^nT%q;?KJnZJ zDK~JbO6TpV4uYzMPp>d-OW;C}^4`J{J}-92cFoNlY-7NF`@NR2Y6AB=bu&2cSS$a3 z+B^>OOn<%q+7PZ-8hq3=UUW%jU+Cm4oZ7$6!2Rn^uBV^-?*c7wyyR=;|KI{GIKm4y z@fs93>i+bIfA{WPUzV0Q4#h|$-SeCpT)mng7JyzfM#`vhtG2C=4^=gZ2 z^{yW)FjLD!&oodoTgdnQbCqW9t+&Ir+cro)^^Czm39prI3sJNA zOMxV_mJgQ4$suFaQ?C{50l{M{_?#i#D)XuSPdQ^L7HOR}ZYfU=P;S24*fv}al?EJfaStHQ?eeed;ir*yXNCwut z(|J%P)rkLahh#Cf!~&@~PZn*7%Mec;NerQ?9Gka=I9-Xxe`gL_F61*TFYNo*Ay`tHTDqh;(<^9sLkS+yK>NgXLnJ8jq382tF1t@e+Bs z(yJ0?IC!u+t24F)&PQ;a;;MPyiPV>}l!`sp+z%=f&(X}K zN%*zB)U1*mTVgm7rChd2iLU6;Oa-OBPi#9lqMx)agR7#ECXtkZm2j2ZOTKiQU-)>Z z5pMw2AvpdL9{-gE&1U)*#)(}b*UIX$XMV>==$XUANH<&E@9j1-3z>|$ zu4R&Szh{jG4g!>`eB(g}9J=icIHuD2`sLoBXq(Z!qZZr(EgiPgSPG>DMtJe>Q@yF0 z&r}|yRxJDVSb2jcBC~n)UK8;O&=MuHz^!4BZ?_L5R%x=eIX z*o&8CPTzupkf>9>-t*-)3XIfE<<5RaK3jsLu8n^kih3tEsQ%>b^j`b@TWbUSb%N*W zW)!;FyB$8=EOVX}wOD$D)-5s=tZ?IXbFTy|Tu5C}8!k|^EpZsoHITw+5ynQ%3bfY_ zw}Bh}rsH>rTK3z4?qAtj82?pAapBU-x;?e|{*3nx`qJvEjN)zEj=&a=I5=6l5

9 z;dR$ZV^{Oe1X3?Fg{L9asuJdLA(}}|x}e%#y|+pHHq*{9>scv2cJwl@T5!mC-ydGJ zF^Nf0i~!hkF0wPrdMF47nCu#wGR1`5uQ$P!vDkR>I`jQE+UIFl)y$uM zWDxtLZfeSh3&}xuBn@Y~=jBpRQn`9Q(30?M%;Z4AN`lCluF2j}Bcb@!gi!rbXz%Cr zNTeYeY2BZbdpVZ6I}Y^}sUNohPAt6aIoN5vn`KvGGtfs6#zKL`u0MF5MQwLt#t&@2 zL};ip4Zlc|L=%qV&-x ztL_*oD&E1RK8#{`f`d*zr4q4}b11Rv?U{B=hA)Z63STr|5VnjO?bP~mBePQ$jwc>j zL`I5wcbv8x{3)-8A@u>=={nbSIUpba2|p}H8lXOco-{g_l5k}jQfL3VX8UPB6TdXz zaE@l2?|SgoqCQE8-*sM4vts+Vlx>P2NrQ@^3s2n6rFXBGY15m^2g`Td=B-Y^DTy2y z8qfNI4WLQQrcT5CMcx*^$8`?Wc#Dn%w78)!XQ#>W!2;_?e1#h^HJfl0wR|)MyU{uG z9EjjYrYGH*qoYPy>Rl(|I|8mUd;RXKqM>5zO|N!?{3lXr?%Xmm4;{U?vz?|d;Bujl z?Q})809X(Op$yXy`qV)BVQ@^&n?ae?&*wL4sxZnCVD$^lO=#-^m32_deh89B26vLB zDmeU_)i`<;qlG<|P>^zKuv{K{VuxozcXbsap{R1Q0>p-rL@i%A08cjEPiU==$B4ba{W%=RNBvoO;^UP`L@pO5Y76=pY+*7jY@rrQJ_ z(T$XyZ6)b3_X(_rq&Bm{a~T^9&;y2E!_z`c^+elT@em^~5_8qzQllFQ|01P(D@kw< z#7Q!4NZ4q3QnB@O$G3d@TULqfuJ!&T=bZ&m$KHW2oOL!hMlk}Zg+gAO%T(d7IwMa#ewpo`4My(JaDolcwEB%@KgZ#%TH&yAs81|fC-SM+ z-sgRiVN4q-%jihpZq0fONy=nn2G2U5Qbrk_kTBC#?br*m8!3iH09qq)#g30d7`-!= ze!5n+&3rd{Hhr+`;=3_4u(vXq=dv;A7`QbRb&VX!?Df(_aNUd-Qo6jj%KoK2=9(^^~UuGgz_eaWM8dydp2)Yt> zD5JdG`6vB7)gKPs@L|ld-^kv3rKb8hw&KmIQ(Zx72Q!|#*j6WOFVc7EJ6ufbZ=k(i z+lQT?CY(~@ZuI@J_oG@k2m9gxh;y5(76dNvvVmuPhSx#3x0B({#&7&GJSW!ByODJ0 z7rz@TbLfMFF`8zQIg#*EVHC5+g~@hCB!4}(wVct&Qmp_gj&2J(3ZX2$A(*kOXjH#M zvE68?2H9I+gyG#^A0BRWAo#D%4WEK!oLBCu&1m~_iCH!|9n~;4{}LR-TCkFxLl$6W z=;eZy-A;`a{a@_8cU04Bv@MFFVxfpik-8PJ(WG}!K@mX^q*npyz1I*GY0?A)q&MkZ zO6Z_8k={!P9RkE8v``Wf?w5Ve8Rw0A-#>4RcmF#X!##A1kl$Cp?UI%zr z4Yj3|D?3BJ?Cm9%NsBmidIEIJq@t!gLIaya?K?6%>w&|Jr)hm^3fXHhYZrIh*rsp6 zcfX_I^i5w1+KC_v?FksW4!rWk*jLZ&lax%i8d+n#w3D?UmXj zffG_x-V$m*I2X)+DC>=BCV68mQe5CfwFqovnv|yjojj?zJF;mY+h@?&xs6bT@!!~# zX@df(5d-zfF-hKcGMhI5XK?b5Hmc^HQ-zr!Hp5tS_eb`z+&UT-=`9t6&Ee*u=5+Au zsKEwK4y#m5I9FS-GA`Vlxp}>$Ak+UCzQcoDdz@+)kF+PP#A|$#5sdOca=^4!AF% zrOicLrYAzco)VA?=UGGoB5B#>mPcwSDPA&N-d@xM(h&=^PgZSVUF3(y@k59#n#$Q5 zsQ>uC`g{gIo?;GJJ;Pyjl!L;UGFrKbO$TS$VV(zX!FqX1Q zn{=H1J96kKmI~szMGI+?zyXoJos%Qw?O;7!XN7)Vuwb~E^VM!xWj zLWRe1+<9G6W(ccYov?`yNL~Z=gF@{!ZKSH&!2~IK=GE4 z{mm)0LrLG=uiy^wnOb}d52s2S^r4}6>~v%CXC5asd2QtJQc3(>Br2*u#|`8iS;8{w zF@BJW6PkCLdQzlB_io{ILnQ{UUu1qBw>iOwj1dMkA`D)kf;{j--&0E)htR$9IPP{v zNYzf{z41>F;KX=jZhS*D63dmS;Q$_aU=`H;J<{XnNsj?*$Uz?IFf9#Ee0kH7T0yYm znKNfT7wam?HhSxT*bEo}H@{LU4&UcDF9bylUXWZlylc0$-)wz~>zZ=`YmPYFR_s6x zRQPlH86bzGt>!`1I=4pcOHa=*k?(m0AaWD!5-qRBg*eL+BmQ{n)t^ckI~xWjKF5v# z=<#gJo}p+@VwdolwuN&m;E^jY4ldAatkj?vvpbF@G?xskopKSM=`uiG&GP5)`Qu~= zDlbV3Ek}5b2OgouK06y_E$TGhUQUc|;`G#$6NROS78ltk(b~=A6ampw5`jIv3*BRx^1np|E`q? zA@exI5qc_Y3RYIc0X0%qy`&ez^9<)OcL)rbB zzN81YZ$B(nDL4RZc;gsk5TFcvDn=-+cWQ=txnG{-+90He!M5zp7m$(17(}5jQ9IPD zY@%KRl5`%bE=wp*lt?Z*`l*zOD}3R$UOK~X+7GJ2xU*m$(^1_}8(!yMThB;tNQrk$ zd9hZ}M|1BUR9{7#d!s|oh(%Ae730n6sS=_*1Rp8pJj1WdBI{P)=($;F02~>FXlBUn zu~vt;GAX@H@534W(+YZnx>EiokIF_bOcrpv)VPv8ziS=^eZEA19$&tc+7vk_Jyxqi zMZ|aL#{HNdE@ZKlv5^FjqLG-mqZYH*DJ;M`IBQ*{=W)n>-DB?)N~=jHDh;iYST_0{ zCjZFD%6lY^0q;F;PQ&u{bR7-i-wysbfqloW9>}BgS>?-X}j5h-yyt zY;)oO!q(d>H9;UV!RKr3bf)5C5Cs_s=@Rp<%dVZ(}=BkEeSj@}M-yHPk^u|A~aY~={TaNXgD6^;1 zF4cR|j(x*d6ymd2~QLdZ3q#)`tsA?lA{qL9wk}k~lyO z2TVw|u9A>-@;*LLIoP zDZ4XGY6Nk>*zxJr^jD&PECqRDjbVifO_P%FgHH6sDxKVv_!!h<`t)e$P78r#?YCYO zI@c&ZGh|bZ+ZuTWqQQ8wur))AJ?!bzr+1X$-rXCu;!)PZP7^a*n&2e4Eh-aEQ zjHyDNA$MDdAC~$q3$z_XTMgj{o!}rgQM+r_{j1a~VYP=a#y99SG^BGaaL2l1?mG4N zi)XUVP;gV7_i=gfVDo#<*2IXoX>$SNK@q?ELmpxenkdKzUb<1WJac7$y zpaUm5#_j`*;_qI|BOWNe2h`A{ut=l@7;h#iNQe%ne+l>S@s&*i^ zS4r!-D!-Vk;Dm|=X5lwOo$UZwCgFgc$c+H^H_P=pMl3CFEmyrj;>IH6bj4YX;4(15 zg`0;9AkV#3W)aDP;SbT-(pdjF+fxuRNcy~1G=CRVq%FMQYsqlun-#hyKBH!*LY7bW zF>nF<-d$~}K$+fb$o$8=EKq_`}rd zvOq0kGD#5F;%{?Qh`PaE4PWvH70paJg#aK_ap*DQsw&snIxZ>e%_^Yqr5uml2&MY1 zsdLx=h;+KyrF%M*?TE&|0s?n^u~xJTK?)9Y%)2=zr>&^imF5U6wi-PLj^o+JJOzDL zCxE~P43SPlYG_wY z+_ei|%UK&X)$!qeN>>#7PelV#*_ztg^>};if#i9g;H8bKl}3l7w}AC5`)2I#_W6AE zZvQEw75%^cM=Y3RYIKG)W z;8=Q+G1sos-Mu&*P_L7?G5ITCr`nu}BIz??X-=fYP0bin&wpU4otU4+$nA ziy-P-M4$kW2-x4e(Se4k)~m&vByUugIt(*?v;s4a2o-4zLywbo>_Q;S*&lN;I6JgG<5j6ZYaZ zfZXvCP&hega$U;1Q)`QODj!HleyF7NL)x31b6V{0Ax^gyllpE^Qv6eOj&JuWFpQd7 z1=#8aB$2Hb^FFwnO`-V>T|HR9?~+~2?2dX@b&E95%i=a5YHi-|fhjn{f@O(*Zc0Yr za$v#2-emihdfSOveTy>|6LLo0@bTmK^8sl6jyg-8NiuYlly{#0f!K`uhs@$gJ2%@L z5#9nDH0iX(+(#ZzxYkZBwrSwRC5u%gR{(_ozc*#;=Rdkfez>&20wcXba2IT*>zqx^ zTL(FB>Z_dg;|Fbb(goH-IH4qjE!?m|-Wt4p!@QRa`=#;X{vd>H_0O!PWuhjc#+Bkt zr`n*ztWE@Lja}~oem&xFe`$4!CIb5dhlP*X8XC#Dc_s_pO4&Vr*YtC3&Z*6^nV((k zcO@UN_f(Tk3Kqoy@yog9z&Q6ujfCirDb|ikN;q7n_K}xLKAtqM+9(;Cui|O#LpRz# zN2QcJXQ=~q-`MsUSOK`3MHTXyr3?|I@elQ{47P`c@JB7mDf?T(0P)YH@e!Ip$F9i5mBsod<_4A`jkdojkLDZHv3{MeRK<2Oo<^ zR5`kq+JAP?(xp{LH9HjcF;U*x9F%tQm|b^JCVT`ST9Yh+;1ZIWj3#yCt{t*6y~zhQ zYPXl4m5`j%3qHIqT@QPx`k9!ff`ReocLc|eOgVQQz$w(i>%0(mJKU+k(gG|afld|Q z1%89pLA!y6jn0$bV_C$Do$H5|^A65?59;8yMjIf5ZB=3=6KJ^`J=F~#kAC*{6(-Sf z#vw0X1h%*&3Eyrh=+ZS9Vf)V&^~Qd9H7U&kCZ%5&LX$JzVpt#(1MU5CMh)+C>k4+h zTDK=U^U<91@2o&O@RR!7Wjsz#=UPp`OuepaH7-RO9fdN7MY`ge01&xNV|ahxfIZYs z6PRLHTBfnKc9wdfS(Z}HX~zh&=uy9KHO0|U2N)DZ*h2bgp7;;+=N14-fx=O_kfwUvGynxbDAdyXRCytMl6#G;Sq6Ion~W$g zi&2YL%WSQq?O`>&ZuKqcH{)c?WNJO2ec!tmB#0F`mBbmQMLyGp?rpswJQCVFwd@DT zDf=l_rc=;ysPHC#aQmo!u$*Admm;pwaiKg@v;zJ%jnBfnr${p@pX1OKuyK-^#!=q5 z&4k1Hw}25R*AcJ^*8k*B|AdBu=kL1A(2RJMbe1=Rn36g$crT3i6I1RLZB5OQmY*pp zUi`?tY=v%0AJFL%(s#qO^f|7$Sg-11T$~ysLG~;~mIUCZ4MB1qI6PeMH{S3V?o9w@ zwc58Mnq_(oY9m0{2*k>v!{G({0ldkvoZ#COYfAoFlWR?6HImiyK1lR1n@*}Ug`VIl zfKyLnZXWVEDryXrDiMDJFuVxXt5>rQ&;~bK72Wr3M#!zs&LtXU#Q?l6Rkmaa#Lha1 zu}cMvAEix{_^ufk4|q-1d0v4R1Hb#oU&V*Erg#)TEbtI>C87TGQWCg0tQb+W)f%;>x7dooJ09PpSOICW+e~t z$iYu{mG4F5$7t$=fXUzEKZ6FZY|qv>ZBACDh&a6f2K09B%iHg-Eh=jMTp0Jd%g4uu ztgaTf;n9tD(XaewsF?SeEMdNEo|kRfESJ8!O7I7z$)NX{c{0^y@2oocA*f5-UH|pl zw;6;Z11AaBU%n>Aud@TP7jhw&2)Mry&NiS}3=VYAor6er&x~3U=-7BCNx^;^Pl9c0g%3RZoD-{T0c5{WTWE{b>VbtVgF^B|U1Ngx;IbE;4wlfbIe;(ZeovE(aUZ&4!C86JXdyk=gd;6Q! zgF_5o4=LXqF-34=DNsdolwgSX&gr{v0gf*p1B=ud;D_|*40w4cccj(I(H)$0g(s18 zY~Xb9GOgR}`ri)?1%Ngx{n^p8T5?ogNiuP8!y2R!Wxp3#*W&=ee4;^fk4^`0N~AQ| zsY=J=&!Psv*nl9jDqe(slJ|!(_sLQX1kV)9hI#1-LSmg);M-h4@-Jg@VU-lcky)|a zl=G(sq#wb#R=a`VJPX}&6QoO~p9kuW^44r#kg*}q+JT(+Wi>#5@eI-Lrqdyg%sW;z z`0cNSz^hNuCRKK2W`sie4jCy^@^W3QZm{WInq!B$Rm41la=zl%m0h`c55&($lo>IF z;O2tH4FGxGh1NkXsK~BbVp|mp9Oqe%6h>TY(|Wh^pe1HOg-<2bE$=zM$dtg44CS6R ztO8h**DEZbItq@P*DS}iYo%U}hDDAj#^Tql&35C3`SeLN6V>4F0jKr384B)pv97yZ z$?u~0f-7hlpk{cWao+Vtf6CR~@zpxRU%pBa(R$yNBiGVY0z^Z*iEQT&L*N4a*=!j? z*T?I-rVUV^1G7Pg0Zmol*fw~gvQp9X$Ba-cioz|IoLa;9cty0TPmk0FQpFPQ4B#!I z$5y;hqa!?1TMr3$(q-0u$fj27@7qoN@qZxbO*}p{LL3f{@gLd(>IZbqW&fV7)yh{5 zdu}AA$fH{}h4z-$+&C;VLA(%kp45YTcTPJlRJxV`a;DF`&Svc);cWANN(9RK!W$<$ zQ*B=8D~tkD0OE`T(VJ#S(kIJxB(vgQF>YW&*Q6Y2;`ip}%>x0Zay)inapFSt^aUy^ zvb({@qxIh)4#1F@kr*yr+*G8$b$-#|?qW$rvk_;Tc+u;@CA-9?JL1-h(m%IMDBjC} z5mySgx$GsWF)v0J+}BaS33J&?(7vZDt)-U7Qg&ORR}HIV899C6CW?t7_c>& zZ58eg;$k7J?iB&h=alS{j%l>`xHVaX9!(*z&1n>MaJAr*%?zU z(9a2S! zzv=qSz&5K}ZcvdURB7tmQCj0fv^q~E89j8cF)xX9AL1|ue_du$f$A|Sib`d-J}P0; zP)?Vs@tnrc{hMarNan;{*hl3-`BTz;tW`^wmk(_bAp^7v4ewl_WNLKe_%pc-(<(9O zs-(dFj6EvFe^8bw05nlRMh7O~~TcO;VMIXT#Z z1{Ib%N!I;yU{L#`WK|aL0hv(qEf} z2g9P6oxBgeOig@dY#2gC*OeJcK#~tLp-k(?#B{+bwV{b31!)-mOVX!K;%uX1ff<}B zvpE;;)H+{zq!u?in9lQ6j`^lUyN~j8R4U9Cl>4-B0Q3^~8o-9rR$nP!sMH5CrpMgd zyBj|#2`m|Xod2R)oBhJ25V-uQUE|UL&vV+Of`2!s#uo9bfN;-pO@|Bg=S~1ab+B9X zAO6eRBsYsRH?W;#(KVg*9K|*(7&-9;#7{{_|IJ$O{Zv-ETjCCLTW-g}*+F=Jf{+Hq z1%Z)OW-*WVO9!0Lj6BfIBojki6|UHbg2|7!?J=Uh$8RP|voy!1qQ`~`8mWH)tr_3n z3ta>j%@awFqp+m|6WJy(NO|hK7NCbB@?u)Qu|7AF>U1Fh2LO&3BWxV#O?Fd6&y;D~ zPug$6y`cT0FNj8N1wsIHB@?2ar z>p+`jXR}PVC6y@HS?`wz;BLtS*G&#!ZD`>zhnaF3R@k&74-?~7W&d`Ug@?3-d2N4h z-zdmqVsrm_!9)T!9(N?M=R;2;I_iM4XJgbX=rV|YK4M8ssS%-}9U-(Lb8^rnO>T_* zH)K`Y30_+Ea5)ukxo+yz!n+(E2=RLeNQRDsHw9|;lcw&wCnU1`+Rin!k-8~whpI~l z4H>iq&}OH%w6sRuCT~5TBct2ngY6Lbyb6?4?kixd>$|yHT`A*VKY_+XHd%0~H)jDX zBJrsRoK>=7B)Y$ApRj69g9pyBE_hP7j2I?(NB^36Kcqzx z(x}oVS&sCVl}trP-Ske~5=Z6mxA2cRddro9J|*V?FZA5}W}FpS_F?yyH$URM0Z8IT zRBMl~^f}OjWiG_pb3{pHEMS2LZiQJb)jsYcbEkTTqpJmu*E6BUC;`8$6!dt}nBQ)) zE)AS4Ou^>LXL=W+szVFo-qjl5mI~fnUSk2hHlAZ>I_AO3+sc^%q$m=}y4B3k#pTO$ zro{nJ!JIq+3J-3sGc>)fLLa8lf{z&{r|#HXro5D8&qUOBwaxf`W z7Ki~H&@JwC&=iyH2!bJ|9ytY>;`>5lp~B7XnTe;pWdM&=j3Uo7lrYu=fsa3$d1vofGR?^dg2585Qzt&j=d zfjlF-KVAJ&-JA6BFKE%<2h6)MxsRG!A6lsq9}5UUbBR zg{?z*(t{e*d5W(_WyfD{~j;#m)#KI?gonF)Gm&j<-+?8+EwU1B z(BRjCH~{aHEC#Yb$7E?2W*Art;tSM@RFkhZp~WLvS8A~2)cT~O$7Znk8JQ{tg_s@C z)VJjKU&5?hfVmwLUTO@u6Yw)|WceMwE?`s)1hOA`giZT~Y^x|cvZt}54qPkLsKyG} zl~K#(2fQ?6z#gBoU^Or~+*dIH90b&D;s+^LRQi%t?>?I-v#4LNcW!mA|7#C&8`uJO zgDN-2Y-1$&!g2fdi?6`R;J$;I0!A^Qn`^)jxUh_GN1w;A#*$k?1uDzHpA|RfkK|Lc z=7|4sxqTiem7L2W?&+6ln_o8?g*vTT6vD6floTm<;YPg*>%SVCw!?l1uFY2z;Kw>Q)R?n z`x`ZDhXx=>g}_<9mg@F6mjtvCy+ zrz2~D;Q4Dk;cBoLc$vM@E59}H5fmJA<5^E+%Z%H4%?KpQ(DCxV;LRL(oo&%^HT2K% zaqgkX)cb7Rf2#-VV4A2QaF*%-BsTtC0|Gu3%^swf0+rNns&{2czguYG&P~2)R)ELb zRM-H_*j9=w%%8vrD$X2FaPWXv+$B7`C&Nz}N|Mz@Gy?mK%Yzn{^*+8QZ8ncl>mGNilFav_meu@H3GOZY*w~2NIiOXoP z@RlWC{FXzJ78js+Mo|?qXtzvP3ndh~my-vyznYP+RIS;HPDh=gbE}DS8_G{C!2wWj z8)J0y<5^1<)TXnDCIOAprb9tkh2yHFLOQ=Zs|mkqY;5h!O_@=P3E6GPvdz7jO~Ae;)RnQ-QJp)t(E>Bo zdHk4!^2RpoS&2H&*4I06fm%c-YD?R*_X|l4&Lm)5G_??53e2tgz+cynF`JvvZ9HUj zG28B%d(F?Q#iDN!Sa-c**)K{ zw%Bj0im(UyOWr?rVUGhW6s0qO+g~}BpXvgoRhjof;LMubN{L~4SZHE=x*OAiB+ofsUb1rnkmX5)8hiMtZJ?XBQIg~DtX4Jn2{)PdFDd_R;nmbU zyO#@GN6MpX9aJS-&#D_Gs~_l!UA%N@GAZ*U6Ld*=HbTMB6mlFOFRFgP6uABfUqV!{ z7uL;xE%@Fk8odvXd7}lq@iDEYRp#f3LMtkw z&g**rOqV;VBuV~x0b&8!%^4ixmqDzqwHr}Ym-DND6AXD7Tky;Ajq6*n=jFsfmudbJ zq95LW9R_@?8&9Rz-wd^GO$K_;2j+&*umj&FN@-%E2iw9Q(Pci3vCFUX$29AcmAV~O zZlHyal$z$RH=Lk>4RmYr$_>ER_Z|oAMOlbeLMsAr1#d#@$QF3n#>5lm=^@WHJkHhR zopp_fqZ2T3YY__@`44xJ{`HqNZe5=0!s|vi*1R6l1+vYbB)Tb;A$iQ?4!=oMj#I17dd1l!S*16mp1DIv-dxkqmD1z{#;a*|XZyV>4TyZABEC*i^X&aJ^d3ep(T* zpU4G5WHkH|z zY|cztns&|c>Jcj!-^EY~xu<rlnp}jK> zfn+hlV<=r*8uB=^3|MVaj#q9V0{f1hO8>j907{W<$q)iAbZe?W=|c?c-ONMT?cc(_ z7;B+qk+o`Xc`@vBYxYtE!+&f@J_4r!m)Wx&t^WW7b^GZ_01icM=dy-}^uflLvw0So zK#y%fgUFJbe6DpUpP|UaTwCDq-gQn5;Ky>)1$f-=uq z^-0~#)?7dxHxgSwW$3p7(yg#L;2!z((#Hv!fOxbtM+LO$OGWMlssjJQ3B9# zYmQZ+Bz-iK?`}_ z0NDuwZZ;UxG=?;NH3fi<=hnDwx{Rj*C^Td5kbOc7f0A^;JNC4hGFa(0DGKEvKo2m| z4?maCP##r>dC=4IhK12E(9<`WW1mN9T#wSo4bNwa7Z~Yew3wQ{X2`2y@wX+bO8n}R ztMv5eV&_xe@7FDG_LY}5T`_$BZ0}@n=aVX2x|(utum#)VE$GyMNRXObAjISt!zYhc zSBlmG^UKTm#hi^k6mhDy$68n~B2SrJT`&Fq-LKejA<<^K{Ti1Nb+@%}fwC0!##V6> z=uSqX;fvcO^hIBm5OmYQlE&k!83oq=aEsDNN;Xs$n$oSWJ@(8|hA zEPqYpbEtw2G5XBmx@Y#1=<&R4x3bN`!ow+FgQ*>`!TbFDv41VzX2n=WK!1Jhy}pg@ zvfpk*Mr{AS-`UxnYeuP3V`m%T<%oXd-~!#>nqi>$5*w?(cKFGH%70qK@nhkJUb3gB zYUD^us(S;0?&dfh6fJw-8?pF-;ojnz3f*RPMMbSKRc7(a^M}NDiMs3i)fL6jbq)HQ zuYP_%od1~t3B9^4!94Wq*UlY@8x0M{pYL?-GS$O&ahb)_O3`cbRkz$%O z^wNhXx5C0AyT^uIntft}pGUD|Y2;qm7;fd0lBnsZ{7I>m0_m9keG%BZdYT&+mXE^S z>rrb#@7wQ%MZJ1o=J>_~vl=Ft8ig{k=$Ad=)f1z5!9cEJa}0+GvoJ}a0aZ@)XG>3Gt1(u* zog;pEMZDX2O<8@Y{Wna$J^stBk7uNSYxUZwtX zr(FR~tFWL1NH_{*#V1-_|NPfi^DSNUAwS0d_Og3>mV^HPc*U}Od$07reI@wg_X~Fy z|BtVwr!V?&>Ho{O_NXw7Zzzxba1=Ue~x>Vx0? zU)}%zS?m8<>;H%?|GxzvEv~$L*`79Cr&~PIO7Lg57(RtOTMkLR_c*7(Nl+nQ%G zoBki+Y_`KoCub_Pyza_l(Xo$~s3j!lMT&2@CBF!Xjr3ap165O-AeH)fUL z1&>)80}wROlVfpJ)ks&LL+k{8Mt?@~Xcd0^dq|+Y$UUiYC5BmqsQ*tF0T61?abinR@3w2 z`~sy9B(q7l^;^*DSCRe{xl7J5Y^CVsai3*mkyI6a&UA9o_4UR1K>LeeI=2SA;HjeG ze)oNWKw(kQC%G3AT`FN6i=-Aa3&%Y4@=IUltDlZlUZNxp96w}#2&{$FiJ?kCw%BNk z+DY|eZll*OEuPgEtvdZ}%O zUf(W!ddemlMS}QcmD{pAGOb0$rN>9aTML|_cuvQ85kOc+rlR$$mo>ER{P`=u>jx1! z>A0Qa(lf?{$NTwU(_?4(qema2On7;D;|Rj^^b;->o9;;_e#RDG#OW;pZr?8EO-|Ma z^!n2mHWGs-^`B=<13r=X5w*s=w`p1!X9wlgpwZ)dX zP22gTo4lo*-0rq=xM_@B4A^7I-sZ_UlA3uw_=v!O%At-t*}x)5LykBjP<8+{iX9xRx&4TnHcb>-z!8q2E_n_- zL~YLSh`6|Gj!fbIg(o)Tf3`aEL~;mTrC3~Fii*3IT^I516%?)YKx# zTuzR;QM2C_UFZ2H9;!0n|7C-Efmzt?kpZj**me^C;k|viI$u35#Q>ezQQ*4zoyTB$ zb}>dYVwHo?A6!D-US7WbDr*!=16=WW*Yfn{6`yOn)DLWj%uI%;z4%fseofQcOynew z*9FFWtbDsERb**;TCcae*NR5HHK{0HJ$2vPb>02@%!h#IdLYTr;OlEM+j;rG(a`MV zn^|Q|Va0)GM09vh_I2dd8*HD!(X&DPVoXnGd*n6#I+*a4@3g8-ykmIyu~q8!Z{}Vw za<}GM6pO*j$pPaUmY7VLu5o1x!N7i(G;nV1VX{}*ug7f0_mJO}CcH(~?UB{1%sYGO zlG2iIdz)wK*D%36;#l%S|GIW-cDA-%IydC!NVa1Gl7lrVEU0Jb_IB@^cdfslq7v&| zyc}X&Ekag4oLZbTZqb1dvpBtw%F`UZEEH~OX=yR;FMNhVCyM254=2wmhUr9v+M3_! z+3RiLcdb4j7za|!H`?WxWwON2o&E4@2n^-xsTyP2Za)=_dowx=AUF8wonX}NNck(C zyf&yd=Go5iN!|WEk;>8-qS8?NlmJDM?WSIvx!hj^(WF_YpE0I6N>ge=nZCGncB2MN z^r!Fd-o3N>Ir@vOPHd7{+V0{k%(2X4COoXrt=Auu`1R`|yg}tE$IT!su~(JHur8sY zg2;ZRZ@2-O)z#JIGBe8U;~vfzWkUk@+Z&)29Rn*I<}26D%pE>W@}=hL!qhg9qm)uo zpEJD~y1cip$`d?1&Pn+D+|$&|T-hkv+dhDN0u#F=z`9O`UNuj+X4asr)s~75L<+)jX!OK{0iG?1;Qvffv7#WF_JDk;W+WSYGBR$7XAFNIe3f9G@ld3w?RCLm z@oh`g_q)-o!75X8i%XuI>Q6JWz0k8ZGjkW>yJLzg9kx2_mybGoM>zTz17Zv@CKBE| zEE#eUiaoUG%6Ib)wL_={9@yeuJ7=s$l}|=&IAfhyrTqk3ZYbT?;&^{;8@)Tx>8FEA0z>hy-tbWf4v#d0wKEo z!3o{IZ9zc+Zib?K62}I-gvSdb8!60GPChVt+bc;zQ*C#9LW@mwLFk`hZW9dTp(9sJ zpYPjQmz5su=(@A?Z>9X2Ev7f}^XjU60@1?5H8fHmQK;fK4BuH=uA~mhbq;@kyqmOc z{rzia?DW@I58Z0V_WS}+-OUlc8wSUUg7dPyVB z62!PLl@}l3#?HKHd!7jsT4?x3?_%`iR zv}Q)HaWNw7*F>s!*SZk2ua>Sor|`2RvudC`w09?^8ot z>67iTN3}6k_6zhNhTN|0hab{6LpaU4zg}XNx2m5blK(K{oT_1D#H-JEmHFfQ_N#M; zSB5t%AM0}*23S5%puX%IlJ&)UyWX4g3NnC8{Jsy{jgQZG#BR&CJ^sP_@Gh-}pey+? z2i0i5?V;~I5)>u8V4i>CokuVLo*x^y#D zJGOs9N_Kx-r;okt;o-5}R$;xID%o~h=pkcylGEG$?GKvpzj(q$H#avklL~&h6ny!3 zBXaZRk?jskXE*oD#I?0GE^eG8`MYJWARk#D6bPj=yx$7Pe*CCVWz+S1b$wkq5m66e z+PM_2*W|!qBw*5$2|gemy@E#3Ih#TQ4%d{J$19Th1$nsEqoUM1<3v-xWMn+hXJoh@ zTDam`?>9zipG5qGU&oEhVe3ELahN}j>F&W!HL=zaJt?}ny6TtK!(DUNyhnHTecyw- zOVR$mRW^aYpw8l?GVFf8;SXAU{h2sRkltPl{qD@|`B}e-3HLoEoCOuU=J9k&=TRW( zgI=rG6*rZN2mieMt)lw!C&Hg@aT6VSEFaK&M+VgYs>W}w_YNfs{P@1LCK4rIyp>#_ zOnl}!uJ4GbnEL?R3(2s%w(^-+i@mSbU^02ccKJ#~rCmqn z_U=x+0S8DzS&Oeh(o|XU7H}%%MJc~v&iM3cY5$mqSvDX`D^yR=aT0rjfnn)T{j(@v_@xFctq-yW@)6N0Oj z7irM`D6i;I!XB}F~6#}@6YWt$8feKYhy?$ zCr*L$C{n&6RjVzTftgfE`!~!tQwDq(InGm3LiW)UG+t#6W(EbcXM-}A zF)dWnm7d-S#+>4G&JNSJrCPOfFE9%YpBJ0d2@6;G5;doM7N{biB$)ABFa(C5L+d15PC>f>>PaOy|>% z+g0WW#v4pb9i5%b9aOj{p!)$NjF0V$1>4)Z&vewHUm}G74pmJTVVrXEd)qOIcqAy; zy@Y5>Y8o1B2{p5```Fsj_%l15T~l++#t;qH(F^N)9TE$l6# zoYL9Nrivx6U3;^A{}Ho^T;MkDN;`f4YBn2ql$Y@%$qQHgnq@73qTuk-;t00^T8W5&5^H2Z@Yxhic zvtT1xLatj2n4d1a*}#sn0|xO-n2Dxyz3*9yR${<~ecb*X0s{ks*?e4WSd@yQY<1(t z1mY%e&^!-(a^~a5%%33ZFJFrTyL9)Y!7O<^tnp8`w2jAbre>gcUbs>E(T@bGebJmfT3Xl+HlEprFk&o$j1lI9>+`DL44qzk{66vTeu zDlmIz6J{Gf{{-~V+~?)(1oleT?P-0`b7l@w`_Wo~^O-`XAU0XgGoX@S9xk9tOJ{qn zrS~ZnW8wp9DsVndS{(%v`%lY%p{&8%0Ec3GKak?EN$&FX?Kzp|GZbZpv%iWpDDzrb z0T6KA2?v4C`FC$G028-DXfP4LBzT)^?>q)^7z8%T=UAq*m*khYnp+FC0H=JKjK79Zu?Qe6ZwmeK_$Umjl3KO+ zBZYM93?YCG3ZtcXyoU%EW5S+;YITcUi%WqT4Xe4#Hwe_zt;l~`@$U>00`6Jn<>y(9 z?9z}|GA~%t&l4L7mi`}c0Xp@kzZSiwSW~@D%3PqY0%4*=hn(Fe~cxO3zTt*4hTsE8v&NPzke1DS!G{LUNYJlUg7%wBF_T0>y98Z|{Zr1d8?c zlRVV+zW%wy3dF~BXz8c&a<}Ala*+do6vf-kkJvnpw=Ip*7R&V-M_!m~05Is_Yn8#! zJCPF{z?<%^M8&vU3+(OnBOR5#J#t2k>ml;qoKFc}j>Dxz38OtRpTpxL8F%~UoWF-e zvV+j47JUGq^N>$$0u4A6)LL$e^x3b&*eyTSbjc4Tz6|gOJ5Me_j0w?Ncu^i6d3jEh zF7N9HOFv3Gzuzc&V1K6l=R9p66Y2d;)4?a8Xmvs~++%oqG5BfeOg(#W@Uu$0xvTbp z=~qB?-;1xx4O#rP#yZ`IdYq6UP4R6~@Fzau%6GrZG&dJN4z-zveH}-FJjosZ9_Bd} zxQb-T%2kj)k#epZ$M#NZDBNi=#UP+z0F!8I-m-Rh7gpOB7@}coQK@e{cKPtZ{rg`} zG6J{f;Xcq`HocAIgY3fqxGoTzZ!E?q)#KihlYA~gqfE1{-FRY zkzI^eYEn{+XCE@#(mge4q4zNpuW|KF5P*FaIm7zJCrBJjQTN(cqTbqlTl8MN#T2BsBY&%1x0w=@p*RB_+*^_vy( z)A#>Sya#hFw~~{U6YW``S`)(R2zmkd_rS~1U}*?JwdA)WMaw1~ zbc@pX^;AvtJ63WSnVXa8PZOgDRZ}dlaM>HzIqsNH&;jrmnuPgA?4s`7#Tcgzm)c(M zCt8Z8h}lMd|9(TH+V(8P@4?;#k$E*1`O9zaM)OshDyf3s_Dwkj7aUTuNiKa}3L+@8 zKx_5et}|tZRWp^JrO0oQrv)=1ehilSCqFO}i3E!9Zk5PWMhKDQe9j&ppD%Pa zp=+x!xTDP^>+zN|l5Li=8fsAd-?3tYOrKQ!-tb|Q2|RPpxMJly%9BlMMcH~97l14o#9#`k4vCHSq1{{n~0g(PwS@{ybaZ}moj-z8~ zl_&AqU&KM`-0>_QUq3h9(0zuG4G7!*jd0}$6pCkJnl+HmX*lmQglU~eM$_8eTR8JR z!^AO?L-K`HLs8KsBfl_~j;^2TGwv}eFTnKcz0FX!A=jftlFeKFwwFWf6#1%bJYz0S zAjwrZhx_FNs^ujyx~uEnFKp~aFuFuN|BquO)PMDDua@QVh}ARMr4g(2~;<1Or1g-chMJ?l+n{CJV^KSuH!9Yp{>EI!|x~?wMLW0gk z<2DGBdgils+$aq|Xk<{7Iq;3Qw&nHxuUdE1k|lJu)^z*JwcVACHcSk5?&uirAWFtI z&pvLOM{vv2v5xD;1>BqL&%Xrdp)(Xa;mVq*hdk@-LRm3dyXn)09T#4dV?mB7vWW(PkbDn?bHNJ!Uv^rs+Mf@-5n)u**$WyE|=l~a5q54F=x&*et|t`w$@Vv6oJx~ z%UZ82j07#XKo5oB)r4F31n4M+!K9dEPe3&-W96sJXMUY3vpAnwJV^Kd9T0n7B?7NW z6KsC=1H}U5nBH!pIJopL+tD%A%SqenKxBRs)2FAm0D&#&wEsF82fk`-p3}4_^MTI9 zf0PE}J>)CX4*ru`DlQrLrT}sRICKEyvr0-L1gz9zrPna~y(^C@oz;1h#aY*JTR9Jb zMP@lVY2y%$hF$1GUz{&~CcM9e;r0HntP1LaiV(n!x-=0U3o-Cgtgf%E)P)LsvW#0P z4gwP#-(ikGeMW{eMY{y~z_S$0<882CXaKhFCdX|(Np8=Q;pXNBrR&+p<2;J7^9X6( zUflK`)A`(VHn_^Q>!#XGb^Lw_fvuTwNZi9`H`f90^1?sk426$|Rp9Pt8D6yKn}z0# zU*{yiW!hMut9n_U`b}soF|lX#myy-1c-38rE)qO7V8W}O(%N)@?>SFTm)EEE-W9cg42pPmD{HzA z@8X5!H^{A)YpRLzsn3n*IiAQSDkmrZ$s8JQki9`NgPt`;WrX9yQ;d1iM%?`2vsaS5 z`p@$zn(_$d1uBWda#D_Hu3<)`NXd4t9iiU_<}nO7pT@<;;xx%T;6A@WAr!)SR*eNi z@!cZhH~G=+a&e z2}3o*;`sKhKkI3H;*p${A$>4e@0mMJnSGF4N_}qi^2y3*ePN3O2^ndIwRz_Dpy@34 zTBULm?HNa%^D0VD?7e z`}vuB^srE;vO?$ zQAuveE4`IRY;Z5Abhov>({$YAA5nMTL=m2C-X{6{-nX&l&?G%AhHdo$AxOU9GHK85 z@Nf^M#gz!}x^d>ya8O_MI*XV+zel3nZx4f$l+6mS6-uo>F(}Z2$-2YVxhTo_=gB-_ z@hve%_5Gb8G%~=$4u#4vr@!(oQA2HVtuia?(tNIm@~pkzLuzh==U+bSPg#U*S**pK zvt%tNGTO34cZIrkpLp%n(!C}>A$toi}$Fg5PIx8Txj z8^5Lr+O&Ly<=}1dpVbd0pbtsfnvRBM(M-te+Etv6H`!~1#R9y%%_V>GvXk80D~8wG?daA=*Unz}`MC75{AldNHX2?@PM>0gGCand=h_;r3{-m5 zVmia_Q=~{xQE3@;!n(Y7xRq&}3oH^@LLIPBu17~K)&|3yCzlORHhmp@&A=8)S1pXo z62QX8H*bgMFf@p%pV^0nZIAR_xM#O_9c4IosO(Vf9+~}<=Nii47?RJ3Ed$90SOBoK^ym1#w`=A7f=+bXyqqQ0^#XKpSi#+F@YA3i{kPc$L=pT(eP*B zIyMb`?w%OJIwzd z_FNM+@D!R>s{#ZLDDK@5=l$vD+dvMF#VZ5^#uXO**N@%Y4xNT6AGvRq4A{3luz8$l zKDc1;Nx)VP!`>$~MfL1&`s4EF>IB}lBK7x;&v1!M|BTYX=Zc7yFxWgB&bt6&&YPT( zFy)!a>)(_4{LIM--V3{2tv|n?vypKVUp+Vpj8*@*3-Z6eYnW3i&PNou{We$eR@QUUAmZaTjd@I@QT19bnnY7O!1=s* zR}_bB&G<)k8ltMUEWH+cljctg(_4no+^;3dz^x_DjvT(G=F*DU!LQ%2R#p-Z9otVx zM2z0arDcCVCbzGB>A)I@`$@m)@ZJ6kFn6Dw=8((_tdw)Xt(^1Co8C*6Klejjptr!w zKP+_u<=s;TMF*HTV##?l3eAPHmo8oa9sf;0eA@FG6$uQ_n!V+$;T6AWZ^dR@C_as36neP=DfbD`Q9 zmvLsfSQ8CR$Egg~Z*{m4p^^2UHHzXT*q3e*KDyXkZt-*3vLMx6;pv;I5SGl;#N{(t zMfc*3jJ$Q272zUL9<8`BQj)+aFe{$oo*0;yQvjP3gB%E`HiI0XH5;#HmD!;`N5G$X zUCiM&rJ|>%#e`dSgQUT86WXTq^cIQ&6Lo2iTpV@MKaDr8?5zY17Hi_&CJut1CxL`) z7CcN;fuh*8p|>OkgfIPM)bZv6WEv)A{8Ia4iRQ0ex_HmU3KszO3xRI-9Dl8OPBBsq z(PzdA&G6{&Un6NU|F6^in&R5W74xf`W|)`Qu?% zLnQz<>X+-*>lSOHxtnxfv|+T$?xMoOqI(%TWA{g;W-69!6MHlMfIF+V>(Z4j3(L`) zK4u&zGOxclRCjiFcZkdc?3QS!#D`_r@5nk-Uv<5m<4{{50g5z>unTJY5AKk&vPq!9 z*M|>VBa`Ba?dsjplr$hOPqf8Gy^q31fix~XYbFK*mU(@Gq-1OX@C`}#Tn}!h`pJBO zqdCn zy}`BsdEF$A?DlQLxteMe3ikS_!;rwh7-ULJ`bw$3-!qtX_Ha;;)x=LmnpX6ISBl1q z7jblr)}uMu&ubaDY}8#NW5dX7QXNK}oSY@=`7^dMtbAVy(QlHXz(Hc>d5By%KjTJL zV4G$77=QyK;@hv!Yu79sJ-#82|4J^e=!l(UEJTKY0rl&B99+uFK{-aTnWd#zg#tDm zpj*F-JbIWvKax)?h`x8ZDR~yZpNWMfN_)D%kKNHx(p+wFcxT!n{y!#!28K%)m8+aZ zcvOdC!pTJHouYX2QX1^kcRN=wifi*U;kXgwmYg@r_=^*6O0el!|_VXH5yh{GI%Jk zxFkz-^ip#%Uxv+*HsBy$N7H$s#_E2ii&jGN1w0&M*4}Af#uzVD+~Q=J2;1r?2FePI zEoat=c|0{8cvztMmAvbHT@2cjIq@Lh?x#E)%y%Q6E223AN zWvEyf9v97rM5H7qYp#fp2|Al$t__?x0buJ8K}kv!!q>Fb%sBI-1I9sh4gsoj{UJ5a zm;HZpmh}&IcYNa`UT{LhjZaxIbY=*jfGh%|;|B`W-XwAdo|<+J6*4jb&Un~_jzE^aCr?v4sj!R0d#7uL%cbAK zYR2=)Ci)H@3C+>Cq@Ottpjg?X>|TR(XMKB#xq&dmB#me@7iLKYDheHZ$dY9GWHU1x z4Hv`1jh}TYv_}@V=QXNeB=@-cN9f~3#Wk2Do{uzr>ylPmF{5d3myTL&y>jpxz;p0U z>_Gjj?Pzo!#8~6sXjzCbm8UpRW>yhS?vDFqf6nPp1pCcQCKZ?; zmkR~Xg22F9*tCSl!*tr+D=52_B(f3Pvuj_JTHhtdN96X>l$tDw-E&Zh3FLpVU^w`@5f?lqaVvq&7%M}U zE+kDgzQp|#|4~Bz@`;5meDew1_8%7}Z?S1(reQ|Bi;fNf65;SA`hnGy6Y9HFQl8W4 z@9&Z`_V)H%H^{{Tz-Gr%?mKy?4qvZ$9;m1UR^SQX zgYW~748CD1ehz%bUj3F}CtWbubaRh`q!IZ55z^x5)tlUQbI^xG&13 zrRve0@L3sBlk&N2y`E1v>Anr7o}`Tp#V(wudqbD4#_GsWh^3&z@9kQ|S2Tk^T0Q0X zM-rGM7)swAJ*;hiWmza4<=w+0d%%K~B zdG>nSo$wNz@mimEU9xhrGt1s=xwK;vq{AR`dU}yfrwkvwW-1<@Yruluvp=BWx0z7g zoWc1or)=4x9<}H8sUk1Jr6c_7>rB(GDVu3@n(^YXHDYOa-$-j03s90T8if_NL^RPK zgnzYT57-Xc#5{f53eUt}NmlffS&ojhWz^36iV#D0k*lav;TgirZn()=7@20^1HM;` z&enoi1fsq?6Mr|^>+Q0R1()C4_EpWNAQF$-&cu$t==t{L(5&lH?TOMIft$K62|6-q^`pG~_txwM1X-Ij{c zfqzIx*z|FX>E$$Sz+U_%%95n}8zPr3`B8C*;zQS0?CORQoER^>?%^XK;i7|j02l2Q zh^*WJ2L_LD_j-ut8AoL!9AfaMyP*B#bD%`R$oPEZdpYcy)_hwTpV}Y3WxalV&)#Du zPLA0fxXy(0)_AQZ*IPGlM(=c_d3Rf7mXrjfHJvCdX1(2o8#<=$#ScHByN~#pFAU9

wlpE_hG)xPma8~q}zP=3L)RQ%>pW!s%Y-&%MaiN00?WMP0-@^~HgrFk~F-DM|8FomRZfHKG0UnYdbfSvYb)7!T{O^w}`^;az?QsF& zI`o=$Ks6)Zdkt4>jNnp4ZbLxmE$tf5C5qzd&%SUEJ}OERG-oq1B3O9*T0MGRVk8+K z|1TiLszA^plN>M4>;^ut11(>SP3<@00w%R(VCjpbb7wIYPosdz$@fH$QW*O>XcRg! zGMGT$mDt5dgdFdezM8JqI-4K{*g!7oQ5(1vJM#jcwvW))7B@@&Edc?m7TG>cE_4%d zj*V1;Tdd*jLS>F$&^0dS)Cd^;ZTTKNZqi>%c{&0%{#ZUH-h zA|%_segNyU;*(_%(4y)IA0|PWXG=L3saijliMq;;hjrJ(&cK6rU*uKXk8_R)ajIs_ ztp*&hKJ5;(SX2G|Y3Voa_pBv;aFW+WxLp8q)oaebeZT;|#Rnih8g4;iDXBJqO{C#A zOE1*D_Q(71V(wGU`Gs2fs4FkPFor$nI?%waUHcP5XVdLrqzFE9@6{toQVq?Y=`$~GjTaF(+v@p(ZP+q+ za$$}j`U9MCzrTM(K+x&i{HXn&)dG*n-OaYHyMXJCX$gFp_U)i=G6iOR8LZ?Nipfj@ zuCalE6|6A$p2uk11S>{sljqsMp)!K)f_H(8V%{H*q*OYMjjjE@H?g-5CvVokgu7K@VRU(4I)hAq=+XT zKB;eDo)(A+knFp5eSLxe^b;T%_$(bC0b!|=)J~Zs{HH5Z_OBmeeDTzp6&|+#Z{Li z9f9_rCVxuNzpeuHN(*}h5Zke$26}pWJx2!w0DP$vno6~0fY5Bcp=0z7bqm38VS;5r zyA6Lmd@{Hu2T&{}Nc_)WHpMYK&EbHDO6OMigRRXJd-&~zue$n!K8tlp&xw zgeb;enah{_f91BpD}{u-3^)=QG79dtGiI!|AOm;<>2D65unwivIrycyERX4|Zv_-I z*D2Q9wSFfMsdH|5L)kRsY#;b21c7KX1u*8T1t@{^zv)geC$QL&N>Ae^@%dX9hl{79 zl`ty3u{N<5p(nZB}fXN>c2vx$d}`WT;gHykLz>VK0M9I+_?C^e!@te1O93V z|G#0ne|-}F{@4E-T>OuZ*j$Y!R7N*geXrqS1;D7$*wgJTWJb*d? z-w!w|2L_%+BOzipPlQsd76IZC=D!w*+^|lX{*!+J;N1_F4!Z88v+^rQ_znieyKAjM zKSlXeTK@CoR5PD};FHzQMqEvs8u>U-b?=;7(yk_uSe^{Q-8YSOEv_ga%{zV4sa@LN z%xD-3e6VL<-+4hsh|@(#sw}w*)P)wX9Z{%`v+3&+5*XIEWDCp7%ga1AG++e0f~qL3 z{6c9-%shEE{WsvA!>%w)A@AbjapkYQblh5h%S_PmP^qL!C9N7Bi-(xP4;(CRhlYh2 zS`TBXGKNdRqOiD`3~OyBWAA*U0Se+U;2*I+b#rXbo5i5U!y?>tnOm1yhY21?el2d> zsw&PSOXJOq;a4DlPE*_`fgsfYJRSlc$u73pLj25ZsQKoN180)SCIPFDaGXz`U*ADz zSP45E)sdYY{;@?hcmAEAvmb#K4$)#_#hR=_8NJ#ISBDb}*B5%9sHxF?N)e|L_k78t z#b<*BU=fL6Gm>kIbrbP^T6*&VbuS8qa4hg(W_EE`GrznEr{6p>UZYCb_*Vf6)IT`7dNZ zsqWL`z~|R8L5r!mW=epsei?>y6|hF^dq)j+&*1?VBiDRVg7CDQ<>mduzp~MoxHat zvvj@sJ2>>J7AHmZHxS@brQ2x!rakxOP2ta*#@`3hAXHJ@@|QMqe)~^}<-5d0dhNK> z)F6;|K-a+mWGh5=UWR$nd+?yi{^W0gJfGlK^h40y20Nk|FHsDL^yF2{n}WWzFfNbsfyJz)r$=ofS3!r0 z5IYi}Cg%L!SqNDzoizj-EPeMc3UkW7a~@Y8Pj~c~G^sru(llB%Rt;)B?}0~z$16w= zZxK5D2w|5p3niSIFemN)d~Gjse}ZIL;$q$hXDz5r)}P~D^E$-_#!7SC#ct)NwbcpS zV$JP8vHQ8~5wO|Ff#vs)Gqp`oDJdzf>LX4t5j?nFVk4u>0ur_%S29>$Tbpfgk+!J6 zrzSxZ=UfAY82(R~U{+e@dkMhg!`2K#<0%pd0a@1HlPsY}zS_?or^vlYX30v&kV^&B z1PFFWkgzI5gSJNhv;W&H!i1!xyOHwYYt>s9QSa|;l-d2zgneYtITE$)P79Cl=zoPp z@8z2Siv-_vz*^hdH^{TK7uEMSPRS*V51MTskW(t3k}$fa8R)J5i@3N|r^0dSl$(~dWiH!u1 zHsvIosi7fVSx+d$R9zm!Ep$lMuSbB*cEA8yp zFRHiS$iYNXRCcC`-sEE>5EeNB7KT(7eI=SDHhvvUh4!sixF=kkHc=?VVszdT^M`!HWaCSvdFg84v?Ae1 z^v7YNLcMzzqq2Db2N9@v62KKLudO_54ZaNPw3dZuz=3rsI1HCy`+{dHfa7M4Uh0a& zXdjpf;GOaMU~;#@??7N)o? z+V5=t=qkjQQ9gj@Lz;NY@aY#v1rWa_z$y(5yT0=sxF#T76+hlKnq2;X@)<0ShfFqW zC2~OkEr5Y)k07NUUS{B5YnAOA9hCst`f*A<+b7YcbUc)y)oJ-huo6H%lpnqI$U5yn z7^5CdDFeR5;Xw%L&&CDVRrusQ|G2#Z3>f9p>x%-7*1Z1Fp8suu7bH4k!O~iUF6|nc zzK7D>nx7$M>kM#7Rc1|7oo&eM)jiek13GV79LP2 zA6wC6j_5m@0C^%u6AB4#9*TOfRW@=r`o0;sH?t619^4%j&-s_)iHZshY1vlvO7uc_ z_`k|)_Ue9Ny;A#7kETdZPsj83zXA;jzK{fQKJ&bkZ{E9eZ<+bd`bI(aoqvbKmzS~Z z4z?d>Wr=q5t1iuMoM1s0qn)!u^G94pIsN6o7^y&u>mm5bMM;@Zq7-^(09U$1jUv=d$t@}H{~45hr;`Q&E8|?wU%)}Y&GrFe z#|Uahjo~KG;-k+8mZ7lME}<%8Slc02E8;8_PaTLuUOq>OBI2sCOrGAErt8V^e9W4O zq+~k^$*BZ+aftL)YihwK~o8nK$ZfiShV8c*hE^Y`ItcF+0v;=_lu?;;Z+ z?yLB0CWj9Yajn@WoggL-#k|t`GR@@CJ3gZLA{taAch5HRby@;-Xh!3@C_3PE_ z5P0&r;OX{Ak&LF%z{$zU{`glKd@daj+(E)+a3V0CjTh`RP#TbLKiujhNCEWW> z@|rH$Sfxcc3=v%$=0%|`Ei_N-oXJ4Tmx90?fF*rj3-FH*HvOypao!0<%@!`P9g{cs zr2ond3|AB zh%~fr;y0`y$t4tEMar%QPN}#i*{09uK%?9~*q1Rs>{06E zXAc0G@uwTl9?3nHveBnV;xBvSIiUf8T@p6-tTfev_K=c+;o&wH1FyFb@@7^SrEHSP z=p`4$a#CFTHuW3g@1SBeF)=YgPZQeV0LHxJ&XZtmqg~dhVa@El-A6fZO~M_>u#L(K;DNio{{9YcX0TICOB$UGy*&696DSvkRtLb_y@j`o{A)iO6C zh4ji;wpe_YJ?DFlSg}Gv{YxbSAwlv%sh5MKubR>M{N;7TCDt^RIo%x;;7-f#tbYvO z$>aA8Z%YFoA-31YVrHE&eyQpop87eix)czL}RU761& zwm{o2+X+Gv5^Hha`wMj$_g=10@4Gxc-P9i$72}9I{cL+8m@ry+?U%`&Pro`iv*-NE z89evcVO4`Ok`n1fh*~_qBN|4_s5cA7lgYKl4t5vL_w}!EAdrw@9N>&BS3}PK+Oqg< zYTakMfMpE{d;>ofl#*=!$a`kzXjZs=tR~fiHdtI3y8*H9!0@2a<$Jo$XTH$kbx*KD z3eE8tymPhM2~Fwi7SEoA*X20%Wfn%a^qNoh-F)!n!z0#|A_;YM<@3D2uB{8Wl3N$R zScwZwKPrH*7kr^8I2LQpf8oEE7y79=;$o;J$UXmOPXQiO5}MV-KJl59jc|NI`X1Pq z{?2~=*_bM58VQEynTL?eRY)-OK{|r}yh`gu9r}OMykJCM_VJ@tCr>*(#1K^!H9V1Z zG41W#VWKxa5qU^Vg(Jki{1pcoNPZ1qV4Uo$xw5#~-`D+jJBQ87-!1Bh`5H(3d+d`_ zSdW{NF}xz0r%S&#Gnccuy92kA`JaIPI+#UYU8dhawOVfX0PcV20syl!1j4UT|>HSo((a+JMU)_2HPRZ!>XcZ(+zSJ6|R} zJibf?v(lPoPXJ8dM5(@qB!$Gi57soQ?m2C83xD>&CrbkXlb!2NYY^mpub>bb47o6Y zzJ_rW91bbC5<|&EK2FZ4s{hy+=Jy2KFpB#I`55Mm$H9l8gVjlN!3g!uhGJ0Ni0agT z&X-x{-stP^e*id_;Zzovk899a01 z`l7h_7cCZ>j zg7P-NbGnO5>EEW@8?|cBlwx9HP%w*SM-vP+2>kD}>DNGdWmLVO6$zIRlA(v|U!_~3 zl?ES>zYtBEXZumLc@UJC<$|B(uIVhxbCV{8O_)2So~yATa`{|ZqtwfZ90#;IS|2au zf9CoKzcQCXW`r=Zp_r=8Jh3a~;KU&OWqvgfNAGam$Jzl{Zjcfb6eN z8(hJ7J5%B|F_(g^_O5NG4zxyO<~tc9kwmp!JqJ0K-<;Zvq?aEm+#%CzSb04YcX|nY ztL&05uvwg*uIYUJDkt#BUrLf1npxoK_@&FhORfH*EQM5<=`P5_@~Pg78=64RhLPzY zfPKV8iLBd0e=#I!X{&6^b!{#ufwh2~*4y9AAh;)IJpo=N?4;CGcS#U$4~~L+ulBCP zXW7@7k}`yLgrTPqmoig5nXkJuxEH3laH2xTqMM{xJqI+jA3aHC4^3UVctoRZhN9;tNu zLIeVQTbr5M0QIIHv7ttX1;NwmsBgTtQOyk}xb|CT(D&IE=dQ==I=b@*_v>z@Zq^TW zm=}R7sBz!AAl&d*F4yA4O$z+srzUIo`sA_)Fu{B2e7*u8^3trBF(qr!Ue90*}tR6%-}O zlX*Us4~zPj7@&ZgN!KXSIkXs2%Ra~tC2<^wCe_pT6?@nFT?_6FB=N6Os=LAqpkyL^ zFQCX-6K)_;Vj!UK@Ca!tKXW%?h&22x1)TD=(!-rmF_|5RXCgi-n9|M7;*Mk*R@{}A}}Ou;@!9YKCwwG6uc1;9@deuNH%0)TF90()Pbx- zQNzjGY^NrA|KaOdoeM;tm$S4idJwlLSBSE?WZsRR558SjBR^zplE?Y+#&enRsK)(SLAFL-*Iu{o(kctOPJI`Vx@)Mre+tuJReJ*}fo#rYW>(-zqYO>{KWht~9$n~2yr!xA zALR>F!;i8aAGICaxkoMAxVE|;2+0j(s)Uby4puxM1af!H=nCU|Vo!y=R&Rkr+x&h! zt&3c7%Rf1n4$p3Li~@osufv=Oz@q#zF-i%6TmP51=(jgM))hZT=W6!(okBrJnU8fgFQoC7liSzs5*q zcc-AKjmzRtoY#C3?<^wCaI`TKiJSyi>XuplVab*ugx@iWPIGyA*$|Kd7%Z+$=~VtY zKfGEzRTlzM1VSewYiTw5k*qA2hV3B%QZ9OnM@&4T_y@|z9sRcyo{0eW7|#adjFs8f zD)^-`px-Ri-MNngZA1#mdpGJF9VDMUqb{Cl4Ds#wL35v;21QCkrig|p zJNR)IQ81C`?0F@LQX-{jaE>A=WUw`X-A_-^lZUH=1{f5W0i|HQW;3Y2oIJu77aEiP z$VOlEH>VzA*dqcdzH#(W~wJJO?oUQfgNvA#t&W9(| z#B)i9V6*&6n&3y`SfH6^#dWlYoHa>(+C|%rKjjrke8MDY<&mK_@Bw03jqmx0)&$P| z!gSG(fDwlGZ?wF4-q?IFg$be0=5@{&Y9~T%`??h0db)_)uKyr6RGzs5r?WA{W5Blz zoAH`?J*BJJ{aFBn$#l90KOn3wQt$l6RfI>_lQ=wN)P@%LsgOA9=2iNa>c!7v1)T$& zm&d=8D&7{5^m;)3IISrZ&Mf=Wy(Y6~mb3!J&h=})@Z5xMfy@w9Of8_gFwY|F0Zs&n ztkkVFZLGm5OwB3*TxJ7J+lTPcvazokgAoCpcvu9+5|a*10SKSVEqDXKV$HEqz5e5yQrajt>M9);bP z%F6h^*|kH)Y9xnv3Pbd#QV@}6;T9nk(;?}k@Fq1p5doiVNh6E<($|Lq+vLmsG6(Fr z&%i84p_09HLxIC6%vuNV@)srE+kVEYvFgbD!GiUKttJj0`5~V?rjqjrwR4khy!WB18D?!RR5(ki_ODz^X2 zbNy(x^WTHG+0z7|W`(_Z^U&jL2lI9Wg`(tM9gL3c(9bsebv$Iu`;hRs-Z5VIC8d~a zFmU3aSBRxi=Z7Q!J%p4LSPF9Na#Kln9|5c21hktlPxD& zu<&+3p~XgyUSEE;FI3;8>yasY;6n&-)5WvP+O$w%b)*BP1*CES%mqVOCXv3F;#hWt zwV?-w+p3cdXcSr1W}Fj zok)~T!IgEsu_W(C3Z;r7B0acE&_6@heX_S6oSDl( zCBz6#NfeodFEMdMrTCziN=s*`LutmFLHqYW<~5`=@IWM>)cu?bsX1vA^JZO1>2C-j zKoTb#tIN)Q$f9#ekyRPR^M=9(fkq4%Q#H@^*kEf>|9}UXHZD>;&79&EG zz5qQ7PA=t2C z+;eClYQ;oH^O6t~5+WxlYWs`3?fl=Xne->l0NTLbceuHfjTI64Wzo{cp~TW@*>FbM z;&xH_V&B5__BNE{L(Ps}LA(SElx8CpSCNJb#bjP-6%{!MPnc}L!3vW&XnUDt~<8KoCs+v;~(ovCgI8|G?L(|oM|;YD#&m;{N=U0Fh*g}dqf0iAi{0E zc$}=ojDDzn*$-lg7Ssw|YQ#&Xbh}M%H9pYnBuHHZIobq>-zBp zzEQeC7PVY3hCb@?V&pEQvZ37l=32-3Jh$qyXHDDfQpO4I7c3EKx) zJqC3*Kv*z@>V~nSjxKBhIRlCbC5Lq-up1LJZ<`4TRd%5NXdtbSC%9=*$v*L*M{&OJ zf+G?0QC#ib`o-iNMWkX2*dAn1hBP0WHs#?0^WL6CYo9nJnMP0i@g`#^`D>8DOWo$3 zks^R7eFOFBdO2A1pcM(^`b7EQ8Tq*m)|u%W%@W>N)81<4kaNBTY~>lBJ%EQ z4nw>2;j5qSOe`Gjz5x-+Pqehm(M0$S(-tbH3>u)uc$Z9GLP6eR&uaeUsukucyDE2QW1ouR^7kBto}6F;({m|s z$>4=y*{droD%xCTu2ma9Bj6fJNKDL7>MfSrLJJOwy@;wGuPQ&oJ*GjGCU_nURjQz@bJwcNo%{9 z2&X)xTWMi%5<*k7qu~_{@LM4$flpqml_?`;m}ur_{(PC&N^&x6)?xIJNEVbB5fF&} zstq>w*Vts20`?0^Qwfiwk3+%K0t-spMsEpfYT!2!?>RHiZ{gOIxsw`|K?Ht%9jr z)u^itT^NU!e=It8>Rs#~!Ye86p5&T{xU`{G|u=Y%k1XzeRHLkK# z^|4Mi!D{WE2KwYQ{mDL8UzNOu#*-R%QE`29;+hYyMFB#16ISUk_|klCguH+66B4

7vaJV}5_pCiZ)xJ!&~ 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 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Trial + Free plan + Paid · Capped + Paid · Metered + + + Unlimited + Hard cap + Quota wall + Metered + + + + No quota during the trial + + All metered features open + + Reverts when the trial ends + + + + Fixed monthly quotas + + Blocks at 100%, no charges + + Resets next calendar month + + + + Pooled per-seat quota + + Returns HTTP 402 at 100% + + Enable overage to continue + + + + Pooled per-seat quota included + + Extra usage billed per meter + + Optional monthly spending cap + diff --git a/src/content/docs/management/company/usage-based-billing.md b/src/content/docs/management/company/usage-based-billing.md new file mode 100644 index 00000000..97cddaa0 --- /dev/null +++ b/src/content/docs/management/company/usage-based-billing.md @@ -0,0 +1,228 @@ +--- +title: Usage-Based Billing +description: Learn how usage-based billing works in Testomat.io. This guide explains per-seat quotas for test reports, API requests, and AI tokens, how to enable metered overage, set a monthly spending cap, and read your usage on the billing page. +type: article +url: https://docs.testomat.io/management/company/usage-based-billing +head: + - tag: meta + attrs: + name: keywords + content: Testomat.io, usage-based billing, metered billing, overage, quota, test reports, API requests, AI tokens, spending cap, subscription, fair use, billing portal +--- + +Usage-based billing adds metered limits on top of your per-seat subscription. Each billable user grants a monthly quota for three metrics — **test reports**, **API requests**, and **AI tokens**. When a quota is exhausted, the feature is blocked by default. You can opt in to overage billing so traffic continues and the extra usage is charged per unit. A monthly spending cap protects you from unexpected charges. + +This page explains how quotas are calculated, what each metric counts, how to enable overage, and where to track your current usage. + +## Usage across billing modes + +How metered features behave depends on which billing mode your company is in. The four modes — Trial, Free plan, Paid with overage off, and Paid with overage on — apply the same quota model in different ways. + +![Testomat.io - Usage across billing modes](./images/usage-billing-modes.png) + +- **Trial — Unlimited.** During the Free Trial no quotas are enforced. Every metered feature works without limits until the trial ends. +- **Free plan — Hard cap.** The Free plan has fixed monthly quotas and **no** overage option. Once a quota is reached, that feature is blocked until the next calendar month or until you upgrade. You are never charged extra on the Free plan. +- **Paid, overage off — Quota wall.** On a paid subscription with overage disabled, you use a pooled per-seat quota each month. Below the quota everything works as normal. At 100%, billable requests return HTTP **402 Payment Required** until the next billing period or until you enable overage. +- **Paid, overage on — Metered.** Same pooled per-seat quota, but traffic continues past it. Each extra unit is reported daily to Stripe and billed per meter rate. An optional monthly spending cap acts as a hard ceiling on overage charges. + +The rest of this page details the quota model, what each metric counts, and how to switch overage on or off. + +## How quotas are calculated + +Quotas are pooled across your company and recalculated on every request from your current billable seat count: + +``` +monthly quota = number of billable users × per-seat quota for the plan +``` + +Each plan defines its own per-seat quota for every metric. If you have 10 Professional seats and the Professional plan grants 5,000 test reports per seat, your company has a pool of 50,000 test reports for the month. + +The period is the calendar month. This applies to both monthly and yearly subscriptions — yearly plans still receive a fresh quota on the first of each month. + +:::note +Quotas are pooled, not per user. Any user on a billable seat draws from the same monthly pool. +::: + +## What is metered + +Three metrics are tracked against your monthly quota. + +### Test reports + +A test report is a single test result uploaded to Testomat.io. Reports come from the `@testomatio/reporter` package, JUnit XML imports, the API report ingestion endpoints, and load data endpoints. Every report counts as **1 unit**, regardless of status (passed, failed, skipped). + +### API requests + +API requests count writes and other billable operations against the Testomat.io API. Reads, UI traffic, and report ingestion do not count here — report ingestion is covered by the **test reports** metric. + +Weighting depends on the API version: + +- **API v2** (`/api/v2/...`) — counts **1 unit** per billable request. +- **Legacy API v1** (`/api/...`) with an `Authorization` header — counts **2 units** per billable request. The doubled rate is there to push integrations toward v2. +- **Legacy API v1** called with cookie authentication (UI traffic from the Testomat.io app) — **not billed**. + +Only write-style operations are billable: `POST`, `PATCH`, `PUT`, and `DELETE` on resource endpoints such as tests, suites, runs, test runs, plans, labels, issues, attachments, and similar. Ordinary `GET` reads do not consume API requests. See [What counts as a billable API request](#what-counts-as-a-billable-api-request) below for the full list. + +### AI tokens + +AI tokens count language-model usage for built-in AI features — test generation, AI editing, conversational helpers. Each AI call is estimated before it runs and reconciled afterwards against the actual token count returned by the provider. + +If your company uses a **custom LLM provider** (your own API key), AI calls go through your provider and are not metered by Testomat.io. + +## Free plan limits + +The Free plan is included in usage-based billing with fixed monthly quotas. The Free plan does **not** support overage billing — once a metric reaches its quota, the feature is blocked until the next calendar month or until you upgrade to a paid plan. + +Free plan quotas are visible on the billing page for any company on the Free plan, and on the Upgrade page. Test reports inventory remains visible on Usage Statistics even after the quota is exhausted. + +:::note +On the Free plan, hitting a quota does not charge you. It pauses the metered feature for the rest of the month. +::: + +## How overage billing works + +Overage billing is **off by default**. With overage off: + +- Below the quota, everything works as normal. +- At 100% of the quota, the metered feature is blocked. Requests to that feature return HTTP **402 Payment Required** until the next billing period or until you turn on overage. + +With overage on: + +- Usage continues past the quota. +- Each unit over the quota is billed at the plan's overage rate (for example, $0.01 per 100 extra test reports, $0.01 per 1,000 extra API requests, $0.05 per 10,000 extra AI tokens). +- Overage is reported daily to Stripe and appears on your next invoice. + +A single toggle covers all three metrics — you cannot opt in to overage for only one metric. + +[Screenshot: the Usage & Billing page showing the overage toggle and per-metric usage cards] + +## How to enable overage billing + +Overage requires a paid Stripe subscription. Only company managers and billing users can change the setting. + +1. Navigate to the **Companies** tab and open your company. +2. Go to **Settings → Billing**. +3. Review the per-metric usage cards and the indicative overage rates. +4. Toggle **Allow overage billing** on. +5. Confirm the consent prompt. The user, IP, and timestamp are recorded in your audit log. + +[Screenshot: the Allow overage billing toggle and consent confirmation modal] + +To turn overage off, repeat the steps and toggle it back. The change takes effect immediately — usage at or above the quota will be blocked again from that point on. + +## How to set a monthly spending cap + +The spending cap puts a hard ceiling on overage charges per calendar month. When the projected overage cost reaches the cap, all metered features are blocked for the rest of the month — even with overage on. + +1. Open the **Billing** page for your company. +2. Enter an amount, in US dollars, in the **Monthly spending cap** field. +3. Click **Save**. + +Leave the field empty to disable the cap. With no cap set, overage runs at the plan rates without an upper limit. + +:::note +The spending cap applies to overage only. Your base subscription seats are billed separately and are not affected by the cap. +::: + +## How to view current usage + +The **Billing** page shows live usage for every metric: + +- **Used** — total usage so far this month, including today. +- **Quota** — the pooled monthly quota at the current seat count. +- **Remaining** — quota minus used. +- **Projected overage** — for paid plans with overage on, the estimated charge based on current usage trends. + +Per-project usage and a "by user" breakdown for API and AI activity are available on the company's **Usage Statistics** page. Test reports, runs, and seat counts are tracked at the company level and are not split per user. + +You can also query the current state programmatically from any project: + +```bash +GET /api/{project_slug}/quota +``` + +The response returns quota, used, and remaining for each metric, along with the company-level overage toggle and spending cap. + +## Notifications + +Testomat.io sends email notifications to company managers and billing users at key thresholds. Each notification is sent at most once per company per metric per month. + +- **Quota warning** — at 80% and at 100% of the monthly quota. +- **Quota exceeded** — at 100% when overage is off, so traffic on that metric is now blocked. +- **Overage started** — at 100% when overage is on, so the next unit of usage will be billed. +- **Spending cap reached** — when overage charges reach the configured cap and all metered features are blocked for the rest of the month. + +## What counts as a billable API request + +The following routes consume the **API requests** metric. Every entry in the **API v2** table costs 1 unit per call. Entries in the **Legacy API v1** table cost 2 units per call when called with an `Authorization` header, and 0 units when called with UI cookie authentication. + +### API v2 (1 unit per call) + +| Route | Billable methods | +|-------|------------------| +| `/api/v2/{project_id}/tests`, `/api/v2/{project_id}/tests/{id}` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/v2/{project_id}/suites`, `/api/v2/{project_id}/suites/{id}` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/v2/{project_id}/plans`, `/api/v2/{project_id}/plans/{id}` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/v2/{project_id}/runs`, `/api/v2/{project_id}/runs/{id}` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/v2/{project_id}/testruns`, `/api/v2/{project_id}/testruns/{id}` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/v2/{project_id}/rungroups`, `/api/v2/{project_id}/rungroups/{id}` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/v2/{project_id}/steps`, `/api/v2/{project_id}/steps/{id}` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/v2/{project_id}/snippets`, `/api/v2/{project_id}/snippets/{id}` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/v2/{project_id}/labels`, `/api/v2/{project_id}/labels/{id}` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/v2/{project_id}/issues`, `/api/v2/{project_id}/issues/{id}` | `POST`, `DELETE` | +| `/api/v2/{project_id}/requirements`, `/api/v2/{project_id}/requirements/{id}` | `POST`, `PATCH`, `PUT`, `DELETE` | + +### Legacy API v1 (2 units per call with `Authorization` header) + +| Route | Billable methods | +|-------|------------------| +| `/api/projects/{id}` | `PATCH`, `PUT`, `DELETE` | +| `/api/{project_id}/avatar`, `/api/{project_id}/artifacts` | `POST` | +| `/api/{project_id}/tests`, `/api/{project_id}/tests/{id}`, `/api/{project_id}/tests/delete_detached`, `/api/{project_id}/tests/{test_id}/copy` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/{project_id}/suites`, `/api/{project_id}/suites/{id}`, `/api/{project_id}/suites/delete_empty`, `/api/{project_id}/suites/{suite_id}/copy`, `/api/{project_id}/suites/{suite_id}/markdown` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/{project_id}/branches`, `/api/{project_id}/branches/{id}`, `/api/{project_id}/branches/destroy_merged`, `/api/{project_id}/branches/{branch_id}/destroy_item`, `/api/{project_id}/branches/{branch_id}/revert` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/{project_id}/templates`, `/api/{project_id}/templates/{id}` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/{project_id}/diagrams`, `/api/{project_id}/diagrams/{id}` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/{project_id}/plans`, `/api/{project_id}/plans/{id}` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/{project_id}/rungroups`, `/api/{project_id}/rungroups/{id}`, `/api/{project_id}/rungroups/delete_multiple` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/{project_id}/testruns`, `/api/{project_id}/testruns/{id}` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/{project_id}/steps`, `/api/{project_id}/steps/{id}`, `/api/{project_id}/steps/delete_multiple`, `/api/{project_id}/steps/merge` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/{project_id}/runs`, `/api/{project_id}/runs/{id}`, `/api/{project_id}/runs/delete_multiple`, `/api/{project_id}/runs/merge`, `/api/{project_id}/runs/{run_id}/relaunch`, `/api/{project_id}/runs/{run_id}/relaunch_copy`, `/api/{project_id}/runs/{run_id}/email`, `/api/{project_id}/runs/{run_id}/plan` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/{project_id}/labels`, `/api/{project_id}/labels/{id}`, `/api/{project_id}/labels/{label_id}/link` | `POST`, `DELETE` | +| `/api/{project_id}/attachments`, `/api/{project_id}/attachments/{id}` | `POST`, `DELETE` | +| `/api/{project_id}/tests/{test_id}/attachment`, `/api/{project_id}/testruns/{testrun_id}/attachment` | `POST`, `DELETE` | +| `/api/{project_id}/settings` | `PATCH`, `PUT` | +| `/api/{project_id}/sharings` | `POST` | +| `/api/{project_id}/pdf_export` | `GET` | +| `/api/{project_id}/prompts`, `/api/{project_id}/prompts/{id}` | `POST`, `PATCH`, `PUT` | +| `/api/{project_id}/analytics/query_settings` | `POST` | +| `/api/{project_id}/jira/projects`, `/api/{project_id}/jira/projects/{jiraproject_id}`, `/api/{project_id}/jira/projects/connect` | `POST`, `PATCH`, `PUT`, `DELETE` | +| `/api/{project_id}/ims/config` | `POST`, `DELETE` | + +The following requests are **not** billed against API requests: + +- `GET /api/{project_id}/quota` and any read that is not in the tables above. +- Any legacy API v1 request made with UI cookie authentication. +- Report ingestion routes (`/api/reporter/*`, `/api/load`, `/api/test_data`, `/api/test_grep`). These count against **test reports** instead. + +

+ +## Exceptions and edge cases + +A few situations bypass the standard quota rules. + +- **Free Trial** — usage during a Free Trial is not enforced. Trial accounts can use metered features without quota limits while the trial is active. +- **Enterprise (custom) subscriptions** — quotas can be set high for blocking purposes, but overage is never billed. +- **Self-hosted (On-Premise) installations** — usage-based billing does not apply. Enforcement and reporting are disabled on self-hosted instances. +- **Custom LLM provider** — when your company is configured with its own AI provider, AI tokens are not metered or billed by Testomat.io. +- **Tests inventory** — your `tests` count remains visible on Usage Statistics, but tests are not metered or quota-enforced. +- **Mid-period seat changes** — when you add or remove seats during a month, the monthly quota is recalculated immediately from the new seat count. +- **Plan changes** — when you switch plans mid-period, remaining quota is preserved and the new per-seat rate takes effect at the start of the next billing period. + +## What's Next? + +- [Subscriptions](./subscriptions.md) +- [Plan Features Comparison](./plan-features-comparison.md) +- [Audit Log](./audit-log.md)