[{"data":1,"prerenderedAt":986},["ShallowReactive",2],{"navigation_docs_en":3,"-en-guides-authentication":98,"-en-guides-authentication-surround":981},[4,23,49,83,93],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":22},"Getting Started","i-lucide-rocket","/en/getting-started","en/1.getting-started",[10,14,18],{"title":11,"path":12,"stem":13},"Installation","/en/getting-started/installation","en/1.getting-started/1.installation",{"title":15,"path":16,"stem":17},"Configuration","/en/getting-started/configuration","en/1.getting-started/2.configuration",{"title":19,"path":20,"stem":21},"Quick Start","/en/getting-started/quick-start","en/1.getting-started/3.quick-start",false,{"title":24,"icon":25,"path":26,"stem":27,"children":28,"page":22},"Guides","i-lucide-book-open","/en/guides","en/2.guides",[29,33,37,41,45],{"title":30,"path":31,"stem":32},"Authentication","/en/guides/authentication","en/2.guides/1.authentication",{"title":34,"path":35,"stem":36},"Invoices","/en/guides/invoices","en/2.guides/2.invoices",{"title":38,"path":39,"stem":40},"Notifications","/en/guides/notifications","en/2.guides/3.notifications",{"title":42,"path":43,"stem":44},"Communications","/en/guides/communications","en/2.guides/4.communications",{"title":46,"path":47,"stem":48},"XML Builder","/en/guides/xml-builder","en/2.guides/5.xml-builder",{"title":50,"icon":51,"path":52,"stem":53,"children":54,"page":22},"API Reference","i-lucide-code","/en/api-reference","en/3.api-reference",[55,59,62,66,69,73,76,79],{"title":56,"path":57,"stem":58},"Core","/en/api-reference/core","en/3.api-reference/1.core",{"title":34,"path":60,"stem":61},"/en/api-reference/invoices","en/3.api-reference/2.invoices",{"title":63,"path":64,"stem":65},"Errors","/en/api-reference/errors","en/3.api-reference/3.errors",{"title":46,"path":67,"stem":68},"/en/api-reference/xml-builder","en/3.api-reference/4.xml-builder",{"title":70,"path":71,"stem":72},"Utils","/en/api-reference/utils","en/3.api-reference/5.utils",{"title":38,"path":74,"stem":75},"/en/api-reference/notifications","en/3.api-reference/6.notifications",{"title":42,"path":77,"stem":78},"/en/api-reference/communications","en/3.api-reference/7.communications",{"title":80,"path":81,"stem":82},"Nuxt Module","/en/api-reference/nuxt","en/3.api-reference/8.nuxt",{"title":84,"path":85,"stem":86,"children":87,"icon":92},"Integrations","/en/integrations","en/4.integrations/0.index",[88,89],{"title":84,"path":85,"stem":86},{"title":80,"path":90,"stem":91},"/en/integrations/nuxt","en/4.integrations/1.nuxt","i-lucide-puzzle",{"title":94,"path":95,"stem":96,"icon":97},"Changelog","/en/changelog","en/5.changelog","i-lucide-history",{"id":99,"title":30,"body":100,"description":975,"extension":976,"links":977,"meta":978,"navigation":167,"path":31,"seo":979,"stem":32,"__hash__":980},"docs_en/en/2.guides/1.authentication.md",{"type":101,"value":102,"toc":968},"minimark",[103,107,111,116,352,356,359,391,394,398,535,539,685,689,964],[104,105,30],"h1",{"id":106},"authentication",[108,109,110],"p",{},"The Aruba API uses OAuth2 with password grant type.",[112,113,115],"h2",{"id":114},"login","Login",[117,118,123],"pre",{"className":119,"code":120,"language":121,"meta":122,"style":122},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { ArubaClient } from '@fatturazione-elettronica-aruba/core';\n\nconst client = new ArubaClient({ environment: 'demo' });\n\nconst result = await client.auth.signin('username', 'password');\n\nconsole.log('Access Token:', result.access_token);\nconsole.log('Expires in:', result.expires_in, 'seconds'); // 1800s = 30 min\n","typescript","",[124,125,126,162,169,215,220,270,275,307],"code",{"__ignoreMap":122},[127,128,131,135,139,143,146,149,152,156,159],"span",{"class":129,"line":130},"line",1,[127,132,134],{"class":133},"s7zQu","import",[127,136,138],{"class":137},"sMK4o"," {",[127,140,142],{"class":141},"sTEyZ"," ArubaClient",[127,144,145],{"class":137}," }",[127,147,148],{"class":133}," from",[127,150,151],{"class":137}," '",[127,153,155],{"class":154},"sfazB","@fatturazione-elettronica-aruba/core",[127,157,158],{"class":137},"'",[127,160,161],{"class":137},";\n",[127,163,165],{"class":129,"line":164},2,[127,166,168],{"emptyLinePlaceholder":167},true,"\n",[127,170,172,176,179,182,185,188,191,194,198,201,203,206,208,210,213],{"class":129,"line":171},3,[127,173,175],{"class":174},"spNyl","const",[127,177,178],{"class":141}," client ",[127,180,181],{"class":137},"=",[127,183,184],{"class":137}," new",[127,186,142],{"class":187},"s2Zo4",[127,189,190],{"class":141},"(",[127,192,193],{"class":137},"{",[127,195,197],{"class":196},"swJcz"," environment",[127,199,200],{"class":137},":",[127,202,151],{"class":137},[127,204,205],{"class":154},"demo",[127,207,158],{"class":137},[127,209,145],{"class":137},[127,211,212],{"class":141},")",[127,214,161],{"class":137},[127,216,218],{"class":129,"line":217},4,[127,219,168],{"emptyLinePlaceholder":167},[127,221,223,225,228,230,233,236,239,242,244,247,249,251,254,256,259,261,264,266,268],{"class":129,"line":222},5,[127,224,175],{"class":174},[127,226,227],{"class":141}," result ",[127,229,181],{"class":137},[127,231,232],{"class":133}," await",[127,234,235],{"class":141}," client",[127,237,238],{"class":137},".",[127,240,241],{"class":141},"auth",[127,243,238],{"class":137},[127,245,246],{"class":187},"signin",[127,248,190],{"class":141},[127,250,158],{"class":137},[127,252,253],{"class":154},"username",[127,255,158],{"class":137},[127,257,258],{"class":137},",",[127,260,151],{"class":137},[127,262,263],{"class":154},"password",[127,265,158],{"class":137},[127,267,212],{"class":141},[127,269,161],{"class":137},[127,271,273],{"class":129,"line":272},6,[127,274,168],{"emptyLinePlaceholder":167},[127,276,278,281,283,286,288,290,293,295,297,300,302,305],{"class":129,"line":277},7,[127,279,280],{"class":141},"console",[127,282,238],{"class":137},[127,284,285],{"class":187},"log",[127,287,190],{"class":141},[127,289,158],{"class":137},[127,291,292],{"class":154},"Access Token:",[127,294,158],{"class":137},[127,296,258],{"class":137},[127,298,299],{"class":141}," result",[127,301,238],{"class":137},[127,303,304],{"class":141},"access_token)",[127,306,161],{"class":137},[127,308,310,312,314,316,318,320,323,325,327,329,331,334,336,338,341,343,345,348],{"class":129,"line":309},8,[127,311,280],{"class":141},[127,313,238],{"class":137},[127,315,285],{"class":187},[127,317,190],{"class":141},[127,319,158],{"class":137},[127,321,322],{"class":154},"Expires in:",[127,324,158],{"class":137},[127,326,258],{"class":137},[127,328,299],{"class":141},[127,330,238],{"class":137},[127,332,333],{"class":141},"expires_in",[127,335,258],{"class":137},[127,337,151],{"class":137},[127,339,340],{"class":154},"seconds",[127,342,158],{"class":137},[127,344,212],{"class":141},[127,346,347],{"class":137},";",[127,349,351],{"class":350},"sHwdD"," // 1800s = 30 min\n",[112,353,355],{"id":354},"refresh-token","Refresh Token",[108,357,358],{},"Refresh token is valid for 60 minutes:",[117,360,362],{"className":119,"code":361,"language":121,"meta":122,"style":122},"const newToken = await client.auth.refresh(refreshToken);\n",[124,363,364],{"__ignoreMap":122},[127,365,366,368,371,373,375,377,379,381,383,386,389],{"class":129,"line":130},[127,367,175],{"class":174},[127,369,370],{"class":141}," newToken ",[127,372,181],{"class":137},[127,374,232],{"class":133},[127,376,235],{"class":141},[127,378,238],{"class":137},[127,380,241],{"class":141},[127,382,238],{"class":137},[127,384,385],{"class":187},"refresh",[127,387,388],{"class":141},"(refreshToken)",[127,390,161],{"class":137},[108,392,393],{},"The SDK automatically refreshes tokens during API calls.",[112,395,397],{"id":396},"user-info","User Info",[117,399,401],{"className":119,"code":400,"language":121,"meta":122,"style":122},"const userInfo = await client.auth.getUserInfo();\n\nconsole.log('Username:', userInfo.username);\nconsole.log('VAT:', userInfo.vatCode);\nconsole.log('Space used:', userInfo.usageStatus.usedSpaceKB, 'KB');\n",[124,402,403,430,434,463,491],{"__ignoreMap":122},[127,404,405,407,410,412,414,416,418,420,422,425,428],{"class":129,"line":130},[127,406,175],{"class":174},[127,408,409],{"class":141}," userInfo ",[127,411,181],{"class":137},[127,413,232],{"class":133},[127,415,235],{"class":141},[127,417,238],{"class":137},[127,419,241],{"class":141},[127,421,238],{"class":137},[127,423,424],{"class":187},"getUserInfo",[127,426,427],{"class":141},"()",[127,429,161],{"class":137},[127,431,432],{"class":129,"line":164},[127,433,168],{"emptyLinePlaceholder":167},[127,435,436,438,440,442,444,446,449,451,453,456,458,461],{"class":129,"line":171},[127,437,280],{"class":141},[127,439,238],{"class":137},[127,441,285],{"class":187},[127,443,190],{"class":141},[127,445,158],{"class":137},[127,447,448],{"class":154},"Username:",[127,450,158],{"class":137},[127,452,258],{"class":137},[127,454,455],{"class":141}," userInfo",[127,457,238],{"class":137},[127,459,460],{"class":141},"username)",[127,462,161],{"class":137},[127,464,465,467,469,471,473,475,478,480,482,484,486,489],{"class":129,"line":217},[127,466,280],{"class":141},[127,468,238],{"class":137},[127,470,285],{"class":187},[127,472,190],{"class":141},[127,474,158],{"class":137},[127,476,477],{"class":154},"VAT:",[127,479,158],{"class":137},[127,481,258],{"class":137},[127,483,455],{"class":141},[127,485,238],{"class":137},[127,487,488],{"class":141},"vatCode)",[127,490,161],{"class":137},[127,492,493,495,497,499,501,503,506,508,510,512,514,517,519,522,524,526,529,531,533],{"class":129,"line":222},[127,494,280],{"class":141},[127,496,238],{"class":137},[127,498,285],{"class":187},[127,500,190],{"class":141},[127,502,158],{"class":137},[127,504,505],{"class":154},"Space used:",[127,507,158],{"class":137},[127,509,258],{"class":137},[127,511,455],{"class":141},[127,513,238],{"class":137},[127,515,516],{"class":141},"usageStatus",[127,518,238],{"class":137},[127,520,521],{"class":141},"usedSpaceKB",[127,523,258],{"class":137},[127,525,151],{"class":137},[127,527,528],{"class":154},"KB",[127,530,158],{"class":137},[127,532,212],{"class":141},[127,534,161],{"class":137},[112,536,538],{"id":537},"multi-company-premium","Multi-company (Premium)",[117,540,542],{"className":119,"code":541,"language":121,"meta":122,"style":122},"const multicedenti = await client.auth.getMulticedenti({\n  page: 0,\n  size: 20,\n});\n\nfor (const cedente of multicedenti.content) {\n  console.log(`${cedente.id}: ${cedente.description}`);\n}\n",[124,543,544,571,585,597,606,610,636,680],{"__ignoreMap":122},[127,545,546,548,551,553,555,557,559,561,563,566,568],{"class":129,"line":130},[127,547,175],{"class":174},[127,549,550],{"class":141}," multicedenti ",[127,552,181],{"class":137},[127,554,232],{"class":133},[127,556,235],{"class":141},[127,558,238],{"class":137},[127,560,241],{"class":141},[127,562,238],{"class":137},[127,564,565],{"class":187},"getMulticedenti",[127,567,190],{"class":141},[127,569,570],{"class":137},"{\n",[127,572,573,576,578,582],{"class":129,"line":164},[127,574,575],{"class":196},"  page",[127,577,200],{"class":137},[127,579,581],{"class":580},"sbssI"," 0",[127,583,584],{"class":137},",\n",[127,586,587,590,592,595],{"class":129,"line":171},[127,588,589],{"class":196},"  size",[127,591,200],{"class":137},[127,593,594],{"class":580}," 20",[127,596,584],{"class":137},[127,598,599,602,604],{"class":129,"line":217},[127,600,601],{"class":137},"}",[127,603,212],{"class":141},[127,605,161],{"class":137},[127,607,608],{"class":129,"line":222},[127,609,168],{"emptyLinePlaceholder":167},[127,611,612,615,618,620,623,626,629,631,634],{"class":129,"line":272},[127,613,614],{"class":133},"for",[127,616,617],{"class":141}," (",[127,619,175],{"class":174},[127,621,622],{"class":141}," cedente ",[127,624,625],{"class":137},"of",[127,627,628],{"class":141}," multicedenti",[127,630,238],{"class":137},[127,632,633],{"class":141},"content) ",[127,635,570],{"class":137},[127,637,638,641,643,645,647,650,653,655,658,660,663,666,668,670,673,676,678],{"class":129,"line":277},[127,639,640],{"class":141},"  console",[127,642,238],{"class":137},[127,644,285],{"class":187},[127,646,190],{"class":196},[127,648,649],{"class":137},"`${",[127,651,652],{"class":141},"cedente",[127,654,238],{"class":137},[127,656,657],{"class":141},"id",[127,659,601],{"class":137},[127,661,662],{"class":154},": ",[127,664,665],{"class":137},"${",[127,667,652],{"class":141},[127,669,238],{"class":137},[127,671,672],{"class":141},"description",[127,674,675],{"class":137},"}`",[127,677,212],{"class":196},[127,679,161],{"class":137},[127,681,682],{"class":129,"line":309},[127,683,684],{"class":137},"}\n",[112,686,688],{"id":687},"custom-token-storage","Custom Token Storage",[117,690,692],{"className":119,"code":691,"language":121,"meta":122,"style":122},"const client = new ArubaClient({\n  environment: 'production',\n  tokenStorage: {\n    getToken: async () => {\n      const stored = await redis.get('aruba:token');\n      return stored ? JSON.parse(stored) : null;\n    },\n    setToken: async (token) => {\n      await redis.set('aruba:token', JSON.stringify(token), 'EX', 3600);\n    },\n    clearToken: async () => {\n      await redis.del('aruba:token');\n    },\n  },\n});\n",[124,693,694,710,726,736,754,788,819,824,845,899,904,920,944,949,955],{"__ignoreMap":122},[127,695,696,698,700,702,704,706,708],{"class":129,"line":130},[127,697,175],{"class":174},[127,699,178],{"class":141},[127,701,181],{"class":137},[127,703,184],{"class":137},[127,705,142],{"class":187},[127,707,190],{"class":141},[127,709,570],{"class":137},[127,711,712,715,717,719,722,724],{"class":129,"line":164},[127,713,714],{"class":196},"  environment",[127,716,200],{"class":137},[127,718,151],{"class":137},[127,720,721],{"class":154},"production",[127,723,158],{"class":137},[127,725,584],{"class":137},[127,727,728,731,733],{"class":129,"line":171},[127,729,730],{"class":196},"  tokenStorage",[127,732,200],{"class":137},[127,734,735],{"class":137}," {\n",[127,737,738,741,743,746,749,752],{"class":129,"line":217},[127,739,740],{"class":187},"    getToken",[127,742,200],{"class":137},[127,744,745],{"class":174}," async",[127,747,748],{"class":137}," ()",[127,750,751],{"class":174}," =>",[127,753,735],{"class":137},[127,755,756,759,762,765,767,770,772,775,777,779,782,784,786],{"class":129,"line":222},[127,757,758],{"class":174},"      const",[127,760,761],{"class":141}," stored",[127,763,764],{"class":137}," =",[127,766,232],{"class":133},[127,768,769],{"class":141}," redis",[127,771,238],{"class":137},[127,773,774],{"class":187},"get",[127,776,190],{"class":196},[127,778,158],{"class":137},[127,780,781],{"class":154},"aruba:token",[127,783,158],{"class":137},[127,785,212],{"class":196},[127,787,161],{"class":137},[127,789,790,793,795,798,801,803,806,808,811,814,816],{"class":129,"line":272},[127,791,792],{"class":133},"      return",[127,794,761],{"class":141},[127,796,797],{"class":137}," ?",[127,799,800],{"class":141}," JSON",[127,802,238],{"class":137},[127,804,805],{"class":187},"parse",[127,807,190],{"class":196},[127,809,810],{"class":141},"stored",[127,812,813],{"class":196},") ",[127,815,200],{"class":137},[127,817,818],{"class":137}," null;\n",[127,820,821],{"class":129,"line":277},[127,822,823],{"class":137},"    },\n",[127,825,826,829,831,833,835,839,841,843],{"class":129,"line":309},[127,827,828],{"class":187},"    setToken",[127,830,200],{"class":137},[127,832,745],{"class":174},[127,834,617],{"class":137},[127,836,838],{"class":837},"sHdIc","token",[127,840,212],{"class":137},[127,842,751],{"class":174},[127,844,735],{"class":137},[127,846,848,851,853,855,858,860,862,864,866,868,870,872,875,877,879,881,883,885,888,890,892,895,897],{"class":129,"line":847},9,[127,849,850],{"class":133},"      await",[127,852,769],{"class":141},[127,854,238],{"class":137},[127,856,857],{"class":187},"set",[127,859,190],{"class":196},[127,861,158],{"class":137},[127,863,781],{"class":154},[127,865,158],{"class":137},[127,867,258],{"class":137},[127,869,800],{"class":141},[127,871,238],{"class":137},[127,873,874],{"class":187},"stringify",[127,876,190],{"class":196},[127,878,838],{"class":141},[127,880,212],{"class":196},[127,882,258],{"class":137},[127,884,151],{"class":137},[127,886,887],{"class":154},"EX",[127,889,158],{"class":137},[127,891,258],{"class":137},[127,893,894],{"class":580}," 3600",[127,896,212],{"class":196},[127,898,161],{"class":137},[127,900,902],{"class":129,"line":901},10,[127,903,823],{"class":137},[127,905,907,910,912,914,916,918],{"class":129,"line":906},11,[127,908,909],{"class":187},"    clearToken",[127,911,200],{"class":137},[127,913,745],{"class":174},[127,915,748],{"class":137},[127,917,751],{"class":174},[127,919,735],{"class":137},[127,921,923,925,927,929,932,934,936,938,940,942],{"class":129,"line":922},12,[127,924,850],{"class":133},[127,926,769],{"class":141},[127,928,238],{"class":137},[127,930,931],{"class":187},"del",[127,933,190],{"class":196},[127,935,158],{"class":137},[127,937,781],{"class":154},[127,939,158],{"class":137},[127,941,212],{"class":196},[127,943,161],{"class":137},[127,945,947],{"class":129,"line":946},13,[127,948,823],{"class":137},[127,950,952],{"class":129,"line":951},14,[127,953,954],{"class":137},"  },\n",[127,956,958,960,962],{"class":129,"line":957},15,[127,959,601],{"class":137},[127,961,212],{"class":141},[127,963,161],{"class":137},[965,966,967],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}",{"title":122,"searchDepth":164,"depth":164,"links":969},[970,971,972,973,974],{"id":114,"depth":164,"text":115},{"id":354,"depth":164,"text":355},{"id":396,"depth":164,"text":397},{"id":537,"depth":164,"text":538},{"id":687,"depth":164,"text":688},"OAuth2 flow management","md",null,{},{"title":30,"description":975},"HGTlT5JzhNnnRMQxeVLdftXvf59RpyyZDLK9E1MfFOg",[982,984],{"title":19,"path":20,"stem":21,"description":983,"children":-1},"Get started quickly with the SDK",{"title":34,"path":35,"stem":36,"description":985,"children":-1},"Send and receive electronic invoices",1782166592766]