[{"data":1,"prerenderedAt":360},["ShallowReactive",2],{"navigation_docs":3,"-guias-recetas-migrar-a-referencias":102,"-guias-recetas-migrar-a-referencias-surround":355},[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":104,"body":105,"description":348,"extension":349,"links":350,"meta":351,"navigation":352,"path":79,"seo":353,"stem":80,"__hash__":354},"docs\u002F1.guias\u002F3.recetas\u002F7.migrar-a-referencias.md","Migrar de payload completo a referencias",{"type":106,"value":107,"toc":341},"minimark",[108,113,121,130,143,146,150,157,161,164,312,326,330,337],[109,110,112],"insignia-operacion",{"id":111},"partnersV1InvoicesCreateSingle","Disponible",[114,115,116,117,120],"p",{},"Esta receta es para una integración con payload completo: cada venta envía el cliente, las líneas y\nla condición de pago como objetos. Al migrar, cada venta cita esos registros por su id de Openbox\nCloud y deja de reescribirlos (",[118,119,33],"a",{"href":34},"). La\nmigración es gradual: la venta acepta una referencia en un campo y un objeto en otro.",[122,123,125,126],"h2",{"id":124},"paso-1-sincroniza-el-catálogo-con-tu-internalid","Paso 1 · Sincroniza el catálogo con tu ",[127,128,129],"code",{},"internalId",[114,131,132,133,135,136,139,140,142],{},"Registra cada cliente, servicio, producto, vendedor, zona y condición de pago con tu ",[127,134,129],{},",\ncomo en ",[118,137,138],{"href":55},"Sincronizar tu catálogo",". Si un registro ya existe en\nOpenbox Cloud porque tus ventas lo crearon como objeto, búscalo y asígnale tu ",[127,141,129],{}," con una\nactualización.",[109,144,112],{"id":145},"partnersV1CustomersGetMany",[122,147,149],{"id":148},"paso-2-guarda-los-ids-de-openbox-cloud","Paso 2 · Guarda los ids de Openbox Cloud",[114,151,152,153,156],{},"Guarda en tu sistema el ",[127,154,155],{},"id"," de Openbox Cloud de cada registro, junto a tu propio identificador. Es\nlo que vas a enviar en la venta: una referencia es ese id como texto.",[122,158,160],{"id":159},"paso-3-cambia-campo-a-campo","Paso 3 · Cambia campo a campo",[114,162,163],{},"Empieza por el campo que más se repite (por ejemplo, el cliente) y cambia el objeto por su id:",[165,166,172],"pre",{"className":167,"code":168,"filename":169,"language":170,"meta":171,"style":171},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"data\": {\n    \"header\": {\n      \"customer\": \"0a1b2c3d-1111-9999-0000-123456789abc\",\n      \"paymentCondition\": { \"name\": \"Contado\", \"cashPayment\": true }\n    }\n  }\n}\n","venta.json (fragmento)","json","",[127,173,174,183,202,218,244,294,300,306],{"__ignoreMap":171},[175,176,179],"span",{"class":177,"line":178},"line",1,[175,180,182],{"class":181},"sMK4o","{\n",[175,184,186,189,193,196,199],{"class":177,"line":185},2,[175,187,188],{"class":181},"  \"",[175,190,192],{"class":191},"spNyl","data",[175,194,195],{"class":181},"\"",[175,197,198],{"class":181},":",[175,200,201],{"class":181}," {\n",[175,203,205,208,212,214,216],{"class":177,"line":204},3,[175,206,207],{"class":181},"    \"",[175,209,211],{"class":210},"sBMFI","header",[175,213,195],{"class":181},[175,215,198],{"class":181},[175,217,201],{"class":181},[175,219,221,224,228,230,232,235,239,241],{"class":177,"line":220},4,[175,222,223],{"class":181},"      \"",[175,225,227],{"class":226},"sbssI","customer",[175,229,195],{"class":181},[175,231,198],{"class":181},[175,233,234],{"class":181}," \"",[175,236,238],{"class":237},"sfazB","0a1b2c3d-1111-9999-0000-123456789abc",[175,240,195],{"class":181},[175,242,243],{"class":181},",\n",[175,245,247,249,252,254,256,259,261,265,267,269,271,274,276,279,281,284,286,288,291],{"class":177,"line":246},5,[175,248,223],{"class":181},[175,250,251],{"class":226},"paymentCondition",[175,253,195],{"class":181},[175,255,198],{"class":181},[175,257,258],{"class":181}," {",[175,260,234],{"class":181},[175,262,264],{"class":263},"swJcz","name",[175,266,195],{"class":181},[175,268,198],{"class":181},[175,270,234],{"class":181},[175,272,273],{"class":237},"Contado",[175,275,195],{"class":181},[175,277,278],{"class":181},",",[175,280,234],{"class":181},[175,282,283],{"class":263},"cashPayment",[175,285,195],{"class":181},[175,287,198],{"class":181},[175,289,290],{"class":181}," true",[175,292,293],{"class":181}," }\n",[175,295,297],{"class":177,"line":296},6,[175,298,299],{"class":181},"    }\n",[175,301,303],{"class":177,"line":302},7,[175,304,305],{"class":181},"  }\n",[175,307,309],{"class":177,"line":308},8,[175,310,311],{"class":181},"}\n",[114,313,314,315,317,318,321,322,325],{},"El ",[118,316,37],{"href":38}," dice qué campo lleva cada pieza. Cuando una\nreferencia no existe en tu empresa, la venta responde ",[127,319,320],{},"400"," ",[127,323,324],{},"REFERENCE_NOT_FOUND"," sin escribir nada:\ncorrige el id y reenvía.",[122,327,329],{"id":328},"paso-4-si-quieres-deja-de-calcular-montos","Paso 4 · Si quieres, deja de calcular montos",[114,331,332,333,336],{},"Con todas las líneas por referencia, puedes omitir los montos y usar el modo calculado: Openbox Cloud\ncalcula la venta con el mismo cálculo de la aplicación web\n(",[118,334,58],{"href":335},"\u002Fguias\u002Frecetas\u002Fvender-por-referencias#dos-modos-calculado-y-precalculado",").\nSi prefieres seguir enviando montos, el modo precalculado los verifica al centavo.",[338,339,340],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}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":171,"searchDepth":185,"depth":185,"links":342},[343,345,346,347],{"id":124,"depth":185,"text":344},"Paso 1 · Sincroniza el catálogo con tu internalId",{"id":148,"depth":185,"text":149},{"id":159,"depth":185,"text":160},{"id":328,"depth":185,"text":329},"Pasa una integración que envía objetos a citar el catálogo por id, campo por campo y sin cortar la facturación.","md",null,{},{"title":78},{"title":104,"description":348},"oGYv1lqALnOItO9OoYBWJSoIB7izUJzkXv-W7tMzWSA",[356,358],{"title":74,"path":75,"stem":76,"description":357,"children":-1},"Invalida ante el MH una venta ya procesada y lee el resultado de la invalidación.",{"title":87,"path":88,"stem":89,"description":359,"children":-1},"Qué significa cada código de respuesta y cómo se ve su cuerpo.",1795295097888]