[{"data":1,"prerenderedAt":436},["ShallowReactive",2],{"navigation_docs":3,"-guias-empezar-ambientes":102,"-guias-empezar-ambientes-surround":433},[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":15,"body":104,"description":426,"extension":427,"links":428,"meta":429,"navigation":430,"path":16,"seo":431,"stem":17,"__hash__":432},"docs\u002F1.guias\u002F1.empezar\u002F1.ambientes.md",{"type":105,"value":106,"toc":420},"minimark",[107,112,116,182,185,189,200,262,279,283,297,332,335,361,365,398,409,416],[108,109,111],"h2",{"id":110},"dos-ambientes-demo-y-producción","Dos ambientes: demo y producción",[113,114,115],"p",{},"La API de Partners v1 de Openbox Cloud está disponible en dos ambientes, con las mismas rutas y el\nmismo contrato:",[117,118,119,138],"table",{},[120,121,122],"thead",{},[123,124,125,129,132,135],"tr",{},[126,127,128],"th",{},"Ambiente",[126,130,131],{},"URL base",[126,133,134],{},"Ministerio de Hacienda",[126,136,137],{},"Para qué",[139,140,141,163],"tbody",{},[123,142,143,147,153,160],{},[144,145,146],"td",{},"Demo",[144,148,149],{},[150,151,152],"code",{},"https:\u002F\u002Fdemo-api.openbox.cloud",[144,154,155,156,159],{},"Pruebas (ambiente ",[150,157,158],{},"00",")",[144,161,162],{},"Construir y probar tu integración. Lo que emites no tiene validez fiscal y puedes repetirlo cuantas veces necesites.",[123,164,165,168,173,179],{},[144,166,167],{},"Producción",[144,169,170],{},[150,171,172],{},"https:\u002F\u002Fproduction-api.openbox.cloud",[144,174,175,176,159],{},"Real (ambiente ",[150,177,178],{},"01",[144,180,181],{},"Operar: cada venta o compra que emites es un documento con validez fiscal.",[113,183,184],{},"Empieza en demo y pasa a producción cuando tu integración funcione de punta a punta. Cada ambiente\ntiene su propia empresa y su propia llave: una llave de demo no sirve en producción, ni al revés.",[108,186,188],{"id":187},"la-url-base-en-los-ejemplos","La URL base en los ejemplos",[113,190,191,192,195,196,199],{},"Los ejemplos ",[150,193,194],{},"curl"," de las guías usan la variable ",[150,197,198],{},"OPENBOX_API_URL"," en lugar de una URL fija.\nDefínela una vez con el ambiente en el que trabajas:",[201,202,208],"pre",{"className":203,"code":204,"filename":205,"language":206,"meta":207,"style":207},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# Demo (pruebas)\nexport OPENBOX_API_URL=https:\u002F\u002Fdemo-api.openbox.cloud\n\n# Producción (documentos con validez fiscal)\nexport OPENBOX_API_URL=https:\u002F\u002Fproduction-api.openbox.cloud\n","Terminal","bash","",[150,209,210,219,237,244,250],{"__ignoreMap":207},[211,212,215],"span",{"class":213,"line":214},"line",1,[211,216,218],{"class":217},"sHwdD","# Demo (pruebas)\n",[211,220,222,226,230,234],{"class":213,"line":221},2,[211,223,225],{"class":224},"spNyl","export",[211,227,229],{"class":228},"sTEyZ"," OPENBOX_API_URL",[211,231,233],{"class":232},"sMK4o","=",[211,235,236],{"class":228},"https:\u002F\u002Fdemo-api.openbox.cloud\n",[211,238,240],{"class":213,"line":239},3,[211,241,243],{"emptyLinePlaceholder":242},true,"\n",[211,245,247],{"class":213,"line":246},4,[211,248,249],{"class":217},"# Producción (documentos con validez fiscal)\n",[211,251,253,255,257,259],{"class":213,"line":252},5,[211,254,225],{"class":224},[211,256,229],{"class":228},[211,258,233],{"class":232},[211,260,261],{"class":228},"https:\u002F\u002Fproduction-api.openbox.cloud\n",[263,264,265,266,269,270,273,274,278],"note",{},"Todas las rutas de la API cuelgan de ",[150,267,268],{},"\u002Fpartners\u002Fv1",". Por ejemplo, el inicio de sesión es\n",[150,271,272],{},"POST $OPENBOX_API_URL\u002Fpartners\u002Fv1\u002Fauth\u002Flogin",". En la ",[275,276,277],"strong",{},"Referencia",", elige el ambiente en el\nselector de servidor: los ejemplos se arman con la URL que escojas (demo, si no eliges otra).",[108,280,282],{"id":281},"pide-tu-llave-al-equipo-de-openbox-cloud","Pide tu llave al equipo de Openbox Cloud",[113,284,285,296],{},[275,286,287,288,291,292,295],{},"La llave (",[150,289,290],{},"key",") y el secreto (",[150,293,294],{},"secret",") se piden al equipo de Openbox Cloud",", que también deja\nlista tu empresa. Para cada ambiente en el que vayas a trabajar recibes:",[298,299,300,307,322],"ol",{},[301,302,303,306],"li",{},[275,304,305],{},"Una empresa"," con su sucursal, conectada al Ministerio de Hacienda de ese ambiente.",[301,308,309,312,313,315,316,312,319,321],{},[275,310,311],{},"Una llave"," (",[150,314,290],{},", un UUID) y su ",[275,317,318],{},"secreto",[150,320,294],{},"). El secreto se entrega por un canal\nseguro y no se vuelve a mostrar: guárdalo como cualquier contraseña.",[301,323,324,327,328,331],{},[275,325,326],{},"Un perfil"," asignado a la llave con acceso a los módulos que vas a usar (ventas, compras,\ninventario). Una operación de un módulo que el perfil no tiene responde ",[150,329,330],{},"403",".",[113,333,334],{},"Para pedirla, escríbenos por cualquiera de estos canales:",[336,337,338,352],"ul",{},[301,339,340,343,344],{},[275,341,342],{},"WhatsApp:"," ",[345,346,351],"a",{"href":347,"rel":348,"target":350},"https:\u002F\u002Fwa.me\u002F50321136220",[349],"nofollow","_blank","+503 2113 6220",[301,353,354,343,357],{},[275,355,356],{},"Correo:",[345,358,360],{"href":359},"mailto:info@openbox.cloud","info@openbox.cloud",[108,362,364],{"id":363},"cómo-leer-este-portal","Cómo leer este portal",[336,366,367,384,392],{},[301,368,369,371,372,374,375,377,378,380,381,383],{},[275,370,5],{}," (esta sección), en cuatro bloques: ",[275,373,10],{}," (ambientes y autenticación),\n",[275,376,24],{}," (lo que conviene entender antes de integrar), ",[275,379,49],{}," (cada tarea paso a paso) y\n",[275,382,82],{}," (errores, reintentos y contingencia).",[301,385,386,388,389,391],{},[275,387,277],{},": cada operación con su esquema y un ejemplo ",[150,390,194],{}," para el ambiente que elijas.\nEl portal no envía peticiones: copia el ejemplo y córrelo tú.",[301,393,394,397],{},[275,395,396],{},"Estado del contrato",": la insignia de cada operación, en una sola tabla.",[113,399,400,401,406,407,331],{},"Cada operación lleva una insignia que sale del contrato publicado, por ejemplo\n",[402,403,405],"insignia-operacion",{"id":404},"partnersV1AuthLogin","Disponible",". Qué significa cada una está en\n",[345,408,45],{"href":46},[113,410,411,412,415],{},"Si prefieres Postman o Insomnia, descarga el OpenAPI con el botón ",[275,413,414],{},"OpenAPI (Postman \u002F Insomnia)","\nde la cabecera e impórtalo: trae los dos ambientes como servidores.",[417,418,419],"style",{},"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 pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}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);}",{"title":207,"searchDepth":221,"depth":221,"links":421},[422,423,424,425],{"id":110,"depth":221,"text":111},{"id":187,"depth":221,"text":188},{"id":281,"depth":221,"text":282},{"id":363,"depth":221,"text":364},"Los dos ambientes de la API de Partners v1, cómo pedir tu llave y cómo usar los ejemplos.","md",null,{},{"title":15},{"title":15,"description":426},"L9Wq7a-JH_JKkL8T5m5wpoK4zuiFUClNhIoVNTARQSI",[428,434],{"title":19,"path":20,"stem":21,"description":435,"children":-1},"Obtén un token con tu llave y tu secreto, y reutilízalo hasta que venza.",1795293794014]