[{"data":1,"prerenderedAt":379},["ShallowReactive",2],{"navigation_docs":3,"-guias-empezar-autenticacion":102,"-guias-empezar-autenticacion-surround":374},[4],{"title":5,"path":6,"stem":7,"children":8,"page":22},"Guías","\u002Fguias","1.guias",[9,23,48,81],{"title":10,"path":11,"stem":12,"children":13,"page":22},"Empezar","\u002Fguias\u002Fempezar","1.guias\u002F1.empezar",[14,18],{"title":15,"path":16,"stem":17},"Ambientes","\u002Fguias\u002Fempezar\u002Fambientes","1.guias\u002F1.empezar\u002F1.ambientes",{"title":19,"path":20,"stem":21},"Autenticación","\u002Fguias\u002Fempezar\u002Fautenticacion","1.guias\u002F1.empezar\u002F2.autenticacion",false,{"title":24,"path":25,"stem":26,"children":27,"page":22},"Conceptos","\u002Fguias\u002Fconceptos","1.guias\u002F2.conceptos",[28,32,36,40,44],{"title":29,"path":30,"stem":31},"Tu internalId y los ids","\u002Fguias\u002Fconceptos\u002Finternal-id","1.guias\u002F2.conceptos\u002F1.internal-id",{"title":33,"path":34,"stem":35},"Referencia u objeto","\u002Fguias\u002Fconceptos\u002Freferencia-u-objeto","1.guias\u002F2.conceptos\u002F2.referencia-u-objeto",{"title":37,"path":38,"stem":39},"Mapa del catálogo","\u002Fguias\u002Fconceptos\u002Fmapa-del-catalogo","1.guias\u002F2.conceptos\u002F3.mapa-del-catalogo",{"title":41,"path":42,"stem":43},"Permisos por módulo","\u002Fguias\u002Fconceptos\u002Fpermisos","1.guias\u002F2.conceptos\u002F4.permisos",{"title":45,"path":46,"stem":47},"Disponibilidad","\u002Fguias\u002Fconceptos\u002Fdisponibilidad","1.guias\u002F2.conceptos\u002F5.disponibilidad",{"title":49,"path":50,"stem":51,"children":52,"page":22},"Recetas","\u002Fguias\u002Frecetas","1.guias\u002F3.recetas",[53,57,61,65,69,73,77],{"title":54,"path":55,"stem":56},"Sincronizar el catálogo","\u002Fguias\u002Frecetas\u002Fsincronizar-catalogo","1.guias\u002F3.recetas\u002F1.sincronizar-catalogo",{"title":58,"path":59,"stem":60},"Vender por referencias","\u002Fguias\u002Frecetas\u002Fvender-por-referencias","1.guias\u002F3.recetas\u002F2.vender-por-referencias",{"title":62,"path":63,"stem":64},"Vender con payload","\u002Fguias\u002Frecetas\u002Fvender-con-payload-completo","1.guias\u002F3.recetas\u002F3.vender-con-payload-completo",{"title":66,"path":67,"stem":68},"Compra sujeto excluido","\u002Fguias\u002Frecetas\u002Fcompra-a-sujeto-excluido","1.guias\u002F3.recetas\u002F4.compra-a-sujeto-excluido",{"title":70,"path":71,"stem":72},"Consultar y conciliar","\u002Fguias\u002Frecetas\u002Fconsultar-y-conciliar","1.guias\u002F3.recetas\u002F5.consultar-y-conciliar",{"title":74,"path":75,"stem":76},"Anular una venta","\u002Fguias\u002Frecetas\u002Fanular-venta","1.guias\u002F3.recetas\u002F6.anular-venta",{"title":78,"path":79,"stem":80},"Migrar a referencias","\u002Fguias\u002Frecetas\u002Fmigrar-a-referencias","1.guias\u002F3.recetas\u002F7.migrar-a-referencias",{"title":82,"path":83,"stem":84,"children":85,"page":22},"Operar","\u002Fguias\u002Foperar","1.guias\u002F4.operar",[86,90,94,98],{"title":87,"path":88,"stem":89},"Errores","\u002Fguias\u002Foperar\u002Ferrores","1.guias\u002F4.operar\u002F1.errores",{"title":91,"path":92,"stem":93},"Reintentos","\u002Fguias\u002Foperar\u002Freintentos","1.guias\u002F4.operar\u002F2.reintentos",{"title":95,"path":96,"stem":97},"Contingencia","\u002Fguias\u002Foperar\u002Fcontingencia","1.guias\u002F4.operar\u002F3.contingencia",{"title":99,"path":100,"stem":101},"Cambios del contrato","\u002Fguias\u002Foperar\u002Fcambios-del-contrato","1.guias\u002F4.operar\u002F4.cambios-del-contrato",{"id":103,"title":19,"body":104,"description":367,"extension":368,"links":369,"meta":370,"navigation":371,"path":20,"seo":372,"stem":21,"__hash__":373},"docs\u002F1.guias\u002F1.empezar\u002F2.autenticacion.md",{"type":105,"value":106,"toc":362},"minimark",[107,120,125,130,138,212,215,275,289,293,300,331,335,355,358],[108,109,110,114,115,119],"warning",{},[111,112,113],"strong",{},"Cada inicio de sesión revoca los tokens anteriores de la llave."," Reutiliza el token hasta que\nvenza; no inicies sesión antes de cada petición ni en paralelo desde varios procesos con la misma\nllave, o tus propias peticiones en curso empezarán a fallar con ",[116,117,118],"code",{},"401",".",[121,122,124],"h2",{"id":123},"obtener-el-token","Obtener el token",[126,127,129],"insignia-operacion",{"id":128},"partnersV1AuthLogin","Disponible",[131,132,133,134,137],"p",{},"Envía tu llave y tu secreto a ",[116,135,136],{},"POST \u002Fpartners\u002Fv1\u002Fauth\u002Flogin",":",[139,140,146],"pre",{"className":141,"code":142,"filename":143,"language":144,"meta":145,"style":145},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -X POST \"$OPENBOX_API_URL\u002Fpartners\u002Fv1\u002Fauth\u002Flogin\" \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{\"key\":\"\u003CTU_LLAVE>\",\"secret\":\"\u003CTU_SECRETO>\"}'\n","Terminal","bash","",[116,147,148,181,198],{"__ignoreMap":145},[149,150,153,157,161,164,168,172,175,178],"span",{"class":151,"line":152},"line",1,[149,154,156],{"class":155},"sBMFI","curl",[149,158,160],{"class":159},"sfazB"," -X",[149,162,163],{"class":159}," POST",[149,165,167],{"class":166},"sMK4o"," \"",[149,169,171],{"class":170},"sTEyZ","$OPENBOX_API_URL",[149,173,174],{"class":159},"\u002Fpartners\u002Fv1\u002Fauth\u002Flogin",[149,176,177],{"class":166},"\"",[149,179,180],{"class":170}," \\\n",[149,182,184,187,190,193,196],{"class":151,"line":183},2,[149,185,186],{"class":159},"  -H",[149,188,189],{"class":166}," '",[149,191,192],{"class":159},"Content-Type: application\u002Fjson",[149,194,195],{"class":166},"'",[149,197,180],{"class":170},[149,199,201,204,206,209],{"class":151,"line":200},3,[149,202,203],{"class":159},"  -d",[149,205,189],{"class":166},[149,207,208],{"class":159},"{\"key\":\"\u003CTU_LLAVE>\",\"secret\":\"\u003CTU_SECRETO>\"}",[149,210,211],{"class":166},"'\n",[131,213,214],{},"La respuesta trae el token de acceso:",[139,216,220],{"className":217,"code":218,"language":219,"meta":145,"style":145},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"data\": {\n    \"access_token\": \"\u003CTOKEN>\"\n  }\n}\n","json",[116,221,222,227,243,263,269],{"__ignoreMap":145},[149,223,224],{"class":151,"line":152},[149,225,226],{"class":166},"{\n",[149,228,229,232,236,238,240],{"class":151,"line":183},[149,230,231],{"class":166},"  \"",[149,233,235],{"class":234},"spNyl","data",[149,237,177],{"class":166},[149,239,137],{"class":166},[149,241,242],{"class":166}," {\n",[149,244,245,248,251,253,255,257,260],{"class":151,"line":200},[149,246,247],{"class":166},"    \"",[149,249,250],{"class":155},"access_token",[149,252,177],{"class":166},[149,254,137],{"class":166},[149,256,167],{"class":166},[149,258,259],{"class":159},"\u003CTOKEN>",[149,261,262],{"class":166},"\"\n",[149,264,266],{"class":151,"line":265},4,[149,267,268],{"class":166},"  }\n",[149,270,272],{"class":151,"line":271},5,[149,273,274],{"class":166},"}\n",[131,276,277,278,280,281,284,285,288],{},"Si la llave o el secreto no son válidos, la respuesta es ",[116,279,118],{}," con el mensaje\n",[116,282,283],{},"API key y\u002Fo secret no valida.",". Si la llave no tiene perfil o empresa asignada, es ",[116,286,287],{},"403",": pide al\nequipo de Openbox Cloud que revise el aprovisionamiento.",[121,290,292],{"id":291},"usar-el-token","Usar el token",[131,294,295,296,299],{},"Envía el token en la cabecera ",[116,297,298],{},"Authorization"," de cada petición:",[139,301,303],{"className":141,"code":302,"filename":143,"language":144,"meta":145,"style":145},"curl \"$OPENBOX_API_URL\u002Fpartners\u002Fv1\u002Finvoices\u002F\u003CID_DE_LA_VENTA>\" \\\n  -H 'Authorization: Bearer \u003CTOKEN>'\n",[116,304,305,320],{"__ignoreMap":145},[149,306,307,309,311,313,316,318],{"class":151,"line":152},[149,308,156],{"class":155},[149,310,167],{"class":166},[149,312,171],{"class":170},[149,314,315],{"class":159},"\u002Fpartners\u002Fv1\u002Finvoices\u002F\u003CID_DE_LA_VENTA>",[149,317,177],{"class":166},[149,319,180],{"class":170},[149,321,322,324,326,329],{"class":151,"line":183},[149,323,186],{"class":159},[149,325,189],{"class":166},[149,327,328],{"class":159},"Authorization: Bearer \u003CTOKEN>",[149,330,211],{"class":166},[121,332,334],{"id":333},"cuándo-volver-a-iniciar-sesión","Cuándo volver a iniciar sesión",[336,337,338,342,345],"ol",{},[339,340,341],"li",{},"Guarda el token en memoria (o en un almacén compartido si tienes varios procesos).",[339,343,344],{},"Úsalo en todas las peticiones mientras funcione.",[339,346,347,348,350,351,354],{},"Solo cuando una petición responda ",[116,349,118],{},", inicia sesión ",[111,352,353],{},"una vez",", reemplaza el token y\nrepite esa petición.",[131,356,357],{},"Nunca pongas la llave ni el secreto en el código de un navegador o una app móvil: la integración\ncorre en tu servidor.",[359,360,361],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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 .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 .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}",{"title":145,"searchDepth":183,"depth":183,"links":363},[364,365,366],{"id":123,"depth":183,"text":124},{"id":291,"depth":183,"text":292},{"id":333,"depth":183,"text":334},"Obtén un token con tu llave y tu secreto, y reutilízalo hasta que venza.","md",null,{},{"title":19},{"title":19,"description":367},"buRSCntqaDSpNG3gzupIXizTXErbe1wpEfRWnKn_K1o",[375,377],{"title":15,"path":16,"stem":17,"description":376,"children":-1},"Los dos ambientes de la API de Partners v1, cómo pedir tu llave y cómo usar los ejemplos.",{"title":29,"path":30,"stem":31,"description":378,"children":-1},"Tu identificador en cada registro del catálogo, el id de Openbox Cloud y cómo pasar de uno a otro.",1795293794014]